Skip to content

Latest commit

 

History

History
125 lines (101 loc) · 9.43 KB

README.md

File metadata and controls

125 lines (101 loc) · 9.43 KB
Raw

Automated SpectroPhotometric Image REDuction (ASPIRED) -- A Python-based spectral data reduction toolkit

Python package Coverage Status Readthedocs Status arXiv PyPI version DOI AJ Downloads Code style: black

We aim to provide a suite of publicly available spectral data reduction software to facilitate rapid scientific outcomes from time-domain observations. For time resolved observations, an automated pipeline frees astronomers from performance of the routine data analysis tasks to concentrate on interpretation, planning future observations and communication with international collaborators. Part of the OPTICON project coordinates the operation of a network of largely self-funded European robotic and conventional telescopes, coordinating common science goals and providing the tools to deliver science-ready photometric and spectroscopic data. As part of this activity is SPRAT, a compact, reliable, low-cost and high-throughput spectrograph and appropriate for deployment on a wide range of 1-4m class telescopes. Installed on the Liverpool Telescope since 2014, the deployable slit and grating mechanism and optical fibre based calibration system make the instrument self-contained.

ASPIRED is written for use with python 3.7, 3.8, 3.9, 3.10 and 3.11, and is intentionally developed as a self-consistent reduction pipeline with its own diagnostics and error handling. The pipeline should be able to reduce 2D spectral data from raw image to wavelength and flux calibrated 1D spectrum automatically without any user input (quicklook quality). However, the real goal is to provide a set of easily configurable routines to build pipelines for long slit spectrographs on different telescopes (science quality). We use SPRAT as a test case for this development, but our aim is to support a much wider range of instruments. By delivering near real-time data reduction we will facilitate automated or interactive decision making, allowing "on-the-fly" modification of observing strategies and rapid triggering of other facilities.

The most up-to-date description can be referred to this AJ article. Please use the DOI 10.5281/zenodo.4127294 for general referencing to the software. If you would like to reference a specific version, please look up the corresponding DOI on Zenodo. The bibtex below is referencing the latest release.

@ARTICLE{2023AJ....166...13L,
       author = {{Lam}, Marco C. and {Smith}, Robert J. and {Arcavi}, Iair and {Steele}, Iain A. and {Veitch-Michaelis}, Josh and {Wyrzykowski}, Lukasz},
        title = "{Automated SpectroPhotometric Image REDuction (ASPIRED)}",
      journal = {\aj},
     keywords = {Astronomy data reduction, Spectroscopy, Open source software, Publicly available software, Astronomy software, Observational astronomy, Astronomical techniques, Astronomical methods, 1861, 1558, 1866, 1864, 1855, 1145, 1684, 1043, Astrophysics - Instrumentation and Methods for Astrophysics},
         year = 2023,
        month = jul,
       volume = {166},
       number = {1},
          eid = {13},
        pages = {13},
          doi = {10.3847/1538-3881/acd75c},
archivePrefix = {arXiv},
       eprint = {2111.02127},
 primaryClass = {astro-ph.IM},
       adsurl = {https://ui.adsabs.harvard.edu/abs/2023AJ....166...13L},
      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
}

@software{lam_2023_8179037,
  author       = {Lam, Marco C and Smith, Robert J},
  title        = {{ASPIRED: A Python-based spectral data reduction toolkit}},
  month        = jul,
  year         = 2023,
  publisher    = {Zenodo},
  version      = {0.5.1},
  doi          = {10.5281/zenodo.8179037},
  url          = {https://doi.org/10.5281/zenodo.8179037}
}

Early stage development efforts can be referred to this ASPC article and this arXiv article. This is in concurrent development with the automated wavelength calibration software RASCAL, further information can be referred to this ASPC article and it will appear in the same volume of ASPCS.

Example notebooks and scripts can be found at aspired-example. More examples can be found at the github repository of the journal article here, e.g.:

alt text

Use cases

We are to cover as many use cases as possible. If you would like to apply some reduction techniques that we have overseen, please use the issue tracker to request new features. The following is the list of scenarios that we can handle:

Spectrum - full reduction

  1. Dataset with science and standard field-flattened images and the respective arc image.

Spectrum - ADU spectrum extraction only (No flux calibration)

  1. Dataset with science field-flattened image and the arc image only.

Spectrum - wavelength calibration only (Pre wavelength-calibrated)

  1. Dataset with science and standard field-flattened images only.

Spectrum - other cases for full or partial reduction

  1. User supplied trace(s) for light spectrum extraction (only to extract ADU/s of the spectra).
  2. User supplied trace(s) for arc extraction (only to get wavelength calibration polynomial).
  3. User supplied wavelength calibration polynomial coefficients.
  4. User supplied line list.
  5. User supplied pixel-to-wavelength mapping (not fitted).
  6. User supplied sensitivity curve.
  7. Flux calibration for user supplied wavelength calibrated science and standard 1D spectra.
  8. Apply atmospheric extinction correction.
  9. Apply basic telluric absorption correction.

Output

  1. Save diagnostic plots in these formats.
  2. Save data in FITS (with header information) or ascii (csv).

See the examples of these use cases at aspired-example.

Dependencies

Installation

Instructions can be found here.

Reporting issues/feature requests

Please use the issue tracker to report any issues or support questions.

Getting started

The quickstart guide will show you how to reduce the example dataset.

Contributing Code/Documentation

If you are interested in contributing code to the project, thank you! For those unfamiliar with the process of contributing to an open-source project, you may want to read through Github’s own short informational section on how to submit a contribution or send me a message.

Style -- black. See the .pre-commit-config.yaml for the other requirements.

Funding bodies

  1. European Union’s Horizon 2020 research and innovation programme (grant agreement No. 730890) (January 2019 - March 2020)
  2. Polish NCN grant Daina No. 2017/27/L/ST9/03221 (May - June 2020)
  3. European Research Council Starting Grant (grant agreement No. 852097) (Sept 2020 - Current)

Citation

If you make use of the ASPIRED toolkit, we would appreciate if you can refernce the two articles and two pieces of software listed below:

  1. ASPIRED AJ article
  2. ASPIRED Zenodo
  3. RASCAL arXiv article
  4. RASCAL Zenodo