FPGATrackSimRegionMap Class Reference

#include <FPGATrackSimRegionMap.h>

Collaboration diagram for FPGATrackSimRegionMap:

Public Member Functions
	FPGATrackSimRegionMap (FPGATrackSimPlaneMap const *pmap, std::string const &filepath)
void	loadModuleIDLUT (std::string const &filepath)
void	loadRadiiFile (std::string const &radii_file)
const FPGATrackSimPlaneMap *	getPlaneMap () const
int	getNRegions () const
bool	isModuleIDLUTloaded () const
const FPGATrackSimRegionBoundaries &	getRegionBoundaries (int region, int layer, int section) const
bool	isInRegion (uint32_t region, const FPGATrackSimHit &hit) const
bool	isInRegion (uint32_t region, uint32_t plane, uint32_t section, int eta, int phi) const
std::vector< uint32_t >	getRegions (const FPGATrackSimHit &hit) const
uint32_t	getUnmappedID (uint32_t region, const FPGATrackSimHit &hit) const
uint32_t	getLocalID (uint32_t region, uint32_t layer, uint32_t globalModuleID) const
uint32_t	getGlobalID (uint32_t region, uint32_t layer, uint32_t localModuleID) const
double	getAvgRadius (unsigned region, unsigned layer) const
const std::vector< double > &	getAvgRadii (unsigned region) const

Private Member Functions
void	allocateMap (std::ifstream &fin)
void	readRegion (std::ifstream &fin, int expected_region)

Private Attributes
const FPGATrackSimPlaneMap *	m_pmap = nullptr
int	m_nregions = 0
std::vector< std::vector< std::vector< FPGATrackSimRegionBoundaries > > >	m_map
std::vector< std::vector< std::map< uint32_t, uint32_t > > >	m_global_local_map
std::vector< std::vector< double > >	m_radii_map

Detailed Description

Definition at line 61 of file FPGATrackSimRegionMap.h.

Constructor & Destructor Documentation

FPGATrackSimRegionMap()

FPGATrackSimRegionMap::FPGATrackSimRegionMap	(	FPGATrackSimPlaneMap const *	pmap,
		std::string const &	filepath
	)

Definition at line 29 of file FPGATrackSimRegionMap.cxx.

                                                                                                         :
    m_pmap(pmap)
{
    // Open the file
    ANA_MSG_INFO("Reading " << filepath);
    ifstream fin(filepath);
    if (!fin.is_open())
    {
        ANA_MSG_FATAL("Couldn't open " << filepath);
        throw ("FPGATrackSimRegionMap Couldn't open " + filepath);
    }
 
    // Reads the header of the file to resize all the vector members
    allocateMap(fin);
 
    // Read all the region data
    for (int region = 0; region < m_nregions; region++) readRegion(fin, region);
}

Member Function Documentation

allocateMap()

void FPGATrackSimRegionMap::allocateMap ( std::ifstream &  fin )

private

Definition at line 50 of file FPGATrackSimRegionMap.cxx.

{
    string line, towerKey;
    bool ok = true;
 
    ok = ok && getline(fin, line);
    ANA_MSG_DEBUG(line << " <  " << ok);
 
    istringstream sline(line);
    ok = ok && (sline >> towerKey >> m_nregions);
    ok = ok && (towerKey == "towers");
 
 
    if (!ok) ANA_MSG_FATAL("Error reading header");
 
    m_map.resize(m_nregions);
    for (auto & vv : m_map)
    {
        vv.resize(m_pmap->getNLogiLayers());
        for (size_t l = 0; l < vv.size(); l++) vv[l].resize(m_pmap->getNSections(l));
    }
}

getAvgRadii()

const std::vector<double>& FPGATrackSimRegionMap::getAvgRadii ( unsigned  region ) const

inline

Definition at line 103 of file FPGATrackSimRegionMap.h.

{ return m_radii_map.at(region); };

getAvgRadius()

double FPGATrackSimRegionMap::getAvgRadius	(	unsigned	region,
		unsigned	layer
	)		const

Definition at line 349 of file FPGATrackSimRegionMap.cxx.

                                                                                {
 
    if (region >= m_radii_map.size() || layer >= m_pmap->getNLogiLayers())
    {
        ANA_MSG_ERROR("getAvgRadius() bad region=" << region << " or layer=" << layer);
        return -1;
    }
 
    // Return the radius we loaded for this region.
    return m_radii_map[region][layer];
}

