Singleton class providing pre-constructed reconstruction objects. More...

#include <TOPRecoManager.h>

Static Public Member Functions
static TOPRecoManager &	getInstance ()
	Returns instance of the class.

static const InverseRaytracer *	getInverseRaytracer (int moduleID)
	Returns inverse ray-tracer of a given module.

static const FastRaytracer *	getFastRaytracer (int moduleID)
	Returns fast ray-tracer of a given module.

static const YScanner *	getYScanner (int moduleID)
	Returns y-scanner of a given module.

static const BackgroundPDF *	getBackgroundPDF (int moduleID)
	Returns background PDF of a given module.

static const std::vector< BackgroundPDF > &	getBackgroundPDFs ()
	Returns background PDF's of all modules.

static double	getMinTime ()
	Returns time window lower edge.

static double	getMaxTime ()
	Returns time window upper edge.

static double	getTimeWindowSize ()
	Returns size of time window.

static void	setTimeWindow (double minTime, double maxTime)
	Sets time window.

static void	setDefaultTimeWindow ()
	Sets default time window (functions getMinTime(), getMaxTime() will then return default values from DB)

static void	setChannelMask (const DBObjPtr< TOPCalChannelMask > &mask, const TOPAsicMask &asicMask)
	Sets channel masks.

static void	setUncalibratedChannelsOff (const DBObjPtr< TOPCalChannelT0 > &channelT0)
	Sets uncalibrated channels off.

static void	setUncalibratedChannelsOff (const DBObjPtr< TOPCalTimebase > &timebase)
	Sets uncalibrated channels off.

static void	setChannelEffi ()
	Sets relative efficiencies of pixels.

static void	setMirrorCenter (int moduleID, double xc, double yc)
	Sets the mirror center-of-curvature.

Private Member Functions
	TOPRecoManager ()=default
	Singleton: private constructor.

	TOPRecoManager (TOPRecoManager &)=delete
	Singleton: no copy constructor.

TOPRecoManager &	operator= (const TOPRecoManager &)=delete
	Singleton: no assignment operator.

	~TOPRecoManager ()=default
	Singleton: private destructor.

void	set ()
	Sets the reconstruction object collections.

std::vector< InverseRaytracer > &	inverseRaytracers ()
	Interface to inverse ray-tracers of all modules.

std::vector< FastRaytracer > &	fastRaytracers ()
	Interface to fast ray-tracers of all modules.

std::vector< YScanner > &	yScanners ()
	Interface to y-scanners of all modules.

std::vector< BackgroundPDF > &	backgroundPDFs ()
	Interface to background PDF's of all modules.

Private Attributes
std::vector< InverseRaytracer >	m_inverseRaytracers
	collection of inverse raytracers

std::vector< FastRaytracer >	m_fastRaytracers
	collection of fast raytracers

std::vector< YScanner >	m_yScanners
	collection of y-scanners

std::vector< BackgroundPDF >	m_backgroundPDFs
	collection of background PDF's

double	m_minTime = 0
	time window lower edge

double	m_maxTime = 0
	time window upper edge

bool	m_redoBkg = false
	flag to signal whether backgroundPDF has to be redone

Detailed Description

Singleton class providing pre-constructed reconstruction objects.

Definition at line 34 of file TOPRecoManager.h.

Member Function Documentation

◆ backgroundPDFs()

std::vector< BackgroundPDF > & backgroundPDFs ( )

inlineprivate

Interface to background PDF's of all modules.

Any accesses to underlying collection must be made with this method.

Returns: collection of background PDF's (index = moduleID - 1)

Definition at line 233 of file TOPRecoManager.h.

    {
      if (m_backgroundPDFs.empty()) set();
      if (m_redoBkg) {
        for (auto& pdf : m_backgroundPDFs) pdf.set();
        m_redoBkg = false;
      }
      return m_backgroundPDFs;
    }

◆ fastRaytracers()

