Interface for general multipole. More...

#include <Multipole.h>

Inheritance diagram for Multipole:

Collaboration diagram for Multipole:

Public Member Functions
	Multipole (const std::string &name)
	Constructor with given name. More...

	Multipole ()

	Multipole (const Multipole &)

virtual	~Multipole ()

virtual void	accept (BeamlineVisitor &) const override
	Apply visitor to Multipole. More...

virtual BMultipoleField &	getField () override=0
	Get multipole field. More...

virtual const BMultipoleField &	getField () const override=0
	Get multipole field. Version for const object. More...

double	getNormalComponent (int n) const
	Get normal component. More...

double	getSkewComponent (int n) const
	Get skew component. More...

void	setNormalComponent (int, double)
	Set normal component. More...

void	setNormalComponent (int, double, double)
	Set normal component. More...

void	setSkewComponent (int, double)
	Set skew component. More...

void	setSkewComponent (int, double, double)
	Set skew component. More...

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 StraightGeometry &	getGeometry () override=0
	Get geometry. More...

virtual const StraightGeometry &	getGeometry () const override=0
	Get geometry. More...

virtual void	addKR (int i, double t, Vector_t &K) override

virtual void	addKT (int i, double t, Vector_t &K) override

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 ElementBase::ElementType	getType () const override
	Get element type std::string. More...

virtual void	getDimensions (double &zBegin, double &zEnd) const override

virtual bool	isInside (const Vector_t &r) const override

Public Member Functions inherited from Component
	Component (const std::string &name)
	Constructor with given name. More...

	Component ()

	Component (const Component &right)

virtual	~Component ()

EVector	Efield (const Point3D &P) const
	Return the field in a point. More...

BVector	Bfield (const Point3D &P) const
	Return the field in a point. More...

EVector	Efield (const Point3D &P, double t) const
	Return the field in a point. More...

BVector	Bfield (const Point3D &P, double t) const
	Return the field in a point. More...

EBVectors	EBfield (const Point3D &P) const
	Return the field in a point. More...

EBVectors	EBfield (const Point3D &P, double t) const
	Return the field in a point. More...

virtual bool	getPotential (const Vector_t &R, const double &t, Vector_t &A, double &phi)

virtual double	getDesignEnergy () const

virtual void	setDesignEnergy (const double &energy, bool changeable)

virtual void	goOnline (const double &kineticEnergy)

virtual void	goOffline ()

virtual bool	Online ()

virtual void	setComponentType (std::string)

virtual std::string	getComponentType () const

virtual const ElementBase &	getDesign () const
	Return design element. More...

virtual void	trackBunch (PartBunchBase< double, 3 > *bunch, const PartData &, bool revBeam, bool revTrack) const
	Track particle bunch. More...

virtual void	trackMap (FVps< double, 6 > &map, const PartData &, bool revBeam, bool revTrack) const
	Track a map. More...

void	setExitFaceSlope (const double &)

Public Member Functions inherited from ElementBase
	ElementBase (const std::string &name)
	Constructor with given name. More...

	ElementBase ()

	ElementBase (const ElementBase &)

virtual	~ElementBase ()

virtual const std::string &	getName () const
	Get element name. More...

virtual void	setName (const std::string &name)
	Set element name. More...

std::string	getTypeString () const

virtual double	getArcLength () const
	Get arc length. More...

virtual double	getElementLength () const
	Get design length. More...

virtual void	setElementLength (double length)
	Set design length. More...

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

virtual double	getOrigin () const
	Get origin position. More...

virtual double	getEntrance () const
	Get entrance position. More...

virtual double	getExit () const
	Get exit position. More...

virtual Euclid3D	getTransform (double fromS, double toS) const
	Get transform. More...

virtual Euclid3D	getTransform (double s) const
	Get transform. More...

virtual Euclid3D	getTotalTransform () const
	Get transform. More...

virtual Euclid3D	getEntranceFrame () const
	Get transform. More...

virtual Euclid3D	getExitFrame () const
	Get transform. More...

virtual Euclid3D	getEntrancePatch () const
	Get patch. More...

virtual Euclid3D	getExitPatch () const
	Get patch. More...

virtual double	getAttribute (const std::string &aKey) const
	Get attribute value. More...

virtual bool	hasAttribute (const std::string &aKey) const
	Test for existence of an attribute. More...

virtual void	removeAttribute (const std::string &aKey)
	Remove an existing attribute. More...

virtual void	setAttribute (const std::string &aKey, double val)
	Set value of an attribute. More...