getGlobalID()

uint32_t FPGATrackSimRegionMap::getGlobalID	(	uint32_t	region,
		uint32_t	layer,
		uint32_t	localModuleID
	)		const

Definition at line 334 of file FPGATrackSimRegionMap.cxx.

{
    if (region >= m_global_local_map.size() || layer >= m_pmap->getNLogiLayers())
    {
        ANA_MSG_ERROR("getGlobalID() bad region=" << region << " or layer=" << layer);
        return -1;
    }
 
    for (auto const & g_l : m_global_local_map[region][layer])
        if (g_l.second == localModuleID) return g_l.first;
 
    ANA_MSG_ERROR("getGlobalID() Did not find global id for region " << region << ", layer " << layer << ", localID " << localModuleID);
    return -1;
}

getLocalID()

uint32_t FPGATrackSimRegionMap::getLocalID	(	uint32_t	region,
		uint32_t	layer,
		uint32_t	globalModuleID
	)		const

Definition at line 325 of file FPGATrackSimRegionMap.cxx.

{
    // TEMPORARY UNTIL WE HAVE A MODULE LUT
    (void) region;
    (void) layer;
    return globalModuleID & 0x3ff;
}

getNRegions()

int FPGATrackSimRegionMap::getNRegions ( ) const

inline

Definition at line 79 of file FPGATrackSimRegionMap.h.

{ return m_nregions; }

getPlaneMap()

const FPGATrackSimPlaneMap* FPGATrackSimRegionMap::getPlaneMap ( ) const

inline

Definition at line 77 of file FPGATrackSimRegionMap.h.

{ return m_pmap; }

getRegionBoundaries()

const FPGATrackSimRegionBoundaries& FPGATrackSimRegionMap::getRegionBoundaries ( int  region, int  layer, int  section  ) const

inline

Definition at line 86 of file FPGATrackSimRegionMap.h.

            { return m_map.at(region).at(layer).at(section); }

getRegions()

std::vector< uint32_t > FPGATrackSimRegionMap::getRegions

(

const FPGATrackSimHit &

hit

)

const

Definition at line 259 of file FPGATrackSimRegionMap.cxx.

{
    std::vector<uint32_t> regions;
    for (uint32_t region = 0; region < m_map.size(); region++)
        if (isInRegion(region, hit))
            regions.push_back(region);
    return regions;
}

getUnmappedID()

uint32_t FPGATrackSimRegionMap::getUnmappedID	(	uint32_t	region,
		const FPGATrackSimHit &	hit
	)		const

Definition at line 268 of file FPGATrackSimRegionMap.cxx.

{
    /*
    Todo: Does this handle EC hits correctly?
 
    error code key:
    6 digit number. 1 = ok. 2 = not ok
 
    1st digit - Endcap Check
    2nd - region
    3rd - layer
    4th - section
    5th - eta
    6th - phi
    */
 
  uint32_t layer   = hit.getLayer();
  uint32_t section = hit.getSection();
  int eta          = hit.getEtaModule();
  int phi          = hit.getPhiModule();
 
    int anyerr = 0;
    int err[] = {1,1,1,1,1,1};
 
    if (region >= m_map.size()) anyerr = err[1] = 2;
 
    if (!anyerr && layer >= m_map[region].size()) anyerr = err[2] = 2;
 
    if (!anyerr && section >= m_map[region][layer].size()) anyerr = err[3] = 2;
 
    if (!anyerr) {
      int eta_min = m_map[region][layer][section].eta_min;
      int eta_max = m_map[region][layer][section].eta_max;
 
      if (eta < eta_min) err[4] = 3;
      if (eta > eta_max) err[4] = 2;
 
      int phi_min = m_map[region][layer][section].phi_min;
      int phi_max = m_map[region][layer][section].phi_max;
 
      // Need special cases for phi berrause it can go from 2pi to 0.
      if (phi_min <= phi_max) // Region does not cross phi = 0
      {
        if (phi < phi_min || phi > phi_max) err[5] = 2;
      }
      else // Region crosses phi = 0
      {
        if (phi < phi_min && phi > phi_max) err[5] = 3;
      }
    }
 
    int error_code = 100000*err[0] + 10000*err[1] + 1000*err[2] + 100*err[3] + 10*err[4] + err[5];
 
    return error_code;
}

