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

#include <MultipoleRep.h>

Inheritance diagram for MultipoleRep:
Collaboration diagram for MultipoleRep:

Public Member Functions

 MultipoleRep (const std::string &name)
 Constructor with given name.
 MultipoleRep ()
 MultipoleRep (const MultipoleRep &)
virtual ~MultipoleRep ()
virtual ElementBaseclone () const
 Return clone.
virtual ChannelgetChannel (const std::string &aKey, bool=false)
 Construct a read/write channel.
virtual BMultipoleFieldgetField ()
 Get field.
virtual const BMultipoleFieldgetField () const
 Get field.
virtual StraightGeometrygetGeometry ()
 Get geometry.
virtual const StraightGeometrygetGeometry () const
 Get geometry.
virtual void setField (const BMultipoleField &field)
 Set mulitpole field.
virtual void accept (BeamlineVisitor &) const override
 Apply visitor to Multipole.
double getNormalComponent (int n) const
 Get normal component.
double getSkewComponent (int n) const
 Get skew component.
void setNormalComponent (int, double)
 Set normal component.
void setNormalComponent (int, double, double)
 Set normal component.
void setSkewComponent (int, double)
 Set skew component.
void setSkewComponent (int, double, double)
 Set skew component.
size_t getMaxNormalComponentIndex () const
size_t getMaxSkewComponentIndex () const
void setNSlices (const std::size_t &nSlices)
std::size_t getNSlices () const
bool isFocusing (unsigned int component) const
virtual bool apply (const size_t &i, const double &t, Vector_t &E, Vector_t &B) override
virtual bool apply (const Vector_t &R, const Vector_t &P, const double &t, Vector_t &E, Vector_t &B) override
virtual bool applyToReferenceParticle (const Vector_t &R, const Vector_t &P, const double &t, Vector_t &E, Vector_t &B) override
virtual void initialise (PartBunchBase< double, 3 > *bunch, double &startField, double &endField) override
virtual void finalise () override
virtual bool bends () const override
virtual ElementType getType () const override
 Get element type std::string.
virtual void getDimensions (double &zBegin, double &zEnd) const override
virtual bool isInside (const Vector_t &r) const override
EVector Efield (const Point3D &P) const
 Return the field in a point.
EVector Efield (const Point3D &P, double t) const
 Return the field in a point.
BVector Bfield (const Point3D &P) const
 Return the field in a point.
BVector Bfield (const Point3D &P, double t) const
 Return the field in a point.
EBVectors EBfield (const Point3D &P) const
 Return the field in a point.
EBVectors EBfield (const Point3D &P, double t) const
 Return the field in a point.
virtual bool getPotential (const Vector_t &, const double &, Vector_t &, double &)
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 const ElementBasegetDesign () const
 Return design element.
virtual void trackBunch (PartBunchBase< double, 3 > *bunch, const PartData &, bool revBeam, bool revTrack) const
 Track particle bunch.
virtual void trackMap (FVps< double, 6 > &map, const PartData &, bool revBeam, bool revTrack) const
 Track a map.
void setExitFaceSlope (const double &)
virtual const std::string & getName () const
 Get element name.
virtual void setName (const std::string &name)
 Set element name.
std::string getTypeString () const
virtual double getArcLength () const
 Get arc length.
virtual double getElementLength () const
 Get design length.
virtual void setElementLength (double length)
 Set design length.
virtual void getElementDimensions (double &begin, double &end) const
virtual double getOrigin () const
 Get origin position.
virtual double getEntrance () const
 Get entrance position.
virtual double getExit () const
 Get exit position.
virtual Euclid3D getTransform (double fromS, double toS) const
 Get transform.
virtual Euclid3D getTransform (double s) const
 Get transform.
virtual Euclid3D getTotalTransform () const
 Get transform.
virtual Euclid3D getEntranceFrame () const
 Get transform.
virtual Euclid3D getExitFrame () const
 Get transform.
virtual Euclid3D getEntrancePatch () const
 Get patch.
virtual Euclid3D getExitPatch () const
 Get patch.
virtual double getAttribute (const std::string &aKey) const
 Get attribute value.
virtual bool hasAttribute (const std::string &aKey) const
 Test for existence of an attribute.
virtual void removeAttribute (const std::string &aKey)
 Remove an existing attribute.
virtual void setAttribute (const std::string &aKey, double val)
 Set value of an attribute.
