TGLC

TESS-Gaia Light Curve ("TGLC")

Primary Investigator: Timothy D. Brandt

HLSP Authors: Te Han

Released: 2023-01-19

Updated: 2024-11-07

Primary Reference(s): Han & Brandt 2023

DOI: 10.17909/610m-9474

Citations: See ADS Statistics

Read Me

Overview

TESS-Gaia Light Curve (TGLC) is a PSF-based TESS full-frame image (FFI) light curve product. Using Gaia DR3 as priors, the team forward models the FFIs with the effective point spread function to remove contamination from nearby stars. The resulting light curves show a photometric precision closely tracking the pre-launch prediction of the noise level: TGLC's photometric precision consistently reaches ≲2% at 16th TESS magnitude even in crowded fields, demonstrating excellent decontamination and deblending power.

The HLSP authors publish TGLC Aperture and PSF light curves for stars down to 16th TESS magnitude for all available sectors and will continue to deliver future light curves. The authors also publish an open-source package tglc, which can be used to produce similar quality light curves for any sector and any star with custom options. For the quickest access to light curves from newly released TESS sectors, the team recommends that users run the tglc package. MAST does not own or maintain this software repository, and takes no responsibility for its performance or quality, but provides a link to it here to the software "as-is" for convenience.

Data Notes

In the primary TESS Mission (Sectors 1 through 26) light curves provided by the TGLC team, in cases where the target star is very dim (≲15 T_mag) and near a variable source, the aperture and/or PSF light curve may be negative for some cadences. The subsequent detrending algorithm may malfunction and result in bad cal_aper_flux and/or cal_psf_flux values. This issue now fixed for the tglc package and will be applied to future TGLC data releases, but this problem remains for the primary Mission light curves published on MAST. Users should detrend these light curves if necessary.

Data Products

The light curve files have this data file naming convention:

hlsp_tglc_tess_ffi_gaiaid-<gaiaid>-s<sector>-cam<cam>-ccd<ccd>_tess_v1_llc.fits

where:

<gaiaid> = The full Gaia DR3 source ID, e.g., "6483604294135323520".
<sector> = The Sector represented as a 4-digit, zero-padded string, e.g., "s0004" for Sector 4.
<cam> = The camera number (1-4), e.g., "cam1" for Camera 1.
<ccd> = The CCD number (1-4) for that camera, e.g., "ccd1" for CCD 1.

Data file types:

_llc.fits	Extracted light curve file

Data Access

TGLC light curves are available via the MAST Portal web search and the astroquery python package. Set "Provenance Name" to "TGLC" in the Portal's Advanced Search if you wish to restrict results to TGLC. You can also use the "Sequence Number" to limit the search to a specific Sector. You can also search on TESS Input Catalog (TIC) ID using the "Target Name" field in Advanced Search. Alternatively, to search on Gaia DR3 ID, you can search for "hlsp_tglc%<gaiaid>%" in the Observation ID field.

* The TGLC light curves for Sectors 9-38 are not yet available via the MAST Portal, API, or astroquery, but can be accessed for bulk download via the provided curl script in the table below.

MAST Portal

A web-based interface for cross-mission searches of data at MAST or the VO. Download a small number of TGLC light curves.

Portal
MAST Astroquery

Search for, and retrieve, TGLC data products programmatically in python based on a list of coordinates or target names.

MAST Astroquery

For bulk downloads of TGLC light curves, we recommend utilizing the bulk download scripts for each Sector, provided in the table below. The scripts use curl, which is likely already installed on many machines, and if not, is freely available as open source software. The bulk download scripts for the TESS Mission light curves also make use of curl. You can run each shell script directly in a terminal to retrieve the full set of files, or use a selected subset of the script; each line in the script downloads one TGLC file.

Target list files are provided that contain the Gaia DR3 ID, TIC ID, RA (J2000, deg), and Dec (J2000, deg) for targets that have TGLC light curves. For users with very large target lists, it is recommended you download these .csv files first to cross-match with your list of targets BEFORE you query MAST to search for and download TGLC data products.

Year 4 (Sectors 40-52)

