OPAL (Object Oriented Parallel Accelerator Library) 2024.2
OPAL
Ring Class Reference

Ring describes a ring type geometry for tracking. More...

#include <Ring.h>

Inheritance diagram for Ring:
Inheritance graph
Collaboration diagram for Ring:
Collaboration graph

Public Member Functions

 Ring (const std::string &ring)
 Constructor. More...
 
 Ring (const Ring &ring)
 Copy constructor. More...
 
virtual ~Ring ()
 Destructor - deletes lossDS_m if not nullptr. More...
 
virtual bool apply (const size_t &id, const double &t, Vector_t &E, Vector_t &B) override
 Overwrite data in vector E and B with electric and magnetic field. More...
 
virtual bool apply (const Vector_t &R, const Vector_t &P, const double &t, Vector_t &E, Vector_t &B) override
 Overwrite data in vector E and B with electromagnetic field at point R. More...
 
virtual void initialise (PartBunchBase< double, 3 > *bunch, double &startField, double &endField) override
 Initialise the Ring. More...
 
virtual void initialise (PartBunchBase< double, 3 > *bunch)
 Initialise the Ring - set the bunch and allocate a new LossDataSink. More...
 
virtual void finalise () override
 Clean up the Ring. More...
 
virtual bool bends () const override
 Returns true - Ring is assumed to bend particles, being a ring. More...
 
virtual void accept (BeamlineVisitor &visitor) const override
 Accept the BeamlineVisitor. More...
 
virtual void getDimensions (double &zBegin, double &zEnd) const override
 Not implemented - always throws an exception. More...
 
virtual ElementBaseclone () const override
 Inherited copy constructor. More...
 
void appendElement (const Component &element)
 Add element to the ring. More...
 
virtual EMFieldgetField () override
 Not implemented, throws an exception. More...
 
virtual const EMFieldgetField () const override
 Not implemented, throws an exception. More...
 
virtual PlanarArcGeometrygetGeometry () override
 Not implemented. More...
 
virtual const PlanarArcGeometrygetGeometry () const override
 Not implemented. More...
 
void setLossDataSink (LossDataSink *sink)
 Set LossDataSink to sink. More...
 
PartBunchBase< double, 3 > * getLossDataSink () const
 Get pointer to lossDataSink. More...
 
void setRefPartBunch (PartBunchBase< double, 3 > *bunch)
 Set RefPartBunchBase<double, 3> to bunch. More...
 
PartBunchBase< double, 3 > * getRefPartBunch () const
 Get pointer to RefPartBunchBase<double, 3> from the bunch. More...
 
void setHarmonicNumber (double cyclHarm)
 Set the harmonic number for RF (number of bunches in the ring) More...
 
double getHarmonicNumber ()
 Get the harmonic number for RF (number of bunches in the ring) More...
 
void setRFFreq (double rfFreq)
 Set the nominal RF frequency. More...
 
double getRFFreq () const
 Get the nominal RF frequency. More...
 
void setBeamRInit (double rInit)
 Set the initial beam radius. More...
 
double getBeamRInit () const
 Get the initial beam radius. More...
 
void setBeamPhiInit (double phiInit)
 Set the initial beam azimuthal angle. More...
 
double getBeamPhiInit () const
 Get the initial beam azimuthal angle. More...
 
void setBeamThetaInit (double thetaInit)
 Set the initial beam rotation relative to the tangent vector. More...
 
double getBeamThetaInit () const
 Get the initial beam rotation relative to the tangent vector. More...
 
void setBeamPRInit (double pRInit)
 Set the initial beam radial momentum. More...
 
double getBeamPRInit () const
 Get the initial beam radial momentum. More...
 
void setLatticeRInit (double rInit)
 Set the initial element's radius. More...
 
double getLatticeRInit () const
 Get the initial element's radius. More...
 
void setLatticePhiInit (double phiInit)
 Set the initial element's azimuthal angle. More...
 
double getLatticePhiInit () const
 Get the initial element's azimuthal angle. More...
 
Vector_t getNextPosition () const
 Get the initial element's start position in cartesian coordinates. More...
 
Vector_t getNextNormal () const
 Get the initial element's start normal in cartesian coordinates. More...
 
void setLatticeThetaInit (double thetaInit)
 Set the first element's horizontal angle. More...
 
double getLatticeThetaInit () const
 Get the first element's horizontal angle. More...
 
void setSymmetry (double symmetry)
 Set the rotational symmetry of the ring (number of cells) More...
 
void setScale (double scale)
 Set the scaling factor for the fields. More...
 
double getSymmetry () const
 Get the rotational symmetry of the ring (number of cells) More...
 
void setIsClosed (bool isClosed)
 Set flag for closure checking. More...
 
double getIsClosed () const
 Get flag for closure checking. More...
 
void setRingAperture (double minR, double maxR)
 Set the ring aperture limits. More...
 
double getRingMinR () const
 Get the ring minimum. More...
 
double getRingMaxR () const
 Get the ring maximum. More...
 
void lockRing ()
 Lock the ring. More...
 
RingSectiongetSection (int i) const
 Return ith section. More...
 
RingSectiongetLastSectionPlaced () const
 Get the last section placed or nullptr if no sections were placed yet. More...
 
size_t getNumberOfRingSections () const
 Get number of RingSections. More...
 
std::vector< RingSection * > getSectionsAt (const Vector_t &pos)
 Get the list of sections at position pos. More...
 
EVector Efield (const Point3D &P) const
 Return the field in a point. More...
 
EVector Efield (const Point3D &P, double t) const
 Return the field in a point. More...
 
BVector Bfield (const Point3D &P) const
 Return the field in a point. More...
 
BVector Bfield (const Point3D &P, double t) const
 Return the field in a point. More...
 
EBVectors EBfield (const Point3D &P) const
 Return the field in a point. More...
 
EBVectors EBfield (const Point3D &P, double t) const
 Return the field in a point. More...
 
virtual bool applyToReferenceParticle (const Vector_t &R, const Vector_t &P, const double &t, Vector_t &E, Vector_t &B)
 
virtual bool getPotential (const Vector_t &, const double &, Vector_t &, double &)
 Calculate the four-potential at some position relative to the component. More...
 
virtual double getDesignEnergy () const
 
virtual void setDesignEnergy (const double &energy, bool changeable=true)
 
virtual void goOnline (const double &kineticEnergy)
 
virtual void goOffline ()
 
virtual bool Online ()
 
virtual ElementType getType () const override
 Get element type std::string. More...
 
virtual const ElementBasegetDesign () const
 Return design element. More...
 
virtual void trackBunch (PartBunchBase< double, 3 > *bunch, const PartData &, bool revBeam, bool revTrack) const
 Track particle bunch. More...
 
virtual void trackMap (FVps< double, 6 > &map, const PartData &, bool revBeam, bool revTrack) const
 Track a map. More...
 
void setExitFaceSlope (const double &)
 
virtual const std::string & getName () const
 Get element name. More...
 
virtual void setName (const std::string &name)
 Set element name. More...
 
std::string getTypeString () const
 
virtual double getArcLength () const
 Get arc length. More...
 
virtual double getElementLength () const
 Get design length. More...
 
virtual void setElementLength (double length)
 Set design length. More...
 
virtual void getElementDimensions (double &begin, double &end) const
 
virtual double getOrigin () const
 Get origin position. More...
 
virtual double getEntrance () const
 Get entrance position. More...
 
virtual double getExit () const
 Get exit position. More...
 
virtual Euclid3D getTransform (double fromS, double toS) const
 Get transform. More...
 
virtual Euclid3D getTransform (double s) const
 Get transform. More...
 
virtual Euclid3D getTotalTransform () const
 Get transform. More...
 
virtual Euclid3D getEntranceFrame () const
 Get transform. More...
 
virtual Euclid3D getExitFrame () const
 Get transform. More...
 
virtual Euclid3D getEntrancePatch () const
 Get patch. More...
 
virtual Euclid3D getExitPatch () const
 Get patch. More...
 
virtual double getAttribute (const std::string &aKey) const
 Get attribute value. More...
 
virtual bool hasAttribute (const std::string &aKey) const
 Test for existence of an attribute. More...
 
virtual void removeAttribute (const std::string &aKey)
 Remove an existing attribute. More...
 
virtual void setAttribute (const std::string &aKey, double val)
 Set value of an attribute. More...
 
virtual ChannelgetChannel (const std::string &aKey, bool create=false)
 Construct a read/write channel. More...
 
virtual const ConstChannelgetConstChannel (const std::string &aKey) const
 Construct a read-only channel. More...
 
virtual ElementBasecopyStructure ()
 Make a structural copy. More...
 
bool isSharable () const
 Test if the element can be shared. More...
 
virtual void makeSharable ()
 Set sharable flag. More...
 
bool update (const AttributeSet &)
 Update element. More...
 
