OPAL (Object Oriented Parallel Accelerator Library)  2021.1.99
OPAL
Public Member Functions | Private Member Functions | Private Attributes | List of all members
Solenoid Class Referenceabstract

Interface for solenoids. More...

#include <Solenoid.h>

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

Public Member Functions

 Solenoid (const std::string &name)
 Constructor with given name. More...
 
 Solenoid ()
 
 Solenoid (const Solenoid &)
 
virtual ~Solenoid ()
 
virtual void accept (BeamlineVisitor &) const override
 Apply visitor to Solenoid. More...
 
virtual double getBz () const =0
 Get solenoid field Bz in Teslas. More...
 
void setKS (double ks)
 
void setDKS (double ks)
 
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 void goOnline (const double &kineticEnergy) override
 
virtual void goOffline () override
 
void setFieldMapFN (std::string fn)
 
void setFast (bool fast)
 
bool getFast () const
 
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
 
virtual void getElementDimensions (double &zBegin, double &zEnd) const override
 
virtual CoordinateSystemTrafo getEdgeToBegin () const override
 
virtual CoordinateSystemTrafo getEdgeToEnd () 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 ()
 
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 getPotential (const Vector_t &, const double &, Vector_t &, double &)
 
virtual double getDesignEnergy () const
 
virtual void setDesignEnergy (const double &energy, bool changeable=true)
 
virtual bool Online ()
 
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 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 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 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
 
void setAperture (const ApertureType &type, const std::vector< double > &args)
 
std::pair< ElementBase::ApertureType, std::vector< double > > getAperture () const
 
void setMisalignment (const CoordinateSystemTrafo &cst)
 
void getMisalignment (double &x, double &y, double &s) const
 
CoordinateSystemTrafo getMisalignment () const
 
void setActionRange (const std::queue< std::pair< double, double > > &range)
 
void setCurrentSCoordinate (double s)
 
void setRotationAboutZ (double rotation)
 Set rotation about z axis in bend frame. 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 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 operator= (const Solenoid &)
 

Private Attributes

std::string filename_m
 
FieldmapmyFieldmap_m
 
double scale_m
 
double scaleError_m
 
double startField_m
 
bool fast_m
 

Additional Inherited Members

- Public Types inherited from ElementBase
enum  ApertureType { RECTANGULAR , ELLIPTICAL , CONIC_RECTANGULAR , CONIC_ELLIPTICAL }
 
enum  ElementType {
  BEAMLINE , CCOLLIMATOR , CORRECTOR , CYCLOTRON ,
  DEGRADER , DRIFT , FLEXIBLECOLLIMATOR , MARKER ,
  MONITOR , MPSPLITINTEGRATOR , MULTIPOLE , MULTIPOLET ,
  OFFSET , PROBE , RBEND , RBEND3D ,
  RFCAVITY , RING , SBEND3D , SBEND ,
  SEPTUM , SOLENOID , SOURCE , STRIPPER ,
  TRAVELINGWAVE , UNDULATOR , VACUUM , 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) 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

Interface for solenoids.

Definition at line 36 of file Solenoid.h.

Constructor & Destructor Documentation

◆ Solenoid() [1/3]

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

Constructor with given name.

Definition at line 51 of file Solenoid.cpp.

◆ Solenoid() [2/3]

Solenoid::Solenoid ( )

Definition at line 35 of file Solenoid.cpp.

◆ Solenoid() [3/3]

Solenoid::Solenoid ( const Solenoid right)

Definition at line 40 of file Solenoid.cpp.

◆ ~Solenoid()

Solenoid::~Solenoid ( )
virtual

Definition at line 62 of file Solenoid.cpp.

Member Function Documentation

◆ accept()

void Solenoid::accept ( BeamlineVisitor visitor) const
overridevirtual

Apply visitor to Solenoid.

Implements ElementBase.

Definition at line 67 of file Solenoid.cpp.

References BeamlineVisitor::visitSolenoid().

Here is the call graph for this function:

◆ apply() [1/2]

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

Reimplemented from Component.

Definition at line 84 of file Solenoid.cpp.

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

◆ apply() [2/2]

bool Solenoid::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 88 of file Solenoid.cpp.

References ElementBase::getElementLength(), Fieldmap::getFieldstrength(), myFieldmap_m, Attrib::Distribution::R, scale_m, scaleError_m, and startField_m.

Here is the call graph for this function:

◆ applyToReferenceParticle()

bool Solenoid::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 102 of file Solenoid.cpp.

References ElementBase::getElementLength(), Fieldmap::getFieldstrength(), myFieldmap_m, Attrib::Distribution::R, scale_m, and startField_m.

Here is the call graph for this function:

◆ bends()

bool Solenoid::bends ( ) const
overridevirtual

Implements Component.

Definition at line 142 of file Solenoid.cpp.

