Welcome to Filabres’s documentation!

Filabres started in 2019 as a joint effort of the Calar Alto Observatory (especially Santos Pedraz and Jesús Aceituno), the Spanish Virtual Observatory (Enrique Solano, José Manuel Alacid and Miriam Cortés), and the Physics of the Earth and Astrophysics Department at the Universidad Complutense de Madrid (Nicolás Cardiel, Sergio Pascual, Enrique Galcerán and Jaime Alonso), and the collaboration of the Instituto de Física de Cantabria (Maite Ceballos), with the main goal of providing useful reduced images through the Calar Alto Archive hosted at http://caha.sdc.cab.inta-csic.es/calto/.

Although this software package was initially created with the idea of performing the automatic reduction of direct images obtained with the instrument CAFOS, placed at the 2.2 m telescope of the Calar Alto Observatory, filabres has been designed to allow the future inclusion of additional observing modes and instruments.

The typical workflow with filabres consists of the following steps:

1. Image classification (bias, flat-imaging, arc, science-imaging, etc.)

2. Reduction of calibration images (bias, flat-imaging) and generation of combined master calibrations as a function of the modified Julian Date.

3. Basic reduction of individual science images, making use of the corresponding master calibrations (closest in time to the observation of the science target). The main reduction steps considered here are:

   • bias subtraction

   • flatfielding of the images

   • astrometric calibration (performed with the help of additional software tools provided by Astrometry.net and by AstrOmatic.net)

An example of use of filabres with CAFOS data from 2017 is illustrated in this documentation.

---

Document index:

• Filabres installation
  • Conda installation
  • Installing the development version of filabres
  • Required additional software packages
• Initial setup
  • Generate configuration files
  • File setup_filabres.yaml
  • File ignored_images.yaml
  • File image_header_corrections.yaml
  • File forced_classifications.yaml
• Initial image check
  • Updating ignored_images.yaml
  • Re-check the image tree
• Image classification
  • Rules for the classification of the images
  • Inital image classification
  • Examine the image classification
  • Is there something wrong with the image classification?
• Reduction of bias images
  • Database of master bias frames
  • Checking the bias reduction
  • Removing invalid reduced bias
• Reduction of flat-imaging
  • Database of master flat-imaging frames
  • Checking the flat-imaging reduction
  • Removing invalid reduced flat-imaging
• Reduction of science-imaging frames
  • Reduction of a single science-imaging frame
  • Reducing multiple science-imaging files
  • Checking the science-imaging reduction
  • Removing invalid reduced science-imaging frames
  • Skipping the astrometric calibration
• Another example with LSSS data
  • Solving some problems with the astrometric calibration

---

Software repository: https://github.com/nicocardiel/filabres

Developers and maintainers: Nicolás Cardiel (cardiel@ucm.es) and Sergio Pascual (sergiopr@fis.ucm.es)