BDSIM
BDSIM is a Geant4 extension toolkit for simulation of particle transport in accelerator beamlines.
Public Member Functions | Static Public Member Functions | Private Types | Private Member Functions | Private Attributes | Static Private Attributes
BDSComponentFactory Class Reference

Factory to produce all types of BDSAcceleratorComponents. More...

#include <BDSComponentFactory.hh>

Collaboration diagram for BDSComponentFactory:
Collaboration graph

Public Member Functions

 BDSComponentFactory (const BDSParticleDefinition *designParticleIn, BDSComponentFactoryUser *userComponentFactoryIn=nullptr, G4bool usualPrintOut=true)
 
BDSAcceleratorComponentCreateComponent (GMAD::Element const *elementIn, GMAD::Element const *prevElementIn, GMAD::Element const *nextElementIn, G4double currentArcLength=0)
 
BDSAcceleratorComponentCreateTerminator (G4double witdth)
 
BDSAcceleratorComponentCreateTeleporter (const G4double teleporterLength, const G4double teleporterWidth, const G4Transform3D &transformIn)
 
BDSCrystalInfoPrepareCrystalInfo (const G4String &crystalName) const
 

Static Public Member Functions

static BDSTiltOffsetCreateTiltOffset (GMAD::Element const *el)
 Create the tilt and offset information object by inspecting the parser element. More...
 
static G4Transform3D CreateFieldTransform (const BDSTiltOffset *tiltOffset)
 Create a transform from a tilt offset. If nullptr, returns identity transform. More...
 
static G4Transform3D CreateFieldTransform (GMAD::Element const *el)
 
static BDSBeamPipeInfoPrepareBeamPipeInfo (GMAD::Element const *el, const G4ThreeVector &inputFaceNormal=G4ThreeVector(0, 0,-1), const G4ThreeVector &outputFaceNormal=G4ThreeVector(0, 0, 1))
 
static BDSBeamPipeInfoPrepareBeamPipeInfo (GMAD::Element const *el, G4double angleIn, G4double angleOut)
 
static G4bool YokeOnLeft (const GMAD::Element *el, const BDSMagnetStrength *st)
 
static G4double PrepareHorizontalWidth (GMAD::Element const *el, G4double defaultHorizontalWidth=-1)
 Prepare the element horizontal width in Geant4 units - if not set, use the global default. More...
 
static G4double ScalingFieldOuter (const GMAD::Element *ele)
 
static BDSFieldInfoPrepareMagnetOuterFieldInfo (const BDSMagnetStrength *vacuumSt, const BDSFieldType &fieldType, const BDSBeamPipeInfo *bpInfo, const BDSMagnetOuterInfo *outerInfo, const G4Transform3D &fieldTransform, const BDSIntegratorSet *integratorSetIn, G4double brhoIn, G4double outerFieldScaling=1.0)
 Prepare the field definition for the yoke of a magnet. More...
 
static BDSMagnetOuterInfoPrepareMagnetOuterInfo (const G4String &elementNameIn, const GMAD::Element *el, const BDSMagnetStrength *st, const BDSBeamPipeInfo *beamPipe, G4double defaultHorizontalWidth=-1, G4double defaultVHRatio=1.0, G4double defaultCoilWidthFraction=-1, G4double defaultCoilHeightFraction=-1)
 
static BDSMagnetGeometryType MagnetGeometryType (const GMAD::Element *el)
 
static BDSMagnetOuterInfoPrepareMagnetOuterInfo (const G4String &elementNameIn, const GMAD::Element *el, const G4double angleIn, const G4double angleOut, const BDSBeamPipeInfo *beamPipe, const G4bool yokeOnLeft=false, G4double defaultHorizontalWidth=-1, G4double defaultVHRatio=-1, G4double defaultCoilWidthFraction=-1, G4double defaultCoilHeightFraction=-1)
 
static G4Colour * PrepareColour (GMAD::Element const *element)
 Checks if colour is specified for element, else uses the default for that element type. More...
 
static G4Material * PrepareMaterial (GMAD::Element const *element, const G4String &defaultMaterialName)
 Checks if a material is named in Element::material, else uses the supplied default. More...
 
static G4Material * PrepareMaterial (GMAD::Element const *element)
 Try and get a material and exit if no such material. More...
 
static void CheckBendLengthAngleWidthCombo (G4double arcLength, G4double angle, G4double horizontalWidth, const G4String &name="not given")
 
static void PoleFaceRotationsNotTooLarge (const GMAD::Element *el, G4double maxAngle=0.5 *CLHEP::halfpi)
 Check whether the pole face rotation angles are too big for practical construction. More...
 

Private Types

enum class  KickerType { horizontal , vertical , general }
 Private enum for kicker types. More...
 

Private Member Functions

 BDSComponentFactory ()=delete
 No default constructor.
 
void SetBeta0 (BDSMagnetStrength *stIn) const
 Simple setter used to add Beta0 to a strength instance. More...
 
BDSAcceleratorComponentCreateDrift (G4double angleIn, G4double angleOut)
 
BDSAcceleratorComponentCreateRF (G4double currentArcLength)
 
BDSAcceleratorComponentCreateSBend ()
 
BDSAcceleratorComponentCreateRBend ()
 
BDSAcceleratorComponentCreateKicker (KickerType type)
 
BDSAcceleratorComponentCreateQuad ()
 
BDSAcceleratorComponentCreateSextupole ()
 
BDSAcceleratorComponentCreateOctupole ()
 
BDSAcceleratorComponentCreateDecapole ()
 
BDSAcceleratorComponentCreateMultipole ()
 
BDSAcceleratorComponentCreateThinMultipole (G4double angleIn)
 
BDSAcceleratorComponentCreateElement ()
 
BDSAcceleratorComponentCreateSolenoid ()
 
BDSAcceleratorComponentCreateParallelTransporter ()
 
BDSAcceleratorComponentCreateRectangularCollimator ()
 
BDSAcceleratorComponentCreateTarget ()
 
BDSAcceleratorComponentCreateEllipticalCollimator ()
 
BDSAcceleratorComponentCreateJawCollimator ()
 
