SPARCL - SPARCL Field Catalog (SFC)

SPARCL Field Catalog

List of Fields available via Retrieve

CORE fields (common to all Data Sets)

Name Storage Units Description Default All
sparcl_id CORE Universally Unique Identifier for spectrum in SPARCL
dec CORE deg Declination in degrees
specid CORE Dataset-specific spectrum identifier (may not be unique)
ra CORE deg Right Ascension in degrees
updated CORE Date and time when the record was created/updated
site CORE [Categorical] Site of observations
datasetgroup CORE [Categorical] Common name for a coherent set of spectra published as a single release (e.g., SDSS_BOSS)
instrument CORE [Categorical] Instrument used for observation
redshift CORE Measured redshift, or radial velocity in units of redshift
targetid CORE Dataset-specific photometric target identifier
specprimary CORE Whether an entry is the primary spectrum for a given target object
data_release CORE [Categorical] Data release of a given record (with a common data structure, e.g., SDSS-DR16, BOSS-DR16)
wavemin CORE AA Minimum value of wavelength coverage in Angstroms
spectype CORE [Categorical] Spectral type of the object (STAR, GALAXY, QSO)
telescope CORE [Categorical] Telescope used for the observation
redshift_err CORE Uncertainty on the measured redshift, or radial velocity in units of redshift
wavemax CORE AA Maximum value of wavelength coverage in Angstroms
extra_files CORE Additional files read for ingest
exptime CORE second Exposure time in seconds
file CORE File used for this record
dateobs CORE Range of observational dates for a given spectrum (single value for a single date)
redshift_warning CORE Bitmask with warning on redshift result
dateobs_center CORE Central value of the dateobs range
Download .csv Download .json

AUX and SPECTRA fields (unique to each Data Set)

Data Set: SDSS-DR16, AUX fields

Name Storage Units Description Default All
tfile AUX File that best fit template comes from in idlspec2d product
theta AUX Template coefficients of best fit
thing_id AUX Resolve THING_ID in SDSS imaging for best positional match
thing_id_targeting AUX Resolve THING_ID in SDSS imaging for targeted object
tile AUX Tile number (each tile can have several plates drilled for it)
vdisp AUX km s-1 Velocity dispersion
vdispchi2 AUX Chi-squared for best-fit velocity dispersion
vdispdof AUX Number of degrees of freedom in velocity dispersion fit
vdisp_err AUX km s-1 Error in velocity dispersion
vdispnpix AUX Number of pixels overlapping the templates used in the velocity dispersion fit
vdispz AUX Redshift associated with best-fit velocity dispersion
vdispz_err AUX Error in redshift associated with best-fit velocity dispersion
wcoverage AUX Coverage in wavelength, in units of log10 wavelength
xfocal AUX mm Hole position on plate (+X = +RA)
yfocal AUX mm Hole position on plate (+Y = +DEC)
z_conf_person AUX Visual-inspection confidence (0=not inspected or no confidence, 1,2=low confidence, 3,4=high confidence)
z_err_noqso AUX Error in Z_NOQSO redshift
z_noqso AUX Best redshift when ignoring QSO fits, recommended for BOSS CMASS and LOWZ targets; calculated only for survey=boss spectra, not for any SDSS spectrograph data
zoffset AUX micron Washer thickness used for backstopping BOSS quasar targets, so they are closer to 4000 Angstrom focal plan
z_person AUX Visual-inspection redshift
zwarning_noqso AUX Warnings in z_noqso redshift (BOSS spectra only)

Data Set: SDSS-DR16, SPECTRA fields

Name Storage Units Description Default All
mask SPECTRA and_mask
flux SPECTRA 1e-17 erg cm-2 s-1 AA-1 Coadded calibrated flux
ivar SPECTRA 1e+34 cm4 s2 AA2 erg-2 Inverse variance of flux
wave_sigma SPECTRA pixel Line-spread function width (sigma of approximating Gaussian) in units of number of pixel
model SPECTRA 1e-17 erg cm-2 s-1 AA-1 Pipeline best model fit used for classification and redshift
sky SPECTRA 1e-17 erg cm-2 s-1 AA-1 Subtracted sky flux
wavelength SPECTRA AA Wavelength in units of Angstroms

Data Set: BOSS-DR16, AUX fields

