output secondary targets

Summary:: DESI secondary target output files include a binary fits table. This table contains the targets provided with a given secondary proposal, with the added targeting information (i.e. IDs and bits) needed by the DESI pipeline.
Naming Convention:: BITNAME.fits, where BITNAME matches the name of the secondary targeting bit used by the desitarget pipeline for a given survey phase (see the desitarget GitHub repository for, e.g. the sv1 or main secondary target bitmasks).
Regex:: [A-Z_0-9]+\.fits
File Type:: FITS, 20 KB - 284 MB

Contents (FITS version; see notes, below, for text version)

Number	EXTNAME	Type	Contents
HDU0		IMAGE	Empty
HDU1	TARGETS	BINTABLE	Output secondary targets

This HDU has no non-standard required keywords.

Empty HDU.

EXTNAME = TARGETS

Output secondary targets

Required Header Keywords Table

KEY	Example Value	Type	Comment
NAXIS1	89	int	width of table in bytes
NAXIS2	4838	int	number of rows in table
SURVEY	“main”	str	svX for SV, main for Main Survey
PRIMDIR	“/global/”	str	location of directory of information about corresponding primary targets
SEP	1.0	float	matching radius that was used to find primary targets (arcsec)
MASKED	T	bool	`True` if targets were masked to avoid bright sources
MASKDIR	“masks/”	str	location of directory of masks used to avoid bright sources
SCNDDIR	“/global/”	str	directory from which secondary targets were read
OBSCON	“DARK”	str	observing layer for file
SUBPSEED	717	int	random seed used to generate SUBPRIORITY values

Name	Type	Units	Description
RA	float64	deg	Right ascension
DEC	float64	deg	Declination
PMRA	float32	mas / yr	Proper motion in the RA direction
PMDEC	float32	mas / yr	Proper motion in the Dec direction
REF_EPOCH	float32	yr	Astrometric reference epoch. Defaults to 2015.5.
OVERRIDE	logical		If `True` do not match to and accept an existing primary target. Instead, always generate a new `TARGETID`.
FLUX_G	float32	nanomaggy	LS flux from tractor input (g)
FLUX_R	float32	nanomaggy	LS flux from tractor input (r)
FLUX_Z	float32	nanomaggy	LS flux from tractor input (z)
PARALLAX	float32	mas	Reference catalog parallax
GAIA_PHOT_G_MEAN_MAG	float32	mag	Gaia G band magnitude
GAIA_PHOT_BP_MEAN_MAG	float32	mag	Gaia BP band magnitude
GAIA_PHOT_RP_MEAN_MAG	float32	mag	Gaia RP band magnitude
GAIA_ASTROMETRIC_EXCESS_NOISE	float32		Gaia astrometric excess noise
TARGETID	int64		Unique targeting ID
DESI_TARGET	int64		DESI (dark time program) target selection bitmask
SCND_TARGET	int64		SCND (secondary program) target selection bitmask
SCND_ORDER	int32		Row in which this target appeared in the input secondary target file