BDSAcceleratorComponentCreateMuonSpoiler ()
 
BDSAcceleratorComponentCreateShield ()
 
BDSAcceleratorComponentCreateDegrader ()
 
BDSAcceleratorComponentCreateGap ()
 
BDSAcceleratorComponentCreateCrystalCollimator ()
 
BDSAcceleratorComponentCreateLaser ()
 
BDSAcceleratorComponentCreateScreen ()
 
BDSAcceleratorComponentCreateTransform3D ()
 
BDSAcceleratorComponentCreateWireScanner ()
 
BDSAcceleratorComponentCreateRMatrix ()
 
BDSAcceleratorComponentCreateThinRMatrix (G4double angleIn, const G4String &name)
 
BDSAcceleratorComponentCreateThinRMatrix (G4double angleIn, BDSMagnetStrength *stIn, const G4String &name, BDSIntegratorType intType=BDSIntegratorType::rmatrixthin, BDSFieldType fieldType=BDSFieldType::rmatrix, G4double beamPipeRadius=0)
 
BDSAcceleratorComponentCreateUndulator ()
 
BDSAcceleratorComponentCreateDump ()
 
BDSAcceleratorComponentCreateCT ()
 
BDSAcceleratorComponentCreateCavityFringe (G4double angleIn, BDSMagnetStrength *stIn, const G4String &name, G4double irisRadius)
 
BDSAcceleratorComponentCreateAwakeScreen ()
 
BDSAcceleratorComponentCreateAwakeSpectrometer ()
 
BDSMagnetCreateMagnet (const GMAD::Element *el, BDSMagnetStrength *st, BDSFieldType fieldType, BDSMagnetType magnetType, G4double angle=0.0, const G4String &nameSuffix="") const
 Helper method for common magnet construction. More...
 
G4bool HasSufficientMinimumLength (GMAD::Element const *el, G4bool printWarning=true)
 Test the component length is sufficient for practical construction. More...
 
G4Material * PrepareVacuumMaterial (GMAD::Element const *el) const
 Prepare the vacuum material from the element or resort to default in options. More...
 
void PrepareCavityModels ()
 
void PrepareColours ()
 Prepare all colours defined in the parser. More...
 
void PrepareCrystals ()
 Prepare all crystals in defined the parser. More...
 
BDSCavityInfoPrepareCavityModelInfo (GMAD::Element const *el, G4double frequency) const
 
BDSCavityInfoPrepareCavityModelInfoForElement (GMAD::Element const *el, G4double frequency) const
 
BDSMagnetStrengthPrepareCavityStrength (GMAD::Element const *el, G4double cavityLength, G4double currentArcLength, BDSMagnetStrength *&fringeIn, BDSMagnetStrength *&fringeOut) const
 
void SetFieldDefinitions (GMAD::Element const *el, BDSAcceleratorComponent *component) const
 
BDSMagnetStrengthPrepareMagnetStrengthForMultipoles (GMAD::Element const *el) const
 Prepare magnet strength for multipoles. More...
 
BDSMagnetStrengthPrepareMagnetStrengthForRMatrix (GMAD::Element const *el) const
 Prepare magnet strength for rmatrix. More...
 
G4double FieldFromAngle (const G4double angle, const G4double arcLength) const
 
G4double AngleFromField (const G4double field, const G4double arcLength) const
 
void CalculateAngleAndFieldSBend (GMAD::Element const *el, G4double &angle, G4double &field) const
 
void CalculateAngleAndFieldRBend (const GMAD::Element *el, G4double &arcLength, G4double &chordLength, G4double &field, G4double &angle) const
 
G4double BendAngle (const GMAD::Element *el) const
 Calculate the angle of a bend whether it's an rbend or an sbend. More...
 
G4double OutgoingFaceAngle (const GMAD::Element *el) const
 
G4double IncomingFaceAngle (const GMAD::Element *el) const
 
void GetKickValue (G4double &hkick, G4double &vkick, const KickerType type) const
 

Private Attributes

const BDSParticleDefinitiondesignParticle
 Particle w.r.t. which elements are built. More...
 
G4double brho
 Rigidity in T*m (G4units) for beam particles. More...
 
G4double beta0
 Cache of relativisitic beta for primary particle. More...
 
BDSComponentFactoryUseruserComponentFactory
 User component factory if any. More...
 
G4double lengthSafety
 Length safety from global constants. More...
 
G4double thinElementLength
 Length of a thin element. More...
 
G4bool includeFringeFields
 Cache of whether to include fringe fields. More...
 
G4bool yokeFields
 Cache of whether to include yoke magnetic fields. More...
 
GMAD::Element const * element = nullptr
 element for storing instead of passing around More...
 
GMAD::Element const * prevElement = nullptr
 element access to previous element (can be nullptr) More...
 
GMAD::Element const * nextElement = nullptr
 element access to previous element (can be nullptr) More...
 
std::map< G4String, BDSCavityInfo * > cavityInfos
 Map of cavity model info instances by name. More...
 
std::map< G4String, BDSCrystalInfo * > crystalInfos
 Maps of crystal info instances by name. More...
 
const BDSIntegratorSetintegratorSet
 Local copy of reference to integrator set to use. More...
 
const BDSIntegratorSetType integratorSetType
 Local copy of enum of the integrator set, i.e. which one it is specifically. More...
 
std::map< G4String, G4int > modifiedElements
 
G4String elementName
 Variable used to pass around the possibly modified name of an element. More...
 

Static Private Attributes

static G4bool coloursInitialised = false
 

Detailed Description

Factory to produce all types of BDSAcceleratorComponents.

Creates from a parser Element the appropriate object (that inherits BDSAcceleratorComponent) and returns it. Will return nullptr if invalid type or nothing to be constructed for that particular type. Calculations on field strength and angle as well as basic parameter validity (minimum length) are done here.

The main interface requires both a previous and next GMAD::Element that the element is constructed with respect to. This is so that drifts can be matched to the faces of bends with pole face rotations etc. If required in future, a simple interface for a single element could be added that uses this one with nullptrs.

