read_data

tessilator.tessilator.read_data(t_filename, name_is_source_id=False, type_coord='icrs', gaia_sys=True)[source]

Read input data and convert to an astropy table ready for analysis.

The input data must be in the form of a comma-separated variable and may take 3 forms:

  1. a 1-column table of source identifiers.

  2. a 2-column table of decimal sky coordinates (celestial or galactic).

  3. a pre-prepared table of 7 columns consisting of source_id, ra, dec, parallax, Gmag, BPmag, RPmag (without column headers).

Note that a single target can be quickly analysed directly from the command line by using option (a) with a #-sign preceding the target name, and then encompassed with double-quotation marks around the source identifier.

E.G. >>> python run_tess_cutouts files “#AB Doradus”

Parameters:
t_filenameastropy.table.Table

Name of the file containing the input data.

name_is_source_idbool, optional, default=False

When running option (c), the “name” column will automatically be set as the Gaia DR3 identifiers if this parameter is True. This avoids long sql queries for very large input tables.

type_coordstr, optional, default=’icrs’

The coordinate system of the input data. Choose from ‘icrs’, ‘galactic’ or ‘barycentricmeanecliptic’, where the latter is the conventional coordinate system used by TESS.

gaia_sysbool, optional, default=True

Choose to format the data based on Gaia DR3. Note that no contamination can be calculated if this is False.

Returns:
t_targetsastropy.table.Table

a formatted astropy table ready for further analysis