KOALA

---

PyKOALA: A multi-instrument tool for reducing Integral Field Spectroscopic Data

---

PyKOALA is a Python package to reduce KOALA+AAOmega integral field spectroscopy (IFS) data creating a data cube. It produces full calibrated (wavelength, flux and astrometry) data cubes ready for science.

KOALA, the Kilofibre Optical AAT Lenslet Array, is a wide-field, high efficiency, integral field unit used by the AAOmega spectrograph on the 3.9m AAT (Anglo-Australian Telescope) at Siding Spring Observatory. PyKOALA is the forthcoming data reduction pipeline for creating science-ready 3D data cubes using Raw Stacked Spectra (RSS) images created with 2dfdr.

---

Pre-requisites

PyKOALA has the following pre-requisites

- numpy
- scipy
- astropy
- photutils
- skimage (for image registration using cross-correlation)
...

Installation

...

Package structure

---

Data containers

Represent the different types of data used by PyKOALA.

• RSS
• Cube

Data Wrappers: Instrument-specific classes based on Data Containers for reading the data

• koala_rss

---

Cubing

cubing.interpolate_fibre

cubing.interpolate_rss

cubing.build_cube

Registration

registration.register_stars

---

Corrections

All the corrections applied to the data are build upon the Correction base class.

Fibre Throughput

Atmospheric corrections

• AtmosphericExtinction
• Atmospheric Differential Refraction (ADR)

Sky

• Sky substraction (SkySubsCorrection)
  • Sky continuum
  • Sky emission lines
• Telluric correction (TelluricCorrection)

Flux calibration (Spectral throughput)

Cleaning

• Cosmics
• NaN's
• CCD edges

Ancillary

---

Basic reduction procedure

---

(See examples)

Reducing calibration star data

• Read RSS data.
• Apply fibre throughput.
• Correct data for atmospheric extinction.
• Correct data from telluric atmospheric absorption.
• Substract sky (continuum + emission lines).
• Build cube

---

License and Acknowledgements

...

Helping to develop PyKOALA

---

1. Fork koala into your github account
2. Clone your fork onto your laptop:

    git clone https://github.com/<your_account>/koala

3. Add this repository as another remote (to get the latest stuff):

    git remote add  upstream https://github.com/pykoala/koala

4. Create a branch to work on the changes:

    git checkout -b <new_branch>

5. Add and commit changes
6. Push up your changes
7. Create a PR, and wait for someone to review it

Reviewing commits

1. Look through the changes, and provide comments
2. Once the PR is ready, type bors r+, then bors will handle the merge (DON'T HIT THE MERGE BUTTON).
3. If the tests fail, help the proposer fix the failures
4. Use bors r+ again

You can also use bors try to try running the tests, without merging