Skip to main content

No project description provided

Project description

Test status PyPI version Documentation

tesscube is a package designed to help you obtain TESS data by cutting it out of the FFI cubes at the Barbara A. Mikulski Archive for Space Telescopes (MAST).

tesscube works with data that is available in the cloud, and will return TESS data in formats similar to the NASA TESS official mission products. You do not need any login credentials to use tesscube, and can use this tool by pip installing either on your local machine or in the cloud.

Quickstart

The easiest way to install tesscube and all of its dependencies is to use the pip command.

To install tesscube, run the following command in a terminal window:

$ python -m pip install tesscube --upgrade

The --upgrade flag is optional, but recommended if you already have tesscube installed and want to upgrade to the latest version.

Depending on the specific Python environment, you may need to replace python with the correct Python interpreter, e.g., python3.

Load an FFI cube

You can work with an FFI cube by loading it using a sector, camera, and CCD number.

from tesscube import TESSCube
cube = TESSCube(sector=1, camera=1, ccd=4)

Obtain an FFI Using tesscube

You can obtain an FFI image by indexing into a cube

from tesscube import TESSCube
cube = TESSCube(sector=1, camera=1, ccd=4)
ffi = cube[300]

This will return an astropy.fits.HDUList

Obtain a TPF

You can obtain a TPF in two ways, either you can either pass a pixel position

from tesscube import TESSCube
from astropy.coordinates import SkyCoord
corner = (1282, 1750)
cube = TESSCube(sector=1, camera=1, ccd=4)
tpf = cube.get_tpf(corner, shape=(10, 11))

Or you can pass an astropy SkyCoord object containing the RA and Dec of the target

from tesscube import TESSCube
from astropy.coordinates import SkyCoord
coord = SkyCoord.from_name("AU Mic")
cube = TESSCube(sector=1, camera=1, ccd=4)
tpf = cube.get_tpf(coord, shape=(10, 11))

Alternatively, you can index into the cube like so:

from tesscube import TESSCube
cube = TESSCube(sector=1, camera=1, ccd=4)
tpf = cube[:, 401:410, 503:510]

Both will return an astropy.fits.HDUList, with a file format similar to the official mission products.

Obtain a lower time resolution TPF

You can obtain a lower time resolution by either passing in a frame_bin parameter, which will downsample the resultant TPF,

from tesscube import TESSCube
from astropy.coordinates import SkyCoord
corner = (1282, 1750)
cube = TESSCube(sector=1, camera=1, ccd=4)
tpf = cube.get_tpf(corner, shape=(10, 11), frame_bin=10)

Or you can slice the cube, which will return a downsampled TPF

from tesscube import TESSCube
cube = TESSCube(sector=1, camera=1, ccd=4)
tpf = cube[::10, 401:410, 503:510]

Both will return an astropy.fits.HDUList, with a file format similar to the official mission products, with the time resolution reduced by a factor of 10.

Contributing

tesscube is an open-source, community driven package. We welcome users to contribute and develop new features for lksearch.

For further information, please see the Lightkurve Community guidelines.

Citing

If you find tesscube useful in your research, please cite it and give us a GitHub star!

If you use Lightkurve for work or research presented in a publication, we request the following acknowledgment or citation:

This research made use of Lightkurve, a Python package for Kepler and TESS data analysis (Lightkurve Collaboration, 2018).

See full citation instuctions, including dependencies, in the Lightkurve documentation.

Contact

tesscube is an open source community project created by the TESS Science Support Center. The best way to contact us is to open an issue or to e-mail tesshelp@bigbang.gsfc.nasa.gov.

Please include a self-contained example that fully demonstrates your problem or question.

Changelog:

  • Initial v1.0.0 release of tesscube.

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

tesscube-1.0.1.dev0.tar.gz (20.7 kB view details)

Uploaded Source

Built Distribution

tesscube-1.0.1.dev0-py3-none-any.whl (21.0 kB view details)

Uploaded Python 3

File details

Details for the file tesscube-1.0.1.dev0.tar.gz.

File metadata

  • Download URL: tesscube-1.0.1.dev0.tar.gz
  • Upload date:
  • Size: 20.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.2 CPython/3.9.13 Darwin/23.5.0

File hashes

Hashes for tesscube-1.0.1.dev0.tar.gz
Algorithm Hash digest
SHA256 0b0c4b97d12f141a4e29e38189857c63ac041f4eaf7e69651a753e7ae7701f5c
MD5 e379443fcaa0c3ebfe0c2e7143f32421
BLAKE2b-256 20f9f1eff3f6a08b7b02f4b5f1aebe6241c42ff666bef880c36d2c10071064fc

See more details on using hashes here.

File details

Details for the file tesscube-1.0.1.dev0-py3-none-any.whl.

File metadata

  • Download URL: tesscube-1.0.1.dev0-py3-none-any.whl
  • Upload date:
  • Size: 21.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.2 CPython/3.9.13 Darwin/23.5.0

File hashes

Hashes for tesscube-1.0.1.dev0-py3-none-any.whl
Algorithm Hash digest
SHA256 d0fa4e1ef1d2fbf62ddcd33f7aef1574b90dda1d06c60df1f5109ba770470a73
MD5 3e0196e270bd19c732df031c3895bf33
BLAKE2b-256 79ea4617f610051de47d35c9d0ab0ea3b78f59058c137463edaf197af7610600

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