virtual const ConstChannelgetConstChannel (const std::string &aKey) const
 Construct a read-only channel.
virtual ElementBasecopyStructure ()
 Make a structural copy.
bool isSharable () const
 Test if the element can be shared.
virtual void makeSharable ()
 Set sharable flag.
bool update (const AttributeSet &)
 Update element.
virtual void setBoundaryGeometry (BoundaryGeometry *geo)
virtual BoundaryGeometrygetBoundaryGeometry () const
 return the attached boundary geometrt object if there is any
virtual bool hasBoundaryGeometry () const
virtual void setWake (WakeFunction *wf)
 attach a wake field to the element
virtual WakeFunctiongetWake () const
 return the attached wake object if there is any
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
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.
double getRotationAboutZ () const
virtual BoundingBox getBoundingBoxInLabCoords () const
virtual int getRequiredNumberOfTimeSteps () const
void setOutputFN (std::string fn)
 Set output filename.
std::string getOutputFN () const
 Get output filename.
void setFlagDeleteOnTransverseExit (bool=true)
bool getFlagDeleteOnTransverseExit () const
int addReference () const
 Increment reference count.
int removeReference () const
 Decrement the reference count.
bool isShared () const
 Test for sharing.
void setElementPosition (double elemedge)
 Access to ELEMEDGE attribute.
double getElementPosition () const
bool isElementPositionSet () const

Static Public Member Functions

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 operator= (const MultipoleRep &)
void computeField (Vector_t R, Vector_t &E, Vector_t &B)

Private Attributes

StraightGeometry geometry
 Multipole geometry.
BMultipoleField field
 Multipole field.
std::vector< double > NormalComponents
std::vector< double > NormalComponentErrors
std::vector< double > SkewComponents
std::vector< double > SkewComponentErrors
int max_SkewComponent_m
int max_NormalComponent_m
std::size_t nSlices_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
bool deleteOnTransverseExit_m = true
int refCount
double elementPosition_m
 ELEMEDGE attribute.
bool elemedgeSet_m

Static Private Attributes

static const std::map< ElementType, std::string > elementTypeToString_s

Detailed Description

Definition at line 24 of file MultipoleRep.h.

Constructor & Destructor Documentation

◆ MultipoleRep() [1/3]

MultipoleRep::MultipoleRep ( const std::string & name)
explicit

Constructor with given name.

Definition at line 58 of file MultipoleRep.cpp.

References field, geometry, Multipole::Multipole(), and name.

Referenced by MultipoleRep(), and operator=().

Here is the call graph for this function:

◆ MultipoleRep() [2/3]

MultipoleRep::MultipoleRep ( )

Definition at line 44 of file MultipoleRep.cpp.

References field, geometry, and Multipole::Multipole().

Referenced by clone().

Here is the call graph for this function:

◆ MultipoleRep() [3/3]

MultipoleRep::MultipoleRep ( const MultipoleRep & multipole)

Definition at line 51 of file MultipoleRep.cpp.

References field, geometry, Multipole::Multipole(), and MultipoleRep().

Here is the call graph for this function:

◆ ~MultipoleRep()

MultipoleRep::~MultipoleRep ( )
virtual

Definition at line 65 of file MultipoleRep.cpp.

Member Function Documentation

◆ accept()

void Multipole::accept ( BeamlineVisitor & visitor) const
overridevirtualinherited

Apply visitor to Multipole.

Implements ElementBase.

Definition at line 80 of file Multipole.cpp.

References BeamlineVisitor::visitMultipole().

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 refCount.

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

◆ apply() [1/2]

bool Multipole::apply ( const size_t & i,
const double & t,
Vector_t & E,
Vector_t & B )
overridevirtualinherited

Reimplemented from Component.

Definition at line 274 of file Multipole.cpp.

References computeField(), ElementBase::getElementLength(), ElementBase::getFlagDeleteOnTransverseExit(), ElementBase::isInsideTransverse(), and Component::RefPartBunch_m.

Here is the call graph for this function:

◆ apply() [2/2]

bool Multipole::apply ( const Vector_t & R,
const Vector_t & P,
const double & t,
Vector_t & E,
Vector_t & B )
overridevirtualinherited

Reimplemented from Component.

Definition at line 290 of file Multipole.cpp.

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

Here is the call graph for this function:

◆ applyToReferenceParticle()

