SegmentPairFilterFactory Class Reference

Factory that can create appropriate segment pair filters from associated names. More...

#include <SegmentPairFilterFactory.h>

Inheritance diagram for SegmentPairFilterFactory:

Public Types
using	CreatedFilter
	Type of the filter that this factory creates.
using	CreatedFilter
	Type of the filter that this factory creates.

Public Member Functions
	SegmentPairFilterFactory (const std::string &defaultFilterName="realistic")
	Constructor forwarding the default filter name.
std::string	getIdentifier () const final
	Getter for a short identifier for the factory.
std::string	getFilterPurpose () const final
	Getter for a descriptive purpose of the constructed filters.
std::map< std::string, std::string >	getValidFilterNamesAndDescriptions () const final
	Getter for valid filter names and a description for each.
std::unique_ptr< BaseSegmentPairFilter >	create (const std::string &filterName) const final
	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	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.
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.
const std::string &	getDefaultFilterName () const
	Legacy - Return the default filter suggested by the factory.

Private Types
using	Super = TrackingUtilities::FilterFactory<BaseSegmentPairFilter>
	Type of the base class.

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

Detailed Description

Factory that can create appropriate segment pair filters from associated names.

Definition at line 28 of file SegmentPairFilterFactory.h.

Member Typedef Documentation

CreatedFilter [1/2]

using CreatedFilter

inherited

Type of the filter that this factory creates.

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

CreatedFilter [2/2]

using CreatedFilter

inherited

Type of the filter that this factory creates.

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

Super

using Super = TrackingUtilities::FilterFactory<BaseSegmentPairFilter>

private

Type of the base class.

Definition at line 32 of file SegmentPairFilterFactory.h.

Constructor & Destructor Documentation

SegmentPairFilterFactory()

SegmentPairFilterFactory ( const std::string & defaultFilterName = "realistic" )

explicit

Constructor forwarding the default filter name.

Definition at line 29 of file SegmentPairFilterFactory.cc.

  : Super(defaultFilterName)
{
}

Member Function Documentation

create()

std::unique_ptr< Filter< CDCSegmentPair > > create ( const std::string & filterName ) const

finalvirtual

Create a filter with the given name.

Reimplemented from FilterFactory< BaseSegmentPairFilter >.

Definition at line 60 of file SegmentPairFilterFactory.cc.

{
  if (filterName == "none") {
    return std::make_unique<NoneFilter<BaseSegmentPairFilter>>();
    // cppcheck-suppress knownConditionTrueFalse
  } else if (filterName == "all") {
    return std::make_unique<AllSegmentPairFilter>();
    // cppcheck-suppress knownConditionTrueFalse
  } else if (filterName == "truth") {
    return std::make_unique<MCSegmentPairFilter>();
    // cppcheck-suppress knownConditionTrueFalse
  } else if (filterName == "fitless") {
    return std::make_unique<FitlessSegmentPairFilter>();
    // cppcheck-suppress knownConditionTrueFalse
  } else if (filterName == "simple") {
    return std::make_unique<SimpleSegmentPairFilter>();
    // cppcheck-suppress knownConditionTrueFalse
  } else if (filterName == "unionrecording") {
    return std::make_unique<UnionRecordingSegmentPairFilter>();
    // cppcheck-suppress knownConditionTrueFalse
  } else if (filterName == "feasible") {
    return std::make_unique<MVAFeasibleSegmentPairFilter>();
    // cppcheck-suppress knownConditionTrueFalse
  } else if (filterName == "realistic") {
    return std::make_unique<MVARealisticSegmentPairFilter>();
  } else {
    return Super::create(filterName);
  }
}

createFiltersNameDescription()

std::string createFiltersNameDescription ( ) const