Functions for common functionality, checks and preparation of recipe classes are provided publicly (and statically) for use elsewhere.

Definition at line 75 of file BDSComponentFactory.hh.

Member Enumeration Documentation

◆ KickerType

enum class BDSComponentFactory::KickerType
strongprivate

Private enum for kicker types.

Definition at line 224 of file BDSComponentFactory.hh.

Constructor & Destructor Documentation

◆ BDSComponentFactory()

BDSComponentFactory::BDSComponentFactory ( const BDSParticleDefinition designParticleIn,
BDSComponentFactoryUser userComponentFactoryIn = nullptr,
G4bool  usualPrintOut = true 
)
explicit

Definition at line 111 of file BDSComponentFactory.cc.

◆ ~BDSComponentFactory()

BDSComponentFactory::~BDSComponentFactory ( )

Definition at line 136 of file BDSComponentFactory.cc.

Member Function Documentation

◆ AngleFromField()

G4double BDSComponentFactory::AngleFromField ( const G4double  field,
const G4double  arcLength 
) const
private

Calculate the angle through a length of field - uses member rigidity and charge. Length & field in g4 m / tesla units

Definition at line 2730 of file BDSComponentFactory.cc.

References brho, and BDS::IsFinite().

Referenced by CalculateAngleAndFieldSBend().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ BendAngle()

G4double BDSComponentFactory::BendAngle ( const GMAD::Element el) const
private

Calculate the angle of a bend whether it's an rbend or an sbend.

Definition at line 2826 of file BDSComponentFactory.cc.

References CalculateAngleAndFieldRBend(), CalculateAngleAndFieldSBend(), and GMAD::Element::type.

Referenced by IncomingFaceAngle(), and OutgoingFaceAngle().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ CalculateAngleAndFieldRBend()

void BDSComponentFactory::CalculateAngleAndFieldRBend ( const GMAD::Element el,
G4double &  arcLength,
G4double &  chordLength,
G4double &  field,
G4double &  angle 
) const
private

Calculate the field and angle of an rbend from information in the element noting the 'l' in an element is the chord length of an rbend. Variables passed by reference and are updated as output. Note, this uses the MADX convention of +ve angle -> deflection in -ve x.

Definition at line 2768 of file BDSComponentFactory.cc.

References GMAD::Element::angle, GMAD::Element::angleSet, GMAD::Element::B, brho, BDS::IsFinite(), and GMAD::Element::l.

Referenced by BendAngle().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ CalculateAngleAndFieldSBend()

void BDSComponentFactory::CalculateAngleAndFieldSBend ( GMAD::Element const *  el,
G4double &  angle,
G4double &  field 
) const
private

Calculate field and angle of a sector bend. Note, this uses the MADX convention of +ve angle -> deflection in -ve x.

Definition at line 2739 of file BDSComponentFactory.cc.

References GMAD::Element::angle, AngleFromField(), GMAD::Element::angleSet, GMAD::Element::B, FieldFromAngle(), BDSGlobalConstants::Instance(), BDS::IsFinite(), and GMAD::Element::l.

Referenced by BendAngle().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ CheckBendLengthAngleWidthCombo()

void BDSComponentFactory::CheckBendLengthAngleWidthCombo ( G4double  arcLength,
G4double  angle,
G4double  horizontalWidth,
const G4String &  name = "not given" 
)
static

Utility function to check if the combination of horizontal width, angle and length will result in overlapping entrance and exit faces and therefore whether to abort.

Definition at line 2312 of file BDSComponentFactory.cc.

Referenced by BDS::BuildSBendLine().

Here is the caller graph for this function:

◆ CreateAwakeScreen()

BDSAcceleratorComponent * BDSComponentFactory::CreateAwakeScreen ( )
private

Definition at line 1751 of file BDSComponentFactory.cc.

◆ CreateAwakeSpectrometer()

BDSAcceleratorComponent * BDSComponentFactory::CreateAwakeSpectrometer ( )
private

Definition at line 1762 of file BDSComponentFactory.cc.

◆ CreateCavityFringe()

BDSAcceleratorComponent * BDSComponentFactory::CreateCavityFringe ( G4double  angleIn,
BDSMagnetStrength stIn,
const G4String &  name,
G4double  irisRadius 
)
private

Definition at line 1914 of file BDSComponentFactory.cc.

◆ CreateComponent()

BDSAcceleratorComponent * BDSComponentFactory::CreateComponent ( GMAD::Element const *  elementIn,
GMAD::Element const *  prevElementIn,
GMAD::Element const *  nextElementIn,
G4double  currentArcLength = 0 
)

Create component from parser Element pointers to next and previous Element are used to ensure the component will fit and may optionally be made to be so in the case of a drift. The optional last argument is the current s position at the end of the beam line for components that are distance or phase dependent such as an RF cavity.

Definition at line 154 of file BDSComponentFactory.cc.

References GMAD::Element::biasMaterialList, GMAD::Element::biasVacuumList, BDSComponentFactoryUser::CanConstructComponentByName(), BDSComponentFactoryUser::ConstructComponent(), element, elementName, BDSAcceleratorComponentRegistry::GetComponent(), HasSufficientMinimumLength(), includeFringeFields, IncomingFaceAngle(), BDSAcceleratorComponent::Initialise(), BDSAcceleratorComponentRegistry::Instance(), BDSGlobalConstants::Instance(), BDS::IsFinite(), GMAD::Element::l, GMAD::Element::minimumKineticEnergy, modifiedElements, nextElement, OutgoingFaceAngle(), prevElement, GMAD::Element::print(), GMAD::Element::region, BDSAcceleratorComponentRegistry::RegisterComponent(), BDSAcceleratorComponent::SetBiasMaterialList(), BDSAcceleratorComponent::SetBiasVacuumList(), SetFieldDefinitions(), BDSAcceleratorComponent::SetMinimumKineticEnergy(), BDSAcceleratorComponent::SetRegion(), GMAD::Element::type, userComponentFactory, and GMAD::Element::userTypeName.

Referenced by BDSDetectorConstruction::BuildBeamline(), and BDS::BuildPlacementGeometry().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ CreateCrystalCollimator()

