README.md

VLT/SPHERE

Information

This repository provides tools for the reduction of VLT/SPHERE data. The pipeline currently provides support for processing IRDIS dual-band imaging (DBI), IRDIS classical imaging (CI), IRDIS long-slit spectroscopy (LSS) and IFS data. IRDIS dual-polarimetry imaging (DPI) and ZIMPOL are not supported at the moment.

If you find a bug or want to suggest improvements, please create a ticket.

Requirements

The pipeline requires official ESO pipeline for SPHERE to be installed and in your path. If the esorex command is not available the pipeline will output an error.

The package also relies on usual packages for data science and astronomy: numpy, scipy, pandas, matplotlib and astropy.

Installation

The easiest is to install sphere using pip:

pip install vlt-sphere

Otherwise your can download the current repository and install the package manually:

cd SPHERE-master/
python setup.py install

Examples

The package is not fully documented, but examples are provided.

Credits

Please cite the following reference if you use this pipeline in a scientific publication:

• Vigan, 2020, ASCL, ascl:2009.002

Or simply use the following Bibtex entry:

@MISC{2020ascl.soft09002V,
       author = {{Vigan}, Arthur},
        title = "{vlt-sphere: Automatic VLT/SPHERE data reduction and analysis}",
     keywords = {Software},
         year = 2020,
        month = sep,
          doi = {10.5281/zenodo.6563998},
          eid = {ascl:2009.002},
        pages = {ascl:2009.002},
archivePrefix = {ascl},
       eprint = {2009.002},
       adsurl = {https://ui.adsabs.harvard.edu/abs/2020ascl.soft09002V},
      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
}

Moreover, the development of the SPHERE instrument has demanded a tremendous effort from many scientists, who have devoted several years of their life to design, build, test and commission the instrument. To recognize this work, we kindly ask you to cite the relevant instrumental papers in your scientific work. The reference papers for the instrument and its observing mode are:

SPHERE:

• General description: Beuzit et al., 2019, A&A, 631, A155

IRDIS:

• General description: Dohlen et al., 2008, SPIE, 7014
• Long-slit spectroscopy mode: Vigan et al., 2008, A&A, 489, 1345
• Dual-Band Imaging mode: Vigan et al., 2010, MNRAS, 407, 71
• Dual-Polarization Imaging mode: de Boer et al., 2020, A&A, 633, A63 & van Holstein et al., 2020, A&A, 633, A64

IFS:

• General description: Claudi et al., 2008, SPIE, 7014
• Performance: Mesa et al., 2015, A&A, 576, 121

We are grateful for your effort, and hope that these tools will contribute to your scientific work and discoveries. Please feel free to report any bug or possible improvement to the author(s).

Author and contributors

Arthur Vigan <[email protected]>, Laboratoire d'Astrophysique de Marseille / CNRS

With important contributions from:

• Julien Milli (IPAG/UGA): Support of SPARTA files
• Jean-Françoise Sauvage (ONERA): Support of SPARTA files
• Dino Mesa (INAF/OAPD): IFS pre-processing
• ESO personnel in general: SPHERE pipeline and calibration procedures

And small improvements, or bug reports with suggested fix from:

• Wolfgang Brandner (@Rumpelstil)
• Tomas Stolker (@tomasstolker)
• Karthikeyan Singaravelan (@tirkarthi)
• Chen Xie (@ChenXie-astro)