virtual void setBoundaryGeometry (BoundaryGeometry *geo)
 attach a boundary geometry field to the element More...
 
virtual BoundaryGeometrygetBoundaryGeometry () const
 return the attached boundary geometrt object if there is any More...
 
virtual bool hasBoundaryGeometry () const
 
virtual void setWake (WakeFunction *wf)
 attach a wake field to the element More...
 
virtual WakeFunctiongetWake () const
 return the attached wake object if there is any More...
 
virtual bool hasWake () const
 
virtual void setParticleMatterInteraction (ParticleMatterInteractionHandler *spys)
 
virtual ParticleMatterInteractionHandlergetParticleMatterInteraction () const
 
virtual bool hasParticleMatterInteraction () const
 
void setCSTrafoGlobal2Local (const CoordinateSystemTrafo &ori)
 
CoordinateSystemTrafo getCSTrafoGlobal2Local () const
 
void releasePosition ()
 
void fixPosition ()
 
bool isPositioned () const
 
virtual CoordinateSystemTrafo getEdgeToBegin () const
 
virtual CoordinateSystemTrafo getEdgeToEnd () const
 
void setAperture (const ApertureType &type, const std::vector< double > &args)
 
std::pair< ApertureType, std::vector< double > > getAperture () const
 
virtual bool isInside (const Vector_t &r) const
 
void setMisalignment (const CoordinateSystemTrafo &cst)
 
void getMisalignment (double &x, double &y, double &s) const
 
CoordinateSystemTrafo getMisalignment () const
 
void setActionRange (const std::queue< std::pair< double, double > > &range)
 
void setCurrentSCoordinate (double s)
 
void setRotationAboutZ (double rotation)
 Set rotation about z axis in bend frame. More...
 
double getRotationAboutZ () const
 
virtual BoundingBox getBoundingBoxInLabCoords () const
 
virtual int getRequiredNumberOfTimeSteps () const
 
void setOutputFN (std::string fn)
 Set output filename. More...
 
std::string getOutputFN () const
 Get output filename. More...
 
void setFlagDeleteOnTransverseExit (bool=true)
 
bool getFlagDeleteOnTransverseExit () const
 
int addReference () const
 Increment reference count. More...
 
int removeReference () const
 Decrement the reference count. More...
 
bool isShared () const
 Test for sharing. More...
 
void setElementPosition (double elemedge)
 Access to ELEMEDGE attribute. More...
 
double getElementPosition () const
 
bool isElementPositionSet () const
 

Static Public Member Functions

static Vector_t convert (const Vector3D &vec)
 Convert from a Vector3D to a Vector_t. More...
 
static Vector3D convert (const Vector_t &vec)
 Convert from a Vector_t to a Vector3D. More...
 
static std::string getTypeString (ElementType type)
 

Protected Member Functions

bool isInsideTransverse (const Vector_t &r) const
 

Protected Attributes

double exit_face_slope_m
 
PartBunchBase< double, 3 > * RefPartBunch_m
 
bool online_m
 
bool shareFlag
 
CoordinateSystemTrafo csTrafoGlobal2Local_m
 
CoordinateSystemTrafo misalignment_m
 
std::pair< ApertureType, std::vector< double > > aperture_m
 
double elementEdge_m
 
double rotationZAxis_m
 

Static Protected Attributes

static const std::vector< double > defaultAperture_m
 

Private Member Functions

void resetAzimuths ()
 
void checkAndClose ()
 
void buildRingSections ()
 
void rotateToCyclCoordinates (Euclid3D &euclid3d) const
 
Vector_t getStartPosition () const
 
Vector_t getStartNormal () const
 
 Ring ()
 Disabled. More...
 
Ringoperator= (const Ring &ring)
 Disabled. More...
 
void checkMidplane (Euclid3D delta) const
 
Rotation3D getRotationStartToEnd (Euclid3D delta) const
 

Static Private Member Functions

static bool sectionCompare (RingSection const *const sec1, RingSection const *const sec2)
 

Private Attributes

PlanarArcGeometry planarArcGeometry_m
 
PartBunchBase< double, 3 > * refPartBunch_m
 
LossDataSinklossDS_m
 
double beamRInit_m
 
double beamPRInit_m
 
double beamPhiInit_m
 
double beamThetaInit_m
 
double latticeRInit_m
 
double latticePhiInit_m
 
double latticeThetaInit_m
 
bool willDoAperture_m = false
 
double minR2_m
 
double maxR2_m
 
bool isLocked_m
 
bool isClosed_m
 
int symmetry_m
 
double scale_m = 1.
 
double cyclHarm_m
 
double rfFreq_m
 
double phiStep_m
 
std::vector< RingSectionListringSections_m
 
RingSectionList section_list_m
 
std::string elementID
 
AttributeSet userAttribs
 
WakeFunctionwake_m
 
BoundaryGeometrybgeometry_m
 
ParticleMatterInteractionHandlerparmatint_m
 
bool positionIsFixed
 
std::queue< std::pair< double, double > > actionRange_m
 
std::string outputfn_m
 The name of the outputfile. More...
 
bool deleteOnTransverseExit_m = true
 
int refCount
 
double elementPosition_m
 ELEMEDGE attribute. More...
 
bool elemedgeSet_m
 

Static Private Attributes

static const double lengthTolerance_m = 1e-2
 
static const double angleTolerance_m = 1e-2
 
static const std::map< ElementType, std::string > elementTypeToString_s
 

Detailed Description

Ring describes a ring type geometry for tracking.

Ring describes a ring type geometry for tracking. Ring provides the necessary interfaces for e.g. OPAL-CYCL to track through the ring geometry, while enabling the user to add arbitrary field elements in a closed geometry.

Ring uses similar routines to OPAL-T OpalBeamline class to set up geometry; note that as OPAL-CYCL places the beam in an x-y geometry we place in an x-y geometry for Ring (i.e. the axis of the ring is by default the z-axis). So far only placement of elements in the midplane is supported. It is not possible to give vertical displacements or rotations, or add elements that might create vertical displacements and rotations.

Also aim to maintain backwards compatibility with Cyclotron (i.e. use ParallelCyclotronTracker)

Definition at line 53 of file Ring.h.

Constructor & Destructor Documentation

◆ Ring() [1/3]

Ring::Ring ( const std::string &  ring)

Constructor.

Parameters
ringName of the ring as defined in the input file

Definition at line 41 of file Ring.cpp.

References setRefPartBunch().

Here is the call graph for this function:

◆ Ring() [2/3]

Ring::Ring ( const Ring ring)

Copy constructor.

Can't copy LossDataSink so throw exception if this is set

Definition at line 59 of file Ring.cpp.

References buildRingSections(), lossDS_m, refPartBunch_m, section_list_m, and setRefPartBunch().

Here is the call graph for this function:

◆ ~Ring()

Ring::~Ring ( )
virtual

Destructor - deletes lossDS_m if not nullptr.

Definition at line 90 of file Ring.cpp.

References section_list_m.

◆ Ring() [3/3]

Ring::Ring ( )
private

Disabled.

Referenced by clone().

Member Function Documentation

◆ accept()

void Ring::accept ( BeamlineVisitor visitor) const
overridevirtual

Accept the BeamlineVisitor.

Just calls visitRing function on the visitor. I guess the point of this function is that it enables us to store a pointer to the visitor object or something

Implements ElementBase.

Definition at line 55 of file Ring.cpp.

References BeamlineVisitor::visitRing().

Here is the call graph for this function:

◆ addReference()

int RCObject::addReference ( ) const
inlineinherited

Increment reference count.

Definition at line 83 of file RCObject.h.

References RCObject::refCount.

Referenced by Pointer< Object >::operator=(), and Pointer< Object >::unique().

◆ appendElement()

void Ring::appendElement ( const Component element)

Add element to the ring.

Add element to the ring. Elements are assumed to occupy a region of space defined by a (flat) plane at the start and a plane at the end, both infinite in extent. The position and rotation of these planes are defined according to the Component geometry given by element.getGeometry().

Caller owns memory allocated to element - Ring makes a copy.

Throws an exception if the geometry would bend the element out of the midplane (elements out of midplane are not yet supported). Note that BeamlineGeometry considers midplane to be x-z, whereas Ring considers midplane to be x-y; we apply a rotation during set up.

The element is assumed to extend not beyond the element geometry; Ring applies a bounding box based on the element geometry, if there are field maps expanding outside this region they may get cut.

Definition at line 234 of file Ring.cpp.