Name Storage Units Description Default All
ancillary_target1 AUX BOSS ancillary science target selection information at plate design
ancillary_target2 AUX BOSS ancillary target selection information at plate design
anyandmask AUX For each bit, records whether any pixel in the spectrum has that bit set in its ANDMASK
anyormask AUX For each bit, records whether any pixel in the spectrum has that bit set in its ORMASK
bluefiber AUX Set to 1 if this was requested to be a blue fiber target, 0 if it was a red fiber (in BOSS high redshift LRGs are requested to be on red fibers)
boss_specobj_id AUX Identification number internal to BOSS for SPECBOSS=1 objects
boss_target1 AUX Primary (science) target flags for BOSS targets
boss_target2 AUX Always set to zero (placeholder for BOSS target flags never used)
calibflux AUX nanomaggy ugriz fluxes used for calibrations
calibflux_ivar AUX nanomaggy-2 Inverse variances of ugriz fluxes used for calibrations
chi68p AUX 68-th percentile value of abs(chi) of the best-fit synthetic spectrum to the actual spectrum (around 1.0 for a good fit)
chunk AUX Name of tiling chunk that this spectrum was tiled in (boss1, boss2, etc), important for tracking large-scale structure samples
class_noqso AUX Spectroscopic classification for Z_NOQSO redshift
class_person AUX Visual-inspection classification (0=not inspected or unknown, 1=star, 2=narrow emission-line galaxy, 3=QSO, 4=galaxy)
comments_person AUX Visual-inspection comments
cx AUX x of Normal unit vector in J2000
cy AUX y of Normal unit vector in J2000
cz AUX z of Normal unit vector in J2000
deredsn2 AUX Dereddened overall signal-to-noise-squared measure for plate (only for BOSS spectrograph plates)
designid AUX Design identification number for plate
dof AUX Number of degrees of freedom in best fit
eboss_target0 AUX SEQUELS, TDSS and SPIDERS target selection flags
eboss_target1 AUX eBOSS, TDSS and SPIDERS target selection flags for main eBOSS survey
eboss_target2 AUX eBOSS, TDSS and SPIDERS target selection flags for main eBOSS survey
eboss_target_id AUX EBOSS unique target identifier for every spectroscopic target

Data Set: BOSS-DR16, SPECTRA fields

Name Storage Units Description Default All
wave_sigma SPECTRA pixel Line-spread function width (sigma of approximating Gaussian) in units of number of pixel
wavelength SPECTRA AA Wavelength in units of Angstroms
sky SPECTRA 1e-17 erg cm-2 s-1 AA-1 Subtracted sky flux
model SPECTRA 1e-17 erg cm-2 s-1 AA-1 Pipeline best model fit used for classification and redshift
mask SPECTRA and_mask
ivar SPECTRA 1e+34 cm4 s2 AA2 erg-2 Inverse variance of flux
flux SPECTRA 1e-17 erg cm-2 s-1 AA-1 Coadded calibrated flux

Data Set: DESI-DR1, AUX fields

Name Storage Units Description Default All
numobs_init AUX Initial number of observations for target calculated across target selection bitmasks and OBSCONDITIONS
objtype AUX Object type: TGT, SKY, NON, BAD
obsconditions AUX Bit-coded of allowed observing conditions
plate_dec AUX deg Declination to be used by PlateMaker
plate_ra AUX deg Right Ascension to be used by PlateMaker
pmdec AUX mas year-1 Reference catalog proper motion in the Dec direction
pmra AUX mas year-1 Reference catalog proper motion in the RA direction
priority_init AUX Target initial priority from target selection bitmasks and OBSCONDITIONS
program AUX DESI program type - BRIGHT, DARK, BACKUP, OTHER
ref_epoch AUX year Reference epoch for Gaia/Tycho astrometry. Typically 2015.5 for Gaia
rms_delta_x AUX mm RMS (over exposures) of the fiber difference between measured and requested CS5 X location on focal plane
rms_delta_y AUX mm RMS (over exposures) of the fiber difference between measured and requested CS5 Y location on focal plane
scnd_target AUX Target selection bitmask for secondary programs
spgrpval AUX Value corresponding to the grouping type indicated in the spgrp column. This is the same as the healpix column
std_fiber_dec AUX arcsec Standard deviation (over exposures) of DEC of actual fiber position
std_fiber_ra AUX arcsec Standard deviation (over exposures) of RA of actual fiber position
subpriority AUX Random subpriority [0-1] to break assignment ties
subtype AUX Spectral subtype
survey AUX Survey name
sv1_bgs_target AUX BGS (bright time program) target selection bitmask for SV1
sv1_desi_target AUX DESI (dark time program) target selection bitmask for SV1
sv1_mws_target AUX MWS (bright time program) target selection bitmask for SV1
sv1_scnd_target AUX Secondary target selection bitmask for SV1
sv2_bgs_target AUX BGS (bright time program) target selection bitmask for SV2
sv2_desi_target AUX DESI (dark time program) target selection bitmask for SV2

Data Set: DESI-DR1, SPECTRA fields

Name Storage Units Description Default All
wave_sigma SPECTRA AA Line-spread function width (sigma of approximating Gaussian) in units of Angstroms
wavelength SPECTRA AA Wavelength in units of Angstroms
model SPECTRA 1e-17 erg cm-2 s-1 AA-1 Pipeline best model fit
mask SPECTRA Mask value
ivar SPECTRA 1e+34 cm4 s2 AA2 erg-2 Inverse variance of flux
flux SPECTRA 1e-17 erg cm-2 s-1 AA-1 Coadded calibrated flux

Data Set: DESI-EDR, AUX fields

