Throughout this page <region>
denotes either north
for BASS/MzLS or south
for DECaLS.
Directory Structures
For Web Access
At NERSC (for collaborators)
Summary Files
survey-bricks.fits.gz
FITS binary table with the RA, Dec bounds of each geometrical "brick" on the sky. This includes all bricks on the sky, not just the ones in our footprint or with coverage in DR9. For that information, see the next file description.
Column |
Type |
Description |
---|---|---|
|
char[8] |
Name of the brick. |
|
int32 |
A unique integer with 1-to-1 mapping to |
|
int16 |
A "priority" factor used for processing. |
|
int32 |
Dec row number. |
|
int32 |
Number of the brick within a Dec row. |
|
float64 |
RA of the center of the brick. |
|
float64 |
Dec of the center of the brick. |
|
float64 |
Lower RA boundary. |
|
float64 |
Upper RA boundary. |
|
float64 |
Lower Dec boundary. |
|
float64 |
Upper Dec boundary. |
<region>/survey-bricks-dr9-<region>.fits.gz
A FITS binary table with information that summarizes the contents of each brick for a region of DR9.
Column |
Type |
Description |
---|---|---|
|
char[8] |
Name of the brick. |
|
float64 |
RA of the center of the brick. |
|
float64 |
Dec of the center of the brick. |
|
int16 |
Median number of exposures in the unique area (i.e. |
|
int16 |
Median number of exposures in the unique area of the brick in r-band. |
|
int16 |
Median number of exposures in the unique area of the brick in z-band. |
|
int32[6] |
Histogram of number of pixels in the unique brick area with 0, 1, 2, 3, 4, or > 5 exposures in g. |
|
int32[6] |
Histogram of number of pixels in the unique brick area with 0, 1, 2, 3, 4, or > 5 exposures in r. |
|
int32[6] |
Histogram of number of pixels in the unique brick area with 0, 1, 2, 3, 4, or > 5 exposures in z. |
|
int16 |
Total number of |
|
int16 |
Total number of |
|
int16 |
Total number of |
|
int16 |
Total number of |
|
int16 |
Total number of |
|
int16 |
Total number of |
|
int16 |
Total number of |
|
int16 |
Total number of |
|
int16 |
Total number of |
|
float32 |
Median PSF size, in arcsec, evaluated at the |
|
float32 |
Median PSF size, in arcsec, evaluated at the |
|
float32 |
Median PSF size, in arcsec, evaluated at the |
|
float32 |
5-sigma PSF detection depth in \(g\)-band (AB mag), using PsfEx PSF model. |
|
float32 |
5-sigma PSF detection depth in \(r\)-band (AB mag), using PsfEx PSF model. |
|
float32 |
5-sigma PSF detection depth in \(z\)-band (AB mag), using PsfEx PSF model. |
|
float32 |
5-sigma galaxy (0.45" round exp) detection depth in \(g\)-band (AB) mag. |
|
float32 |
5-sigma galaxy (0.45" round exp) detection depth in \(r\)-band (AB) mag. |
|
float32 |
5-sigma galaxy (0.45" round exp) detection depth in \(z\)-band (AB) mag. |
|
float32 |
Median SFD98 dust map E(B-V) extinction, in magnitudes, evaluated at |
|
float32 |
Median Milky Way dust transparency in \(g\)-band, based on |
|
float32 |
Median Milky Way dust transparency in \(g\)-band, based on |
|
float32 |
Median Milky Way dust transparency in \(z\)-band, based on |
|
float32 |
Estimated sky level in the coadded images (stacks) in \(g\)-band [1]. |
|
float32 |
Estimated sky level in the coadded images (stacks) in \(r\)-band. |
|
float32 |
Estimated sky level in the coadded images (stacks) in \(z\)-band. |
|
float32 |
Extinction in \(g\)-band. |
|
float32 |
Extinction in \(r\)-band. |
|
float32 |
Extinction in \(z\)-band. |
|
int16[4] |
Number of images that contributed to WISE calculations in each filter (not profile-weighted). |
|
float32[4] |
Median Milky Way dust transparency in WISE bands, based on |
|
float32 |
Extinction in \(W1\)-band. |
|
float32 |
Extinction in \(W2\)-band. |
|
float32 |
Extinction in \(W3\)-band. |
|
float32 |
Extinction in \(W4\)-band. |
|
int16 |
A unique integer with 1-to-1 mapping to |
|
float32 |
Lower RA boundary. |
|
float32 |
Upper RA boundary. |
|
float32 |
Lower Dec boundary. |
|
float32 |
Upper Dec boundary. |
|
float32 |
Area of the brick in square degrees. |
|
boolean |
|
|
boolean |
|
Note that, for the nexphist
rows, pixels that are masked by the NOIRLab Community Pipeline as, e.g., cosmic rays or saturation
(see, e.g. the ALLMASK/ANYMASK
information on the DR9 bitmasks page), do
not count toward the number of exposures. More information about the morphological types and MW_TRANSMISSION
can be found on
the catalogs page.
survey-ccds-<camera>-dr9.fits.gz
A FITS binary table with almanac information about each individual CCD image for each camera (where <camera>
is one of 90prime
for BASS, decam
for DECaLS or mosaic
for MzLS).
This file contains information regarding the photometric and astrometric zero points for each CCD of every image that is part of the DR9 data release. Photometric zero points for each CCD are computed by identifying stars and comparing their instrumental magnitudes to color-selected stars in the PanSTARRS "qz" catalog.
The photometric zeropoints (zpt
, ccdzpt
, etc)
are magnitude-like numbers (e.g. 25.04), and
indicate the magnitude of a source that would contribute one count per
second to the image. For example, in an image with zeropoint of 25.04
and exposure time of 30 seconds, a source of magnitude 22.5 would
contribute
\(30 \times 10^{((25.04 - 22.5) / 2.5)} = 311.3\)
counts.
Column |
Type |
Description |
---|---|---|
|
char[120] |
Path to FITS image, e.g. "north/DECam_CP/CP20170729/c4d_170730_045351_ooi_g_v1.fits.fz". |
|
int16 |
FITS HDU number in the |
|
char[X] |
The camera that took this image (X is 7 for "90prime", 6 for "mosaic" and 5 for "decam"). |
|
int64 |
Exposure number, e.g. 348224. |
|
char[8] |
Community Pipeline (CP) version number. |
|
char[19] |
CP processing date. |
|
char[7] |
Unique, time-based, CP processing hash - see the plprocid page for how to convert this to a date. |
|
char[X] |
CCD name, e.g. "N10", "S7" for DECam (X is 4 for 90prime and mosaic CCDs, and 3 for decam). |
|
char[35] |
Name listed in the object tag from the CCD header. |
|
char[10] |
Proposal ID of the program that took this image, eg "2014B-0404". |
|
char[1] |
Filter used for observation, e.g. "\(g\)", "\(r\)", "\(z\)". |
|
float32 |
Exposure time in seconds, e.g. 30. |
|
float64 |
Date of observation in MJD (in UTC system), e.g. 56884.99373389. |
|
float32 |
Airmass of observation (measured at the telescope bore-sight). |
|
float32 |
FWHM (in pixels) measured by the CP. |
|
int16 |
Width in pixels of this image, e.g. 2046. |
|
int16 |
Height in pixels of this image, e.g. 4096. |
|
float64 |
Telescope boresight RA of this exposure (deg). |
|
float64 |
Telescope boresight Dec of this exposure (deg). |
|
float32 |
Astrometric header value: X reference pixel. |
|
float32 |
Astrometric header value: Y reference pixel. |
|
float64 |
Astrometric header value: RA of reference pixel. |
|
float64 |
Astrometric header value: Dec of reference pixel. |
|
float32 |
Astrometric header value: transformation matrix. |
|
float32 |
Astrometric header value: transformation matrix. |
|
float32 |
Astrometric header value: transformation matrix. |
|
float32 |
Astrometric header value: transformation matrix. |
|
boolean |
(ignore; it's always |
|
float64 |
Approximate RA center of this CCD (deg). |
|
float64 |
Approximate Dec center of this CCD (deg). |
|
float32 |
Sky rms for the entire image (in counts/second). |
|
float32 |
Median per-pixel error standard deviation, in nanomaggies. |
|
float32 |
Zeropoint for the CCD (AB mag). |
|
float32 |
Median zero point for the entire image (median of all CCDs of the image), e.g. 25.0927. |
|
float32 |
Median astrometric offset for the CCD <GAIA-Legacy Survey> in arcsec. |
|
float32 |
Median astrometric offset for the CCD <GAIA-Legacy Survey> in arcsec. |
|
float32 |
Mean sky counts level per pixel (AVSKY divided by EXPTIME) in the CP-processed frames measured (with iterative rejection) for each CCD in the image section [500:1500,1500:2500]. DECam exposure data is in electrons. Mosaic and 90prime are in electrons/sec. Sky counts are normalized to maintain a mean level from the original gain-corrected ADU. |
|
float32 |
rms in astrometric offset for the CCD <Gaia-Legacy Survey> in arcsec. |
|
float32 |
rms in astrometric offset for the CCD <Gaia-Legacy Survey> in arcsec. |
|
float32 |
Photometric rms for the CCD (in mag). |
|
float32 |
Median photometric rms across all CCDs in the image (in mag). |
|
int16 |
Number of stars (after sigma-clipping) used to compute astrometric correction. |
|
int16 |
Number of Gaia+PS1 stars detected with signal-to-noise ratio greater than five. |
|
int32 |
Bit mask describing CCD image quality (see the DR9 bitmasks page). |
survey-ccds-<camera>-dr9.kd.fits
As for the survey-ccds-<camera>-dr9.fits.gz files but limited by the depth of each observation. These files contain the CCDs actually used for the DR9 reductions. Columns are the same as for the survey-ccds-<camera>-dr9.fits.gz files.
ccds-annotated-<camera>-dr9.fits.gz
Versions of the survey-ccds-<camera>-dr9.fits.gz files with additional information gathered during calibration pre-processing before running the Tractor reductions.
Includes all of the columns in the survey-ccds-<camera>-dr9.fits.gz files plus the columns
listed below. Note that string columns can have different lengths in the survey-ccds-<camera>-dr9.fits.gz
and ccds-annotated-<camera>-dr9.fits.gz files. For example the camera
column can change from
char[9]
to char[7]
(see, e.g. legacypipe issue #379).
Column |
Type |
Description |
---|---|---|
|
boolean |
|
|
int16[4] |
If only a subset of the CCD images was used, this array of x0,x1,y0,y1 values gives the coordinates that were used, [x0,x1), [y0,y1). -1 for no cut (most CCDs) |
|
float64 |
RA coordinate of pixel (1,1)...Note that the ordering of the CCD corners is detailed here |
|
float64 |
Dec coordinate of pixel (1,1) |
|
float64 |
RA coordinate of pixel (1,H) |
|
float64 |
Dec coordinate of pixel (1,H) |
|
float64 |
RA coordinate of pixel (W,H) |
|
float64 |
Dec coordinate of pixel (W,H) |
|
float64 |
RA coordinate of pixel (W,1) |
|
float64 |
Dec coordinate of pixel (W,1) |
|
float32 |
Maximum distance from RA,Dec center to the edge midpoints, in RA |
|
float32 |
Maximum distance from RA,Dec center to the edge midpoints, in Dec |
|
float64 |
RA coordinate of CCD center |
|
float64 |
Dec coordinate of CCD center |
|
float32 |
Our pipeline (not the CP) estimate of the sky level, average over the image, in nanomaggies |
|
float32 |
Standard deviation of our sky level, in nanomaggies |
|
float32 |
Max of our sky level, in nanomaggies |
|
float32 |
Min of our sky level, in nanomaggies |
|
float32 |
Pixel scale (via sqrt of area of a 10x10 pixel patch evaluated in a 5x5 grid across the image), in arcsec/pixel. |
|
float32 |
Standard deviation of pixel scale |
|
float32 |
Max of pixel scale |
|
float32 |
Min of pixel scale |
|
float32 |
PSF norm = 1/sqrt of N_eff = sqrt(sum(psf_i^2)) for normalized PSF pixels i; mean of the PSF model evaluated on a 5x5 grid of points across the image. Point-source detection standard deviation is |
|
float32 |
Standard deviation of PSF norm |
|
float32 |
Norm of the PSF model convolved by a 0.45" exponential galaxy. |
|
float32 |
Standard deviation of galaxy norm. |
|
float32 |
PSF model second moment in x (pixels^2) |
|
float32 |
PSF model second moment in y (pixels^2) |
|
float32 |
PSF model second moment in x-y (pixels^2) |
|
float32 |
PSF model major axis (pixels) |
|
float32 |
PSF model minor axis (pixels) |
|
float32 |
PSF position angle (deg) |
|
float32 |
PSF ellipticity 1 - minor/major |
|
float32 |
Percent humidity outside |
|
float32 |
Outside temperate (deg C). |
|
int32 |
tile number, 0 for data from programs other than MzLS or DECaLS |
|
uint8 |
tile pass number, 1, 2 or 3, if this was an MzLS or DECaLS observation, or 0 for data from other programs. Set by the observers (the meaning of |
|
float32 |
Mean SFD98 E(B-V) extinction in the tile, 0 for data from programs other than BASS, MzLS or DECaLS |
|
float32 |
SFD98 E(B-V) extinction for CCD center |
|
float32[6] |
Extinction for optical filters \(ugrizY\) |
|
float32[4] |
Extinction for WISE bands W1,W2,W3,W4 |
|
float32 |
5-sigma PSF detection depth in AB mag, using PsfEx PSF model |
|
float32 |
5-sigma galaxy (0.45" round exp) detection depth in AB mag |
|
float32 |
5-sigma PSF detection depth in AB mag, using Gaussian PSF approximation (using |
|
float32 |
5-sigma galaxy detection depth in AB mag, using Gaussian PSF approximation |
ccds-annotated-<camera>-dr9.kd.fits
As for the ccds-annotated-<camera>-dr9.fits.gz files but limited by the depth of each observation. These files contain the CCDs actually used for the DR9 reductions. Columns are the same as for the ccds-annotated-<camera>-dr9.fits.gz files.
<region>/dr9-<region>-depth.fits.gz
A concatenation of the depth histograms for each brick, for each region, from the
coadd/*/*/*-depth.fits
tables. HDU1 contains histograms that describe the
number of pixels in each brick with a 5-sigma AB depth in the given magnitude
bin. HDU2 contains the bin edges of the histograms.
HDU1
Column |
Type |
Description |
---|---|---|
|
int32[50] |
Histogram of pixels for point source depth in \(g\) band |
|
int32[50] |
Histogram of pixels for canonical galaxy depth in \(g\) band |
|
int32[50] |
Histogram of pixels for point source depth in \(r\) band |
|
int32[50] |
Histogram of pixels for canonical galaxy depth in \(r\) band |
|
int32[50] |
Histogram of pixels for point source depth in \(z\) band |
|
int32[50] |
Histogram of pixels for canonical galaxy depth in \(z\) band |
|
char[8] |
Name of the brick |
HDU2
Column |
Type |
Description |
---|---|---|
|
float32 |
Lower bin edge for each histogram in HDU1 (5-sigma AB depth) |
|
float32 |
Upper bin edge for each histogram in HDU1 (5-sigma AB depth) |
<region>/dr9-<region>-depth-summary.fits.gz
A summary of the depth histogram for a region of DR9. FITS table with the following columns:
Column |
Type |
Description |
---|---|---|
|
float32 |
Lower limit of the depth bin |
|
float32 |
Upper limit of the depth bin |
|
int64 |
Number of pixels in histogram for point source depth in \(g\) band |
|
int64 |
Number of pixels in histogram for canonical galaxy depth in \(g\) band |
|
int64 |
Number of pixels in histogram for point source depth in \(r\) band |
|
int64 |
Number of pixels in histogram for canonical galaxy depth in \(r\) band |
|
int64 |
Number of pixels in histogram for point source depth in \(z\) band |
|
int64 |
Number of pixels in histogram for canonical galaxy depth in \(z\) band |
The depth histogram runs from magnitude of 20.1 to 24.9 in steps of 0.1 mag. The first and last bins are "catch-all" bins: 0 to 20.1 and 24.9 to 100, respectively. The histograms count the number of pixels in each brick's unique area with the given depth. These numbers can be turned into values in square degrees using the brick pixel area of 0.262 arcseconds square. These depth estimates take into account the small-scale masking (cosmic rays, edges, saturated pixels) and detailed PSF model.
Random Catalogs (randoms/*
)
randoms-1-*.fits
Twenty files of random points sampled across the CCDs that comprise the geometry of DR9 (see Myers et al. 2023). Random locations
were generated across the footprint at a density of 2,500 per square degree and meta-information
about the survey was extracted from pixels at each random location from files in the coadd
directory (see below, e.g.
coadd/*/*/*-depth-<filter>.fits.fz
, coadd/*/*/*-galdepth-<filter>.fits.fz
,
coadd/*/*/*-nexp-<filter>.fits.fz
, coadd/*/*/*-maskbits.fits.fz
,
coadd/*/*/*-invvar-<filter>.fits.fz
). The order of the points within each file is also random
(meaning that randomness is retained if just the first N rows of the file are read). Each file contains the following columns:
Column |
Type |
Description |
---|---|---|
|
int16 |
Integer denoting the camera and filter set used, which will be unique for a given processing run of the data (RELEASE is documented here) |
|
int32 |
A unique Brick ID (in the range [1, 662174]) |
|
char[8] |
Name of the brick |
|
int32 |
Random catalog object number enumerate by increasing |
|
float64 |
Right ascension at equinox J2000 |
|
float64 |
Declination at equinox J2000 |
|
int16 |
Number of images that contribute to the central pixel in the \(g\) filter for this location (not profile-weighted) |
|
int16 |
Number of images that contribute to the central pixel in the \(r\) filter for this location (not profile-weighted) |
|
int16 |
Number of images that contribute to the central pixel in the \(z\) filter for this location (not profile-weighted) |
|
float32 |
For a \(5\sigma\) point source detection limit in \(g\), \(5/\sqrt(\mathrm{PSFDEPTH\_G})\) gives flux in nanomaggies and \(-2.5[\log_{10}(5 / \sqrt(\mathrm{PSFDEPTH\_G})) - 9]\) gives corresponding magnitude |
|
float32 |
For a \(5\sigma\) point source detection limit in \(r\), \(5/\sqrt(\mathrm{PSFDEPTH\_R})\) gives flux in nanomaggies and \(-2.5[\log_{10}(5 / \sqrt(\mathrm{PSFDEPTH\_R})) - 9]\) gives corresponding magnitude |
|
float32 |
For a \(5\sigma\) point source detection limit in \(i\), \(5/\sqrt(\mathrm{PSFDEPTH\_Z})\) gives flux in nanomaggies and \(-2.5[\log_{10}(5 / \sqrt(\mathrm{PSFDEPTH\_Z})) - 9]\) gives corresponding magnitude |
|
float32 |
As for |
|
float32 |
As for |
|
float32 |
As for |
|
float32 |
As for |
|
float32 |
As for |
|
float32 |
Weighted average PSF FWHM in arcsec in the \(g\) band |
|
float32 |
Weighted average PSF FWHM in arcsec in the \(r\) band |
|
float32 |
Weighted average PSF FWHM in arcsec in the \(z\) band |
|
float32 |
Total flux in nanomaggies extracted in a 0.75 arcsec radius in the \(g\) band at this location |
|
float32 |
Total flux in nanomaggies extracted in a 0.75 arcsec radius in the \(r\) band at this location |
|
float32 |
Total flux in nanomaggies extracted in a 0.75 arcsec radius in the \(z\) band at this location |
|
float32 |
Inverse variance of |
|
float32 |
Inverse variance of |
|
float32 |
Inverse variance of |
|
int16 |
Bitwise mask for optical data in the |
|
uint8 |
Bitwise mask for WISE W1 data in the |
|
uint8 |
Bitwise mask for WISE W2 data in the |
|
float32 |
Galactic extinction E(B-V) reddening from SFD98 |
|
char[1] |
|
|
int64 |
HEALPixel containing this location at NSIDE=64 in the NESTED scheme |
|
int64 |
See the desitarget data model (added to facilitate running randoms through the DESI fiberassign code) |
|
int64 |
See the desitarget data model; set to 4, appropriate to a QSO, the highest-priority DESI dark-time target (added to facilitate running randoms through the DESI fiberassign code) |
|
int64 |
See the desitarget data model; set to zero (added to facilitate running randoms through the DESI fiberassign code) |
|
int64 |
See the desitarget data model; set to zero (added to facilitate running randoms through the DESI fiberassign code) |
|
int64 |
See the desitarget data model (added to facilitate running randoms through the DESI fiberassign code) |
|
int32 |
See the desitarget data model; set to 511, which corresponds to all possible observing conditions (added to facilitate running randoms through the DESI fiberassign code) |
|
int64 |
See the desitarget data model; set to 3400, appropriate to a QSO, the highest-priority DESI dark-time target (added to facilitate running randoms through the DESI fiberassign code) |
|
int64 |
See the desitarget data model; set to 4, appropriate to a QSO, the highest-priority DESI dark-time target (added to facilitate running randoms through the DESI fiberassign code) |
|
int64 |
See the desitarget data model; set to 0 (added to facilitate running randoms through the DESI fiberassign code) |
|
int64 |
See the desitarget data model; set to 4, appropriate to a QSO, the highest-priority DESI dark-time target (added to facilitate running randoms through the DESI fiberassign code) |
|
int64 |
See the desitarget data model; set to 0 (added to facilitate running randoms through the DESI fiberassign code) |
|
float64 |
See the desitarget data model; set to -1.0 (added to facilitate running randoms through the DESI fiberassign code) |
|
int64 |
See the desitarget data model; set to -1 (added to facilitate running randoms through the DESI fiberassign code) |
|
char[15] |
See the desitarget data model; set to "QSO|UNOBS", denoting an unobserved QSO (added to facilitate running randoms through the DESI fiberassign code) |
|
char[19] |
See the desitarget data model; time at which this random was processed (added to facilitate running randoms through the DESI fiberassign code) |
|
char[14] |
See the desitarget data model; version of the |
|
int64 |
See the desitarget data model; set to 3400, appropriate to a QSO, the highest-priority DESI dark-time target (added to facilitate running randoms through the DESI fiberassign code) |
The version of the desitarget code used to generate the random catalogs (0.48.0
) can be extracted from the VERSION
column. The code is available on GitHub (see also here). The
northern and southern imaging footprints overlap, so, randoms are resolved by the desitarget code at a particular declination and by the Galactic plane. The result is that
randoms with locations at Dec \(\geq\) 32.375° and that are north of the Galactic Plane are only included in this file if they have pixels in BASS/MzLS (PHOTSYS
set to "N"), and
randoms with locations at Dec < 32.375° or that are south of the Galactic Plane are only included in this file if they have pixels in DECaLS (PHOTSYS
set to "S").
Work which uses any of the random catalogs should cite Myers et al. (2023).
randoms-outside-1-*.fits
Twenty files of random points in bricks that do not contain an observation in DR9 (that are "outside" of the DR9 footprint). The columns in this file are simplified compared to the other random catalogs as most of the entries in the additional columns would be zeros. As with the other random catalogs, points were generated at a density of 2,500 per square degree and the order of the points within the file is also randomized. Contains the following columns:
Column |
Type |
Description |
---|---|---|
|
int32 |
A unique Brick ID (in the range [1, 662174]) |
|
char[8] |
Name of the brick |
|
float64 |
Right ascension at equinox J2000 |
|
float64 |
Declination at equinox J2000 |
|
int16 |
Always zero in this file. |
|
int16 |
Always zero in this file. |
|
int16 |
Always zero in this file. |
|
float32 |
Galactic extinction E(B-V) reddening from SFD98 |
randoms-allsky-1-*.fits
The (randomly shuffled) combination of each of the randoms-1-X.fits
and randoms-outside-1-X.fits
files (where X = 0, 1, 2, 3, ... 18, 19). This creates
twenty "all-sky" random catalogs (at a density of 2,500 locations per square degree)
where each brick is either populated with observations from the
Legacy Surveys, or zeros. Contains a subset of the columns from the randoms-1-X.fits
files.
survey-bricks-dr9-randoms-0.48.0.fits
A similar file to the survey-bricks.fits.gz file, but with extra columns to help interpret the random catalogs. Contains the same columns as the survey-bricks.fits.gz file, plus the additional columns:
Column |
Type |
Description |
---|---|---|
|
char[1] |
|
|
float64 |
The area of the brick in square degrees. |
<region>/randoms/randoms-<region>-1-*.fits
As for the corresponding randoms-1-*.fits
file, but for each <region>
without resolving randoms using the desitarget code. In other words, this file
contains all randoms for the northern (southern) imaging surveys, regardless of whether the brick is "officially" in the north
(south
) region.
External Match Files (<region>/external/*
)
Each row of each external-match file contains the full record of the nearest object in our Tractored survey
imaging catalogs, matched at a radius of 1.5 arcsec. The structure of the imaging catalog files
is documented on the catalogs page. If no match is found, then OBJID
is set to -1.
In addition to the columns from the Tractor catalogs, we have added columns from the SDSS files that can be used to track objects uniquely. These are typically some combination of PLATE
, FIBER
, MJD
(or SMJD
) and, in some cases, RERUN
.
In previous Data Releases, if a source was duplicated in the SDSS spectroscopic files, only one of the duplicates was matched to a Legacy Surveys photometric object. Starting with DR9, we match
all duplicates in the SDSS spectroscopic files. The result is that all sources in the SDSS spectroscopic files should have information from the Legacy Surveys imaging if they
match with any Legacy Surveys BRICK_PRIMARY
photometric object.
survey-dr9-<region>-specObj-dr16.fits
HDU1 (the only HDU) contains Tractored survey photometry that is row-by-row-matched to the SDSS DR16 spectrosopic pipeline file such that the photometric parameters in row "N" of survey-dr9-<region>-specObj-dr16.fits match the spectroscopic parameters in row "N" of specObj-dr16.fits. The spectroscopic file is documented in the SDSS DR16 data model for specObj-dr16.fits.
survey-dr9-<region>-dr16Q-v4.fits
HDU1 (the only HDU) contains Tractored survey photometry that is row-by-row-matched to the SDSS DR16 visually inspected quasar catalog (Lyke et al. 2020) such that the photometric parameters in row "N" of survey-dr9-<region>-dr16Q-v4.fits match the spectroscopic parameters in row "N" of DR16Q_v4.fits. The spectroscopic file is documented in the SDSS DR14 data model for DR16Q_v4.fits.
survey-dr9-<region>-superset-dr16Q-v3.fits
HDU1 (the only HDU) contains Tractored survey photometry that is row-by-row-matched to the superset of all SDSS DR16 spectroscopically confirmed objects that were visually inspected as possible quasars (Lyke et al. 2020) such that the photometric parameters in row "N" of survey-dr9-<region>-superset-dr16Q-v3.fits match the spectroscopic parameters in row "N" of DR16Q_Superset_v3.fits. The spectroscopic file is documented in the SDSS DR16 data model for DR16Q_Superset_v3.fits.
survey-dr9-<region>-dr12Q.fits
HDU1 (the only HDU) contains Tractored survey photometry that is row-by-row-matched to the SDSS DR12 visually inspected quasar catalog (Paris et al. 2017) such that the photometric parameters in row "N" of survey-dr9-<region>-dr12Q.fits match the spectroscopic parameters in row "N" of DR12Q.fits. The spectroscopic file is documented in the SDSS DR12 data model for DR12Q.fits.
survey-dr9-<region>-superset-dr12Q.fits
HDU1 (the only HDU) contains Tractored survey photometry that is row-by-row-matched to the superset of all SDSS DR12 spectroscopically confirmed objects that were visually inspected as possible quasars (Paris et al. 2017) such that the photometric parameters in row "N" of survey-dr9-<region>-superset-dr12Q.fits match the spectroscopic parameters in row "N" of Superset_DR12Q.fits. The spectroscopic file is documented in the SDSS DR12 data model for Superset_DR12Q.fits.
survey-dr9-<region>-dr7Q.fits
HDU1 (the only HDU) contains Tractored survey photometry that is row-by-row-matched to the SDSS DR7 visually inspected quasar catalog (Schneider et al. 2010) such that the photometric parameters in row "N" of survey-dr9-<region>-dr7Q.fits match the spectroscopic parameters in row "N" of DR7qso.fit. The spectroscopic file is documented on the DR7 quasar catalog description page.
Tractor Catalogs (<region>/tractor/*
)
In the file listings outlined below:
brick names (<brick>) have the format <AAAa>c<BBB> where A, a and B are digits and c is either the letter m or p (e.g. 1126p222). The names are derived from the (RA, Dec) center of the brick. The first four digits are \(int(RA \times 10)\), followed by p to denote positive Dec or m to denote negative Dec ("plus"/"minus"), followed by three digits of \(int(Dec \times 10)\). For example the case 1126p222 corresponds to (RA, Dec) = (112.6°, +22.2°).
<brickmin> and <brickmax> denote the corners of a rectangle in (RA, Dec). Explicitly, <brickmin> has the format <AAA>c<BBB> where <AAA> denotes three digits of the minimum \(int(RA)\) in degrees, <BBB> denotes three digits of the minimum \(int(Dec)\) in degrees, and c uses the p/m ("plus"/"minus") format outlined in the previous bullet point. The convention is similar for <brickmax> and the maximum RA and Dec. For example 000m010-010m005 would correspond to a survey region limited by \(0^\circ \leq RA < 10^\circ\) and \(-10^\circ \leq Dec < -5^\circ\).
sub-directories are listed by the RA of the brick center, and sub-directory names (<AAA>) correspond to RA. For example 002 corresponds to brick centers between an RA of 2° and an RA of 3°.
<filter> denotes the \(g\), \(r\) or \(z\) band, using the corresponding letter.
Note that it is not possible to go from a brick name back to an exact (RA, Dec) center (the bricks are not on 0.1° grid
lines). The exact brick center for a given brick name can be derived from columns in the
survey-bricks.fits.gz file (i.e. brickname
, ra
, dec
).
<AAA>/tractor-<brick>.fits
FITS binary table containing Tractor photometry, documented on the catalogs page.
Users interested in database access to the Tractor catalogs can use the NOIRLab Astro Data Lab [2].
Sweep Catalogs (<region>/sweep/*
)
9.0/sweep-<brickmin>-<brickmax>.fits
The sweeps are light-weight FITS binary tables (containing a subset of the most commonly used
Tractor measurements) of all the Tractor catalogs for which BRICK_PRIMARY==T
in rectangles of RA, Dec.
Name |
Type |
Units |
Description |
---|---|---|---|
|
int16 |
Integer denoting the camera and filter set used, which will be unique for a given processing run of the data (RELEASE is documented here) |
|
|
int32 |
A unique Brick ID (in the range [1, 662174]) |
|
|
char[8] |
Name of brick, encoding the brick sky position, eg "1126p222" near RA=112.6, Dec=+22.2 |
|
|
int32 |
Catalog object number within this brick; a unique identifier hash is |
|
|
char[3] |
Morphological model: "PSF"=stellar, "REX"="round exponential galaxy" = round EXP galaxy with a variable radius, "EXP"=exponential, "DEV"=deVauc, "SER"=Sersic, "DUP"==Gaia source fit by different model |
|
|
float64 |
deg |
Right ascension at equinox J2000 |
|
float64 |
deg |
Declination at equinox J2000 |
|
float32 |
1/deg² |
Inverse variance of |
|
float32 |
1/deg² |
Inverse variance of |
|
float32[5] |
Difference in χ² between successively more-complex model fits: PSF, REX, DEV, EXP, SER. The difference is versus no source. |
|
|
float32 |
mag |
Galactic extinction E(B-V) reddening from SFD98, used to compute |
|
float32 |
nanomaggy |
Model flux in \(g\) |
|
float32 |
nanomaggy |
Model flux in \(r\) |
|
float32 |
nanomaggy |
Model flux in \(z\) |
|
float32 |
nanomaggy |
WISE model flux in \(W1\) (AB system) |
|
float32 |
nanomaggy |
WISE model flux in \(W2\) (AB) |
|
float32 |
nanomaggy |
WISE model flux in \(W3\) (AB) |
|
float32 |
nanomaggy |
WISE model flux in \(W4\) (AB) |
|
float32 |
1/nanomaggy² |
Inverse variance of |
|
float32 |
1/nanomaggy² |
Inverse variance of |
|
float32 |
1/nanomaggy² |
Inverse variance of |
|
float32 |
1/nanomaggy² |
Inverse variance of |
|
float32 |
1/nanomaggy² |
Inverse variance of |
|
float32 |
1/nanomaggy² |
Inverse variance of |
|
float32 |
1/nanomaggy² |
Inverse variance of |
|
float32 |
Galactic transmission in \(g\) filter in linear units [0,1] |
|
|
float32 |
Galactic transmission in \(r\) filter in linear units [0,1] |
|
|
float32 |
Galactic transmission in \(z\) filter in linear units [0,1] |
|
|
float32 |
Galactic transmission in \(W1\) filter in linear units [0,1] |
|
|
float32 |
Galactic transmission in \(W2\) filter in linear units [0,1] |
|
|
float32 |
Galactic transmission in \(W3\) filter in linear units [0,1] |
|
|
float32 |
Galactic transmission in \(W4\) filter in linear units [0,1] |
|
|
int16 |
Number of images that contribute to the central pixel in \(g\): filter for this object (not profile-weighted) |
|
|
int16 |
Number of images that contribute to the central pixel in \(r\): filter for this object (not profile-weighted) |
|
|
int16 |
Number of images that contribute to the central pixel in \(z\): filter for this object (not profile-weighted) |
|
|
int16 |
Number of images that contribute to the central pixel in \(W1\): filter for this object (not profile-weighted) |
|
|
int16 |
Number of images that contribute to the central pixel in \(W2\): filter for this object (not profile-weighted) |
|
|
int16 |
Number of images that contribute to the central pixel in \(W3\): filter for this object (not profile-weighted) |
|
|
int16 |
Number of images that contribute to the central pixel in \(W4\): filter for this object (not profile-weighted) |
|
|
float32 |
Profile-weighted χ² of model fit normalized by the number of pixels in \(g\) |
|
|
float32 |
Profile-weighted χ² of model fit normalized by the number of pixels in \(r\) |
|
|
float32 |
Profile-weighted χ² of model fit normalized by the number of pixels in \(z\) |
|
|
float32 |
Profile-weighted χ² of model fit normalized by the number of pixels in \(W1\) |
|
|
float32 |
Profile-weighted χ² of model fit normalized by the number of pixels in \(W2\) |
|
|
float32 |
Profile-weighted χ² of model fit normalized by the number of pixels in \(W3\) |
|
|
float32 |
Profile-weighted χ² of model fit normalized by the number of pixels in \(W4\) |
|
|
float32 |
Profile-weighted fraction of the flux from other sources divided by the total flux in \(g\) (typically [0,1]) |
|
|
float32 |
Profile-weighted fraction of the flux from other sources divided by the total flux in \(r\) (typically [0,1]) |
|
|
float32 |
Profile-weighted fraction of the flux from other sources divided by the total flux in \(z\) (typically [0,1]) |
|
|
float32 |
Profile-weighted fraction of the flux from other sources divided by the total flux in \(W1\) (typically [0,1]) |
|
|
float32 |
Profile-weighted fraction of the flux from other sources divided by the total flux in \(W2\) (typically [0,1]) |
|
|
float32 |
Profile-weighted fraction of the flux from other sources divided by the total flux in \(W3\) (typically [0,1]) |
|
|
float32 |
Profile-weighted fraction of the flux from other sources divided by the total flux in \(W4\) (typically [0,1]) |
|
|
float32 |
Profile-weighted fraction of pixels masked from all observations of this object in \(g\), strictly between [0,1] |
|
|
float32 |
Profile-weighted fraction of pixels masked from all observations of this object in \(r\), strictly between [0,1] |
|
|
float32 |
Profile-weighted fraction of pixels masked from all observations of this object in \(z\), strictly between [0,1] |
|
|
float32 |
Fraction of a source's flux within the blob in \(g\), near unity for real sources |
|
|
float32 |
Fraction of a source's flux within the blob in \(r\), near unity for real sources |
|
|
float32 |
Fraction of a source's flux within the blob in \(z\), near unity for real sources |
|
|
int16 |
Bitwise mask set if the central pixel from any image satisfies each condition in \(g\) (see the DR9 bitmasks page) |
|
|
int16 |
Bitwise mask set if the central pixel from any image satisfies each condition in \(r\) (see the DR9 bitmasks page) |
|
|
int16 |
Bitwise mask set if the central pixel from any image satisfies each condition in \(z\) (see the DR9 bitmasks page) |
|
|
int16 |
Bitwise mask set if the central pixel from all images satisfy each condition in \(g\) (see the DR9 bitmasks page) |
|
|
int16 |
Bitwise mask set if the central pixel from all images satisfy each condition in \(r\) (see the DR9 bitmasks page) |
|
|
int16 |
Bitwise mask set if the central pixel from all images satisfy each condition in \(z\) (see the DR9 bitmasks page) |
|
|
uint8 |
W1 bitmask as cataloged on the DR9 bitmasks page |
|
|
uint8 |
W2 bitmask as cataloged on the DR9 bitmasks page |
|
|
float32 |
arcsec |
Weighted average PSF FWHM in the \(g\) band |
|
float32 |
arcsec |
Weighted average PSF FWHM in the \(r\) band |
|
float32 |
arcsec |
Weighted average PSF FWHM in the \(z\) band |
|
float32 |
1/nanomaggy² |
For a \(5\sigma\) point source detection limit in \(g\), \(5/\sqrt(\mathrm{PSFDEPTH\_G})\) gives flux in nanomaggies and \(-2.5[\log_{10}(5 / \sqrt(\mathrm{PSFDEPTH\_G})) - 9]\) gives corresponding magnitude |
|
float32 |
1/nanomaggy² |
For a \(5\sigma\) point source detection limit in \(g\), \(5/\sqrt(\mathrm{PSFDEPTH\_R})\) gives flux in nanomaggies and \(-2.5[\log_{10}(5 / \sqrt(\mathrm{PSFDEPTH\_R})) - 9]\) gives corresponding magnitude |
|
float32 |
1/nanomaggy² |
For a \(5\sigma\) point source detection limit in \(g\), \(5/\sqrt(\mathrm{PSFDEPTH\_Z})\) gives flux in nanomaggies and \(-2.5[\log_{10}(5 / \sqrt(\mathrm{PSFDEPTH\_Z})) - 9]\) gives corresponding magnitude |
|
float32 |
1/nanomaggy² |
As for |
|
float32 |
1/nanomaggy² |
As for |
|
float32 |
1/nanomaggy² |
As for |
|
float32 |
1/nanomaggy² |
As for |
|
float32 |
1/nanomaggy² |
As for |
|
char[8] |
unWISE coadd file name for the center of each object |
|
|
float32 |
arcsec |
Half-light radius of galaxy model for galaxy type |
|
float32 |
1/arcsec² |
Inverse variance of |
|
float32 |
Ellipticity component 1 of galaxy model for galaxy type |
|
|
float32 |
Inverse variance of |
|
|
float32 |
Ellipticity component 2 of galaxy model for galaxy type |
|
|
float32 |
Inverse variance of |
|
|
float32 |
nanomaggy |
Predicted \(g\)-band flux within a fiber of diameter 1.5 arcsec from this object in 1 arcsec Gaussian seeing |
|
float32 |
nanomaggy |
Predicted \(r\)-band flux within a fiber of diameter 1.5 arcsec from this object in 1 arcsec Gaussian seeing |
|
float32 |
nanomaggy |
Predicted \(z\)-band flux within a fiber of diameter 1.5 arcsec from this object in 1 arcsec Gaussian seeing |
|
float32 |
nanomaggy |
Predicted \(g\)-band flux within a fiber of diameter 1.5 arcsec from all sources at this location in 1 arcsec Gaussian seeing |
|
float32 |
nanomaggy |
Predicted \(r\)-band flux within a fiber of diameter 1.5 arcsec from all sources at this location in 1 arcsec Gaussian seeing |
|
float32 |
nanomaggy |
Predicted \(z\)-band flux within a fiber of diameter 1.5 arcsec from all sources at this location in 1 arcsec Gaussian seeing |
|
char[2] |
Reference catalog source for this star: "T2" for Tycho-2, "G2" for Gaia DR2, "L3" for the SGA, empty otherwise |
|
|
int64 |
Reference catalog identifier for this star; Tyc1*1,000,000+Tyc2*10+Tyc3 for Tycho-2; "sourceid" for Gaia DR2 and SGA |
|
|
float32 |
yr |
Reference catalog reference epoch (eg, 2015.5 for Gaia DR2) |
|
float32 |
mag |
Gaia G band magnitude |
|
float32 |
Gaia G band signal-to-noise |
|
|
float32 |
mag |
Gaia BP magnitude |
|
float32 |
Gaia BP signal-to-noise |
|
|
float32 |
mag |
Gaia RP magnitude |
|
float32 |
Gaia RP signal-to-noise |
|
|
float32 |
Gaia astrometric excess noise |
|
|
boolean |
Gaia duplicated source flag (1/0 for True/False) |
|
|
float32 |
Gaia BP/RP excess factor |
|
|
float32 |
mas |
Gaia longest semi-major axis of the 5-d error ellipsoid |
|
uint8 |
Which astrometric parameters were estimated for a Gaia source |
|
|
float32 |
mas |
Reference catalog parallax |
|
float32 |
1/mas² |
Reference catalog inverse-variance on |
|
float32 |
mas/yr |
Reference catalog proper motion in RA direction (\(\mu_\alpha^*\equiv\mu_\alpha\cos\delta\)) in the ICRS at |
|
float32 |
1/(mas/yr)² |
Reference catalog inverse-variance on |
|
float32 |
mas/yr |
Reference catalog proper motion in Dec direction (\(\mu_\delta\)) in the ICRS at |
|
float32 |
1/(mas/yr)² |
Reference catalog inverse-variance on |
|
int16 |
Bitwise mask indicating that an object touches a pixel in the |
|
|
int16 |
Bitwise mask detailing properties of how a source was fit (see the DR9 bitmasks page) |
|
|
float32 |
Power-law index for the Sersic profile model ( |
|
|
float32 |
Inverse variance of |
Light Curve sweeps (9.0-lightcurves/sweep-<brickmin>-<brickmax>-lc.fits)
The "light curve" sweeps files contain values from the Tractor catalogs that relate to multi-epoch WISE data, which are
Name |
Type |
Units |
Description |
---|---|---|---|
|
int16 |
Integer denoting the camera and filter set used, which will be unique for a given processing run of the data (RELEASE is documented here) |
|
|
int32 |
A unique Brick ID (in the range [1, 662174]) |
|
|
int32 |
Catalog object number within this brick; a unique identifier hash is |
|
|
float32[15] |
nanomaggy |
|
|
float32[15] |
nanomaggy |
|
|
float32[15] |
1/nanomaggy² |
Inverse variance of |
|
float32[15] |
1/nanomaggy² |
Inverse variance of |
|
int16[15] |
|
|
|
int16[15] |
|
|
|
float64[15] |
|
|
|
float64[15] |
|
|
|
float32[15] |
|
|
|
float32[15] |
|
|
|
float32[15] |
|
|
|
float32[15] |
|
|
|
int16[15] |
Index number of unWISE epoch for W1 (defaults to -1 for unused entries) |
|
|
int16[15] |
Index number of unWISE epoch for W2 (defaults to -1 for unused entries) |
The light curve sweeps files are row-by-row-parallel to the standard sweeps files
(i.e. the entries in each row of the light curve sweeps files correspond to the entries
in each row of the standard sweeps files, which can be verified using RELEASE
,
BRICKID
and OBJID
).
Extra sweeps (9.0-lightcurves/sweep-<brickmin>-<brickmax>-ex.fits)
The "extra" sweeps files contain all columns from the Tractor catalogs that
are not otherwise in the standard sweeps files or the "light curve" sweep files.
See the Tractor catalogs for a description of the columns in these files.
The extra sweeps files are row-by-row-parallel to the standard sweeps files
(i.e. the entries in each row of the extra sweeps files correspond to the entries
in each row of the standard sweeps files, which can be verified using RELEASE
,
BRICKID
and OBJID
).
Photo-z sweeps (9.1-photo-z/sweep-<brickmin>-<brickmax>-pz.fits)
The photometric redshift (photo-z) sweeps catalogs are row-by-row-matched to the DR9 sweep catalogs as described above for the other types of sweeps files.
The photometric redshifts are computed using a random forest algorithm.
Details of the photo-z training and performance can be found in Zhou et al. (2023).
For computing the photo-zs, we require at least one exposure in
\(g\), \(r\) and \(z\) bands (NOBS_G,R,Z>1
).
For objects that do not meet the NOBS
cut,
the photo-z values are filled with -99.
Although we provide photo-zs for all
objects that meet the NOBS
cut, the brightest objects have the most reliable
photo-zs. As a rule of thumb, objects brighter than \(z\)-band magnitude of 21
are mostly reliable, whereas fainter objects are increasingly unreliable with
increasingly large systematic offsets. The overall performance of the photometric
redshifts compared to a range of spectroscopic surveys are available for both
the northern and southern regions of the legacy surveys imaging.
The photo-z catalogs do not provide information on star-galaxy separation.
Stars are excluded from the photo-z training data, and we do not attempt to
identify stars. To perform star-galaxy separation, one can use the
morphological TYPE
and/or the photometry (e.g., the optical-WISE
color cut, as applied in Zhou et al. 2021, can be very effective for selecting redshift ≳ 0.3 galaxies) in the sweep catalogs.
Name |
Type |
Description |
---|---|---|
|
int16 |
Integer denoting the camera and filter set used, which will be unique for a given processing run of the data (RELEASE is documented here) |
|
int32 |
A unique Brick ID (in the range [1, 662174]) |
|
int32 |
Catalog object number within this brick; a unique identifier hash is |
|
float32 |
photo-z derived from the mean of the photo-z PDF |
|
float32 |
photo-z derived from the median of the photo-z PDF |
|
float32 |
standard deviation of the photo-zs derived from the photo-z PDF |
|
float32 |
lower bound of the 68% confidence region, derived from the photo-z PDF |
|
float32 |
upper bound of the 68% confidence region, derived from the photo-z PDF |
|
float32 |
lower bound of the 95% confidence region, derived from the photo-z PDF |
|
float32 |
upper bound of the 68% confidence region, derived from the photo-z PDF |
|
float32 |
spectroscopic redshift, if available |
|
char[10] |
source of the spectroscopic redshift |
|
boolean |
whether or not the spectroscopic redshift is used in photometric redshift training |
|
int16 |
index of the subset in the 10-fold cross-validation |
Work which uses this photometric redshift catalog should cite Zhou et al. (2023) and include the additional acknowledgment for photometric redshifts.
Foreground object masks (masking/*
)
The foreground object masks were used to set the BRIGHT
, MEDIUM
, GALAXY
and CLUSTER
bits
described on the DR9 bitmasks page. Files in the masking
directory other than gaia-mask-dr9.fits.gz
are generally described as part the overview of the external catalogs used for masking, and have data models
that are detailed as part of the Siena Galaxy Atlas (SGA).
gaia-mask-dr9.fits.gz
A FITS binary table with a single HDU containing information about the Tycho-2 and Gaia DR2 stars used to
set the BRIGHT
and MEDIUM
bits described on the DR9 bitmasks page. See also the general overview of
the external catalogs used for masking.
Name |
Type |
Units |
Description |
---|---|---|---|
|
float64 |
deg |
|
|
float64 |
deg |
|
|
char[2] |
Reference catalog source for this star: "T2" for Tycho-2, "G2" for Gaia DR2 |
|
|
int64 |
Reference catalog identifier for this star; Tyc1*1,000,000+Tyc2*10+Tyc3 for Tycho-2; "sourceid" for Gaia DR2 |
|
|
float32 |
yr |
Reference catalog reference epoch (eg, 2015.5 for Gaia DR2) |
|
float32 |
mag |
Gaia G-band mag for Gaia DR2; V_T for Tycho-2 when available, otherwise Hipparcos magnitude |
|
float32 |
mag |
Magnitude used for masking: the lesser of |
|
float32 |
deg |
Masking radius |
|
int64 |
pix |
Masking radius in 0.262 arcsec "brick" pixels |
|
float32 |
mas/yr |
Reference catalog proper motion in RA direction (\(\mu_\alpha^*\equiv\mu_\alpha\cos\delta\)) in the ICRS at |
|
float32 |
mas/yr |
Reference catalog proper motion in Dec direction (\(\mu_\delta\)) in the ICRS at |
|
float32 |
mas |
Reference catalog parallax |
|
float32 |
1/deg² |
Inverse variance of RA (no cosine term!), excluding astrometric calibration errors |
|
float32 |
1/deg² |
Inverse variance of DEC, excluding astrometric calibration errors |
|
float32 |
1/(mas/yr)² |
Reference catalog inverse-variance on |
|
float32 |
1/(mas/yr)² |
Reference catalog inverse-variance on |
|
float32 |
1/mas² |
Reference catalog inverse-variance on |
|
boolean |
In the DESI footprint? |
|
|
boolean |
From, or was matched to, the Tycho-2 catalog? |
|
|
boolean |
From, or was matched to, the Gaia DR2 catalog? |
|
|
boolean |
Is a |
|
|
boolean |
Is a |
|
|
boolean |
Does the star pass the Legacy Surveys Gaia DR2 point source cut? |
|
|
boolean |
Does the object match an SGA galaxy? If |
|
|
float32 |
mag |
The estimated DECam \(g\) magnitude for Gaia DR2 stars based on the \(G\) and \(Bp-Rp\) color |
|
float32 |
mag |
The estimated DECam \(r\) magnitude for Gaia DR2 stars based on the \(G\) and \(Bp-Rp\) color |
|
float32 |
mag |
The estimated DECam \(z\) magnitude for Gaia DR2 stars based on the \(G\) and \(Bp-Rp\) color |
|
float32 |
mag |
The estimated \(z\) magnitude for Tycho-2 stars from matching to 2MASS and estimating \(V\) to \(z\) transformations based on APASS. |
|
char[8] |
Name of brick, encoding the brick sky position, eg "1126p222" near RA=112.6, Dec=+22.2 |
|
|
int32 |
Integer brick pixel X coordinate (0-indexed) of this star |
|
|
int32 |
Integer brick pixel Y coordinate (0-indexed) of this star |
|
|
float32 |
mag |
Gaia G band magnitude |
|
float32 |
Gaia G band signal-to-noise |
|
|
int16 |
Gaia G band number of observations |
|
|
float32 |
mag |
Gaia BP magnitude |
|
float32 |
Gaia BP signal-to-noise |
|
|
int16 |
Gaia BP number of observations |
|
|
float32 |
mag |
Gaia RP magnitude |
|
float32 |
Gaia RP signal-to-noise |
|
|
int16 |
Gaia RP number of observations |
|
|
boolean |
Gaia photometric variable flag |
|
|
float32 |
Gaia astrometric excess noise |
|
|
float32 |
Gaia astrometric excess noise uncertainty |
|
|
int16 |
Gaia number of astrometric observations along scan direction |
|
|
int16 |
Gaia number of good astrometric observations along scan direction |
|
|
float32 |
Gaia astrometric weight along scan direction |
|
|
boolean |
Gaia duplicated source flag |
|
|
float32 |
mag |
Gaia line-of-sight extinction in the G band |
|
float32 |
mag |
Gaia line-of-sight reddening E(BP-RP) |
|
float32 |
Gaia BP/RP excess factor |
|
|
float32 |
mas |
Gaia longest semi-major axis of the 5-d error ellipsoid |
|
uint8 |
which astrometric parameters were estimated for a Gaia source |
Image Stacks (<region>/coadd/*
)
Image stacks are on tangent-plane (WCS TAN) projections, 3600 × 3600 pixels, at 0.262 arcseconds per pixel.
- <AAA>/<brick>/legacysurvey-<brick>-blobmodel-<filter>.fits.fz
-
The Tractor's model prediction of the images, similar to
<AAA>/<brick>/legacysurvey-<brick>-model-<filter>.fits.fz
, below, except that the models are clipped to the blobs within which they are measured. In other words, the models used to derive the maps in these files are not extrapolated beyond the pixels in the blobs that are used to fit the models.
- <AAA>/<brick>/legacysurvey-<brick>-ccds.fits
-
FITS binary table with the list of CCD images that were used in this brick. Contains the same columns as survey-ccds-<camera>-dr9.fits.gz, and also contains the additional columns listed below. Note that string columns can have different lengths in the survey-ccds-<camera>-dr9.fits.gz and legacysurvey-<brick>-ccds.fits files and can differ for
<region>
equal to<north>
and<south>
. For example thecamera
column can change fromchar[7]
tochar[5]
(see, e.g. legacypipe issue #379).Column
Type
Description
ccd_x0
int16
Minimum x image coordinate overlapping this brick
ccd_y0
int16
Minimum y image coordinate overlapping this brick
ccd_x1
int16
Maximum x image coordinate overlapping this brick
ccd_y1
int16
Maximum y image coordinate overlapping this brick
brick_x0
int16
Minimum x brick image coordinate overlapped by this image
brick_x1
int16
Maximum x brick image coordinate overlapped by this image
brick_y0
int16
Minimum y brick image coordinate overlapped by this image
brick_y1
int16
Maximum y brick image coordinate overlapped by this image
psfnorm
float32
Same as
psfnorm
in the ccds-annotated- filegalnorm
float32
Same as
galnorm
in the ccds-annotated- fileskyver
char[8]
Git version of the sky calibration code
wcsver
char[1]
Git version of the WCS calibration code
psfver
char[7]
Git version of the PSF calibration code
skyplver
char[8]
Community Pipeline (CP) version of the input to sky calibration
wcsplver
char[5]
CP version of the input to WCS calibration
psfplver
char[8]
CP version of the input to PSF calibration
co_sky
float32
- <AAA>/<brick>/legacysurvey-<brick>-chi2-<filter>.fits.fz
-
Stacked χ² image, which is approximately the summed χ² values from the single-epoch images.
- <AAA>/<brick>/legacysurvey-<brick>-depth-<filter>.fits.fz
-
Stacked depth map in units of the point-source flux inverse-variance at each pixel.
The 5σ point-source depth can be computed as \(5 / \sqrt(\mathrm{depth\_ivar})\) .
- <AAA>/<brick>/legacysurvey-<brick>-galdepth-<filter>.fits.fz
-
Stacked depth map in units of the canonical galaxy flux inverse-variance at each pixel. The canonical galaxy is an exponential profile with effective radius 0.45" and round shape.
The 5σ galaxy depth can be computed as \(5 / \sqrt(\mathrm{galdepth\_ivar})\) .
- <AAA>/<brick>/legacysurvey-<brick>-image-<filter>.fits.fz
-
Stacked image centered on a brick location covering 0.25° × 0.25°. The primary HDU contains the coadded image (inverse-variance weighted coadd), in units of nanomaggies per pixel.
NOTE: These are not the images used by Tractor, which operates on the single-epoch images.
NOTE: These images are resampled using Lanczos-3 resampling.
NOTE: Images in WISE bands are on the Vega system, all other flux-related quantities in DR9 are reported on the AB system. The description page lists the Vega-to-AB conversions recommended by the WISE team.
- <AAA>/<brick>/legacysurvey-<brick>-invvar-<filter>.fits.fz
-
Inverse variance image corresponding to the legacysurvey-<brick>-image-<filter>.fits.fz file based on the sum of the inverse-variances of the individual input images in units of 1/(nanomaggies)² per pixel.
NOTE: These are not the inverse variance maps used by Tractor, which operates on the single-epoch images.
NOTE: Images in WISE bands are on the Vega system, all other flux-related quantities in DR9 are reported on the AB system. The description page lists the Vega-to-AB conversions recommended by the WISE team.
- <AAA>/<brick>/legacysurvey-<brick>-maskbits.fits.fz
-
Bitmask of possible problems with pixels in this brick.
HDU1: The optical bitmasks, corresponding to
MASKBITS
on the DR9 bitmasks page.HDU2: The WISE W1 bitmasks, corresponding to
WISEMASK_W1
on the DR9 bitmasks page.HDU3: The WISE W2 bitmasks, corresponding to
WISEMASK_W2
on the DR9 bitmasks page.
- <AAA>/<brick>/legacysurvey-<brick>-model-<filter>.fits.fz
-
Stacked model image centered on a brick location covering 0.25° × 0.25°.
The Tractor's idea of what the coadded images should look like; the Tractor's model prediction.
NOTE: Images in WISE bands are on the Vega system, all other flux-related quantities in DR9 are reported on the AB system. The description page lists the Vega-to-AB conversions recommended by the WISE team.
- <AAA>/<brick>/legacysurvey-<brick>-nexp-<filter>.fits.fz
-
Number of exposures contributing to each pixel of the stacked images.
- <AAA>/<brick>/legacysurvey-<brick>-psfsize-<filter>.fits.fz
-
Weighted average PSF FWHM in arcsec at each pixel of the stacked images.
- <AAA>/<brick>/legacysurvey-<brick>-blobmodel.jpg
-
JPEG image of the Tractor's model images, where the model fits have been clipped to the blobs within which the models are measured. Uses the \(g,r,z\) filters as the colors.
- <AAA>/<brick>/legacysurvey-<brick>-image.jpg
-
JPEG image of the calibrated image using the \(g,r,z\) filters as the colors.
- <AAA>/<brick>/legacysurvey-<brick>-model.jpg
-
JPEG image of the Tractor's model image using the \(g,r,z\) filters as the colors.
- <AAA>/<brick>/legacysurvey-<brick>-resid.jpg
-
JPEG image of the residual image (data minus model) using the \(g,r,z\) filters as the colors.
- <AAA>/<brick>/legacysurvey-<brick>-wise.jpg
-
JPEG image of the calibrated image using the WISE filters as the colors.
- <AAA>/<brick>/legacysurvey-<brick>-wisemodel.jpg
-
JPEG image of the model image using the WISE filters as the colors.
Forced Photometry Files (forced-ccd/*
and forced-brick/*
)
Files in this directory contain forced photometry results, for all CCDs that were included in the DR9 processing.
After we produce the catalogs based on fitting to all images simultaneously, we go back to the individual CCDs, select the catalog objects that overlap, and ask what fluxes those objects should have to best match what is observed in the CCD. The positions and shapes of the stars and galaxies are held fixed, which is why it is called "forced"; only the fluxes are fit. When selecting objects from the catalog, we resolve the north and south components using the same cut as in the sweep files and randoms.
We perform two fits. The first is regular forced photometry, where
the position and profile of the sources are fixed, and all we are
fitting is the flux. In the second fit, we compute the
source-centered spatial derivatives and fit the amplitudes of those
derivatives as well. For sources moving less than a pixel or two,
this produces an approximate estimate of the motion of the source (dra
and ddec
).
Note that for Gaia sources, this is relative to the Gaia measured
proper motion!
We provide these results organized in two ways. The first is exposure-based (each file contains measurements for all the sources that appear in the CCDs of a single exposure), and the second is brick-based (each file contains all the sources within a brick, gathering up measurements from all the CCDs that overlap the brick).
- forced-ccd/<camera>/<EXPOS>/forced-<camera>-<EXPOSURE>.fits
-
Where <camera> is one of
90prime
for BASS,decam
for DECaLS ormosaic
for MzLS, <EXPOSURE> is the exposure number (not necessarily as an 8-character string, unlike some other data products), and <EXPOS> is the first 5 characters of the exposure number printed as an 8-character string.This file contains a single FITS binary table for all the CCDs in this exposure, contatenated into one long table.
For the columns pertaining to the catalog objects, see the catalog description page.
Column
Type
Description
release
int16
Integer denoting the camera and filter set used, which will be unique for a given processing run of the data (release is documented here)
brickid
int32
Unique Brick ID (in the range [1, 662174]) that the catalog object came from
brickname
char[8]
Name of brick, encoding the brick sky position, eg "1126p222" near RA=112.6, Dec=+22.2, of the catalog object
objid
int32
Catalog object number within this brick; a unique identifier hash is
release,brickid,objid
camera
char[7]
The camera for the CCD being measured, eg "decam"
expnum
int64
The exposure number of the CCD being measured, eg 574299
ccdname
char[4]
The name of the CCD being measured, eg "N10" or "CCD4"
filter
char[1]
The filter of the CCD being measured ("g", "r" or "z")
mjd
float64
The Modified Julian Date when the exposure was taken, in UTC, eg 57644.31537588
exptime
float32
The exposure time in seconds, eg 90.0
psfsize
float32
PSF FWHM in this exposure, in arcsec
ccd_cuts
int64
Bit mask describing CCD image quality (see the DR9 bitmasks page)
airmass
float32
Airmass of this observation
sky
float32
Sky background surface brightness, in nanomaggies/arcsec²
psfdepth
float32
Inverse-variance for the flux measured from a point source; for a \(5\sigma\) point source detection limit use \(5/\sqrt(\mathrm{psfdepth})\) for the flux in nanomaggies and \(-2.5[\log_{10}(5 / \sqrt(\mathrm{psfdepth})) - 9]\) for the corresponding AB magnitude
galdepth
float32
Inverse-variance for the flux measured from a nominal galaxy source (0.45" round exponential galaxy)
ra
float64
Right Ascension in degrees
dec
float64
Declination in degrees
flux
float32
Measured flux for this catalog object in this CCD, in nanomaggies
flux_ivar
float32
Inverse-variance of the flux measurement, in 1/nanomaggies²
fracflux
float32
Profile-weighted fraction of the flux from other sources over total flux
rchisq
float32
Profile-weighted χ² residual chi-squared per pixel
fracmasked
float32
Profile-weighted fraction of pixels masked
apflux
float32[8]
Aperture fluxes in this CCD, in nanomaggies, for aperture radii [0.5, 0.75, 1.0, 1.5, 2.0, 3.5, 5.0, 7.0] arcsec
apflux_ivar
float32[8]
Inverse-variance on apflux, in 1/nanomaggies²
x
float32
Horizontal pixel position of the catalog source in this CCD, in zero-indexed pixels
y
float32
Vertical pixel position of the catalog source in this CCD, in zero-indexed pixels
dqmask
int16
Data Quality mask from the CP pipeline for the center pixel (defined as for
ALLMASK/ANYMASK
on the DR9 bitmasks page)dra
float32
When fitting for spatial derivatives, the motion of the source in the RA direction, in arcsec
ddec
float32
Motion of the source in the Dec direction, in arcsec
dra_ivar
float32
Inverse-variance on
dra
, in 1/arcsec|sup2|ddec_ivar
float32
Inverse-variance on
ddec
, in 1/arcsec|sup2|
- forced-brick/<AAA>/forced-<brick>.fits.gz
-
Where
<AAA>
are the first three characters of the brick name, ie, the RA angle, and<brick>
is the brick name.These files contain two tables. The first lists the catalog objects contained in the file, and gives the indices in the second table of the measurements for that source.
Note that the forced photometry was performed on a resolved combination of the north and south surveys, so the
forced-brick
product for thenorth
will contain measurements of northern CCDs, but catalog entries that may have been detected in the north or south.Column
Type
Description
release
int16
Integer denoting the camera and filter set used, which will be unique for a given processing run of the data
brickid
int32
Brick ID [1,662174]
objid
int32
Catalog object number within this brick; a unique identifier hash is
release,brickid,objid
;objid
spans [0,N-1] and is contiguously enumerated within each bricknobs_g
int32
Number of forced-photometry measurements in the \(g\) band.
index_g
int32
Starting index in the second table of the \(g\) band measurements.
nobs_r
int32
Number of forced-photometry measurements in the \(r\) band.
index_r
int32
Starting index in the second table of the \(r\) band measurements.
nobs_z
int32
Number of forced-photometry measurements in the \(z\) band.
index_z
int32
Starting index in the second table of the \(z\) band measurements.
The second HDU has exactly the same format as the
forced-ccd
table described above.
Other Files
Much additional information is available as part of the DESI Legacy Imaging Surveys Data Releases, including, in separate directories,
statistics of the Tractor fits (<region>/metrics
), CCD-level masks of outlier pixels (<region>/outlier-masks
),
code outputs from the fitting processes (<region>/logs
) and additional files
detailing the calibrations (calib
).
We don't expect that most users will need a description of these files, but contact us if you require more information.
Raw Data
See the raw data page.
Footnotes