References atan2(), checkMidplane(), ElementBase::clone(), cos(), endl(), Rotation3D::getAxis(), RingSection::getComponent(), RingSection::getEndNormal(), RingSection::getEndPosition(), ElementBase::getGeometry(), ElementBase::getName(), getNextNormal(), getNextPosition(), Euclid3D::getRotation(), RingSection::getStartNormal(), RingSection::getStartPosition(), BGeometryBase::getTotalTransform(), Euclid3D::getVector(), gmsg, RingSection::handleOffset(), isLocked_m, rotateToCyclCoordinates(), section_list_m, RingSection::setComponent(), RingSection::setComponentOrientation(), RingSection::setComponentPosition(), RingSection::setEndNormal(), RingSection::setEndPosition(), RingSection::setStartNormal(), RingSection::setStartPosition(), and sin().

Referenced by lockRing(), ParallelCyclotronTracker::visitMultipoleT(), ParallelCyclotronTracker::visitOffset(), ParallelCyclotronTracker::visitSBend3D(), ParallelCyclotronTracker::visitScalingFFAMagnet(), ParallelCyclotronTracker::visitVariableRFCavity(), ParallelCyclotronTracker::visitVariableRFCavityFringeField(), and ParallelCyclotronTracker::visitVerticalFFAMagnet().

Here is the call graph for this function:

◆ apply() [1/2]

bool Ring::apply ( const size_t &  id,
const double &  t,
Vector_t E,
Vector_t B 
)
overridevirtual

Overwrite data in vector E and B with electric and magnetic field.

Parameters
iindex of item in RefPartBunch_m - particle bunch
ttime
Earray where electric field vector is stored - any existing data is overwritten
Barray where magnetic field vector is stored - any existing data is overwritten
Returns
false if particle is outside of the field map apertures, else true. If particle is off the field maps, then set flag on the particle "Bin" data to -1 and store in LossDataSink

Reimplemented from Component.

Definition at line 95 of file Ring.cpp.

References LossDataSink::addParticle(), apply(), PartBunchBase< T, Dim >::Bin, endl(), ElementBase::getName(), gmsgALL, level4(), lossDS_m, PartBunchBase< T, Dim >::M, PartBunchBase< T, Dim >::P, PartBunchBase< T, Dim >::Q, PartBunchBase< T, Dim >::R, and refPartBunch_m.

Referenced by apply().

Here is the call graph for this function:

◆ apply() [2/2]

bool Ring::apply ( const Vector_t R,
const Vector_t P,
const double &  t,
Vector_t E,
Vector_t B 
)
overridevirtual

Overwrite data in vector E and B with electromagnetic field at point R.

Parameters
R3 vector position at which the field is found in Cartesian coordinates (i.e. x, y, z with z=vertical)
P3 vector momentum
centroidunknown, but not used - bunch mean maybe?
ttime
Evector where electric field vector will be stored - any existing data is overwritten
Bvector where magnetic field vector will be stored - any existing data is overwritten
Returns
false if particle is outside of the ring aperture, else true. If particle is off the field maps, then set flag on the particle "Bin" data to -1

Reimplemented from Component.

Definition at line 116 of file Ring.cpp.

References PartBunchBase< T, Dim >::get_centroid(), getSectionsAt(), maxR2_m, Attrib::Distribution::R, refPartBunch_m, scale_m, and willDoAperture_m.

Here is the call graph for this function:

◆ applyToReferenceParticle()

bool Component::applyToReferenceParticle ( const Vector_t R,
const Vector_t P,
const double &  t,
Vector_t E,
Vector_t B 
)
virtualinherited

◆ bends()

virtual bool Ring::bends ( ) const
inlineoverridevirtual

Returns true - Ring is assumed to bend particles, being a ring.

Implements Component.

Definition at line 131 of file Ring.h.

◆ Bfield() [1/2]

BVector Component::Bfield ( const Point3D P) const
inlineinherited

Return the field in a point.

Definition at line 202 of file Component.h.

References EMField::Bfield(), and Component::getField().

Here is the call graph for this function:

◆ Bfield() [2/2]

BVector Component::Bfield ( const Point3D P,
double  t 
) const
inlineinherited

Return the field in a point.

Definition at line 208 of file Component.h.

References EMField::Bfield(), and Component::getField().

Here is the call graph for this function:

◆ buildRingSections()

void Ring::buildRingSections ( )
private

Definition at line 351 of file Ring.cpp.

References phiStep_m, ringSections_m, section_list_m, and Physics::two_pi.

Referenced by lockRing(), and Ring().

◆ checkAndClose()

void Ring::checkAndClose ( )
private

Definition at line 336 of file Ring.cpp.

References abs(), angleTolerance_m, lengthTolerance_m, and section_list_m.

Referenced by lockRing().

Here is the call graph for this function:

◆ checkMidplane()

void Ring::checkMidplane ( Euclid3D  delta) const
private

Definition at line 187 of file Ring.cpp.

References abs(), angleTolerance_m, Rotation3D::getAxis(), Euclid3D::getRotation(), Euclid3D::getVector(), and lengthTolerance_m.

Referenced by appendElement().

Here is the call graph for this function:

◆ clone()

virtual ElementBase * Ring::clone ( ) const
inlineoverridevirtual

Inherited copy constructor.

Implements ElementBase.

Definition at line 145 of file Ring.h.

References Ring().

Referenced by ParallelCyclotronTracker::visitRing().

Here is the call graph for this function:

◆ convert() [1/2]

Vector_t Ring::convert ( const Vector3D vec)
inlinestatic

Convert from a Vector3D to a Vector_t.

Definition at line 421 of file Ring.h.

◆ convert() [2/2]

Vector3D Ring::convert ( const Vector_t vec)
inlinestatic

Convert from a Vector_t to a Vector3D.

Definition at line 425 of file Ring.h.

◆ copyStructure()

ElementBase * ElementBase::copyStructure ( )
virtualinherited

Make a structural copy.

Reimplemented in TBeamline< T >.

Definition at line 244 of file ElementBase.cpp.

References ElementBase::clone(), and ElementBase::isSharable().

Referenced by Sequence::copy(), Line::parse(), SequenceParser::parseMember(), and Replacer::visitFlaggedElmPtr().

Here is the call graph for this function:

◆ EBfield() [1/2]

EBVectors Component::EBfield ( const Point3D P) const
inlineinherited

Return the field in a point.

Definition at line 211 of file Component.h.

References EMField::EBfield(), and Component::getField().

Here is the call graph for this function:

◆ EBfield() [2/2]

EBVectors Component::EBfield ( const Point3D P,
double  t 
) const
inlineinherited

Return the field in a point.

Definition at line 214 of file Component.h.

References EMField::EBfield(), and Component::getField().

Here is the call graph for this function:

◆ Efield() [1/2]

EVector Component::Efield ( const Point3D P) const
inlineinherited

Return the field in a point.

Definition at line 199 of file Component.h.

References EMField::Efield(), and Component::getField().

Here is the call graph for this function:

◆ Efield() [2/2]

EVector Component::Efield ( const Point3D P,
double  t 
) const
inlineinherited

Return the field in a point.

Definition at line 205 of file Component.h.

References EMField::Efield(), and Component::getField().

Here is the call graph for this function:

◆ finalise()

void Ring::finalise ( )
overridevirtual

Clean up the Ring.

Ring relinquishes RefPartBunchBase<double, 3> pointer and deletes LossDataSink

Implements Component.

Definition at line 161 of file Ring.cpp.

References lossDS_m, Component::online_m, LossDataSink::save(), and setLossDataSink().

Here is the call graph for this function:

◆ fixPosition()

void ElementBase::fixPosition ( )
inlineinherited

◆ getAperture()

std::pair< ApertureType, std::vector< double > > ElementBase::getAperture ( ) const
inlineinherited

Definition at line 525 of file ElementBase.h.

References ElementBase::aperture_m.

Referenced by MeshGenerator::add(), and Offset::operator=().

◆ getArcLength()

double ElementBase::getArcLength ( ) const
inlinevirtualinherited

Get arc length.

Reimplemented in MarkerRep, and TBeamline< T >.

Definition at line 411 of file ElementBase.h.

References BGeometryBase::getArcLength(), and ElementBase::getGeometry().

Referenced by BeamlineGeometry::getArcLength(), and TBeamline< T >::getTransform().

Here is the call graph for this function:

◆ getAttribute()

double ElementBase::getAttribute ( const std::string &  aKey) const
virtualinherited

Get attribute value.

Definition at line 187 of file ElementBase.cpp.

References ElementBase::getConstChannel().

Here is the call graph for this function:

◆ getBeamPhiInit()

double Ring::getBeamPhiInit ( ) const
inline

Get the initial beam azimuthal angle.

Definition at line 231 of file Ring.h.

References beamPhiInit_m.

Referenced by ParallelCyclotronTracker::visitRing().

◆ getBeamPRInit()

double Ring::getBeamPRInit ( ) const
inline

Get the initial beam radial momentum.

Definition at line 243 of file Ring.h.

References beamPRInit_m.

Referenced by ParallelCyclotronTracker::visitRing().

◆ getBeamRInit()

double Ring::getBeamRInit ( ) const
inline

