Versions Compared

Key

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

...

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

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 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 documentationfield list and data products fields for the full list of filters.

...

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_id

The Guest Investigator IDs are provided in this column. They are stored in a string with underscores separating them.

e.g. G011183_G011132_G011048_G011250

Sectorsequence_numberSector number is stored in this field as an integer.
Data Product Typedataproduct_type

FFI: "image"

postage-stamp: "time seriestimeseries"

Target Nametarget_name

postage-stamp: The integer TIC ID is given.

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

Data Products Filter

FilterField NameHow it is used for TESS Data
Minimum Recommended Productmrp_only

When set to True you only get the most common data products. They are:

postage-stamp: light curve files and target pixel files.

FFI: There are no MRPs. 

Product Typeproduct_type

postage-stamp: "timeseries"

FFI: "image"

Descriptiondescription

Choices are":

  • calibrated full frame images
  • uncalibrated full frame images
  • Light curves
  • Target pixel files
Data File TypeproductSubGroupDescription
  • FFIR - raw FFIs
  • FFIC - calibrated FFIs
  • TP - Target pixel files
  • LC - Light curves
  • DVR - Data validation report (includes pdf report and xml file)
  • DVS - Data validation summary
  • DVT - Data validation timeseries