Hold on to $\eta$ -dependent resolution. This class acts as a function object and returns Vector_Resolution as a function of $\eta$ . It does not assume symmetry between $+\eta$ and $-\eta$ . The interpretation of $\eta$ as physics $\eta$ or detector $\eta$ is left to users's implementation. More...

#include <EtaDepResolution.h>

Public Member Functions
const bool	CheckEta (double eta) const
	Check is an input $\eta$ value is within the valid $\eta$ -range of this instance. More...

bool	CheckNoOverlap (const std::vector< EtaDepResElement > &v)
	Check for non-overlapping $\eta$ -range between $\eta$ -dependent resolution elements in a list. More...

	EtaDepResolution ()
	Default constructor, instantiate an EtaDepResolution object with empty list of $\eta$ -dependent resolution elements. More...

	EtaDepResolution (const std::string &default_file)
	Instantiate an EtaDepResolution object with a filename which contains information about $\eta$ -dependent resolution. More...

const double	EtaMax () const
	Return the upper limit of the valid $\eta$ -range. More...

const double	EtaMin () const
	Return the lower limit of the valid $\eta$ -range. More...

const std::vector< EtaDepResElement >	GetEtaDepResElement () const
	Access the internal list of $\eta$ -dependent resolution elements. More...

EtaDepResElement	GetEtaDepResElement (double &eta) const
	Return the corresponding $\eta$ -dependent resolution element (of type EtaDepResElement)for a value of $\eta$ . More...

Vector_Resolution	GetResolution (double &eta) const
	Return the corresponding resolution for a value of $\eta$ . More...

Vector_Resolution	operator() (double &eta)
	Allow users to call this instance as a function to access the corresponding resolution for an input value of $\eta$ . More...

std::vector< EtaDepResElement >::size_type	Read (const Defaults_Text &defs)
	Read the $\eta$ -dependent resolution information from a Defaults_Text object. More...

std::vector< EtaDepResElement >::size_type	Read (const std::string &default_file)
	Read the $\eta$ -dependent resolution information from an ASCII text file. More...

void	sort ()

	~EtaDepResolution ()

Private Member Functions
std::vector< EtaDepResElement >::const_iterator	FindResolution (double &eta) const
	Internal method to return the corresponding $\eta$ -dependent resolution element for a given $\eta$ value. More...

Private Attributes
std::vector< EtaDepResElement >	_EtaDepResElement

Detailed Description

Hold on to $\eta$ -dependent resolution. This class acts as a function object and returns Vector_Resolution as a function of $\eta$ . It does not assume symmetry between $+\eta$ and $-\eta$ . The interpretation of $\eta$ as physics $\eta$ or detector $\eta$ is left to users's implementation.

Usage:: Users should write the $\eta$ -dependent resolution in a plain ASCII text file with the following format:

etadep_etaminX = etamin

etadep_etamaxX = etamax

etadep_vecresX = vecres

where:

X is an integer starting from 0 (0, 1, 2, 3, ...). Users can write as many resolutions as long as each of them has different integer, and complete information regarding $\eta$ range an resolution.

etamin is a floating-point number, the lower limit of the valid $\eta$ range.

etamax is a floating-point number, the upper limit of the valid $\eta$ range.

vecres is a string-encoded Vector_Resolution, see the documentation for Vector_Resolution class for details.

The constructor will read the ASCII text file and read all resolutions in the file. Then it will instantiate the EtaDepResolution and sort the internal list of EtaDepResElement.

Author: Haryo Sumowidagdo Suhar.nosp@m.yo.S.nosp@m.umowi.nosp@m.dagd.nosp@m.o@cer.nosp@m.n.ch

Creation date:: June 2009.

Definition at line 86 of file EtaDepResolution.h.

Constructor & Destructor Documentation

◆ EtaDepResolution() [1/2]

hitfit::EtaDepResolution::EtaDepResolution ( )

Default constructor, instantiate an EtaDepResolution object with empty list of $\eta$ -dependent resolution elements.

Definition at line 43 of file EtaDepResolution.cc.

43 {}

◆ EtaDepResolution() [2/2]

hitfit::EtaDepResolution::EtaDepResolution ( const std::string & default_file )

Instantiate an EtaDepResolution object with a filename which contains information about $\eta$ -dependent resolution.

Parameters

default_file The input ASCII text file.

Definition at line 45 of file EtaDepResolution.cc.

45 { Read(default_file); }

References Read().

◆ ~EtaDepResolution()

hitfit::EtaDepResolution::~EtaDepResolution ( )

Destructor.

Definition at line 47 of file EtaDepResolution.cc.

47 {}

Member Function Documentation