TESS Sector	Number of Light Curves	Total Data Volume	Bulk Download Script
40 *	6022929	5.1 TB	Sector 40 Light Curves \| Target List *

Year 3 (Sectors 27-39)

TESS Sector	Number of Light Curves	Total Data Volume	Bulk Download Script
27 *	3,712,279	2.1 TB	Sector 27 Light Curves \| Target List *
28 *	2,352,872	1.3 TB	Sector 28 Light Curves \| Target List *
29 *	1,936,005	1.1 TB	Sector 29 Light Curves \| Target List *
30 *	1,837,250	1.0 TB	Sector 30 Light Curves \| Target List *
31 *	1,981,993	1.1 TB	Sector 31 Light Curves \| Target List *
32 *	2,868,908	1.9 TB	Sector 32 Light Curves \| Target List *
33 *	6,703,789	3.7 TB	Sector 33 Light Curves \| Target List *
34 *	7,833,121	4.3 TB	Sector 34 Light Curves \| Target List *
35 *	6,458,892	3.4 TB	Sector 35 Light Curves \| Target List *
36 *	7,318,634	4.0 TB	Sector 36 Light Curves \| Target List *
37 *	10,064,914	5.3 TB	Sector 37 Light Curves \| Target List *
38 *	13,626,975	11 TB	Sector 38 Light Curves \| Target List *
39 *	18,978,318	15 TB	Sector 39 Light Curves \| Target List *

Year 2 (Sectors 14-26)

TESS Sector	Number of Light Curves	Total Data Volume	Bulk Download Script
14 *	8,013,669	2.1 TB	Sector 14 Light Curves \| Target List *
15 *	6,515,019	1.7 TB	Sector 15 Light Curves \| Target List *
16 *	5,969,587	1.9 TB	Sector 16 Light Curves \| Target List *
17 *	5,681,194	1.9 TB	Sector 17 Light Curves \| Target List *
18 *	5,587,877	1.4 TB	Sector 18 Light Curves \| Target List *
19 *	5,046,262	1.7 TB	Sector 19 Light Curves \| Target List *
20 *	2,726,244	0.9 TB	Sector 20 Light Curves \| Target List *
21 *	1,602,140	0.5 TB	Sector 21 Light Curves \| Target List *
22 *	1,385,316	0.5 TB	Sector 22 Light Curves \| Target List *
23 *	1,460,425	0.5 TB	Sector 23 Light Curves \| Target List *
24 *	4,246,121	1.4 TB	Sector 24 Light Curves \| Target List *
25 *	3,418,488	1.1 TB	Sector 25 Light Curves \| Target List *
26 *	3,926,538	1.3 TB	Sector 26 Light Curves \| Target List *

Year 1 (Sectors 1-13)

TESS Sector	Number of Light Curves	Total Data Volume	Bulk Download Script
1	2,481,050	0.9 TB	Sector 1 Light Curves \| Target List
2	1,973,987	0.7 TB	Sector 2 Light Curves \| Target List
3	1,837,696	0.7 TB	Sector 3 Light Curves \| Target List
4	1,942,827	0.6 TB	Sector 4 Light Curves \| Target List
5	2,582,658	0.9 TB	Sector 5 Light Curves \| Target List
6	5,517,576	1.6 TB	Sector 6 Light Curves \| Target List
7	8,116,193	2.4 TB	Sector 7 Light Curves \| Target List
8	6,644,752	1.8 TB	Sector 8 Light Curves \| Target List
9 *	6,801,919	2.2 TB	Sector 9 Light Curves \| Target List *
10 *	9,357,081	2.9 TB	Sector 10 Light Curves \| Target List *
11 *	13,220,294	4.1 TB	Sector 11 Light Curves \| Target List *
12 *	17,775,922	5.5 TB	Sector 12 Light Curves \| Target List *
13 *	9,428,024	3.0 TB	Sector 13 Light Curves \| Target List *

Citations

Please remember to cite the appropriate paper(s) below and the DOI if you use these data in a published work.

Note: These HLSP data products are licensed for use under CC BY 4.0.

Mission Overview