Belle II Software development
FacetRelationFilterFactory Class Reference

Factory that can create appropriate facet relation filters from associated names. More...

#include <FacetRelationFilterFactory.h>

Inheritance diagram for FacetRelationFilterFactory:
FilterFactory< BaseFacetRelationFilter >

Public Types

using CreatedFilter = BaseFacetRelationFilter
 Type of the filter that this factory creates.
 

Public Member Functions

 FacetRelationFilterFactory (const std::string &defaultFilterName="chi2")
 Constructor forwarding the default filter name.
 
std::string getIdentifier () const override
 Getter for a short identifier for the factory.
 
std::string getFilterPurpose () const override
 Getter for a descriptive purpose of the constructed filters.
 
std::map< std::string, std::string > getValidFilterNamesAndDescriptions () const override
 Getter for valid filter names and a description for each.
 
std::unique_ptr< BaseFacetRelationFiltercreate (const std::string &filterName) const override
 Create a filter with the given name.
 
virtual std::string createFiltersNameDescription () const
 Create a string with a description mentioning the names of the chooseable filter.
 
virtual std::string createFiltersParametersDescription () const
 Create a string with a description mentioning the parameters of the chooseable filter.
 
const std::string & getDefaultFilterName () const
 Legacy - Return the default filter suggested by the factory.
 

Private Types

using Super = FilterFactory< BaseFacetRelationFilter >
 Type of the base class.
 

Private Attributes

std::string m_defaultFilterName
 Legacy - Default filter name suggested by this factory.
 

Detailed Description

Factory that can create appropriate facet relation filters from associated names.

Definition at line 24 of file FacetRelationFilterFactory.h.

Member Typedef Documentation

◆ CreatedFilter

Type of the filter that this factory creates.

Definition at line 29 of file FilterFactory.dcl.h.

◆ Super

Type of the base class.

Definition at line 28 of file FacetRelationFilterFactory.h.

Constructor & Destructor Documentation

◆ FacetRelationFilterFactory()

FacetRelationFilterFactory ( const std::string &  defaultFilterName = "chi2")
explicit

Constructor forwarding the default filter name.

Definition at line 28 of file FacetRelationFilterFactory.cc.

29 : Super(defaultFilterName)
30{
31}
FilterFactory< BaseFacetRelationFilter > Super
Type of the base class.

Member Function Documentation

◆ create()

std::unique_ptr< BaseFacetRelationFilter > create ( const std::string &  filterName) const
overridevirtual

Create a filter with the given name.

Reimplemented from FilterFactory< BaseFacetRelationFilter >.

Definition at line 59 of file FacetRelationFilterFactory.cc.

60{
61 if (filterName == "none") {
62 return std::make_unique<NoneFilter<BaseFacetRelationFilter>>();
63 // cppcheck-suppress knownConditionTrueFalse
64 } else if (filterName == "all") {
65 return std::make_unique<AllFacetRelationFilter>();
66 // cppcheck-suppress knownConditionTrueFalse
67 } else if (filterName == "truth") {
68 return std::make_unique<MCFacetRelationFilter>();
69 // cppcheck-suppress knownConditionTrueFalse
70 } else if (filterName == "simple") {
71 return std::make_unique<SimpleFacetRelationFilter>();
72 // cppcheck-suppress knownConditionTrueFalse
73 } else if (filterName == "chi2") {
74 return std::make_unique<Chi2FacetRelationFilter>();
75 // cppcheck-suppress knownConditionTrueFalse
76 } else if (filterName == "chi2_old") {
77 return std::make_unique<Chi2FacetRelationFilter>(130.0, 200.0);
78 // cppcheck-suppress knownConditionTrueFalse
79 } else if (filterName == "unionrecording") {
80 return std::make_unique<UnionRecordingFacetRelationFilter>();
81 // cppcheck-suppress knownConditionTrueFalse
82 } else if (filterName == "mva") {
83 return std::make_unique<MVAFacetRelationFilter>();
84 } else {
85 return Super::create(filterName);
86 }
87}
virtual std::unique_ptr< BaseFacetRelationFilter > create(const std::string &filterName) const
Create a filter with the given name, does not set filter specific parameters.

◆ createFiltersNameDescription()

std::string createFiltersNameDescription
virtualinherited

Create a string with a description mentioning the names of the chooseable filter.

Definition at line 56 of file FilterFactory.icc.h.

