OPAL (Object Oriented Parallel Accelerator Library)  2.2.0
OPAL
Public Member Functions | Private Attributes | List of all members
SBend3D Class Reference

#include <SBend3D.h>

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

Public Member Functions

 SBend3D (const std::string &name)
 
 SBend3D (const SBend3D &right)
 
 ~SBend3D ()
 
ElementBaseclone () const override
 
bool apply (const size_t &i, const double &t, Vector_t &E, Vector_t &B) override
 
bool apply (const Vector_t &R, const Vector_t &P, const double &t, Vector_t &E, Vector_t &B) override
 
void initialise (PartBunchBase< double, 3 > *bunch, double &startField, double &endField) override
 
void finalise () override
 
bool bends () const override
 
void getDimensions (double &zBegin, double &zEnd) const override
 
BGeometryBasegetGeometry () override
 
const BGeometryBasegetGeometry () const override
 
EMFieldgetField () override
 
const EMFieldgetField () const override
 
void accept (BeamlineVisitor &visitor) const override
 
void setFieldMapFileName (std::string name)
 
std::string getFieldMapFileName () const
 
double getLengthUnits () const
 
void setLengthUnits (double lengthUnits)
 
double getFieldUnits () const
 
void setFieldUnits (double fieldUnits)
 
int getPolynomialOrder () const
 
void setPolynomialOrder (int polyOrder)
 
int getSmoothingOrder () const
 
void setSmoothingOrder (int polyOrder)
 
SectorMagneticFieldMapgetSectorMagneticFieldMap () const
 
- 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 void addKR (int i, double t, Vector_t &K)
 
virtual void addKT (int i, double t, Vector_t &K)
 
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 &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 ElementBase::ElementType getType () const
 Get element type std::string. More...
 
virtual void setComponentType (std::string)
 
virtual std::string getComponentType () const
 
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...
 
std::string getTypeString () const
 
virtual double getArcLength () const
 Get arc length. More...
 
virtual double getElementLength () const
 Get design length. More...
 
virtual void setElementLength (double length)
 Set design length. More...
 
virtual void getElementDimensions (double &begin, double &end) const
 
virtual double getOrigin () const
 Get origin position. More...
 
virtual double getEntrance () const
 Get entrance position. More...
 
virtual double getExit () const
 Get exit position. More...
 
virtual Euclid3D getTransform (double fromS, double toS) const
 Get transform. More...
 
virtual Euclid3D getTransform (double s) const
 Get transform. More...
 
virtual Euclid3D getTotalTransform () const
 Get transform. More...
 
virtual Euclid3D getEntranceFrame () const
 Get transform. More...
 
virtual Euclid3D getExitFrame () const
 Get transform. More...
 
virtual Euclid3D getEntrancePatch () const
 Get patch. More...
 
virtual Euclid3D getExitPatch () const
 Get patch. More...
 
virtual double getAttribute (const std::string &aKey) const
 Get attribute value. More...
 
virtual bool hasAttribute (const std::string &aKey) const
 Test for existence of an attribute. More...
 
virtual void removeAttribute (const std::string &aKey)
 Remove an existing attribute. More...
 
virtual void setAttribute (const std::string &aKey, double val)
 Set value of an attribute. More...
 
virtual ChannelgetChannel (const std::string &aKey, bool create=false)
 Construct a read/write channel. More...
 
virtual const ConstChannelgetConstChannel (const std::string &aKey) const
 Construct a read-only channel. More...
 
virtual ElementImagegetImage () const
 Construct an image. 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...
 
virtual ElementBasemakeAlignWrapper ()
 Allow misalignment. More...
 
virtual ElementBasemakeFieldWrapper ()
 Allow field errors. More...
 
virtual ElementBasemakeWrappers ()
 Allow errors. More...
 
virtual ElementBaseremoveAlignWrapper ()
 Remove align wrapper. More...
 
virtual const ElementBaseremoveAlignWrapper () const
 Remove align wrapper. More...
 
virtual ElementBaseremoveFieldWrapper ()
 Remove field wrapper. More...
 
virtual const ElementBaseremoveFieldWrapper () const
 Remove field wrapper. More...
 
