include/DD4hep/CartesianGridUV.h

0001 //==========================================================================
0002 //  AIDA Detector description implementation
0003 //--------------------------------------------------------------------------
0004 // Copyright (C) Organisation europeenne pour la Recherche nucleaire (CERN)
0005 // All rights reserved.
0006 //
0007 // For the licensing terms see $DD4hepINSTALL/LICENSE.
0008 // For the list of contributors see $DD4hepINSTALL/doc/CREDITS.
0009 //
0010 //  \author   Markus Frank
0011 //  \date     2016-10-18
0012 //  \version  1.0
0013 //
0014 //==========================================================================
0015 #ifndef DD4HEP_CARTESIANGRIDUV_H
0016 #define DD4HEP_CARTESIANGRIDUV_H 1
0017
0018 // Framework include files
0019 #include <DD4hep/Segmentations.h>
0020
0021 /// Namespace for the AIDA detector description toolkit
0022 namespace dd4hep {
0023
0024   /// Namespace for base segmentations
0025   namespace DDSegmentation  {    class CartesianGridUV;  }
0026
0027   /// We need some abbreviation to make the code more readable.
0028   typedef Handle<SegmentationWrapper<DDSegmentation::CartesianGridUV> > CartesianGridUVHandle;
0029
0030   /// Implementation class for the grid UV segmentation.
0031   /**
0032    *  Concrete user handle to serve specific needs of client code
0033    *  which requires access to the base functionality not served
0034    *  by the super-class Segmentation.
0035    *
0036    *  Note:
0037    *  We only check the validity of the underlying handle.
0038    *  If for whatever reason the implementation object is not valid
0039    *  This is not checked.
0040    *  In principle this CANNOT happen unless some brain-dead has
0041    *  fiddled with the handled object directly.....
0042    *
0043    *  Note:
0044    *  The handle base corresponding to this object in for
0045    *  conveniance reasons instantiated in dd4hep/src/Segmentations.cpp.
0046    *
0047    *  \author  M.Frank
0048    *  \version 1.0
0049    *  \ingroup DD4HEP_CORE
0050    */
0051   class CartesianGridUV : public CartesianGridUVHandle  {
0052   public:
0053     /// Default constructor
0054     CartesianGridUV() = default;
0055     /// Copy constructor
0056     CartesianGridUV(const CartesianGridUV& e) = default;
0057     /// Copy Constructor from segmentation base object
0058     CartesianGridUV(const Segmentation& e) : Handle<Object>(e) { }
0059     /// Copy constructor from handle
0060     CartesianGridUV(const Handle<Object>& e) : Handle<Object>(e) { }
0061     /// Copy constructor from other equivalent handle
0062     template <typename Q> CartesianGridUV(const Handle<Q>& e) : Handle<Object>(e) { }
0063     /// Assignment operator
0064     CartesianGridUV& operator=(const CartesianGridUV& seg) = default;
0065     /// Equality operator
0066     bool operator==(const CartesianGridUV& seg) const {
0067       return m_element == seg.m_element;
0068     }
0069
0070     /// determine the position based on the cell ID
0071     Position position(const CellID& cellID) const;
0072     /// determine the cell ID based on the position
0073     CellID cellID(const Position& local, const Position& global, const VolumeID& volID) const;
0074     /// access the grid size in U
0075     double gridSizeU() const;
0076     /// access the grid size in V
0077     double gridSizeV() const;
0078     /// set the grid size in U
0079     void setGridSizeU(double cellSize) const;
0080     /// set the grid size in V
0081     void setGridSizeV(double cellSize) const;
0082     /// access the coordinate offset in U
0083     double offsetU() const;
0084     /// access the coordinate offset in V
0085     double offsetV() const;
0086     /// access the rotation angle
0087     double gridAngle() const;
0088     /// set the coordinate offset in U
0089     void setOffsetU(double offset) const;
0090     /// set the coordinate offset in V
0091     void setOffsetV(double offset) const;
0092     /// set the rotation angle
0093     void setGridAngle(double angle) const;
0094     /// access the field name used for U
0095     const std::string& fieldNameU() const;
0096     /// access the field name used for V
0097     const std::string& fieldNameV() const;
0098     /** \brief Returns a vector<double> of the cellDimensions of the given cell ID
0099         in natural order of dimensions, e.g., dx/dy/dz, or dr/r*dPhi
0100
0101         Returns a vector of the cellDimensions of the given cell ID
0102         \param cellID is ignored as all cells have the same dimension
0103         \return std::vector<double> size 2:
0104         -# size in U
0105         -# size in V
0106     */
0107     std::vector<double> cellDimensions(const CellID& cellID) const;
0108   };
0109
0110 } /* End namespace dd4hep                */
0111 #endif // DD4HEP_CARTESIANGRIDUV_H