2. Setting up the Calibration Service

DRAGONS comes with a local calibration manager that uses the same calibration association rules as the Gemini Observatory Archive. This allows the command line “reduce” and the API Reduce instance to make requests to a local light-weight database for matching processed calibrations when needed to reduce a dataset.

Below we show how to configure the database and then how to initialize and use it from the command line and from the API.

If you need more details, check the “caldb” documentation in the Recipe System User Manual.

2.1. The Configuration File

The database is configure in the DRAGONS configuration file under the [calibs] section.

In ~/.dragons/, create or edit the configuration file dragonsrc as follow:

[calibs]
databases = ${path_to_my_data}/gsaoiimg_tutorial/playground/cal_manager.db get store

The [calibs] section tells the system where to put the calibration database and how to name it. Here we use cal_manager.db to match what was used in the pre-v3.1 version of DRAGONS, but you can now set the name of the database to what suits your needs and preferences.

That database will keep track of the processed calibrations that we are going to send to it. With the “get” and “store” options, the database will be used by DRAGONS to automatically get matching calibrations and to automatically store master calibrations that you produce. If you remove the “store” option you will have to caldb add (command line) or caldb.add_cal() (API) your calibration product yourself (like what needed to be done in DRAGONS v3.0).

Note

The tilde (~) in the path above refers to your home directory. Also, mind the dot in .dragons.

2.2. Usage from the Command Line

To initialize (create) the database run:

caldb init

That’s it. It is ready to use. You can check the configuration and confirm the settings with caldb config. On the command line, if the database already exists it will refuse to act and will let you know. If you do want to delete the existing database and start fresh, use the “wipe” option: caldb init -w.

You can manually add processed calibrations with caldb add <filename>, list the database content with caldb list, and caldb remove <filename> to remove a file from the database (it will not remove the file on disk.)

2.3. Usage from the API

From the API, the calibration database is initialized as follows:

from recipe_system import cal_service

caldb = cal_service.set_local_database()
caldb.init()

The calibration service is now ready to use.

You can manually add processed calibrations with caldb.add_cal(<filename>), list the database content with caldb.list_files(), and caldb.remove_cal(<filename>) to remove a file from the database (it will not remove the file on disk.)