bool Multipole::applyToReferenceParticle ( const Vector_t & R,
const Vector_t & P,
const double & t,
Vector_t & E,
Vector_t & B )
overridevirtualinherited

Reimplemented from Component.

Definition at line 299 of file Multipole.cpp.

References computeField(), ElementBase::getElementLength(), ElementBase::isInsideTransverse(), max_NormalComponent_m, max_SkewComponent_m, NormalComponentErrors, NormalComponents, SkewComponentErrors, and SkewComponents.

Here is the call graph for this function:

◆ bends()

bool Multipole::bends ( ) const
overridevirtualinherited

Implements Component.

Definition at line 333 of file Multipole.cpp.

◆ 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 getField().

Referenced by OutputPlane::getFieldsAtPoint().

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 getField().

Here is the call graph for this function:

◆ clone()

ElementBase * MultipoleRep::clone ( ) const
virtual

Return clone.

Implements ElementBase.

Definition at line 69 of file MultipoleRep.cpp.

References ElementBase::ElementBase(), and MultipoleRep().

Here is the call graph for this function:

◆ computeField()

void Multipole::computeField ( Vector_t R,
Vector_t & E,
Vector_t & B )
privateinherited

◆ copyStructure()

ElementBase * ElementBase::copyStructure ( )
virtualinherited

Make a structural copy.

Reimplemented in TBeamline< T >, TBeamline< FlaggedElmPtr >, and TBeamline< SequenceMember >.

Definition at line 244 of file ElementBase.cpp.

References ElementBase(), and isSharable().

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

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 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 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 getField().

Referenced by OutputPlane::getFieldsAtPoint().

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 getField().

Here is the call graph for this function:

◆ finalise()

void Multipole::finalise ( )
overridevirtualinherited

Implements Component.

Definition at line 329 of file Multipole.cpp.

References Component::online_m.

◆ 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 aperture_m.

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

◆ getArcLength()

double ElementBase::getArcLength ( ) const
inlinevirtualinherited

Get arc length.

Reimplemented in MarkerRep, TBeamline< T >, TBeamline< FlaggedElmPtr >, and TBeamline< SequenceMember >.

Definition at line 411 of file ElementBase.h.

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

Referenced by 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 getConstChannel().

Here is the call graph for this function:

◆ 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 bgeometry_m.

◆ getBoundingBoxInLabCoords()

BoundingBox ElementBase::getBoundingBoxInLabCoords ( ) const
virtualinherited

Reimplemented in Bend2D.

Definition at line 313 of file ElementBase.cpp.

References csTrafoGlobal2Local_m, and getEdgeToBegin().

Here is the call graph for this function:

◆ getChannel()

Channel * MultipoleRep::getChannel ( const std::string & aKey,
bool create = false )
virtual

Construct a read/write channel.

Reimplemented from ElementBase.

Definition at line 74 of file MultipoleRep.cpp.

References ElementBase::getChannel(), Multipole::getNormalComponent(), Multipole::getSkewComponent(), Multipole::setNormalComponent(), Multipole::setSkewComponent(), and SingleMultipole< 4 >::entries.

Here is the call graph for this function:

◆ 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(), and getChannel().

Referenced by getAttribute(), and 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.

References ElementBase::ElementBase().

Here is the call graph for this function:

◆ getDesignEnergy()

double Component::getDesignEnergy ( ) const
inlinevirtualinherited

Reimplemented in BendBase, and RFCavity.

Definition at line 231 of file Component.h.

◆ getDimensions()

void Multipole::getDimensions ( double & zBegin,
double & zEnd ) const
overridevirtualinherited

Implements Component.

Definition at line 338 of file Multipole.cpp.

References ElementBase::getElementLength().

Here is the call graph for this function:

◆ 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 getElementLength().

Here is the call graph for this function:

◆ getElementDimensions()

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

Reimplemented in RFCavity, Solenoid, and TravelingWave.

Definition at line 174 of file ElementBase.h.

References begin(), end(), and 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, RFCavity, TBeamline< T >, TBeamline< FlaggedElmPtr >, and TBeamline< SequenceMember >.

Definition at line 415 of file ElementBase.h.

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