◆ CheckEta()

const bool hitfit::EtaDepResolution::CheckEta ( double eta ) const

Check is an input $\eta$ value is within the valid $\eta$ -range of this instance.

Parameters

eta	The $\eta$ value to be check.

Return:: true if eta is within the valid $\eta$ -range.
false if is not within the valid $\eta$ -range.

Definition at line 112 of file EtaDepResolution.cc.

112 { return FindResolution(eta) != _EtaDepResElement.end(); }

References _EtaDepResElement, PVValHelper::eta, and FindResolution().

◆ CheckNoOverlap()

bool hitfit::EtaDepResolution::CheckNoOverlap ( const std::vector< EtaDepResElement > & v )

Check for non-overlapping $\eta$ -range between $\eta$ -dependent resolution elements in a list.

Parameters

v	The list of $\eta$ -dependent resolution elements to check.

Return:: true if there is no overlap.
false if there is overlap.

Definition at line 87 of file EtaDepResolution.cc.

                                                                             {
     for (std::vector<EtaDepResElement>::size_type i = 0; i != v.size(); i++) {
       for (std::vector<EtaDepResElement>::size_type j = i + 1; j != v.size(); j++) {
         if (v[i].IsOverlap(v[j])) {
           return false;
         }
       }
     }
     return true;
   }

References mps_fire::i, dqmiolumiharvest::j, and findQualityFiles::v.

Referenced by Read().

◆ EtaMax()

const double hitfit::EtaDepResolution::EtaMax ( ) const

Return the upper limit of the valid $\eta$ -range.

Definition at line 105 of file EtaDepResolution.cc.

                                               {
     if (!(_EtaDepResElement.empty())) {
       return _EtaDepResElement.back().EtaMax();
     }
     return -999.;  // a ridiculously negative large number
   }

References _EtaDepResElement.

◆ EtaMin()

const double hitfit::EtaDepResolution::EtaMin ( ) const

Return the lower limit of the valid $\eta$ -range.

Definition at line 98 of file EtaDepResolution.cc.

                                               {
     if (!(_EtaDepResElement.empty())) {
       return _EtaDepResElement.front().EtaMin();
     }
     return 999.;  // a ridiculously positive large number
   }

References _EtaDepResElement.

◆ FindResolution()

std::vector< EtaDepResElement >::const_iterator hitfit::EtaDepResolution::FindResolution ( double & eta ) const

private

Internal method to return the corresponding $\eta$ -dependent resolution element for a given $\eta$ value.

Parameters

eta	The value of $\eta$ whose corresponding resolution is to be found.

Return:: An iterator (pointer) to the corresponding $\eta$ -dependent resolution element.

Definition at line 31 of file EtaDepResolution.cc.

                                                                                               {
     for (std::vector<EtaDepResElement>::const_iterator res = _EtaDepResElement.begin(); res != _EtaDepResElement.end();
          ++res) {
       if (res->IsInInterval(eta) || res->IsOnEdge(eta)) {
         return res;
       }
     }
     return _EtaDepResElement.end();
   }

References _EtaDepResElement, and PVValHelper::eta.

Referenced by CheckEta(), GetEtaDepResElement(), and GetResolution().

◆ GetEtaDepResElement() [1/2]

const std::vector< EtaDepResElement > hitfit::EtaDepResolution::GetEtaDepResElement ( ) const

Access the internal list of $\eta$ -dependent resolution elements.

Return:: The list of $\eta$ -dependent resolution elements.

Definition at line 130 of file EtaDepResolution.cc.

130 { return _EtaDepResElement; }

References _EtaDepResElement.

◆ GetEtaDepResElement() [2/2]

EtaDepResElement hitfit::EtaDepResolution::GetEtaDepResElement ( double & eta ) const

Return the corresponding $\eta$ -dependent resolution element (of type EtaDepResElement)for a value of $\eta$ .

Parameters

eta	The $\eta$ value for which the corresponding element

Return:: The corresponding element if the input $\eta$ value is valid. Throw a runtime error if the $\eta$ value is invalid.

Definition at line 128 of file EtaDepResolution.cc.

128 { return *(FindResolution(eta)); }

References PVValHelper::eta, and FindResolution().

◆ GetResolution()

Vector_Resolution hitfit::EtaDepResolution::GetResolution ( double & eta ) const

Return the corresponding resolution for a value of $\eta$ .

Parameters

eta	The $\eta$ value for which the corresponding resolution is desired.

Return:: The corresponding resolution if the input $\eta$ value is valid. Throw a runtime error if the $\eta$ value is invalid.

