reco::PFBlock Class Reference

Block of elements. More...

#include <PFBlock.h>

Classes
struct	Link

Public Types
typedef edm::OwnVector< reco::PFBlockElement >::const_iterator	IE
typedef std::map< unsigned int, Link >	LinkData
enum	LinkTest { LINKTEST_RECHIT, LINKTEST_NLINKTEST, LINKTEST_ALL }

Public Member Functions
void	addElement (reco::PFBlockElement *element)
void	associatedElements (unsigned i, const LinkData &linkData, std::multimap< double, unsigned > &sortedAssociates, reco::PFBlockElement::Type type=PFBlockElement::NONE, LinkTest test=LINKTEST_RECHIT) const
void	bookLinkData ()
double	dist (unsigned ie1, unsigned ie2, const LinkData &linkData, LinkTest test) const
double	dist (unsigned ie1, unsigned ie2, const LinkData &linkData) const
const edm::OwnVector< reco::PFBlockElement > &	elements () const
const LinkData &	linkData () const
LinkData &	linkData ()
bool	matrix2vector (unsigned i, unsigned j, unsigned &index) const
	PFBlock ()
void	setLink (unsigned i1, unsigned i2, double dist, LinkData &linkData, LinkTest test=LINKTEST_RECHIT) const

Private Member Functions
unsigned	linkDataSize () const

Private Attributes
edm::OwnVector< reco::PFBlockElement >	elements_
	all elements More...
LinkData	linkData_
	link data (permanent) More...

Detailed Description

Block of elements.

Author

Colin Bernet

Date

January 2006

A PFBlock is:

• a set of topologically connected elements.
• a set of links between these elements

Definition at line 26 of file PFBlock.h.

Member Typedef Documentation

IE

typedef edm::OwnVector<reco::PFBlockElement>::const_iterator reco::PFBlock::IE

Definition at line 35 of file PFBlock.h.

LinkData

typedef std::map<unsigned int, Link> reco::PFBlock::LinkData

Definition at line 39 of file PFBlock.h.

Member Enumeration Documentation

LinkTest

enum reco::PFBlock::LinkTest

Enumerator
LINKTEST_RECHIT
LINKTEST_NLINKTEST
LINKTEST_ALL

Definition at line 41 of file PFBlock.h.

{ LINKTEST_RECHIT, LINKTEST_NLINKTEST, LINKTEST_ALL };

Constructor & Destructor Documentation

PFBlock()

reco::PFBlock::PFBlock ( )

inline

Definition at line 43 of file PFBlock.h.

{}

Member Function Documentation

addElement()

void PFBlock::addElement

(

reco::PFBlockElement *

element

)

add an element to the current PFBlock the block will keep a copy.

Definition at line 11 of file PFBlock.cc.

References reco::PFBlockElement::clone(), reco::PFBlockElement::lock(), and reco::PFBlockElement::setIndex().

                                                {
  element->setIndex(elements_.size());
  element->lock();
  elements_.push_back(element->clone());
}

associatedElements()

void PFBlock::associatedElements	(	unsigned	i,
		const LinkData &	linkData,
		std::multimap< double, unsigned > &	sortedAssociates,
		reco::PFBlockElement::Type	type = PFBlockElement::NONE,
		LinkTest	test = LINKTEST_RECHIT
	)		const

lock an element ( unlink it from the others ) Colin: this function is misleading void lock(unsigned i, LinkData& linkData ) const; fills a map with the elements associated to element i. elements are sorted by increasing distance. if specified, only the elements of type "type" will be considered if specified, only the link calculated from a certain "test" will be considered: distance test, etc..

Definition at line 60 of file PFBlock.cc.

References mps_fire::i, caHitNtupletGeneratorKernels::if(), NONE, and ctpps_dqm_sourceclient-live_cfg::test.

                                                      {
  sortedAssociates.clear();

  // i is too large
  if (i > elements_.size())
    return;
  // assert(i>=0); i >= 0, since i is unsigned

  for (unsigned ie = 0; ie < elements_.size(); ie++) {
    // considered element itself
    if (ie == i) {
      continue;
    }
    // not the right type
    if (type != PFBlockElement::NONE && elements_[ie].type() != type) {
      continue;
    }

    // Order the elements by increasing distance !

    unsigned index = 0;
    if (!matrix2vector(i, ie, index))
      continue;

    double c2 = -1;
    LinkData::const_iterator it = linkData.find(index);
    if (it != linkData.end() && (((1 << test) & it->second.test) != 0 || (test == LINKTEST_ALL)))
      c2 = it->second.distance;

    // not associated
    if (c2 < 0) {
      continue;
    }

    sortedAssociates.insert(pair<double, unsigned>(c2, ie));
  }
}

