Skip to main content

A helpful little package to search for TESS/Kepler/K2 data

Project description

Test status PyPI version Documentation

lksearch

Helpful package to search for TESS/Kepler/K2 data

lksearch is a community developed, open source Python package that offers a user-friendly approach to searching the Barbara A. Mikulski Archive for Space Telescopes (MAST) web portal for scientific data and mission products from NASA’s TESS, K2, and Kepler missions. This package aims to lower the barrier for students, astronomers, and citizen scientists interested in analyzing time-series data from these NASA missions. It does this by providing a set of streamlined classes with simplified inputs and outputs that wraps Astroquery’s MAST.Observations class with user-friendly post-processing of observation tables and convenient bundled download methods.

Quickstart

The easiest way to install lksearch and all of its dependencies is to use the pip command, which is a standard part of all Python distributions. (upon release)

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

$ python -m pip install lksearch --upgrade

The --upgrade flag is optional, but recommended if you already have lksearch 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.

Search package for finding and retrieving TESS/Kepler/K2 mission data

This package is a stand-alone implementation of the lightkurve search functionalty. While this package shares many common features to the lightkurve.search module, it has many major changes, as described below.

Usage

from lksearch import MASTSearch, TESSSearch, KeplerSearch, K2Search
### Get long-cadence target pixel files for Kepler
res = search.KeplerSearch("KIC 11904151", exptime="long").cubedata
### Get TESScut cutouts for a particular target and sector
res = TESSSearch("TOI 2257").tesscut
res.download()

Contributing

lksearch 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 lksearch 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

lksearch 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:

  • The class structure has been modified. The base class is MASTSearch. Users are intended to use mission-specific classes (KeplerSearch/K2Search/TESSSearch) to obtain mission-specific results.

  • Result tables are saved as pandas dataframs

  • The TESScut search functionality now uses tesswcs to identify observed sectors

  • Data products are now generalized (timeseries contains lightcurve products, cubedata contains target pixel files and TESSCut, and dvreports contains pdfs contining data validation reports)

  • ‘download’ now defaults to the AWS cloud storage.

  • ‘download’ only downloads files to disk. It no longer returns a lightkurve object.

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

lksearch-1.0.0.tar.gz (26.7 kB view details)

Uploaded Source

Built Distribution

lksearch-1.0.0-py3-none-any.whl (31.5 kB view details)

Uploaded Python 3

File details

Details for the file lksearch-1.0.0.tar.gz.

File metadata

  • Download URL: lksearch-1.0.0.tar.gz
  • Upload date:
  • Size: 26.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 lksearch-1.0.0.tar.gz
Algorithm Hash digest
SHA256 a683299c6c108b9a31f287160e98e22b2055534e6183828b49b6d5d2fe223b5f
MD5 19c5a801f092d4fb1c1e6d7b827d510d
BLAKE2b-256 96905ef6e5fee0e640de83de05c88e8433c0940b17a17454d568a2017bce4e74

See more details on using hashes here.

File details

Details for the file lksearch-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: lksearch-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 31.5 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 lksearch-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 951454bb21d19c269af68653964c2bfbb4fe01515519edf0c8aa6ed528c6aece
MD5 e9b2f4f3a96b15abe594cc8687837ff1
BLAKE2b-256 a9e17ccf89aa373ad9babf03273b93496116cd014f9608e7245dd2e7e0233277

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