OPAL (Object Oriented Parallel Accelerator Library) 2022.1
OPAL
Public Member Functions | Protected Member Functions | Protected Attributes | List of all members
BendBase Class Referenceabstract

#include <BendBase.h>

Inheritance diagram for BendBase:
Inheritance graph
[legend]
Collaboration diagram for BendBase:
Collaboration graph
[legend]

Public Member Functions

 BendBase ()
 
 BendBase (const BendBase &)
 
 BendBase (const std::string &)
 
virtual bool bends () const
 Indicates that element bends the beam. More...
 
double getChordLength () const
 
virtual void setBendAngle (double angle)
 
double getBendAngle () const
 
virtual void setEntranceAngle (double entranceAngle)
 
double getEntranceAngle () const
 
virtual double getExitAngle () const =0
 
void setFullGap (double)
 
double getFullGap () const
 
virtual void setDesignEnergy (const double &energy, bool changeable=true)
 
double getDesignEnergy () const
 
std::vector< Vector_tgetDesignPath () const
 
void setFieldAmplitude (double k0, double k0s)
 
double getFieldAmplitude () const
 
void setFieldMapFN (std::string fileName)
 
std::string getFieldMapFN () const
 
- Public Member Functions inherited from Component
 Component (const std::string &name)
 Constructor with given name. More...
 
 Component ()
 
 Component (const Component &right)
 
virtual ~Component ()
 
virtual EMFieldgetField ()=0
 Return field. More...
 
virtual const EMFieldgetField () const =0
 Return field. More...
 
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 apply (const size_t &i, const double &t, Vector_t &E, Vector_t &B)
 
virtual bool apply (const Vector_t &R, const Vector_t &P, const double &t, Vector_t &E, Vector_t &B)
 
virtual bool applyToReferenceParticle (const Vector_t &R, const Vector_t &P, const double &t, Vector_t &E, Vector_t &B)
 
virtual bool getPotential (const Vector_t &, const double &, Vector_t &, double &)
 
virtual double getDesignEnergy () const
 
virtual void setDesignEnergy (const double &energy, bool changeable=true)
 
virtual void initialise (PartBunchBase< double, 3 > *bunch, double &startField, double &endField)=0
 
virtual void finalise ()=0
 
virtual bool bends () const =0
 
virtual void goOnline (const double &kineticEnergy)
 
virtual void goOffline ()
 
virtual bool Online ()
 
virtual void getDimensions (double &zBegin, double &zEnd) const =0
 
virtual ElementType getType () const
 Get element type std::string. More...
 
virtual const ElementBasegetDesign () const
 Return design element. More...
 
virtual void trackBunch (PartBunchBase< double, 3 > *bunch, const PartData &, bool revBeam, bool revTrack) const
 Track particle bunch. More...
 
virtual void trackMap (FVps< double, 6 > &map, const PartData &, bool revBeam, bool revTrack) const
 Track a map. More...
 
void setExitFaceSlope (const double &)
 
- 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...
 
virtual ElementType getType () const =0
 Get element type std::string. More...
 
std::string getTypeString () const
 
virtual BGeometryBasegetGeometry ()=0
 Get geometry. More...
 
virtual const BGeometryBasegetGeometry () const =0
 Get geometry. More...
 
virtual double getArcLength () const
 Get arc length. More...
 
virtual double getElementLength () const
 Get design length. More...
 
virtual void setElementLength (double length)
 Set design length. More...
 
virtual void getElementDimensions (double &begin, double &end) const
 
virtual double getOrigin () const
 Get origin position. More...
 
virtual double getEntrance () const
 Get entrance position. More...
 
virtual double getExit () const
 Get exit position. More...
 
virtual Euclid3D getTransform (double fromS, double toS) const
 Get transform. More...
 
virtual Euclid3D getTransform (double s) const
 Get transform. More...
 
virtual Euclid3D getTotalTransform () const
 Get transform. More...
 
virtual Euclid3D getEntranceFrame () const
 Get transform. More...
 
virtual Euclid3D getExitFrame () const
 Get transform. More...
 
virtual Euclid3D getEntrancePatch () const
 Get patch. More...
 
virtual Euclid3D getExitPatch () const
 Get patch. More...
 
virtual double getAttribute (const std::string &aKey) const
 Get attribute value. More...
 
virtual bool hasAttribute (const std::string &aKey) const
 Test for existence of an attribute. More...
 
virtual void removeAttribute (const std::string &aKey)
 Remove an existing attribute. More...
 
