Source code for model.calibration_model

"""Definition and modeling of a calibration device."""

import logging

from simtools.model.model_parameter import ModelParameter




class CalibrationModel(ModelParameter):
    """
    CalibrationModel represents the MC model of an individual calibration device.

    It provides functionality to read the required parameters from the
    simulation-model repository.

    Parameters
    ----------
    site: str
        Site name (e.g., South or North).
    calibration_device_model_name: str
        Calibration device model name (ex. ILLS-01, ILLN-01, ...).
    model_version: str
        Model version.
    label: str, optional
        Instance label. Important for output file naming.
    overwrite_model_parameter_dict: dict, optional
        Dictionary to overwrite model parameters with provided values.
    model_directory: pathlib.Path or str, optional
        Directory for generated model assets and sim_telarray configuration files.
    """

    def __init__(
        self,
        site,
        calibration_device_model_name,
        model_version,
        label=None,
        overwrite_model_parameter_dict=None,
        model_reader=None,
        model_directory=None,
        context=None,
    ):
        """Initialize CalibrationModel."""
        super().__init__(
            site=site,
            array_element_name=calibration_device_model_name,
            collection="calibration_devices",
            model_version=model_version,
            label=label,
            overwrite_model_parameter_dict=overwrite_model_parameter_dict,
            model_reader=model_reader,
            model_directory=model_directory,
            context=context,
        )

        self._logger = logging.getLogger(__name__)