The TESS mission has several data products ranging from the TESS input catalog to a catalog of planet candidates. Here we give an overview of what information is in each data product. More information on downloading products at MAST is covered in Section 5.
On this page...
Photometric Data Products
TESS obtains time-series photometry at a few different cadences with a baseline ranging from ~27 days to a full year, depending on sector overlap. An overview of the primary pixel-level science products is shown above. The entirety of the CCDs is known as a Full Frame Image (FFI). Certain groups of pixels are also downloaded at a faster cadence for a subset of targets; these are known as Target Pixel (TP) files. The pixels around a selected star are stored as arrays in these target-pixel files, one image per time stamp. Aperture photometry is performed on each image, creating an array of fluxes; these are known as Light Curve (LC) files. See the Science Product Handbook for more detailed information on file formats and content. See the Levels Of Data Processing page to better understand how SAP, PDCSAP, and Co-trending Basis Vectors relate to TESS data products.
- Full Frame Images (FFI) (uncalibrated: _ffir.fits, calibrated: _ffic.fits): These files contain the 30-minute, 10-minute, or 200-second cadence time series of the entire field of view; both uncalibrated and calibrated versions are available.
- For users who plan to use most or all of the FFIs, the FFI data files are best obtained using the bulk download scripts.
- TESScut service. TESScut cutouts of the calibrated FFI time series (ffic files) are available through the MAST TESScut service. This creates files that look like the target pixel files but are at the cadence of the FFIs and do not include background subtraction. Also note that the times in the TESScut files have not been barycenter corrected beyond the correction applied by the mission, which is corrected to the center of the CCD. For more information on the TESScut files, see the astrocut documentation. The FFI cubes from which TESScut performs its cutouts are available in the public S3 bucket on AWS.
- Target Pixel (TP) Files (_tp.fits, _fast-tp.fits): These files contain a time series of the raw and calibrated pixels downloaded at the 2-minute and 20-second cadence.
- Light Curve (LC) Files (_lc.fits, _fast-lc.fits): These files contain the flux time series derived from the calibrated 2-minute and 20-second target pixels. These files contain several time series, including the simple aperture photometry, a detrended light curve, position vectors, and quality flags. The aperture photometry flux series is known as the SAP_FLUX, while the flux series that has the common instrumental systematics removed using the CBV files is known as the PDCSAP_FLUX. The PDCSAP_FLUX light curves also correct for the amount of flux captured by the photometric aperture and crowding from known nearby stars.
Cotrending Basis Vectors (CBV) (_cbv.fits): The cotrending basis vectors represent the set of systematic trends present in the ensemble light curve data for each CCD and can be used to remove common instrument systematics from the data. These vectors are created by the pipeline to produce the detrended flux time series (PDCSAP_FLUX) in the light curve files. The CBVs can be fit to individual aperture photometry light curves (SAP_FLUX) on the same channel to fine-tune the detrending. (There are no CBVs associated with the fast, 20-second light curves.)
Extended Mission Update
Sector 27 is the first set of data associated with the TESS extended mission that began in July 2020. There are a few changes to the observing mode following the mission extension. The FFIs are now read out at a 10-minute cadence instead of a 30-minute cadence. Also, a select set of targets are being read out at a 20-second cadence in addition to the 2-minute cadence. These short cadence observations are delivered as target pixel and light curve files. No Data Validation files are created for the 20-second data products.
Second Extended Mission Update
Sector 56 is the first set of data associated with the second TESS extended mission that began in September 2022. The FFIs are now read out at a 200-second cadence instead of a 10-minute cadence.
Table: Cadence Quality Flags
The TESS pipeline populates a series of quality flags to indicate when a cadence may have been taken during an anomalous event. These flags are available in the light curve files, the target pixel files, and a subset are available for the FFIs. Those in the FFIs are created by taking a logical AND across the short cadences. The following table describes the meaning of each flag.
n Binary Digit # | Value = 2(n-1) | TESS Quality Flag Description |
---|---|---|
1 | 1 | Attitude Tweak |
2 | 2 | Safe Mode |
3 | 4 | Spacecraft is in Coarse Point |
4 | 8 | Spacecraft is in Earth Point |
5 | 16 | Argabrightening Event |
6 | 32 | Reaction Wheel Desaturation Event |
7 | 64 | Cosmic Ray in Optimal Aperture Pixel |
8 | 128 | Manual Exclude due to an anomaly. |
9 | 256 | Discontinuity corrected between this cadence and the next one. |
10 | 512 | Impulsive outlier removed before cotrending |
11 | 1024 | Cosmic ray detected on collateral pixel row or column |
12 | 2048 | Stray light from Earth to Moon in Camera FOV |
13 | 4096 | Scattered Light Exclude (pipeline >= spoc-4.0.5) |
14 | 8192 | Planet Search Exclude (pipeline >= spoc-4.0.5) |
15 | 16384 | Bad Calibration Exclude (pipeline >= spoc-4.0.14) |
16 | 32768 | Insufficient Targets for Error Correction Exclude (pipeline >= spoc-4.0.14) |
Advice on usage of cadence quality flags. Not all of these pixels indicate that the data quality is bad. In many cases the flags simply indicate that a correction was made. For instance, bit 7 indicates that a cosmic ray was corrected on one of the pixels in the optimal aperture. If this is the only flag on this cadence, then the data is likely fine and should not be excluded from your analysis. Different science cases may warrant different usages of these flags. As a starting point, the following flags indicate that the cadence will likely be of lesser quality: 1,2,3,4,5,6,8,10,13, and 15. More specifically, a bit-wise AND with the binary number 0101001010111111 indicate cadences that are likely of lesser quality.
Note also that cadences marked with bits 2 and 4 (Safe Mode and Earth Point) have timestamps and data marked with NULL in the target-pixel and light curve files.
Table: Aperture Mask Image Flags
The light curve and target pixel files contain an image in the APERTURE FITS extension that describes how each pixel was used in the processing. The integer values of this image are the bit-wise OR of the bits described in the following table.
n Binary Digit # | Value = 2(n-1) | Description |
---|---|---|
1 | 1 | Pixel was collected by the spacecraft. |
2 | 2 | Pixel was in the optimal photometric aperture to calculate SAP_FLUX. |
3 | 4 | Pixel was used in background calculation. |
4 | 8 | Pixel was used to calculate the flux-weighted centroid. |
5 | 16 | Pixel was used to calculate the PRF centroid. |
6 | 32 | Pixel is on CCD output A |
7 | 64 | Pixel is on CCD output B |
8 | 128 | Pixel is on CCD output C |
9 | 256 | Pixel is on CCD output D |
Target Catalogs
TESS provides several catalogs of target stars to choose which stars will be observed at the 2-minute cadence.
- TESS Input Catalog (TIC): Catalog of luminous sources in the sky created by the TESS Stellar Properties Working Group, used to select targets to observe at the short cadence. It is also used to estimate flux contributions of stars within pixels. The TIC is available through the MAST Portal, CasJobs, via the API/astroquery, and as a direct download split into a series of .csv files.
- Catalog Target Lists (CTL): Several lists of TIC stars that indicate the priorities for short-cadence observations from different science perspectives. The same TIC ID may appear in more than one list. See the figure above for the names of the various CTLs. Some CTLs, such as the xCTL, are available for download and searching at MAST.
- Merged Target List (MTL): This list represents the final set of targets observed at the 2-minute cadence. It is created by selecting targets in the various CTLs plus specific engineering targets. Each target in the MTL should have a target pixel file and a light curve file created from the mission pipeline. This product is called "target list" on the All Data Products page.
Planet Search Products
The flux time series for each star observed in short cadence is then further detrended and searched for transits. The repeating signals identified in this way are known as Threshold Crossing Events (TCE). The TESS Science Processing Pipeline produces the following products for each target star that generates a TCE.
The TESS mission searches each sector individually for planets and performs multi-sector searches for targets observed in more than one sector. The DV products listed below exist for these multi-sector searches and can be found in their own Observation when searching for data in the MAST portal or using astroquery. The single-sector DV products can be found next to the 2-minute light curves after removing the check mark for minimum recommended products. The DV reports and summaries are also available in bulk from the bulk downloads page.
- DV Time Series File (.dvt.fits): These files contain the sector-stitched, detrended, and whitened light curves searched by the TESS Pipeline. All TCEs found on a star in one search are contained in the same file.
- DV Report (.dvr.pdf): These pdf files contain plots and statistics for every TCE assigned to a given TIC target. For example, the reports contain plots of folded light curves and in- and out-of-transit difference images.
- DV One-Page Summary (.dvs.pdf): This one-page summary contains a quick overview of each individual TCE. In it, you'll find the essential information to determine if a transit likely causes the signal or if the TCE shows evidence of being caused by an eclipsing binary or instrumental noise. Each TCE gets its own file, so if multiple TCEs are found on the same TIC target, there will be multiple _dvs.pdf files for that target. These files are very similar to those produced for Kepler and a description of some of the metrics on this page can be found here.
- DV mini-report (.dvm.pdf): This multi-page report contains vetting metrics to evaluate whether a TCE is a planet, but is not as detailed as the full DV report. There is one mini-report per search per star.
Exoplanet Result Catalogs
TESS produces several catalogs of possibly transit-like, periodic signals found in the TESS data. Each successive catalog represents a more intense vetting process. The catalog of signals with the least amount of vetting is the Threshold Crossing Events (TCEs), which the SPOC Pipeline produces. Other groups may also search the short cadence light curves or the longer cadence FFIs for signals consistent with transiting exoplanets. Since these signals have little-to-no vetting, the reliability can be quite low. Signals found in the data are then turned into TESS Objects of Interest (TOI) once the signal is vetted and determined to be sufficiently consistent with a transit or eclipse. The TOI list contains planet candidates and false positives, but all signals are worthy of follow-up observations. Once follow-up measurements, or additional analysis, reveal the mass of the transiting object or remove all doubt that an eclipsing binary could cause the signal, the planet is considered confirmed.
- Threshold Crossing Events (TCE): Table of TCE signals and various metrics that measure different aspects of that signal. The project provides a highly detrended light curve file for each TCE and a report showing relevant plots to evaluate whether the signal is a planet. The project also provides an xml file for each star that contains all the information related to the TCEs found in that star's light curve. These signals are not vetted and include false positives and instrumental false alarms. Each TCE is identified by a TIC ID, planet number, and search ID.
- TESS Objects of Interest (TOI): Table containing the list of signals consistent with being a transiting planet. This catalog provides a disposition of either planet candidate or false positive, which can change after a follow-up observation and additional data analysis.
- Confirmed Planets: Transiting planets found in the TESS data for which follow-up data provide a mass of the planet. See the exoFOP-TESS page for more information about what follow-up data are available.
Engineering and Model Files
These files include the Pixel Response Function, the flat field models, the 2D black model, and the engineering mnemonics. See the full listing of the data products.
Pixel Response Functions
The PRF models were created by the SPOC by fitting to micro-dithered data taken during PRF commissioning exercises. See the Instrument Handbook for details on the data collection. The pixel response functions in FITS or Matlab format are available from the models/prf_fitsfiles directory. There are two versions of the PRF. Those in the directory start_s0001/ apply to the data taken in Sectors 1–3, and those in start_s0004/ apply to the data taken in Sector 4 and beyond.
For each CCD, the pixel response function is provided for 5x5 locations across the detector. For each CCD location, there is an associated FITS file. The reference row/column of the grid points is provided in the image file names and FITS headers. These reference locations define the center of the PRF image in the TESS CCD coordinate system. The images are composed of 9x9 intra-pixel samples per physical TESS CCD pixels. The size of the PRF provided for each intra-pixel sample is 13x13 pixels. Each FITS file contains two extensions: the primary header contains the PRF image data itself, and the 2nd extension contains the uncertainties. Users can interpolate between both the location on the CCD and the intra-pixel location to obtain a PRF for an arbitrary location on the detector.
The 'PHYSICAL' WCS solutions can be used to convert the PRF image coordinates to the corresponding locations on the TESS CCDs. The TESS CCD coordinate systems are defined so that row,col = 1,1 is the center of the lower left pixel of each CCD. Note that the PRF locations do not always map to "real" TESS pixels: in the adopted coordinate system, there may be negative TESS pixels or pixels larger than the total number in the CCD imaging arrays (> 2048). These locations are well-defined in the instrument's focal plane even though no light-sensitive pixels are present. Bilinear interpolation on the images between the grid points can be used to estimate the PRF at arbitrary locations and is accurate to 1%-5%. This coordinate system is offset from the FFIs/TPF coordinate system by 44 columns, owing to the presence of collateral pixels in the science data products (overscan regions).