[MUON] Introduce list of DCS aliases names for MCH and MID.

Author: aphecetche

Detectors/MUON/MCH/CMakeLists.txt

@@ -18,3 +18,4 @@ add_subdirectory(Simulation)
 add_subdirectory(Tracking)
 add_subdirectory(Raw)
 add_subdirectory(Workflow)
+add_subdirectory(Conditions)

Detectors/MUON/MCH/Conditions/CMakeLists.txt

@@ -0,0 +1,24 @@
+# Copyright CERN and copyright holders of ALICE O2. This software is distributed
+# under the terms of the GNU General Public License v3 (GPL Version 3), copied
+# verbatim in the file "COPYING".
+#
+# See http://alice-o2.web.cern.ch/license for full licensing information.
+#
+# In applying this license CERN does not waive the privileges and immunities
+# granted to it by virtue of its status as an Intergovernmental Organization or
+# submit itself to any jurisdiction.
+
+o2_add_library(
+  MCHConditions
+  SOURCES src/DCSNamer.cxx
+  PUBLIC_LINK_LIBRARIES fmt::fmt)
+
+if(BUILD_TESTING)
+  o2_add_test(
+    dcs-namer
+    SOURCES test/testDCSNamer.cxx test/HVAliases.cxx test/LVAliases.cxx
+    COMPONENT_NAME mch
+    LABELS "muon;mch;dcs"
+    PUBLIC_LINK_LIBRARIES O2::MCHConditions)
+endif()
+

Detectors/MUON/MCH/Conditions/README.md

@@ -0,0 +1,24 @@
+<!-- doxy
+\page refDetectorsMUONMCHConditions Conditions
+/doxy -->
+
+# MCH Conditions
+
+## From DCS
+
+### HV
+
+The MCH high voltage (HV) system is composed of 188 channels :
+
+- 48 channels for stations 1 and 2 (3 HV channel per quadrant x 16 quadrants)
+- 140 channels for stations 3, 4, 5 (1 HV channel per slat x 140 slats)
+
+### LV
+
+The MCH low voltage (LV) system is composed of 328 channels :
+
+- 216 channels (108 x 2 different voltage values) to power up the front-end
+  electronics (dualsampas)
+- 112 channels to power up the readout crates hosting the solar (readout) cards
+
+

Detectors/MUON/MCH/Conditions/include/MCHConditions/DCSNamer.h

@@ -0,0 +1,64 @@
+// Copyright CERN and copyright holders of ALICE O2. This software is
+// distributed under the terms of the GNU General Public License v3 (GPL
+// Version 3), copied verbatim in the file "COPYING".
+//
+// See http://alice-o2.web.cern.ch/license for full licensing information.
+//
+// In applying this license CERN does not waive the privileges and immunities
+// granted to it by virtue of its status as an Intergovernmental Organization
+// or submit itself to any jurisdiction.
+
+#ifndef O2_MCH_CONDITIONS_DCS_NAMER_H
+#define O2_MCH_CONDITIONS_DCS_NAMER_H
+
+#include <vector>
+#include <string>
+#include <optional>
+#include <cstdint>
+
+namespace o2::mch::dcs
+{
+// The list of MCH DCS measurements that are of interest for reconstruction
+enum class MeasurementType {
+  HV_V,             // HV voltage
+  HV_I,             // HV current
+  LV_V_FEE_ANALOG,  // FEE (dualsampa) analog voltage
+  LV_V_FEE_DIGITAL, // FEE (dualsampa) digital voltage
+  LV_V_SOLAR        // Solar crate voltage
+};
+
+// Side describes on which side (inside or outside) a detection element
+// (slat or quadrant) is.
+// Note that MCH DCS uses the very old left-right convention instead of the
+// agreed-upon inside-outside.
+enum class Side {
+  Left,
+  Right
+};
+
+// ID is used to reference a particular device in MCH DCS,
+// like a detection element or solar crate for instance.
+struct ID {
+  int number;
+  Side side;
+  int chamberId; // 0..9
+};
+
+// detElemId2DCS converts a detection element id into a dcs-id.
+// @returns an ID if deId is a valid the MCH detID, std::nullopt otherwise.
+std::optional<ID> detElemId2DCS(int deId);
+
+// aliases gets a list of MCH DCS aliases for the given measurement type(s).
+// @param types a vector of the measurement types for which the aliases should
+// be returned.
+// @returns a list of MCH DCS alias names.
+std::vector<std::string> aliases(std::vector<MeasurementType> types = {
+                                   MeasurementType::HV_V,
+                                   MeasurementType::HV_I,
+                                   MeasurementType::LV_V_FEE_ANALOG,
+                                   MeasurementType::LV_V_FEE_DIGITAL,
+                                   MeasurementType::LV_V_SOLAR});
+
+} // namespace o2::mch::dcs
+
+#endif