|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
|
#ifndef DETECTOR_DESCRIPTION_CORE_DDSPECIFICS_H
#define DETECTOR_DESCRIPTION_CORE_DDSPECIFICS_H
#include <iosfwd>
#include <map>
#include <memory>
#include <string>
#include <utility>
#include <vector>
#include "DetectorDescription/Core/interface/DDBase.h"
#include "DetectorDescription/Core/interface/DDExpandedView.h"
#include "DetectorDescription/Core/interface/DDName.h"
#include "DetectorDescription/Core/interface/DDsvalues.h"
class DDExpandedView;
class DDPartSelection;
class DDSpecifics;
namespace DDI {
class Specific;
}
std::ostream &operator<<(std::ostream &, const std::vector<std::string> &);
std::ostream &operator<<(std::ostream &, const DDSpecifics &);
/**
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 \c 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.
*/
class DDSpecifics : public DDBase<DDName, std::unique_ptr<DDI::Specific> > {
friend std::ostream &operator<<(std::ostream &, const DDSpecifics &);
public:
//! Creates a uninitialized reference-object (see DDLogicalPart documentation for details on reference objects)
DDSpecifics();
//! Creates a initialized reference-object or a reference to an allready defined specifcs.
/** If a DDSpecifics with \a name was already defined, this constructor creates a
lightweighted reference-object to it. Otherwise a (default) initialized reference-object
is registered named \a name.
For further details concerning the usage of reference-objects refere
to the documentation of DDLogicalPart.
*/
DDSpecifics(const DDName &name);
//! Creates a defined reference-object or replaces a already defined reference-object named \a name
/**
\arg \c name unique name
\arg \c partSelections collection of selection-strings which select expanded-nodes
\arg \c svalues user data attached to nodes selected by \a partSelections
<h3> Syntax of the selection std::string </h3>
bla, bla, bla
*/
DDSpecifics(const DDName &name,
const std::vector<std::string> &partSelections,
const DDsvalues_type &svalues,
bool doRegex = true);
//! Gives a reference to the collection of part-selections
const std::vector<DDPartSelection> &selection() const;
//! Reference to the user-data attached to all nodes selected by the selections-strings given through selection
const DDsvalues_type &specifics() const;
//! Calculates the geometrical history of a fully specified PartSelector
std::pair<bool, DDExpandedView> node() const;
};
#endif
|