Get the initial beam radius.

Definition at line 225 of file Ring.h.

References beamRInit_m.

Referenced by ParallelCyclotronTracker::visitRing().

◆ getBeamThetaInit()

double Ring::getBeamThetaInit ( ) const
inline

Get the initial beam rotation relative to the tangent vector.

Definition at line 237 of file Ring.h.

References beamThetaInit_m.

Referenced by ParallelCyclotronTracker::visitRing().

◆ getBoundaryGeometry()

BoundaryGeometry * ElementBase::getBoundaryGeometry ( ) const
inlinevirtualinherited

return the attached boundary geometrt object if there is any

Definition at line 475 of file ElementBase.h.

References ElementBase::bgeometry_m.

◆ getBoundingBoxInLabCoords()

BoundingBox ElementBase::getBoundingBoxInLabCoords ( ) const
virtualinherited

◆ getChannel()

◆ getConstChannel()

const ConstChannel * ElementBase::getConstChannel ( const std::string &  aKey) const
virtualinherited

Construct a read-only channel.

Definition at line 233 of file ElementBase.cpp.

References ElementBase::getChannel().

Referenced by ElementBase::getAttribute(), and ElementBase::hasAttribute().

Here is the call graph for this function:

◆ getCSTrafoGlobal2Local()

◆ getDesign()

const ElementBase & Component::getDesign ( ) const
virtualinherited

Return design element.

Definition at line 67 of file Component.cpp.

◆ getDesignEnergy()

double Component::getDesignEnergy ( ) const
inlinevirtualinherited

Reimplemented in BendBase, and RFCavity.

Definition at line 231 of file Component.h.

◆ getDimensions()

void Ring::getDimensions ( double &  zBegin,
double &  zEnd 
) const
overridevirtual

Not implemented - always throws an exception.

Implements Component.

Definition at line 145 of file Ring.cpp.

◆ getEdgeToBegin()

CoordinateSystemTrafo ElementBase::getEdgeToBegin ( ) const
inlinevirtualinherited

◆ getEdgeToEnd()

CoordinateSystemTrafo ElementBase::getEdgeToEnd ( ) const
inlinevirtualinherited

Reimplemented in Bend2D, RFCavity, Solenoid, and TravelingWave.

Definition at line 511 of file ElementBase.h.

References ElementBase::getElementLength().

Referenced by ElementBase::getBoundingBoxInLabCoords().

Here is the call graph for this function:

◆ getElementDimensions()

virtual void ElementBase::getElementDimensions ( double &  begin,
double &  end 
) const
inlinevirtualinherited

Reimplemented in RFCavity, TravelingWave, and Solenoid.

Definition at line 174 of file ElementBase.h.

References begin(), end(), and ElementBase::getElementLength().

Referenced by MeshGenerator::add().

Here is the call graph for this function:

◆ getElementLength()

double ElementBase::getElementLength ( ) const
inlinevirtualinherited

Get design length.

Reimplemented in MarkerRep, TBeamline< T >, and RFCavity.

Definition at line 415 of file ElementBase.h.

References BGeometryBase::getElementLength(), and ElementBase::getGeometry().

Referenced by ScatteringPhysics::addBackToBunch(), Undulator::apply(), Multipole::apply(), Component::apply(), Corrector::apply(), Solenoid::apply(), Component::applyToReferenceParticle(), Multipole::applyToReferenceParticle(), Solenoid::applyToReferenceParticle(), Vacuum::checkPoint(), ScatteringPhysics::copyFromBunch(), RBend::findChordLength(), SBend::findChordLength(), Corrector::getDimensions(), CCollimator::getDimensions(), Degrader::getDimensions(), Drift::getDimensions(), FlexibleCollimator::getDimensions(), Multipole::getDimensions(), RBend3D::getDimensions(), Solenoid::getDimensions(), Vacuum::getDimensions(), ElementBase::getEdgeToEnd(), Solenoid::getEdgeToEnd(), ElementBase::getElementDimensions(), Solenoid::getElementDimensions(), BeamlineGeometry::getElementLength(), RFCavity::getElementLength(), Corrector::initialise(), Degrader::initialise(), Drift::initialise(), FlexibleCollimator::initialise(), Multipole::initialise(), RBend3D::initialise(), Solenoid::initialise(), Source::initialise(), Vacuum::initialise(), ElementBase::isInside(), Degrader::isInside(), Monitor::isInside(), Multipole::isInside(), ElementBase::isInsideTransverse(), FlexibleCollimator::isStopped(), ScatteringPhysics::setTimeStepForLeavingParticles(), Bend2D::setupDefaultFieldMap(), ParallelCyclotronTracker::visitCorrector(), ParallelCyclotronTracker::visitDrift(), ThickTracker::visitDrift(), ParallelCyclotronTracker::visitMultipole(), ThickTracker::visitMultipole(), ParallelCyclotronTracker::visitRBend(), ParallelCyclotronTracker::visitSBend(), and ThickTracker::visitSBend().

Here is the call graph for this function:

◆ getElementPosition()

double ElementBase::getElementPosition ( ) const
inlineinherited

Definition at line 589 of file ElementBase.h.

References ElementBase::elemedgeSet_m, ElementBase::elementPosition_m, and ElementBase::getName().

Here is the call graph for this function:

◆ getEntrance()

double ElementBase::getEntrance ( ) const
inlinevirtualinherited

Get entrance position.

Reimplemented in TBeamline< T >.

Definition at line 427 of file ElementBase.h.

References BGeometryBase::getEntrance(), and ElementBase::getGeometry().

Referenced by BeamlineGeometry::getEntrance().

Here is the call graph for this function:

◆ getEntranceFrame()

Euclid3D ElementBase::getEntranceFrame ( ) const
inlinevirtualinherited

Get transform.

Reimplemented in TBeamline< T >.

Definition at line 447 of file ElementBase.h.

References BGeometryBase::getEntranceFrame(), and ElementBase::getGeometry().

Referenced by BeamlineGeometry::getEntranceFrame().

Here is the call graph for this function:

◆ getEntrancePatch()

Euclid3D ElementBase::getEntrancePatch ( ) const
inlinevirtualinherited

Get patch.

Definition at line 455 of file ElementBase.h.

References BGeometryBase::getEntrancePatch(), and ElementBase::getGeometry().

Here is the call graph for this function:

◆ getExit()

double ElementBase::getExit ( ) const
inlinevirtualinherited

Get exit position.

Reimplemented in TBeamline< T >.

Definition at line 431 of file ElementBase.h.

References BGeometryBase::getExit(), and ElementBase::getGeometry().

Referenced by BeamlineGeometry::getExit().

Here is the call graph for this function:

◆ getExitFrame()

Euclid3D ElementBase::getExitFrame ( ) const
inlinevirtualinherited

Get transform.

Reimplemented in TBeamline< T >.

Definition at line 451 of file ElementBase.h.

References BGeometryBase::getExitFrame(), and ElementBase::getGeometry().

Referenced by BeamlineGeometry::getExitFrame().

Here is the call graph for this function:

◆ getExitPatch()

Euclid3D ElementBase::getExitPatch ( ) const
inlinevirtualinherited

Get patch.

Definition at line 459 of file ElementBase.h.

References BGeometryBase::getExitPatch(), and ElementBase::getGeometry().

Here is the call graph for this function:

◆ getField() [1/2]

virtual const EMField & Ring::getField ( ) const
inlineoverridevirtual

Not implemented, throws an exception.

Implements Component.

Definition at line 172 of file Ring.h.

◆ getField() [2/2]

virtual EMField & Ring::getField ( )
inlineoverridevirtual

Not implemented, throws an exception.

Implements Component.

Definition at line 169 of file Ring.h.

◆ getFlagDeleteOnTransverseExit()

bool ElementBase::getFlagDeleteOnTransverseExit ( ) const
inlineinherited

◆ getGeometry() [1/2]

virtual const PlanarArcGeometry & Ring::getGeometry ( ) const
inlineoverridevirtual

Not implemented.

Implements ElementBase.

Definition at line 178 of file Ring.h.

References planarArcGeometry_m.

◆ getGeometry() [2/2]

virtual PlanarArcGeometry & Ring::getGeometry ( )
inlineoverridevirtual

Not implemented.

Implements ElementBase.

Definition at line 175 of file Ring.h.

References planarArcGeometry_m.

◆ getHarmonicNumber()

double Ring::getHarmonicNumber ( )
inline

Get the harmonic number for RF (number of bunches in the ring)

Definition at line 212 of file Ring.h.

References cyclHarm_m.

Referenced by ParallelCyclotronTracker::getHarmonicNumber(), and ParallelCyclotronTracker::visitRing().

◆ getIsClosed()

double Ring::getIsClosed ( ) const
inline

Get flag for closure checking.

Definition at line 288 of file Ring.h.