Referenced by Component::apply(), Corrector::apply(), Multipole::apply(), Multipole::apply(), Solenoid::apply(), Undulator::apply(), Component::applyToReferenceParticle(), Multipole::applyToReferenceParticle(), Solenoid::applyToReferenceParticle(), Vacuum::checkPoint(), RBend::findChordLength(), SBend::findChordLength(), CCollimator::getDimensions(), Corrector::getDimensions(), Degrader::getDimensions(), Drift::getDimensions(), FlexibleCollimator::getDimensions(), Multipole::getDimensions(), RBend3D::getDimensions(), Solenoid::getDimensions(), Vacuum::getDimensions(), getEdgeToEnd(), Solenoid::getEdgeToEnd(), getElementDimensions(), Solenoid::getElementDimensions(), RFCavity::getElementLength(), Corrector::initialise(), Degrader::initialise(), Drift::initialise(), FlexibleCollimator::initialise(), Multipole::initialise(), RBend3D::initialise(), Solenoid::initialise(), Source::initialise(), Vacuum::initialise(), Degrader::isInside(), isInside(), Monitor::isInside(), Multipole::isInside(), FlexibleCollimator::isStopped(), Bend2D::setupDefaultFieldMap(), SingleMultipole< 4 >::update(), 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 elemedgeSet_m, elementPosition_m, and getName().

Here is the call graph for this function:

◆ getEntrance()

double ElementBase::getEntrance ( ) const
inlinevirtualinherited

Get entrance position.

Reimplemented in TBeamline< T >, TBeamline< FlaggedElmPtr >, and TBeamline< SequenceMember >.

Definition at line 427 of file ElementBase.h.

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

Here is the call graph for this function:

◆ getEntranceFrame()

Euclid3D ElementBase::getEntranceFrame ( ) const
inlinevirtualinherited

Get transform.

Reimplemented in TBeamline< T >, TBeamline< FlaggedElmPtr >, and TBeamline< SequenceMember >.

Definition at line 447 of file ElementBase.h.

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

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 getGeometry().

Here is the call graph for this function:

◆ getExit()

double ElementBase::getExit ( ) const
inlinevirtualinherited

Get exit position.

Reimplemented in TBeamline< T >, TBeamline< FlaggedElmPtr >, and TBeamline< SequenceMember >.

Definition at line 431 of file ElementBase.h.

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

Here is the call graph for this function:

◆ getExitFrame()

Euclid3D ElementBase::getExitFrame ( ) const
inlinevirtualinherited

Get transform.

Reimplemented in TBeamline< T >, TBeamline< FlaggedElmPtr >, and TBeamline< SequenceMember >.

Definition at line 451 of file ElementBase.h.

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

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 getGeometry().

Here is the call graph for this function:

◆ getField() [1/2]

BMultipoleField & MultipoleRep::getField ( )
virtual

Get field.

Implements Multipole.

Definition at line 117 of file MultipoleRep.cpp.

References field.

◆ getField() [2/2]

const BMultipoleField & MultipoleRep::getField ( ) const
virtual

Get field.

Implements Multipole.

Definition at line 122 of file MultipoleRep.cpp.

References field.

◆ getFlagDeleteOnTransverseExit()

bool ElementBase::getFlagDeleteOnTransverseExit ( ) const
inlineinherited

◆ getGeometry() [1/2]

StraightGeometry & MultipoleRep::getGeometry ( )
virtual

Get geometry.

Implements Multipole.

Definition at line 108 of file MultipoleRep.cpp.

References geometry.

◆ getGeometry() [2/2]

const StraightGeometry & MultipoleRep::getGeometry ( ) const
virtual

Get geometry.

Implements Multipole.

Definition at line 112 of file MultipoleRep.cpp.

References geometry.

◆ getMaxNormalComponentIndex()

size_t Multipole::getMaxNormalComponentIndex ( ) const
inlineinherited

Definition at line 157 of file Multipole.h.

References NormalComponents.

◆ getMaxSkewComponentIndex()

size_t Multipole::getMaxSkewComponentIndex ( ) const
inlineinherited

Definition at line 162 of file Multipole.h.

References SkewComponents.

◆ getMisalignment() [1/2]

CoordinateSystemTrafo ElementBase::getMisalignment ( ) const
inlineinherited

Definition at line 541 of file ElementBase.h.

References 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 elementID.

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

◆ getNormalComponent()

double Multipole::getNormalComponent ( int n) const
inherited

Get normal component.

Definition at line 85 of file Multipole.cpp.

Referenced by MultipoleRep::getChannel().

◆ getNSlices()

std::size_t Multipole::getNSlices ( ) const
inherited

Definition at line 147 of file Multipole.cpp.

References nSlices_m.

