# Reproduction Package for the paper "TUVO-21acq: A new cataclysmic variable discovered through a UV outburst" #

* This is a basic reproduction package (RP) for the paper "TUVO-21acq: A new cataclysmic variable discovered through a UV outburst".
* Authors: David Modiano, Rudy Wijnands, David A.H Buckley, Mariusz Gromadzki, Sill Verberne, Marieke van Etten
* Accepted for publication in Astronomy and Astrophysics (date of acceptance: 19/06/2022)
* Paper DOI: 10.1051/0004-6361/202243870
* Arxiv  DOI: 10.48550/arXiv.2206.10395
* Zenodo DOI: 10.5281/zenodo.6483027

### Raw data ###
* ALL UVOT and XRT data are public and archived online, available at the NASA/GCFC Archive: https://swift.gsfc.nasa.gov/archive/
* UVOT images used to create the figures are provided (see Figures and tables section and Intermediate data products section)
* Reduced SALT spectrum is provided in the directory 'raw_data/salt/'.

### Software ###
* OS used for all analysis: Mac OS X Mojave 10.14.6
* Programming languages used: Python 3.8.8, including NumPy v1.19.2, Matplotlib v3.4.2, AstroPy 4.2, Specutils
* HEAsoft version 6.28 (https://heasarc.gsfc.nasa.gov/docs/software.html)
* CALDB version 20201215 (https://heasarc.gsfc.nasa.gov/docs/heasarc/caldb/install.html)
* Hotpants (https://github.com/acbecker/hotpants)
* Astrometry.net (http://nova.astrometry.net/)
* Scikit-image register\_translation https://scikit-image.org/docs/dev/api/skimage.feature.html
* Pwkit.pdm (https://pwkit.readthedocs.io/en/latest/science/pwkit-pdm/)
* SAOImageDS9 (http://ds9.si.edu/site/Home.html)
* SExtractor (https://sextractor.readthedocs.io/en/latest/index.html)
* XSPEC (https://heasarc.gsfc.nasa.gov/xanadu/xspec/)
* PySALT (https://pysalt.salt.ac.za/)
* Transient UV Objects pipeline (TUVOpipe). Proprietary; contact ORCID ID: 0000-0002-3516-2152, email address: r.a.d.wijnands@uva.nl

### Figures and tables ###
* All figures can be reproduced using the scripts within this RP, in the directory 'figures', and the relevant (intermediate) data products provided (see Intermediate data products section). Each figure is created with one script.
* Fig. 5 does not have an associated python script, as it was created within the iplot tool of XSPEC. The data, intermediate products, and methods for the analysis and creation of the figure are provided.

### Intermediate data products ###
* The images used to create Fig. 1 are publicly archived (UVOT) data, and are also available within this RP, in the directory 'raw\_data/uvot'.
* The image used to create Fig. 2 is publicly archived (UVOT) data, and is also available within this RP, in the directory 'raw\_data/uvot'.
* The final light curves used to create Fig. 3 were created using publicly archived (UVOT) data and public software as described within the paper. They are provided in this RP, in the directory 'intermediate\_data/lightcurves/'. The scripts used to obtain the photometry are not provided because they are part of the still proprietary TUVO pipeline. The methods used by the scripts are described in the paper.
* The summed UVOT image used to create Fig. 4 was created using publicly archived (UVOT) data and public software, as described within the paper. It is provided in this RP, in the directory 'intermediate\_data/uvot/'.
* All intermediate data products relevant for the XRT analysis are provided in this RP, in the directory 'intermediate\_data/xrt/'. This includes summed images for outburst and quiesence, as well as all data products related to building and extracting the spectrum. Methods are described within the paper.
* The reduced SALT spectrum used to create Fig. 6 is provided in this RP, in the directory 'raw\_data/salt/'. The values obtained from the analysis of the spectrum (methods described in the paper), which are given in Table 2, are calculated within the script that produces the spectrum figure (within the '/figures/' directory).

### End-to-end analysis scripts ###
* The TUVO pipeline is not included in this RP. Therefore the original script used to obtain the data points for Fig. 3 is not provided.
* All analysis and figures can be reproduced using the scripts within this RP, in the directory 'figures/', together with the relevant (intermediate) data products provided, using the methods described in the paper.
