Gabriele Cosmo
245 lines
10 KiB
C++
245 lines
10 KiB
C++
//
|
|
// ********************************************************************
|
|
// * DISCLAIMER *
|
|
// * *
|
|
// * The following disclaimer summarizes all the specific disclaimers *
|
|
// * of contributors to this software. The specific disclaimers,which *
|
|
// * govern, are listed with their locations in: *
|
|
// * http://cern.ch/geant4/license *
|
|
// * *
|
|
// * 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. *
|
|
// * *
|
|
// * This code implementation is the intellectual property of the *
|
|
// * GEANT4 collaboration. *
|
|
// * By copying, distributing or modifying the Program (or any work *
|
|
// * based on the Program) you indicate your acceptance of this *
|
|
// * statement, and all its terms. *
|
|
// ********************************************************************
|
|
//
|
|
//
|
|
// $Id: G4ReflectionFactory.hh,v 1.1 2004/05/13 14:50:58 gcosmo Exp $
|
|
// GEANT4 tag $Name: geant4-06-02 $
|
|
//
|
|
//
|
|
// class G4ReflectionFactory
|
|
//
|
|
// Class description:
|
|
//
|
|
// Class providing functions for volumes placements with a general
|
|
// transfomation that can contain reflection.
|
|
// Reflection is then applied to a solid: a new G4ReflectedSolid
|
|
// instance is created and is placed with a transformation containing
|
|
// pure rotation and translation only.
|
|
// The pair of constituent and reflected logical volumes is
|
|
// considered as a generalized logical volume that is addressed
|
|
// by user specifying the constituent logical volume.
|
|
//
|
|
// Decomposition of a general transformation that can include reflection
|
|
// in a "reflection-free" transformation:
|
|
//
|
|
// x(inM') = TG*x(inM) TG - general transformation
|
|
// = T*(R*x(inM)) T - "reflection-free" transformation
|
|
// = T* x(inReflM)
|
|
//
|
|
// Daughters transformation:
|
|
// When a volume V containing daughter D with transformation TD
|
|
// is placed in mother M with a general tranformation TGV,
|
|
// the TGV is decomposed. New reflected volume ReflV containing
|
|
// a new daughter ReflD with reflected transformation ReflTD is created:
|
|
//
|
|
// x(inV) = TD * x(inD);
|
|
// x(inM) = TGV * x(inV)
|
|
// = TV * R * x(inV)
|
|
// = TV * R * TD * x(inD)
|
|
// = TV * R*TD*R-1 * R*x(inD)
|
|
// = TV * ReflTD * x(inReflD)
|
|
|
|
// Author: Ivana Hrivnacova, 16.10.2001 (Ivana.Hrivnacova@cern.ch)
|
|
// --------------------------------------------------------------------
|
|
#ifndef G4_REFLECTION_FACTORY_HH
|
|
#define G4_REFLECTION_FACTORY_HH
|
|
|
|
#include "G4Types.hh"
|
|
#include "G4Transform3D.hh"
|
|
#include "geomdefs.hh"
|
|
|
|
#include <map>
|
|
|
|
class G4VPhysicalVolume;
|
|
class G4LogicalVolume;
|
|
class G4VSolid;
|
|
class G4VPVDivisionFactory;
|
|
|
|
typedef std::pair<G4VPhysicalVolume*,
|
|
G4VPhysicalVolume*> G4PhysicalVolumesPair;
|
|
typedef std::map<G4LogicalVolume*, G4LogicalVolume*,
|
|
std::less<G4LogicalVolume*> > G4ReflectedVolumesMap;
|
|
|
|
class G4ReflectionFactory
|
|
{
|
|
typedef G4ReflectedVolumesMap::const_iterator LogicalVolumesMapIterator;
|
|
|
|
public: // with description
|
|
|
|
virtual ~G4ReflectionFactory();
|
|
// Virtual destructor.
|
|
|
|
static G4ReflectionFactory* Instance();
|
|
// Gets pointer to the instance of the singleton.
|
|
|
|
G4PhysicalVolumesPair Place(const G4Transform3D& transform3D,
|
|
const G4String& name,
|
|
G4LogicalVolume* LV,
|
|
G4LogicalVolume* motherLV,
|
|
G4bool isMany,
|
|
G4int copyNo);
|
|
// Evaluates the passed transformation; if it contains reflection
|
|
// it performs its decomposition, creates new reflected solid and
|
|
// logical volume (or retrieves them from a map if the reflected
|
|
// objects were already created), transforms the daughters (if present)
|
|
// and place it in the given mother.
|
|
// The result is a pair of physical volumes;
|
|
// the second physical volume is a placement in a reflected mother
|
|
// or 0 if mother LV was not reflected.
|
|
|
|
G4PhysicalVolumesPair Replicate(const G4String& name,
|
|
G4LogicalVolume* LV,
|
|
G4LogicalVolume* motherLV,
|
|
EAxis axis,
|
|
G4int nofReplicas,
|
|
G4double width,
|
|
G4double offset=0);
|
|
// Creates replica in the given mother.
|
|
// The result is a pair of physical volumes;
|
|
// the second physical volume is a replica in a reflected mother
|
|
// or 0 if mother LV was not reflected.
|
|
|
|
G4PhysicalVolumesPair Divide(const G4String& name,
|
|
G4LogicalVolume* LV,
|
|
G4LogicalVolume* motherLV,
|
|
EAxis axis,
|
|
G4int nofDivisions,
|
|
G4double width,
|
|
G4double offset);
|
|
G4PhysicalVolumesPair Divide(const G4String& name,
|
|
G4LogicalVolume* LV,
|
|
G4LogicalVolume* motherLV,
|
|
EAxis axis,
|
|
G4int nofDivisions,
|
|
G4double offset);
|
|
G4PhysicalVolumesPair Divide(const G4String& name,
|
|
G4LogicalVolume* LV,
|
|
G4LogicalVolume* motherLV,
|
|
EAxis axis,
|
|
G4double width,
|
|
G4double offset);
|
|
// Creates division in the given mother.
|
|
// The result is a pair of physical volumes;
|
|
// the second physical volume is a division in a reflected mother
|
|
// or 0 if mother LV was not reflected.
|
|
|
|
void SetVerboseLevel(G4int verboseLevel);
|
|
G4int GetVerboseLevel() const;
|
|
// Sets/gets verbosity level.
|
|
|
|
void SetVolumesNameExtension(const G4String& nameExtension);
|
|
G4String GetVolumesNameExtension() const;
|
|
// Returns the name extension for the reflected solids
|
|
// and logical volumes.
|
|
|
|
void SetScalePrecision(G4double scaleValue);
|
|
G4double GetScalePrecision() const;
|
|
// Sets/gets precision factor for the scale consistency check
|
|
// The default value is set to 10*kCarTolerance.
|
|
|
|
G4LogicalVolume* GetConstituentLV(G4LogicalVolume* reflLV) const;
|
|
// Returns the consituent volume of the given reflected volume,
|
|
// 0 if the given reflected volume was not found.
|
|
|
|
G4LogicalVolume* GetReflectedLV(G4LogicalVolume* lv) const;
|
|
// Returns the reflected volume of the given consituent volume,
|
|
// 0 if the given volume was not reflected.
|
|
|
|
G4bool IsConstituent(G4LogicalVolume* lv) const;
|
|
// Returns true if the given volume has been already reflected
|
|
// (is in the map of constituent volumes).
|
|
|
|
G4bool IsReflected(G4LogicalVolume* lv) const;
|
|
// Returns true if the given volume is a reflected volume
|
|
// (is in the map reflected volumes).
|
|
|
|
const G4ReflectedVolumesMap& GetReflectedVolumesMap() const;
|
|
// Returns a handle to the internal map of volumes which have
|
|
// been reflected, after that placement or replication is performed.
|
|
|
|
protected:
|
|
|
|
G4ReflectionFactory();
|
|
// Protected singleton constructor.
|
|
|
|
G4ReflectionFactory(const G4ReflectionFactory&);
|
|
G4ReflectionFactory& operator=(const G4ReflectionFactory&);
|
|
// Disabled copy constructor and assignment operator.
|
|
|
|
private:
|
|
|
|
G4LogicalVolume* ReflectLV(G4LogicalVolume* LV);
|
|
// Gets/creates the reflected solid and logical volume
|
|
// and copies + transforms LV daughters.
|
|
|
|
G4LogicalVolume* CreateReflectedLV(G4LogicalVolume* LV);
|
|
// Creates the reflected solid and logical volume
|
|
// and add the logical volumes pair in the maps.
|
|
|
|
void ReflectDaughters(G4LogicalVolume* LV, G4LogicalVolume* refLV);
|
|
// Reflects daughters recursively.
|
|
|
|
void ReflectPVPlacement(G4VPhysicalVolume* PV, G4LogicalVolume* refLV);
|
|
// Copies and transforms daughter of PVPlacement type of
|
|
// a constituent volume into a reflected volume.
|
|
|
|
void ReflectPVReplica(G4VPhysicalVolume* PV, G4LogicalVolume* refLV);
|
|
// Copies and transforms daughter of PVReplica type of
|
|
// a constituent volume into a reflected volume.
|
|
|
|
void ReflectPVDivision(G4VPhysicalVolume* PV, G4LogicalVolume* refLV);
|
|
// Copies and transforms daughter of PVDivision type of
|
|
// a constituent volume into a reflected volume.
|
|
|
|
void ReflectPVParameterised(G4VPhysicalVolume* PV, G4LogicalVolume* refLV);
|
|
// Not implemented yet.
|
|
// Should copy and transform daughter of PVReplica type of
|
|
// a constituent volume into a reflected volume.
|
|
|
|
G4bool IsReflection(const G4Scale3D& scale) const;
|
|
// Returns true if the scale is negative, false otherwise.
|
|
|
|
void CheckScale(const G4Scale3D& scale) const;
|
|
// Checks if scale correspond to fScale, if not gives exception.
|
|
|
|
G4VPVDivisionFactory* GetPVDivisionFactory() const;
|
|
// Checks if the division factory is instanciated,
|
|
// if not gives exception.
|
|
|
|
void PrintConstituentLVMap();
|
|
// Temporary - for debugging purpose.
|
|
|
|
private:
|
|
|
|
static G4ReflectionFactory* fInstance;
|
|
static const G4String fDefaultNameExtension;
|
|
static const G4Scale3D fScale;
|
|
G4double fScalePrecision;
|
|
|
|
G4int fVerboseLevel;
|
|
G4String fNameExtension;
|
|
G4ReflectedVolumesMap fConstituentLVMap;
|
|
G4ReflectedVolumesMap fReflectedLVMap;
|
|
};
|
|
|
|
#endif
|