virtual ElementBaseremoveWrappers ()
 Return the design element. More...
 
virtual const ElementBaseremoveWrappers () const
 Return the design element. 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
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
 
virtual bool isInside (const Vector_t &r) 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 Attributes

SectorMagneticFieldMapmap_m
 
PlanarArcGeometry planarArcGeometry_m
 
double fieldUnits_m
 
double lengthUnits_m
 
int polyOrder_m
 
double smoothOrder_m
 
BMultipoleField dummy
 

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
 
RCObjectoperator= (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

Sector bending magnet from a 3D field map

SBend3D provides interface between Component type and routines for linear interpolation from a 3D field map in a sector geometry.

Parameters
planarArcGeometry_mCell geometry is a PlanarArcGeometry with radius of curvature equal to the radius at the middle of the field map and angle given by the field map opening angle.
map_mthe actual field map class (with associated interpolation and IO routines).
field_ma dummy field - never used, only put in to obey inheritance requirements

Definition at line 50 of file SBend3D.h.

Constructor & Destructor Documentation

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

Construct a new SBend3D

Parameters
nameUser-defined name of the SBend3D

Definition at line 32 of file SBend3D.cpp.

References isDrift, and ElementBase::setElType().

Referenced by clone().

Here is the call graph for this function:

SBend3D::SBend3D ( const SBend3D right)

Copy constructor

Definition at line 39 of file SBend3D.cpp.

References isDrift, map_m, Component::RefPartBunch_m, and ElementBase::setElType().

Here is the call graph for this function:

SBend3D::~SBend3D ( )

Destructor - deletes map

Definition at line 51 of file SBend3D.cpp.

References map_m.

Member Function Documentation

void SBend3D::accept ( BeamlineVisitor visitor) const
overridevirtual

Accept a beamline visitor

Implements ElementBase.

Definition at line 119 of file SBend3D.cpp.

References BeamlineVisitor::visitSBend3D().

Here is the call graph for this function:

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

Calculate the field at the position of the ith particle

Parameters
iindex of the particle event; field is calculated at this position
ttime at which the field is to be calculated
Ecalculated electric field - always 0 (no E-field)
Bcalculated magnetic field
Returns
true if particle is outside the field map

Reimplemented from Component.

Definition at line 68 of file SBend3D.cpp.

References PartBunchBase< T, Dim >::P, PartBunchBase< T, Dim >::R, and Component::RefPartBunch_m.

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

Calculate the field at some arbitrary position

Parameters
Rposition in the local coordinate system of the bend
ttime at which the field is to be calculated
Ecalculated electric field - always 0 (no E-field)
Bcalculated magnetic field
Returns
true if particle is outside the field map, else false

Reimplemented from Component.

Definition at line 73 of file SBend3D.cpp.

References SectorMagneticFieldMap::getFieldstrength(), and map_m.

Here is the call graph for this function:

bool SBend3D::bends ( ) const
inlineoverridevirtual

Return true - SBend3D always bends the reference particle

Implements Component.

Definition at line 87 of file SBend3D.cpp.

ElementBase * SBend3D::clone ( ) const
overridevirtual

Inheritable copy constructor

Implements ElementBase.

Definition at line 55 of file SBend3D.cpp.

References SBend3D().

Here is the call graph for this function:

void SBend3D::finalise ( )
overridevirtual

Finalise the SBend3D - sets bunch to NULL

Implements Component.

Definition at line 83 of file SBend3D.cpp.

References Component::RefPartBunch_m.

void SBend3D::getDimensions ( double &  zBegin,
double &  zEnd 
) const
inlineoverridevirtual

Not implemented

Implements Component.

Definition at line 104 of file SBend3D.h.

EMField & SBend3D::getField ( )
overridevirtual

Return a dummy (0.) field value (what is this for?)

Implements Component.

Definition at line 60 of file SBend3D.cpp.

References dummy.

const EMField & SBend3D::getField ( ) const
overridevirtual

Return a dummy (0.) field value (what is this for?)

Implements Component.

Definition at line 64 of file SBend3D.cpp.

References dummy.

std::string SBend3D::getFieldMapFileName ( ) const
inline

Get the file name of the field map

Definition at line 174 of file SBend3D.h.

References SectorMagneticFieldMap::getFieldMapFileName(), and map_m.

Here is the call graph for this function:

double SBend3D::getFieldUnits ( ) const
inline

Get the scale factor

Definition at line 140 of file SBend3D.h.

References fieldUnits_m.

BGeometryBase & SBend3D::getGeometry ( )
overridevirtual

Return the cell geometry

Implements ElementBase.

Definition at line 91 of file SBend3D.cpp.

References planarArcGeometry_m.

const BGeometryBase & SBend3D::getGeometry ( ) const
overridevirtual

Return the cell geometry

Implements ElementBase.

Definition at line 95 of file SBend3D.cpp.

References planarArcGeometry_m.

double SBend3D::getLengthUnits ( ) const
inline

Get the scale factor

Definition at line 134 of file SBend3D.h.

References lengthUnits_m.

int SBend3D::getPolynomialOrder ( ) const
inline

Get the polynomial order

Definition at line 146 of file SBend3D.h.

References polyOrder_m.

SectorMagneticFieldMap* SBend3D::getSectorMagneticFieldMap ( ) const
inline

Get the sector magnetic field map

Definition at line 158 of file SBend3D.h.

References map_m.

int SBend3D::getSmoothingOrder ( ) const
inline

Get the smoothing factor

Definition at line 152 of file SBend3D.h.

References smoothOrder_m.

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

Initialise the SBend3D

Parameters
bunchthe global bunch object
startFieldnot used
endFieldnot used

Implements Component.

Definition at line 79 of file SBend3D.cpp.

References Component::RefPartBunch_m.

void SBend3D::setFieldMapFileName ( std::string  name)

Set the field map file

Parameters
namethe file name of the field map

This generates a new field map object with the given name. If name == "" then sets the field map to NULL.

Definition at line 99 of file SBend3D.cpp.

References fieldUnits_m, SectorMagneticFieldMap::getDeltaPhi(), SectorField::getPolarBoundingBoxMax(), SectorField::getPolarBoundingBoxMin(), lengthUnits_m, map_m, planarArcGeometry_m, polyOrder_m, PlanarArcGeometry::setCurvature(), PlanarArcGeometry::setElementLength(), and smoothOrder_m.

Referenced by OpalSBend3D::update().

Here is the call graph for this function:

void SBend3D::setFieldUnits ( double  fieldUnits)
inline

Set the scale factor

Definition at line 143 of file SBend3D.h.

References fieldUnits_m.

Referenced by OpalSBend3D::update().

void SBend3D::setLengthUnits ( double  lengthUnits)
inline

Set the scale factor

Definition at line 137 of file SBend3D.h.

References lengthUnits_m.

Referenced by OpalSBend3D::update().

void SBend3D::setPolynomialOrder ( int  polyOrder)
inline

Set the polynomial order

Definition at line 149 of file SBend3D.h.

References polyOrder_m.

void SBend3D::setSmoothingOrder ( int  polyOrder)
inline

Set the smoothing factor

Definition at line 155 of file SBend3D.h.

References smoothOrder_m.

Member Data Documentation

BMultipoleField SBend3D::dummy
private

Definition at line 171 of file SBend3D.h.

Referenced by getField().

double SBend3D::fieldUnits_m
private

Definition at line 165 of file SBend3D.h.

Referenced by getFieldUnits(), setFieldMapFileName(), and setFieldUnits().

double SBend3D::lengthUnits_m
private

Definition at line 166 of file SBend3D.h.

Referenced by getLengthUnits(), setFieldMapFileName(), and setLengthUnits().

SectorMagneticFieldMap* SBend3D::map_m
private
PlanarArcGeometry SBend3D::planarArcGeometry_m
private

Definition at line 163 of file SBend3D.h.

Referenced by getGeometry(), and setFieldMapFileName().

int SBend3D::polyOrder_m
private

Definition at line 168 of file SBend3D.h.

Referenced by getPolynomialOrder(), setFieldMapFileName(), and setPolynomialOrder().

double SBend3D::smoothOrder_m
private

Definition at line 169 of file SBend3D.h.

Referenced by getSmoothingOrder(), setFieldMapFileName(), and setSmoothingOrder().


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