87 {
88 // Compose description for the filter names
89 std::ostringstream oss;
90 oss << this->getFilterPurpose();
91 oss << "Allowed values are: ";
92 std::vector<std::string> filterNameAndDescriptions;
93 for (const auto& filterNameAndDescription : this->getValidFilterNamesAndDescriptions()) {
94 const std::string& filterName = filterNameAndDescription.first;
95 const std::string& filterDescription = filterNameAndDescription.second;
96 filterNameAndDescriptions.push_back(quoted(filterName) + " " + bracketed(filterDescription));
97 }
98 oss << join(", ", filterNameAndDescriptions);
99 return oss.str();
100 }
virtual std::map< std::string, std::string > getValidFilterNamesAndDescriptions() const=0
Getter for the valid filter names and a description for each.
virtual std::string getFilterPurpose() const=0
Getter for a descriptive purpose of the filter.

◆ createFiltersParametersDescription()

std::string createFiltersParametersDescription
virtualinherited

Create a string with a description mentioning the parameters of the chooseable filter.

Definition at line 59 of file FilterFactory.icc.h.

104 {
105 // Compose description for the filter parameters
106 std::ostringstream oss;
107 oss << "Key -- value pairs depending on the filter." << std::endl;
108 for (const auto& filterNameAndDescription : this->getValidFilterNamesAndDescriptions()) {
109
110 const std::string& filterName = filterNameAndDescription.first;
111 // const std::string& filterDescription = filterNameAndDescription.second;
112
113 std::unique_ptr<AFilter> filter = this->create(filterName);
114 if (not filter) {
115 B2WARNING("Could not create a filter for name " << filterName);
116 continue;
117 }
118
119 ModuleParamList moduleParamList;
120 const std::string prefix = "";
121 filter->exposeParameters(&moduleParamList, prefix);
122
123 std::map<std::string, std::string> filterParameters;
124 for (auto && name : moduleParamList.getParameterNames()) {
125 filterParameters[name] = moduleParamList.getParameterDescription(name);
126 }
127
128 oss << quoted(filterName) << " :\n";
129 if (filterParameters.empty()) {
130 oss << "(no parameters)";
131 } else {
132 std::vector<std::string> parameterDescriptions;
133 for (const auto& parameterNameAndDescription : filterParameters) {
134 const std::string& parameterName = parameterNameAndDescription.first;
135 const std::string& parameterDescription = parameterNameAndDescription.second;
136 parameterDescriptions.push_back(parameterName + " -- " + parameterDescription);
137 }
138 oss << join(",\n", parameterDescriptions);
139 }
140 oss << ";\n";
141 }
142 return oss.str();
143 }

◆ getDefaultFilterName()

const std::string & getDefaultFilterName
inherited

Legacy - Return the default filter suggested by the factory.

Definition at line 63 of file FilterFactory.icc.h.

147 {
148 return m_defaultFilterName;
149 }
std::string m_defaultFilterName
Legacy - Default filter name suggested by this factory.

◆ getFilterPurpose()

std::string getFilterPurpose ( ) const
overridevirtual

Getter for a descriptive purpose of the constructed filters.

Implements FilterFactory< BaseFacetRelationFilter >.

Definition at line 38 of file FacetRelationFilterFactory.cc.

39{
40 return "Facet relation filter to construct of a facet network";
41}

◆ getIdentifier()

std::string getIdentifier ( ) const
overridevirtual

Getter for a short identifier for the factory.

Implements FilterFactory< BaseFacetRelationFilter >.

Definition at line 33 of file FacetRelationFilterFactory.cc.

34{
35 return "FacetRelation";
36}

◆ getValidFilterNamesAndDescriptions()

std::map< std::string, std::string > getValidFilterNamesAndDescriptions ( ) const
overridevirtual

Getter for valid filter names and a description for each.

Implements FilterFactory< BaseFacetRelationFilter >.

Definition at line 44 of file FacetRelationFilterFactory.cc.

45{
46 return {
47 {"none", "no facet relation is valid, stop at facet creation."},
48 {"all", "all facet relations are valid"},
49 {"truth", "facet relations from monte carlo truth"},
50 {"simple", "mc free with simple criteria"},
51 {"chi2", "mc free based on chi2 fitting"},
52 {"chi2_old", "old based on chi2 fitting with single cut regardless of superlayer"},
53 {"unionrecording", "record multiple choosable variable sets"},
54 {"mva", "filter facets with a mva method"},
55 };
56}

Member Data Documentation

◆ m_defaultFilterName

std::string m_defaultFilterName
privateinherited

Legacy - Default filter name suggested by this factory.

Definition at line 67 of file FilterFactory.dcl.h.


The documentation for this class was generated from the following files: