tpfplotter

Create paper-ready figures (1-column) overplotting the Gaia DR2 catalog to the TESS Target Pixel Files (TPF). You can create plots for any target observed by TESS! Even if you do not have a TIC number, you can search by coordinates now (see examples below)!

Installation & Requirenments

Clone this folder or download it to your computer. That's it!

tpfplotter is written in both Python3.6 (tpfplotter_python3.py) Python2.7 (tpfplotter.py). But please note that since October 2020 only the Python3 version is kept up-to-date.

Usage

Using tpfplotter is really easy.

If you know the TIC number ():

python tpfplotter.py 150428135 --maglim 6

Note: if the TIC is in the CTL, the mask will correspond to the pipeline mask. Otherwise, it will just show a mask obtained with tpf.create_threshold_mask(threshold=10,reference_pixel='center'):

If there is no TIC number, you can search by coordinates:

python tpfplotter.py TestTarget1 --COORD 166.0189667,49.15338516 --maglim 6

Also, if you have a list of TIC values just type:

python tpfplotter.py list_of_tics.lis --LIST --maglim 6

In case tpfplotter is not able to find the target in the Gaia catalog, you can overcome this by providing the Gaia ID and Gmag as input in the following way:

python tpfplotter.py 150428135 --maglim 6 --gid UCAC4 123-010026 --gmag 12.07

You can also save the list of Gaia sources in the TPF in a separate ascii file called Gaia_TIC*.dat with the --SAVEGAIA option. This file contains the ID, XY location on the TPF, distance to the target, Gmag and a column flag indicating if the source is inside the aperture mask (=1) or not (=0):

python tpfplotter.py 150428135 --maglim 6 --SAVEGAIA --sector 4

Papers using tpfplotter

Several papers involving different science cases have already used TPF plotter. A sample of them are highlighted here:

Aller, A., Lillo-Box, J., Jones, D., et al., 2019, arXiv e-prints, arXiv:1911.09991 ADS link
Lillo-Box, et al., (2020), arXiv e-prints, arXiv:2010.06928. ADS link
Demory, et al., (2020), A&A, 642, A49. ADS link
Luque, et al., (2020), arXiv e-prints, arXiv:2009.08338. ADS link
Bluhm, et al., (2020), A&A, 639, A132. ADS link
Nowak, et al., (2020), arXiv e-prints, arXiv:2003.01140. ADS link

Credits

If you use tpfplotter, please give credit to the following paper:

Aller, A., Lillo-Box, J., Jones, D., et al. (2020, A&A, 635, 128) "Planetary nebulae seen with TESS: Discovery of new binary central star candidates from Cycle 1," ADS link

and add the following sentence somewhere in the paper (either footnote or acknowledgements section):

This work made use of \texttt{tpfplotter} by J. Lillo-Box (publicly available in www.github.com/jlillo/tpfplotter), which also made use of the python packages \texttt{astropy}, \texttt{lightkurve}, \texttt{matplotlib} and \texttt{numpy}.

Contributors