isInRegion() [1/2]

bool FPGATrackSimRegionMap::isInRegion	(	uint32_t	region,
		const FPGATrackSimHit &	hit
	)		const

Definition at line 217 of file FPGATrackSimRegionMap.cxx.

{
    // To avoid confusion and double-counting, by convention, always use the coordinates of the inner hit
    // when testing if a spacepoint is in a (sub)region.
    if (hit.getHitType() == HitType::spacepoint) {
        return isInRegion(region, hit.getPairedLayer(), hit.getPairedSection(), hit.getPairedEtaModule(), hit.getPairedPhiModule());
    } else {
        return isInRegion(region, hit.getLayer(), hit.getSection(), hit.getEtaModule(), hit.getPhiModule());
    }
}

isInRegion() [2/2]

bool FPGATrackSimRegionMap::isInRegion	(	uint32_t	region,
		uint32_t	plane,
		uint32_t	section,
		int	eta,
		int	phi
	)		const

Definition at line 229 of file FPGATrackSimRegionMap.cxx.

{
    if (    region  >= m_map.size()
         || layer   >= m_map[region].size()
         || section >= m_map[region][layer].size() )
    {
        return false;
    }
 
    int eta_min = m_map[region][layer][section].eta_min;
    int eta_max = m_map[region][layer][section].eta_max;
 
    if (eta < eta_min || eta > eta_max) return false;
 
    int phi_min = m_map[region][layer][section].phi_min;
    int phi_max = m_map[region][layer][section].phi_max;
 
    // Need special cases for phi because it can go from 2pi to 0.
    if (phi_min <= phi_max) // Region does not cross phi = 0
    {
        if (phi < phi_min || phi > phi_max) return false;
    }
    else // Region crosses phi = 0
    {
        if (phi < phi_min && phi > phi_max) return false;
    }
 
    return true;
}

isModuleIDLUTloaded()

bool FPGATrackSimRegionMap::isModuleIDLUTloaded ( ) const

inline

Definition at line 81 of file FPGATrackSimRegionMap.h.

{ return !m_global_local_map.empty(); }

loadModuleIDLUT()

void FPGATrackSimRegionMap::loadModuleIDLUT

(

std::string const &

filepath

)

Definition at line 120 of file FPGATrackSimRegionMap.cxx.

{
    ANA_MSG_INFO("Reading module LUT" << filepath);
    ifstream fin(filepath);
    if (!fin.is_open())
    {
        ANA_MSG_ERROR("Couldn't open " << filepath);
        throw ("FPGATrackSimRegionMap Couldn't open " + filepath);
    }
 
    m_global_local_map.clear();
    m_global_local_map.resize(m_nregions, vector<map<uint32_t, uint32_t>>(m_pmap->getNLogiLayers()));
 
    string line;
    while (getline(fin, line))
    {
        uint32_t region, layer, globalID, localID;
        istringstream sline(line);
 
        if (!(sline >> region >> layer >> globalID >> localID))
            ANA_MSG_WARNING("Error reading module LUT");
        else if (region >= m_global_local_map.size() || layer >= m_pmap->getNLogiLayers())
            ANA_MSG_WARNING("loadModuleIDLUT() bad region=" << region << " or layer=" << layer);
        else
            m_global_local_map[region][layer][globalID] = localID;
    }
}

loadRadiiFile()

void FPGATrackSimRegionMap::loadRadiiFile

(

std::string const &

radii_file

)

Definition at line 149 of file FPGATrackSimRegionMap.cxx.

