---

DDSpecifics Class Reference

used to attach specific (user defined) data to nodes in the expanded view. More...

#include <DetectorDescription/Core/interface/DDSpecifics.h>

Inheritance diagram for DDSpecifics:

List of all members.

Public Member Functions
	DDSpecifics (const DDName &name, const selectors_type &partSelections, const DDsvalues_type &svalues, bool doRegex=true)
	Creates a defined reference-object or replaces a already defined reference-object named name.
	DDSpecifics (const DDName &name)
	Creates a initialized reference-object or a reference to an allready defined specifcs.
	DDSpecifics ()
	Creates a uninitialized reference-object (see DDLogicalPart documentation for details on reference objects).
std::pair< bool, DDExpandedView >	node () const
	Calculates the geometrical history of a fully specified PartSelector.
bool	nodes (DDNodes &nds) const
	Calculates all expanded-nodes which are selected by the selection-strings.
const std::vector < DDPartSelection > &	selection () const
	Gives a reference to the collection of part-selections.
const DDsvalues_type &	specifics () const
	Reference to the user-data attached to all nodes selected by the selections-strings given through selection.
	~DDSpecifics ()
Static Public Member Functions
static void	clear ()
Friends
std::ostream &	operator<< (std::ostream &, const DDSpecifics &)

---

Detailed Description

used to attach specific (user defined) data to nodes in the expanded view.

• only a std::map<std::string,std::string> (std::map of name,value) Interface to attach user specific data to nodes in the expanded-view User data (currently only of type a std::map<std::string,std::string> ) can be attached to single nodes or set of nodes in the detector tree (represented in DDExpandedView). Nodes where user data has to be attached are selected by a very simplified XPath similar notation.

DDSpecifics are lightweighted reference-objects. For further information concerning reference-objects refere to the documentation of DDLogicalPart.

Definition at line 40 of file DDSpecifics.h.

---

Constructor & Destructor Documentation

DDSpecifics::DDSpecifics

(

)

Creates a uninitialized reference-object (see DDLogicalPart documentation for details on reference objects).

Definition at line 16 of file DDSpecifics.cc.

                         : DDBase<DDName,Specific*>()
{ }

DDSpecifics::DDSpecifics

(

const DDName &

name

)

Creates a initialized reference-object or a reference to an allready defined specifcs.

If a DDSpecifics with name was already defined, this constructor creates a lightweighted reference-object to it. Otherwise a (default) initialized reference-object is registered named name. For further details concerning the usage of reference-objects refere to the documentation of DDLogicalPart.

Definition at line 20 of file DDSpecifics.cc.

References DDI::Singleton< I >::instance(), and DDBase< DDName, DDI::Specific * >::prep_.

                                            : DDBase<DDName,Specific*>()
{
  prep_ = StoreT::instance().create(name);
}

DDSpecifics::DDSpecifics	(	const DDName &	name,
		const selectors_type &	partSelections,
		const DDsvalues_type &	svalues,
		bool	doRegex = true
	)

Creates a defined reference-object or replaces a already defined reference-object named name.

• name unique name
• partSelections collection of selection-strings which select expanded-nodes
• svalues user data attached to nodes selected by partSelections

Syntax of the selection std::string

bla, bla, bla

Definition at line 26 of file DDSpecifics.cc.

References DCOUT, DDI::Singleton< I >::instance(), it, DDBase< DDName, DDI::Specific * >::prep_, DDBase< DDName, DDI::Specific * >::rep(), and v.

 : DDBase<DDName,Specific*>()
{
  prep_ = StoreT::instance().create(name, new Specific(partSelections,svalues,doRegex));   
  typedef std::vector<std::pair<DDLogicalPart,std::pair<DDPartSelection*,DDsvalues_type*> > > strange_type;
  strange_type v;
  rep().updateLogicalPart(v);
  strange_type::iterator it = v.begin();
  for(; it != v.end(); ++it) {
    if (it->first.isDefined().second) {
      it->first.addSpecifics(it->second);
      DCOUT('C', "add specifics to LP: partsel=" << *(it->second.first) );
    }
    else {
      std::string serr("Definition of LogicalPart missing! name=");
      serr+= std::string(it->first.ddname());
      throw DDException(serr);
    }
  }
} 

DDSpecifics::~DDSpecifics

(

)

Definition at line 51 of file DDSpecifics.cc.

{ }

---

Member Function Documentation

void DDSpecifics::clear

(

void

)

[static]

Reimplemented from DDBase< DDName, DDI::Specific * >.

Definition at line 83 of file DDSpecifics.cc.

References DDI::Singleton< I >::instance().

Referenced by DDCompactView::clear().

{
 StoreT::instance().clear();
}

std::pair< bool, DDExpandedView > DDSpecifics::node

(

)

const

Calculates the geometrical history of a fully specified PartSelector.

node() will only work, if

• there is only one PartSelection std::string
• the PartSelection std::string specifies exactly one full path concatenating always direct children including their copy-number and will return (true,const DDGeoHistory&) if the std::string matches an expanded-part in the ExpandedView, else it will return (false, xxx), whereas xxx is a history which is not valid.

Definition at line 78 of file DDSpecifics.cc.

References DDBase< DDName, DDI::Specific * >::rep().

{
  return rep().node();
}

bool DDSpecifics::nodes

(

DDNodes &

nds

)

const

Calculates all expanded-nodes which are selected by the selection-strings.

Definition at line 65 of file DDSpecifics.cc.

References DDBase< DDName, DDI::Specific * >::rep().

{
   return rep().nodes(result);
}

const std::vector< DDPartSelection > & DDSpecifics::selection

(

)

const

Gives a reference to the collection of part-selections.

Definition at line 54 of file DDSpecifics.cc.

References DDBase< DDName, DDI::Specific * >::rep().

Referenced by DDDToPersFactory::specpar(), and DDStreamer::specs_write().

{ 
  return rep().selection(); 
}

const DDsvalues_type & DDSpecifics::specifics

(

)

const

Reference to the user-data attached to all nodes selected by the selections-strings given through selection.

Definition at line 60 of file DDSpecifics.cc.

References DDBase< DDName, DDI::Specific * >::rep().

Referenced by DDDToPersFactory::specpar(), and DDStreamer::specs_write().

{ 
  return rep().specifics(); 
}         

---

Friends And Related Function Documentation

std::ostream& operator<<	(	std::ostream &	os,
		const DDSpecifics &	sp
	)			[friend]

Definition at line 89 of file DDSpecifics.cc.

{
  DDBase<DDName,DDI::Specific*>::def_type defined(sp.isDefined());
  if (defined.first) {
    os << *(defined.first) << " ";
    if (defined.second) {
      sp.rep().stream(os); 
    }
    else {
      os << "* specific not defined * ";  
    }
  }  
  else {
    os << "* specific not declared * ";  
  }  
  return os;

}

---

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

• DetectorDescription/Core/interface/DDSpecifics.h
• DetectorDescription/Core/src/DDSpecifics.cc

---