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?
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9260711b37a2a454740f69f6641598b76e7ff157b60fda358bd43576d3a7290c |
|
MD5 | 1b336ff3e1009ce7f7909969d7652807 |
|
BLAKE2b-256 | d00ed104c732777df6ed1ca0df7ea2e10e9d6c03fdf85ee5ce325cf468a24a39 |
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 20c0b40e46feceba10ea61e0c42bc6e48eba0523c3848ee28876baab9a0597eb |
|
MD5 | e604d1d4e7e04353c34e2f73ff73d9ba |
|
BLAKE2b-256 | 7f2cb3c9cf45d5e1f55382fd29de7c2e0b46889bd200f04027609c0ecdb6995f |