Acts/Geometry/PlaneLayer.hpp

0001 // This file is part of the ACTS project.
0002 //
0003 // Copyright (C) 2016 CERN for the benefit of the ACTS project
0004 //
0005 // This Source Code Form is subject to the terms of the Mozilla Public
0006 // License, v. 2.0. If a copy of the MPL was not distributed with this
0007 // file, You can obtain one at https://mozilla.org/MPL/2.0/.
0008
0009 #pragma once
0010
0011 #include "Acts/Definitions/Algebra.hpp"
0012 #include "Acts/Geometry/ApproachDescriptor.hpp"
0013 #include "Acts/Geometry/Layer.hpp"
0014 #include "Acts/Surfaces/PlaneSurface.hpp"
0015
0016 #include <memory>
0017
0018 namespace Acts {
0019
0020 class PlanarBounds;
0021 class SurfaceArray;
0022
0023 /// @class PlaneLayer
0024 ///
0025 /// Class to describe a planar detector layer for tracking,
0026 /// it inhertis from both, Layer base class and PlaneSurface class
0027 ///
0028 class PlaneLayer : virtual public PlaneSurface, public Layer {
0029  public:
0030   /// Factory for a shared plane layer
0031   ///
0032   /// @param transform which places the layer in the global frame
0033   /// @param pbounds the planar bounds that define the layer dimensions
0034   /// @param surfaceArray is the surface array that holds the sensitive surfaces
0035   /// @param thickness is the thickness of the layer (normal direction to plane)
0036   /// @param ad is the approach descriptor for describing the approach surface
0037   /// @param laytyp is the layer type
0038   ///
0039   /// @return shared pointer to a PlaneLayer
0040   static std::shared_ptr<PlaneLayer> create(
0041       const Transform3& transform, std::shared_ptr<const PlanarBounds> pbounds,
0042       std::unique_ptr<SurfaceArray> surfaceArray = nullptr,
0043       double thickness = 0., std::unique_ptr<ApproachDescriptor> ad = nullptr,
0044       LayerType laytyp = active);
0045
0046   PlaneLayer() = delete;
0047   PlaneLayer(const PlaneLayer& pla) = delete;
0048   ~PlaneLayer() override = default;
0049   PlaneLayer& operator=(const PlaneLayer&) = delete;
0050
0051   /// Transforms the layer into a Surface representation for extrapolation
0052   /// @return returns a reference to a PlaneSurface
0053   const PlaneSurface& surfaceRepresentation() const override;
0054
0055   /// Non-const version of surface representation access
0056   /// @return Mutable reference to the plane surface
0057   PlaneSurface& surfaceRepresentation() override;
0058
0059  private:
0060   /// private helper method to build approach surfaces
0061   void buildApproachDescriptor();
0062
0063  protected:
0064   /// Private constructor for a PlaneLayer is called by create(args*)
0065   ///
0066   /// @param transform which places the layer in the global frame
0067   /// @param pbounds the planar bounds that define the layer dimensions
0068   /// @param surfaceArray is the surface array that holds the sensitive surfaces
0069   /// @param thickness is the thickness of the layer (normal direction to plane)
0070   /// @param ades is the approach descriptor for describing the approach surface
0071   /// @param laytyp is the layer type
0072   PlaneLayer(const Transform3& transform,
0073              std::shared_ptr<const PlanarBounds>& pbounds,
0074              std::unique_ptr<SurfaceArray> surfaceArray = nullptr,
0075              double thickness = 0.,
0076              std::unique_ptr<ApproachDescriptor> ades = nullptr,
0077              LayerType laytyp = active);
0078
0079   /// Private constructor for a PlaneLayer, is called by create(arge*
0080   ///
0081   /// @param pla is the plain layer to be coped
0082   /// @param shift is the additional shift applied after copying
0083   PlaneLayer(const PlaneLayer& pla, const Transform3& shift);
0084 };
0085
0086 }  // namespace Acts