References isClosed_m.

◆ getLastSectionPlaced()

RingSection * Ring::getLastSectionPlaced ( ) const

Get the last section placed or nullptr if no sections were placed yet.

Definition at line 364 of file Ring.cpp.

References section_list_m.

◆ getLatticePhiInit()

double Ring::getLatticePhiInit ( ) const
inline

Get the initial element's azimuthal angle.

Definition at line 255 of file Ring.h.

References latticePhiInit_m.

◆ getLatticeRInit()

double Ring::getLatticeRInit ( ) const
inline

Get the initial element's radius.

Definition at line 249 of file Ring.h.

References latticeRInit_m.

◆ getLatticeThetaInit()

double Ring::getLatticeThetaInit ( ) const
inline

Get the first element's horizontal angle.

Get the angle in the ring plane with respect to the tangent vector

Definition at line 273 of file Ring.h.

References latticeThetaInit_m.

◆ getLossDataSink()

PartBunchBase< double, 3 > * Ring::getLossDataSink ( ) const

Get pointer to lossDataSink.

Ring still owns the memory to which lossDataSink points.

◆ getMisalignment() [1/2]

CoordinateSystemTrafo ElementBase::getMisalignment ( ) const
inlineinherited

Definition at line 541 of file ElementBase.h.

References ElementBase::misalignment_m.

◆ getMisalignment() [2/2]

void ElementBase::getMisalignment ( double &  x,
double &  y,
double &  s 
) const
inherited

◆ getName()

const std::string & ElementBase::getName ( ) const
virtualinherited

Get element name.

Definition at line 162 of file ElementBase.cpp.

References ElementBase::elementID.

Referenced by appendElement(), Cyclotron::apply(), apply(), Bend2D::calculateRefTrajectory(), OutputPlane::checkOne(), Vacuum::checkPressure(), Stripper::doCheck(), CCollimator::doFinalise(), Stripper::doFinalise(), OutputPlane::doGoOffline(), Probe::doGoOffline(), OutputPlane::doInitialise(), PlaceRep::enter(), Cyclotron::finalise(), Degrader::finalise(), FlexibleCollimator::finalise(), Vacuum::finalise(), PyOpal::Field::getElementName(), ElementBase::getElementPosition(), RFCavity::getMomentaKick(), BeamStrippingPhysics::getName(), ScatteringPhysics::getName(), Bend2D::getOutline(), ElementBase::getOutputFN(), CavityAutophaser::getPhaseAtMaxEnergy(), Selector::handleElement(), initialise(), Bend2D::initialise(), RBend3D::initialise(), RFCavity::initialise(), Solenoid::initialise(), CSRIGFWakeFunction::initialize(), CSRWakeFunction::initialize(), OpalWake::initWakefunction(), PlaceRep::leave(), operator<<(), Offset::operator=(), VariableRFCavity::operator=(), operator==(), Line::parse(), Vacuum::print(), BeamStrippingPhysics::print(), ScatteringPhysics::print(), Sequence::print(), ParticleMatterInteraction::print(), Bend2D::readFieldMap(), PyOpal::PyLine_< C >::registerObject(), Component::trackBunch(), Component::trackMap(), RBend3D::trackRefParticleThrough(), OpalRBend::update(), OpalRBend3D::update(), OpalSBend::update(), Sequence::updateList(), ParallelTTracker::updateRFElement(), ParallelCyclotronTracker::visitCCollimator(), Replacer::visitFlaggedElmPtr(), ParallelCyclotronTracker::visitProbe(), ParallelCyclotronTracker::visitRFCavity(), ParallelCyclotronTracker::visitSeptum(), ParallelCyclotronTracker::visitStripper(), and ParallelTTracker::writePhaseSpace().

◆ getNextNormal()

Vector_t Ring::getNextNormal ( ) const

Get the initial element's start normal in cartesian coordinates.

Definition at line 220 of file Ring.cpp.

References getStartNormal(), and section_list_m.

Referenced by appendElement().

Here is the call graph for this function:

◆ getNextPosition()

Vector_t Ring::getNextPosition ( ) const

Get the initial element's start position in cartesian coordinates.

Definition at line 206 of file Ring.cpp.

References getStartPosition(), and section_list_m.

Referenced by appendElement().

Here is the call graph for this function:

◆ getNumberOfRingSections()

size_t Ring::getNumberOfRingSections ( ) const

Get number of RingSections.

Definition at line 402 of file Ring.cpp.

References section_list_m.

Referenced by PyOpal::Field::getNumberOfElements(), and getSection().

◆ getOrigin()

double ElementBase::getOrigin ( ) const
inlinevirtualinherited

Get origin position.

Reimplemented in TBeamline< T >.

Definition at line 423 of file ElementBase.h.

References ElementBase::getGeometry(), and BGeometryBase::getOrigin().

Referenced by BeamlineGeometry::getOrigin().

Here is the call graph for this function:

◆ getOutputFN()

std::string ElementBase::getOutputFN ( ) const
inherited

Get output filename.

Definition at line 177 of file ElementBase.cpp.

References ElementBase::getName(), and ElementBase::outputfn_m.

Referenced by Probe::doInitialise(), PluginElement::initialise(), Cyclotron::initialise(), FlexibleCollimator::initialise(), Monitor::initialise(), and Source::initialise().

Here is the call graph for this function:

◆ getParticleMatterInteraction()

ParticleMatterInteractionHandler * ElementBase::getParticleMatterInteraction ( ) const
inlinevirtualinherited

◆ getPotential()

virtual bool Component::getPotential ( const Vector_t ,
const double &  ,
Vector_t ,
double &   
)
inlinevirtualinherited

Calculate the four-potential at some position relative to the component.

Parameters
Rposition in the local coordinate system of the component
ttime
Afilled with the calculated magnetic vector potential
phifilled with the calculated electric potential Note that any existing values in A and phi may be overwritten by this method.
Returns
true if particle is outside the field map, else false Default for component is to return false and make no change to A and phi

Definition at line 130 of file Component.h.

◆ getRefPartBunch()

PartBunchBase< double, 3 > * Ring::getRefPartBunch ( ) const

Get pointer to RefPartBunchBase<double, 3> from the bunch.

Ring does not own this memory (so neither does caller).

◆ getRequiredNumberOfTimeSteps()

int ElementBase::getRequiredNumberOfTimeSteps ( ) const
inlinevirtualinherited

Reimplemented in Drift, Marker, Monitor, Source, and Stripper.

Definition at line 603 of file ElementBase.h.

◆ getRFFreq()

double Ring::getRFFreq ( ) const
inline

Get the nominal RF frequency.

Definition at line 219 of file Ring.h.

References rfFreq_m.

◆ getRingMaxR()

double Ring::getRingMaxR ( ) const
inline

Get the ring maximum.

Definition at line 300 of file Ring.h.

References maxR2_m, and sqrt().

Here is the call graph for this function:

◆ getRingMinR()

double Ring::getRingMinR ( ) const
inline

Get the ring minimum.

Definition at line 297 of file Ring.h.

References minR2_m, and sqrt().

Here is the call graph for this function:

◆ getRotationAboutZ()

double ElementBase::getRotationAboutZ ( ) const
inlineinherited

◆ getRotationStartToEnd()

Rotation3D Ring::getRotationStartToEnd ( Euclid3D  delta) const
private

Definition at line 176 of file Ring.cpp.

References atan2(), Euclid3D::getRotation(), and Rotation3D::ZRotation().

Here is the call graph for this function:

◆ getSection()

RingSection * Ring::getSection ( int  i) const

Return ith section.

Throw a readable exception if i is not valid

Definition at line 387 of file Ring.cpp.

References getNumberOfRingSections(), sec(), and section_list_m.

Referenced by PyOpal::Field::getElementEndNormal(), PyOpal::Field::getElementEndPosition(), PyOpal::Field::getElementName(), PyOpal::Field::getElementStartNormal(), and PyOpal::Field::getElementStartPosition().

Here is the call graph for this function:

◆ getSectionsAt()

std::vector< RingSection * > Ring::getSectionsAt ( const Vector_t pos)

Get the list of sections at position pos.

Definition at line 172 of file Ring.cpp.

References section_list_m.

Referenced by apply().

◆ getStartNormal()

Vector_t Ring::getStartNormal ( ) const
private

Definition at line 228 of file Ring.cpp.

References cos(), latticePhiInit_m, latticeThetaInit_m, and sin().

Referenced by getNextNormal().

Here is the call graph for this function:

◆ getStartPosition()

Vector_t Ring::getStartPosition ( ) const
private

Definition at line 214 of file Ring.cpp.

References cos(), latticePhiInit_m, latticeRInit_m, and sin().

Referenced by getNextPosition().

Here is the call graph for this function:

◆ getSymmetry()

double Ring::getSymmetry ( ) const
inline