Name Storage Units Description Default All
sv2_scnd_target AUX Secondary target selection bitmask for SV2
sv3_bgs_target AUX BGS (bright time program) target selection bitmask for SV3
sv3_desi_target AUX DESI (dark time program) target selection bitmask for SV3
sv3_mws_target AUX MWS (bright time program) target selection bitmask for SV3
sv3_scnd_target AUX Secondary target selection bitmask for SV3
sv_nspec AUX Number of coadded spectra for this TARGETID in SV (SV1+2+3)
sv_primary AUX Boolean flag (True/False) for the primary coadded spectrum in SV (SV1+2+3)
tsnr2_bgs AUX BGS template (S/N)^2 summed over B,R,Z
tsnr2_elg AUX ELG template (S/N)^2 summed over B,R,Z
tsnr2_gpbbackup AUX GPBBACKUP template (S/N)^2 summed over BRZ
tsnr2_gpbbright AUX GPBBRIGHT template (S/N)^2 summed over B,R,Z
tsnr2_gpbdark AUX GPBDARK template (S/N)^2 summed over BRZ
tsnr2_lrg AUX LRG template (S/N)^2 summed over B,R,Z
tsnr2_lya AUX LYA template (S/N)^2 summed over B,R,Z
tsnr2_qso AUX QSO template (S/N)^2 summed over B,R,Z
zcat_nspec AUX Number of coadded spectra for this TARGETID in this zcatalog

Data Set: DESI-EDR, SPECTRA fields

Name Storage Units Description Default All
flux SPECTRA 1e-17 erg cm-2 s-1 AA-1 Coadded calibrated flux
ivar SPECTRA 1e+34 cm4 s2 AA2 erg-2 Inverse variance of flux
wave_sigma SPECTRA AA Line-spread function width (sigma of approximating Gaussian) in units of Angstroms
mask SPECTRA Mask value
model SPECTRA 1e-17 erg cm-2 s-1 AA-1 Pipeline best model fit
wavelength SPECTRA AA Wavelength in units of Angstroms

Data Set: SDSS-DR17-test, AUX fields

Name Storage Units Description Default All
ancillary_target1 AUX BOSS ancillary science target selection information at plate design
ancillary_target2 AUX BOSS ancillary target selection information at plate design
anyandmask AUX For each bit, records whether any pixel in the spectrum has that bit set in its ANDMASK
anyormask AUX For each bit, records whether any pixel in the spectrum has that bit set in its ORMASK
bluefiber AUX Set to 1 if this hole was designated a blue fiber, 0 if designated a red fiber (high redshift LRGs are preferentially in red fibers)
boss_specobj_id AUX Identification number internal to BOSS for SPECBOSS=1 objects
boss_target1 AUX Primary (science) target flags for BOSS targets
boss_target2 AUX Always set to zero (placeholder for BOSS target flags never used)
calibflux AUX nanomaggy ugriz fluxes used for calibrations
calibflux_ivar AUX nanomaggy-2 Inverse variances of ugriz fluxes used for calibrations
chi68p AUX 68-th percentile value of abs(chi) of the best-fit synthetic spectrum to the actual spectrum (around 1.0 for a good fit)
chunk AUX Name of tiling chunk that this spectrum was tiled in (boss1, boss2, etc), important for tracking large-scale structure samples
class_noqso AUX Spectroscopic classification for Z_NOQSO redshift
class_person AUX Visual-inspection classification (0=not inspected or unknown, 1=star, 2=narrow emission-line galaxy, 3=QSO, 4=galaxy)
comments_person AUX Visual-inspection comments
cx AUX x of Normal unit vector in J2000
cy AUX y of Normal unit vector in J2000
cz AUX z of Normal unit vector in J2000
deredsn2 AUX Dereddened overall signal-to-noise-squared measure for plate (only for BOSS spectrograph plates)
designid AUX Design identification number for plate
dof AUX Number of degrees of freedom in best fit
eboss_target1 AUX eBOSS, TDSS and SPIDERS target selection flags for main eBOSS survey
eboss_target2 AUX eBOSS, TDSS and SPIDERS target selection flags for main eBOSS survey
eboss_target_id AUX EBOSS unique target identifier for every spectroscopic target
elodie_bv AUX mag (B-V) color index for ELODIE star

Data Set: SDSS-DR17-test, SPECTRA fields

Name Storage Units Description Default All
flux SPECTRA 1e-17 erg cm-2 s-1 AA-1 Coadded calibrated flux
ivar SPECTRA 1e+34 cm4 s2 AA2 erg-2 Inverse variance of flux
mask SPECTRA and_mask
model SPECTRA 1e-17 erg cm-2 s-1 AA-1 Pipeline best model fit used for classification and redshift
sky SPECTRA 1e-17 erg cm-2 s-1 AA-1 Subtracted sky flux
wavelength SPECTRA AA Wavelength in units of Angstroms
wave_sigma SPECTRA pixel Line-spread function width (sigma of approximating Gaussian) in units of number of pixel
SPARCL Field Cat(alog)