New calcat interface

The MR is based on the work done on this MR in EXtra-data: https://github.com/European-XFEL/EXtra-data/pull/262

New CALCAT interface to replace calibrationDBRemote, iCalibrationDB, and cal_tools.get_from_db for retrieving constants from CALCAT.

Related to https://git.xfel.eu/calibration/planning/-/issues/150

Description

How Has This Been Tested?

• Has been tested along with all the correction notebooks and detectors available. Reference runs

Relevant Documents (optional)

Types of changes

• New feature (non-breaking change which adds functionality)

Checklist:

• Update snapshot parameter after calibration client is updated.
• I updated the documentation accordingly.
• I added tests where appropriate.

Reviewers

@kluyvert @schmidtp

tests/test_calcat_interface.py

+"""
+TEST CALCAT INTERFACE:
+
+1- AGIPD_CalibrationData/ CalibrationData / metadata()
+2- physical_detector_units().
+"""
+
+import pytest
+
+from cal_tools.calcat_interface import AGIPD_CalibrationData, DSSC_CalibrationData
+
+
+@pytest.mark.requires_gpfs
+@pytest.mark.parametrize(
+    "mod,mod_naming",
+    [
+        ("AGIPD00", "da"),
+        ("Q1M1", "qm"),
+        (0, "modno"),
+
+    ]
+)
+def test_AGIPD_CalibrationData(mod, mod_naming):
+    """Test CalibrationData through AGIPD_CalibrationData
+    and test metadata method.
+
+    Args:
+        mod (str): Module name
+        mod_naming (str): Selected module naming
+    """
+    agipd_md = AGIPD_CalibrationData(
+        detector_name="SPB_DET_AGIPD1M-1",
+        sensor_bias_voltage=300,
+        memory_cells=352,
+        acquisition_rate=1.1,
+        integration_time=12,
+        source_energy=9.2,
+        gain_mode=0,
+        gain_setting=0,
+        event_at="2020-01-07 13:26:48.00",
+        modules=[mod],
+        client=None,
+        module_naming=mod_naming
+    ).metadata()
+    assert isinstance(agipd_md, dict)
+    assert list(agipd_md.keys())[0] == mod
+
+
+@pytest.mark.parametrize(
+    "mod,mod_naming",
+    [
+        ("DSSC00", "da"),
+        ("Q1M1", "qm"),
+        (0, "modno"),
+
+    ]
+)
+def test_physical_detector_units(mod, mod_naming):
+    """Test physical_detector_units property.
+
+    Args:
+        mod (str): Module name
+        mod_naming (str): Selected module naming
+    """
+    agipd_cal = DSSC_CalibrationData(
+        detector_name="SCS_DET_DSSC1M-1",
+        sensor_bias_voltage=300,
+        memory_cells=400,
+        pulse_id_checksum=None,
+        acquisition_rate=None,
+        target_gain=None,
+        encoded_gain=None,
+        event_at="2020-01-07 13:26:48.00",
+        modules=[mod],
+        client=None,
+        module_naming=mod_naming
+    )
+    pdus = agipd_cal.physical_detector_units
+    assert isinstance(pdus, dict)
+    assert len(pdus) == 16
+    assert list(pdus.keys())[0] == mod