Get the rotational symmetry of the ring (number of cells)

Definition at line 282 of file Ring.h.

References symmetry_m.

Referenced by ParallelCyclotronTracker::visitRing().

◆ getTotalTransform()

Euclid3D ElementBase::getTotalTransform ( ) const
inlinevirtualinherited

Get transform.

Reimplemented in TBeamline< T >.

Definition at line 439 of file ElementBase.h.

References ElementBase::getGeometry(), and BGeometryBase::getTotalTransform().

Referenced by BeamlineGeometry::getTotalTransform().

Here is the call graph for this function:

◆ getTransform() [1/2]

Euclid3D ElementBase::getTransform ( double  fromS,
double  toS 
) const
inlinevirtualinherited

Get transform.

Reimplemented in TBeamline< T >.

Definition at line 435 of file ElementBase.h.

References ElementBase::getGeometry(), and BGeometryBase::getTransform().

Referenced by BeamlineGeometry::getTransform(), and TBeamline< T >::getTransform().

Here is the call graph for this function:

◆ getTransform() [2/2]

Euclid3D ElementBase::getTransform ( double  s) const
inlinevirtualinherited

Get transform.

Reimplemented in TBeamline< T >.

Definition at line 443 of file ElementBase.h.

References ElementBase::getGeometry(), and BGeometryBase::getTransform().

Here is the call graph for this function:

◆ getType()

ElementType Component::getType ( ) const
overridevirtualinherited

Get element type std::string.

Implements ElementBase.

Reimplemented in Corrector, Cyclotron, Undulator, CCollimator, Degrader, Drift, FlexibleCollimator, Marker, Monitor, Multipole, OutputPlane, Probe, RBend, RBend3D, RFCavity, SBend, Septum, Solenoid, Source, Stripper, TravelingWave, Vacuum, and Bend2D.

Definition at line 95 of file Component.cpp.

References ANY.

◆ getTypeString() [1/2]

std::string ElementBase::getTypeString ( ) const
inlineinherited

Definition at line 579 of file ElementBase.h.

References ElementBase::getType(), and ElementBase::getTypeString().

Referenced by ParallelCyclotronTracker::execute(), ElementBase::getTypeString(), Vacuum::print(), and OpalBeamline::visit().

Here is the call graph for this function:

◆ getTypeString() [2/2]

std::string ElementBase::getTypeString ( ElementType  type)
staticinherited

Definition at line 240 of file ElementBase.cpp.

References ElementBase::elementTypeToString_s.

◆ getWake()

WakeFunction * ElementBase::getWake ( ) const
inlinevirtualinherited

return the attached wake object if there is any

Definition at line 467 of file ElementBase.h.

References ElementBase::wake_m.

◆ goOffline()

void Component::goOffline ( )
virtualinherited

◆ goOnline()

void Component::goOnline ( const double &  kineticEnergy)
virtualinherited

◆ hasAttribute()

bool ElementBase::hasAttribute ( const std::string &  aKey) const
virtualinherited

Test for existence of an attribute.

Definition at line 200 of file ElementBase.cpp.

References ElementBase::getConstChannel().

Referenced by ParallelCyclotronTracker::visitSolenoid().

Here is the call graph for this function:

◆ hasBoundaryGeometry()

bool ElementBase::hasBoundaryGeometry ( ) const
inlinevirtualinherited

Definition at line 479 of file ElementBase.h.

References ElementBase::bgeometry_m.

◆ hasParticleMatterInteraction()

bool ElementBase::hasParticleMatterInteraction ( ) const
inlinevirtualinherited

Definition at line 487 of file ElementBase.h.

References ElementBase::parmatint_m.

◆ hasWake()

bool ElementBase::hasWake ( ) const
inlinevirtualinherited

Definition at line 471 of file ElementBase.h.

References ElementBase::wake_m.

◆ initialise() [1/2]

void Ring::initialise ( PartBunchBase< double, 3 > *  bunch)
virtual

Initialise the Ring - set the bunch and allocate a new LossDataSink.

Parameters
bunchthe particle bunch. Ring borrows this pointer (caller owns memory)

Definition at line 150 of file Ring.cpp.

References ElementBase::getName(), Component::online_m, setLossDataSink(), and setRefPartBunch().

Here is the call graph for this function:

◆ initialise() [2/2]

void Ring::initialise ( PartBunchBase< double, 3 > *  bunch,
double &  startField,
double &  endField 
)
overridevirtual

Initialise the Ring.

Parameters
bunchthe particle bunch. Ring borrows this pointer (caller owns memory)
startField- not used
endField- not used
scaleFactor- not used

Implements Component.

Definition at line 156 of file Ring.cpp.

References initialise().

Referenced by initialise(), and ParallelCyclotronTracker::visitRing().

Here is the call graph for this function:

◆ isElementPositionSet()

bool ElementBase::isElementPositionSet ( ) const
inlineinherited

Definition at line 598 of file ElementBase.h.

References ElementBase::elemedgeSet_m.

◆ isInside()

bool ElementBase::isInside ( const Vector_t r) const
inlinevirtualinherited

Reimplemented in Bend2D, Degrader, Monitor, Multipole, RBend3D, RFCavity, Solenoid, and TravelingWave.

Definition at line 530 of file ElementBase.h.

References ElementBase::getElementLength(), and ElementBase::isInsideTransverse().

Here is the call graph for this function:

◆ isInsideTransverse()

◆ isPositioned()

bool ElementBase::isPositioned ( ) const
inlineinherited

◆ isSharable()

bool ElementBase::isSharable ( ) const
inlineinherited

Test if the element can be shared.

Definition at line 463 of file ElementBase.h.

References ElementBase::shareFlag.

Referenced by ElementBase::copyStructure(), and Sequence::updateList().

◆ isShared()

bool RCObject::isShared ( ) const
inlineinherited

Test for sharing.

Definition at line 93 of file RCObject.h.

References RCObject::refCount.

◆ lockRing()

void Ring::lockRing ( )

Lock the ring.

Lock the ring; apply closure checks and symmetry properties as required. Impose rule that start must be before end and switch objects around if this is not the case. Sort by startPosition azimuthal angle.

Sets isLocked_m to true. New elements can no longer be added (as it may break the symmetry/bound checking)

Definition at line 291 of file Ring.cpp.

References appendElement(), buildRingSections(), checkAndClose(), endl(), gmsg, isClosed_m, isLocked_m, section_list_m, and symmetry_m.

Referenced by ParallelCyclotronTracker::execute().

Here is the call graph for this function:

◆ makeSharable()

void ElementBase::makeSharable ( )
virtualinherited

Set sharable flag.

Reimplemented in TBeamline< T >.

Definition at line 253 of file ElementBase.cpp.

References ElementBase::shareFlag.

Referenced by OpalMarker::OpalMarker(), and Element::setShared().

◆ Online()

bool Component::Online ( )
virtualinherited

Definition at line 91 of file Component.cpp.

References Component::online_m.

◆ operator=()

Ring & Ring::operator= ( const Ring ring)
private

Disabled.

◆ releasePosition()

void ElementBase::releasePosition ( )
inlineinherited

◆ removeAttribute()

void ElementBase::removeAttribute ( const std::string &  aKey)
virtualinherited

Remove an existing attribute.

Definition at line 212 of file ElementBase.cpp.

References AttributeSet::removeAttribute(), and ElementBase::userAttribs.

Here is the call graph for this function:

◆ removeReference()

int RCObject::removeReference ( ) const
inlineinherited

Decrement the reference count.

Definition at line 88 of file RCObject.h.

References RCObject::refCount.

◆ resetAzimuths()

void Ring::resetAzimuths ( )
private

Definition at line 321 of file Ring.cpp.

References section_list_m.

◆ rotateToCyclCoordinates()

void Ring::rotateToCyclCoordinates ( Euclid3D euclid3d) const
private

Definition at line 197 of file Ring.cpp.

References Rotation3D::getAxis(), Euclid3D::getRotation(), and Euclid3D::getVector().

Referenced by appendElement().

Here is the call graph for this function:

◆ sectionCompare()

bool Ring::sectionCompare ( RingSection const *const  sec1,
RingSection const *const  sec2 
)
staticprivate

Definition at line 371 of file Ring.cpp.

◆ setActionRange()

void ElementBase::setActionRange ( const std::queue< std::pair< double, double > > &  range)
inlineinherited

Definition at line 561 of file ElementBase.h.

References ElementBase::actionRange_m, and ElementBase::elementEdge_m.

◆ setAperture()

void ElementBase::setAperture ( const ApertureType type,
const std::vector< double > &  args 
)
inlineinherited

◆ setAttribute()

void ElementBase::setAttribute ( const std::string &  aKey,
double  val 
)
virtualinherited

Set value of an attribute.

Definition at line 217 of file ElementBase.cpp.

References endl(), ElementBase::getChannel(), and Channel::isSettable().

