Muon Processing Pipeline Refactoring for Optical Throughput and PSF calibration

Summary

Current Implementation

Previously, we utilized a separate calibrator class for optical throughput calibration using muons.

Proposed Changes

With respect to the last changes in the MR122:

Introduce new calibration tools.

And a MuonDataHandler class responsible for:

• Processing DL0 data.
• Extracting muon parameters using the ctapipe infrastructure.
• Generating astropy tables containing:
  • Parameters from ctapipe.containers.MuonEfficiencyContainer, MuonRingContainer, and MuonParametersContainer.
  • Observation and telescope-specific information.
• Applying quality cuts as defined in a configuration file (specific for throughput or psf calibration for specific telescope type).

These tables will be utilized by calibration tools to compute necessary coefficients, such as PSF or Optical Throughput.

Benefits

• Centralization: Combines all common muon processing steps into a single class (it will not introduce new processing methods, just calling ctapipe methods in an organised way in one place).
• Configurability: Allows flexible configuration of quality gates within MuonDataHandler based on the calibration type.

Workflow Summary

1. A calibration tool (e.g., throughput_tool, psf_tool) invokes the MuonDataHandler with:
   • An input eventsource file.
   • A specific config (e.g., throughput_config, psf_config).
2. MuonDataHandler processes the input events using ctapipe methods and generates tables with extracted muon parameters, returning them to the tool.
3. The tool calculates the corresponding calibration coefficients and uploads them to the database.