TOPRecoManager Class Reference

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

#include <TOPRecoManager.h>

Collaboration diagram for TOPRecoManager:

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.

{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.

{return getMaxTime() - getMinTime();}

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) {
            B2INFO("TOPRecoManager::setChannelEffi: relative pixel efficiency found rather small"
                   << LogVar("slot", moduleID)
                   << LogVar("pixel", pixelID)
                   << LogVar("efficiency", effi)
                   << " -> will be set to " << minEffi);
            effi = minEffi;
          } else if (effi > maxEffi) {
            B2INFO("TOPRecoManager::setChannelEffi: relative pixel efficiency found rather large"
                   << LogVar("slot", moduleID)
                   << LogVar("pixel", pixelID)
                   << LogVar("efficiency", effi)
                   << " -> will be set 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