Referenced by ElementBase::update(), and OpalElement::updateUnknown().

Here is the call graph for this function:

◆ setBeamPhiInit()

void Ring::setBeamPhiInit ( double  phiInit)
inline

Set the initial beam azimuthal angle.

Definition at line 228 of file Ring.h.

References beamPhiInit_m.

Referenced by OpalRingDefinition::update().

◆ setBeamPRInit()

void Ring::setBeamPRInit ( double  pRInit)
inline

Set the initial beam radial momentum.

Definition at line 240 of file Ring.h.

References beamPRInit_m.

Referenced by OpalRingDefinition::update().

◆ setBeamRInit()

void Ring::setBeamRInit ( double  rInit)
inline

Set the initial beam radius.

Definition at line 222 of file Ring.h.

References beamRInit_m.

Referenced by OpalRingDefinition::update().

◆ setBeamThetaInit()

void Ring::setBeamThetaInit ( double  thetaInit)
inline

Set the initial beam rotation relative to the tangent vector.

Definition at line 234 of file Ring.h.

References beamThetaInit_m.

Referenced by OpalRingDefinition::update().

◆ setBoundaryGeometry()

void ElementBase::setBoundaryGeometry ( BoundaryGeometry geo)
virtualinherited

attach a boundary geometry field to the element

Definition at line 270 of file ElementBase.cpp.

References ElementBase::bgeometry_m.

Referenced by OpalCavity::update(), OpalCyclotron::update(), and OpalDrift::update().

◆ setCSTrafoGlobal2Local()

void ElementBase::setCSTrafoGlobal2Local ( const CoordinateSystemTrafo ori)
inlineinherited

◆ setCurrentSCoordinate()

void ElementBase::setCurrentSCoordinate ( double  s)
inherited

Definition at line 278 of file ElementBase.cpp.

References ElementBase::actionRange_m, and ElementBase::elementEdge_m.

◆ setDesignEnergy()

void Component::setDesignEnergy ( const double &  energy,
bool  changeable = true 
)
inlinevirtualinherited

Reimplemented in Corrector, RFCavity, and BendBase.

Definition at line 228 of file Component.h.

◆ setElementLength()

◆ setElementPosition()

void ElementBase::setElementPosition ( double  elemedge)
inlineinherited

Access to ELEMEDGE attribute.

Definition at line 583 of file ElementBase.h.

References ElementBase::elemedgeSet_m, and ElementBase::elementPosition_m.

Referenced by OpalElement::update().

◆ setExitFaceSlope()

void Component::setExitFaceSlope ( const double &  m)
inlineinherited

Definition at line 225 of file Component.h.

References Component::exit_face_slope_m.

◆ setFlagDeleteOnTransverseExit()

void ElementBase::setFlagDeleteOnTransverseExit ( bool  flag = true)
inlineinherited

Definition at line 608 of file ElementBase.h.

References ElementBase::deleteOnTransverseExit_m.

Referenced by OpalElement::update().

◆ setHarmonicNumber()

void Ring::setHarmonicNumber ( double  cyclHarm)
inline

Set the harmonic number for RF (number of bunches in the ring)

Definition at line 209 of file Ring.h.

References cyclHarm_m.

Referenced by OpalRingDefinition::update().

◆ setIsClosed()

void Ring::setIsClosed ( bool  isClosed)
inline

Set flag for closure checking.

Definition at line 285 of file Ring.h.

References isClosed_m.

Referenced by OpalRingDefinition::update().

◆ setLatticePhiInit()

void Ring::setLatticePhiInit ( double  phiInit)
inline

Set the initial element's azimuthal angle.

Definition at line 252 of file Ring.h.

References latticePhiInit_m.

Referenced by OpalRingDefinition::update().

◆ setLatticeRInit()

void Ring::setLatticeRInit ( double  rInit)
inline

Set the initial element's radius.

Definition at line 246 of file Ring.h.

References latticeRInit_m.

Referenced by OpalRingDefinition::update().

◆ setLatticeThetaInit()

void Ring::setLatticeThetaInit ( double  thetaInit)
inline

Set the first element's horizontal angle.

Set the angle in the ring plane with respect to the tangent vector

Definition at line 267 of file Ring.h.

References latticeThetaInit_m.

Referenced by OpalRingDefinition::update().

◆ setLossDataSink()

void Ring::setLossDataSink ( LossDataSink sink)

Set LossDataSink to sink.

Parameters
sinkThe LossDataSink. Ring takes ownership of memory allocated to sink

Definition at line 140 of file Ring.cpp.

References lossDS_m.

Referenced by finalise(), and initialise().

◆ setMisalignment()

void ElementBase::setMisalignment ( const CoordinateSystemTrafo cst)
inlineinherited

Definition at line 536 of file ElementBase.h.

References ElementBase::misalignment_m.

Referenced by OpalElement::update().

◆ setName()

void ElementBase::setName ( const std::string &  name)
virtualinherited

Set element name.

Definition at line 167 of file ElementBase.cpp.

References ElementBase::elementID, and name.

Referenced by Sequence::insertDrifts(), Offset::operator=(), and VariableRFCavity::operator=().

◆ setOutputFN()

◆ setParticleMatterInteraction()

◆ setRefPartBunch()

void Ring::setRefPartBunch ( PartBunchBase< double, 3 > *  bunch)

Set RefPartBunchBase<double, 3> to bunch.

Parameters
sinkThe Bunch. Ring borrows memory allocated to bunch.

Note for compliance with style guide and compatibility with parent two pointer to RefPartBunchBase<double, 3> are stored; this keeps them aligned

Definition at line 167 of file Ring.cpp.

References Component::RefPartBunch_m, and refPartBunch_m.

Referenced by initialise(), and Ring().

◆ setRFFreq()

void Ring::setRFFreq ( double  rfFreq)
inline

Set the nominal RF frequency.

Definition at line 216 of file Ring.h.

References rfFreq_m.

Referenced by OpalRingDefinition::update().

◆ setRingAperture()

void Ring::setRingAperture ( double  minR,
double  maxR 
)

Set the ring aperture limits.

  • minR; the minimum radius allowed during tracking. Throws if minR < 0
  • maxR; the maximum radius allowed during tracking. Throws if maxR < 0 Sets willDoRingAperture_m to true.

Definition at line 376 of file Ring.cpp.

References maxR2_m, minR2_m, and willDoAperture_m.

Referenced by OpalRingDefinition::update().

◆ setRotationAboutZ()

void ElementBase::setRotationAboutZ ( double  rotation)
inlineinherited

Set rotation about z axis in bend frame.

Definition at line 569 of file ElementBase.h.

References ElementBase::rotationZAxis_m.

Referenced by OpalElement::update().

◆ setScale()

void Ring::setScale ( double  scale)
inline

Set the scaling factor for the fields.

Definition at line 279 of file Ring.h.

References scale_m.

Referenced by OpalRingDefinition::update().

◆ setSymmetry()

void Ring::setSymmetry ( double  symmetry)
inline

Set the rotational symmetry of the ring (number of cells)

Definition at line 276 of file Ring.h.

References symmetry_m.

Referenced by OpalRingDefinition::update().

◆ setWake()

void ElementBase::setWake ( WakeFunction wf)
virtualinherited

◆ trackBunch()

void Component::trackBunch ( PartBunchBase< double, 3 > *  bunch,
const PartData ,
bool  revBeam,
bool  revTrack 
) const
virtualinherited

Track particle bunch.

Definition at line 71 of file Component.cpp.

References ElementBase::getName().

Referenced by Tracker::visitComponent().

Here is the call graph for this function:

◆ trackMap()

void Component::trackMap ( FVps< double, 6 > &  map,
const PartData ,
bool  revBeam,
bool  revTrack 
) const
virtualinherited

Track a map.

Definition at line 77 of file Component.cpp.

References ElementBase::getName().

Here is the call graph for this function:

◆ update()

bool ElementBase::update ( const AttributeSet set)
inherited

Update element.

Definition at line 258 of file ElementBase.cpp.

References AttributeSet::begin(), AttributeSet::end(), and ElementBase::setAttribute().

Referenced by Monitor::driftToCorrectPositionAndSave().

Here is the call graph for this function:

Member Data Documentation

◆ actionRange_m

std::queue<std::pair<double, double> > ElementBase::actionRange_m
privateinherited

◆ angleTolerance_m

const double Ring::angleTolerance_m = 1e-2
staticprivate

Definition at line 418 of file Ring.h.

Referenced by checkAndClose(), and checkMidplane().

◆ aperture_m

◆ beamPhiInit_m

double Ring::beamPhiInit_m
private

Definition at line 379 of file Ring.h.

Referenced by getBeamPhiInit(), and setBeamPhiInit().

◆ beamPRInit_m

double Ring::beamPRInit_m
private