BDSAcceleratorComponent * BDSComponentFactory::CreateCrystalCollimator ( )
private

Definition at line 1641 of file BDSComponentFactory.cc.

◆ CreateCT()

BDSAcceleratorComponent * BDSComponentFactory::CreateCT ( )
private

Definition at line 1617 of file BDSComponentFactory.cc.

◆ CreateDecapole()

BDSAcceleratorComponent * BDSComponentFactory::CreateDecapole ( )
private

Definition at line 1133 of file BDSComponentFactory.cc.

◆ CreateDegrader()

BDSAcceleratorComponent * BDSComponentFactory::CreateDegrader ( )
private

Definition at line 1481 of file BDSComponentFactory.cc.

◆ CreateDrift()

BDSAcceleratorComponent * BDSComponentFactory::CreateDrift ( G4double  angleIn,
G4double  angleOut 
)
private

Definition at line 467 of file BDSComponentFactory.cc.

◆ CreateDump()

BDSAcceleratorComponent * BDSComponentFactory::CreateDump ( )
private

Definition at line 1593 of file BDSComponentFactory.cc.

◆ CreateElement()

BDSAcceleratorComponent * BDSComponentFactory::CreateElement ( )
private

Definition at line 1190 of file BDSComponentFactory.cc.

◆ CreateEllipticalCollimator()

BDSAcceleratorComponent * BDSComponentFactory::CreateEllipticalCollimator ( )
private

Definition at line 1381 of file BDSComponentFactory.cc.

◆ CreateFieldTransform() [1/2]

G4Transform3D BDSComponentFactory::CreateFieldTransform ( const BDSTiltOffset tiltOffset)
static

Create a transform from a tilt offset. If nullptr, returns identity transform.

Definition at line 2299 of file BDSComponentFactory.cc.

References BDSTiltOffset::Transform3D().

Referenced by BDS::BuildDipoleFringe(), BDS::BuildRBendLine(), BDS::BuildSBendLine(), BDS::BuildSingleSBend(), CreateFieldTransform(), CreateMagnet(), and SetFieldDefinitions().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ CreateFieldTransform() [2/2]

G4Transform3D BDSComponentFactory::CreateFieldTransform ( GMAD::Element const *  el)
static

Create a transform for the field for a given element to account for the difference from the curvilinear coordinates for the tilt and offset of the magnet.

Definition at line 2304 of file BDSComponentFactory.cc.

References CreateFieldTransform(), and CreateTiltOffset().

Here is the call graph for this function:

◆ CreateGap()

BDSAcceleratorComponent * BDSComponentFactory::CreateGap ( )
private

Definition at line 1631 of file BDSComponentFactory.cc.

◆ CreateJawCollimator()

BDSAcceleratorComponent * BDSComponentFactory::CreateJawCollimator ( )
private

Definition at line 1403 of file BDSComponentFactory.cc.

◆ CreateKicker()

BDSAcceleratorComponent * BDSComponentFactory::CreateKicker ( KickerType  type)
private

Definition at line 784 of file BDSComponentFactory.cc.

◆ CreateLaser()

BDSAcceleratorComponent * BDSComponentFactory::CreateLaser ( )
private

Definition at line 1687 of file BDSComponentFactory.cc.

◆ CreateMagnet()

BDSMagnet * BDSComponentFactory::CreateMagnet ( const GMAD::Element el,
BDSMagnetStrength st,
BDSFieldType  fieldType,
BDSMagnetType  magnetType,
G4double  angle = 0.0,
const G4String &  nameSuffix = "" 
) const
private

◆ CreateMultipole()

BDSAcceleratorComponent * BDSComponentFactory::CreateMultipole ( )
private

Definition at line 1145 of file BDSComponentFactory.cc.

◆ CreateMuonSpoiler()

BDSAcceleratorComponent * BDSComponentFactory::CreateMuonSpoiler ( )
private

Definition at line 1422 of file BDSComponentFactory.cc.

◆ CreateOctupole()

BDSAcceleratorComponent * BDSComponentFactory::CreateOctupole ( )
private

Definition at line 1121 of file BDSComponentFactory.cc.

◆ CreateParallelTransporter()

BDSAcceleratorComponent * BDSComponentFactory::CreateParallelTransporter ( )
private

Definition at line 1338 of file BDSComponentFactory.cc.

◆ CreateQuad()

BDSAcceleratorComponent * BDSComponentFactory::CreateQuad ( )
private

Definition at line 1097 of file BDSComponentFactory.cc.

◆ CreateRBend()

BDSAcceleratorComponent * BDSComponentFactory::CreateRBend ( )
private

Definition at line 694 of file BDSComponentFactory.cc.

◆ CreateRectangularCollimator()

BDSAcceleratorComponent * BDSComponentFactory::CreateRectangularCollimator ( )
private

Definition at line 1344 of file BDSComponentFactory.cc.

◆ CreateRF()

BDSAcceleratorComponent * BDSComponentFactory::CreateRF ( G4double  currentArcLength)
private

Definition at line 518 of file BDSComponentFactory.cc.

◆ CreateRMatrix()

BDSAcceleratorComponent * BDSComponentFactory::CreateRMatrix ( )
private

Definition at line 1835 of file BDSComponentFactory.cc.

◆ CreateSBend()

BDSAcceleratorComponent * BDSComponentFactory::CreateSBend ( )
private

Definition at line 655 of file BDSComponentFactory.cc.

◆ CreateScreen()

BDSAcceleratorComponent * BDSComponentFactory::CreateScreen ( )
private

Definition at line 1701 of file BDSComponentFactory.cc.

◆ CreateSextupole()

BDSAcceleratorComponent * BDSComponentFactory::CreateSextupole ( )
private

Definition at line 1109 of file BDSComponentFactory.cc.

◆ CreateShield()

BDSAcceleratorComponent * BDSComponentFactory::CreateShield ( )
private

Definition at line 1460 of file BDSComponentFactory.cc.

◆ CreateSolenoid()

BDSAcceleratorComponent * BDSComponentFactory::CreateSolenoid ( )
private