Referenced by ThickTracker::visitMultipole().

◆ getOrigin()

double ElementBase::getOrigin ( ) const
inlinevirtualinherited

Get origin position.

Reimplemented in TBeamline< T >, TBeamline< FlaggedElmPtr >, and TBeamline< SequenceMember >.

Definition at line 423 of file ElementBase.h.

References getGeometry(), and BGeometryBase::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 getName(), and outputfn_m.

Referenced by Probe::doInitialise(), Cyclotron::initialise(), FlexibleCollimator::initialise(), FlexibleCollimator::initialise(), Monitor::initialise(), PluginElement::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.

◆ getRequiredNumberOfTimeSteps()

int ElementBase::getRequiredNumberOfTimeSteps ( ) const
inlinevirtualinherited

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

Definition at line 603 of file ElementBase.h.

◆ getRotationAboutZ()

double ElementBase::getRotationAboutZ ( ) const
inlineinherited

Definition at line 574 of file ElementBase.h.

References rotationZAxis_m.

Referenced by OpalBeamline::compute3DLattice(), and Bend2D::setFieldCalcParam().

◆ getSkewComponent()

double Multipole::getSkewComponent ( int n) const
inherited

Get skew component.

Definition at line 93 of file Multipole.cpp.

References max_SkewComponent_m, and SkewComponents.

Referenced by MultipoleRep::getChannel().

◆ getTotalTransform()

Euclid3D ElementBase::getTotalTransform ( ) const
inlinevirtualinherited

Get transform.

Reimplemented in TBeamline< T >, TBeamline< FlaggedElmPtr >, and TBeamline< SequenceMember >.

Definition at line 439 of file ElementBase.h.

References getGeometry(), and BGeometryBase::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 >, TBeamline< FlaggedElmPtr >, and TBeamline< SequenceMember >.

Definition at line 435 of file ElementBase.h.

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

Referenced by 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 >, TBeamline< FlaggedElmPtr >, and TBeamline< SequenceMember >.

Definition at line 443 of file ElementBase.h.

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

Here is the call graph for this function:

◆ getType()

ElementType Multipole::getType ( ) const
overridevirtualinherited

Get element type std::string.

Reimplemented from Component.

Definition at line 344 of file Multipole.cpp.

References MULTIPOLE.

◆ getTypeString() [1/2]

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

Definition at line 579 of file ElementBase.h.

References getType(), and getTypeString().

Referenced by ParallelCyclotronTracker::execute(), getTypeString(), 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 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 wake_m.

◆ goOffline()

void Component::goOffline ( )
virtualinherited

Reimplemented in Degrader, FlexibleCollimator, Monitor, PluginElement, RBend3D, RFCavity, Solenoid, Source, TravelingWave, and Vacuum.

Definition at line 87 of file Component.cpp.

References online_m.

◆ goOnline()

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

Reimplemented in Bend2D, CCollimator, Corrector, Degrader, FlexibleCollimator, Monitor, RBend3D, RFCavity, Solenoid, Source, TravelingWave, and Vacuum.

Definition at line 83 of file Component.cpp.

References online_m.

Referenced by PluginElement::initialise().

◆ 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 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 bgeometry_m.

◆ hasParticleMatterInteraction()

bool ElementBase::hasParticleMatterInteraction ( ) const
inlinevirtualinherited

Definition at line 487 of file ElementBase.h.

References parmatint_m.

◆ hasWake()

bool ElementBase::hasWake ( ) const
inlinevirtualinherited

Definition at line 471 of file ElementBase.h.

References wake_m.

◆ initialise()

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

Implements Component.

Definition at line 322 of file Multipole.cpp.

References ElementBase::getElementLength(), Component::online_m, and Component::RefPartBunch_m.

Here is the call graph for this function:

◆ isElementPositionSet()

bool ElementBase::isElementPositionSet ( ) const
inlineinherited

Definition at line 598 of file ElementBase.h.

References elemedgeSet_m.

◆ isFocusing()

bool Multipole::isFocusing ( unsigned int component) const
inherited

Definition at line 357 of file Multipole.cpp.

References NormalComponents, and Component::RefPartBunch_m.

◆ isInside()

bool Multipole::isInside ( const Vector_t & r) const
overridevirtualinherited

Reimplemented from ElementBase.

Definition at line 349 of file Multipole.cpp.

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

Here is the call graph for this function:

◆ isInsideTransverse()

◆ isPositioned()

