Belle II Software development
KLMExpertModule.cc
1/**************************************************************************
2 * basf2 (Belle II Analysis Software Framework) *
3 * Author: The Belle II Collaboration *
4 * *
5 * See git log for contributors and copyright holders. *
6 * This file is licensed under LGPL-3.0, see LICENSE.md. *
7 **************************************************************************/
8#include <reconstruction/modules/KlId/KLMExpert/KLMExpertModule.h>
9#include <mdst/dataobjects/KlId.h>
10#include <framework/logging/Logger.h>
11
12#include <mdst/dataobjects/ECLCluster.h>
13#include <mdst/dataobjects/KLMCluster.h>
14#include <tracking/dataobjects/TrackClusterSeparation.h>
15
16#include <mva/interface/Interface.h>
17#include <mva/dataobjects/DatabaseRepresentationOfWeightfile.h>
18#include <mva/interface/Weightfile.h>
19#include <mva/interface/Expert.h>
20
21// here's where the functions are hidden
22#include "reconstruction/modules/KlId/KLMExpert/KlId.h"
23
24using namespace std;
25using namespace Belle2;
26using namespace Belle2::KlongId;
27
28REG_MODULE(KLMExpert);
29
31{
32 setDescription("Use to calculate KlId for each KLM cluster.");
33 addParam("classifierPath", m_identifier,
34 "path to the classifier you want to use. It is recommended to use the default classifiers and not to mess around with this.",
37}
38
39
40
44
45
46// --------------------------------------Module----------------------------------------------
48{
49 // require existence of necessary datastore obj
50
51 m_klmClusters.isRequired();
52
53 m_klids.registerInDataStore();
54 m_klmClusters.registerRelationTo(m_klids);
55
56
57 if (not(m_identifier.ends_with(".root") or m_identifier.ends_with(".xml"))) {
58 m_weightfile_representation = std::unique_ptr<DBObjPtr<DatabaseRepresentationOfWeightfile>>(new
60 }
61
63
64}
65
66
68{
70 if (m_weightfile_representation->hasChanged()) {
71 std::stringstream ss((*m_weightfile_representation)->m_data);
72 auto weightfile = MVA::Weightfile::loadFromStream(ss);
73 init_mva(weightfile);
74 }
75 } else {
77 init_mva(weightfile);
78
79 }
80}
81
83{
84
85 auto supported_interfaces = MVA::AbstractInterface::getSupportedInterfaces();
86 MVA::GeneralOptions general_options;
87 weightfile.getOptions(general_options);
88
89 m_expert = supported_interfaces[general_options.m_method]->getExpert();
90 m_expert->load(weightfile);
91
92 std::vector<float> dummy;
93 dummy.resize(m_feature_variables.size(), 0);
94 m_dataset = std::unique_ptr<MVA::SingleDataset>(new MVA::SingleDataset(general_options, std::move(dummy), 0));
95
96}
97
98
100{
101 // Use the neutralHadron hypothesis for the ECL
103
104 //overwritten at the end of the cluster loop
105 KlId* klid = nullptr;
106
107 // loop thru clusters in event and classify
108 for (KLMCluster& cluster : m_klmClusters) {
109
110 const ROOT::Math::XYZVector& clusterPos = cluster.getClusterPosition();
111
112 // get various KLMCluster vars
113 m_KLMglobalZ = clusterPos.Z();
114 m_KLMnCluster = m_klmClusters.getEntries();
115 m_KLMnLayer = cluster.getLayers();
116 m_KLMnInnermostLayer = cluster.getInnermostLayer();
117 m_KLMtime = cluster.getTime();
118 m_KLMenergy = cluster.getEnergy();
119 m_KLMhitDepth = cluster.getClusterPosition().R();
120
121 // find nearest ecl cluster and calculate distance
122 pair<ECLCluster*, double> closestECLAndDist = findClosestECLCluster(clusterPos, eclHypothesis);
123 ECLCluster* closestECLCluster = get<0>(closestECLAndDist);
124 m_KLMECLDist = get<1>(closestECLAndDist);
125
126 // get variables of the closest ECL cluster might be removed in future
127 if (!(closestECLCluster == nullptr)) {
128 m_KLMECLE = closestECLCluster -> getEnergy(eclHypothesis);
129 m_KLMECLE9oE25 = closestECLCluster -> getE9oE21();
130 m_KLMECLTerror = closestECLCluster -> getDeltaTime99();
131 m_KLMECLTiming = closestECLCluster -> getTime();
132 m_KLMECLEerror = closestECLCluster -> getUncertaintyEnergy();
133 m_KLMECLdeltaL = closestECLCluster -> getDeltaL();
134 m_KLMECLminTrackDist = closestECLCluster -> getMinTrkDistance();
135 m_KLMECLZMVA = closestECLCluster -> getZernikeMVA();
136 m_KLMECLZ40 = closestECLCluster -> getAbsZernike40();
137 m_KLMECLZ51 = closestECLCluster -> getAbsZernike51();
138 } else {
139 m_KLMECLdeltaL = -999;
141 m_KLMECLE = -999;
142 m_KLMECLE9oE25 = -999;
143 m_KLMECLTiming = -999;
144 m_KLMECLTerror = -999;
145 m_KLMECLEerror = -999;
146 m_KLMECLZMVA = -999;
147 m_KLMECLZ40 = -999;
148 m_KLMECLZ51 = -999;
149 }
150
151 // calculate distance to next cluster
152 tuple<const KLMCluster*, double, double> closestKLMAndDist = findClosestKLMCluster(clusterPos);
153 m_KLMnextCluster = get<1>(closestKLMAndDist);
154 m_KLMavInterClusterDist = get<2>(closestKLMAndDist);
155
156 m_KLMTrackSepDist = -999;
157 m_KLMTrackSepAngle = -999;
161
162 auto trackSeperations = cluster.getRelationsTo<TrackClusterSeparation>();
163 float best_dist = 1e10;
164 for (auto trackSeperation : trackSeperations) {
165 float dist = trackSeperation.getDistance();
166 if (dist < best_dist) {
167 best_dist = dist;
168 m_KLMTrackSepDist = trackSeperation.getDistance();
169 m_KLMTrackSepAngle = trackSeperation.getTrackClusterAngle();
170 m_KLMInitialTrackSepAngle = trackSeperation.getTrackClusterInitialSeparationAngle();
171 m_KLMTrackRotationAngle = trackSeperation.getTrackRotationAngle();
172 m_KLMTrackClusterSepAngle = trackSeperation.getTrackClusterSeparationAngle();
173 }
174 }
175
176// reduced vars set
195
196
197 for (unsigned int i = 0; i < m_feature_variables.size(); ++i) {
198 if (!std::isfinite(m_feature_variables[i])) { m_feature_variables[i] = -999; }
199 m_dataset->m_input[i] = m_feature_variables[i];
200 }
201
202 double IDMVAOut = m_expert->apply(*m_dataset)[0];
203 B2DEBUG(175, "KLM Expert classification: " << IDMVAOut);
204 klid = m_klids.appendNew();
205 cluster.addRelationTo(klid, IDMVAOut);
206
207 }// for cluster in clusters
208} // event
Class for accessing objects in the database.
Definition DBObjPtr.h:21
ECL cluster data.
Definition ECLCluster.h:27
EHypothesisBit
The hypothesis bits for this ECLCluster (Connected region (CR) is split using this hypothesis.
Definition ECLCluster.h:31
@ c_neutralHadron
CR is reconstructed as a neutral hadron (N2)
Definition ECLCluster.h:43
KLM cluster data.
Definition KLMCluster.h:29
float m_KLMECLE
energy measured in associated ECL cluster
float m_KLMECLdeltaL
distance between track entry pofloat and cluster center, might be removed
StoreArray< KlId > m_klids
storearray
float m_KLMInitialTrackSepAngle
angular distance from track to cluster at track starting point
float m_KLMECLZMVA
output of a BDT fitted on various Z-moments for the closest ECL cluster
float m_KLMTrackRotationAngle
angle between track at poca and trackbeginning
float m_KLMECLTiming
timing of associated ECL cluster
std::unique_ptr< MVA::SingleDataset > m_dataset
Pointer to the current dataset.
StoreArray< KLMCluster > m_klmClusters
storearray
virtual void initialize() override
init
float m_KLMECLTerror
uncertanty on time in associated ECL cluster
virtual void event() override
process event
float m_KLMtime
timing of KLM Cluster
float m_KLMECLDist
distance associated ECL <-> KLM cluster, extrapolated by genfit
float m_KLMnLayer
number of layers hit in KLM cluster
float m_KLMhitDepth
hit depth in KLM, distance to IP
float m_KLMECLminTrackDist
track distance between associated ECL cluster and track extrapolated into ECL
float m_KLMenergy
Energy deposit in KLM (0.2 GeV * nHitCells)
float m_KLMTrackSepAngle
angular distance from track separation object.
std::unique_ptr< MVA::Expert > m_expert
Pointer to the current MVA Expert.
float m_KLMECLZ40
zernike moment 4,0 of closest ECL
std::unique_ptr< DBObjPtr< DatabaseRepresentationOfWeightfile > > m_weightfile_representation
Database pointer to the Database representation of the weightfile.
virtual ~KLMExpertModule()
Destructor.
float m_KLMnInnermostLayer
number of innermost layers hit
float m_KLMECLEerror
uncertanty on E in associated ECL cluster
float m_KLMECLE9oE25
E in surrounding 9 crystals divided by surrounding 25 crydtalls.
std::vector< float > m_feature_variables
vars to be classified
float m_KLMECLZ51
zernike moment 5,1 of closest ECL
float m_KLMavInterClusterDist
average distance between all KLM clusters
virtual void beginRun() override
beginn run
float m_KLMTrackSepDist
distance from track separation object
float m_KLMglobalZ
global Z position in KLM
float m_KLMnCluster
varibales to write out.
float m_KLMnextCluster
distance to next KLM cluster
float m_KLMTrackClusterSepAngle
angle between trach momentum and cluster (measured from ip)
void init_mva(MVA::Weightfile &weightfile)
Initialize mva expert, dataset and features Called everytime the weightfile in the database changes i...
std::string m_identifier
mva identifier.
Klong identification (KlId) datastore object to store results from KlId calculations.
Definition KlId.h:23
static void initSupportedInterfaces()
Static function which initializes all supported interfaces, has to be called once before getSupported...
Definition Interface.cc:46
static std::map< std::string, AbstractInterface * > getSupportedInterfaces()
Returns interfaces supported by the MVA Interface.
Definition Interface.h:53
General options which are shared by all MVA trainings.
Definition Options.h:62
Wraps the data of a single event into a Dataset.
Definition Dataset.h:135
The Weightfile class serializes all information about a training into an xml tree.
Definition Weightfile.h:38
static Weightfile loadFromStream(std::istream &stream)
Static function which deserializes a Weightfile from a stream.
static Weightfile loadFromFile(const std::string &filename)
Static function which loads a Weightfile from a file.
void setDescription(const std::string &description)
Sets the description of the module.
Definition Module.cc:214
void setPropertyFlags(unsigned int propertyFlags)
Sets the flags for the module properties.
Definition Module.cc:208
Module()
Constructor.
Definition Module.cc:30
@ c_ParallelProcessingCertified
This module can be run in parallel processing mode safely (All I/O must be done through the data stor...
Definition Module.h:80
Store one Track-KLMCluster separation as a ROOT object.
void addParam(const std::string &name, T &paramVariable, const std::string &description, const T &defaultValue)
Adds a new parameter to the module.
Definition Module.h:559
#define REG_MODULE(moduleName)
Register the given module (without 'Module' suffix) with the framework.
Definition Module.h:649
Helper functions for all klid modules to improve readability of the code.
Definition KlId.h:27
std::tuple< const Belle2::KLMCluster *, double, double > findClosestKLMCluster(const ROOT::Math::XYZVector &klmClusterPosition)
find nearest KLMCluster, tis distance and the av intercluster distance
Definition KlId.h:236
std::pair< Belle2::ECLCluster *, double > findClosestECLCluster(const ROOT::Math::XYZVector &klmClusterPosition, const Belle2::ECLCluster::EHypothesisBit eclhypothesis=Belle2::ECLCluster::EHypothesisBit::c_neutralHadron)
Find the closest ECLCluster with a neutral hadron hypothesis, and return it with its distance.
Definition KlId.h:203
Abstract base class for different kinds of events.
STL namespace.