Definition at line 1209 of file BDSComponentFactory.cc.

◆ CreateTarget()

BDSAcceleratorComponent * BDSComponentFactory::CreateTarget ( )
private

Definition at line 1365 of file BDSComponentFactory.cc.

◆ CreateTeleporter()

BDSAcceleratorComponent * BDSComponentFactory::CreateTeleporter ( const G4double  teleporterLength,
const G4double  teleporterWidth,
const G4Transform3D &  transformIn 
)

Public creation for object that accounts for slight offset between ends of a ring. The z component of the delta three vector is used for the length of the teleporter.

Definition at line 447 of file BDSComponentFactory.cc.

References brho.

Referenced by BDSDetectorConstruction::BuildBeamline().

Here is the caller graph for this function:

◆ CreateTerminator()

BDSAcceleratorComponent * BDSComponentFactory::CreateTerminator ( G4double  witdth)

Public creation for object that dynamically stops all particles once the primary has completed a certain number of turns.

Definition at line 1827 of file BDSComponentFactory.cc.

Referenced by BDSDetectorConstruction::BuildBeamline().

Here is the caller graph for this function:

◆ CreateThinMultipole()

BDSAcceleratorComponent * BDSComponentFactory::CreateThinMultipole ( G4double  angleIn)
private

Definition at line 1156 of file BDSComponentFactory.cc.

◆ CreateThinRMatrix() [1/2]

BDSAcceleratorComponent * BDSComponentFactory::CreateThinRMatrix ( G4double  angleIn,
BDSMagnetStrength stIn,
const G4String &  name,
BDSIntegratorType  intType = BDSIntegratorType::rmatrixthin,
BDSFieldType  fieldType = BDSFieldType::rmatrix,
G4double  beamPipeRadius = 0 
)
private

Definition at line 1871 of file BDSComponentFactory.cc.

◆ CreateThinRMatrix() [2/2]

BDSAcceleratorComponent * BDSComponentFactory::CreateThinRMatrix ( G4double  angleIn,
const G4String &  name 
)
private

Definition at line 1864 of file BDSComponentFactory.cc.

◆ CreateTiltOffset()

BDSTiltOffset * BDSComponentFactory::CreateTiltOffset ( GMAD::Element const *  el)
static

Create the tilt and offset information object by inspecting the parser element.

Definition at line 2284 of file BDSComponentFactory.cc.

References BDS::IsFinite(), GMAD::Element::offsetX, GMAD::Element::offsetY, and GMAD::Element::tilt.

Referenced by BDSDetectorConstruction::BuildBeamline(), and CreateFieldTransform().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ CreateTransform3D()

BDSAcceleratorComponent * BDSComponentFactory::CreateTransform3D ( )
private

Definition at line 1802 of file BDSComponentFactory.cc.

◆ CreateUndulator()

BDSAcceleratorComponent * BDSComponentFactory::CreateUndulator ( )
private

Definition at line 1550 of file BDSComponentFactory.cc.

◆ CreateWireScanner()

BDSAcceleratorComponent * BDSComponentFactory::CreateWireScanner ( )
private

Definition at line 1528 of file BDSComponentFactory.cc.

◆ FieldFromAngle()

G4double BDSComponentFactory::FieldFromAngle ( const G4double  angle,
const G4double  arcLength 
) const
private

Calculate the field from a given angle through a length of field - uses member rigidity and charge. Length & angle in g4 m / rad units.

Definition at line 2721 of file BDSComponentFactory.cc.

References brho, and BDS::IsFinite().

Referenced by CalculateAngleAndFieldSBend().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ GetKickValue()

void BDSComponentFactory::GetKickValue ( G4double &  hkick,
G4double &  vkick,
const KickerType  type 
) const
private

Pull out the right value - either 'kick' or 'h/vkick' for the appropriate type of kicker from the current member element.

Definition at line 744 of file BDSComponentFactory.cc.

References GMAD::Element::angle, element, elementName, GMAD::Element::hkick, BDS::IsFinite(), GMAD::Element::kick, and GMAD::Element::vkick.

Here is the call graph for this function:

◆ HasSufficientMinimumLength()

G4bool BDSComponentFactory::HasSufficientMinimumLength ( GMAD::Element const *  el,
G4bool  printWarning = true 
)
private

Test the component length is sufficient for practical construction.

Definition at line 1971 of file BDSComponentFactory.cc.

References GMAD::Element::l.

Referenced by CreateComponent().

Here is the caller graph for this function:

◆ IncomingFaceAngle()

G4double BDSComponentFactory::IncomingFaceAngle ( const GMAD::Element el) const
private

Calculate the incoming angel of the face (in the horizontal plane) for a given element. Calculates the bend angle and applies e1 / e2 pole face rotations the correct way depending on sign of angle. The angle is w.r.t. incoming curvilinear coordinates, so for an rbend with e1=0, the returned angle will be half the bend angle. For an sbend, with e1=0, it'll be 0.

Definition at line 2883 of file BDSComponentFactory.cc.

References BendAngle(), GMAD::Element::e1, BDSGlobalConstants::Instance(), integratorSet, BDS::IsFinite(), BDSIntegratorSet::IsMatrixIntegratorSet(), GMAD::Element::k1, and GMAD::Element::type.

Referenced by CreateComponent().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ MagnetGeometryType()

BDSMagnetGeometryType BDSComponentFactory::MagnetGeometryType ( const GMAD::Element el)
static

Determine the magnet geometry type. If not specified or the global option to ignore local magnet geometry definitions is on, then the global default is used

Definition at line 2114 of file BDSComponentFactory.cc.

References BDS::DetermineMagnetGeometryType(), and BDSGlobalConstants::Instance().

Referenced by PrepareMagnetOuterInfo(), and YokeOnLeft().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ OutgoingFaceAngle()

G4double BDSComponentFactory::OutgoingFaceAngle ( const GMAD::Element el) const
private

Calculate the outgoing angle of the face (in the horizontal plane) for a given element. Calculates the bend angle and applies e1 / e2 pole face rotations the correct way depending on sign of angle. The angle is w.r.t. outgoing curvilinear coordinates, so for an rbend with e2=0, the returned angle will be half the bend angle. For an sbend, with e2=0, it'll be 0.