virtual Channel *	getChannel (const std::string &aKey, bool create=false)
	Construct a read/write channel. More...

virtual const ConstChannel *	getConstChannel (const std::string &aKey) const
	Construct a read-only channel. More...

virtual ElementImage *	getImage () const
	Construct an image. More...

virtual ElementBase *	clone () const =0
	Return clone. More...

virtual ElementBase *	copyStructure ()
	Make a structural copy. More...

bool	isSharable () const
	Test if the element can be shared. More...

virtual void	makeSharable ()
	Set sharable flag. More...

virtual ElementBase *	makeAlignWrapper ()
	Allow misalignment. More...

virtual ElementBase *	makeFieldWrapper ()
	Allow field errors. More...

virtual ElementBase *	makeWrappers ()
	Allow errors. More...

virtual ElementBase *	removeAlignWrapper ()
	Remove align wrapper. More...

virtual const ElementBase *	removeAlignWrapper () const
	Remove align wrapper. More...

virtual ElementBase *	removeFieldWrapper ()
	Remove field wrapper. More...

virtual const ElementBase *	removeFieldWrapper () const
	Remove field wrapper. More...

virtual ElementBase *	removeWrappers ()
	Return the design element. More...

virtual const ElementBase *	removeWrappers () const
	Return the design element. More...

bool	update (const AttributeSet &)
	Update element. More...

virtual void	setBoundaryGeometry (BoundaryGeometry *geo)

virtual BoundaryGeometry *	getBoundaryGeometry () const
	return the attached boundary geometrt object if there is any More...

virtual bool	hasBoundaryGeometry () const

virtual void	setWake (WakeFunction *wf)
	attach a wake field to the element More...

virtual WakeFunction *	getWake () const
	return the attached wake object if there is any More...

virtual bool	hasWake () const

virtual void	setParticleMatterInteraction (ParticleMatterInteractionHandler *spys)

virtual ParticleMatterInteractionHandler *	getParticleMatterInteraction () const

virtual bool	hasParticleMatterInteraction () const

ElemType	getElType () const
	returns element type as enumeration needed in the envelope tracker More...

void	setElType (ElemType elt)
	set the element type as enumeration needed in the envelope tracker More...

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 < ElementBase::ApertureType, std::vector< double > >	getAperture () const

void	setMisalignment (double x, double y, double s)

void	setMisalignment (const CoordinateSystemTrafo &cst)

void	getMisalignment (double &x, double &y, double &s) const

CoordinateSystemTrafo	getMisalignment () const

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

void	setCurrentSCoordinate (double s)

void	setRotationAboutZ (double rotation)
	Set rotation about z axis in bend frame. More...

double	getRotationAboutZ () const

void	setElementPosition (double elemedge)
	Access to ELEMEDGE attribute. More...

double	getElementPosition () const

bool	isElementPositionSet () const

Public Member Functions inherited from RCObject
int	addReference () const
	Increment reference count. More...

int	removeReference () const
	Decrement the reference count. More...

bool	isShared () const
	Test for sharing. More...

Private Member Functions
void	computeField (Vector_t R, Vector_t &E, Vector_t &B)

void	operator= (const Multipole &)

Private Attributes
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

Additional Inherited Members
Public Types inherited from ElementBase
enum	ApertureType { RECTANGULAR, ELLIPTICAL, CONIC_RECTANGULAR, CONIC_ELLIPTICAL }

enum	ElementType { ALIGNWRAPPER, BEAMBEAM, BEAMBEAM3D, BEAMLINE, BEAMSTRIPPING, CCOLLIMATOR, CORRECTOR, CORRECTORWRAPPER, CYCLOTRON, CYCLOTRONWRAPPER, CYCLOTRONVALLEY, DEGRADER, DIAGNOSTIC, DRIFT, FLEXIBLECOLLIMATOR, INTEGRATOR, LAMBERTSON, MARKER, MONITOR, MPSPLITINTEGRATOR, MULTIPOLE, MULTIPOLET, MULTIPOLEWRAPPER, OFFSET, PARALLELPLATE, PATCH, PROBE, RBEND, RBEND3D, RBENDWRAPPER, RFCAVITY, RFQUADRUPOLE, RING, SBEND3D, SBEND, SBENDWRAPPER, SEPARATOR, SEPTUM, SOLENOID, SOURCE, STRIPPER, TRAVELINGWAVE, VARIABLERFCAVITY, ANY }

Static Public Member Functions inherited from ElementBase
static std::string	getTypeString (ElementType type)

Protected Member Functions inherited from ElementBase
bool	isInsideTransverse (const Vector_t &r, double f=1) const

