A tool for determining whether stars and galaxies are observable by TESS.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
scripts
tvguide
.gitignore
.travis.yml
LICENSE
README.md
requirements.txt
setup.py

README.md

tvguide

A tool for determining whether stars and galaxies are observable by TESS.

Travis status PyPI DOI

Installation

You can install using pip

$ pip install tvguide --upgrade

or via the github repository

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

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

Usage

Pick your favorite star and have a whirl. I'm a big fan of Alpha Centauri

$ tvguide 219.9009 -60.8356

Success! The target may be observable by TESS during Cycle 1.
We can observe this source for:
    maximum: 2 sectors
    minimum: 0 sectors
    median:  1 sectors
    average: 1.16 sectors

You can also run on a file with targets currently implemented is using RA and Dec.

$ head inputfilename.csv

150., -60.
10., -75.
51., 0.
88., +65

$ tvguide-csv inputfilename.csv

Writing example-file.csv-tvguide.csv.

$ head example-file.csv-tvguide.csv

150.0000000000, -60.0000000000, 0, 2
10.0000000000, -75.0000000000, 1, 3
51.0000000000, 0.0000000000, 0, 1
88.0000000000, 65.0000000000, 0, 0

This new file appends two additional columns. The number in the first column is the minimum number of sectors the target is observable for and the second is the maximum.

You can also run from within a Python script:

import tvguide

tvguide.check_observable(150.00, -60.00)

tvguide.check_many(ra_array, dec_array)

Citation

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

Mukai, K. & Barclay, T. 2017, tvguide: A tool for determining whether stars and galaxies are observable by TESS., v1.0.0, Zenodo, doi:10.5281/zenodo.823357