New PID Substitution DaVinci Tool

Start from #305 (closed), implementing the comment #305 (comment 5363235).

This MR will add a new PID substitution Tool and a new DTF Tool for DaVinci, which has integrated the PID substitution. A minimal example of the usage could be:

DTF_KstG = DecayTreeFitter(
    Name = 'DTF_KstG',
    Input = B_Data,
    Substitutions = [
        ' B0 ->  ( K*(892)0 ->  K+ K-{{pi-}} ) gamma',
    ]
)
variables_all = FC({
    # Original particle
    'ORIGINAL_ID'      : F.PARTICLE_ID,
    'ORIGINAL_ENERGY'  : F.ENERGY,
    'ORIGINAL_CHI2DOF' : F.CHI2DOF,
    # DTF Bd2KstGamma
    'DTF_KSTG_ID'      : F.VALUE_OR(-1) @ DTF_KstG.get_info( F.PARTICLE_ID ),
    'DTF_KSTG_ENERGY'  : DTF_KstG.get_info( F.ENERGY      ),
    'DTF_KSTG_CHI2DOF' : DTF_KstG.get_info( F.CHI2DOF     ),
})

A real example could be found in https://gitlab.cern.ch/lhcb/DaVinci/-/blob/jzhuo_SubsPID/DaVinciExamples/python/DaVinciExamples/tupling/option_davinci_tupling_DTF_substitutePID.py

Other example for SubstitutePID without DTF could be found in https://gitlab.cern.ch/lhcb/DaVinci/-/blob/jzhuo_SubsPID/DaVinciExamples/python/DaVinciExamples/tupling/option_davinci_tupling_substitutePID.py

This MR should be test with DaVinci!756 (merged)

FYI: @amathad @pkoppenb @erodrigu @fevolle

Closes #305 (closed) Closes #309 (closed)

Phys/DaVinciTools/python/DaVinciTools/SubstitutePID.py

@@ -22,7 +22,7 @@ class SubstitutePID:
     SubstitutePID is an DaVinci python tool which can configure easily the PID substitution
     for DaVinci and create functors to access the necesary information.
     The substitution syntax is the following:
-        ' Old_Particle{{New_Particle}} '
+        ' Old_PID{{New_PID}} '
 
     Args:
         Input (DataHandle): the Input data handle (TES).
@@ -128,7 +128,9 @@ class SubstitutePID:
     def _GetSubsitutionMap(self, Subsitutions: list):
 
         if self.OutputLevel <= VERBOSE:
-            print("SubstitutePID: Start extending the substitution rule to substitution map...")
+            print("==============================")
+            print("SubstitutePID will extend the substitution rules to the following substitution map:")
+            print("{")
 
         # Compile the regex
         find_subs = re.compile(r'{{(.*?)}}')
@@ -171,9 +173,10 @@ class SubstitutePID:
 
         if self.OutputLevel <= VERBOSE:
             for key, value in SubstitutionMap.items():
-                print(f"\t '{key}' : '{value}'")
+                print(f"\t '{key}' : '{value}',")
 
         if self.OutputLevel <= VERBOSE:
-            print("SubstitutePID: Done")
+            print("}")
+            print("==============================")
 
         return SubstitutionMap