mtl-dark-hp-HPX.rst

mtl-dark-hp-HPX

Summary

MTL ledgers for the DESI dark-time program.

Naming Convention

mtl-dark-hp-HPX.ecsv, where HPX is the nside=32 (NESTED) HEALPixel integer.

Regex

mtl-dark-hp-[0-12287]\.ecsv

File Type

ecsv, 0-10 MB

Contents

EXTNAME	Type	Contents
MTL	TABLE	MTL Ledger

Required Header Keywords

KEY	Example Value	Type	Comment
DR	9	int	Legacy Surveys Data Release used to produce the targets (should always be 9)
FILEHPX	4447	int	HEALPixel integer for the file
FILENEST	True	bool	If the HEALPixel NESTED scheme was used for the file (should always be True)
FILENSID	32	int	HEALPixel nside used for the file (should always be 32)
INDIR	dr9/1.1.1/targets/main/resolve/dark	str	Location of the directory of targets used to produce the file
OBSCON	DARK	str	DESI program (DARK, BRIGHT or BACKUP)
SCND	False	bool	Whether the file is a ledger of primary or secondary targets
SURVEY	main	str	DESI survey phase (main, sv2 or sv3)
TSFORCED	2021-05-13T08:15:37+00:00	str	UTC/ISO TIMESTAMP that was specified to produce initial ledgers

Required Data Table Columns

Name	Type	Units	Description
RA	float64	deg	Right ascension
DEC	float64	deg	Declination
REF_EPOCH	float32	yr	Reference epoch for Gaia/Tycho astrometry
PARALLAX	float32	mas	Parallax
PMRA	float32	mas/yr	Proper motion in the RA direction
PMDEC TARGETID DESI_TARGET BGS_TARGET MWS_TARGET SUBPRIORITY OBSCONDITIONS PRIORITY_INIT NUMOBS_INIT SCND_TARGET NUMOBS_MORE NUMOBS Z ZWARN ZTILEID Z_QN IS_QSO_QN DELTACHI2 TARGET_STATE	float32 int64 int64 int64 int64 float64 int32 int64 int64 int64 int64 int64 float64 int64 int32 float64 int16 float64 char[18]	mas/yr	Proper motion in the Dec direction Unique DESI targeting ID DESI (dark time program) target selection bitmask BGS (bright time program) target selection bitmask MWS (bright time program) target selection bitmask Random subpriority [0-1] to break assignment ties Observing conditions/program bitmask (bright/dark/backup/etc.) Target's initial priority from target selection bitmasks and OBSCONDITIONS Target's initial desired number of observations Target selection bitmask for secondary programs Desired number of observations given target's current state Number of (good) observations of target acquired so far Redshift measured by Redrock Redshift warning bitmask measured by Redrock ID of tile that most recently updated target's state Redshift measured by QuasarNET Classification determined by QuasarNET (1=QSO) Delta-chi-squared for template fit from Redrock Combination of target's class and its current observational state
TIMESTAMP VERSION PRIORITY	char[25] char[5] int64	s	UTC/ISO time at which the target's state was updated Version of desitarget code used to update target's state Target's current priority