virtual void setAttribute (const std::string &aKey, double val)
 Set value of an attribute. More...
 
virtual ChannelgetChannel (const std::string &aKey, bool create=false)
 Construct a read/write channel. More...
 
virtual const ConstChannelgetConstChannel (const std::string &aKey) const
 Construct a read-only channel. More...
 
virtual void accept (BeamlineVisitor &visitor) const =0
 Apply visitor. More...
 
virtual ElementBaseclone () const =0
 Return clone. More...
 
virtual ElementBasecopyStructure ()
 Make a structural copy. More...
 
bool isSharable () const
 Test if the element can be shared. More...
 
virtual void makeSharable ()
 Set sharable flag. More...
 
bool update (const AttributeSet &)
 Update element. More...
 
virtual void setBoundaryGeometry (BoundaryGeometry *geo)
 
virtual BoundaryGeometrygetBoundaryGeometry () const
 return the attached boundary geometrt object if there is any More...
 
virtual bool hasBoundaryGeometry () const
 
virtual void setWake (WakeFunction *wf)
 attach a wake field to the element More...
 
virtual WakeFunctiongetWake () const
 return the attached wake object if there is any More...
 
virtual bool hasWake () const
 
virtual void setParticleMatterInteraction (ParticleMatterInteractionHandler *spys)
 
virtual ParticleMatterInteractionHandlergetParticleMatterInteraction () const
 
virtual bool hasParticleMatterInteraction () const
 
void setCSTrafoGlobal2Local (const CoordinateSystemTrafo &ori)
 
CoordinateSystemTrafo getCSTrafoGlobal2Local () const
 
void releasePosition ()
 
void fixPosition ()
 
bool isPositioned () const
 
virtual CoordinateSystemTrafo getEdgeToBegin () const
 
virtual CoordinateSystemTrafo getEdgeToEnd () const
 
void setAperture (const ApertureType &type, const std::vector< double > &args)
 
std::pair< ApertureType, std::vector< double > > getAperture () const
 
virtual bool isInside (const Vector_t &r) const
 
void setMisalignment (const CoordinateSystemTrafo &cst)
 
void getMisalignment (double &x, double &y, double &s) const
 
CoordinateSystemTrafo getMisalignment () const
 
void setActionRange (const std::queue< std::pair< double, double > > &range)
 
void setCurrentSCoordinate (double s)
 
void setRotationAboutZ (double rotation)
 Set rotation about z axis in bend frame. More...
 
double getRotationAboutZ () const
 
virtual BoundingBox getBoundingBoxInLabCoords () const
 
virtual int getRequiredNumberOfTimeSteps () const
 
void setOutputFN (std::string fn)
 Set output filename. More...
 
std::string getOutputFN () const
 Get output filename. More...
 
void setFlagDeleteOnTransverseExit (bool=true)
 
bool getFlagDeleteOnTransverseExit () const
 
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...
 

Protected Member Functions

double calcDesignRadius (double fieldAmplitude) const
 Calculate design radius from design energy and field amplitude. More...
 
double calcFieldAmplitude (double radius) const
 Calculate field amplitude from design energy and radius. More...
 
double calcBendAngle (double chordLength, double radius) const
 Calculate bend angle from chord length and design radius. More...
 
double calcDesignRadius (double chordLength, double angle) const
 Calculate design radius from chord length and bend angle. More...
 
double calcGamma () const
 Calculate gamma from design energy. More...
 
double calcBetaGamma () const
 Calculate beta*gamma from design energy. More...
 
- Protected Member Functions inherited from ElementBase
bool isInsideTransverse (const Vector_t &r) const
 
- Protected Member Functions inherited from RCObject
 RCObject ()
 Default constructor. More...
 
 RCObject (const RCObject &)
 Copy constructor. More...
 
virtual ~RCObject ()=0
 
RCObjectoperator= (const RCObject &right)
 

Protected Attributes

double chordLength_m
 
double angle_m
 Bend angle. More...
 
double entranceAngle_m
 
Fieldmapfieldmap_m
 Magnet field map. More...
 
const bool fast_m = false
 Flag to turn on fast field calculation. More...
 
double gap_m
 Full vertical gap of the magnets. More...
 
double designEnergy_m
 Bend design energy (eV). More...
 
bool designEnergyChangeable_m
 
std::vector< Vector_trefTrajMap_m
 Map of reference particle trajectory. More...
 
double fieldAmplitudeX_m
 
