#include <MultipoleTStraight.h>

Inheritance diagram for MultipoleTStraight:

Collaboration diagram for MultipoleTStraight:

Public Member Functions
	MultipoleTStraight (const std::string &name)
	MultipoleTStraight (const MultipoleTStraight &right)
	~MultipoleTStraight ()
virtual ElementBase *	clone () const override
void	accept (BeamlineVisitor &visitor) const override
virtual void	setMaxOrder (const std::size_t &maxOrder) override
StraightGeometry &	getGeometry () override
const StraightGeometry &	getGeometry () const override
virtual void	initialise (PartBunch_t *bunch, double &startField, double &endField) override
EMField &	getField ()
const EMField &	getField () const
bool	apply (const Vector_t< double, 3 > &R, const Vector_t< double, 3 > &P, const double &t, Vector_t< double, 3 > &E, Vector_t< double, 3 > &B)
bool	apply (const size_t &i, const double &t, Vector_t< double, 3 > &E, Vector_t< double, 3 > &B)
void	finalise ()
bool	bends () const
double	getDipoleConstant () const
void	setDipoleConstant (const double &B0)
std::size_t	getMaxOrder () const
std::size_t	getTransMaxOrder () const
void	setTransMaxOrder (const std::size_t &transMaxOrder)
void	setTransProfile (const std::size_t &n, const double &Bn)
double	getTransProfile (const std::size_t &n) const
std::vector< double >	getTransProfile () const
bool	setFringeField (const double &s0, const double &lambda_left, const double &lambda_right)
std::vector< double >	getFringeLength () const
void	setEntranceAngle (const double &entranceAngle)
virtual void	setBendAngle (const double &angle)
virtual double	getBendAngle () const
double	getEntranceAngle () const
void	setLength (const double &length)
double	getLength () const
void	setAperture (const double &vertAp, const double &horizAp)
void	setAperture (const ApertureType &type, const std::vector< double > &args)
std::vector< double >	getAperture () const
void	setRotation (const double &rot)
double	getRotation () const
double	getBoundingBoxLength () const
void	setBoundingBoxLength (const double &boundingBoxLength)
virtual void	getDimensions (double &zBegin, double &zEnd) const
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	applyToReferenceParticle (const Vector_t< double, 3 > &R, const Vector_t< double, 3 > &P, const double &t, Vector_t< double, 3 > &E, Vector_t< double, 3 > &B)
virtual bool	getPotential (const Vector_t< double, 3 > &, const double &, Vector_t< double, 3 > &, 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 ElementType	getType () const
	Get element type std::string.
virtual const ElementBase &	getDesign () const
	Return design element.
virtual void	trackBunch (PartBunch_t *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 Channel *	getChannel (const std::string &aKey, bool create=false)
	Construct a read/write channel.
virtual const ConstChannel *	getConstChannel (const std::string &aKey) const
	Construct a read-only channel.
virtual ElementBase *	copyStructure ()
	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 BoundaryGeometry *	getBoundaryGeometry () 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 WakeFunction *	getWake () const
	return the attached wake object if there is any
virtual bool	hasWake () const
virtual void	setParticleMatterInteraction (ParticleMatterInteractionHandler *spys)
virtual ParticleMatterInteractionHandler *	getParticleMatterInteraction () 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
virtual bool	isInside (const Vector_t< double, 3 > &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.
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
double	getFringeDeriv (const std::size_t &n, const double &s)
double	getTransDeriv (const std::size_t &n, const double &x)
bool	isInsideTransverse (const Vector_t< double, 3 > &r) const

Protected Attributes
double	exit_face_slope_m
PartBunch_t *	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 = std::vector<double>({1e6, 1e6, 1.0})

Private Member Functions
MultipoleTStraight	operator= (const MultipoleTStraight &rhs)
virtual void	transformCoords (Vector_t< double, 3 > &R) override
virtual void	transformBField (Vector_t< double, 3 > &B, const Vector_t< double, 3 > &R) override
virtual double	getRadius (const double &s) override
virtual double	getScaleFactor (const double &x, const double &s) override
virtual double	getBx (const Vector_t< double, 3 > &R) override
virtual double	getBs (const Vector_t< double, 3 > &R) override
virtual double	getFn (const std::size_t &n, const double &x, const double &s) override
Vector_t< double, 3 >	rotateFrame (const Vector_t< double, 3 > &R)
Vector_t< double, 3 >	rotateFrameInverse (Vector_t< double, 3 > &B)
double	getBz (const Vector_t< double, 3 > &R)
bool	insideAperture (const Vector_t< double, 3 > &R)
double	getFnDerivX (const std::size_t &n, const double &x, const double &s)
double	getFnDerivS (const std::size_t &n, const double &x, const double &s)

Private Attributes
StraightGeometry	straightGeometry_m
endfieldmodel::Tanh	fringeField_l
endfieldmodel::Tanh	fringeField_r
std::size_t	maxOrder_m
std::size_t	transMaxOrder_m = 0
std::vector< double >	transProfile_m
double	length_m
double	entranceAngle_m
double	rotation_m
double	boundingBoxLength_m
double	verticalApert_m
double	horizontalApert_m
BMultipoleField	dummy
std::string	elementID
AttributeSet	userAttribs
WakeFunction *	wake_m
BoundaryGeometry *	bgeometry_m
ParticleMatterInteractionHandler *	parmatint_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

MultipoleTiStraight defines a straight combined function magnet (up to arbitrary multipole component) with fringe fields

Class category: AbsBeamline
$Author: Titus Dascalu, Martin Duy Tat, Chris Rogers

The field is obtained from the scalar potential

\[ V = f_0(x,s) z + f_1 (x,s) \frac{z^3}{3!} + f_2 (x,s) \frac{z^5}{5!} + ... \]

(x,z,s) -> Frenet-Serret local coordinates along the magnet
z -> vertical component
assume mid-plane symmetry
set field on mid-plane -> $ B_z = f_0(x,s) = T(x) \cdot S(s) $
T(x) -> transverse profile; this is a polynomial describing the field expansion on the mid-plane inside the magnet (not in the fringe field); 1st term is the dipole strength, 2nd term is the quadrupole gradient * x, etc.
-> when setting the magnet, one gives the multipole coefficients of this polynomial (i.e. dipole strength,
quadrupole gradient, etc.)

----------— example --------------------------------------------—
Setting a combined function magnet with dipole, quadrupole and sextupole components:
$ T(x) = B_0 + B_1 \cdot x + B_2 \cdot x^2 $
user gives $ B_0, B_1, B_2 $
----------— example end ----------------------------------------—

S(s) -> fringe field
recursion -> $ f_n (x,s) = (-1)^n \cdot \sum_{i=0}^{n} C_n^i \cdot T^{(2i)} \cdot S^{(2n-2i)} $
for curved magnets the above recursion is more complicated
$ C_n^i $ -> binomial coeff; $ T^{(n)} $ -> n-th derivative

Definition at line 82 of file MultipoleTStraight.h.

Constructor & Destructor Documentation

◆ MultipoleTStraight() [1/2]

MultipoleTStraight::MultipoleTStraight ( const std::string & name )

explicit

Constructor

Parameters

name	-> User-defined name

Definition at line 35 of file MultipoleTStraight.cpp.

References MultipoleTBase::getLength(), MultipoleTBase::MultipoleTBase(), and straightGeometry_m.

Referenced by clone(), MultipoleTStraight(), and operator=().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ MultipoleTStraight() [2/2]

MultipoleTStraight::MultipoleTStraight ( const MultipoleTStraight & right )

Copy constructor

Definition at line 40 of file MultipoleTStraight.cpp.

References MultipoleTBase::MultipoleTBase(), MultipoleTStraight(), Component::RefPartBunch_m, and straightGeometry_m.

Here is the call graph for this function:

◆ ~MultipoleTStraight()

MultipoleTStraight::~MultipoleTStraight ( )

Destructor

Definition at line 47 of file MultipoleTStraight.cpp.

Member Function Documentation

◆ accept()

void MultipoleTStraight::accept ( BeamlineVisitor & visitor ) const

inlineoverridevirtual

Accept a beamline visitor

Implements ElementBase.

Definition at line 153 of file MultipoleTStraight.h.

References BeamlineVisitor::visitMultipoleTStraight().

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

Here is the caller graph for this function:

◆ apply() [1/2]

bool MultipoleTBase::apply	(	const size_t &	i,
		const double &	t,
		Vector_t< double, 3 > &	E,
		Vector_t< double, 3 > &	B )

inlinevirtualinherited

Calculate the field at the position of the ith particle

Parameters

i	-> Index of the particle event; field is calculated at this position If particle is outside field map true is returned, otherwise false is returned
t	-> Time at which the field is to be calculated
E	-> Calculated electric field - always 0 (no E-field)
B	-> Calculated magnetic field

Reimplemented from Component.

Definition at line 324 of file MultipoleTBase.h.

References apply(), and Component::RefPartBunch_m.

Here is the call graph for this function:

◆ apply() [2/2]

bool MultipoleTBase::apply	(	const Vector_t< double, 3 > &	R,
		const Vector_t< double, 3 > &	P,
		const double &	t,
		Vector_t< double, 3 > &	E,
		Vector_t< double, 3 > &	B )

virtualinherited

Calculate the field at some arbitrary position
If particle is outside field map true is returned, otherwise false is returned

Parameters

R	-> Position in the lab coordinate system of the multipole
P	-> Not used
t	-> Time at which the field is to be calculated
E	-> Calculated electric field - always 0 (no E-field)
B	-> Calculated magnetic field

Rotate coordinates around the central axis of the magnet

Go to local Frenet-Serret coordinates

Calculate B-field in the local Frenet-Serret frame

Transform B-field from local to lab coordinates

Reimplemented from Component.

Definition at line 74 of file MultipoleTBase.cpp.

References getBs(), getBx(), getBz(), ElementBase::getFlagDeleteOnTransverseExit(), insideAperture(), rotateFrame(), transformBField(), and transformCoords().

Referenced by apply().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ applyToReferenceParticle()

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

virtualinherited

Reimplemented in Monitor, Multipole, PluginElement, RFCavity, Solenoid, and TravelingWave.

Definition at line 100 of file Component.cpp.

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

Here is the call graph for this function:

◆ bends()

bool MultipoleTBase::bends ( ) const

inlinevirtualinherited

Return true if dipole component not zero

Implements Component.

Definition at line 422 of file MultipoleTBase.h.

References transProfile_m.

◆ Bfield() [1/2]

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

inlineinherited

Return the field in a point.

Definition at line 196 of file Component.h.

References EMField::Bfield(), and 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 204 of file Component.h.

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

Here is the call graph for this function:

◆ clone()

ElementBase * MultipoleTStraight::clone ( ) const

overridevirtual

Inheritable copy constructor

Implements ElementBase.

Definition at line 50 of file MultipoleTStraight.cpp.

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

Here is the call graph for this function:

◆ copyStructure()

ElementBase * ElementBase::copyStructure ( )

virtualinherited

Make a structural copy.

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

Definition at line 204 of file ElementBase.cpp.

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ EBfield() [1/2]

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

inlineinherited

Return the field in a point.

Definition at line 208 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 212 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 192 of file Component.h.

References EMField::Efield(), and 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 200 of file Component.h.

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

Here is the call graph for this function:

◆ finalise()

void MultipoleTBase::finalise ( )

inlinevirtualinherited

Finalise the MultipoleT - sets bunch to nullptr

Implements Component.

Definition at line 321 of file MultipoleTBase.h.

References Component::RefPartBunch_m.

◆ fixPosition()

void ElementBase::fixPosition ( )

inlineinherited

Definition at line 521 of file ElementBase.h.

References positionIsFixed.

Referenced by OpalElement::update().

Here is the caller graph for this function:

◆ getAperture()

std::vector< double > MultipoleTBase::getAperture ( ) const

inlineinherited

Get the aperture dimensions Returns a vector of 2 doubles

Definition at line 407 of file MultipoleTBase.h.

References horizontalApert_m, and verticalApert_m.

◆ getArcLength()

double ElementBase::getArcLength ( ) const

inlinevirtualinherited

Get arc length.

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

Definition at line 392 of file ElementBase.h.

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

Referenced by TBeamline< T >::getTransform().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getAttribute()

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

virtualinherited

Get attribute value.

Definition at line 153 of file ElementBase.cpp.

References getConstChannel().

Here is the call graph for this function:

◆ getBendAngle()

double MultipoleTBase::getBendAngle ( ) const

inlinevirtualinherited

Get the bending angle of the magnet

Reimplemented in MultipoleTCurvedConstRadius, and MultipoleTCurvedVarRadius.

Definition at line 337 of file MultipoleTBase.h.

◆ getBoundaryGeometry()

BoundaryGeometry * ElementBase::getBoundaryGeometry ( ) const

inlinevirtualinherited

return the attached boundary geometrt object if there is any

Definition at line 456 of file ElementBase.h.

References bgeometry_m.

◆ getBoundingBoxInLabCoords()

BoundingBox ElementBase::getBoundingBoxInLabCoords ( ) const

virtualinherited

Definition at line 272 of file ElementBase.cpp.

References csTrafoGlobal2Local_m, getEdgeToBegin(), and getEdgeToEnd().

Here is the call graph for this function:

◆ getBoundingBoxLength()

double MultipoleTBase::getBoundingBoxLength ( ) const

inlineinherited

Get distance between centre of magnet and entrance

Definition at line 384 of file MultipoleTBase.h.

References boundingBoxLength_m.

Referenced by MultipoleTCurvedConstRadius::initialise(), MultipoleTCurvedVarRadius::initialise(), and MultipoleTStraight::initialise().

Here is the caller graph for this function:

◆ getBs()

double MultipoleTStraight::getBs ( const Vector_t< double, 3 > & R )

overrideprivatevirtual

Get s-component of the B-field
This function has been overloaded because calculating
the B-field directly is quicker and more accurate

Reimplemented from MultipoleTBase.

Definition at line 76 of file MultipoleTStraight.cpp.

References MultipoleTBase::getFringeDeriv(), MultipoleTBase::getMaxOrder(), and MultipoleTBase::getTransDeriv().

Here is the call graph for this function:

◆ getBx()

double MultipoleTStraight::getBx ( const Vector_t< double, 3 > & R )

overrideprivatevirtual

Get x-component of the B-field
This function has been overloaded because calculating
the B-field directly is quicker and more accurate

Reimplemented from MultipoleTBase.

Definition at line 62 of file MultipoleTStraight.cpp.

References MultipoleTBase::getFringeDeriv(), MultipoleTBase::getMaxOrder(), and MultipoleTBase::getTransDeriv().

Here is the call graph for this function:

◆ getBz()

double MultipoleTBase::getBz ( const Vector_t< double, 3 > & R )

privateinherited

Returns the vertical field component
Returns zero far outside fringe field $ Bz = sum_n f_n * z^(2n) / (2n)! $

Definition at line 142 of file MultipoleTBase.cpp.

References getFn(), getFringeDeriv(), and getMaxOrder().

Referenced by apply().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getChannel()

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

virtualinherited

Construct a read/write channel.

Reimplemented in DriftRep, MonitorRep, MultipoleRep, ProbeRep, RFCavityRep, SolenoidRep, and TravelingWaveRep.

Definition at line 190 of file ElementBase.cpp.

References userAttribs.

Referenced by DriftRep::getChannel(), MonitorRep::getChannel(), MultipoleRep::getChannel(), ProbeRep::getChannel(), RFCavityRep::getChannel(), SolenoidRep::getChannel(), TravelingWaveRep::getChannel(), getConstChannel(), and setAttribute().

Here is the caller graph for this function:

◆ getConstChannel()

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

virtualinherited

Construct a read-only channel.

Definition at line 194 of file ElementBase.cpp.

References ElementBase(), and getChannel().

Referenced by getAttribute(), and hasAttribute().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getCSTrafoGlobal2Local()

CoordinateSystemTrafo ElementBase::getCSTrafoGlobal2Local ( ) const

inlineinherited

Definition at line 479 of file ElementBase.h.

References csTrafoGlobal2Local_m.

Referenced by MeshGenerator::add().

Here is the caller graph for this function:

◆ getDesign()

const ElementBase & Component::getDesign ( ) const

virtualinherited

Return design element.

Definition at line 52 of file Component.cpp.

References ElementBase::ElementBase().

Here is the call graph for this function:

◆ getDesignEnergy()

double Component::getDesignEnergy ( ) const

inlinevirtualinherited

Reimplemented in RFCavity.

Definition at line 231 of file Component.h.

◆ getDimensions()

void MultipoleTBase::getDimensions	(	double &	zBegin,
		double &	zEnd ) const

inlinevirtualinherited

Not implemented

Implements Component.

Definition at line 431 of file MultipoleTBase.h.

◆ getDipoleConstant()

double MultipoleTBase::getDipoleConstant ( ) const

inlineinherited

Get the dipole constant B_0

Definition at line 356 of file MultipoleTBase.h.

References transProfile_m.

◆ getEdgeToBegin()

CoordinateSystemTrafo ElementBase::getEdgeToBegin ( ) const

inlinevirtualinherited

Reimplemented in RFCavity, Solenoid, and TravelingWave.

Definition at line 483 of file ElementBase.h.

Referenced by getBoundingBoxInLabCoords(), and TBeamline< FlaggedElmPtr >::getConstChannel().

Here is the caller graph for this function:

◆ getEdgeToEnd()

CoordinateSystemTrafo ElementBase::getEdgeToEnd ( ) const

inlinevirtualinherited

Reimplemented in RFCavity, Solenoid, and TravelingWave.

Definition at line 488 of file ElementBase.h.

References getElementLength().

Referenced by getBoundingBoxInLabCoords().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getElementDimensions()

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

inlinevirtualinherited

Reimplemented in RFCavity, Solenoid, and TravelingWave.

Definition at line 159 of file ElementBase.h.

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

Referenced by MeshGenerator::add().

Here is the call graph for this function:

Here is the caller 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 396 of file ElementBase.h.

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

Referenced by Component::apply(), Corrector::apply(), Multipole::apply(), Multipole::apply(), Solenoid::apply(), Component::applyToReferenceParticle(), Multipole::applyToReferenceParticle(), Solenoid::applyToReferenceParticle(), TBeamline< FlaggedElmPtr >::getConstChannel(), Corrector::getDimensions(), Drift::getDimensions(), Multipole::getDimensions(), Solenoid::getDimensions(), getEdgeToEnd(), Solenoid::getEdgeToEnd(), getElementDimensions(), Solenoid::getElementDimensions(), RFCavity::getElementLength(), Corrector::initialise(), Drift::initialise(), Multipole::initialise(), Solenoid::initialise(), isInside(), Monitor::isInside(), and Multipole::isInside().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getElementPosition()

double ElementBase::getElementPosition ( ) const

inlineinherited

Definition at line 553 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 408 of file ElementBase.h.

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

Here is the call graph for this function:

◆ getEntranceAngle()

double MultipoleTBase::getEntranceAngle ( ) const

inlineinherited

Get the entrance angle

Definition at line 347 of file MultipoleTBase.h.

References entranceAngle_m.

◆ getEntranceFrame()

Euclid3D ElementBase::getEntranceFrame ( ) const

inlinevirtualinherited

Get transform.

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

Definition at line 428 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 436 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 412 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 432 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 440 of file ElementBase.h.

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

Here is the call graph for this function:

◆ getField() [1/2]

EMField & MultipoleTBase::getField ( )

inlinevirtualinherited

Return a dummy field value

Implements Component.

Definition at line 425 of file MultipoleTBase.h.

References dummy.

◆ getField() [2/2]

const EMField & MultipoleTBase::getField ( ) const

inlinevirtualinherited

Return a dummy field value

Implements Component.

Definition at line 428 of file MultipoleTBase.h.

References dummy.

◆ getFlagDeleteOnTransverseExit()

bool ElementBase::getFlagDeleteOnTransverseExit ( ) const

inlineinherited

Definition at line 574 of file ElementBase.h.

References deleteOnTransverseExit_m.

Referenced by Corrector::apply(), Multipole::apply(), Multipole::apply(), MultipoleT::apply(), MultipoleTBase::apply(), RFCavity::apply(), Solenoid::apply(), and TravelingWave::apply().

Here is the caller graph for this function:

◆ getFn()

double MultipoleTStraight::getFn	(	const std::size_t &	n,
		const double &	x,
		const double &	s )

overrideprivatevirtual

Calculate fn(x, s) by expanding the differential operator (from Laplacian and scalar potential) in terms of polynomials

Parameters

n	-> nth derivative
x	-> Coordinate x
s	-> Coordinate s

Implements MultipoleTBase.

Definition at line 90 of file MultipoleTStraight.cpp.

References MultipoleTBase::getFringeDeriv(), and MultipoleTBase::getTransDeriv().

Here is the call graph for this function:

◆ getFnDerivS()

double MultipoleTBase::getFnDerivS	(	const std::size_t &	n,
		const double &	x,
		const double &	s )

privateinherited

Calculate partial derivative of fn wrt s using a 5-point finite difference formula Error of order stepSize^4

Parameters

n	-> nth derivative
x	-> Coordinate x
s	-> Coordinate s

Definition at line 239 of file MultipoleTBase.cpp.

References getFn(), getFringeDeriv(), and getTransDeriv().

Referenced by getBs().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getFnDerivX()

double MultipoleTBase::getFnDerivX	(	const std::size_t &	n,
		const double &	x,
		const double &	s )

privateinherited

Calculate partial derivative of fn wrt x using a 5-point finite difference formula Error of order stepSize^4

Parameters

n	-> nth derivative
x	-> Coordinate x
s	-> Coordinate s

Definition at line 223 of file MultipoleTBase.cpp.

References getFn(), getFringeDeriv(), and getTransDeriv().

Referenced by getBx().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getFringeDeriv()

double MultipoleTBase::getFringeDeriv	(	const std::size_t &	n,
		const double &	s )

protectedinherited

Returns the value of the fringe field n-th derivative at s

Parameters

n	-> nth derivative
s	-> Coordinate s

Definition at line 186 of file MultipoleTBase.cpp.

References fringeField_l, fringeField_r, and tanhderiv::integrate().

Referenced by getBs(), MultipoleTStraight::getBs(), getBx(), MultipoleTStraight::getBx(), getBz(), MultipoleTCurvedConstRadius::getFn(), MultipoleTCurvedVarRadius::getFn(), MultipoleTStraight::getFn(), getFnDerivS(), getFnDerivX(), and MultipoleTCurvedVarRadius::getRadius().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getFringeLength()

std::vector< double > MultipoleTBase::getFringeLength ( ) const

inlineinherited

Return vector of 2 doubles [left fringe length, right fringelength]

Definition at line 413 of file MultipoleTBase.h.

References fringeField_l, and fringeField_r.

Referenced by MultipoleTCurvedVarRadius::initialise(), MultipoleTCurvedVarRadius::transformBField(), and MultipoleTCurvedVarRadius::transformCoords().

Here is the caller graph for this function:

◆ getGeometry() [1/2]

const StraightGeometry & MultipoleTStraight::getGeometry ( ) const

inlineoverridevirtual

Return the cell geometry

Implements ElementBase.

Definition at line 173 of file MultipoleTStraight.h.

References straightGeometry_m.

◆ getGeometry() [2/2]

StraightGeometry & MultipoleTStraight::getGeometry ( )

inlineoverridevirtual

Return the cell geometry

Implements ElementBase.

Definition at line 169 of file MultipoleTStraight.h.

References straightGeometry_m.

◆ getLength()

double MultipoleTBase::getLength ( ) const

inlineinherited

Get the length of the magnet

Definition at line 381 of file MultipoleTBase.h.

References length_m.

Referenced by MultipoleTCurvedConstRadius::getFn(), MultipoleTCurvedVarRadius::getFn(), MultipoleTCurvedConstRadius::getRadius(), MultipoleTCurvedVarRadius::getRadius(), MultipoleTCurvedConstRadius::getScaleFactor(), MultipoleTCurvedConstRadius::initialise(), MultipoleTCurvedVarRadius::initialise(), MultipoleTStraight::MultipoleTStraight(), MultipoleTCurvedConstRadius::transformBField(), MultipoleTCurvedVarRadius::transformBField(), MultipoleTCurvedConstRadius::transformCoords(), and MultipoleTCurvedVarRadius::transformCoords().

Here is the caller graph for this function:

◆ getMaxOrder()

std::size_t MultipoleTBase::getMaxOrder ( ) const

inlineinherited

Get the number of terms used in calculation of field components

Definition at line 362 of file MultipoleTBase.h.

References maxOrder_m.

Referenced by getBs(), MultipoleTStraight::getBs(), getBx(), MultipoleTStraight::getBx(), and getBz().

Here is the caller graph for this function:

◆ getMisalignment() [1/2]

CoordinateSystemTrafo ElementBase::getMisalignment ( ) const

inlineinherited

Definition at line 513 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 132 of file ElementBase.cpp.

Referenced by Ring::appendElement(), Ring::apply(), TBeamline< T >::clone(), TBeamline< T >::copyStructure(), Probe::doGoOffline(), PlaceRep::enter(), getElementPosition(), RFCavity::getMomentaKick(), getOutputFN(), CavityAutophaser::getPhaseAtMaxEnergy(), Selector::handleElement(), RFCavity::initialise(), Ring::initialise(), Solenoid::initialise(), PlaceRep::leave(), Offset::Offset(), operator<<(), Offset::operator=(), operator==(), Sequence::print(), Ring::Ring(), ClassicField::SortAsc(), Component::trackBunch(), Component::trackMap(), Sequence::updateList(), ParallelTracker::updateRFElement(), and Replacer::visitFlaggedElmPtr().

Here is the caller graph for this function:

◆ getOrigin()

double ElementBase::getOrigin ( ) const

inlinevirtualinherited

Get origin position.

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

Definition at line 404 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 144 of file ElementBase.cpp.

References getName(), and outputfn_m.

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getParticleMatterInteraction()

ParticleMatterInteractionHandler * ElementBase::getParticleMatterInteraction ( ) const

inlinevirtualinherited

Definition at line 464 of file ElementBase.h.

References parmatint_m.

◆ getPotential()

virtual bool Component::getPotential	(	const Vector_t< double, 3 > &	,
		const double &	,
		Vector_t< double, 3 > &	,
		double &	)

inlinevirtualinherited

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

Parameters

R	position in the local coordinate system of the component
t	time
A	filled with the calculated magnetic vector potential
phi	filled 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 122 of file Component.h.

◆ getRadius()

double MultipoleTStraight::getRadius ( const double & s )

inlineoverrideprivatevirtual

Radius of curvature
Straight magnet, infinite radius, infinity (1.0e300) is returned

Parameters

s	-> Coordinate s

Implements MultipoleTBase.

Definition at line 160 of file MultipoleTStraight.h.

◆ getRequiredNumberOfTimeSteps()

int ElementBase::getRequiredNumberOfTimeSteps ( ) const

inlinevirtualinherited

Reimplemented in Drift, Marker, and Monitor.

Definition at line 566 of file ElementBase.h.

◆ getRotation()

double MultipoleTBase::getRotation ( ) const

inlineinherited

Get the angle of rotation of the magnet around its axis

Definition at line 372 of file MultipoleTBase.h.

References rotation_m.

◆ getRotationAboutZ()

double ElementBase::getRotationAboutZ ( ) const

inlineinherited

Definition at line 540 of file ElementBase.h.

References rotationZAxis_m.

◆ getScaleFactor()

double MultipoleTStraight::getScaleFactor	(	const double &	x,
		const double &	s )

inlineoverrideprivatevirtual

Returns the scale factor $ h_s = 1$

Parameters

x	-> Coordinate x
s	-> Coordinate s

Implements MultipoleTBase.

Definition at line 164 of file MultipoleTStraight.h.

◆ getTotalTransform()

Euclid3D ElementBase::getTotalTransform ( ) const

inlinevirtualinherited

Get transform.

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

Definition at line 420 of file ElementBase.h.

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

Here is the call graph for this function:

◆ getTransDeriv()

double MultipoleTBase::getTransDeriv	(	const std::size_t &	n,
		const double &	x )

protectedinherited

Returns the value of the transverse field n-th derivative at x
Transverse field is a polynomial in x, differentiation follows usual polynomial rules of differentiation

Parameters

n	-> nth derivative
x	-> Coordinate x

Definition at line 199 of file MultipoleTBase.cpp.

References getTransMaxOrder(), getTransProfile(), and transMaxOrder_m.

Referenced by MultipoleTStraight::getBs(), MultipoleTStraight::getBx(), MultipoleTCurvedConstRadius::getFn(), MultipoleTCurvedVarRadius::getFn(), MultipoleTStraight::getFn(), getFnDerivS(), and getFnDerivX().

Here is the call graph for this function:

Here is the caller 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 416 of file ElementBase.h.

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

Referenced by TBeamline< T >::getTransform().

Here is the call graph for this function:

Here is the caller 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 424 of file ElementBase.h.

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

Here is the call graph for this function:

◆ getTransMaxOrder()

std::size_t MultipoleTBase::getTransMaxOrder ( ) const

inlineinherited

Get the maximum order in the given transverse profile

Definition at line 365 of file MultipoleTBase.h.

References transMaxOrder_m.

Referenced by getTransDeriv(), MultipoleTCurvedConstRadius::setMaxOrder(), and MultipoleTCurvedVarRadius::setMaxOrder().

Here is the caller graph for this function:

◆ getTransProfile() [1/2]

std::vector< double > MultipoleTBase::getTransProfile ( ) const

inlineinherited

Get all terms of transverse profile

Definition at line 353 of file MultipoleTBase.h.

References transProfile_m.

Referenced by getTransDeriv().

Here is the caller graph for this function:

◆ getTransProfile() [2/2]

double MultipoleTBase::getTransProfile ( const std::size_t & n ) const

inlineinherited

Get transverse profile

Parameters

n	-> Power of x

Definition at line 350 of file MultipoleTBase.h.

References transProfile_m.

◆ getType()

ElementType Component::getType ( ) const

virtualinherited

Get element type std::string.

Implements ElementBase.

Reimplemented in Corrector, Drift, Marker, Monitor, Multipole, Probe, RFCavity, Solenoid, and TravelingWave.

Definition at line 76 of file Component.cpp.

References ANY.

◆ getTypeString() [1/2]

std::string ElementBase::getTypeString ( ) const

inlineinherited

Definition at line 544 of file ElementBase.h.

References getType(), and getTypeString().

Referenced by getTypeString().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getTypeString() [2/2]

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

staticinherited

Definition at line 200 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 448 of file ElementBase.h.

References wake_m.

◆ goOffline()

void Component::goOffline ( )

virtualinherited

Reimplemented in Monitor, PluginElement, RFCavity, Solenoid, and TravelingWave.

Definition at line 68 of file Component.cpp.

References online_m.

◆ goOnline()

void Component::goOnline ( const double & kineticEnergy )

virtualinherited

Reimplemented in Corrector, Monitor, RFCavity, Solenoid, and TravelingWave.

Definition at line 64 of file Component.cpp.

References online_m.

Referenced by PluginElement::initialise().

Here is the caller graph for this function:

◆ hasAttribute()

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

virtualinherited

Test for existence of an attribute.

Definition at line 165 of file ElementBase.cpp.

References getConstChannel().

Here is the call graph for this function:

◆ hasBoundaryGeometry()

bool ElementBase::hasBoundaryGeometry ( ) const

inlinevirtualinherited

Definition at line 460 of file ElementBase.h.

References bgeometry_m.

◆ hasParticleMatterInteraction()

bool ElementBase::hasParticleMatterInteraction ( ) const

inlinevirtualinherited

Definition at line 468 of file ElementBase.h.

References parmatint_m.

◆ hasWake()

bool ElementBase::hasWake ( ) const

inlinevirtualinherited

Definition at line 452 of file ElementBase.h.

References wake_m.

◆ initialise()

void MultipoleTStraight::initialise	(	PartBunch_t *	bunch,
		double &	startField,
		double &	endField )

inlineoverridevirtual

Initialise the MultipoleT

Parameters

bunch	-> Bunch the global bunch object
startField	-> Not used
endField	-> Not used

Reimplemented from MultipoleTBase.

Definition at line 177 of file MultipoleTStraight.h.

References MultipoleTBase::getBoundingBoxLength(), Component::RefPartBunch_m, and straightGeometry_m.

Here is the call graph for this function:

◆ insideAperture()

bool MultipoleTBase::insideAperture ( const Vector_t< double, 3 > & R )

inlineprivateinherited

Tests if inside the magnet

Parameters

R	-> Coordinate vector

Definition at line 343 of file MultipoleTBase.h.

References horizontalApert_m, and verticalApert_m.

Referenced by apply().

Here is the caller graph for this function:

◆ isElementPositionSet()

bool ElementBase::isElementPositionSet ( ) const

inlineinherited

Definition at line 562 of file ElementBase.h.

References elemedgeSet_m.

◆ isInside()

bool ElementBase::isInside ( const Vector_t< double, 3 > & r ) const

inlinevirtualinherited

Reimplemented in Monitor, Multipole, RFCavity, Solenoid, and TravelingWave.

Definition at line 504 of file ElementBase.h.

References getElementLength(), and isInsideTransverse().

Here is the call graph for this function:

◆ isInsideTransverse()

bool ElementBase::isInsideTransverse ( const Vector_t< double, 3 > & r ) const

protectedinherited

Definition at line 245 of file ElementBase.cpp.

References aperture_m.

Referenced by Component::apply(), Corrector::apply(), Multipole::apply(), Multipole::apply(), Component::applyToReferenceParticle(), Multipole::applyToReferenceParticle(), isInside(), Monitor::isInside(), Multipole::isInside(), RFCavity::isInside(), Solenoid::isInside(), and TravelingWave::isInside().

Here is the caller graph for this function:

◆ isPositioned()

bool ElementBase::isPositioned ( ) const

inlineinherited

Definition at line 525 of file ElementBase.h.

References positionIsFixed.

◆ isSharable()

bool ElementBase::isSharable ( ) const

inlineinherited

Test if the element can be shared.

Definition at line 444 of file ElementBase.h.

References shareFlag.

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

Here is the caller graph for this function:

◆ 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 212 of file ElementBase.cpp.

References shareFlag.

Referenced by OpalMarker::OpalMarker().

Here is the caller graph for this function:

◆ Online()

bool Component::Online ( )

virtualinherited

Definition at line 72 of file Component.cpp.

References online_m.

◆ operator=()

MultipoleTStraight MultipoleTStraight::operator= ( const MultipoleTStraight & rhs )

private

References MultipoleTStraight().

Here is the call graph for this function:

◆ releasePosition()

void ElementBase::releasePosition ( )

inlineinherited

Definition at line 517 of file ElementBase.h.

References positionIsFixed.

◆ removeAttribute()

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

virtualinherited

Remove an existing attribute.

Definition at line 176 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.

◆ rotateFrame()

Vector_t< double, 3 > MultipoleTBase::rotateFrame ( const Vector_t< double, 3 > & R )

privateinherited

Rotate frame for skew elements
Consecutive rotations: 1st -> about central axis 2nd -> azimuthal rotation

Parameters

R	-> Vector to be rotated

Apply two 2D rotation matrices to coordinate vector Rotate around central axis => skew fields Rotate azymuthaly => entrance angle

Definition at line 98 of file MultipoleTBase.cpp.

References entranceAngle_m, and rotation_m.

Referenced by apply().

Here is the caller graph for this function:

◆ rotateFrameInverse()

Vector_t< double, 3 > MultipoleTBase::rotateFrameInverse ( Vector_t< double, 3 > & B )

privateinherited

Inverse of the 1st rotation in rotateFrame() method
Used to rotate B field back to global coordinate system

This function represents the inverse of the rotation around the central axis performed by rotateFrame() method Used to rotate B field back to global coordinate system

Definition at line 118 of file MultipoleTBase.cpp.

References rotation_m.

◆ setActionRange()

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

inlineinherited

Definition at line 529 of file ElementBase.h.

References actionRange_m, and elementEdge_m.

◆ setAperture() [1/2]

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

inlineinherited

Definition at line 495 of file ElementBase.h.

References aperture_m.

Referenced by Component::Component(), Offset::operator=(), and OpalElement::update().

Here is the caller graph for this function:

◆ setAperture() [2/2]

void MultipoleTBase::setAperture	(	const double &	vertAp,
		const double &	horizAp )

inlineinherited

Set the aperture dimensions
This element only supports a rectangular aperture

Parameters

vertAp	-> Vertical aperture length
horizAp	-> Horisontal aperture length

Definition at line 403 of file MultipoleTBase.h.

References horizontalApert_m, and verticalApert_m.

◆ setAttribute()

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

virtualinherited

Set value of an attribute.

Definition at line 180 of file ElementBase.cpp.

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setBendAngle()

void MultipoleTBase::setBendAngle ( const double & angle )

inlinevirtualinherited

Set the bending angle of the magnet

Reimplemented in MultipoleTCurvedConstRadius, and MultipoleTCurvedVarRadius.

Definition at line 335 of file MultipoleTBase.h.

◆ setBoundaryGeometry()

void ElementBase::setBoundaryGeometry ( BoundaryGeometry * geo )

virtualinherited

attach a boundary geometry field to the element

Definition at line 228 of file ElementBase.cpp.

References bgeometry_m.

◆ setBoundingBoxLength()

void MultipoleTBase::setBoundingBoxLength ( const double & boundingBoxLength )

inlineinherited

Set distance between centre of magnet and enctrance

Parameters

boundingBoxLength -> Distance between centre and entrance

Definition at line 387 of file MultipoleTBase.h.

References boundingBoxLength_m.

◆ setCSTrafoGlobal2Local()

void ElementBase::setCSTrafoGlobal2Local ( const CoordinateSystemTrafo & ori )

inlineinherited

Definition at line 472 of file ElementBase.h.

References csTrafoGlobal2Local_m, and positionIsFixed.

Referenced by OpalElement::update().

Here is the caller graph for this function:

◆ setCurrentSCoordinate()

void ElementBase::setCurrentSCoordinate ( double s )

inherited

Definition at line 236 of file ElementBase.cpp.

◆ setDesignEnergy()

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

inlinevirtualinherited

Reimplemented in Corrector, and RFCavity.

Definition at line 228 of file Component.h.

◆ setDipoleConstant()

void MultipoleTBase::setDipoleConstant ( const double & B0 )

inlineinherited

Set the dipole constant B_0

Definition at line 397 of file MultipoleTBase.h.

References transMaxOrder_m, and transProfile_m.

◆ setElementLength()

void ElementBase::setElementLength ( double length )

inlinevirtualinherited

Set design length.

Definition at line 400 of file ElementBase.h.

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

Referenced by RFCavity::initialise(), Solenoid::initialise(), TravelingWave::initialise(), SequenceMember::setLength(), OpalCavity::update(), OpalMonitor::update(), OpalMultipole::update(), OpalMultipoleT::update(), OpalProbe::update(), OpalSolenoid::update(), and OpalTravelingWave::update().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setElementPosition()

void ElementBase::setElementPosition ( double elemedge )

inlineinherited

Access to ELEMEDGE attribute.

Definition at line 548 of file ElementBase.h.

References elemedgeSet_m, and elementPosition_m.

Referenced by OpalElement::update().

Here is the caller graph for this function:

◆ setEntranceAngle()

void MultipoleTBase::setEntranceAngle ( const double & entranceAngle )

inlineinherited

Set the entrance angle

Parameters

entranceAngle -> Entrance angle

Definition at line 340 of file MultipoleTBase.h.

References entranceAngle_m.

◆ setExitFaceSlope()

void Component::setExitFaceSlope ( const double & m )

inlineinherited

Definition at line 224 of file Component.h.

References exit_face_slope_m.

◆ setFlagDeleteOnTransverseExit()

void ElementBase::setFlagDeleteOnTransverseExit ( bool flag = true )

inlineinherited

Definition at line 570 of file ElementBase.h.

References deleteOnTransverseExit_m.

Referenced by OpalElement::update().

Here is the caller graph for this function:

◆ setFringeField()

bool MultipoleTBase::setFringeField	(	const double &	s0,
		const double &	lambda_left,
		const double &	lambda_right )

inherited

Set fringe field model
Tanh model used here

\[ 1/2 * \left [tanh \left( \frac{s + s_0}{\lambda_{left}} \right) - tanh \left( \frac{s - s_0}{\lambda_{right}} \right) \right] \]

Parameters

s0	-> Centre field length and \lambda_{left} -> Left end field length \lambda_{right} -> Right end field length

Definition at line 130 of file MultipoleTBase.cpp.

References fringeField_l, fringeField_r, and maxOrder_m.

◆ setLength()

void MultipoleTBase::setLength ( const double & length )

inlineinherited

Set the length of the magnet If straight-> Actual length If curved -> Arc length

Definition at line 378 of file MultipoleTBase.h.

References length_m.

◆ setMaxOrder()

void MultipoleTStraight::setMaxOrder ( const std::size_t & maxOrder )

overridevirtual

Set the number of terms used in calculation of field components
Maximum power of z in Bz is 2 * maxOrder_m

Parameters

maxOrder -> Number of terms in expansion in z

Reimplemented from MultipoleTBase.

Definition at line 58 of file MultipoleTStraight.cpp.

References MultipoleTBase::setMaxOrder().

Here is the call graph for this function:

◆ setMisalignment()

void ElementBase::setMisalignment ( const CoordinateSystemTrafo & cst )

inlineinherited

Definition at line 509 of file ElementBase.h.

References misalignment_m.

Referenced by OpalElement::update().

Here is the caller graph for this function:

◆ setName()

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

virtualinherited

Set element name.

Definition at line 136 of file ElementBase.cpp.

References elementID.

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

Here is the caller graph for this function:

◆ setOutputFN()

void ElementBase::setOutputFN ( std::string fn )

inherited

Set output filename.

Definition at line 140 of file ElementBase.cpp.

References outputfn_m.

Referenced by OpalMonitor::update(), and OpalProbe::update().

Here is the caller graph for this function:

◆ setParticleMatterInteraction()

void ElementBase::setParticleMatterInteraction ( ParticleMatterInteractionHandler * spys )

virtualinherited

Definition at line 232 of file ElementBase.cpp.

◆ setRotation()

void MultipoleTBase::setRotation ( const double & rot )

inlineinherited

Set the angle of rotation of the magnet around its axis
To make skew components

Parameters

rot	-> Angle of rotation

Definition at line 375 of file MultipoleTBase.h.

References rotation_m.

◆ setRotationAboutZ()

void ElementBase::setRotationAboutZ ( double rotation )

inlineinherited

Set rotation about z axis in bend frame.

Definition at line 536 of file ElementBase.h.

References rotationZAxis_m.

Referenced by OpalElement::update().

Here is the caller graph for this function:

◆ setTransMaxOrder()

void MultipoleTBase::setTransMaxOrder ( const std::size_t & transMaxOrder )

inlineinherited

Set the maximum order in the given transverse profile

Parameters

transMaxOrder -> Highest power of x in field expansion

Definition at line 368 of file MultipoleTBase.h.

References transMaxOrder_m, and transProfile_m.

◆ setTransProfile()

void MultipoleTBase::setTransProfile	(	const std::size_t &	n,
		const double &	Bn )

inlineinherited

Set transverse profile T(x) T(x) = B_0 + B1 x + B2 x^2 + B3 x^3 + ...

Parameters

n	-> Order of the term (d^n/dx^n) to be set
Bn	-> Value of transverse profile coefficient

Definition at line 390 of file MultipoleTBase.h.

References transMaxOrder_m, and transProfile_m.

◆ setWake()

void ElementBase::setWake ( WakeFunction * wf )

virtualinherited

attach a wake field to the element

Definition at line 224 of file ElementBase.cpp.

References wake_m.

◆ trackBunch()

void Component::trackBunch	(	PartBunch_t *	bunch,
		const PartData &	,
		bool	revBeam,
		bool	revTrack ) const

virtualinherited

Track particle bunch.

Definition at line 56 of file Component.cpp.

References ElementBase::getName().

Referenced by Tracker::visitComponent().

Here is the call graph for this function:

Here is the caller 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 60 of file Component.cpp.

References ElementBase::getName().

Here is the call graph for this function:

◆ transformBField()

void MultipoleTStraight::transformBField	(	Vector_t< double, 3 > &	B,
		const Vector_t< double, 3 > &	R )

inlineoverrideprivatevirtual

Transform B-field from Frenet-Serret coordinates to lab coordinates

Implements MultipoleTBase.

Definition at line 157 of file MultipoleTStraight.h.

◆ transformCoords()

void MultipoleTStraight::transformCoords ( Vector_t< double, 3 > & R )

overrideprivatevirtual

Transform to Frenet-Serret coordinates for sector magnets

Implements MultipoleTBase.

Definition at line 54 of file MultipoleTStraight.cpp.

◆ update()

bool ElementBase::update ( const AttributeSet & set )

inherited

Update element.

Definition at line 216 of file ElementBase.cpp.

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

Here is the call graph for this function:

Member Data Documentation

◆ actionRange_m

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

privateinherited

Definition at line 382 of file ElementBase.h.

Referenced by setActionRange().

◆ aperture_m

std::pair<ApertureType, std::vector<double> > ElementBase::aperture_m

protectedinherited

Definition at line 353 of file ElementBase.h.

Referenced by ElementBase(), getAperture(), isInsideTransverse(), and setAperture().

◆ bgeometry_m

BoundaryGeometry* ElementBase::bgeometry_m

privateinherited

Definition at line 373 of file ElementBase.h.

Referenced by ElementBase(), ElementBase(), getBoundaryGeometry(), hasBoundaryGeometry(), and setBoundaryGeometry().

◆ boundingBoxLength_m

double MultipoleTBase::boundingBoxLength_m

privateinherited

Distance between centre of magnet and entrance

Definition at line 262 of file MultipoleTBase.h.

Referenced by getBoundingBoxLength(), MultipoleTBase(), MultipoleTBase(), and setBoundingBoxLength().

◆ csTrafoGlobal2Local_m

CoordinateSystemTrafo ElementBase::csTrafoGlobal2Local_m

protectedinherited

Definition at line 350 of file ElementBase.h.

Referenced by ElementBase(), ElementBase(), getBoundingBoxInLabCoords(), getCSTrafoGlobal2Local(), and setCSTrafoGlobal2Local().

◆ defaultAperture_m

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

staticprotectedinherited

Definition at line 181 of file Component.h.

Referenced by Component().

◆ deleteOnTransverseExit_m

bool ElementBase::deleteOnTransverseExit_m = true

privateinherited

Definition at line 386 of file ElementBase.h.

Referenced by ElementBase(), getFlagDeleteOnTransverseExit(), and setFlagDeleteOnTransverseExit().

◆ dummy

BMultipoleField MultipoleTBase::dummy

privateinherited

Not implemented

Definition at line 282 of file MultipoleTBase.h.

Referenced by getField(), getField(), and MultipoleTBase().

◆ elemedgeSet_m

bool ElementBase::elemedgeSet_m

privateinherited

Definition at line 380 of file ElementBase.h.

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

◆ elementEdge_m

double ElementBase::elementEdge_m

protectedinherited

Definition at line 355 of file ElementBase.h.

Referenced by ElementBase(), ElementBase(), and setActionRange().

◆ elementID

std::string ElementBase::elementID

privateinherited

Definition at line 364 of file ElementBase.h.

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

◆ elementPosition_m

double ElementBase::elementPosition_m

privateinherited

ELEMEDGE attribute.

Definition at line 379 of file ElementBase.h.

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

◆ elementTypeToString_s

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

staticprivateinherited

Initial value:

= {
    {ElementType::ANY, "Any"},
    {ElementType::BEAMLINE, "Beamline"},
    {ElementType::DRIFT, "Drift"},
    {ElementType::MARKER, "Marker"},
    {ElementType::MULTIPOLE, "Multipole"},
    {ElementType::RFCAVITY, "RFCavity"},
    {ElementType::TRAVELINGWAVE, "TravelingWave"},
    {ElementType::SBEND, "SBEND"},
    {ElementType::RBEND, "RBEND"},
    {ElementType::RBEND3D, "RBEND3D"},
    {ElementType::RING, "Ring"},
    {ElementType::SOURCE, "SOURCE"},
    {ElementType::SOLENOID, "SOLENOID"},
    {ElementType::PROBE, "Probe"},
    {ElementType::VACUUM, "Vacuum"}}

Definition at line 69 of file ElementBase.h.

Referenced by getTypeString().

◆ entranceAngle_m

double MultipoleTBase::entranceAngle_m

privateinherited

Definition at line 259 of file MultipoleTBase.h.

Referenced by getEntranceAngle(), MultipoleTBase(), MultipoleTBase(), rotateFrame(), and setEntranceAngle().

◆ exit_face_slope_m

double Component::exit_face_slope_m

protectedinherited

Definition at line 183 of file Component.h.

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

◆ fringeField_l

endfieldmodel::Tanh MultipoleTBase::fringeField_l

privateinherited

Definition at line 234 of file MultipoleTBase.h.

Referenced by getFringeDeriv(), getFringeLength(), MultipoleTBase(), MultipoleTBase(), and setFringeField().

◆ fringeField_r

endfieldmodel::Tanh MultipoleTBase::fringeField_r

privateinherited

Definition at line 235 of file MultipoleTBase.h.

Referenced by getFringeDeriv(), getFringeLength(), MultipoleTBase(), MultipoleTBase(), and setFringeField().

◆ horizontalApert_m

double MultipoleTBase::horizontalApert_m

privateinherited

Definition at line 280 of file MultipoleTBase.h.

Referenced by getAperture(), insideAperture(), MultipoleTBase(), MultipoleTBase(), and setAperture().

◆ length_m

double MultipoleTBase::length_m

privateinherited

Magnet parameters

Definition at line 258 of file MultipoleTBase.h.

Referenced by getLength(), MultipoleTBase(), MultipoleTBase(), and setLength().

◆ maxOrder_m

std::size_t MultipoleTBase::maxOrder_m

privateinherited

Number of terms in z expansion used in calculating field components

Definition at line 237 of file MultipoleTBase.h.

Referenced by getMaxOrder(), MultipoleTBase(), MultipoleTBase(), setFringeField(), and setMaxOrder().

◆ misalignment_m

CoordinateSystemTrafo ElementBase::misalignment_m

protectedinherited

Definition at line 351 of file ElementBase.h.

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

◆ online_m

bool Component::online_m

protectedinherited

◆ outputfn_m

std::string ElementBase::outputfn_m

privateinherited

The name of the outputfile

Definition at line 384 of file ElementBase.h.

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

◆ parmatint_m

ParticleMatterInteractionHandler* ElementBase::parmatint_m

privateinherited

Definition at line 375 of file ElementBase.h.

Referenced by ElementBase(), ElementBase(), getParticleMatterInteraction(), and hasParticleMatterInteraction().

◆ positionIsFixed

bool ElementBase::positionIsFixed

privateinherited

Definition at line 377 of file ElementBase.h.

Referenced by ElementBase(), ElementBase(), fixPosition(), isPositioned(), releasePosition(), and setCSTrafoGlobal2Local().

◆ refCount

int RCObject::refCount

mutableprivateinherited

Definition at line 76 of file RCObject.h.

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

◆ RefPartBunch_m

PartBunch_t* Component::RefPartBunch_m

protectedinherited

Definition at line 185 of file Component.h.

Referenced by Corrector::apply(), Corrector::apply(), Multipole::apply(), MultipoleT::apply(), MultipoleTBase::apply(), RFCavity::apply(), Ring::apply(), ScalingFFAMagnet::apply(), Solenoid::apply(), TravelingWave::apply(), VerticalFFAMagnet::apply(), Component(), MultipoleT::finalise(), MultipoleTBase::finalise(), Offset::finalise(), ScalingFFAMagnet::finalise(), VerticalFFAMagnet::finalise(), Corrector::goOnline(), Corrector::initialise(), Drift::initialise(), Marker::initialise(), Monitor::initialise(), Multipole::initialise(), MultipoleTCurvedConstRadius::initialise(), MultipoleTCurvedVarRadius::initialise(), MultipoleTStraight::initialise(), Offset::initialise(), PluginElement::initialise(), RFCavity::initialise(), RFCavity::initialise(), ScalingFFAMagnet::initialise(), Solenoid::initialise(), TravelingWave::initialise(), VerticalFFAMagnet::initialise(), Multipole::isFocusing(), MultipoleT::MultipoleT(), MultipoleTBase::MultipoleTBase(), MultipoleTCurvedConstRadius::MultipoleTCurvedConstRadius(), MultipoleTCurvedVarRadius::MultipoleTCurvedVarRadius(), MultipoleTStraight::MultipoleTStraight(), ScalingFFAMagnet::ScalingFFAMagnet(), Corrector::setDesignEnergy(), Ring::setRefPartBunch(), RFCavity::trackOnAxisParticle(), and VerticalFFAMagnet::VerticalFFAMagnet().

◆ rotation_m

double MultipoleTBase::rotation_m

privateinherited

Definition at line 260 of file MultipoleTBase.h.

Referenced by getRotation(), MultipoleTBase(), MultipoleTBase(), rotateFrame(), rotateFrameInverse(), and setRotation().

◆ rotationZAxis_m

double ElementBase::rotationZAxis_m

protectedinherited

Definition at line 357 of file ElementBase.h.

Referenced by ElementBase(), ElementBase(), getRotationAboutZ(), and setRotationAboutZ().

◆ shareFlag

bool ElementBase::shareFlag

mutableprotectedinherited

Definition at line 348 of file ElementBase.h.

Referenced by Beamline::Beamline(), Beamline::Beamline(), Beamline::Beamline(), ElementBase(), ElementBase(), isSharable(), makeSharable(), and TBeamline< T >::makeSharable().

◆ straightGeometry_m

StraightGeometry MultipoleTStraight::straightGeometry_m

private

Geometry

Definition at line 116 of file MultipoleTStraight.h.

Referenced by getGeometry(), getGeometry(), initialise(), MultipoleTStraight(), and MultipoleTStraight().

◆ transMaxOrder_m

std::size_t MultipoleTBase::transMaxOrder_m = 0

privateinherited

Highest power in given mid-plane field

Definition at line 239 of file MultipoleTBase.h.

Referenced by getTransDeriv(), getTransMaxOrder(), MultipoleTBase(), MultipoleTBase(), setDipoleConstant(), setTransMaxOrder(), and setTransProfile().

◆ transProfile_m

std::vector<double> MultipoleTBase::transProfile_m

privateinherited

List of transverse profile coefficients

Definition at line 241 of file MultipoleTBase.h.

Referenced by bends(), getDipoleConstant(), getTransProfile(), getTransProfile(), MultipoleTBase(), setDipoleConstant(), setTransMaxOrder(), and setTransProfile().

◆ userAttribs

AttributeSet ElementBase::userAttribs

privateinherited

Definition at line 369 of file ElementBase.h.

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

◆ verticalApert_m

double MultipoleTBase::verticalApert_m

privateinherited

Assume rectangular aperture with these dimensions

Definition at line 279 of file MultipoleTBase.h.

Referenced by getAperture(), insideAperture(), MultipoleTBase(), MultipoleTBase(), and setAperture().

◆ wake_m

WakeFunction* ElementBase::wake_m

privateinherited

Definition at line 371 of file ElementBase.h.

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

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

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Static Protected Attributes

Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ MultipoleTStraight() [1/2]

◆ MultipoleTStraight() [2/2]

◆ ~MultipoleTStraight()

Member Function Documentation

◆ accept()

◆ addReference()

◆ apply() [1/2]

◆ apply() [2/2]

◆ applyToReferenceParticle()

◆ bends()

◆ Bfield() [1/2]

◆ Bfield() [2/2]

◆ clone()

◆ copyStructure()

◆ EBfield() [1/2]

◆ EBfield() [2/2]

◆ Efield() [1/2]

◆ Efield() [2/2]

◆ finalise()

◆ fixPosition()

◆ getAperture()

◆ getArcLength()

◆ getAttribute()

◆ getBendAngle()

◆ getBoundaryGeometry()

◆ getBoundingBoxInLabCoords()

◆ getBoundingBoxLength()

◆ getBs()

◆ getBx()

◆ getBz()

◆ getChannel()

◆ getConstChannel()

◆ getCSTrafoGlobal2Local()

◆ getDesign()

◆ getDesignEnergy()

◆ getDimensions()

◆ getDipoleConstant()

◆ getEdgeToBegin()

◆ getEdgeToEnd()

◆ getElementDimensions()

◆ getElementLength()

◆ getElementPosition()

◆ getEntrance()

◆ getEntranceAngle()

◆ getEntranceFrame()

◆ getEntrancePatch()

◆ getExit()

◆ getExitFrame()

◆ getExitPatch()

◆ getField() [1/2]

◆ getField() [2/2]

◆ getFlagDeleteOnTransverseExit()

◆ getFn()

◆ getFnDerivS()

◆ getFnDerivX()

◆ getFringeDeriv()

◆ getFringeLength()

◆ getGeometry() [1/2]

◆ getGeometry() [2/2]

◆ getLength()

◆ getMaxOrder()

◆ getMisalignment() [1/2]

◆ getMisalignment() [2/2]

◆ getName()

◆ getOrigin()

◆ getOutputFN()

◆ getParticleMatterInteraction()

◆ getPotential()

◆ getRadius()

◆ getRequiredNumberOfTimeSteps()