Add mnemonic machinery to take into account mnemonics versions

This MR is here to solve #21 (closed)

• The mnemonics is a dictionnary, with str as keys and tuple of dict as values (instead of dict).
• A function mnemonics_for_run checks the extra_data DataCollection sources and keys to find which version of the mnemonic is available. The tuple structure ensures the order in which the check is performed, so that the versions can be sorted from most recent to least recent.

An example notebook is attached

Mnemonics_machinery.ipynb

Close #21 (closed) #12 (closed)

src/toolbox_scs/constants.py

@@ -15,27 +15,28 @@ mnemonics = {
     "bunchpattern": ({'source': 'SCS_RR_UTC/TSYS/TIMESERVER',
                       'key': 'readBunchPatternTable.value',
                       'dim': None},),
-    "bunchPatternTable": ({'source': 'SCS_RR_UTC/TSYS/TIMESERVER:outputBunchPattern',
-                           'key': 'data.bunchPatternTable',
-                           'dim': ['pulse_slot']},
-                          {'source': 'SCS_RR_UTC/TSYS/TIMESERVER',
-                           'key': 'bunchPatternTable.value',
-                           'dim': ['pulse_slot']},),
+    "bunchPatternTable": (
+        {'source': 'SCS_RR_UTC/TSYS/TIMESERVER:outputBunchPattern',
+         'key': 'data.bunchPatternTable',
+         'dim': ['pulse_slot']},
+        {'source': 'SCS_RR_UTC/TSYS/TIMESERVER',
+         'key': 'bunchPatternTable.value',
+         'dim': ['pulse_slot']}),
     "npulses_sase3": ({'source': 'SCS_RR_UTC/MDL/BUNCH_DECODER',
                        'key': 'sase3.nPulses.value',
                        'dim': None},),
     "npulses_sase1": ({'source': 'SCS_RR_UTC/MDL/BUNCH_DECODER',
                        'key': 'sase1.nPulses.value',
                        'dim': None},),
-    "bunchPatternTable_SA3": ({
-        'source': 'SA3_BR_UTC/TSYS/TIMESERVER:outputBunchPattern',
-        'key': 'data.bunchPatternTable',
-        'dim': ['pulse_slot']},),
+    "bunchPatternTable_SA3": (
+        {'source': 'SA3_BR_UTC/TSYS/TIMESERVER:outputBunchPattern',
+         'key': 'data.bunchPatternTable',
+         'dim': ['pulse_slot']},),
 
     # Bunch Arrival Monitors
     "BAM414": ({'source': 'SCS_ILH_LAS/DOOCS/BAM_414_B2:output',
-              'key': 'data.lowChargeArrivalTime',
-              'dim': ['BAMbunchId']},),
+                'key': 'data.lowChargeArrivalTime',
+                'dim': ['BAMbunchId']},),
     "BAM1932M": ({'source': 'SCS_ILH_LAS/DOOCS/BAM_1932M_TL:output',
                   'key': 'data.lowChargeArrivalTime',
                   'dim': ['BAMbunchId']},),
@@ -73,6 +74,9 @@ mnemonics = {
              'key': 'actualPosition.value',
              'dim': None},),
     # DPS imagers
+    "DPS1CAM2": ({'source': 'SCS_BLU_DPS-1/CAM/IMAGER2CAMERA:daqOutput',
+                  'key': 'data.image.pixels',
+                  'dim': ['dps1cam2_y', 'dps1cam2_x']},),
     "DPS2CAM2": ({'source': 'SCS_BLU_DPS-2/CAM/IMAGER2CAMERA:daqOutput',
                   'key': 'data.image.pixels',
                   'dim': ['dps2cam2_y', 'dps2cam2_x']},),
@@ -228,6 +232,12 @@ mnemonics = {
     "ILH_8CAM1": ({'source': 'SCS_ILH_LAS/CAM/8CAM1:daqOutput',
                    'key': 'data.image.pixels',
                    'dim': ['8cam1_y', '8cam1_x']},),
+    "ILH_10CAM1": ({'source': 'SCS_ILH_LAS/CAM/10CAM1:daqOutput',
+                    'key': 'data.image.pixels',
+                    'dim': ['10cam1_y', '10cam1_x']},),
+    "ILH_PIDelay": ({'source': 'SCS_ILH_LAS/MOTOR/PIDELAY',
+                     'key': 'actualPosition.value',
+                     'dim': None},),
 
     # GPC
     "GPC_EOS_DelayLine": ({'source': 'SCS_CDIDET_GRD/MOTOR/IMAGER',
@@ -271,6 +281,9 @@ mnemonics = {
     "Vertical_FDM": ({'source': 'SCS_CDIFFT_LDM/CAM/CAMERA1A:daqOutput',
                       'key': 'data.image.pixels',
                       'dim': ['vfdm_y', 'vfdm_x']},),
+    "LLC_webcam2": ({'source': 'SCS_CDILLC_VAC/CAM/WEBCAMERA2:daqOutput',
+                     'key': 'data.image.pixels',
+                     'dim': ['llc2_y', 'llc2_x']},),
 
     # FastCCD, if in raw folder, raw images
     #          if in proc folder, dark substracted and relative gain corrected
@@ -404,5 +417,15 @@ mnemonics = {
                    'dim': ['gott_pId', 'pixelId']},),
     "Gotthard2": ({'source': 'SCS_PAM_XOX/DET/GOTTHARD_RECEIVER2:daqOutput',
                    'key': 'data.adc',
-                   'dim': ['gott_pId', 'pixelId']},)
+                   'dim': ['gott_pId', 'pixelId']},),
+
+    # BASLER RACER
+    "Racer1": ({'source': 'SCS_PAM_XOX/CAM/RACER1:daqOutput',
+                'key': 'data.image.pixels',
+                'dim': ['racer1_pId', 'racer1_x']},),
+
+    # BBO2 RY (interferometric timing tool, Nov 2020, p2711)
+    "BBO_RY": ({'source': 'SCS_CDIDET_GRD/MOTOR/IMAGER',
+                'key': 'actualPosition.value',
+                'dim': None},)
 }