get_gaia_data

tessilator.maketable.get_gaia_data(gaia_table, name_is_source_id=False, type_coord='icrs', gaia_sys=True)[source]

Reads the input table and returns a table in the correct format for TESSilator.

The table must be in comma-separated variable format, in either of these 3 ways:

  1. A table with a single column containing the source identifier Note that this is the preferred method since the target identified in the Gaia query is unambiguously the same as the input value. Also, the name match runs faster than the coordinate match using astroquery.

  2. A table with sky-coordinates in either the ‘icrs’ (default), ‘galactic’, or ‘ecliptic’ system. * note this is slower because of the time required to run the Vizier query.

  3. A table with all 7 columns already made.

Parameters:
gaia_tableastropy.table.Table

The input table

name_is_source_idbool, optional, default=False

If the input table has 7 columns, this provides the choice to set the name column equal to “source_id” (True), or to find a common target identifier (False)

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:
tblastropy.table.Table

The table ready for TESSilator analysis, with the columns:

  • name: the preferred choice of source identifier

  • source_id: the Gaia DR3 source identifier

  • ra: right ascension (icrs) or longditude (galactic, barycentricmeanecliptic)

  • dec: declination (icrs) or latitude (galactic, barycentricmeanecliptic)

  • parallax: parallax from Gaia DR3 (in mas)

  • Gmag: the apparent G-band magnitude from Gaia DR3

  • BPmag: the apparent BP-band magnitude from Gaia DR3

  • RPmag: the apparent RP-band magnitude from Gaia DR3