Definition at line 378 of file Ring.h.

Referenced by getBeamPRInit(), and setBeamPRInit().

◆ beamRInit_m

double Ring::beamRInit_m
private

Definition at line 377 of file Ring.h.

Referenced by getBeamRInit(), and setBeamRInit().

◆ beamThetaInit_m

double Ring::beamThetaInit_m
private

Definition at line 380 of file Ring.h.

Referenced by getBeamThetaInit(), and setBeamThetaInit().

◆ bgeometry_m

◆ csTrafoGlobal2Local_m

◆ cyclHarm_m

double Ring::cyclHarm_m
private

Definition at line 406 of file Ring.h.

Referenced by getHarmonicNumber(), and setHarmonicNumber().

◆ defaultAperture_m

const std::vector< double > Component::defaultAperture_m
staticprotectedinherited
Initial value:
=
std::vector<double>({1e6, 1e6, 1.0})

Definition at line 187 of file Component.h.

Referenced by Component::Component().

◆ deleteOnTransverseExit_m

bool ElementBase::deleteOnTransverseExit_m = true
privateinherited

◆ elemedgeSet_m

bool ElementBase::elemedgeSet_m
privateinherited

◆ elementEdge_m

double ElementBase::elementEdge_m
protectedinherited

◆ elementID

std::string ElementBase::elementID
privateinherited

Definition at line 381 of file ElementBase.h.

Referenced by ElementBase::getName(), and ElementBase::setName().

◆ elementPosition_m

double ElementBase::elementPosition_m
privateinherited

ELEMEDGE attribute.

Definition at line 396 of file ElementBase.h.

Referenced by ElementBase::getElementPosition(), and ElementBase::setElementPosition().

◆ elementTypeToString_s

const std::map< ElementType, std::string > ElementBase::elementTypeToString_s
staticprivateinherited

Definition at line 383 of file ElementBase.h.

Referenced by ElementBase::getTypeString().

◆ exit_face_slope_m

double Component::exit_face_slope_m
protectedinherited

Definition at line 189 of file Component.h.

Referenced by Component::setExitFaceSlope().

◆ isClosed_m

bool Ring::isClosed_m
private

Definition at line 398 of file Ring.h.

Referenced by getIsClosed(), lockRing(), and setIsClosed().

◆ isLocked_m

bool Ring::isLocked_m
private

Definition at line 394 of file Ring.h.

Referenced by appendElement(), and lockRing().

◆ latticePhiInit_m

double Ring::latticePhiInit_m
private

Definition at line 384 of file Ring.h.

Referenced by getLatticePhiInit(), getStartNormal(), getStartPosition(), and setLatticePhiInit().

◆ latticeRInit_m

double Ring::latticeRInit_m
private

Definition at line 383 of file Ring.h.

Referenced by getLatticeRInit(), getStartPosition(), and setLatticeRInit().

◆ latticeThetaInit_m

double Ring::latticeThetaInit_m
private

Definition at line 385 of file Ring.h.

Referenced by getLatticeThetaInit(), getStartNormal(), and setLatticeThetaInit().

◆ lengthTolerance_m

const double Ring::lengthTolerance_m = 1e-2
staticprivate

Definition at line 417 of file Ring.h.

Referenced by checkAndClose(), and checkMidplane().

◆ lossDS_m

LossDataSink* Ring::lossDS_m
private

Definition at line 374 of file Ring.h.

Referenced by apply(), finalise(), Ring(), and setLossDataSink().

◆ maxR2_m

double Ring::maxR2_m
private

Definition at line 391 of file Ring.h.

Referenced by apply(), getRingMaxR(), and setRingAperture().

◆ minR2_m

double Ring::minR2_m
private

Definition at line 390 of file Ring.h.

Referenced by getRingMinR(), and setRingAperture().

◆ misalignment_m

CoordinateSystemTrafo ElementBase::misalignment_m
protectedinherited

Definition at line 367 of file ElementBase.h.

Referenced by ElementBase::getMisalignment(), and ElementBase::setMisalignment().

◆ online_m

◆ outputfn_m

std::string ElementBase::outputfn_m
privateinherited

The name of the outputfile.

Definition at line 401 of file ElementBase.h.

Referenced by ElementBase::getOutputFN(), and ElementBase::setOutputFN().

◆ parmatint_m

◆ phiStep_m

double Ring::phiStep_m
private

Definition at line 412 of file Ring.h.

Referenced by buildRingSections().

◆ planarArcGeometry_m

PlanarArcGeometry Ring::planarArcGeometry_m
private

Definition at line 363 of file Ring.h.

Referenced by getGeometry().

◆ positionIsFixed

bool ElementBase::positionIsFixed
privateinherited

◆ refCount

int RCObject::refCount
mutableprivateinherited

◆ RefPartBunch_m

PartBunchBase<double, 3>* Component::RefPartBunch_m
protectedinherited

Definition at line 191 of file Component.h.

Referenced by Corrector::apply(), Undulator::apply(), VerticalFFAMagnet::apply(), Bend2D::apply(), Degrader::apply(), FlexibleCollimator::apply(), Monitor::apply(), Multipole::apply(), MultipoleT::apply(), RBend3D::apply(), RFCavity::apply(), SBend3D::apply(), ScalingFFAMagnet::apply(), Solenoid::apply(), Source::apply(), TravelingWave::apply(), VariableRFCavity::apply(), VariableRFCavityFringeField::apply(), Cyclotron::apply(), Degrader::applyToReferenceParticle(), Monitor::applyToReferenceParticle(), BendBase::calcDesignRadius(), BendBase::calcFieldAmplitude(), BendBase::calcGamma(), Bend2D::calculateBendAngle(), Bend2D::calculateRefTrajectory(), Monitor::driftToCorrectPositionAndSave(), VerticalFFAMagnet::finalise(), MultipoleT::finalise(), Offset::finalise(), SBend3D::finalise(), ScalingFFAMagnet::finalise(), VariableRFCavity::finalise(), RBend::findChordLength(), Bend2D::findIdealBendParameters(), Corrector::goOnline(), Degrader::goOnline(), Degrader::initialise(), PluginElement::initialise(), Vacuum::initialise(), Corrector::initialise(), Cyclotron::initialise(), Undulator::initialise(), VerticalFFAMagnet::initialise(), Drift::initialise(), FlexibleCollimator::initialise(), Marker::initialise(), Monitor::initialise(), Multipole::initialise(), MultipoleT::initialise(), Offset::initialise(), RBend3D::initialise(), RFCavity::initialise(), SBend3D::initialise(), ScalingFFAMagnet::initialise(), Solenoid::initialise(), Source::initialise(), TravelingWave::initialise(), VariableRFCavity::initialise(), VariableRFCavity::initNull(), Multipole::isFocusing(), MultipoleT::MultipoleT(), CCollimator::print(), FlexibleCollimator::print(), SBend3D::SBend3D(), ScalingFFAMagnet::ScalingFFAMagnet(), Corrector::setDesignEnergy(), setRefPartBunch(), Bend2D::setupPusher(), RFCavity::trackOnAxisParticle(), RBend3D::trackRefParticleThrough(), Vacuum::updateParticleAttributes(), and VerticalFFAMagnet::VerticalFFAMagnet().

◆ refPartBunch_m

PartBunchBase<double, 3>* Ring::refPartBunch_m
private

Definition at line 369 of file Ring.h.

Referenced by apply(), Ring(), and setRefPartBunch().

◆ rfFreq_m

double Ring::rfFreq_m
private

Definition at line 409 of file Ring.h.

Referenced by getRFFreq(), and setRFFreq().

◆ ringSections_m

std::vector<RingSectionList> Ring::ringSections_m
private

Definition at line 413 of file Ring.h.

Referenced by buildRingSections().

◆ rotationZAxis_m

double ElementBase::rotationZAxis_m
protectedinherited

◆ scale_m

double Ring::scale_m = 1.
private

Definition at line 403 of file Ring.h.

Referenced by apply(), and setScale().

◆ section_list_m

◆ shareFlag

bool ElementBase::shareFlag
mutableprotectedinherited

◆ symmetry_m

int Ring::symmetry_m
private

Definition at line 401 of file Ring.h.

Referenced by getSymmetry(), lockRing(), and setSymmetry().

◆ userAttribs

AttributeSet ElementBase::userAttribs
privateinherited

Definition at line 386 of file ElementBase.h.

Referenced by ElementBase::getChannel(), and ElementBase::removeAttribute().

◆ wake_m

WakeFunction* ElementBase::wake_m
privateinherited

Definition at line 388 of file ElementBase.h.

Referenced by ElementBase::getWake(), ElementBase::hasWake(), and ElementBase::setWake().

◆ willDoAperture_m

bool Ring::willDoAperture_m = false
private

Definition at line 389 of file Ring.h.

Referenced by apply(), and setRingAperture().


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