Definition at line 116 of file EtaDepResolution.cc.

                                                                      {
     std::vector<EtaDepResElement>::const_iterator etaDepResEleVecIter = FindResolution(eta);
     if (etaDepResEleVecIter != _EtaDepResElement.end()) {
       return etaDepResEleVecIter->GetResolution();
     }
  
     std::stringstream message;
     message << "Error, the given eta value : " << eta << " is not inside the valid eta range!";
  
     throw std::runtime_error(message.str());
   }

References _EtaDepResElement, PVValHelper::eta, and FindResolution().

Referenced by operator()().

◆ operator()()

Vector_Resolution hitfit::EtaDepResolution::operator() ( double & eta )

Allow users to call this instance as a function to access the corresponding resolution for an input value of $\eta$ .

Parameters

eta	The $\eta$ value for which the corresponding resolution is desired.

Return:: The corresponding resolution if the input $\eta$ value is valid. Throw a runtime error if the $\eta$ value is invalid.

Definition at line 114 of file EtaDepResolution.cc.

114 { return GetResolution(eta); }

References PVValHelper::eta, and GetResolution().

◆ Read() [1/2]

std::vector< EtaDepResElement >::size_type hitfit::EtaDepResolution::Read ( const Defaults_Text & defs )

Read the $\eta$ -dependent resolution information from a Defaults_Text object.

Parameters

defs	The Defaults_Text object to read.

Return:: The number of $\eta$ -dependent resolution element read from the file.

Definition at line 55 of file EtaDepResolution.cc.

                                                                                        {
     _EtaDepResElement.clear();
  
     for (std::vector<EtaDepResElement>::size_type i = 0;; ++i) {
       std::ostringstream os_etamin;
       std::ostringstream os_etamax;
       std::ostringstream os_res;
  
       os_etamin << "etadep_etamin" << i;
       os_etamax << "etadep_etamax" << i;
       os_res << "etadep_vecres" << i;
  
       if (defs.exists(os_etamin.str()) && defs.exists(os_etamax.str()) && defs.exists(os_res.str())) {
         double etamin = defs.get_float(os_etamin.str());
         double etamax = defs.get_float(os_etamax.str());
         Vector_Resolution res(defs.get_string(os_res.str()));
         _EtaDepResElement.push_back(EtaDepResElement(etamin, etamax, res));
  
       } else {
         break;
       }
     }
  
     if (CheckNoOverlap(_EtaDepResElement)) {
       sort();
     } else {
       _EtaDepResElement.clear();
     }
  
     return _EtaDepResElement.size();
   }

References _EtaDepResElement, CheckNoOverlap(), muonTiming_cfi::etamax, muonTiming_cfi::etamin, hitfit::Defaults_Text::exists(), hitfit::Defaults_Text::get_float(), hitfit::Defaults_Text::get_string(), mps_fire::i, and sort().

◆ Read() [2/2]

std::vector< EtaDepResElement >::size_type hitfit::EtaDepResolution::Read ( const std::string & default_file )

Read the $\eta$ -dependent resolution information from an ASCII text file.

Parameters

default_file The ASCII text file to read.

Return:: The number of $\eta$ -dependent resolution element read from the file.

Definition at line 49 of file EtaDepResolution.cc.

                                                                                            {
     const Defaults_Text defs(default_file);
     Read(defs);
     return _EtaDepResElement.size();
   }

References _EtaDepResElement.

Referenced by EtaDepResolution().

◆ sort()

void hitfit::EtaDepResolution::sort ( )

Sort the internal list of $\eta$ -dependent resolution elements.

Definition at line 41 of file EtaDepResolution.cc.

41 { std::stable_sort(_EtaDepResElement.begin(), _EtaDepResElement.end()); }

References _EtaDepResElement.

Referenced by Read().

Member Data Documentation

◆ _EtaDepResElement

std::vector<EtaDepResElement> hitfit::EtaDepResolution::_EtaDepResElement

private

List of $\eta$ -dependent resolution elements.

Definition at line 91 of file EtaDepResolution.h.

Referenced by CheckEta(), EtaMax(), EtaMin(), FindResolution(), GetEtaDepResElement(), GetResolution(), Read(), and sort().

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ EtaDepResolution() [1/2]

◆ EtaDepResolution() [2/2]

◆ ~EtaDepResolution()

Member Function Documentation

◆ CheckEta()

◆ CheckNoOverlap()

◆ EtaMax()

◆ EtaMin()

◆ FindResolution()

◆ GetEtaDepResElement() [1/2]

◆ GetEtaDepResElement() [2/2]

◆ GetResolution()

◆ operator()()

◆ Read() [1/2]

◆ Read() [2/2]

◆ sort()

Member Data Documentation

◆ _EtaDepResElement