{
 
    // Resize the radius structure  appropriately.
    m_radii_map.clear();
    m_radii_map.resize(m_nregions, std::vector<double>(m_pmap->getNLogiLayers()));
 
    // Open the file
    std::ifstream fin(filepath);
    if (!fin.is_open())
    {
        ANA_MSG_FATAL("Couldn't open radius file " << filepath);
    }
 
    // Variables to fill
    std::string line;
    bool ok = true;
    double r = 0.0;
 
    // Parse the file
    while (getline(fin, line))
    {
        if (line.empty() || line[0] == '#') continue;
        std::istringstream sline(line);
        std::vector<int> shifts;
 
        int subregion{-1};
        ok = ok && (sline >> subregion);
 
        // The radii file contains an "inclusive" line and then one for each subregion.
        // If we only have one region (because we are the rmap or because we are a subrmap
        // with one z-slice) then we only want to read the inclusive line.
        // Otherwise we want to read everything BUT the inclusive line.
        if (m_nregions == 1 && subregion != -1) {
            continue;
        }
        if (m_nregions > 1 && subregion == -1) {
            continue;
        }
 
        for (unsigned layer = 0; layer < m_pmap->getNLogiLayers(); layer++) {
            ok = ok && (sline >> r);
            if (!ok) break;
            if (r<=0) {
                ANA_MSG_WARNING("Radius in radiiFile is "<< r <<" for layer: " << layer << " setting to dummy value!");
                r = 500.0; // dummy value that won't cause a crash, but won't work anywhere.
            }
            if (subregion == -1) {
                m_radii_map[0][layer] = r;
            } else {
                m_radii_map[subregion][layer] = r;
            }
        }
 
        if (!ok) break;
    }
 
    if (!ok)
    {
        ANA_MSG_FATAL("Found error reading file at line: " << line);
    }
}

readRegion()

void FPGATrackSimRegionMap::readRegion ( std::ifstream &  fin, int  expected_region  )

private

Definition at line 75 of file FPGATrackSimRegionMap.cxx.

{
    string line, dummy;
    bool ok = true;
    int region = -1;
    uint32_t linesRead = 0; // detLayer lines read
 
    while (getline(fin, line))
    {
        if (line.empty() || line[0] == '#') continue;
        istringstream sline(line);
 
        if (region < 0) // Find the starting header of the next region
        {
            ok = ok && (sline >> region);// should check this is a sensible number
            ok = ok && !(sline >> dummy); // No keyword to check that we're not reading a detector line, so make sure rest of string is empty
            ok = ok && (region == expected_region);
            if (!ok) break;
        }
        else // Detector layer line
        {
            int isPix{}, BEC{}, physLayer{}, phi_min{}, phi_max{}, phi_tot{}, eta_min{}, eta_max{}, eta_tot{};
            //should check these are within sensible limits after they are read
            ok = ok && (sline >> isPix >> BEC >> physLayer >> phi_min >> phi_max >> phi_tot >> eta_min >> eta_max >> eta_tot);
            if (!ok) break;
 
            int logiLayer = m_pmap->getLayerSection(static_cast<SiliconTech>(isPix), static_cast<DetectorZone>(BEC), physLayer).layer;
            int section   = m_pmap->getLayerSection(static_cast<SiliconTech>(isPix), static_cast<DetectorZone>(BEC), physLayer).section;
 
            if (logiLayer > -1)
                m_map[region][logiLayer][section] = { phi_min, phi_max, eta_min, eta_max };
 
            if (++linesRead == m_pmap->getNDetLayers()) break;
        }
    }
 
    if (!ok)
    {
        ANA_MSG_FATAL("Found error reading file at line: " << line);
        throw "FPGATrackSimRegionMap read error";
    }
}

Member Data Documentation

m_global_local_map

std::vector<std::vector<std::map<uint32_t, uint32_t> > > FPGATrackSimRegionMap::m_global_local_map

private

Definition at line 113 of file FPGATrackSimRegionMap.h.

m_map

std::vector<std::vector<std::vector<FPGATrackSimRegionBoundaries> > > FPGATrackSimRegionMap::m_map

private

Definition at line 110 of file FPGATrackSimRegionMap.h.

m_nregions

int FPGATrackSimRegionMap::m_nregions = 0

private

Definition at line 108 of file FPGATrackSimRegionMap.h.

m_pmap

const FPGATrackSimPlaneMap* FPGATrackSimRegionMap::m_pmap = nullptr

private

Definition at line 107 of file FPGATrackSimRegionMap.h.

m_radii_map

std::vector<std::vector<double> > FPGATrackSimRegionMap::m_radii_map

private

Definition at line 116 of file FPGATrackSimRegionMap.h.

---

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

• FPGATrackSimRegionMap.h
• FPGATrackSimRegionMap.cxx