tessgi / ticgen

Software to estimate the noise level on TESS data and to calculate a TESS magnitude
MIT License
4 stars 1 forks source link

ticgen

A tool for calculating a TESS magnitude, and an expected noise level for stars to be observed by TESS.

Build Status PyPI DOI

Installation

You can install using pip

$ pip install ticgen --upgrade

or via the github repository

$ git clone https://github.com/tessgi/ticgen.git
$ cd tvguide
$ python setup.py install

The code has been tested in Python 2.7, 3.5, and 3.6.

Usage

Provide some magnitudes and we'll calculate a TESS magnitude and a noise level

$ ticgen -V 7.5 -J 12.0 -Ks 11.5

TESS mag = 10.09, calculated using V/J/Ks.
1-sigma scatter in 60 min = 212 ppm.

You can provide any combination of these mangitudes

You can also specify the integration time in minutes. This will be used to calculate the noise. This assumes noise scales with the inverse square-root of the integration time. (default: 60)

ticgen --Tmag 18.0 --integration 1440

TESS mag = 18.00, calculated using Tmag was provided.
1-sigma scatter in 1440 min = 51045 ppm.

You can also run on a csvfile with magnitudes. The header of the file must contain one or more of Tmag, Vmag, Jmag, Bmag, Bphmag, Ksmag, Hmag, and Gmag. Not all the magnitues need to be included in the file and the columns can be in any order.

A new csv file will be created with two columns: TESS mag and 1-sigma noise level in parts-per-million.

Here is an example of an acceptable file

Tmag,Vmag,Jmag,Bmag,Bphmag,Ksmag,Hmag,Gmag
12.0,,,,,,,
,11.5,8.1,,,6.7,,
,,,,,,16.0,
,,12.0,12.0,,8.6,,

and the calling pattern would be

ticgen-csv  mycsvfile.csv

and this would output

# Tmag, 1-sigma noise (ppm)
    12.000,    595.007
     9.850,    188.867
    16.700,  32331.695
    12.872,   1030.614

Further Documentation

This code is build using the algorithms from the TESS Input Catalog publication from Stassun et al. (2017).

Citation

If you find this code useful and want to cite it in your research then we have made that possible for you

Jaffe, T. J. & Barclay, T. 2017, ticgen: A tool for calculating a TESS magnitude, and an expected noise level for stars to be observed by TESS., v1.0.0, Zenodo, doi:10.5281/zenodo.888217

Please also cite Stassun et al. (2017) who developed the algorithms underlying this code.