bool ElementBase::isPositioned ( ) const
inlineinherited

Definition at line 556 of file ElementBase.h.

References positionIsFixed.

Referenced by OpalRBend3D::update(), OpalRBend::update(), and OpalSBend::update().

◆ isSharable()

bool ElementBase::isSharable ( ) const
inlineinherited

Test if the element can be shared.

Definition at line 463 of file ElementBase.h.

References shareFlag.

Referenced by copyStructure(), TBeamline< T >::copyStructure(), and Sequence::updateList().

◆ isShared()

bool RCObject::isShared ( ) const
inlineinherited

Test for sharing.

Definition at line 93 of file RCObject.h.

References refCount.

◆ makeSharable()

void ElementBase::makeSharable ( )
virtualinherited

Set sharable flag.

Reimplemented in TBeamline< T >, TBeamline< FlaggedElmPtr >, and TBeamline< SequenceMember >.

Definition at line 253 of file ElementBase.cpp.

References shareFlag.

Referenced by OpalMarker::OpalMarker().

◆ Online()

bool Component::Online ( )
virtualinherited

Definition at line 91 of file Component.cpp.

References online_m.

◆ operator=()

void MultipoleRep::operator= ( const MultipoleRep & )
private

References MultipoleRep().

Here is the call graph for this function:

◆ releasePosition()

void ElementBase::releasePosition ( )
inlineinherited

Definition at line 546 of file ElementBase.h.

References positionIsFixed.

Referenced by OpalRBend3D::update(), OpalRBend::update(), and OpalSBend::update().

◆ removeAttribute()

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

Remove an existing attribute.

Definition at line 212 of file ElementBase.cpp.

References userAttribs.

◆ removeReference()

int RCObject::removeReference ( ) const
inlineinherited

Decrement the reference count.

Definition at line 88 of file RCObject.h.

References refCount.

◆ setActionRange()

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

Definition at line 561 of file ElementBase.h.

References actionRange_m, and 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 getChannel(), and Channel::isSettable().

Referenced by TBeamline< FlaggedElmPtr >::getChannel(), and OpalElement::updateUnknown().

Here is the call graph for this function:

◆ setBoundaryGeometry()

void ElementBase::setBoundaryGeometry ( BoundaryGeometry * geo)
virtualinherited

attach a boundary geometry field to the element

Definition at line 270 of file ElementBase.cpp.

References 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.

◆ setDesignEnergy()

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

Reimplemented in BendBase, Corrector, and RFCavity.

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 elemedgeSet_m, and elementPosition_m.

Referenced by OpalElement::update().

◆ setExitFaceSlope()

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

Definition at line 225 of file Component.h.

References exit_face_slope_m.

◆ setField()

void MultipoleRep::setField ( const BMultipoleField & field)
virtual

Set mulitpole field.

Definition at line 127 of file MultipoleRep.cpp.

References field.

Referenced by OpalMultipole::update(), OpalOctupole::update(), OpalQuadrupole::update(), and OpalSextupole::update().

◆ setFlagDeleteOnTransverseExit()

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

Definition at line 608 of file ElementBase.h.

References deleteOnTransverseExit_m.

Referenced by OpalElement::update().

◆ setMisalignment()

void ElementBase::setMisalignment ( const CoordinateSystemTrafo & cst)
inlineinherited

Definition at line 536 of file ElementBase.h.

References 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 elementID, and name.

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

◆ setNormalComponent() [1/2]

void Multipole::setNormalComponent ( int n,
double v )
inlineinherited

Set normal component.

Definition at line 147 of file Multipole.h.

References setNormalComponent().

Referenced by MultipoleRep::getChannel(), setNormalComponent(), OpalMultipole::update(), OpalOctupole::update(), OpalQuadrupole::update(), and OpalSextupole::update().

Here is the call graph for this function:

◆ setNormalComponent() [2/2]

void Multipole::setNormalComponent ( int n,
double v,
double vError )
inherited

Set normal component.

Definition at line 101 of file Multipole.cpp.

◆ setNSlices()

void Multipole::setNSlices ( const std::size_t & nSlices)
inherited

Definition at line 142 of file Multipole.cpp.

References nSlices_m.

Referenced by OpalQuadrupole::update().

◆ setOutputFN()

◆ setParticleMatterInteraction()

◆ setRotationAboutZ()

void ElementBase::setRotationAboutZ ( double rotation)
inlineinherited

