Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Using Astroquery to Find Data

Astroquery is a convenient, programmatic way to filter all of MAST holdings and retrieve the files you would like. 

Using it effectively means understanding how the TESS data is represented in the MAST Observations database (also known as the Common Archive Observation Model, CAOM).  All data at MAST is split into observations. Each of those observations have several data files associated with them.  Once you have the observation ID you will be able to then request a list of data products.  Thus most searches for MAST data through astroquery require two filters, one on the observations level and one for the data products.  These tables provide useful information about those fields you might use to do those queries. Please see the CAOM documentation for the full list of filters.

Observations

FilterField NameHow it is used for TESS
Observation IDobs_id

FFIs: tess-s0001-4-2, where the 0001 is the sector, the 4 is the camera and 2 is the CCD

Postage stamp: the name is based on the file name and encodes the TIC ID and Sector Information.

Proposal IDproposal_idThe Guest Investigator IDs are provided in this column. They are stored in a string with underscores separating them.
Sectorsequence_numberSector number is stored in this field.
Data Product Typedataproduct_type

FFI: "image"

postage-stamp: "time series"

Target Nametarget_name

postage-stamp: The integer TIC ID is given.

FFI: "TESS-FFI" is always the value.

Data Products Filter