std::vector< FastRaytracer > & fastRaytracers ( )

inlineprivate

Interface to fast ray-tracers of all modules.

Any accesses to underlying collection must be made with this method.

Returns: collection of fast ray-tracers (index = moduleID - 1)

Definition at line 221 of file TOPRecoManager.h.

    {
      if (m_fastRaytracers.empty()) set();
      return m_fastRaytracers;
    }

◆ getBackgroundPDF()

const BackgroundPDF * getBackgroundPDF ( int moduleID )

static

Returns background PDF of a given module.

Parameters

moduleID slot ID (1-based)

Returns: pointer to background PDF or null pointer if moduleID is not valid

Definition at line 76 of file TOPRecoManager.cc.

    {
      const auto& collection = getInstance().backgroundPDFs();
      unsigned k = moduleID - 1;
      if (k < collection.size()) {
        return &collection[k];
      }
 
      B2ERROR("TOPRecoManager::getBackgroundPDF: invalid moduleID" << LogVar("moduleID", moduleID));
      return 0;
    }

◆ getBackgroundPDFs()

static const std::vector< BackgroundPDF > & getBackgroundPDFs ( )

inlinestatic

Returns background PDF's of all modules.

Returns: collection of background PDF's (index = moduleID - 1)

Definition at line 76 of file TOPRecoManager.h.

76{return getInstance().backgroundPDFs();}

◆ getFastRaytracer()

const FastRaytracer * getFastRaytracer ( int moduleID )

static

Returns fast ray-tracer of a given module.

Parameters

moduleID slot ID (1-based)

Returns: pointer to fast ray-tracer or null pointer if moduleID is not valid

Definition at line 49 of file TOPRecoManager.cc.

    {
      const auto& collection = getInstance().fastRaytracers();
      unsigned k = moduleID - 1;
      if (k < collection.size()) {
        collection[k].clear();
        return &collection[k];
      }
 
      B2ERROR("TOPRecoManager::getFastRaytracer: invalid moduleID" << LogVar("moduleID", moduleID));
      return 0;
    }

◆ getInstance()

TOPRecoManager & getInstance ( )

static

Returns instance of the class.

Returns: class instance

Definition at line 19 of file TOPRecoManager.cc.

    {
      static TOPRecoManager instance;
      return instance;
    }

◆ getInverseRaytracer()

const InverseRaytracer * getInverseRaytracer ( int moduleID )

static

Returns inverse ray-tracer of a given module.

Parameters

moduleID slot ID (1-based)

Returns: pointer to inverse ray-tracer or null pointer if moduleID is not valid

Definition at line 36 of file TOPRecoManager.cc.

    {
      const auto& collection = getInstance().inverseRaytracers();
      unsigned k = moduleID - 1;
      if (k < collection.size()) {
        collection[k].clear();
        return &collection[k];
      }
 
      B2ERROR("TOPRecoManager::getInverseRaytracer: invalid moduleID" << LogVar("moduleID", moduleID));
      return 0;
    }

◆ getMaxTime()

static double getMaxTime ( )

inlinestatic

Returns time window upper edge.

Returns: time window upper edge

Definition at line 94 of file TOPRecoManager.h.

      {
        if (getInstance().m_minTime < getInstance().m_maxTime) {
          return getInstance().m_maxTime;
        }
        return TOPGeometryPar::Instance()->getGeometry()->getNominalTDC().getTimeMax();
      }

◆ getMinTime()

static double getMinTime ( )

inlinestatic

Returns time window lower edge.

Returns: time window lower edge

Definition at line 82 of file TOPRecoManager.h.

      {
        if (getInstance().m_minTime < getInstance().m_maxTime) {
          return getInstance().m_minTime;
        }
        return TOPGeometryPar::Instance()->getGeometry()->getNominalTDC().getTimeMin();
      }

◆ getTimeWindowSize()

