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

#include <TravelingWave.h>

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

Public Member Functions

 TravelingWave (const std::string &name)
 Constructor with given name. More...
 
 TravelingWave ()
 
 TravelingWave (const TravelingWave &)
 
virtual ~TravelingWave ()
 
virtual void accept (BeamlineVisitor &) const override
 Apply visitor to TravelingWave. More...
 
virtual double getAmplitude () const override=0
 Get RF amplitude. More...
 
virtual double getFrequency () const override=0
 Get RF frequency. More...
 
virtual double getPhase () const override=0
 Get RF phase. More...
 
virtual void setPhasem (double phase) override
 
void setNumCells (int NumCells)
 
void setMode (double mode)
 
virtual double getAutoPhaseEstimate (const double &E0, const double &t0, const double &q, const double &m) 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
 
virtual 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 &begin, double &end) const override
 
virtual CoordinateSystemTrafo getEdgeToBegin () const override
 
virtual CoordinateSystemTrafo getEdgeToEnd () const override
 
- Public Member Functions inherited from RFCavity
 RFCavity (const std::string &name)
 Constructor with given name. More...
 
 RFCavity ()
 
 RFCavity (const RFCavity &)
 
virtual ~RFCavity ()
 
void setFrequency (double freq)
 
void dropFieldmaps ()
 
virtual void setFieldMapFN (const std::string &fmapfn)
 Set the name of the field map. More...
 
virtual std::string getFieldMapFN () const
 
virtual void setAmplitudem (double vPeak)
 
virtual double getAmplitudem () const
 
virtual void setAmplitudeError (double vPeakError)
 
virtual double getAmplitudeError () const
 
virtual void setFrequencym (double freq)
 
virtual double getFrequencym () const
 
virtual double getPhasem () const
 
double getPhasem (double t) const
 
virtual void setPhaseError (double phaseError)
 
virtual double getPhaseError () const
 
void setCavityType (const std::string &type)
 
CavityType getCavityType () const
 
std::string getCavityTypeString () const
 
virtual void setFast (bool fast)
 
virtual bool getFast () const
 
virtual void setAutophaseVeto (bool veto=true)
 
virtual bool getAutophaseVeto () const
 
virtual double getAutoPhaseEstimateFallback (double E0, double t0, double q, double m)
 
virtual std::pair< double, double > trackOnAxisParticle (const double &p0, const double &t0, const double &dt, const double &q, const double &mass, std::ofstream *out=nullptr)
 
virtual void initialise (PartBunchBase< double, 3 > *bunch, std::shared_ptr< AbstractTimeDependence > freq_atd, std::shared_ptr< AbstractTimeDependence > ampl_atd, std::shared_ptr< AbstractTimeDependence > phase_atd)
 
virtual void setDesignEnergy (const double &ekin, bool changeable=true) override
 
virtual double getDesignEnergy () const override
 
void setRmin (double rmin)
 
virtual double getRmin () const
 
void setRmax (double rmax)
 
virtual double getRmax () const
 
void setAzimuth (double angle)
 
virtual double getAzimuth () const
 
void setPerpenDistance (double pdis)
 
virtual double getPerpenDistance () const
 
void setGapWidth (double gapwidth)
 
virtual double getGapWidth () const
 
void setPhi0 (double phi0)
 
virtual double getPhi0 () const
 
virtual double getCosAzimuth () const
 
virtual double getSinAzimuth () const
 
virtual double getCycFrequency () const
 
void getMomentaKick (const double normalRadius, double momentum[], const double t, const double dtCorrt, const int PID, const double restMass, const int chargenumber)
 used in OPAL-cycl More...
 
double spline (double z, double *za)
 
void setAmplitudeModel (std::shared_ptr< AbstractTimeDependence > time_dep)
 
void setAmplitudeModelName (std::string name)
 
std::string getAmplitudeModelName ()
 
void setPhaseModel (std::shared_ptr< AbstractTimeDependence > time_dep)
 
void setPhaseModelName (std::string name)
 
std::string getPhaseModelName ()
 
void setFrequencyModel (std::shared_ptr< AbstractTimeDependence > time_dep)
 
void setFrequencyModelName (std::string name)
 
std::string getFrequencyModelName ()
 
virtual double getElementLength () const override
 Get design length. More...
 
- 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 bool Online ()
 
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 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
ParticleMatterInteractionHandler
getParticleMatterInteraction () 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< 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 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...
 

Private Member Functions