Protected Member Functions inherited from RCObject
	RCObject ()
	Default constructor. More...

	RCObject (const RCObject &)
	Copy constructor. More...

virtual	~RCObject ()=0

RCObject &	operator= (const RCObject &right)

Protected Attributes inherited from Component
double	exit_face_slope_m

PartBunchBase< double, 3 > *	RefPartBunch_m

bool	online_m

Protected Attributes inherited from ElementBase
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 inherited from Component
static const std::vector< double >	defaultAperture_m

Detailed Description

Interface for general multipole.

Definition at line 46 of file Multipole.h.

Constructor & Destructor Documentation

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

explicit

Constructor with given name.

Definition at line 60 of file Multipole.cpp.

References isMultipole, and ElementBase::setElType().

Here is the call graph for this function:

Multipole::Multipole ( )

Definition at line 42 of file Multipole.cpp.

Multipole::Multipole ( const Multipole & right )

Definition at line 47 of file Multipole.cpp.

References isMultipole, and ElementBase::setElType().

Here is the call graph for this function:

Multipole::~Multipole ( )

virtual

Definition at line 73 of file Multipole.cpp.

Member Function Documentation

void Multipole::accept ( BeamlineVisitor & visitor ) const

overridevirtual

Apply visitor to Multipole.

Implements ElementBase.

Reimplemented in MultipoleWrapper.

Definition at line 77 of file Multipole.cpp.

References BeamlineVisitor::visitMultipole().

Here is the call graph for this function:

void Multipole::addKR	(	int	i,
		double	t,
		Vector_t &	K
	)

overridevirtual

Reimplemented from Component.

Definition at line 171 of file Multipole.cpp.

References Physics::c, Physics::EMASS, PartBunchBase< T, Dim >::getBeta(), PartBunchBase< T, Dim >::getGamma(), Grad(), NormalComponents, Physics::q_e, and Component::RefPartBunch_m.

Here is the call graph for this function:

void Multipole::addKT	(	int	i,
		double	t,
		Vector_t &	K
	)

overridevirtual

Reimplemented from Component.

Definition at line 195 of file Multipole.cpp.

References Physics::c, Physics::EMASS, PartBunchBase< T, Dim >::getBeta(), PartBunchBase< T, Dim >::getGamma(), PartBunchBase< T, Dim >::getX0(), PartBunchBase< T, Dim >::getY0(), NormalComponents, Physics::q_e, and Component::RefPartBunch_m.

Here is the call graph for this function:

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

overridevirtual

Reimplemented from Component.

Definition at line 344 of file Multipole.cpp.

References computeField(), ElementBase::getElementLength(), ElementBase::isInsideTransverse(), Attrib::Distribution::R, PartBunchBase< T, Dim >::R, and Component::RefPartBunch_m.

Here is the call graph for this function:

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

overridevirtual

Reimplemented from Component.

Definition at line 360 of file Multipole.cpp.

References computeField(), ElementBase::getElementLength(), ElementBase::isInsideTransverse(), and Attrib::Distribution::R.

Here is the call graph for this function:

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

overridevirtual

Reimplemented from Component.

Definition at line 369 of file Multipole.cpp.

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

Here is the call graph for this function:

bool Multipole::bends ( ) const

overridevirtual

Implements Component.

Definition at line 403 of file Multipole.cpp.

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

private

Definition at line 221 of file Multipole.cpp.

References DECAPOLE, DIPOLE, max_NormalComponent_m, max_SkewComponent_m, NormalComponents, OCTUPOLE, QUADRUPOLE, Attrib::Distribution::R, SEXTUPOLE, and SkewComponents.

Referenced by apply(), and applyToReferenceParticle().

void Multipole::finalise ( )

overridevirtual

Implements Component.

Definition at line 399 of file Multipole.cpp.

References Component::online_m.

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

overridevirtual

Implements Component.

Definition at line 408 of file Multipole.cpp.

References ElementBase::getElementLength().

Here is the call graph for this function:

virtual BMultipoleField& Multipole::getField ( )

overridepure virtual

virtual const BMultipoleField& Multipole::getField ( ) const

overridepure virtual

Get multipole field. Version for const object.

Implements Component.

Implemented in MultipoleWrapper, SingleMultipole< order >, and MultipoleRep.

virtual StraightGeometry& Multipole::getGeometry ( )

overridepure virtual

Get geometry.

Implements ElementBase.

Implemented in MultipoleWrapper, SingleMultipole< order >, and MultipoleRep.