static double getTimeWindowSize ( )

inlinestatic

Returns size of time window.

Returns: size of time window

Definition at line 106 of file TOPRecoManager.h.

106{return getMaxTime() - getMinTime();}

Belle2::TOP::TOPRecoManager::getMaxTime

static double getMaxTime()

Returns time window upper edge.

Definition: TOPRecoManager.h:94

Belle2::TOP::TOPRecoManager::getMinTime

static double getMinTime()

Returns time window lower edge.

Definition: TOPRecoManager.h:82

◆ getYScanner()

const YScanner * getYScanner ( int moduleID )

static

Returns y-scanner of a given module.

Parameters

moduleID slot ID (1-based)

Returns: pointer to y-scanner or null pointer if moduleID is not valid

Definition at line 62 of file TOPRecoManager.cc.

    {
      const auto& collection = getInstance().yScanners();
      unsigned k = moduleID - 1;
      if (k < collection.size()) {
        collection[k].clear();
        return &collection[k];
      }
 
      B2ERROR("TOPRecoManager::getYScanner: invalid moduleID" << LogVar("moduleID", moduleID));
      return 0;
    }

◆ inverseRaytracers()

std::vector< InverseRaytracer > & inverseRaytracers ( )

inlineprivate

Interface to inverse ray-tracers of all modules.

Any accesses to underlying collection must be made with this method.

Returns: collection of inverse ray-tracers (index = moduleID - 1)

Definition at line 215 of file TOPRecoManager.h.

    {
      if (m_inverseRaytracers.empty()) set();
      return m_inverseRaytracers;
    }

◆ set()

void set ( )

private

Sets the reconstruction object collections.

Definition at line 25 of file TOPRecoManager.cc.

    {
      const auto* geo = TOPGeometryPar::Instance()->getGeometry();
      for (unsigned moduleID = 1; moduleID <= geo->getNumModules(); moduleID++) {
        m_yScanners.push_back(YScanner(moduleID));
        m_inverseRaytracers.push_back(InverseRaytracer(moduleID, m_yScanners.back().getCosTotal()));
        m_fastRaytracers.push_back(FastRaytracer(moduleID));
        m_backgroundPDFs.push_back(BackgroundPDF(moduleID));
      }
    }

◆ setChannelEffi()

void setChannelEffi ( )

static

Sets relative efficiencies of pixels.

Definition at line 150 of file TOPRecoManager.cc.

    {
      const double minEffi = 0.1;
      const double maxEffi = 2.0;
      for (auto& yScanner : getInstance().yScanners()) {
        auto& pixelEfficiencies = yScanner.pixelEfficiencies();
        int moduleID = pixelEfficiencies.getModuleID();
        int numPixels = pixelEfficiencies.getNumPixels();
        for (int pixelID = 1; pixelID <= numPixels; pixelID++) {
          double effi = TOPGeometryPar::Instance()->getRelativePixelEfficiency(moduleID, pixelID);
          if (effi < minEffi) {
            B2WARNING("TOPRecoManager::setChannelEffi: relative pixel efficiency found rather small"
                      << LogVar("slot", moduleID)
                      << LogVar("pixel", pixelID)
                      << LogVar("efficiency", effi)
                      << " -> will set it to " << minEffi);
            effi = minEffi;
          } else if (effi > maxEffi) {
            B2WARNING("TOPRecoManager::setChannelEffi: relative pixel efficiency found rather large"
                      << LogVar("slot", moduleID)
                      << LogVar("pixel", pixelID)
                      << LogVar("efficiency", effi)
                      << " -> will set it to " << maxEffi);
            effi = maxEffi;
          }
          pixelEfficiencies.set(pixelID, effi);
        }
      }
      getInstance().m_redoBkg = true;
 
      B2INFO("TOPRecoManager: new relative pixel efficiencies have been passed to reconstruction");
    }

◆ setChannelMask()