bookLinkData()

void PFBlock::bookLinkData

(

)

Definition at line 17 of file PFBlock.cc.

{}

dist() [1/2]

double reco::PFBlock::dist ( unsigned  ie1, unsigned  ie2, const LinkData &  linkData, LinkTest  test  ) const

inline

Returns

distance of link

Definition at line 77 of file PFBlock.h.

References linkData().

                                                                                           {
      return dist(ie1, ie2, linkData);
    }

dist() [2/2]

double PFBlock::dist	(	unsigned	ie1,
		unsigned	ie2,
		const LinkData &	linkData
	)		const

Returns

distance of link

Definition at line 122 of file PFBlock.cc.

                                                                               {
  double Dist = -1;

  unsigned index = 0;
  if (!matrix2vector(ie1, ie2, index))
    return Dist;
  LinkData::const_iterator it = linkData.find(index);
  if (it != linkData.end())
    Dist = it->second.distance;

  return Dist;
}

elements()

const edm::OwnVector<reco::PFBlockElement>& reco::PFBlock::elements ( ) const

inline

Returns

elements

Definition at line 85 of file PFBlock.h.

References elements_.

Referenced by FWPFBlockProxyBuilder::buildViewType().

{ return elements_; }

linkData() [1/2]

const LinkData& reco::PFBlock::linkData ( ) const

inline

Returns

link data

Definition at line 88 of file PFBlock.h.

References linkData_.

Referenced by dist().

{ return linkData_; }

linkData() [2/2]

LinkData& reco::PFBlock::linkData ( )

inline

Returns

link data

Definition at line 91 of file PFBlock.h.

References linkData_.

{ return linkData_; }

linkDataSize()

unsigned PFBlock::linkDataSize ( ) const

private

Returns

size of linkData_, calculated from the number of elements

Definition at line 323 of file PFBlock.cc.

References dqmiodumpmetadata::n.

                                     {
  unsigned n = elements_.size();

  // number of possible undirected links between n elements.
  // reflective links impossible.

  return n * (n - 1) / 2;
}

matrix2vector()

bool PFBlock::matrix2vector	(	unsigned	i,
		unsigned	j,
		unsigned &	index
	)		const

makes the correspondance between a 2d element matrix and the 1D vector which is the most compact way to store the matrix

Definition at line 102 of file PFBlock.cc.

References combine::missing, findQualityFiles::size, and std::swap().

                                                                                   {
  unsigned size = elements_.size();
  if (iindex == jindex || iindex >= size || jindex >= size) {
    return false;
  }

  if (iindex > jindex)
    std::swap(iindex, jindex);

  index = jindex - iindex - 1;

  if (iindex > 0) {
    index += iindex * size;
    unsigned missing = iindex * (iindex + 1) / 2;
    index -= missing;
  }

  return true;
}

setLink()

void PFBlock::setLink	(	unsigned	i1,
		unsigned	i2,
		double	dist,
		LinkData &	linkData,
		LinkTest	test = LINKTEST_RECHIT
	)		const

set a link between elements of indices i1 and i2, of "distance" dist the link is set in the linkData vector provided as an argument. As indicated by the 'const' statement, 'this' is not modified.

Definition at line 19 of file PFBlock.cc.

References cms::cuda::assert(), testProducerWithPsetDescEmpty_cfi::i1, testProducerWithPsetDescEmpty_cfi::i2, MainPageGenerator::l, convertSQLiteXML::ok, and ctpps_dqm_sourceclient-live_cfg::test.

                                                                                                    {
  assert(test < LINKTEST_ALL);

  unsigned index = 0;
  bool ok = matrix2vector(i1, i2, index);

  if (ok) {
    //ignore the  -1, -1 pair
    if (Dist > -0.5) {
      Link& l = linkData[index];
      l.distance = Dist;
      l.test |= (1 << test);
    } else  //delete if existing
    {
      LinkData::iterator it = linkData.find(index);
      if (it != linkData.end())
        linkData.erase(it);
    }

  } else {
    assert(0);
  }
}

Member Data Documentation

elements_

edm::OwnVector<reco::PFBlockElement> reco::PFBlock::elements_

private

all elements

Definition at line 101 of file PFBlock.h.

Referenced by elements().

linkData_

LinkData reco::PFBlock::linkData_

private

link data (permanent)

Definition at line 98 of file PFBlock.h.

Referenced by linkData().