virtualinherited

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

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

    {
      // Compose description for the filter names
      std::ostringstream oss;
      oss << this->getFilterPurpose();
      oss << "Allowed values are: ";
      std::vector<std::string> filterNameAndDescriptions;
      for (const auto& filterNameAndDescription : this->getValidFilterNamesAndDescriptions()) {
        const std::string& filterName = filterNameAndDescription.first;
        const std::string& filterDescription = filterNameAndDescription.second;
        filterNameAndDescriptions.push_back(quoted(filterName) + " " + bracketed(filterDescription));
      }
      oss << join(", ", filterNameAndDescriptions);
      return oss.str();
    }

createFiltersParametersDescription()

std::string createFiltersParametersDescription ( ) const

virtualinherited

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

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

    {
      // Compose description for the filter parameters
      std::ostringstream oss;
      oss << "Key -- value pairs depending on the filter." << std::endl;
      for (const auto& filterNameAndDescription : this->getValidFilterNamesAndDescriptions()) {
 
        const std::string& filterName = filterNameAndDescription.first;
        // const std::string& filterDescription = filterNameAndDescription.second;
 
        std::unique_ptr<AFilter> filter = this->create(filterName);
        if (not filter) {
          B2WARNING("Could not create a filter for name " << filterName);
          continue;
        }
 
        ModuleParamList moduleParamList;
        const std::string prefix = "";
        filter->exposeParameters(&moduleParamList, prefix);
 
        std::map<std::string, std::string> filterParameters;
        for (auto&& name : moduleParamList.getParameterNames()) {
          filterParameters[name] = moduleParamList.getParameterDescription(name);
        }
 
        oss << quoted(filterName) << " :\n";
        if (filterParameters.empty()) {
          oss << "(no parameters)";
        } else {
          std::vector<std::string> parameterDescriptions;
          for (const auto& parameterNameAndDescription : filterParameters) {
            const std::string& parameterName = parameterNameAndDescription.first;
            const std::string& parameterDescription = parameterNameAndDescription.second;
            parameterDescriptions.push_back(parameterName + " -- " + parameterDescription);
          }
          oss << join(",\n", parameterDescriptions);
        }
        oss << ";\n";
      }
      return oss.str();
    }

getDefaultFilterName()

const std::string & getDefaultFilterName ( ) const

inherited

Legacy - Return the default filter suggested by the factory.

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

    {
      return m_defaultFilterName;
    }

getFilterPurpose()

std::string getFilterPurpose ( ) const

finalvirtual

Getter for a descriptive purpose of the constructed filters.

Implements FilterFactory< BaseSegmentPairFilter >.

Definition at line 39 of file SegmentPairFilterFactory.cc.

{
  return "Segment pair filter to construct of a segment pair network";
}

getIdentifier()

std::string getIdentifier ( ) const

finalvirtual

Getter for a short identifier for the factory.

Implements FilterFactory< BaseSegmentPairFilter >.

Definition at line 34 of file SegmentPairFilterFactory.cc.

{
  return "SegmentPair";
}

getValidFilterNamesAndDescriptions()

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

finalvirtual

Getter for valid filter names and a description for each.

Implements FilterFactory< BaseSegmentPairFilter >.

Definition at line 45 of file SegmentPairFilterFactory.cc.

{
  return {
    {"none", "no segment pair is valid"},
    {"all", "all segment pairs are valid"},
    {"truth", "monte carlo truth"},
    {"fitless", "mc free with simple criteria without the common fit"},
    {"simple", "mc free with simple criteria"},
    {"unionrecording", "record many multiple choosable variable set"},
    {"feasible", "multivariat method based on variables of the first and last hit in each segment meant as precut"},
    {"realistic", "realistic filter using a common fit and combination of all information with an mva"},
  };
}

Member Data Documentation

m_defaultFilterName [1/2]

std::string m_defaultFilterName

privateinherited

Legacy - Default filter name suggested by this factory.

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

m_defaultFilterName [2/2]

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:

• tracking/trackFindingCDC/filters/segmentPair/include/SegmentPairFilterFactory.h
• tracking/trackFindingCDC/filters/segmentPair/src/SegmentPairFilterFactory.cc