void setChannelMask	(	const DBObjPtr< TOPCalChannelMask > &	mask,
		const TOPAsicMask &	asicMask
	)

static

Sets channel masks.

Parameters

mask	channel mask
asicMask	masked asics

Definition at line 88 of file TOPRecoManager.cc.

    {
      const auto& mapper = TOPGeometryPar::Instance()->getChannelMapper();
      for (auto& yScanner : getInstance().yScanners()) {
        auto& pixelMasks = yScanner.pixelMasks();
        int moduleID = pixelMasks.getModuleID();
        unsigned numChannels = pixelMasks.getNumPixels();
        for (unsigned channel = 0; channel < numChannels; channel++) {
          int pixelID = mapper.getPixelID(channel);
          pixelMasks.set(pixelID, mask->isActive(moduleID, channel) and asicMask.isActive(moduleID, channel));
        }
      }
      getInstance().m_redoBkg = true;
 
      B2INFO("TOPRecoManager: new channel masks have been passed to reconstruction");
    }

◆ setDefaultTimeWindow()

static void setDefaultTimeWindow ( )

inlinestatic

Sets default time window (functions getMinTime(), getMaxTime() will then return default values from DB)

Definition at line 122 of file TOPRecoManager.h.

      {
        getInstance().m_minTime = 0;
        getInstance().m_maxTime = 0;
      }

◆ setMirrorCenter()

void setMirrorCenter	(	int	moduleID,
		double	xc,
		double	yc
	)

static

Sets the mirror center-of-curvature.

Parameters

moduleID	slot ID (1-based)
xc	center of curvature in x
yc	center of curvature in y

Definition at line 183 of file TOPRecoManager.cc.

    {
      auto& inverseRaytracers = getInstance().inverseRaytracers();
      auto& fastRaytracers = getInstance().fastRaytracers();
      auto& yScanners = getInstance().yScanners();
      unsigned k = moduleID - 1;
      if (k < yScanners.size()) {
        inverseRaytracers[k].setMirrorCenter(xc, yc);
        fastRaytracers[k].setMirrorCenter(xc, yc);
        yScanners[k].setMirrorCenter(xc, yc);
        return;
      }
 
      B2ERROR("TOPRecoManager::setMirrorCenter: invalid moduleID" << LogVar("moduleID", moduleID));
    }

◆ setTimeWindow()

static void setTimeWindow	(	double	minTime,
		double	maxTime
	)

inlinestatic

Sets time window.

Parameters

minTime	lower edge
maxTime	upper edge

Definition at line 113 of file TOPRecoManager.h.

      {
        getInstance().m_minTime = minTime;
        getInstance().m_maxTime = maxTime;
      }

◆ setUncalibratedChannelsOff() [1/2]

void setUncalibratedChannelsOff ( const DBObjPtr< TOPCalChannelT0 > & channelT0 )

static

Sets uncalibrated channels off.

Parameters

channelT0 channel T0 calibration

Definition at line 106 of file TOPRecoManager.cc.

    {
      const auto& mapper = TOPGeometryPar::Instance()->getChannelMapper();
      for (auto& yScanner : getInstance().yScanners()) {
        auto& pixelMasks = yScanner.pixelMasks();
        int moduleID = pixelMasks.getModuleID();
        unsigned numChannels = pixelMasks.getNumPixels();
        for (unsigned channel = 0; channel < numChannels; channel++) {
          if (channelT0->isCalibrated(moduleID, channel)) continue;
          int pixelID = mapper.getPixelID(channel);
          pixelMasks.setPixelOff(pixelID);
        }
      }
      getInstance().m_redoBkg = true;
 
      B2INFO("TOPRecoManager: channelT0-uncalibrated channels have been masked off");
    }

◆ setUncalibratedChannelsOff() [2/2]

void setUncalibratedChannelsOff ( const DBObjPtr< TOPCalTimebase > & timebase )

static