Definition at line 2843 of file BDSComponentFactory.cc.

References BendAngle(), GMAD::Element::e2, BDSGlobalConstants::Instance(), integratorSet, BDS::IsFinite(), BDSIntegratorSet::IsMatrixIntegratorSet(), GMAD::Element::k1, and GMAD::Element::type.

Referenced by CreateComponent().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ PoleFaceRotationsNotTooLarge()

void BDSComponentFactory::PoleFaceRotationsNotTooLarge ( const GMAD::Element el,
G4double  maxAngle = 0.5*CLHEP::halfpi 
)
static

Check whether the pole face rotation angles are too big for practical construction.

Definition at line 1984 of file BDSComponentFactory.cc.

References GMAD::Element::e1, GMAD::Element::e2, and element.

◆ PrepareBeamPipeInfo() [1/2]

BDSBeamPipeInfo * BDSComponentFactory::PrepareBeamPipeInfo ( GMAD::Element const *  el,
const G4ThreeVector &  inputFaceNormal = G4ThreeVector(0,0,-1),
const G4ThreeVector &  outputFaceNormal = G4ThreeVector(0,0,1) 
)
static

◆ PrepareBeamPipeInfo() [2/2]

BDSBeamPipeInfo * BDSComponentFactory::PrepareBeamPipeInfo ( GMAD::Element const *  el,
G4double  angleIn,
G4double  angleOut 
)
static

Interface to other PrepareBeamPipeInfo() for convenience to avoid preparing face normal vectors repeatedly.

Definition at line 2275 of file BDSComponentFactory.cc.

References BDS::CalculateFaces(), and PrepareBeamPipeInfo().

Here is the call graph for this function:

◆ PrepareCavityModelInfo()

BDSCavityInfo * BDSComponentFactory::PrepareCavityModelInfo ( GMAD::Element const *  el,
G4double  frequency 
) const
private

Utility function to prepare model info. Retrieve from cache of ones translated parser objects or create a default based on the element's aperture if none specified. Will always return a unique object that's not owned by this class. We need the frequency in case there are no good defaults and we'll make the cavity size according to the wavelength of the rf field.

Definition at line 2413 of file BDSComponentFactory.cc.

References cavityInfos, GMAD::Element::cavityModel, elementName, BDSCavityInfo::equatorRadius, BDSMaterials::GetMaterial(), BDSMaterials::Instance(), lengthSafety, BDSCavityInfo::material, PrepareCavityModelInfoForElement(), PrepareHorizontalWidth(), and BDSCavityInfo::thickness.

Here is the call graph for this function:

◆ PrepareCavityModelInfoForElement()

BDSCavityInfo * BDSComponentFactory::PrepareCavityModelInfoForElement ( GMAD::Element const *  el,
G4double  frequency 
) const
private

Create a default cavity model based on an element's aperture and material. Will always return a unique object that's not owned by this class.

prepare aperture information for this element to base default cavity on.

Definition at line 2459 of file BDSComponentFactory.cc.

References BDSBeamPipeInfo::aper1, BDSBeamPipeInfo::beamPipeThickness, BDSMaterials::Instance(), BDS::IsFinite(), GMAD::Element::l, PrepareBeamPipeInfo(), and PrepareHorizontalWidth().

Referenced by PrepareCavityModelInfo().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ PrepareCavityModels()

void BDSComponentFactory::PrepareCavityModels ( )
private

Prepare all RF cavity models in the component factory. Kept here and copies delivered. This class deletes them upon destruction.

Definition at line 2326 of file BDSComponentFactory.cc.

References cavityInfos, BDS::DetermineCavityType(), BDSMaterials::GetMaterial(), BDSMaterials::Instance(), and BDSParser::Instance().

Here is the call graph for this function:

◆ PrepareCavityStrength()

BDSMagnetStrength * BDSComponentFactory::PrepareCavityStrength ( GMAD::Element const *  el,
G4double  cavityLength,
G4double  currentArcLength,
BDSMagnetStrength *&  fringeIn,
BDSMagnetStrength *&  fringeOut 
) const
private

Utility function to prepare field strength object for rf cavity. This takes a pointer for both incoming and outgoing strengths that this function will allocate by reference.

Definition at line 2509 of file BDSComponentFactory.cc.

References GMAD::Element::E, element, GMAD::Element::frequency, GMAD::Element::gradient, BDS::IsFinite(), GMAD::Element::l, GMAD::Element::phase, GMAD::Element::scaling, SetBeta0(), and GMAD::Element::tOffset.

Here is the call graph for this function:

◆ PrepareColour()

G4Colour * BDSComponentFactory::PrepareColour ( GMAD::Element const *  element)
static

Checks if colour is specified for element, else uses the default for that element type.

Definition at line 2586 of file BDSComponentFactory.cc.

References GMAD::Element::colour, BDSColours::GetColour(), BDSColours::Instance(), GMAD::Element::type, and GMAD::typestr().

Referenced by PrepareMagnetOuterInfo().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ PrepareColours()

void BDSComponentFactory::PrepareColours ( )
private

Prepare all colours defined in the parser.

Definition at line 2353 of file BDSComponentFactory.cc.

References coloursInitialised, BDSColours::DefineColour(), BDSColours::Instance(), and BDSParser::Instance().

Here is the call graph for this function:

◆ PrepareCrystalInfo()

BDSCrystalInfo * BDSComponentFactory::PrepareCrystalInfo ( const G4String &  crystalName) const

Utility function to prepare crystal recipe for an element. Produces a unique object this class doesn't own.

Definition at line 2397 of file BDSComponentFactory.cc.

References crystalInfos.

◆ PrepareCrystals()

void BDSComponentFactory::PrepareCrystals ( )
private

Prepare all crystals in defined the parser.

Definition at line 2370 of file BDSComponentFactory.cc.

References crystalInfos, BDS::DetermineCrystalType(), BDSMaterials::GetMaterial(), BDSMaterials::Instance(), and BDSParser::Instance().

Here is the call graph for this function:

