Skip to main content

Fast offline queries of TESS FFI positions and filenames.

Project description

Where is my favorite star or galaxy in NASA’s TESS Full Frame Image data set?

pypi pytest black flake8 mypy

tess-locator is a user-friendly package which combines the tess-point and tess-cloud packages to enable the positions of astronomical objects in the TESS data set to be queried in a fast and friendly way.

Installation

python -m pip install tess-locator

Example use

Converting celestial coordinates to TESS pixel coordinates:

>>> from tess_locator import locate
>>> locate("Alpha Cen")
List of 3 coordinates
[TessCoord(sector=11, camera=2, ccd=2, column=1699.1, row=1860.3, time=None)
  TessCoord(sector=12, camera=2, ccd=1, column=359.9, row=1838.7, time=None)
  TessCoord(sector=38, camera=2, ccd=2, column=941.1, row=1953.7, time=None)]

Obtaining pixel coordinates for a specific time:

>>> locate("Alpha Cen", time="2019-04-28")
List of 1 coordinates
[TessCoord(sector=11, camera=2, ccd=2, column=1699.1, row=1860.3, time=2019-04-28 00:00:00)]

Obtaining pixel coordinates for a specific celestial coordinate:

>>> from astropy.coordinates import SkyCoord
>>> crd = SkyCoord(ra=60, dec=70, unit='deg')
>>> locate(crd)
List of 4 coordinates
[TessCoord(sector=19, camera=2, ccd=2, column=355.3, row=1045.9, time=None)
  TessCoord(sector=25, camera=4, ccd=4, column=1107.0, row=285.9, time=None)
  TessCoord(sector=26, camera=4, ccd=3, column=317.7, row=395.9, time=None)
  TessCoord(sector=52, camera=4, ccd=4, column=603.5, row=240.2, time=None)]

You can access the properties of TessCoord objects using standard list and attribute syntax:

>>> crdlist = locate("Alpha Cen")
>>> crdlist[0].sector, crdlist[0].camera, crdlist[0].ccd
(11, 2, 2)
>>> crdlist[0].column, crdlist[0].row
(1699.0540739785683, 1860.2510951146114)

When you have obtained a TessCoord object, you can use it to obtain a list of the TESS Full Frame Images (FFIs) which covered the position. The objects returned are provided by the tess-cloud package.

>>> crdlist[0].list_images()
List of 1248 images
[TessImage("tess2019113062933-s0011-2-2-0143-s_ffic.fits")
  TessImage("tess2019113065933-s0011-2-2-0143-s_ffic.fits")
  TessImage("tess2019113072933-s0011-2-2-0143-s_ffic.fits")
  TessImage("tess2019113075933-s0011-2-2-0143-s_ffic.fits")
  ...
  TessImage("tess2019140065932-s0011-2-2-0143-s_ffic.fits")
  TessImage("tess2019140072932-s0011-2-2-0143-s_ffic.fits")
  TessImage("tess2019140075932-s0011-2-2-0143-s_ffic.fits")
  TessImage("tess2019140082932-s0011-2-2-0143-s_ffic.fits")]

Documentation

Please visit the tutorial.

Similar packages

  • tess-point is the package being called behind the scenes. Compared to tess-point, we add a user-friendly API and the ability to specify the time, which is important for moving objects.

  • astroquery.mast includes the excellent TesscutClass.get_sectors() method which queries a web API. This package provides an offline version of that service, and adds the ability to query by time.

  • tess-waldo lets you visualize how a target moves over the detector across sectors. It queries the TessCut service to obtain this information. This package adds the ability to create such plots offline.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tess_locator-0.6.0.tar.gz (7.7 kB view details)

Uploaded Source

Built Distribution

tess_locator-0.6.0-py3-none-any.whl (8.8 kB view details)

Uploaded Python 3

File details

Details for the file tess_locator-0.6.0.tar.gz.

File metadata

  • Download URL: tess_locator-0.6.0.tar.gz
  • Upload date:
  • Size: 7.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.6.1 CPython/3.8.6 Darwin/21.6.0

File hashes

Hashes for tess_locator-0.6.0.tar.gz
Algorithm Hash digest
SHA256 9260711b37a2a454740f69f6641598b76e7ff157b60fda358bd43576d3a7290c
MD5 1b336ff3e1009ce7f7909969d7652807
BLAKE2b-256 d00ed104c732777df6ed1ca0df7ea2e10e9d6c03fdf85ee5ce325cf468a24a39

See more details on using hashes here.

File details

Details for the file tess_locator-0.6.0-py3-none-any.whl.

File metadata

  • Download URL: tess_locator-0.6.0-py3-none-any.whl
  • Upload date:
  • Size: 8.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.6.1 CPython/3.8.6 Darwin/21.6.0

File hashes

Hashes for tess_locator-0.6.0-py3-none-any.whl
Algorithm Hash digest
SHA256 20c0b40e46feceba10ea61e0c42bc6e48eba0523c3848ee28876baab9a0597eb
MD5 e604d1d4e7e04353c34e2f73ff73d9ba
BLAKE2b-256 7f2cb3c9cf45d5e1f55382fd29de7c2e0b46889bd200f04027609c0ecdb6995f

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page