SpectrometerSector.h

Go to the documentation of this file.

/*
  Copyright (C) 2002-2026 CERN for the benefit of the ATLAS collaboration
*/
#ifndef MUONREADOUTGEOMETRYR4_SPECTROMETERSECTOR_H
#define MUONREADOUTGEOMETRYR4_SPECTROMETERSECTOR_H
 
#include "AthenaBaseComps/AthMessaging.h"
#ifndef SIMULATIONBASE
 
#include "MuonReadoutGeometryR4/MuonReadoutElement.h"
#include "MuonReadoutGeometryR4/Chamber.h"
#include "ActsGeometryInterfaces/GeometryDefs.h"
#include "ActsGeoUtils/VolumePlacement.h"
#include "Acts/Geometry/VolumeBounds.hpp"
 
namespace Acts {
    class Volume;
    class PlaneSurface;
}
namespace MuonGMR4{
    class SpectrometerSector;
    class Chamber;
}
 
namespace MuonGMR4 {
 
    class SpectrometerSector : public AthMessaging {   
        public:
            using ChamberPtr = GeoModel::TransientConstSharedPtr<Chamber>;
            using ChamberSet = std::vector<ChamberPtr>;

            struct chamberLocation{
                public:
                    using BoundPtr_t = std::shared_ptr<const Acts::VolumeBounds>;
                    chamberLocation(const Amg::Vector3D& origin,
                                    const MuonReadoutElement* reEle,
                                    BoundPtr_t bounds):
                        m_origin{origin}, m_reEle{reEle}, m_bounds{std::move(bounds)}{}

                    chamberLocation(const chamberLocation& other) = default;
                    chamberLocation(chamberLocation&& other) = default;
                    chamberLocation& operator=(const chamberLocation& other) = default;
                    chamberLocation& operator=(chamberLocation&& other) = default;
                    bool insideYZ(const Amg::Vector3D& pos) const {
                      return minY() <= pos.y() &&  maxY() >= pos.y() &&
                             minZ() <= pos.z() &&  maxZ() >= pos.z();
                    }

                     double minY() const { return m_origin.y() - MuonGMR4::halfY(*m_bounds); }
                     double maxY() const { return m_origin.y() + MuonGMR4::halfY(*m_bounds); }
                     double minZ() const { return m_origin.z() - MuonGMR4::halfZ(*m_bounds); }
                     double maxZ() const { return m_origin.z() + MuonGMR4::halfZ(*m_bounds); }
                     double width(const double y0) const {
                        const double tanPhiHalf = 0.5*(MuonGMR4::halfXhighY(*m_bounds)- MuonGMR4::halfXlowY(*m_bounds)) / MuonGMR4::halfZ(*m_bounds); 
                        return MuonGMR4::halfXlowY(*m_bounds) + tanPhiHalf * (y0 - minY());
                     }

                     const MuonReadoutElement* readoutEle() const { return m_reEle; }
                    const BoundPtr_t& bounds() const { return m_bounds; }
                    const Amg::Vector3D& location() const { return m_origin; }
                private:
                    Amg::Vector3D m_origin{Amg::Vector3D::Zero()};
                    const MuonReadoutElement* m_reEle{nullptr};
                    BoundPtr_t m_bounds{};
            };
 
            struct defineArgs{
                ChamberSet chambers{};
                ActsTrk::VolumePlacement::AlignableNode_t localToGlobalTrf{};
                std::unique_ptr<ActsTrk::VolumePlacement> placement{};
                std::shared_ptr<Acts::VolumeBounds> bounds{};
                std::shared_ptr<const Acts::PlaneSurface> surface{};
                std::vector<chamberLocation> detectorLocs{}; 
                unsigned id{0};
            };

            SpectrometerSector(defineArgs&& args);
            SpectrometerSector(const SpectrometerSector& other) = delete;
            SpectrometerSector& operator=(const SpectrometerSector& other) = delete;
 
            ~SpectrometerSector() = default;
 
            bool operator<(const SpectrometerSector& other) const;

            std::string identString() const;
            const Muon::IMuonIdHelperSvc* idHelperSvc() const;
            Muon::MuonStationIndex::ChIndex chamberIndex() const;
            int stationPhi() const;
            int sector() const;
            int8_t side() const;
            bool barrel() const;
            const Acts::Transform3& localToGlobalTransform(const ActsTrk::GeometryContext& gctx) const;
            const Acts::Transform3& globalToLocalTransform(const ActsTrk::GeometryContext& gctx) const;
            const Acts::Transform3& localToGlobalTransform(const Acts::GeometryContext& tgContext) const;
            const Acts::Transform3& globalToLocalTransform(const Acts::GeometryContext& tgContext) const;
            const Acts::PlaneSurface& surface() const;
            const ChamberSet& chambers() const;
            double halfXLong() const;
            double halfXShort() const;
            double halfY() const;
            double halfZ() const;  
            const defineArgs& parameters() const;
            std::shared_ptr<Acts::Volume> boundingVolume() const;
            std::shared_ptr<Acts::VolumeBounds> bounds() const;
            Chamber::ReadoutSet readoutEles() const;
            const std::vector<chamberLocation> & chamberLocations() const; 
            const std::vector<unsigned int>& logicalLayerIdx(const MuonReadoutElement* reEle) const;
            void addPlacement(std::unique_ptr<ActsTrk::VolumePlacement>&& placement) const;
 
        private:
            defineArgs m_args{};
            std::unordered_map<const MuonReadoutElement*, std::vector<unsigned int>> fillDetLayIdCache() const; 
            const std::unordered_map<const MuonReadoutElement*, std::vector<unsigned int>> m_detLayIdCache{fillDetLayIdCache()};
            Identifier computeDetLayerId(const MuonReadoutElement* rele) const;
            unsigned int nLayerPerReadout (const MuonReadoutElement* rele) const;
    };
    
    std::ostream& operator<<(std::ostream& ostr,
                             const SpectrometerSector::defineArgs& args);
 
    std::ostream& operator<<(std::ostream& ostr,
                             const SpectrometerSector& chamber);
 
}
 
#endif
#endif