◆ PrepareHorizontalWidth()

G4double BDSComponentFactory::PrepareHorizontalWidth ( GMAD::Element const *  el,
G4double  defaultHorizontalWidth = -1 
)
static

Prepare the element horizontal width in Geant4 units - if not set, use the global default.

Definition at line 2213 of file BDSComponentFactory.cc.

References BDSGlobalConstants::Instance().

Referenced by BDS::BuildSBendLine(), PrepareCavityModelInfo(), PrepareCavityModelInfoForElement(), and PrepareMagnetOuterInfo().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ PrepareMagnetOuterFieldInfo()

BDSFieldInfo * BDSComponentFactory::PrepareMagnetOuterFieldInfo ( const BDSMagnetStrength vacuumSt,
const BDSFieldType fieldType,
const BDSBeamPipeInfo bpInfo,
const BDSMagnetOuterInfo outerInfo,
const G4Transform3D &  fieldTransform,
const BDSIntegratorSet integratorSetIn,
G4double  brhoIn,
G4double  outerFieldScaling = 1.0 
)
static

Prepare the field definition for the yoke of a magnet.

Definition at line 2027 of file BDSComponentFactory.cc.

References BDSBeamPipeInfo::IndicativeRadius(), BDSGlobalConstants::Instance(), BDSIntegratorSet::Integrator(), BDSFieldInfo::SetFieldType(), and BDSTypeSafeEnum< def, inner >::underlying().

Referenced by BDS::BuildRBendLine(), BDS::BuildSBendLine(), and CreateMagnet().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ PrepareMagnetOuterInfo() [1/2]

BDSMagnetOuterInfo * BDSComponentFactory::PrepareMagnetOuterInfo ( const G4String &  elementNameIn,
const GMAD::Element el,
const BDSMagnetStrength st,
const BDSBeamPipeInfo beamPipe,
G4double  defaultHorizontalWidth = -1,
G4double  defaultVHRatio = 1.0,
G4double  defaultCoilWidthFraction = -1,
G4double  defaultCoilHeightFraction = -1 
)
static

Prepare the recipe for magnet outer geometry for an element. This uses a strength instance which (we assume) represents the element. Evenly splits angle between input and output faces.

Definition at line 2097 of file BDSComponentFactory.cc.

References PrepareMagnetOuterInfo(), and YokeOnLeft().

Referenced by BDS::BuildDipoleFringe(), BDS::BuildRBendLine(), BDS::BuildSBendLine(), BDS::BuildSingleSBend(), CreateMagnet(), and PrepareMagnetOuterInfo().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ PrepareMagnetOuterInfo() [2/2]

BDSMagnetOuterInfo * BDSComponentFactory::PrepareMagnetOuterInfo ( const G4String &  elementNameIn,
const GMAD::Element el,
const G4double  angleIn,
const G4double  angleOut,
const BDSBeamPipeInfo beamPipe,
const G4bool  yokeOnLeft = false,
G4double  defaultHorizontalWidth = -1,
G4double  defaultVHRatio = -1,
G4double  defaultCoilWidthFraction = -1,
G4double  defaultCoilHeightFraction = -1 
)
static

Prepare the recipe for magnet outer geometry with full control of the angled faces and which side the yoke is on. The angle in and out are the face angles relative to a chord for a straight section of outer magnet geometry.

Definition at line 2126 of file BDSComponentFactory.cc.

References GMAD::Element::autoColour, GMAD::Element::coilHeightFraction, GMAD::Element::coilWidthFraction, BDSMaterials::GetMaterial(), BDSMagnetOuterInfo::hStyle, GMAD::Element::hStyle, BDSBeamPipeInfo::IndicativeRadius(), BDSGlobalConstants::Instance(), BDSMaterials::Instance(), MagnetGeometryType(), PrepareColour(), PrepareHorizontalWidth(), GMAD::Element::stripOuterVolume, and GMAD::Element::vhRatio.

Here is the call graph for this function:

◆ PrepareMagnetStrengthForMultipoles()

BDSMagnetStrength * BDSComponentFactory::PrepareMagnetStrengthForMultipoles ( GMAD::Element const *  el) const
private

◆ PrepareMagnetStrengthForRMatrix()

BDSMagnetStrength * BDSComponentFactory::PrepareMagnetStrengthForRMatrix ( GMAD::Element const *  el) const
private

◆ PrepareMaterial() [1/2]

G4Material * BDSComponentFactory::PrepareMaterial ( GMAD::Element const *  element)
static

Try and get a material and exit if no such material.

Definition at line 2605 of file BDSComponentFactory.cc.

References BDSMaterials::GetMaterial(), and BDSMaterials::Instance().

Here is the call graph for this function:

◆ PrepareMaterial() [2/2]

G4Material * BDSComponentFactory::PrepareMaterial ( GMAD::Element const *  element,
const G4String &  defaultMaterialName 
)
static

Checks if a material is named in Element::material, else uses the supplied default.

Definition at line 2595 of file BDSComponentFactory.cc.

References BDSMaterials::GetMaterial(), and BDSMaterials::Instance().

Here is the call graph for this function:

◆ PrepareVacuumMaterial()

G4Material * BDSComponentFactory::PrepareVacuumMaterial ( GMAD::Element const *  el) const
private

Prepare the vacuum material from the element or resort to default in options.

Definition at line 2227 of file BDSComponentFactory.cc.

References element, BDSMaterials::GetMaterial(), BDSGlobalConstants::Instance(), BDSMaterials::Instance(), and GMAD::Element::vacuumMaterial.

Here is the call graph for this function:

◆ ScalingFieldOuter()

G4double BDSComponentFactory::ScalingFieldOuter ( const GMAD::Element ele)
static

Definition at line 2022 of file BDSComponentFactory.cc.

◆ SetBeta0()

void BDSComponentFactory::SetBeta0 ( BDSMagnetStrength stIn) const
inlineprivate

Simple setter used to add Beta0 to a strength instance.

Definition at line 214 of file BDSComponentFactory.hh.

References beta0.

Referenced by PrepareCavityStrength(), and PrepareMagnetStrengthForMultipoles().

