TesscutClass

class astroquery.mast.TesscutClass

Bases: astroquery.query.BaseQuery

MAST TESS FFI cutout query class.

Class for accessing TESS full-frame image cutouts.

Methods Summary

download_cutouts([coordinates, size, …])	Download cutout target pixel file(s) around the given coordinates with indicated size.
get_cutouts([coordinates, size, sector, …])	Get cutout target pixel file(s) around the given coordinates with indicated size, and return them as a list of HDUList objects.
get_sectors([coordinates, radius, objectname])	Get a list of the TESS data sectors whose footprints intersect with the given search area.

Methods Documentation

download_cutouts(coordinates=None, size=5, sector=None, path='.', inflate=True, objectname=None)

Download cutout target pixel file(s) around the given coordinates with indicated size.

Parameters:

coordinates : str or astropy.coordinates object, optional

The target around which to search. It may be specified as a string or as the appropriate astropy.coordinates object. One and only one of coordinates and objectname must be supplied.

size : int, array-like, Quantity

Optional, default 5 pixels. The size of the cutout array. If size is a scalar number or a scalar Quantity, then a square cutout of size will be created. If size has two elements, they should be in (ny, nx) order. Scalar numbers in size are assumed to be in units of pixels. Quantity objects must be in pixel or angular units.

sector : int

Optional. The TESS sector to return the cutout from. If not supplied, cutouts from all available sectors on which the coordinate appears will be returned.

path : str

Optional. The directory in which the cutouts will be saved. Defaults to current directory.

inflate : bool

Optional, default True. Cutout target pixel files are returned from the server in a zip file, by default they will be inflated and the zip will be removed. Set inflate to false to stop before the inflate step.

objectname : str, optional

The target around which to search, by name (objectname=”M104”) or TIC ID (objectname=”TIC 141914082”). One and only one of coordinates and objectname must be supplied.

Returns:

response : Table

get_cutouts(coordinates=None, size=5, sector=None, objectname=None)

Get cutout target pixel file(s) around the given coordinates with indicated size, and return them as a list of HDUList objects.

Parameters:

coordinates : str or astropy.coordinates object, optional

The target around which to search. It may be specified as a string or as the appropriate astropy.coordinates object. One and only one of coordinates and objectname must be supplied.

size : int, array-like, Quantity

Optional, default 5 pixels. The size of the cutout array. If size is a scalar number or a scalar Quantity, then a square cutout of size will be created. If size has two elements, they should be in (ny, nx) order. Scalar numbers in size are assumed to be in units of pixels. Quantity objects must be in pixel or angular units.

sector : int

Optional. The TESS sector to return the cutout from. If not supplied, cutouts from all available sectors on which the coordinate appears will be returned.

objectname : str, optional

The target around which to search, by name (objectname=”M104”) or TIC ID (objectname=”TIC 141914082”). One and only one of coordinates and objectname must be supplied.

Returns:

response : A list of HDUList objects.

get_sectors(coordinates=None, radius=<Quantity 0.2 deg>, objectname=None)

Get a list of the TESS data sectors whose footprints intersect with the given search area.

Parameters:

coordinates : str or astropy.coordinates object, optional

The target around which to search. It may be specified as a string or as the appropriate astropy.coordinates object. One and only one of coordinates and objectname must be supplied.

radius : str, float, or Quantity object, optional

Default 0.2 degrees. If supplied as a float degrees is the assumed unit. The string must be parsable by Angle. The appropriate Quantity object from astropy.units may also be used.

objectname : str, optional

The target around which to search, by name (objectname=”M104”) or TIC ID (objectname=”TIC 141914082”). One and only one of coordinates and objectname must be supplied.

Returns:

response : Table

Sector/camera/chip information for given coordinates/raduis.