ToO-fiber

Summary:

Targets of Opportunity ledger (used to override fibers on regular, main survey tiles).

Naming Convention:

ToO-fiber.ecsv

Regex:

ToO-fiber\.ecsv

File Type:

ecsv, about 100 KB

Contents

EXTNAME

Type

Contents

TOO

TABLE

ToO Ledger

Required Header Keywords

KEY

Example Value

Type

Comment

RELEASE

9999

int

Ersatz Legacy Surveys RELEASE used for Targets of Opportunity (always 9999)

Required Data Table Columns

Name

Type

Units

Description

RA

float64

deg

Right ascension

DEC

float64

deg

Declination

PMRA

float64

mas/yr

Proper motion in the RA direction

PMDEC

float64

mas/yr

Proper motion in the Dec direction

REF_EPOCH

float64

yr

Reference epoch for Gaia/Tycho astrometry

FLUX_G

float32

nanomaggy

Flux in the Legacy Survey g-band (placeholder; needed by fiberassign)

FLUX_R

float32

nanomaggy

Flux in the Legacy Survey r-band (placeholder; needed by fiberassign)

FLUX_Z

float32

nanomaggy

Flux in the Legacy Survey z-band (placeholder; needed by fiberassign)

PARALLAX

float32

mas

Parallax (placeholder; needed by fiberassign)

GAIA_PHOT_G_MEAN_MAG

float32

mag

Magnitude in the Gaia G-band (placeholder; needed by fiberassign)

GAIA_PHOT_BP_MEAN_MAG

float32

mag

Magnitude in the Gaia BP-band (placeholder; needed by fiberassign)

GAIA_PHOT_RP_MEAN_MAG

float32

mag

Magnitude in the Gaia RP-band (placeholder; needed by fiberassign)

GAIA_ASTROMETRIC_EXCESS_NOISE

float32

Gaia astrometric excess noise (placeholder; needed by fiberassign)

TARGETID

int64

Unique DESI targeting ID

DESI_TARGET

int64

DESI (dark time program) target selection bitmask

SCND_TARGET

int64

Target selection bitmask for DESI secondary programs

SCND_ORDER

int32

Number of row for target entry in secondary file (placeholder; needed by fiberassign)

PRIORITY_INIT

int64

Target’s initial priority from target selection bitmasks and OBSCONDITIONS

SUBPRIORITY

float64

Random subpriority [0-1] to break assignment ties

NUMOBS_INIT

int64

Target’s initial desired number of observations

OBSCONDITIONS

int64

Observing conditions/program bitmask (bright/dark/backup/etc.)

CHECKER

char[2]

Initials of researcher who vetted the target

TOO_TYPE

char[4]

Either “TILE” for a special tile or “FIBER” for a fiber-override ToO

TOO_PRIO

char[2]

Either “HI” for a very-high-priority target or “LO” for a very-low-priority target

OCLAYER

char[6]

Either “DARK” for dark-time or “BRIGHT” to observe in either bright- or dark-time

MJD_BEGIN

float64

d

Start of the allowed observing window for this target (Modified Julian Date)

MJD_END

float64

d

End of the allowed observing window for this target (Modified Julian Date)

TOOID

int64

ID for this target assigned by the CHECKER

TIMESTAMP

char[25]

s

UTC/ISO time at which the target was added to the ToO ledger

Notes

The unit nanomaggy in this file is actually recorded as nmgy. This unit will be read correctly into an astropy table from a .ecsv file.