Referenced by MultipoleWrapper::getGeometry().

virtual const StraightGeometry& Multipole::getGeometry ( ) const

overridepure virtual

Get geometry.

Implements ElementBase.

Implemented in MultipoleWrapper, SingleMultipole< order >, and MultipoleRep.

size_t Multipole::getMaxNormalComponentIndex ( ) const

inline

Definition at line 160 of file Multipole.h.

References NormalComponents.

size_t Multipole::getMaxSkewComponentIndex ( ) const

inline

Definition at line 165 of file Multipole.h.

References SkewComponents.

double Multipole::getNormalComponent ( int n ) const

Get normal component.

Definition at line 82 of file Multipole.cpp.

References max_NormalComponent_m, Hypervolume::n, and NormalComponents.

Referenced by MultipoleRep::getChannel(), and MultipoleRep::getImage().

std::size_t Multipole::getNSlices ( ) const

Definition at line 165 of file Multipole.cpp.

References nSlices_m.

Referenced by ThickTracker::visitMultipole().

double Multipole::getSkewComponent ( int n ) const

Get skew component.

Definition at line 90 of file Multipole.cpp.

References max_SkewComponent_m, Hypervolume::n, and SkewComponents.

Referenced by MultipoleRep::getChannel(), and MultipoleRep::getImage().

ElementBase::ElementType Multipole::getType ( ) const

overridevirtual

Get element type std::string.

Reimplemented from Component.

Reimplemented in MultipoleWrapper.

Definition at line 414 of file Multipole.cpp.

References ElementBase::MULTIPOLE.

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

overridevirtual

Implements Component.

Definition at line 392 of file Multipole.cpp.

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

Here is the call graph for this function:

bool Multipole::isFocusing ( unsigned int component ) const

Definition at line 427 of file Multipole.cpp.

References PartBunchBase< T, Dim >::getChargePerParticle(), NormalComponents, pow(), and Component::RefPartBunch_m.

Here is the call graph for this function:

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

overridevirtual

Reimplemented from ElementBase.

Definition at line 419 of file Multipole.cpp.

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

Here is the call graph for this function:

void Multipole::operator= ( const Multipole & )

private

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

inline

Set normal component.

Definition at line 150 of file Multipole.h.

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

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

Set normal component.

Definition at line 98 of file Multipole.cpp.

References DECAPOLE, DIPOLE, max_NormalComponent_m, Hypervolume::n, NormalComponentErrors, NormalComponents, OCTUPOLE, PAssert_GE, and SEXTUPOLE.

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

Definition at line 160 of file Multipole.cpp.

References nSlices_m.

Referenced by OpalQuadrupole::update().

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

inline

Set skew component.

Definition at line 155 of file Multipole.h.

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

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

Set skew component.

Definition at line 127 of file Multipole.cpp.

References DECAPOLE, DIPOLE, max_SkewComponent_m, Hypervolume::n, OCTUPOLE, PAssert_GT, SEXTUPOLE, SkewComponentErrors, and SkewComponents.

Member Data Documentation

int Multipole::max_NormalComponent_m

private

Definition at line 145 of file Multipole.h.

Referenced by applyToReferenceParticle(), computeField(), getNormalComponent(), and setNormalComponent().

int Multipole::max_SkewComponent_m

private

Definition at line 144 of file Multipole.h.

Referenced by applyToReferenceParticle(), computeField(), getSkewComponent(), and setSkewComponent().

std::vector<double> Multipole::NormalComponentErrors

private

Definition at line 141 of file Multipole.h.

Referenced by applyToReferenceParticle(), and setNormalComponent().

std::vector<double> Multipole::NormalComponents

private

Definition at line 140 of file Multipole.h.

Referenced by addKR(), addKT(), applyToReferenceParticle(), computeField(), getMaxNormalComponentIndex(), getNormalComponent(), isFocusing(), and setNormalComponent().

std::size_t Multipole::nSlices_m

private

Definition at line 146 of file Multipole.h.

Referenced by getNSlices(), and setNSlices().

std::vector<double> Multipole::SkewComponentErrors

private

Definition at line 143 of file Multipole.h.

Referenced by applyToReferenceParticle(), and setSkewComponent().

std::vector<double> Multipole::SkewComponents

private

Definition at line 142 of file Multipole.h.

Referenced by applyToReferenceParticle(), computeField(), getMaxSkewComponentIndex(), getSkewComponent(), and setSkewComponent().

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

src/Classic/AbsBeamline/Multipole.h
src/Classic/AbsBeamline/Multipole.cpp

Public Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation