input secondary targets

Summary:

DESI secondary target input files contain the targets provided with a given secondary proposal. They can consist of either a binary fits table or a text file.

Naming Convention:

BITNAME.fits or BITNAME.txt, 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|txt)

File Type:

FITS or text, 10 KB - 900 MB

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

Number	EXTNAME	Type	Contents
HDU0		IMAGE	Empty
HDU1	NONE	BINTABLE	Input secondary targets

FITS Header Units

HDU0

This HDU has no non-standard required keywords.

Empty HDU.

HDU1

EXTNAME = NONE

Input secondary targets

Required Header Keywords

Required Header Keywords Table

KEY	Example Value	Type	Comment
NAXIS1	29	int	width of table in bytes
NAXIS2	2772483	int	number of rows in table

Required Data Table Columns

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.

Notes

For .fits files, a subset of the columns must correspond to the Required Data Table Columns listed above. Any other columns can exist and can be populated with any values.

For .txt files the first 6 columns must correspond to the Required Data Table Columns listed above. Subsequent columns can contain any additional information. The # may be included as a comment card. For objects with low proper motion, zero can be passed for the proper motion columns. If zero is passed for REF_EPOCH, it will be interpreted to be 2015.5.