double getdE (const int &i, const int &I, const std::vector< double > &t, const double &phi, const std::vector< std::pair< double, double > > &F) const
 
double getdT (const int &i, const int &I, const std::vector< double > &E, const std::vector< std::pair< double, double > > &F, const double mass) const
 
double getdA (const int &i, const int &I, const std::vector< double > &t, const double &phi, const std::vector< std::pair< double, double > > &F) const
 
double getdB (const int &i, const int &I, const std::vector< double > &t, const double &phi, const std::vector< std::pair< double, double > > &F) const
 
void operator= (const TravelingWave &)
 

Private Attributes

double scaleCore_m
 
double scaleCoreError_m
 
double phaseCore1_m
 
double phaseCore2_m
 
double phaseExit_m
 
double startCoreField_m
 
double startExitField_m
 
double mappedStartExitField_m
 
double periodLength_m
 
int numCells_m
 
double cellLength_m
 
double mode_m
 

Additional Inherited Members

- 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 RFCavity
std::shared_ptr
< AbstractTimeDependence
phaseTD_m
 
std::string phaseName_m
 
std::shared_ptr
< AbstractTimeDependence
amplitudeTD_m
 
std::string amplitudeName_m
 
std::shared_ptr
< AbstractTimeDependence
frequencyTD_m
 
std::string frequencyName_m
 
std::string filename_m
 
double scale_m
 
double scaleError_m
 
double phase_m
 
double phaseError_m
 
double frequency_m
 
bool fast_m
 
bool autophaseVeto_m
 
double designEnergy_m
 
Fieldmap fieldmap_m
 
double startField_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
 
- Static Protected Attributes inherited from Component
static const std::vector< double > defaultAperture_m
 

Detailed Description

Definition at line 27 of file TravelingWave.h.

Constructor & Destructor Documentation

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

Constructor with given name.

Definition at line 55 of file TravelingWave.cpp.

TravelingWave::TravelingWave ( )

Definition at line 33 of file TravelingWave.cpp.

TravelingWave::TravelingWave ( const TravelingWave right)

Definition at line 38 of file TravelingWave.cpp.

TravelingWave::~TravelingWave ( )
virtual

Definition at line 72 of file TravelingWave.cpp.

Member Function Documentation

void TravelingWave::accept ( BeamlineVisitor visitor) const
overridevirtual

Apply visitor to TravelingWave.

Reimplemented from RFCavity.

Definition at line 76 of file TravelingWave.cpp.

References BeamlineVisitor::visitTravelingWave().

Here is the call graph for this function:

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

Reimplemented from RFCavity.

Definition at line 80 of file TravelingWave.cpp.

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

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

Reimplemented from RFCavity.

Definition at line 235 of file TravelingWave.cpp.

void TravelingWave::finalise ( )
overridevirtual

Reimplemented from RFCavity.

Definition at line 232 of file TravelingWave.cpp.

virtual double TravelingWave::getAmplitude ( ) const
overridepure virtual

Get RF amplitude.

Implements RFCavity.

Implemented in TravelingWaveRep.

double TravelingWave::getAutoPhaseEstimate ( const double &  E0,
const double &  t0,
const double &  q,
const double &  m 
)
overridevirtual
double TravelingWave::getdA ( const int &  i,
const int &  I,
const std::vector< double > &  t,
const double &  phi,
const std::vector< std::pair< double, double > > &  F 
) const
inlineprivate

Definition at line 168 of file TravelingWave.h.

References cos(), RFCavity::frequency_m, and sin().

Referenced by getAutoPhaseEstimate().

Here is the call graph for this function:

double TravelingWave::getdB ( const int &  i,
const int &  I,
const std::vector< double > &  t,
const double &  phi,
const std::vector< std::pair< double, double > > &  F 
) const
inlineprivate

Definition at line 179 of file TravelingWave.h.

References cos(), RFCavity::frequency_m, and sin().

Referenced by getAutoPhaseEstimate().

Here is the call graph for this function:

double TravelingWave::getdE ( const int &  i,
const int &  I,
const std::vector< double > &  t,
const double &  phi,
const std::vector< std::pair< double, double > > &  F 
) const
inlineprivate

Definition at line 130 of file TravelingWave.h.

References cos(), RFCavity::frequency_m, and sin().

Referenced by getAutoPhaseEstimate().

Here is the call graph for this function:

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

Reimplemented from RFCavity.

Definition at line 248 of file TravelingWave.cpp.

References RFCavity::getElementLength(), and periodLength_m.