Here is the caller graph for this function:

◆ SetFieldDefinitions()

void BDSComponentFactory::SetFieldDefinitions ( GMAD::Element const *  el,
BDSAcceleratorComponent component 
) const
private

Set the field definition on a BDSAcceleratorComponent from the string definition name in a parser element. In the case of a BDSMagnet, (exclusively) set the vacuum and outer field in place of the one general field.

Definition at line 2614 of file BDSComponentFactory.cc.

References BDSFieldInfo::CompoundBScaling(), CreateFieldTransform(), element, elementName, GMAD::Element::fieldAll, GMAD::Element::fieldOuter, GMAD::Element::fieldVacuum, BDSFieldFactory::Instance(), BDSFieldInfo::ProvideGlobal(), GMAD::Element::scalingFieldOuter, BDSAcceleratorComponent::SetField(), SetFieldDefinitions(), and BDSFieldInfo::SetTransformBeamline().

Referenced by CreateComponent(), and SetFieldDefinitions().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ YokeOnLeft()

G4bool BDSComponentFactory::YokeOnLeft ( const GMAD::Element el,
const BDSMagnetStrength st 
)
static

Determine which side the yoke of an asymmetric bend should go on based on the angle of the bend and the overriding setting in the element.

Definition at line 1995 of file BDSComponentFactory.cc.

References element, BDS::IsFinite(), and MagnetGeometryType().

Referenced by BDS::BuildRBendLine(), BDS::BuildSBendLine(), and PrepareMagnetOuterInfo().

Here is the call graph for this function:
Here is the caller graph for this function:

Field Documentation

◆ beta0

G4double BDSComponentFactory::beta0
private

Cache of relativisitic beta for primary particle.

Definition at line 206 of file BDSComponentFactory.hh.

Referenced by SetBeta0().

◆ brho

G4double BDSComponentFactory::brho
private

Rigidity in T*m (G4units) for beam particles.

Definition at line 205 of file BDSComponentFactory.hh.

Referenced by AngleFromField(), CalculateAngleAndFieldRBend(), CreateMagnet(), CreateTeleporter(), and FieldFromAngle().

◆ cavityInfos

std::map<G4String, BDSCavityInfo*> BDSComponentFactory::cavityInfos
private

Map of cavity model info instances by name.

Definition at line 336 of file BDSComponentFactory.hh.

Referenced by PrepareCavityModelInfo(), and PrepareCavityModels().

◆ coloursInitialised

G4bool BDSComponentFactory::coloursInitialised = false
staticprivate

Only allow colours to be constructed from parser definitions once. Static so we can use a component factory many times without calling multiple times.

Definition at line 408 of file BDSComponentFactory.hh.

Referenced by PrepareColours().

◆ crystalInfos

std::map<G4String, BDSCrystalInfo*> BDSComponentFactory::crystalInfos
private

Maps of crystal info instances by name.

Definition at line 339 of file BDSComponentFactory.hh.

Referenced by PrepareCrystalInfo(), and PrepareCrystals().

◆ designParticle

const BDSParticleDefinition* BDSComponentFactory::designParticle
private

Particle w.r.t. which elements are built.

Definition at line 204 of file BDSComponentFactory.hh.

◆ element

GMAD::Element const* BDSComponentFactory::element = nullptr
private

◆ elementName

G4String BDSComponentFactory::elementName
private

Variable used to pass around the possibly modified name of an element.

Definition at line 404 of file BDSComponentFactory.hh.

Referenced by CreateComponent(), CreateMagnet(), GetKickValue(), PrepareCavityModelInfo(), and SetFieldDefinitions().

◆ includeFringeFields

G4bool BDSComponentFactory::includeFringeFields
private

Cache of whether to include fringe fields.

Definition at line 210 of file BDSComponentFactory.hh.

Referenced by CreateComponent().

◆ integratorSet

const BDSIntegratorSet* BDSComponentFactory::integratorSet
private

Local copy of reference to integrator set to use.

Definition at line 342 of file BDSComponentFactory.hh.

Referenced by CreateMagnet(), IncomingFaceAngle(), and OutgoingFaceAngle().

◆ integratorSetType

const BDSIntegratorSetType BDSComponentFactory::integratorSetType
private

Local copy of enum of the integrator set, i.e. which one it is specifically.

Definition at line 345 of file BDSComponentFactory.hh.

◆ lengthSafety

G4double BDSComponentFactory::lengthSafety
private

Length safety from global constants.

Definition at line 208 of file BDSComponentFactory.hh.

Referenced by PrepareCavityModelInfo().

◆ modifiedElements

std::map<G4String, G4int> BDSComponentFactory::modifiedElements
private

Registry of modified elements stored by original name and number of times modified - 0 counting. This is so when we modify elements beyond their definition they get a unique name as they're literally not the same object as the unmodified one so they don't share the placement counter for unique naming. This allows accurate geometry trees in the visualiser.

Definition at line 401 of file BDSComponentFactory.hh.

Referenced by CreateComponent().

◆ nextElement

GMAD::Element const* BDSComponentFactory::nextElement = nullptr
private

element access to previous element (can be nullptr)

Definition at line 221 of file BDSComponentFactory.hh.

Referenced by CreateComponent().

◆ prevElement

GMAD::Element const* BDSComponentFactory::prevElement = nullptr
private

element access to previous element (can be nullptr)

Definition at line 219 of file BDSComponentFactory.hh.

Referenced by CreateComponent().

◆ thinElementLength

G4double BDSComponentFactory::thinElementLength
private

Length of a thin element.

Definition at line 209 of file BDSComponentFactory.hh.

◆ userComponentFactory

BDSComponentFactoryUser* BDSComponentFactory::userComponentFactory
private

User component factory if any.

Definition at line 207 of file BDSComponentFactory.hh.

Referenced by CreateComponent().

◆ yokeFields

G4bool BDSComponentFactory::yokeFields
private

Cache of whether to include yoke magnetic fields.

Definition at line 211 of file BDSComponentFactory.hh.

Referenced by CreateMagnet().


The documentation for this class was generated from the following files: