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)!

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

Due to the latest changes in the lightkurve package (v2 and above) you will need to upgrade the following packages to the corresponding versions:

numpy --> > 1.20.1
matplotlib --> > 3.2.1
astropy --> > 4.2
lightkurve --> > 2.0.3

Remember that you can upgrade your packages by just using pip as, e.g.:

pip install numpy --upgrade

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.

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

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

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}.

J. Lillo-Box, A. Aller, A. Castro (TESScut addition), D. Jones (python3 version), P. Bluhm (Giai identification), N. Espinoza (Gaia RA-DEC cross-matching), E. Jensen (fix to the orientation arrows and others).