Merge pull request #2942 from cta-observatory/subarray_service_data

Implement service data loading

Author: maxnoe

docs/changes/2942.feature.rst

@@ -0,0 +1,5 @@
+Add service data loading to SubarrayDescription.
+
+* Add ``SubarrayDescription.from_service_data()`` classmethod to construct
+  subarrays from service data files (array element IDs, positions, and subarray
+  definitions). This also adds mapping between the array elements IDs and CTAO official telescope names (e.g. LSTN-001).

src/ctapipe/exceptions.py

@@ -17,3 +17,15 @@ def __init__(self, module):
 
 class InputMissing(ValueError):
     """Raised in case an input was not specified."""
+
+
+class UnknownSubarray(CTAPipeException):
+    """Raised if a subarray id is not found in the service data."""
+
+
+class UnknownTelescopeID(KeyError):
+    """Raised when an unknown telescope id is encountered"""
+
+
+class IncompatibleDataModelVersion(CTAPipeException):
+    """Raised when data model version is not compatible"""

src/ctapipe/instrument/__init__.py

@@ -15,7 +15,7 @@
     ReflectorShape,
     SizeType,
 )
-from .subarray import SubarrayDescription, UnknownTelescopeID
+from .subarray import SubarrayDescription, UnknownSubarray, UnknownTelescopeID
 from .telescope import TelescopeDescription
 from .trigger import SoftwareTrigger
 from .warnings import FromNameWarning
@@ -32,6 +32,7 @@
     "SubarrayDescription",
     "TelescopeDescription",
     "UnknownTelescopeID",
+    "UnknownSubarray",
     "FocalLengthKind",
     "ReflectorShape",
     "SizeType",