Here is the call graph for this function:

double TravelingWave::getdT ( const int &  i,
const int &  I,
const std::vector< double > &  E,
const std::vector< std::pair< double, double > > &  F,
const double  mass 
) const
inlineprivate

Definition at line 140 of file TravelingWave.h.

References Physics::c, and sqrt().

Referenced by getAutoPhaseEstimate().

Here is the call graph for this function:

CoordinateSystemTrafo TravelingWave::getEdgeToBegin ( ) const
inlineoverridevirtual

Reimplemented from RFCavity.

Definition at line 209 of file TravelingWave.h.

References periodLength_m.

CoordinateSystemTrafo TravelingWave::getEdgeToEnd ( ) const
inlineoverridevirtual

Reimplemented from RFCavity.

Definition at line 216 of file TravelingWave.h.

References RFCavity::getElementLength(), and periodLength_m.

Here is the call graph for this function:

void TravelingWave::getElementDimensions ( double &  begin,
double &  end 
) const
overridevirtual

Reimplemented from RFCavity.

Definition at line 254 of file TravelingWave.cpp.

References RFCavity::getElementLength(), and periodLength_m.

Here is the call graph for this function:

virtual double TravelingWave::getFrequency ( ) const
overridepure virtual

Get RF frequency.

Implements RFCavity.

Implemented in TravelingWaveRep.

virtual double TravelingWave::getPhase ( ) const
overridepure virtual

Get RF phase.

Implements RFCavity.

Implemented in TravelingWaveRep.

ElementType TravelingWave::getType ( ) const
overridevirtual

Get element type std::string.

Reimplemented from RFCavity.

Definition at line 259 of file TravelingWave.cpp.

References TRAVELINGWAVE.

void TravelingWave::goOffline ( )
overridevirtual

Reimplemented from RFCavity.

Definition at line 244 of file TravelingWave.cpp.

References RFCavity::filename_m, and _Fieldmap::freeMap().

Here is the call graph for this function:

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

Reimplemented from RFCavity.

Definition at line 239 of file TravelingWave.cpp.

References RFCavity::filename_m, Component::online_m, and _Fieldmap::readMap().

Here is the call graph for this function:

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

Reimplemented from RFCavity.

Definition at line 400 of file TravelingWave.cpp.

References ElementBase::isInsideTransverse(), periodLength_m, and startExitField_m.

Here is the call graph for this function:

void TravelingWave::operator= ( const TravelingWave )
private
void TravelingWave::setMode ( double  mode)
inline

Definition at line 204 of file TravelingWave.h.

References mode, and mode_m.

Referenced by OpalTravelingWave::update().

void TravelingWave::setNumCells ( int  NumCells)
inline

Definition at line 199 of file TravelingWave.h.

References numCells_m.

Referenced by OpalTravelingWave::update().

void TravelingWave::setPhasem ( double  phase)
inlineoverridevirtual

Reimplemented from RFCavity.

Definition at line 191 of file TravelingWave.h.

References floor(), mode_m, numCells_m, RFCavity::phase_m, phaseCore1_m, phaseCore2_m, phaseExit_m, Physics::pi, and Physics::two_pi.

Referenced by OpalTravelingWave::update().

Here is the call graph for this function:

Member Data Documentation

double TravelingWave::cellLength_m
private

Definition at line 100 of file TravelingWave.h.

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

double TravelingWave::mappedStartExitField_m
private

Definition at line 96 of file TravelingWave.h.

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

double TravelingWave::mode_m
private

Definition at line 101 of file TravelingWave.h.

Referenced by getAutoPhaseEstimate(), initialise(), setMode(), and setPhasem().

int TravelingWave::numCells_m
private

Definition at line 99 of file TravelingWave.h.

Referenced by getAutoPhaseEstimate(), initialise(), setNumCells(), and setPhasem().

double TravelingWave::periodLength_m
private
double TravelingWave::phaseCore1_m
private
double TravelingWave::phaseCore2_m
private
double TravelingWave::phaseExit_m
private
double TravelingWave::scaleCore_m
private

Definition at line 87 of file TravelingWave.h.

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

double TravelingWave::scaleCoreError_m
private

Definition at line 88 of file TravelingWave.h.

Referenced by apply(), and initialise().

double TravelingWave::startCoreField_m
private

starting point of field(m)

Definition at line 94 of file TravelingWave.h.

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

double TravelingWave::startExitField_m
private

Definition at line 95 of file TravelingWave.h.

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


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