From f658dd86a2588d393638133a11b6cceb16e74f9b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Renata=20Kopecn=C3=A1?= <kopecna@physi.uni-heidelberg.de>
Date: Tue, 25 Jan 2022 13:55:12 +0100
Subject: [PATCH] Add 'MCtruthmatching.cpp'

---
 MCtruthmatching.cpp.md | 65 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 65 insertions(+)
 create mode 100644 MCtruthmatching.cpp.md

diff --git a/MCtruthmatching.cpp.md b/MCtruthmatching.cpp.md
new file mode 100644
index 0000000..0670fc4
--- /dev/null
+++ b/MCtruthmatching.cpp.md
@@ -0,0 +1,65 @@
+In this script, the MC truthmatching is executed. The script can check both the background category of the decay or perform true-ID based truthmatching.
+
+The corresponding classes are defined in [[TMsource.cpp|TMsource]]. **TODO** 
+ 
+### passGammas()
+
+Checks the TRUEIDs of the gammas, including the (grand(grand))mother IDs.
+
+* **Parameters**
+    * gamma1: gamma_IDs class of the first gamma
+    * gamma2: gamma_IDs class of the second gamma
+    * \*counter: counter class to see the number of vetoed events
+    * B_plus_TM: Check whether the gamma TRUEID chain originates from a B?
+    * K_star_plus_TM: Check whether the gamma TRUEID chain originates from a Kstar?
+    * pi_zero_TM: Check whether the gamma TRUEID chain originates from a pi0?
+    * gamma_TM: Check gamma TRUEID?
+    * gamma_TM_full: if true, don't check the gamma TRUEID chain, just return true
+    
+* **Result**\
+Returns a number from 1 to 6:
+    * 1: Both gammas are actually gammas
+    * 2: One gamma is gamma, one is converted
+    * 3: Both are converted
+    * 4: One gamma is real, one is random
+    * 5: One gamma is converted, one is random
+    * 6: Both gammas are random
+    
+### passAllTM()
+
+
+* **Parameters**
+    * B_plus: Bplus_IDs class of the Bplus 
+    * K_star: K_star_IDs class of the Kstar
+    * J_psi: J_psi_IDs class of the J/psi
+    * mu_plus: mu_IDs class of the mu+
+    * mu_minus: mu_IDs class of the mu-
+    * K_plus: K_plus_IDs class of the Kplus
+    * pi_zero: pi_zero_IDs class of the pi0
+    * K_short: K_short_IDs class of the Ks
+    * pi_plus: pi_plus_IDs class of the pi+
+    * Ks_pi_plus: Ks_pi_IDs class of the pi+ from Ks
+    * Ks_pi_minus: Ks_pi_IDs class of the pi- from Ks
+    * 
+    * \*counter: counter class to see the number of vetoed events
+    * \*h_pi0_mismatched_mass:
+    * \*h_Bplus_M_pi0mismatched:
+    * 
+    * \*h_Bplus_M_noPi0Constr:
+    * 
+    * \*h_pi0_resolved_mass:
+
+    * \*h_Bplus_M_pi0random:
+
+
+
+    * B_plus_TM: Check whether the gamma TRUEID chain originates from a B?
+    * K_star_plus_TM: Check whether the gamma TRUEID chain originates from a Kstar?
+    * K_plus_TM: Check whether the gamma TRUEID chain originates from a Kplus?
+    * pi_zero_TM: Check whether the gamma TRUEID chain originates from a pi0?
+    * pi_zero_full_TM: Check whether the gamma TRUEID chain originates from a pi0?**TODO**
+    * mu_TM: Check whether the gamma TRUEID chain originates from a pi0 **TODO**?
+    * J_psi_TM: Check whether the gamma TRUEID chain originates from a pi0 **TODO**?
+    
+* **Result**\
+Returns a boolean: passed (event is TMed) or not passed (event is not TMed)
\ No newline at end of file