Set rotation about z axis in bend frame.

Definition at line 569 of file ElementBase.h.

References rotationZAxis_m.

Referenced by OpalElement::update().

◆ setSkewComponent() [1/2]

void Multipole::setSkewComponent ( int n,
double v )
inlineinherited

Set skew component.

Definition at line 152 of file Multipole.h.

References setSkewComponent().

Referenced by MultipoleRep::getChannel(), setSkewComponent(), OpalMultipole::update(), OpalOctupole::update(), OpalQuadrupole::update(), and OpalSextupole::update().

Here is the call graph for this function:

◆ setSkewComponent() [2/2]

void Multipole::setSkewComponent ( int n,
double v,
double vError )
inherited

Set skew component.

Definition at line 121 of file Multipole.cpp.

◆ 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.

Referenced by Monitor::driftToCorrectPositionAndSave().

Member Data Documentation

◆ actionRange_m

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

Definition at line 399 of file ElementBase.h.

Referenced by setActionRange().

◆ aperture_m

◆ bgeometry_m

BoundaryGeometry* ElementBase::bgeometry_m
privateinherited

◆ csTrafoGlobal2Local_m

◆ 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().

◆ 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 setName().

◆ elementPosition_m

double ElementBase::elementPosition_m
privateinherited

ELEMEDGE attribute.

Definition at line 396 of file ElementBase.h.

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

◆ elementTypeToString_s

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

Definition at line 71 of file ElementBase.h.

Referenced by getTypeString().

◆ exit_face_slope_m

double Component::exit_face_slope_m
protectedinherited

Definition at line 189 of file Component.h.

Referenced by Component(), Component(), and setExitFaceSlope().

◆ field

BMultipoleField MultipoleRep::field
private

Multipole field.

Definition at line 72 of file MultipoleRep.h.

Referenced by getField(), getField(), MultipoleRep(), MultipoleRep(), MultipoleRep(), and setField().

◆ geometry

StraightGeometry MultipoleRep::geometry
private

Multipole geometry.

Definition at line 69 of file MultipoleRep.h.

Referenced by getGeometry(), getGeometry(), MultipoleRep(), MultipoleRep(), and MultipoleRep().

◆ max_NormalComponent_m

int Multipole::max_NormalComponent_m
privateinherited

Definition at line 142 of file Multipole.h.

Referenced by applyToReferenceParticle(), and computeField().

◆ max_SkewComponent_m

int Multipole::max_SkewComponent_m
privateinherited

◆ misalignment_m

CoordinateSystemTrafo ElementBase::misalignment_m
protectedinherited

Definition at line 367 of file ElementBase.h.

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

◆ NormalComponentErrors

std::vector<double> Multipole::NormalComponentErrors
privateinherited

Definition at line 138 of file Multipole.h.

Referenced by applyToReferenceParticle(), Multipole(), and Multipole().

◆ NormalComponents

std::vector<double> Multipole::NormalComponents
privateinherited

◆ nSlices_m

std::size_t Multipole::nSlices_m
privateinherited

Definition at line 143 of file Multipole.h.

Referenced by getNSlices(), and setNSlices().

◆ 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 setOutputFN().

◆ parmatint_m

ParticleMatterInteractionHandler* ElementBase::parmatint_m
privateinherited

◆ positionIsFixed

bool ElementBase::positionIsFixed
privateinherited

◆ refCount

int RCObject::refCount
mutableprivateinherited

Definition at line 76 of file RCObject.h.

Referenced by addReference(), isShared(), RCObject(), RCObject(), and removeReference().

◆ RefPartBunch_m

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

Definition at line 191 of file Component.h.

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

◆ rotationZAxis_m

double ElementBase::rotationZAxis_m
protectedinherited

◆ shareFlag

bool ElementBase::shareFlag
mutableprotectedinherited

◆ SkewComponentErrors

std::vector<double> Multipole::SkewComponentErrors
privateinherited

Definition at line 140 of file Multipole.h.

Referenced by applyToReferenceParticle(), Multipole(), and Multipole().

◆ SkewComponents

std::vector<double> Multipole::SkewComponents
privateinherited

◆ userAttribs

AttributeSet ElementBase::userAttribs
privateinherited

Definition at line 386 of file ElementBase.h.

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

◆ wake_m

WakeFunction* ElementBase::wake_m
privateinherited

Definition at line 388 of file ElementBase.h.

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


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