double fieldAmplitudeY_m
 
double fieldAmplitude_m
 Field amplitude. More...
 
std::string fileName_m
 
- 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
 

Additional Inherited Members

- Static Public Member Functions inherited from ElementBase
static std::string getTypeString (ElementType type)
 
- Static Protected Attributes inherited from Component
static const std::vector< double > defaultAperture_m
 

Detailed Description

Definition at line 11 of file BendBase.h.

Constructor & Destructor Documentation

◆ BendBase() [1/3]

BendBase::BendBase ( )

Definition at line 7 of file BendBase.cpp.

◆ BendBase() [2/3]

BendBase::BendBase ( const BendBase right)

Definition at line 11 of file BendBase.cpp.

◆ BendBase() [3/3]

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

Definition at line 27 of file BendBase.cpp.

Member Function Documentation

◆ bends()

bool BendBase::bends ( ) const
inlinevirtual

Indicates that element bends the beam.

Implements Component.

Definition at line 77 of file BendBase.h.

◆ calcBendAngle()

double BendBase::calcBendAngle ( double  chordLength,
double  radius 
) const
protected

Calculate bend angle from chord length and design radius.

Definition at line 79 of file BendBase.cpp.

References asin().

Referenced by Bend2D::findIdealBendParameters().

Here is the call graph for this function:

◆ calcBetaGamma()

double BendBase::calcBetaGamma ( ) const
protected

Calculate beta*gamma from design energy.

Definition at line 95 of file BendBase.cpp.

References calcGamma(), pow(), and sqrt().

Referenced by calcDesignRadius(), calcFieldAmplitude(), Bend2D::calculateBendAngle(), Bend2D::calculateRefTrajectory(), and RBend3D::trackRefParticleThrough().

Here is the call graph for this function:

◆ calcDesignRadius() [1/2]

double BendBase::calcDesignRadius ( double  chordLength,
double  angle 
) const
protected

Calculate design radius from chord length and bend angle.

Definition at line 84 of file BendBase.cpp.

References sin().

Here is the call graph for this function:

◆ calcDesignRadius() [2/2]

double BendBase::calcDesignRadius ( double  fieldAmplitude) const
protected

Calculate design radius from design energy and field amplitude.

Definition at line 61 of file BendBase.cpp.

References abs(), Physics::c, calcBetaGamma(), PartBunchBase< T, Dim >::getM(), PartBunchBase< T, Dim >::getQ(), and Component::RefPartBunch_m.

Referenced by RBend::findChordLength(), Bend2D::findIdealBendParameters(), and Bend2D::isFieldZero().

Here is the call graph for this function:

◆ calcFieldAmplitude()

double BendBase::calcFieldAmplitude ( double  radius) const
protected

Calculate field amplitude from design energy and radius.

Definition at line 70 of file BendBase.cpp.

References Physics::c, calcBetaGamma(), PartBunchBase< T, Dim >::getM(), PartBunchBase< T, Dim >::getQ(), and Component::RefPartBunch_m.

Referenced by Bend2D::estimateFieldAdjustmentStep(), Bend2D::findIdealBendParameters(), RBend3D::initialise(), and Bend2D::setBendStrength().

Here is the call graph for this function:

◆ calcGamma()

double BendBase::calcGamma ( ) const
protected

Calculate gamma from design energy.

Definition at line 89 of file BendBase.cpp.

References designEnergy_m, PartBunchBase< T, Dim >::getM(), and Component::RefPartBunch_m.

Referenced by calcBetaGamma(), Bend2D::calculateRefTrajectory(), and RBend3D::trackRefParticleThrough().

Here is the call graph for this function:

◆ getBendAngle()

double BendBase::getBendAngle ( ) const
inline

◆ getChordLength()

double BendBase::getChordLength ( ) const
inline

Definition at line 82 of file BendBase.h.

References chordLength_m.

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

◆ getDesignEnergy()

double BendBase::getDesignEnergy ( ) const
inlinevirtual

Reimplemented from Component.

Definition at line 126 of file BendBase.h.

References designEnergy_m.

Referenced by OpalBeamline::activateElements(), and ThickTracker::visitSBend().

◆ getDesignPath()

std::vector< Vector_t > BendBase::getDesignPath ( ) const

Definition at line 43 of file BendBase.cpp.

References refTrajMap_m.

Referenced by OpalBeamline::compute3DLattice(), and OpalBeamline::save3DLattice().

◆ getEntranceAngle()

