Skip to content

SLSkrzypinski/tpfplotter

 
 

Repository files navigation

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

alt text

Installation & Requirenments

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.

Usage

Using tpfplotter is really easy.

If you know the TIC number ():

python tpfplotter.py 150428135 --maglim 6

alt text

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

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

About

TESS TPF plotter with Gaia catalog

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%