OPAL (Object Oriented Parallel Accelerator Library)  2.2.0
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 void addKR (int i, double t, Vector_t &K) override
 ENVELOPE COMPONENT for radial focussing of the beam Calculates the transverse envelope component for the solenoid element and adds it to the K vector. More...
 
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 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 double getElementLength () const override
 Get design length. More...
 
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 &R, const double &t, Vector_t &A, double &phi)
 
virtual double getDesignEnergy () const
 
virtual void setDesignEnergy (const double &energy, bool changeable)
 
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 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 ElementImagegetImage () const
 Construct an image. 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...
 
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
 
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 operator= (const Solenoid &)
 

Private Attributes

std::string filename_m
 
FieldmapmyFieldmap_m
 
double scale_m
 
double scaleError_m
 
double startField_m
 
double length_m
 
bool fast_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
 
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::Solenoid ( const std::string &  name)
explicit

Constructor with given name.

Definition at line 53 of file Solenoid.cpp.

References isSolenoid, and ElementBase::setElType().

Here is the call graph for this function:

Solenoid::Solenoid ( )

Definition at line 35 of file Solenoid.cpp.

Solenoid::Solenoid ( const Solenoid right)

Definition at line 40 of file Solenoid.cpp.

References isSolenoid, and ElementBase::setElType().

Here is the call graph for this function:

Solenoid::~Solenoid ( )
virtual

Definition at line 66 of file Solenoid.cpp.

Member Function Documentation

void Solenoid::accept ( BeamlineVisitor visitor) const
overridevirtual

Apply visitor to Solenoid.

Implements ElementBase.

Definition at line 71 of file Solenoid.cpp.

References BeamlineVisitor::visitSolenoid().

Here is the call graph for this function:

void Solenoid::addKR ( int  i,
double  t,
Vector_t K 
)
overridevirtual

ENVELOPE COMPONENT for radial focussing of the beam Calculates the transverse envelope component for the solenoid element and adds it to the K vector.

Reimplemented from Component.

Definition at line 93 of file Solenoid.cpp.

References Physics::EMASS, Fieldmap::getFieldstrength(), PartBunchBase< T, Dim >::getGamma(), PartBunchBase< T, Dim >::getX(), PartBunchBase< T, Dim >::getY(), PartBunchBase< T, Dim >::getZ(), length_m, myFieldmap_m, Physics::q_e, Component::RefPartBunch_m, scale_m, and startField_m.

Here is the call graph for this function:

void Solenoid::addKT ( int  i,
double  t,
Vector_t K 
)
overridevirtual

ENVELOPE COMPONENT for transverse kick (only important for x0, y0) Calculates the transverse kick component for the solenoid element and adds it to the K vector, only important for off track tracking. Otherwise KT = 0.

BET: Vector_t temp(emg*(bz*(Cxy*tempBunch->getPy(i) + Sy) + Cxy*dbdz*(y-y0)), -emg*(bz*(Cxy*tempBunch->getPx(i) + Sx) + Cxy*dbdz*(x-x0)), 0.0);

Reimplemented from Component.

Definition at line 115 of file Solenoid.cpp.

References Physics::c, DZ, Physics::EMASS, PartBunchBase< T, Dim >::getBeta(), Fieldmap::getFieldDerivative(), Fieldmap::getFieldstrength(), PartBunchBase< T, Dim >::getGamma(), PartBunchBase< T, Dim >::getPx0(), PartBunchBase< T, Dim >::getPy0(), PartBunchBase< T, Dim >::getX(), PartBunchBase< T, Dim >::getX0(), PartBunchBase< T, Dim >::getY(), PartBunchBase< T, Dim >::getY0(), PartBunchBase< T, Dim >::getZ(), length_m, myFieldmap_m, Physics::q_e, Component::RefPartBunch_m, scale_m, and startField_m.

Here is the call graph for this function:

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

Reimplemented from Component.

Definition at line 161 of file Solenoid.cpp.

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

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 165 of file Solenoid.cpp.

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

Here is the call graph for this function:

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 179 of file Solenoid.cpp.

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

Here is the call graph for this function:

bool Solenoid::bends ( ) const
overridevirtual

Implements Component.

Definition at line 218 of file Solenoid.cpp.

void Solenoid::finalise ( )
overridevirtual

Implements Component.

Definition at line 215 of file Solenoid.cpp.

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

Implements Component.

Definition at line 241 of file Solenoid.cpp.

References length_m, and startField_m.

CoordinateSystemTrafo Solenoid::getEdgeToBegin ( ) const
inlineoverridevirtual

Reimplemented from ElementBase.

Definition at line 115 of file Solenoid.h.

References startField_m.

CoordinateSystemTrafo Solenoid::getEdgeToEnd ( ) const
inlineoverridevirtual

Reimplemented from ElementBase.

Definition at line 124 of file Solenoid.h.

References length_m, and startField_m.

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

Reimplemented from ElementBase.

Definition at line 260 of file Solenoid.cpp.

References length_m, and startField_m.

double Solenoid::getElementLength ( ) const
overridevirtual
bool Solenoid::getFast ( ) const

Definition at line 84 of file Solenoid.cpp.

References fast_m.

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

Get element type std::string.

Reimplemented from Component.

Definition at line 247 of file Solenoid.cpp.

References ElementBase::SOLENOID.

void Solenoid::goOffline ( )
overridevirtual

Reimplemented from Component.

Definition at line 228 of file Solenoid.cpp.

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

Here is the call graph for this function:

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

Reimplemented from Component.

Definition at line 223 of file Solenoid.cpp.

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

Here is the call graph for this function:

void Solenoid::initialise ( PartBunchBase< double, 3 > *  bunch,
double &  startField,
double &  endField 
)
overridevirtual
bool Solenoid::isInside ( const Vector_t r) const
overridevirtual

Reimplemented from ElementBase.

Definition at line 251 of file Solenoid.cpp.

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

Here is the call graph for this function:

void Solenoid::operator= ( const Solenoid )
private
void Solenoid::setDKS ( double  ks)

Definition at line 237 of file Solenoid.cpp.

References scaleError_m.

Referenced by OpalSolenoid::update().

void Solenoid::setFast ( bool  fast)

Definition at line 79 of file Solenoid.cpp.

References fast_m.

Referenced by OpalSolenoid::update().

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

Definition at line 75 of file Solenoid.cpp.

References filename_m.

Referenced by OpalSolenoid::update().

void Solenoid::setKS ( double  ks)

Definition at line 233 of file Solenoid.cpp.

References scale_m.

Referenced by OpalSolenoid::update().

Member Data Documentation

bool Solenoid::fast_m
private

Definition at line 107 of file Solenoid.h.

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

std::string Solenoid::filename_m
private

The name of the inputfile

Definition at line 99 of file Solenoid.h.

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

double Solenoid::length_m
private
Fieldmap* Solenoid::myFieldmap_m
private

Definition at line 100 of file Solenoid.h.

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

double Solenoid::scale_m
private

scale multiplier

Definition at line 101 of file Solenoid.h.

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

double Solenoid::scaleError_m
private

scale multiplier error

Definition at line 102 of file Solenoid.h.

Referenced by apply(), and setDKS().

double Solenoid::startField_m
private

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