TesscutClass

class astroquery.mast.TesscutClass

Bases: MastQueryWithLogin

MAST TESS FFI cutout query class.

Class for accessing TESS full-frame image cutouts.

Attributes Summary

cache_location

Methods Summary

__call__(*args, **kwargs)	init a fresh copy of self
authenticated()
clear_cache()	Removes all cache files.
disable_cloud_dataset()	Disables downloading public files from S3 instead of MAST
download_cutouts(*[, coordinates, size, ...])	Download cutout target pixel file(s) around the given coordinates with indicated size.
enable_cloud_dataset([provider, profile, ...])	Enable downloading public files from S3 instead of MAST.
get_cutouts(*[, coordinates, size, product, ...])	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, ...])	Get a list of the TESS data sectors whose footprints intersect with the given search area.
login([token, store_token, reenter_token])	Log into the MAST portal.
logout()	Log out of current MAST session.
reset_cache_location()	Resets the cache location to the default astropy cache
resolve_object(objectname)	Resolves an object name to a position on the sky.
session_info([verbose])	Displays information about current MAST user, and returns user info dictionary.

Attributes Documentation

cache_location

Methods Documentation

__call__(*args, **kwargs)

init a fresh copy of self

authenticated()

clear_cache()

Removes all cache files.

disable_cloud_dataset()

Disables downloading public files from S3 instead of MAST

download_cutouts(*, coordinates=None, size=5, sector=None, product='SPOC', path='.', inflate=True, objectname=None, moving_target=False, mt_type=None, verbose=False)

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

Parameters:

coordinatesstr 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.

NOTE: If moving_target or objectname is supplied, this argument cannot be used.

sizeint, 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.

sectorint

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.

productstr

Default is ‘SPOC’. The product that the cutouts will be made out of. Options are: ‘SPOC’ or ‘TICA’, for the Science Processing Operations Center (SPOC) products, and the TESS Image CAlibration (TICA) high-level science products, respectively. TICA products will usually be available for the latest sectors sooner than their SPOC counterparts, but are not available for sectors 1-26.

NOTE: TICA is currently not available for moving targets.

pathstr

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

inflatebool

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.

objectnamestr, optional

The target around which to search, by name (objectname=”M104”) or TIC ID (objectname=”TIC 141914082”). If moving_target is True, input must be the name or ID (as understood by the JPL ephemerides service) of a moving target such as an asteroid or comet.

NOTE: If coordinates is supplied, this argument cannot be used.

moving_targetstr, optional

Indicate whether the object is a moving target or not. Default is set to False, in other words, not a moving target.

NOTE: If coordinates is supplied, this argument cannot be used.

mt_typestr, optional

The moving target type, valid inputs are majorbody and smallbody. If not supplied first majorbody is tried and then smallbody if a matching majorbody is not found.

NOTE: If moving_target is supplied, this argument is ignored.

Returns:

responseTable

enable_cloud_dataset(provider='AWS', profile=None, verbose=True)

Enable downloading public files from S3 instead of MAST. Requires the boto3 library to function.

Parameters:

providerstr

Which cloud data provider to use. We may in the future support multiple providers, though at the moment this argument is ignored.

profilestr

Profile to use to identify yourself to the cloud provider (usually in ~/.aws/config).

verbosebool

Default True. Logger to display extra info and warning.

get_cutouts(*, coordinates=None, size=5, product='SPOC', sector=None, objectname=None, moving_target=False, mt_type=None)

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

Parameters:

coordinatesstr 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.

NOTE: If moving_target or objectname is supplied, this argument cannot be used.

sizeint, 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.

productstr

Default is ‘SPOC’. The product that the cutouts will be made out of. Options are: ‘SPOC’ or ‘TICA’, for the Science Processing Operations Center (SPOC) products, and the TESS Image CAlibration (TICA) high-level science products, respectively. TICA products will usually be available for the latest sectors sooner than their SPOC counterparts, but are not available for sectors 1-26.

NOTE: TICA is currently not available for moving targets.

sectorint

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.

objectnamestr, optional

The target around which to search, by name (objectname=”M104”) or TIC ID (objectname=”TIC 141914082”). If moving_target is True, input must be the name or ID (as understood by the JPL ephemerides service) of a moving target such as an asteroid or comet.

NOTE: If coordinates is supplied, this argument cannot be used.

moving_targetstr, optional

Indicate whether the object is a moving target or not. Default is set to False, in other words, not a moving target.

NOTE: If coordinates is supplied, this argument cannot be used.

mt_typestr, optional

The moving target type, valid inputs are majorbody and smallbody. If not supplied first majorbody is tried and then smallbody if a matching majorbody is not found.

NOTE: If moving_target is supplied, this argument is ignored.

Returns:

responseA list of HDUList objects.

get_sectors(*, coordinates=None, radius=<Quantity 0. deg>, product='SPOC', objectname=None, moving_target=False, mt_type=None)

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

Parameters:

coordinatesstr 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.

NOTE: If moving_target or objectname is supplied, this argument cannot be used.

radiusstr, float, or Quantity object, optional

Default 0 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.

NOTE: If moving_target is supplied, this argument is ignored.

productstr

Default is ‘SPOC’. The product whose sectors will be returned. Options are: ‘SPOC’ or ‘TICA’, for the Science Processing Operations Center (SPOC) products, and the TESS Image CAlibration (TICA) high-level science products, respectively. TICA products will usually be available for the latest sectors sooner than their SPOC counterparts, but are not available for sectors 1-26.

NOTE: TICA is currently not available for moving targets.

objectnamestr, optional

The target around which to search, by name (objectname=”M104”) or TIC ID (objectname=”TIC 141914082”). If moving_target is True, input must be the name or ID (as understood by the JPL ephemerides service) of a moving target such as an asteroid or comet.

NOTE: If coordinates is supplied, this argument cannot be used.

moving_targetbool, optional

Indicate whether the object is a moving target or not. Default is set to False, in other words, not a moving target.

NOTE: If coordinates is supplied, this argument cannot be used.

mt_typestr, optional

The moving target type, valid inputs are majorbody and smallbody. If not supplied first majorbody is tried and then smallbody if a matching majorbody is not found.

NOTE: If moving_target is supplied, this argument is ignored.

Returns:

responseTable

Sector/camera/chip information for given coordinates/objectname/moving_target.

login(token=None, store_token=False, reenter_token=False)

Log into the MAST portal.

Parameters:

tokenstring, optional

Default is None. The token to authenticate the user. This can be generated at https://auth.mast.stsci.edu/token?suggested_name=Astroquery&suggested_scope=mast:exclusive_access. If not supplied, it will be prompted for if not in the keyring or set via $MAST_API_TOKEN

store_tokenbool, optional

Default False. If true, MAST token will be stored securely in your keyring.

reenter_tokenbool, optional

Default False. Asks for the token even if it is already stored in the keyring or $MAST_API_TOKEN environment variable. This is the way to overwrite an already stored password on the keyring.

logout()

Log out of current MAST session.

reset_cache_location()

Resets the cache location to the default astropy cache

resolve_object(objectname)

Resolves an object name to a position on the sky.

Parameters:

objectnamestr

Name of astronomical object to resolve.

Returns:

responseSkyCoord

The sky position of the given object.

session_info(verbose=True)

Displays information about current MAST user, and returns user info dictionary.

Parameters:

verbosebool, optional

Default True. Set to False to suppress output to stdout.

Returns:

responsedict