// // ******************************************************************** // * License and Disclaimer * // * * // * The Geant4 software is copyright of the Copyright Holders of * // * the Geant4 Collaboration. It is provided under the terms and * // * conditions of the Geant4 Software License, included in the file * // * LICENSE and available at http://cern.ch/geant4/license . These * // * include a list of copyright holders. * // * * // * Neither the authors of this software system, nor their employing * // * institutes,nor the agencies providing financial support for this * // * work make any representation or warranty, express or implied, * // * regarding this software system or assume any liability for its * // * use. Please see the license in the file LICENSE and URL above * // * for the full disclaimer and the limitation of liability. * // * * // * This code implementation is the result of the scientific and * // * technical work of the GEANT4 collaboration. * // * By using, copying, modifying or distributing the software (or * // * any work based on the software) you agree to acknowledge its * // * use in resulting scientific publications, and indicate your * // * acceptance of all terms of the Geant4 Software license. * // ******************************************************************** // // G4GenericTrap // // Class description: // // G4GenericTrap is a solid which represents an arbitrary trapezoid with // up to 8 vertices standing on two parallel planes perpendicular to Z axis. // // Parameters in the constructor: // - name - solid name // - halfZ - the solid half length in Z // - vertices - the (x,y) coordinates of vertices: // o first four points: vertices[i], i<4 // are the vertices sitting on the -halfZ plane; // o last four points: vertices[i], i>=4 // are the vertices sitting on the +halfZ plane. // // The order of defining the vertices of the solid is the following: // - point 0 is connected with points 1,3,4 // - point 1 is connected with points 0,2,5 // - point 2 is connected with points 1,3,6 // - point 3 is connected with points 0,2,7 // - point 4 is connected with points 0,5,7 // - point 5 is connected with points 1,4,6 // - point 6 is connected with points 2,5,7 // - point 7 is connected with points 3,4,6 // Points can be identical in order to create shapes with less than // 8 vertices. // Authors: // Tatiana Nikitina, CERN; Ivana Hrivnacova, IPN Orsay // Adapted from Root Arb8 implementation, author Andrei Gheata, CERN // // 27.05.2024 - Evgueni Tcherniaev, complete revision, speed up // ------------------------------------------------------------------- #ifndef G4GENERICTRAP_HH #define G4GENERICTRAP_HH #include "G4GeomTypes.hh" #if defined(G4GEOM_USE_USOLIDS) #define G4GEOM_USE_UGENERICTRAP 1 #endif #if defined(G4GEOM_USE_UGENERICTRAP) #define G4UGenericTrap G4GenericTrap #include "G4UGenericTrap.hh" #else #include #include "globals.hh" #include "G4TwoVector.hh" #include "G4VSolid.hh" class G4GenericTrap : public G4VSolid { public: // Constructor G4GenericTrap(const G4String& name, G4double halfZ, const std::vector& vertices); // Fake default constructor for usage restricted to direct object // persistency for clients requiring preallocation of memory for // persistifiable objects. G4GenericTrap(__void__&); // Copy constructor and assignment operator G4GenericTrap(const G4GenericTrap& rhs); G4GenericTrap& operator=(const G4GenericTrap& rhs); // Destructor ~G4GenericTrap() override; // Accessors inline G4double GetZHalfLength() const; inline G4int GetNofVertices() const; inline G4TwoVector GetVertex(G4int index) const; inline const std::vector& GetVertices() const; inline G4double GetTwistAngle(G4int index) const; inline G4bool IsTwisted() const; inline G4int GetVisSubdivisions() const; inline void SetVisSubdivisions(G4int subdiv); // Solid methods EInside Inside(const G4ThreeVector& p) const override; G4ThreeVector SurfaceNormal(const G4ThreeVector& p) const override; G4double DistanceToIn(const G4ThreeVector& p, const G4ThreeVector& v) const override; G4double DistanceToIn(const G4ThreeVector& p) const override; G4double DistanceToOut(const G4ThreeVector& p, const G4ThreeVector& v, const G4bool calcNorm = false, G4bool* validNorm = nullptr, G4ThreeVector* n = nullptr) const override; G4double DistanceToOut(const G4ThreeVector& p) const override; void BoundingLimits(G4ThreeVector& pMin, G4ThreeVector& pMax) const override; G4bool CalculateExtent(const EAxis pAxis, const G4VoxelLimits& pVoxelLimit, const G4AffineTransform& pTransform, G4double& pmin, G4double& pmax) const override; G4GeometryType GetEntityType() const override; G4bool IsFaceted () const override; G4VSolid* Clone() const override; std::ostream& StreamInfo(std::ostream& os) const override; G4ThreeVector GetPointOnSurface() const override ; G4double GetCubicVolume() override; G4double GetSurfaceArea() override; // Visualisation functions void DescribeYourselfTo(G4VGraphicsScene& scene) const override; G4VisExtent GetExtent() const override; G4Polyhedron* CreatePolyhedron() const override; G4Polyhedron* GetPolyhedron () const override; private: // Internal methods void CheckParameters(G4double halfZ, const std::vector& vertices); void ComputeLateralSurfaces(); void ComputeBoundingBox(); void ComputeScratchLength(); G4double GetLateralFaceArea(G4int iface) const; G4ThreeVector ApproxSurfaceNormal(const G4ThreeVector& p) const; void WarningSignA(const G4String& method, const G4String& icase, G4double A, const G4ThreeVector& p, const G4ThreeVector& v) const; void WarningSignB(const G4String& method, const G4String& icase, G4double f, G4double B, const G4ThreeVector& p, const G4ThreeVector& v) const; void WarningDistanceToIn(G4int k, const G4ThreeVector& p, const G4ThreeVector& v, G4double tmin, G4double tmax, const G4double ttin[2], const G4double ttout[2]) const; void WarningDistanceToOut(const G4ThreeVector& p, const G4ThreeVector& v, G4double tout) const; private: struct G4GenericTrapPlane // Ax + By + Cz + D = 0 { G4double A = 0.; G4double B = 0.; G4double C = 0.; G4double D = 0.; }; struct G4GenericTrapSurface // Axz + Byz + Czz + Dx + Ey + Fz + G = 0 { G4double A = 0.; G4double B = 0.; G4double C = 0.; G4double D = 0.; G4double E = 0.; G4double F = 0.; G4double G = 0.; }; // Data members G4double halfTolerance = 0.; G4double fScratch = 0.; G4double fDz = 0.; std::vector fVertices = {0.,0.,0.,0.,0.,0.,0.,0.}; G4TwoVector fDelta[4]; G4bool fIsTwisted = false; G4double fTwist[5] = {0.}; G4ThreeVector fMinBBox{0.}; G4ThreeVector fMaxBBox{0.}; G4int fVisSubdivisions = 0; G4GenericTrapPlane fPlane[8]; G4GenericTrapSurface fSurf[4]; mutable G4double fArea[4] = {0.}; mutable G4bool fRebuildPolyhedron = false; mutable G4Polyhedron* fpPolyhedron = nullptr; // Surface and Volume G4double fSurfaceArea = 0.; G4double fCubicVolume = 0.; }; #include "G4GenericTrap.icc" #endif // defined(G4GEOM_USE_UGENERICTRAP) #endif // G4GENERICTRAP_HH