Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/orionlee/tess_dv_fast
TESS TCE Data Validation (DV) Reports Fast Lookup
https://github.com/orionlee/tess_dv_fast
astronomy exoplanet nasa tess
Last synced: 22 days ago
JSON representation
TESS TCE Data Validation (DV) Reports Fast Lookup
- Host: GitHub
- URL: https://github.com/orionlee/tess_dv_fast
- Owner: orionlee
- License: mit
- Created: 2024-03-26T19:41:37.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2024-12-12T04:41:14.000Z (28 days ago)
- Last Synced: 2024-12-12T05:25:36.785Z (28 days ago)
- Topics: astronomy, exoplanet, nasa, tess
- Language: Python
- Homepage:
- Size: 115 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# TESS TCE Data Validation (DV) Reports Fast Lookup
A Python package / webapp that provides a fast lookup of TESS threshold crossing event (TCE) data validation reports.
It also provides a summary of key TCE parameters, e.g. looking up all the TCEs for [pi Men / TIC 261136679](https://exofop.ipac.caltech.edu/tess/target.php?id=261136679):
![sample lookup result screenshot](assets/screenshot_tce_results.png)
## Installation
In your Python virtual environment, install the dependency
Using `pip`:
```shell
pip install -r requirements.txt
```Using `conda`:
```shell
conda install --file requirements.txt
```Download the required data and build the local database.
```shell
python tess_dv_fast.py --update --minimal_db
```Start the webapp:
```shell
flask --app tess_dv_fast_webapp run
```You are done! The app will be available at http://localhost:5000/tces .
Notes:
- To change the port of the webapp, add `-p ` to `flask` line.
- The packages downloads the data from MAST and creates a local sqlite database at `data/tess_dv_fast/tess_tcestats.db` . There is also a csv version in the same directory.
- The sqlite database contains a minimal set of data needed to support the webapp. Optionally, you could create a database with all the TCE parameters provided by MAST by omitting `--minimal-db`.
- It is tested on Python 3.10, but should be compatible with any recent Python3 versions.## Adding new data
The package relies on TCE bulk download data provided by MAST. When new data is available, the local database needs to be updated.
1. In `tess_dv_fast.py`,
- update `sources_tcestats_single_sector` and `sources_tcestats_multi_sector` to include the URLs of the new TCE `csv` files at: https://archive.stsci.edu/tess/bulk_downloads/bulk_downloads_tce.html .
- update `sources_dv_sh_single_sector` and `sources_dv_sh_multi_sector` to include the URLs of the new TCE download `sh` files at: https://archive.stsci.edu/tess/bulk_downloads/bulk_downloads_ffi-tp-lc-dv.html .2. Update the database:
```shell
python tess_dv_fast.py --update --minimal_db
```## Deploying the app to cloud environments
- Instructions for [Google Cloud Run deployment](tess_dv_fast_webapp_gcloud/README.md).