DD4hep  1.30.0
Detector Description Toolkit for High Energy Physics
CartesianGridXYStaggered.cpp
Go to the documentation of this file.
1 //==========================================================================
2 // AIDA Detector description implementation
3 //--------------------------------------------------------------------------
4 // Copyright (C) Organisation europeenne pour la Recherche nucleaire (CERN)
5 // All rights reserved.
6 //
7 // For the licensing terms see $DD4hepINSTALL/LICENSE.
8 // For the list of contributors see $DD4hepINSTALL/doc/CREDITS.
9 //
10 // Created: Sept 15, 2023
11 // Author: Sebouh J. Paul, UCR
12 //
13 //==========================================================================
14 
17 
18 namespace dd4hep {
19 
20  namespace DDSegmentation {
21 
24  : CartesianGrid(cellEncoding)
25 {
26  // define type and description
27  _type = "CartesianGridXYStaggered";
28  _description = "Cartesian segmentation in the local XY-plane, with options for staggering";
29 
30  // register all necessary parameters
31  registerParameter("grid_size_x", "Cell size in X", _gridSizeX, 1., SegmentationParameter::LengthUnit);
32  registerParameter("grid_size_y", "Cell size in Y", _gridSizeY, 1., SegmentationParameter::LengthUnit);
33  registerParameter("offset_x", "Cell offset in X", _offsetX, 0., SegmentationParameter::LengthUnit, true);
34  registerParameter("offset_y", "Cell offset in Y", _offsetY, 0., SegmentationParameter::LengthUnit, true);
35  registerParameter("stagger_x", "Option to stagger the layers in x (ie, add grid_size_x/2 to offset_x for odd layers)",
37  registerParameter("stagger_y", "Option to stagger the layers in y (ie, add grid_size_y/2 to offset_y for odd layers)",
39  registerIdentifier("identifier_x", "Cell ID identifier for X", _xId, "x");
40  registerIdentifier("identifier_y", "Cell ID identifier for Y", _yId, "y");
41  registerParameter("stagger_keyword", "Volume ID identifier used for determining which volumes to stagger",
42  _staggerKeyword, (std::string)"layer", SegmentationParameter::NoUnit, true);
43 }
44 
47  CartesianGrid(decode)
48 {
49  // define type and description
50  _type = "CartesianGridXYStaggered";
51  _description = "Cartesian segmentation in the local XY-plane, with options for staggering";
52 
53  // register all necessary parameters
54  registerParameter("grid_size_x", "Cell size in X", _gridSizeX, 1., SegmentationParameter::LengthUnit);
55  registerParameter("grid_size_y", "Cell size in Y", _gridSizeY, 1., SegmentationParameter::LengthUnit);
56  registerParameter("offset_x", "Cell offset in X", _offsetX, 0., SegmentationParameter::LengthUnit, true);
57  registerParameter("offset_y", "Cell offset in Y", _offsetY, 0., SegmentationParameter::LengthUnit, true);
58  registerParameter("stagger_x", "Option to stagger the layers in x (ie, add grid_size_x/2 to offset_x for odd layers)",
60  registerParameter("stagger_y", "Option to stagger the layers in y (ie, add grid_size_y/2 to offset_y for odd layers)",
62  registerIdentifier("identifier_x", "Cell ID identifier for X", _xId, "x");
63  registerIdentifier("identifier_y", "Cell ID identifier for Y", _yId, "y");
64  registerParameter("stagger_keyword", "Volume ID identifier used for determining which volumes to stagger",
65  _staggerKeyword, (std::string)"layer", SegmentationParameter::NoUnit, true);
66 }
67 
70 
71 }
72 
75  Vector3D cellPosition;
76  if (_staggerX || _staggerY){
77  int layer= _decoder->get(cID,_staggerKeyword);
78  cellPosition.X = binToPosition( _decoder->get(cID,_xId ), _gridSizeX, _offsetX+_staggerX*_gridSizeX*(layer%2)/2.);
79  cellPosition.Y = binToPosition( _decoder->get(cID,_yId ), _gridSizeY, _offsetY+_staggerY*_gridSizeY*(layer%2)/2.);
80  } else {
81  cellPosition.X = binToPosition( _decoder->get(cID,_xId ), _gridSizeX, _offsetX);
82  cellPosition.Y = binToPosition( _decoder->get(cID,_yId ), _gridSizeY, _offsetY);
83  }
84  return cellPosition;
85 }
86 
89  const Vector3D& /* globalPosition */,
90  const VolumeID& vID) const {
91  CellID cID = vID ;
92  if (_staggerX || _staggerY){
93  int layer= _decoder->get(cID,_staggerKeyword);
94  _decoder->set( cID,_xId, positionToBin(localPosition.X, _gridSizeX, _offsetX+_staggerX*_gridSizeX*(layer%2)/2) );
95  _decoder->set( cID,_yId, positionToBin(localPosition.Y, _gridSizeY, _offsetY+_staggerY*_gridSizeY*(layer%2)/2) );
96  } else {
97  _decoder->set( cID,_xId, positionToBin(localPosition.X, _gridSizeX, _offsetX));
98  _decoder->set( cID,_yId, positionToBin(localPosition.Y, _gridSizeY, _offsetY));
99  }
100  return cID ;
101 }
102 
103 std::vector<double> CartesianGridXYStaggered::cellDimensions(const CellID& /* cellID */) const {
104  return {_gridSizeX, _gridSizeY};
105 }
106 
107 } /* namespace DDSegmentation */
108 } /* namespace dd4hep */
dd4hep::DDSegmentation::VolumeID
uint64_t VolumeID
Definition: BitFieldCoder.h:27
dd4hep::DDSegmentation::CartesianGridXYStaggered::_gridSizeY
double _gridSizeY
the grid size in Y
Definition: CartesianGridXYStaggered.h:131
dd4hep::DDSegmentation::Segmentation::_decoder
const BitFieldCoder * _decoder
The cell ID encoder and decoder.
Definition: Segmentation.h:168
dd4hep::DDSegmentation::Vector3D
Simple container for a physics vector.
Definition: Segmentation.h:48
dd4hep::DDSegmentation::SegmentationParameter::LengthUnit
@ LengthUnit
Definition: SegmentationParameter.h:111
dd4hep::DDSegmentation::BitFieldCoder
Helper class for decoding and encoding a bit field of 64bits for convenient declaration.
Definition: BitFieldCoder.h:114
dd4hep::DDSegmentation::CartesianGridXYStaggered::_staggerKeyword
std::string _staggerKeyword
the keyword used to determine which volumes to stagger
Definition: CartesianGridXYStaggered.h:141
dd4hep::DDSegmentation::BitFieldCoder::get
FieldID get(CellID bitfield, size_t idx) const
Definition: BitFieldCoder.h:165
dd4hep::DDSegmentation::CartesianGridXYStaggered::cellID
virtual CellID cellID(const Vector3D &localPosition, const Vector3D &globalPosition, const VolumeID &volumeID) const
determine the cell ID based on the position
Definition: CartesianGridXYStaggered.cpp:88
dd4hep::DDSegmentation::CartesianGridXYStaggered::_yId
std::string _yId
the field name used for Y
Definition: CartesianGridXYStaggered.h:139
CartesianGridXYStaggered.h
dd4hep::DDSegmentation::CartesianGridXYStaggered::_gridSizeX
double _gridSizeX
the grid size in X
Definition: CartesianGridXYStaggered.h:125
dd4hep::DDSegmentation::CartesianGridXYStaggered::_staggerX
int _staggerX
staggering option in X. 0 = no staggering. 1 = stagger by _gridSizeX/2.0 in odd layers
Definition: CartesianGridXYStaggered.h:129
dd4hep::DDSegmentation::SegmentationParameter::NoUnit
@ NoUnit
Definition: SegmentationParameter.h:111
dd4hep::DDSegmentation::CartesianGridXYStaggered::_xId
std::string _xId
the field name used for X
Definition: CartesianGridXYStaggered.h:137
dd4hep::DDSegmentation::Segmentation::registerParameter
void registerParameter(const std::string &nam, const std::string &desc, TYPE &param, const TYPE &defaultVal, UnitType unitTyp=SegmentationParameter::NoUnit, bool isOpt=false)
Add a parameter to this segmentation. Used by derived classes to define their parameters.
Definition: Segmentation.h:138
dd4hep::DDSegmentation::Vector3D::Y
double Y
Definition: Segmentation.h:71
dd4hep::DDSegmentation::BitFieldCoder::set
void set(CellID &bitfield, size_t idx, FieldID value) const
Definition: BitFieldCoder.h:177
dd4hep::DDSegmentation::CellID
uint64_t CellID
Definition: BitFieldCoder.h:26
dd4hep::DDSegmentation::CartesianGridXYStaggered::_staggerY
int _staggerY
staggering option in Y. 0 = no staggering. 1 = stagger by _gridSizeY/2.0 in odd layers
Definition: CartesianGridXYStaggered.h:135
dd4hep::DDSegmentation::Segmentation::registerIdentifier
void registerIdentifier(const std::string &nam, const std::string &desc, std::string &ident, const std::string &defaultVal)
Add a cell identifier to this segmentation. Used by derived classes to define their required identifi...
Definition: Segmentation.cpp:135
dd4hep::DDSegmentation::CartesianGridXYStaggered::cellDimensions
virtual std::vector< double > cellDimensions(const CellID &cellID) const
Returns a vector<double> of the cellDimensions of the given cell ID in natural order of dimensions,...
Definition: CartesianGridXYStaggered.cpp:103
dd4hep::DDSegmentation::Segmentation::_description
std::string _description
The description of the segmentation.
Definition: Segmentation.h:162
dd4hep::DDSegmentation::CartesianGridXYStaggered::position
virtual Vector3D position(const CellID &cellID) const
determine the position based on the cell ID
Definition: CartesianGridXYStaggered.cpp:74
dd4hep::DDSegmentation::Segmentation::positionToBin
static int positionToBin(double position, double cellSize, double offset=0.)
Helper method to convert a 1D position to a cell ID.
Definition: Segmentation.cpp:150
dd4hep::DDSegmentation::Vector3D::X
double X
Definition: Segmentation.h:71
dd4hep::DDSegmentation::Segmentation::binToPosition
static double binToPosition(FieldID bin, double cellSize, double offset=0.)
Helper method to convert a bin number to a 1D position.
Definition: Segmentation.cpp:145
dd4hep::DDSegmentation::CartesianGridXYStaggered::~CartesianGridXYStaggered
virtual ~CartesianGridXYStaggered()
destructor
Definition: CartesianGridXYStaggered.cpp:69
dd4hep::DDSegmentation::CartesianGridXYStaggered::CartesianGridXYStaggered
CartesianGridXYStaggered(const std::string &cellEncoding="")
Default constructor passing the encoding string.
Definition: CartesianGridXYStaggered.cpp:23
dd4hep
Namespace for the AIDA detector description toolkit.
Definition: AlignmentsCalib.h:28
dd4hep::DDSegmentation::Segmentation::_type
std::string _type
The segmentation type.
Definition: Segmentation.h:160
dd4hep::DDSegmentation::CartesianGridXYStaggered::_offsetY
double _offsetY
the coordinate offset in Y
Definition: CartesianGridXYStaggered.h:133
dd4hep::DDSegmentation::CartesianGridXYStaggered::_offsetX
double _offsetX
the coordinate offset in X
Definition: CartesianGridXYStaggered.h:127
dd4hep::DDSegmentation::CartesianGrid
Segmentation base class describing cartesian grid segmentation.
Definition: CartesianGrid.h:28