Data model: plateInput

General description: This file contains a set of potential targets for a specific pointing, offset, instrument, and target type in plate design. The exact form and contents of these files may differ from survey to survey, or even within a survey, from the point of view of the platedesign product. (Although the individual surveys may develop their own conventions and standards).

Naming convention: $PLATELIST_DIR/inputs/[...]/plateInput-DESIGNID6.par -- the intermediate path [...] is arbitrary, but does need to be specified in the plateDefinition file(s) that call(s) on this input file.

Approximate size: 500 kbytes.

File type: Yanny

Read by products: platedesign

Written by products: targeting software from teams

Required header keywords:

• targettype (string): type of target that this file contains ("science", "standard" or "sky"); targets must be a single type in this file
• pointing (int32): which pointing within the design this input file is associated with that it should correspond to
• offset (int32): which offset within the design this input file is associated with that it should correspond to
• racen (float64): right ascension of pointing/offset, J2000 deg
• deccen (float64): declination of pointing/offset, J2000 deg
• instrument (string): which instrument these targets are for (of "SDSS", "APOGEE", "BOSS", "MARVELS")

Required column names:

• ra (float64): right ascension, in J2000 deg
• dec (float64): declination, in J2000 deg
• sourcetype (string): indicate the nature of the source, one of STAR, QSO, GALAXY, or NA (if targettype is NA)
• priority (int32): priority number assigned by the plateInput file; lower numbers indicate higher priority

Optional column names: (in principle, anything allowed, but the following are propagated to the plateDesign and plateHoles files)

• tmass_j (float32): 2MASS Point Source Catalog J-band magnitude; Vega-relative; not Galactic extinction corrected; if available
• tmass_h (float32): 2MASS Point Source Catalog H-band magnitude; Vega-relative; not Galactic extinction corrected, if available
• tmass_k (float32): 2MASS Point Source Catalog K-band magnitude; Vega-relative; not Galactic extinction corrected, if available
• mjd_mag[6] (float32): MARVELS magnitudes for stars in the PRE_SELECTION plates; VT, BT, V, J, H, K
• sp_param_source (string): source for stellar parameters for MARVELS stars
• sp_params[4] (float32): stellar parameters for MARVELS stars: Teff (K), log10(g), [Fe/H], vsini (km/s)
• sp_param_err[4] (float32): errors in stellar parameters for MARVELS stars
• marvels_target1 (int32): bitmask for MARVELS targeting flags (see the MARVELS target flag descriptions.
• marvels_target2 (int32): bitmask for MARVELS targeting flags (see the MARVELS target flag descriptions.
• segue2_target1 (int32): bitmask for SEGUE-2 targeting flags (see the SEGUE-2 target flag descriptions.
• segue2_target2 (int32): bitmask for SEGUE-2 targeting flags (see the SEGUE-2 target flag descriptions.
• segueb_target1 (int32): bitmask for SEGUE-bright targeting flags (see the SEGUE-bright target flag descriptions.
• segueb_target2 (int32): bitmask for SEGUE-bright targeting flags (see the SEGUE-bright target flag descriptions.
• boss_target1 (int64): bitmask for BOSS targeting flags (see the BOSS target flag descriptions.
• boss_target2 (int64): bitmask for BOSS targeting flags (see the BOSS target flag descriptions.
• ancillary_target1 (int64): bitmask for BOSS ancillary targeting flags (see the BOSS target flag descriptions.
• ancillary_target2 (int64): bitmask for BOSS ancillary targeting flags (see the BOSS target flag descriptions.
• apogee_target1 (int32): bitmask for APOGEE targeting flags (see the APOGEE target flag descriptions.
• apogee_target2 (int32): bitmask for APOGEE targeting flags (see the APOGEE target flag descriptions.
• run (int32): SDSS imaging run, for SDSS imaging based targets
• rerun (string): SDSS imaging rerun, for SDSS imaging based targets
• camcol (int32): SDSS imaging camcol, for SDSS imaging based targets
• field (int32): SDSS imaging field, for SDSS imaging based targets
• id (int32): SDSS imaging id, for SDSS imaging based targets
• psfflux[5] (float32): PSF flux in nanomaggies, for SDSS imaging based targets
• psfflux_ivar[5] (float32): inverse variance of PSF flux in nanomaggies, for SDSS imaging based targets
• fiberflux[5] (float32): 3 arcsec fiber flux in nanomaggies, for SDSS imaging based targets
• fiberflux_ivar[5] (float32): inverse variance of 3 arcsec fiber flux in nanomaggies, for SDSS imaging based targets
• fiber2flux[5] (float32): 2 arcsec fiber flux in nanomaggies, for SDSS imaging based targets
• fiber2flux_ivar[5] (float32): inverse variance of 2 arcsec fiber flux in nanomaggies, for SDSS imaging based targets
• psfmag[5] (float32): 3 arcsec fiber magnitude, for SDSS imaging based targets
• fibermag[5] (float32): 3 arcsec fiber magnitude, for SDSS imaging based targets
• fiber2mag[5] (float32): 2 arcsec fiber magnitude, for SDSS imaging based targets
• targetids (string): free-form, white-space separated list of identifiers
• lambda_eff (float32): wavelength to optimize hole location for, in Angstroms (platedesign will default to 5400 if not set)
• zoffset (float32): backstopping offset distance, in microns (platedesign will default to 0 if not set)
• bluefiber (int16): 1 if the BOSS instrument is meant to assign this target a "blue" fiber; 0 otherwise
• chunk (int32): BOSS chunk number (0 if not appropriate)
• ifinal (int32): 0-indexed position in BOSS final tiling file (-1 if not appropriate)
• origfile (string): for BOSS targets, name of file that target originated within (for BOSS targets, one of the bosstarget files, for ancillary targets, a file within the directory.
• fileindx (int32): for BOSS targets, 0-indexed position within ORIGFILE (-1 if not appropriate)
• epoch (float32): epoch for which RA and DEC are most appropriate in years AD (default 2011)
• pmra (float32): proper motion in RA direction in milliarcsec/yr
• pmdec (float32): proper motion in Dec direction in milliarcsec/yr
• fiberid (int32): fiber ID to assign to this target; only respected if respect_fiberid is set in the plateDefault or plateDefinition file. (-9999)