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 from SPOC (2 minute cadence) pipeline and TESS-SPOC (FFI / HLSP) pipeline.

For SPOC, it also provides a summary of key TCE parameters, e.g. looking up all the TCEs for pi Men / TIC 261136679:

Installation

Install the package into your Python environment:

# include the web application
pip install tess-dv-fast"[webapp,build_db]"

# Or just the core package:
# * build_db is needed to create the database.
pip install tess-dv-fast"[build_db]"

For development: clone the git repository and install the package in editable mode:

# at project root
pip install -e ."[webapp,build_db,dev]"

Download the required data and build the local database:

python -m tess_dv_fast.tess_dv_fast_build --update --minimal_db
python -m tess_dv_fast.tess_spoc_dv_fast_build --update

Start the webapp:

flask --app tess_dv_fast.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 <port_number> to the flask command.

• The package downloads the data from MAST and creates local SQLite databases under ./data/tess_dv_fast/ by default. To use a different base directory, set TESS_DB_BASE_PATH before running the build commands, for example:

  export TESS_DB_BASE_PATH=/path/to/base
  

  The resulting database files will then be located at $TESS_DB_BASE_PATH/data/tess_dv_fast/tess_tcestats.db (SPOC) and $TESS_DB_BASE_PATH/data/tess_dv_fast/tess_spoc_tcestats.db (TESS-SPOC).

• For SPOC, 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 Python 3 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.

Update the database with:

python -m tess_dv_fast.tess_dv_fast_build --update --minimal_db
python -m tess_dv_fast.tess_spoc_dv_fast_build --update

It will download all relevant URLs listed on MAST.

• SPOC
• TESS-SPOC

Deploying the app to cloud environments

• Instructions for Google Cloud Run deployment.