Data model: plateDesign

General description: This file contains the "design" for each spectroscopic observation, meaning the list of all of the targets selected to have holes drilled. It is defined separately from a "plate" because multiple plates can be generated for different observing conditions from the same design. In order to decide on collisions and such things a generic observing condition (HA of 0 and observing temperature of 5 deg C) is assumed.

Naming convention: plateDesign-DESIGNID6.par

Approximate size: 500 kbytes.

File type: Yanny

Read by products: platedesign

Written by products: platedesign

Required header keywords (in addition to what is in the plateDefault and plateDefinition files; however, note that that case is not always maintained):

• npointings (int32): number of pointings that the plate is designed to make; each pointing will correspond to one or more exposures during observation; number must be less than or equal to 6
• noffsets (int32): number of offsets to perform within each exposure
• raCen[npointings] (float64): right ascension of pointing centers, J2000 deg
• decCen[npointings] (float64): declination of pointing centers, J2000 deg
• pointing_name (string): "name" for each of the pointings (in legacy plates where not given, default to "A B C D E F")
• theta (float32): position angle of design (always 0 in practice)
• platerun (string): name of platerun this file was part of
• platedesign_version (string): version of platedesign used to produce design file

Optional header keywords: In truth anything; generally filled with keywords from plateDefault and plateDefinition files).

Required column names:

• holetype (string): type of hole to be drilled; one of SDSS, BOSS, MARVELS, APOGEE, GUIDE, CENTER, TRAP, or ALIGNMENT; this really refers to the instrument to be used, so for example SEGUE targets should be either SDSS or BOSS
• targettype (string): type of target; one of SCIENCE, STANDARD, or SKY (if holetype is BOSS, SDSS, MARVELS or APOGEE); NA if not holetype is not one of the instruments (GUIDE, CENTER, TRAP, ALIGNMENT)
• sourcetype (string): indicate the nature of the source, one of STAR, QSO, GALAXY, or NA (if targettype is NA)
• target_ra (float64): right ascension, in J2000 deg
• target_dec (float64): declination, in J2000 deg
• iplateinput (int32): integer indicating which plateInput file from the list in the plateDefinition file this came from (1-indexed); -1 or 0 if the hole wasn't from a plateInput file.
• pointing (int32): which pointing (1-indexed) this target is associated with; note this means which pointing among the ones that this plate is designed for, so if this a single pointing plate but uses the B-side MARVELS fibers, this will be "1", not "2"
• offset (int32): which offset this target is associated with; 0 means it is not associated with an offset, it is associated with the primary pointing
• fiberid (int32): what fiber on the appropriate instrument (as listed in holetype) is assigned to this target (-9999 for none)
• block (int32): which fiber block that fiber is associated with (-9999 for none)
• iguide (int32): for guide holes, which guide fiber it is assigned to (from 1 to 11) (-9999 for non guide holes)
• xf_default (float32): X position of hole in focal plane, given a default set of observing parameters (hour angle of zero, temperature of 5 deg C), in units of mm; for position angle of zero (which we always use), +X is +RA
• yf_default (float32): Y position of hole in focal plane, given a default set of observing parameters (hour angle of zero, temperature of 5 deg C), in units of mm; for position angle of zero (which we always use), +Y is +Dec
• diameter (float32): diameter of hole to be drilled, in mm
• buffer (float32): buffer to leave around hole edge for conflicts in mm
• priority (int32): priority number assigned by the plateInput file; lower numbers indicate higher priority
• assigned (int32): 1 if this was a target assigned to a fiber, 0 otherwise; clearly for all targets this will be 1 for plateDesign files, but this will not be the case for plateInput-output files, which also have this same format.
• conflicted (int32): 1 if this was a target not assigned because of a collision, 0 otherwise; clearly for all targets this will be 0 for plateDesign files, but this will not be the case for plateInput-output files, which also have this same format.
• ranout (int32): 1 if this was a target not assigned because we ran out of fibers, 0 otherwise; clearly for all targets this will be 0 for plateDesign files, but this will not be the case for plateInput-output files, which also have this same format.
• outside (int32): 1 if this was a target not assigned because it was too fare from the plate center, 0 otherwise; clearly for all targets this will be 0 for plateDesign files, but this will not be the case for plateInput-output files, which also have this same format.
• 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
• mfd_mag[6] (float32): MARVELS magnitudes for stars in the PRE_SELECTION plates; VT, BT, V, J, H, K
• usnob_mag[5] (float32): USNO-B magnitudes if available
• 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 (int32): bitmask for BOSS targeting flags (see the BOSS target flag descriptions.
• boss_target2 (int32): 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 (string): SDSS imaging camcol, for SDSS imaging based targets
• field (string): SDSS imaging field, for SDSS imaging based targets
• id (string): SDSS imaging id, for SDSS imaging based targets
• psfflux[5] (string): PSF flux in nanomaggies, for SDSS imaging based targets
• psfflux_ivar[5] (string): inverse variance of PSF flux in nanomaggies, for SDSS imaging based targets
• fiberflux[5] (string): 3 arcsec fiber flux in nanomaggies, for SDSS imaging based targets
• fiberflux_ivar[5] (string): inverse variance of 3 arcsec fiber flux in nanomaggies, for SDSS imaging based targets
• fiber2flux[5] (string): 2 arcsec fiber flux in nanomaggies, for SDSS imaging based targets
• fiber2flux_ivar[5] (string): 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
• mag[5] (float32): magnitude to use for the SOS software as the best known fiber magnitude for the object
• 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
• targetids (string): free-form, white-space separated list of identifiers

Example file: plateDesign-000010.par