ConeSurface.h

Go to the documentation of this file.

/*
  Copyright (C) 2002-2026 CERN for the benefit of the ATLAS collaboration
*/

// ConeSurface.h, (c) ATLAS Detector software
 
#ifndef TRKSURFACES_CONESURFACE_H
#define TRKSURFACES_CONESURFACE_H
 
// Trk
#include "TrkEventPrimitives/ParamDefs.h"
#include "TrkParametersBase/ParametersT.h"
#include "TrkSurfaces/ConeBounds.h"
#include "TrkSurfaces/Surface.h"
// Amg
#include "EventPrimitives/EventPrimitives.h"
#include "GeoPrimitives/GeoPrimitives.h"
 
#include <memory>
#include <optional>
class MsgStream;
 
template<class SURFACE, class BOUNDS_CNV>
class BoundSurfaceCnv_p1;
template<class SURFACE, class BOUNDS_CNV>
class BoundSurfaceCnv_p2;
 
namespace Trk {
 
class LocalParameters;
template<int DIM, class T, class S>
class ParametersT;

 
class ConeSurface : public Surface
{
 
public:
  static constexpr SurfaceType staticType = SurfaceType::Cone;

  ConeSurface();

  ConeSurface& operator=(const ConeSurface& csf);

  ConeSurface(const ConeSurface& csf);

  ConeSurface(ConeSurface&& annbo) = default;
  ConeSurface& operator=(ConeSurface&& sbo) = default;

  virtual ~ConeSurface();

  ConeSurface(const Amg::Transform3D& htrans,
              double alpha,
              bool symmetric = false);

  ConeSurface(const Amg::Transform3D& htrans,
              double alpha,
              double locZmin,
              double locZmax,
              double halfPhi = M_PI);

  ConeSurface(const Amg::Transform3D& htrans, std::shared_ptr<const ConeBounds> cbounds);

  ConeSurface(const Amg::Transform3D& htrans);

  ConeSurface(const ConeSurface& csf, const Amg::Transform3D& transf);

  virtual bool operator==(const Surface& sf) const override;
  bool operator==(const ConeSurface& cf) const;

  virtual ConeSurface* clone() const override;

  virtual Surface::ChargedTrackParametersUniquePtr createUniqueTrackParameters(
    double l1,
    double l2,
    double phi,
    double theta,
    double qop,
    const std::optional<AmgSymMatrix(5)> & cov = std::nullopt) const override final;

  virtual Surface::ChargedTrackParametersUniquePtr createUniqueTrackParameters(
    const Amg::Vector3D& position,
    const Amg::Vector3D& momentum,
    double charge,
    const std::optional<AmgSymMatrix(5)> & cov = std::nullopt) const override final;

  virtual NeutralTrackParametersUniquePtr createUniqueNeutralParameters(
    double l1,
    double l2,
    double phi,
    double theta,
    double qop,
    const std::optional<AmgSymMatrix(5)> & cov = std::nullopt) const override final;

 
  virtual NeutralTrackParametersUniquePtr createUniqueNeutralParameters(
    const Amg::Vector3D& position,
    const Amg::Vector3D& momentum,
    double charge,
    const std::optional<AmgSymMatrix(5)> & cov = std::nullopt) const override final;

  template<int DIM, class T>
  std::unique_ptr<ParametersT<DIM, T, ConeSurface>> createUniqueParameters(
    double l1,
    double l2,
    double phi,
    double theta,
    double qop,
    const std::optional<AmgSymMatrix(DIM)> & cov = std::nullopt) const;

  template<int DIM, class T>
  std::unique_ptr<ParametersT<DIM, T, ConeSurface>> createUniqueParameters(
    const Amg::Vector3D& position,
    const Amg::Vector3D& momentum,
    double charge,
    const std::optional<AmgSymMatrix(DIM)> & cov = std::nullopt) const;

  constexpr virtual SurfaceType type() const override final;

  virtual Amg::RotationMatrix3D measurementFrame(
    const Amg::Vector3D& glopos,
    const Amg::Vector3D& glomom) const override final;

  virtual const Amg::Vector3D& globalReferencePoint() const override final;
 
  // using from the base class
  using Trk::Surface::normal;

  virtual Amg::Vector3D normal(const Amg::Vector2D& locpo) const override final;

  virtual const Amg::Vector3D& rotSymmetryAxis() const;

  virtual const ConeBounds& bounds() const override final;

  virtual bool insideBounds(const Amg::Vector2D& locpos,
                            double tol1 = 0.,
                            double tol2 = 0.) const override;
  virtual bool insideBoundsCheck(const Amg::Vector2D& locpos,
                                 const BoundaryCheck& bchk) const override final;

  virtual Amg::Vector2D localParametersToPosition(
    const LocalParameters& locpars) const override final;

  virtual void localToGlobal(const Amg::Vector2D& locp,
                             const Amg::Vector3D& mom,
                             Amg::Vector3D& glob) const override final;

  virtual bool globalToLocal(const Amg::Vector3D& glob,
                             const Amg::Vector3D& mom,
                             Amg::Vector2D& loc) const override final;

  virtual Intersection straightLineIntersection(
    const Amg::Vector3D& pos,
    const Amg::Vector3D& dir,
    bool forceDir = false,
    BoundaryCheck bchk = false) const override final;

  virtual DistanceSolution straightLineDistanceEstimate(
    const Amg::Vector3D& pos,
    const Amg::Vector3D& dir) const override final;

  virtual DistanceSolution straightLineDistanceEstimate(
    const Amg::Vector3D& pos,
    const Amg::Vector3D& dir,
    bool bound) const override final;

  virtual double pathCorrection(const Amg::Vector3D&,
                                const Amg::Vector3D&) const override;

  virtual std::string name() const override;
 
protected:
  template<class SURFACE, class BOUNDS_CNV>
  friend class ::BoundSurfaceCnv_p1;
  template<class SURFACE, class BOUNDS_CNV>
  friend class ::BoundSurfaceCnv_p2;
  std::shared_ptr<const ConeBounds> m_bounds;
  CxxUtils::CachedUniquePtr<Amg::Vector3D> m_referencePoint;
  CxxUtils::CachedUniquePtr<Amg::Vector3D> m_rotSymmetryAxis;
};
 
} // end of namespace
#include "TrkSurfaces/ConeSurface.icc"
 
#endif // TRKSURFACES_CONESURFACE_H