Legacy Survey - Data Access

The Legacy Survey data and database are accessible from the Astro Data Lab, and from the Legacy Survey team website. Explore the dataset interactively using the Sky Viewer.

Data Lab Table Access Protocol (TAP) service

TAP provides a convenient access layer to the Legacy Survey catalog database. TAP-aware clients (such as TOPCAT) can point to http://datalab.noao.edu/tap. DR8, DR7, DR6, DR5, DR4 and DR3 databases are respectively named ls_dr8, ls_dr7, ls_dr6, ls_dr5, ls_dr4, and ls_dr3. Select a database in order to see the tables it contains as well as their descriptions. Please note that the data model has changed slightly between DR8 and between other releases so the tables and columns are not identical.

Another way to view the tables is through the Data Lab Query Interface (https://datalab.noirlab.edu/query.php). From the Column Information tab, select ls_dr8 from the left-hand menu to see the list of tables for DR8, respectively. Clicking on a table (e.g., ls_dr8.tractor_n or ls_dr8.tractor_s) will show the column names and description.

Data Lab Query Manager

The Query Manager is available as part of the Data Lab software distribution. The Query Manager client provides a Python API to Data Lab database services. For the Legacy Survey, these services include anonymous, and authenticated access through synchronous or asynchronous queries of the catalog made directly to the database. Additional Data Lab services for registered users include personal database storage, and storage through the Data Lab VOSpace.

The Query Manager can be called from a Jupyter Notebook on the Data Lab Notebook server. Example notebooks are provided to users upon creation of their user account (https://datalab.noirlab.edu/register.php)

Image cutouts

The Data Lab Simple Image Access (SIA) service provide users with a fast way to retrieve cutouts from Legacy Survey images.

In addition, sections of the Legacy Survey can be obtained as JPEGs or FITS files using the Legacy Survey team cutout service, as follows:

JPEG:   http://legacysurvey.org/viewer/jpeg-cutout/?ra=190.1086&dec=1.2005&layer=dr8&pixscale=0.27&bands=grz

FITS:   http://legacysurvey.org/viewer/fits-cutout/?ra=190.1086&dec=1.2005&layer=dr8&pixscale=0.27&bands=grz

This will merge the northern (MzLS+BASS) and equatorial (DECam) images at the Dec=32.375 line. To request images from only the northern or equatorial surveys, specify dr8-north or dr8-south, for example:
JPEG (DECaLS):   http://legacysurvey.org/viewer/jpeg-cutout?ra=190.1086&dec=1.2005&layer=dr8-south&pixscale=0.27&bands=grz

FITS (DECaLS):   http://legacysurvey.org/viewer/fits-cutout?ra=190.1086&dec=1.2005&layer=dr8-south&pixscale=0.27&bands=grz

JPEG (BASS/MzLS):   http://legacysurvey.org/viewer/jpeg-cutout?ra=154.7709&dec=46.4537&layer=dr8-north&pixscale=0.27&bands=grz

FITS (BASS/MzLS):   http://legacysurvey.org/viewer/fits-cutout?ra=154.7709&dec=46.4537&layer=dr8-north&pixscale=0.27&bands=grz

where "bands" is a string such as "grz","gz","g", etc. Replacing layer=dr8 (or layer=dr8-north) with layer=dr8-model (layer=dr8-north-model) or layer=dr8-resid (layer=dr8-north-resid) will instead return cutouts for the model and residual images, respectively.

JPEG:   http://legacysurvey.org/viewer/jpeg-cutout/?ra=190.1086&dec=51.2005&layer=mzls+bass-dr6&pixscale=0.27&bands=grz

FITS:   http://legacysurvey.org/viewer/fits-cutout/?ra=190.1086&dec=51.2005&layer=mzls+bass-dr6&pixscale=0.27&bands=g

JPEG:   http://legacysurvey.org/viewer/jpeg-cutout/?ra=190.1086&dec=1.2005&layer=decals-dr5&pixscale=0.27&bands=grz

FITS:   http://legacysurvey.org/viewer/fits-cutout/?ra=190.1086&dec=1.2005&layer=decals-dr5&pixscale=0.27&bands=grz

JPEG:   http://legacysurvey.org/viewer/jpeg-cutout/?ra=190.1086&dec=51.2005&layer=mzls+bass-dr4&pixscale=0.27&bands=grz

FITS:   http://legacysurvey.org/viewer/fits-cutout/?ra=190.1086&dec=51.2005&layer=mzls+bass-dr4&pixscale=0.27&bands=grz

where "bands" is a string like "grz",”gz","g", etc. As of the writing of this documentation the maximum size for cutouts (in number of pixels) is 512. Pixscale=0.262 will return (approximately) the native pixels used by the Tractor.

JPEG:   http://legacysurvey.org/viewer/jpeg-cutout/?ra=190.1086&dec=1.2005&layer=decals-dr3&pixscale=0.27&bands=grz

FITS:   http://legacysurvey.org/viewer/fits-cutout/?ra=190.1086&dec=1.2005&layer=decals-dr3&pixscale=0.27&bands=grz

FTP access

The Legacy Survey catalog files, images, and products of the photometric pipeline are available by FTP at the NSF’s OIR Lab High Level Data Products site for DR8 and previous data releases, such as DR7 (guest connection).

The NSF’s OIR Lab Science Archive access

The NSF’s OIR Lab Science Archive portal can be used to retrieve raw, and calibrated Legacy Survey images, as well as the Tractor catalogs.

  • Query the NSF’s OIR Lab Science Archive.
  • From the menu of "Available Collections" on the left, select the desired data release (e.g. Legacy Survey-DR8).
  • Under "Data products - Raw data" check "Object".
  • Optionally, you may select data from specific filters, or restrict the search by other parameters such as sky coordinates, observing date, or exposure time.
  • Click "Search".
  • In the DR8 (or DR7, DR5, DR3) collection, refine the search by Proposal ID (2014B-0404) in the "Refine" tab in order to obtain DECaLS only images.

There is a direct link for the LS DR8 collection. Similarly, the previous DR7 and DR6 collections also have a direct link.

The Results page offers several different ways to download the data. See the Tutorials page for details.