Sets uncalibrated channels off.

Parameters

timebase timebase calibration

Definition at line 124 of file TOPRecoManager.cc.

    {
      const auto& ch_mapper = TOPGeometryPar::Instance()->getChannelMapper();
      const auto& fe_mapper = TOPGeometryPar::Instance()->getFrontEndMapper();
      for (auto& yScanner : getInstance().yScanners()) {
        auto& pixelMasks = yScanner.pixelMasks();
        int moduleID = pixelMasks.getModuleID();
        unsigned numChannels = pixelMasks.getNumPixels();
        for (unsigned channel = 0; channel < numChannels; channel++) {
          const auto* fe = fe_mapper.getMap(moduleID, channel / 128);
          if (not fe) {
            B2ERROR("TOPRecoManager::setUncalibratedChannelsOff no front-end map found");
            continue;
          }
          auto scrodID = fe->getScrodID();
          const auto* sampleTimes = timebase->getSampleTimes(scrodID, channel);
          if (sampleTimes->isCalibrated()) continue;
          int pixelID = ch_mapper.getPixelID(channel);
          pixelMasks.setPixelOff(pixelID);
        }
      }
      getInstance().m_redoBkg = true;
 
      B2INFO("TOPRecoManager: timebase-uncalibrated channels have been masked off");
    }

◆ yScanners()

std::vector< YScanner > & yScanners ( )

inlineprivate

Interface to y-scanners of all modules.

Any accesses to underlying collection must be made with this method.

Returns: collection of y-scanners (index = moduleID - 1)

Definition at line 227 of file TOPRecoManager.h.

    {
      if (m_yScanners.empty()) set();
      return m_yScanners;
    }

Member Data Documentation

◆ m_backgroundPDFs

std::vector<BackgroundPDF> m_backgroundPDFs

private

collection of background PDF's

Definition at line 206 of file TOPRecoManager.h.

◆ m_fastRaytracers

std::vector<FastRaytracer> m_fastRaytracers

private

collection of fast raytracers

Definition at line 204 of file TOPRecoManager.h.

◆ m_inverseRaytracers

std::vector<InverseRaytracer> m_inverseRaytracers

private

collection of inverse raytracers

Definition at line 203 of file TOPRecoManager.h.

◆ m_maxTime

double m_maxTime = 0

private

time window upper edge

Definition at line 208 of file TOPRecoManager.h.

◆ m_minTime

double m_minTime = 0

private

time window lower edge

Definition at line 207 of file TOPRecoManager.h.

◆ m_redoBkg

bool m_redoBkg = false

private

flag to signal whether backgroundPDF has to be redone

Definition at line 209 of file TOPRecoManager.h.

◆ m_yScanners

std::vector<YScanner> m_yScanners

private

collection of y-scanners

Definition at line 205 of file TOPRecoManager.h.

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

top/reconstruction_cpp/include/TOPRecoManager.h
top/reconstruction_cpp/src/TOPRecoManager.cc

Static Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Member Function Documentation

◆ backgroundPDFs()

◆ fastRaytracers()

◆ getBackgroundPDF()

◆ getBackgroundPDFs()

◆ getFastRaytracer()

◆ getInstance()

◆ getInverseRaytracer()

◆ getMaxTime()

◆ getMinTime()

◆ getTimeWindowSize()

◆ getYScanner()

◆ inverseRaytracers()

◆ set()

◆ setChannelEffi()

◆ setChannelMask()

◆ setDefaultTimeWindow()

◆ setMirrorCenter()

◆ setTimeWindow()

◆ setUncalibratedChannelsOff() [1/2]

◆ setUncalibratedChannelsOff() [2/2]

◆ yScanners()

Member Data Documentation

◆ m_backgroundPDFs

◆ m_fastRaytracers

◆ m_inverseRaytracers

◆ m_maxTime

◆ m_minTime

◆ m_redoBkg

◆ m_yScanners