double BendBase::getEntranceAngle ( ) const
inline

◆ getExitAngle()

virtual double BendBase::getExitAngle ( ) const
pure virtual

Implemented in Bend2D, and RBend3D.

◆ getFieldAmplitude()

double BendBase::getFieldAmplitude ( ) const
inline

Definition at line 131 of file BendBase.h.

References fieldAmplitude_m.

◆ getFieldMapFN()

std::string BendBase::getFieldMapFN ( ) const
inline

Definition at line 142 of file BendBase.h.

References fileName_m.

◆ getFullGap()

double BendBase::getFullGap ( ) const
inline

Definition at line 113 of file BendBase.h.

References gap_m.

Referenced by Bend2D::getBoundingBoxInLabCoords(), and Bend2D::getSurfaceMesh().

◆ setBendAngle()

void BendBase::setBendAngle ( double  angle)
inlinevirtual

Reimplemented in RBend.

Definition at line 87 of file BendBase.h.

References angle_m.

Referenced by RBend::setBendAngle(), OpalRBend3D::update(), and OpalSBend::update().

◆ setDesignEnergy()

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

Reimplemented from Component.

Definition at line 118 of file BendBase.h.

References abs(), designEnergy_m, and designEnergyChangeable_m.

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

Here is the call graph for this function:

◆ setEntranceAngle()

void BendBase::setEntranceAngle ( double  entranceAngle)
inlinevirtual

Reimplemented in Bend2D, and RBend.

Definition at line 97 of file BendBase.h.

References entranceAngle_m.

Referenced by Bend2D::setEntranceAngle(), and OpalRBend3D::update().

◆ setFieldAmplitude()

void BendBase::setFieldAmplitude ( double  k0,
double  k0s 
)

Definition at line 56 of file BendBase.cpp.

References fieldAmplitudeX_m, and fieldAmplitudeY_m.

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

◆ setFieldMapFN()

void BendBase::setFieldMapFN ( std::string  fileName)
inline

Definition at line 137 of file BendBase.h.

References fileName_m.

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

◆ setFullGap()

void BendBase::setFullGap ( double  gap)
inline

Definition at line 108 of file BendBase.h.

References abs(), and gap_m.

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

Here is the call graph for this function:

Member Data Documentation

◆ angle_m

double BendBase::angle_m
protected

◆ chordLength_m

double BendBase::chordLength_m
protected

◆ designEnergy_m

double BendBase::designEnergy_m
protected

Bend design energy (eV).

Definition at line 61 of file BendBase.h.

Referenced by calcGamma(), getDesignEnergy(), Bend2D::isFieldZero(), Bend2D::print(), and setDesignEnergy().

◆ designEnergyChangeable_m

bool BendBase::designEnergyChangeable_m
protected

Definition at line 62 of file BendBase.h.

Referenced by setDesignEnergy().

◆ entranceAngle_m

double BendBase::entranceAngle_m
protected

◆ fast_m

const bool BendBase::fast_m = false
protected

Flag to turn on fast field calculation.

Definition at line 57 of file BendBase.h.

Referenced by RBend3D::initialise(), and Bend2D::initializeFieldMap().

◆ fieldAmplitude_m

double BendBase::fieldAmplitude_m
protected

◆ fieldAmplitudeX_m

double BendBase::fieldAmplitudeX_m
protected

Field amplitude in x direction. Value not updated if user defines strength with angle

Definition at line 66 of file BendBase.h.

Referenced by RBend::findChordLength(), Bend2D::findIdealBendParameters(), RBend3D::initialise(), Bend2D::isFieldZero(), and setFieldAmplitude().

◆ fieldAmplitudeY_m

double BendBase::fieldAmplitudeY_m
protected

Field amplitude in y direction. Value not updated if user defines strength with angle

Definition at line 68 of file BendBase.h.

Referenced by RBend::findChordLength(), Bend2D::findIdealBendParameters(), RBend3D::initialise(), Bend2D::isFieldZero(), and setFieldAmplitude().

◆ fieldmap_m

Fieldmap* BendBase::fieldmap_m
protected

◆ fileName_m

std::string BendBase::fileName_m
protected

◆ gap_m

double BendBase::gap_m
protected

◆ refTrajMap_m

std::vector<Vector_t> BendBase::refTrajMap_m
protected

Map of reference particle trajectory.

Definition at line 64 of file BendBase.h.

Referenced by Bend2D::calculateRefTrajectory(), and getDesignPath().


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