◆ finalise()

void Solenoid::finalise ( )
overridevirtual

Implements Component.

Definition at line 139 of file Solenoid.cpp.

◆ getBz()

virtual double Solenoid::getBz ( ) const
pure virtual

Get solenoid field Bz in Teslas.

Implemented in SolenoidRep.

◆ getDimensions()

void Solenoid::getDimensions ( double &  zBegin,
double &  zEnd 
) const
overridevirtual

Implements Component.

Definition at line 165 of file Solenoid.cpp.

References ElementBase::getElementLength(), and startField_m.

Here is the call graph for this function:

◆ getEdgeToBegin()

CoordinateSystemTrafo Solenoid::getEdgeToBegin ( ) const
inlineoverridevirtual

Reimplemented from ElementBase.

Definition at line 108 of file Solenoid.h.

References startField_m.

◆ getEdgeToEnd()

CoordinateSystemTrafo Solenoid::getEdgeToEnd ( ) const
inlineoverridevirtual

Reimplemented from ElementBase.

Definition at line 117 of file Solenoid.h.

References ElementBase::getElementLength(), and startField_m.

Here is the call graph for this function:

◆ getElementDimensions()

void Solenoid::getElementDimensions ( double &  zBegin,
double &  zEnd 
) const
overridevirtual

Reimplemented from ElementBase.

Definition at line 180 of file Solenoid.cpp.

References begin(), end(), ElementBase::getElementLength(), and startField_m.

Here is the call graph for this function:

◆ getFast()

bool Solenoid::getFast ( ) const

Definition at line 80 of file Solenoid.cpp.

References fast_m.

◆ getType()

ElementBase::ElementType Solenoid::getType ( ) const
overridevirtual

Get element type std::string.

Reimplemented from Component.

Definition at line 171 of file Solenoid.cpp.

References ElementBase::SOLENOID.

◆ goOffline()

void Solenoid::goOffline ( )
overridevirtual

Reimplemented from Component.

Definition at line 152 of file Solenoid.cpp.

References filename_m, Fieldmap::freeMap(), and Component::online_m.

Here is the call graph for this function:

◆ goOnline()

void Solenoid::goOnline ( const double &  kineticEnergy)
overridevirtual

Reimplemented from Component.

Definition at line 147 of file Solenoid.cpp.

References filename_m, Component::online_m, and Fieldmap::readMap().

Here is the call graph for this function:

◆ initialise()

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

◆ isInside()

bool Solenoid::isInside ( const Vector_t r) const
overridevirtual

Reimplemented from ElementBase.

Definition at line 175 of file Solenoid.cpp.

References Fieldmap::isInside(), ElementBase::isInsideTransverse(), and myFieldmap_m.

Here is the call graph for this function:

◆ operator=()

void Solenoid::operator= ( const Solenoid )
private

◆ setDKS()

void Solenoid::setDKS ( double  ks)

Definition at line 161 of file Solenoid.cpp.

References scaleError_m.

Referenced by OpalSolenoid::update().

◆ setFast()

void Solenoid::setFast ( bool  fast)

Definition at line 75 of file Solenoid.cpp.

References fast_m.

Referenced by OpalSolenoid::update().

◆ setFieldMapFN()

void Solenoid::setFieldMapFN ( std::string  fn)

Definition at line 71 of file Solenoid.cpp.

References filename_m.

Referenced by OpalSolenoid::update().

◆ setKS()

void Solenoid::setKS ( double  ks)

Definition at line 157 of file Solenoid.cpp.

References scale_m.

Referenced by OpalSolenoid::update().

Member Data Documentation

◆ fast_m

bool Solenoid::fast_m
private

Definition at line 100 of file Solenoid.h.

Referenced by getFast(), initialise(), and setFast().

◆ filename_m

std::string Solenoid::filename_m
private

The name of the inputfile

Definition at line 93 of file Solenoid.h.

Referenced by goOffline(), goOnline(), initialise(), and setFieldMapFN().

◆ myFieldmap_m

Fieldmap* Solenoid::myFieldmap_m
private

Definition at line 94 of file Solenoid.h.

Referenced by apply(), applyToReferenceParticle(), initialise(), and isInside().

◆ scale_m

double Solenoid::scale_m
private

scale multiplier

Definition at line 95 of file Solenoid.h.

Referenced by apply(), applyToReferenceParticle(), and setKS().

◆ scaleError_m

double Solenoid::scaleError_m
private

scale multiplier error

Definition at line 96 of file Solenoid.h.

Referenced by apply(), and setDKS().

◆ startField_m

double Solenoid::startField_m
private

startingpoint of field, m

Definition at line 98 of file Solenoid.h.

Referenced by apply(), applyToReferenceParticle(), getDimensions(), getEdgeToBegin(), getEdgeToEnd(), getElementDimensions(), and initialise().


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