OPALX (Object Oriented Parallel Accelerator Library for Exascal) master (dc2a29eed580)
OPALX
Loading...
Searching...
No Matches
MonitorRep Class Reference

#include <MonitorRep.h>

Inheritance diagram for MonitorRep:
Inheritance graph
Collaboration diagram for MonitorRep:
Collaboration graph

Public Types

enum  Plane { OFF , X , Y , XY }
 Plane selection. More...
 

Public Member Functions

 MonitorRep (const std::string &name)
 Constructor with given name.
 
 MonitorRep ()
 
 MonitorRep (const MonitorRep &)
 
virtual ~MonitorRep ()
 
virtual ElementBaseclone () const
 Return clone.
 
virtual ChannelgetChannel (const std::string &aKey, bool=false)
 Construct a read/write channel.
 
virtual NullFieldgetField ()
 Get field.
 
virtual const NullFieldgetField () const
 Get field.
 
virtual StraightGeometrygetGeometry ()
 Get geometry.
 
virtual const StraightGeometrygetGeometry () const
 Get geometry.
 
virtual Plane getPlane () const
 Get planes.
 
virtual void setActive (bool=true)
 Set active flag.
 
void accept (BeamlineVisitor &) const override
 Apply visitor to Monitor.
 
virtual bool apply (const std::shared_ptr< ParticleContainer_t > &pc) override
 Apply to all particles. Kernel launch moved inside the function.
 
virtual bool apply (const size_t &i, const double &t, Vector_t< double, 3 > &E, Vector_t< double, 3 > &B) override
 Apply to particle i.
 
virtual bool apply (const Vector_t< double, 3 > &R, const Vector_t< double, 3 > &P, const double &t, Vector_t< double, 3 > &E, Vector_t< double, 3 > &B) override
 Apply to particle with position R and momentum P.
 
virtual bool applyToReferenceParticle (const Vector_t< double, 3 > &R, const Vector_t< double, 3 > &P, const double &t, Vector_t< double, 3 > &E, Vector_t< double, 3 > &B) override
 Apply to reference particle with position R and momemtum P.
 
virtual void initialise (PartBunch_t *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
 
virtual void getFieldExtend (double &zBegin, double &zEnd) const override
 Return the field-support extent of the component.
 
void setCollectionType (CollectionType type)
 
virtual int getRequiredNumberOfTimeSteps () const override
 
virtual bool isInside (const Vector_t< double, 3 > &r) const override
 
EVector Efield (const Point3D &P) const
 Return the field in a point.
 
EVector Efield (const Point3D &P, double t) const
 Return the field in a point.
 
BVector Bfield (const Point3D &P) const
 Return the field in a point.
 
BVector Bfield (const Point3D &P, double t) const
 Return the field in a point.
 
EBVectors EBfield (const Point3D &P) const
 Return the field in a point.
 
EBVectors EBfield (const Point3D &P, double t) const
 Return the field in a point.
 
virtual bool getPotential (const Vector_t< double, 3 > &, const double &, Vector_t< double, 3 > &, double &)
 Calculate the four-potential at some position relative to the component.
 
virtual double getDesignEnergy () const
 
virtual void setDesignEnergy (const double &energy, bool changeable=true)
 
virtual bool Online ()
 
virtual const ElementBasegetDesign () const
 Return design element.
 
virtual void trackBunch (PartBunch_t &bunch, const PartData &, bool revBeam, bool revTrack) const
 Track a borrowed particle bunch through a non-standard component.
 
virtual void trackMap (FVps< double, 6 > &map, const PartData &, bool revBeam, bool revTrack) const
 Track a map.
 
void setExitFaceSlope (const double &)
 
virtual const std::string & getName () const
 Get element name.
 
virtual void setName (const std::string &name)
 Set element name.
 
std::string getTypeString () const
 
virtual double getArcLength () const
 Get arc length.
 
virtual double getElementLength () const
 Get design length.
 
virtual void setElementLength (double length)
 Set design length.
 
virtual void getElementDimensions (double &begin, double &end) const
 Return the nominal body extent of the element.
 
virtual double getOrigin () const
 Get origin position.
 
virtual double getEntrance () const
 Get entrance position.
 
virtual double getExit () const
 Get exit position.
 
virtual Euclid3D getTransform (double fromS, double toS) const
 Get transform.
 
virtual Euclid3D getTransform (double s) const
 Get transform.
 
virtual Euclid3D getTotalTransform () const
 Get transform.
 
virtual Euclid3D getEntranceFrame () const
 Get transform.
 
virtual Euclid3D getExitFrame () const
 Get transform.
 
virtual Euclid3D getEntrancePatch () const
 Get patch.
 
virtual Euclid3D getExitPatch () const
 Get patch.
 
virtual double getAttribute (const std::string &aKey) const
 Get attribute value.
 
virtual bool hasAttribute (const std::string &aKey) const
 Test for existence of an attribute.
 
virtual void removeAttribute (const std::string &aKey)
 Remove an existing attribute.
 
virtual void setAttribute (const std::string &aKey, double val)
 Set value of an attribute.
 
virtual const ConstChannelgetConstChannel (const std::string &aKey) const
 Construct a read-only channel.
 
virtual ElementBasecopyStructure ()
 Make a structural copy.
 
bool isSharable () const
 Test if the element can be shared.
 
virtual void makeSharable ()
 Set sharable flag.
 
bool update (const AttributeSet &)
 Update element.
 
virtual void setBoundaryGeometry (BoundaryGeometry *geo)
 
virtual BoundaryGeometrygetBoundaryGeometry () const
 return the attached boundary geometrt object if there is any
 
virtual bool hasBoundaryGeometry () const
 
virtual void setWake (WakeFunction *wf)
 attach a wake field to the element
 
virtual WakeFunction * getWake () const
 return the attached wake object if there is any
 
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
 
virtual CoordinateSystemTrafo getEdgeToBegin () const
 
virtual CoordinateSystemTrafo getEdgeToEnd () const
 
virtual Port getEntryPort () const
 Return the entrance port of the canonical local chart.
 
virtual Port getBodyPort () const
 Return the body port of the canonical local chart.
 
virtual Port getExitPort () const
 Return the exit port of the canonical local chart.
 
PlacementPose getPlacementPose () const
 Return the nominal rigid placement transform of the element.
 
void setPlacementPose (const PlacementPose &pose)
 Set the nominal rigid placement transform of the element.
 
Misalignment getPlacementMisalignment () const
 Return the local nominal-to-actual correction stored for the element.
 
ElementGeometry getPlacementGeometry () const
 Return the bridge geometry ports assembled from legacy edge state.
 
SupportPlacement getPlacementSupport () const
 Return the support-frame bridge object. The default is the body frame.
 
PlacedElement getPlacedElement () const
 Return a placed-element view assembled from the current bridge objects.
 
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.
 
double getRotationAboutZ () const
 
virtual BoundingBox getBoundingBoxInLabCoords () const
 
void setOutputFN (std::string fn)
 Set output filename.
 
std::string getOutputFN () const
 Get output filename.
 
void setFlagDeleteOnTransverseExit (bool=true)
 
bool getFlagDeleteOnTransverseExit () const
 
void setElementPosition (double elemedge)
 Access to ELEMEDGE attribute.
 
double getElementPosition () const
 
bool isElementPositionSet () const
 

Static Public Member Functions

static void writeStatistics ()
 
static std::string getTypeString (ElementType type)
 

Protected Member Functions

bool isInsideTransverse (const Vector_t< double, 3 > &r) const
 

Protected Attributes

NullField field
 The zero magnetic field.
 
StraightGeometry geometry
 The monitor geometry.
 
bool active
 The active/inactive flag.
 
double exit_face_slope_m
 
PartBunch_tRefPartBunch_m
 
bool online_m
 
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

static const std::vector< double > defaultAperture_m = std::vector<double>({1e6, 1e6, 1.0})
 

Private Member Functions

void operator= (const MonitorRep &)
 
void driftToCorrectPositionAndSave (const Vector_t< double, 3 > &R, const Vector_t< double, 3 > &P)
 

Private Attributes

std::string filename_m
 
Plane plane_m
 
CollectionType type_m
 
unsigned int numPassages_m
 
std::unique_ptr< LossDataSinklossDs_m
 
std::string elementID
 
AttributeSet userAttribs
 
WakeFunction * wake_m
 
BoundaryGeometrybgeometry_m
 
ParticleMatterInteractionHandler * parmatint_m
 
bool positionIsFixed
 
std::queue< std::pair< double, double > > actionRange_m
 
std::string outputfn_m
 
bool deleteOnTransverseExit_m = true
 
double elementPosition_m
 ELEMEDGE attribute.
 
bool elemedgeSet_m
 

Static Private Attributes

static std::map< double, SetStatisticsstatFileEntries_sm
 
static const double halfLength_s = 0.005
 
static const std::map< ElementType, std::string > elementTypeToString_s
 

Detailed Description

Definition at line 26 of file MonitorRep.h.

Member Enumeration Documentation

◆ Plane

enum Monitor::Plane
inherited

Plane selection.

Enumerator
OFF 

Monitor is off (inactive).

Monitor acts on x-plane.

Monitor acts on y-plane.

XY 

Monitor acts on both planes.

Definition at line 36 of file Monitor.h.

Constructor & Destructor Documentation

◆ MonitorRep() [1/3]

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

Constructor with given name.

Definition at line 38 of file MonitorRep.cpp.

◆ MonitorRep() [2/3]

MonitorRep::MonitorRep ( )

Definition at line 33 of file MonitorRep.cpp.

Referenced by clone().

◆ MonitorRep() [3/3]

MonitorRep::MonitorRep ( const MonitorRep right)

Definition at line 35 of file MonitorRep.cpp.

◆ ~MonitorRep()

MonitorRep::~MonitorRep ( )
virtual

Definition at line 41 of file MonitorRep.cpp.

Member Function Documentation

◆ accept()

void Monitor::accept ( BeamlineVisitor visitor) const
overridevirtualinherited

Apply visitor to Monitor.

Implements ElementBase.

Definition at line 56 of file Monitor.cpp.

References BeamlineVisitor::visitMonitor().

Here is the call graph for this function:

◆ apply() [1/3]

bool Monitor::apply ( const size_t &  i,
const double &  t,
Vector_t< double, 3 > &  E,
Vector_t< double, 3 > &  B 
)
overridevirtualinherited

Apply to particle i.

Parameters
iParticle index
tTime
EElectric Field
BMagnetic Field
Returns
true if particle is out-of-bounds (lost), false otherwise

Reimplemented from Component.

Definition at line 129 of file Monitor.cpp.

References ParticleContainer< T, Dim >::Attributes, Physics::c, Util::getBeta(), Monitor::lossDs_m, Component::online_m, PartBunch< T, Dim >::R(), Component::RefPartBunch_m, SPATIAL, and Monitor::type_m.

Here is the call graph for this function:

◆ apply() [2/3]

bool Monitor::apply ( const std::shared_ptr< ParticleContainer_t > &  pc)
overridevirtualinherited

Apply to all particles. Kernel launch moved inside the function.

Apply functions apply the components electromagnetic field to the particles. They are called inside ParalleTracker::computeExternalFields()

Returns
true if particle is out-of-bounds (lost), false otherwise
true if particle is out-of-bounds (lost), false otherwise

Reimplemented from Component.

Definition at line 58 of file Monitor.cpp.

References ParticleContainer< T, Dim >::Attributes, Physics::c, Util::getBeta(), PartBunch< T, Dim >::getdT(), PartBunch< T, Dim >::getGlobalTrackStep(), PartBunch< T, Dim >::getT(), Monitor::lossDs_m, Component::online_m, Component::RefPartBunch_m, SPATIAL, and Monitor::type_m.

Referenced by TEST_F(), and TEST_F().

Here is the call graph for this function:

◆ apply() [3/3]

bool Monitor::apply ( const Vector_t< double, 3 > &  R,
const Vector_t< double, 3 > &  P,
const double &  t,
Vector_t< double, 3 > &  E,
Vector_t< double, 3 > &  B 
)
overridevirtualinherited

Apply to particle with position R and momentum P.

Parameters
RPosition
PMomentum
tTime
EElectric Field
BMagnetic Field
Returns
true if particle is out-of-bounds (lost), false otherwise

Reimplemented from Component.

Definition at line 179 of file Monitor.cpp.

◆ applyToReferenceParticle()

bool Monitor::applyToReferenceParticle ( const Vector_t< double, 3 > &  R,
const Vector_t< double, 3 > &  P,
const double &  t,
Vector_t< double, 3 > &  E,
Vector_t< double, 3 > &  B 
)
overridevirtualinherited

Apply to reference particle with position R and momemtum P.

Parameters
RPosition
PMomentum
tTime
EElectric Field
BMagnetic Field
Returns
true if particle is out-of-bounds (lost), false otherwise

Reimplemented from Component.

Definition at line 259 of file Monitor.cpp.

References OpalData::APPEND, Physics::c, ElementBase::csTrafoGlobal2Local_m, Monitor::driftToCorrectPositionAndSave(), euclidean_norm(), Util::getBeta(), PartBunch< T, Dim >::getdT(), PartBunch< T, Dim >::getGlobalTrackStep(), OpalData::getInstance(), OpalData::getOpenMode(), Monitor::lossDs_m, Monitor::numPassages_m, Component::online_m, Component::RefPartBunch_m, CoordinateSystemTrafo::rotateFrom(), Monitor::statFileEntries_sm, TEMPORAL, CoordinateSystemTrafo::transformFrom(), and Monitor::type_m.

Referenced by TEST_F().

Here is the call graph for this function:

◆ bends()

bool Monitor::bends ( ) const
overridevirtualinherited

Implements Component.

Definition at line 375 of file Monitor.cpp.

Referenced by TEST_F().

◆ Bfield() [1/2]

BVector Component::Bfield ( const Point3D P) const
inlineinherited

Return the field in a point.

Definition at line 234 of file Component.h.

References EMField::Bfield(), and Component::getField().

Here is the call graph for this function:

◆ Bfield() [2/2]

BVector Component::Bfield ( const Point3D P,
double  t 
) const
inlineinherited

Return the field in a point.

Definition at line 240 of file Component.h.

References EMField::Bfield(), and Component::getField().

Here is the call graph for this function:

◆ clone()

ElementBase * MonitorRep::clone ( ) const
virtual

Return clone.

Implements ElementBase.

Definition at line 43 of file MonitorRep.cpp.

References MonitorRep().

Here is the call graph for this function:

◆ copyStructure()

ElementBase * ElementBase::copyStructure ( )
virtualinherited

Make a structural copy.

Reimplemented in TBeamline< T >.

Definition at line 194 of file ElementBase.cpp.

References ElementBase::clone(), and ElementBase::isSharable().

Referenced by Sequence::copy(), Line::parse(), SequenceParser::parseMember(), and Replacer::visitFlaggedElmPtr().

Here is the call graph for this function:

◆ driftToCorrectPositionAndSave()

◆ EBfield() [1/2]

EBVectors Component::EBfield ( const Point3D P) const
inlineinherited

Return the field in a point.

Definition at line 244 of file Component.h.

References EMField::EBfield(), and Component::getField().

Here is the call graph for this function:

◆ EBfield() [2/2]

EBVectors Component::EBfield ( const Point3D P,
double  t 
) const
inlineinherited

Return the field in a point.

Definition at line 246 of file Component.h.

References EMField::EBfield(), and Component::getField().

Here is the call graph for this function:

◆ Efield() [1/2]

EVector Component::Efield ( const Point3D P) const
inlineinherited

Return the field in a point.

Definition at line 232 of file Component.h.

References EMField::Efield(), and Component::getField().

Here is the call graph for this function:

◆ Efield() [2/2]

EVector Component::Efield ( const Point3D P,
double  t 
) const
inlineinherited

Return the field in a point.

Definition at line 236 of file Component.h.

References EMField::Efield(), and Component::getField().

Here is the call graph for this function:

◆ finalise()

void Monitor::finalise ( )
overridevirtualinherited

Implements Component.

Definition at line 356 of file Monitor.cpp.

◆ fixPosition()

void ElementBase::fixPosition ( )
inlineinherited

◆ getAperture()

std::pair< ApertureType, std::vector< double > > ElementBase::getAperture ( ) const
inlineinherited

◆ getArcLength()

double ElementBase::getArcLength ( ) const
inlinevirtualinherited

Get arc length.

Reimplemented in MarkerRep, and TBeamline< T >.

Definition at line 479 of file ElementBase.h.

References BGeometryBase::getArcLength(), and ElementBase::getGeometry().

Referenced by BeamlineGeometry::getArcLength(), and TBeamline< T >::getTransform().

Here is the call graph for this function:

◆ getAttribute()

double ElementBase::getAttribute ( const std::string &  aKey) const
virtualinherited

Get attribute value.

Definition at line 147 of file ElementBase.cpp.

References ElementBase::getConstChannel().

Here is the call graph for this function:

◆ getBodyPort()

Port ElementBase::getBodyPort ( ) const
inlinevirtualinherited

Return the body port of the canonical local chart.

The body port \(p_{i,\mathrm{body}}\) is the identity port of the element's canonical local chart. Its rigid transform is therefore the identity element of \(SE(3)\) in the first redesign stage.

Definition at line 547 of file ElementBase.h.

Referenced by ElementBase::getPlacementGeometry(), and TEST_F().

◆ getBoundaryGeometry()

BoundaryGeometry * ElementBase::getBoundaryGeometry ( ) const
inlinevirtualinherited

return the attached boundary geometrt object if there is any

Definition at line 513 of file ElementBase.h.

References ElementBase::bgeometry_m.

◆ getBoundingBoxInLabCoords()

BoundingBox ElementBase::getBoundingBoxInLabCoords ( ) const
virtualinherited

◆ getChannel()

Channel * MonitorRep::getChannel ( const std::string &  aKey,
bool  create = false 
)
virtual

Construct a read/write channel.

Reimplemented from ElementBase.

Definition at line 45 of file MonitorRep.cpp.

References ElementBase::getChannel().

Here is the call graph for this function:

◆ getConstChannel()

const ConstChannel * ElementBase::getConstChannel ( const std::string &  aKey) const
virtualinherited

Construct a read-only channel.

Definition at line 186 of file ElementBase.cpp.

References ElementBase::getChannel().

Referenced by ElementBase::getAttribute(), and ElementBase::hasAttribute().

Here is the call graph for this function:

◆ getCSTrafoGlobal2Local()

CoordinateSystemTrafo ElementBase::getCSTrafoGlobal2Local ( ) const
inlineinherited

◆ getDesign()

const ElementBase & Component::getDesign ( ) const
virtualinherited

Return design element.

Definition at line 33 of file Component.cpp.

◆ getDesignEnergy()

double Component::getDesignEnergy ( ) const
inlinevirtualinherited

Reimplemented in BendBase, and RFCavity.

Definition at line 254 of file Component.h.

◆ getEdgeToBegin()

CoordinateSystemTrafo ElementBase::getEdgeToBegin ( ) const
inlinevirtualinherited

◆ getEdgeToEnd()

CoordinateSystemTrafo ElementBase::getEdgeToEnd ( ) const
inlinevirtualinherited

Reimplemented in BendBase, RFCavity, Solenoid, and TravelingWave.

Definition at line 538 of file ElementBase.h.

References ElementBase::getElementLength().

Referenced by ElementBase::getBoundingBoxInLabCoords(), and ElementBase::getExitPort().

Here is the call graph for this function:

◆ getElementDimensions()

virtual void ElementBase::getElementDimensions ( double &  begin,
double &  end 
) const
inlinevirtualinherited

Return the nominal body extent of the element.

The first placement redesign stage distinguishes between the nominal body extent and the field-support extent. The body extent is the canonical longitudinal interval of the placed hardware, \([z_\mathrm{body}^{\mathrm{begin}}, z_\mathrm{body}^{\mathrm{end}}]\), and therefore drives ports, placement, and visualization. By default it coincides with the geometry length \([0, L]\) in the local chart.

Reimplemented in RFCavity, TravelingWave, and Solenoid.

Definition at line 178 of file ElementBase.h.

References ElementBase::getElementLength().

Referenced by MeshGenerator::add().

Here is the call graph for this function:

◆ getElementLength()

double ElementBase::getElementLength ( ) const
inlinevirtualinherited

◆ getElementPosition()

double ElementBase::getElementPosition ( ) const
inlineinherited

Definition at line 618 of file ElementBase.h.

References ElementBase::elemedgeSet_m, ElementBase::elementPosition_m, and ElementBase::getName().

Here is the call graph for this function:

◆ getEntrance()

double ElementBase::getEntrance ( ) const
inlinevirtualinherited

Get entrance position.

Reimplemented in TBeamline< T >.

Definition at line 487 of file ElementBase.h.

References BGeometryBase::getEntrance(), and ElementBase::getGeometry().

Referenced by BendBase::getDesignPath(), and BeamlineGeometry::getEntrance().

Here is the call graph for this function:

◆ getEntranceFrame()

Euclid3D ElementBase::getEntranceFrame ( ) const
inlinevirtualinherited

Get transform.

Reimplemented in TBeamline< T >.

Definition at line 499 of file ElementBase.h.

References BGeometryBase::getEntranceFrame(), and ElementBase::getGeometry().

Referenced by BendBase::getChordLength(), BendBase::getEdgeToBegin(), and BeamlineGeometry::getEntranceFrame().

Here is the call graph for this function:

◆ getEntrancePatch()

Euclid3D ElementBase::getEntrancePatch ( ) const
inlinevirtualinherited

Get patch.

Definition at line 503 of file ElementBase.h.

References BGeometryBase::getEntrancePatch(), and ElementBase::getGeometry().

Here is the call graph for this function:

◆ getEntryPort()

Port ElementBase::getEntryPort ( ) const
inlinevirtualinherited

Return the entrance port of the canonical local chart.

In the placement-note language, this is the marked entrance port \(p_{i,\mathrm{entry}}\) of element \(i\). For straight elements in the bridge stage, the body-to-entry transform is taken from the legacy getEdgeToBegin() result.

Definition at line 545 of file ElementBase.h.

References ElementBase::getEdgeToBegin().

Referenced by ElementBase::getPlacementGeometry(), and TEST_F().

Here is the call graph for this function:

◆ getExit()

double ElementBase::getExit ( ) const
inlinevirtualinherited

Get exit position.

Reimplemented in TBeamline< T >.

Definition at line 489 of file ElementBase.h.

References BGeometryBase::getExit(), and ElementBase::getGeometry().

Referenced by BendBase::getDesignPath(), and BeamlineGeometry::getExit().

Here is the call graph for this function:

◆ getExitFrame()

Euclid3D ElementBase::getExitFrame ( ) const
inlinevirtualinherited

Get transform.

Reimplemented in TBeamline< T >.

Definition at line 501 of file ElementBase.h.

References BGeometryBase::getExitFrame(), and ElementBase::getGeometry().

Referenced by BendBase::getChordLength(), BendBase::getEdgeToEnd(), and BeamlineGeometry::getExitFrame().

Here is the call graph for this function:

◆ getExitPatch()

Euclid3D ElementBase::getExitPatch ( ) const
inlinevirtualinherited

Get patch.

Definition at line 505 of file ElementBase.h.

References BGeometryBase::getExitPatch(), and ElementBase::getGeometry().

Here is the call graph for this function:

◆ getExitPort()

Port ElementBase::getExitPort ( ) const
inlinevirtualinherited

Return the exit port of the canonical local chart.

In the placement-note language, this is the marked exit port \(p_{i,\mathrm{exit}}\). For straight elements in the bridge stage, the body-to-exit transform is taken from the legacy getEdgeToEnd() result.

Definition at line 549 of file ElementBase.h.

References ElementBase::getEdgeToEnd().

Referenced by ElementBase::getPlacementGeometry(), and TEST_F().

Here is the call graph for this function:

◆ getField() [1/2]

NullField & MonitorRep::getField ( )
virtual

Get field.

Implements Component.

Definition at line 55 of file MonitorRep.cpp.

References field.

◆ getField() [2/2]

const NullField & MonitorRep::getField ( ) const
virtual

Get field.

Implements Component.

Definition at line 57 of file MonitorRep.cpp.

References field.

◆ getFieldExtend()

void Monitor::getFieldExtend ( double &  zBegin,
double &  zEnd 
) const
overridevirtualinherited

Return the field-support extent of the component.

This is the longitudinal interval \([z_\mathrm{field}^{\mathrm{begin}}, z_\mathrm{field}^{\mathrm{end}}]\) on which the external field model is evaluated in the element-local chart. In the first extent model this may differ from the nominal body extent returned by getElementDimensions(), for example when fringe fields extend beyond the hardware body or when a field map occupies only part of the body.

Implements Component.

Definition at line 377 of file Monitor.cpp.

References Monitor::halfLength_s.

Referenced by TEST_F().

◆ getFlagDeleteOnTransverseExit()

◆ getGeometry() [1/2]

StraightGeometry & MonitorRep::getGeometry ( )
virtual

Get geometry.

Implements Monitor.

Definition at line 59 of file MonitorRep.cpp.

References geometry.

◆ getGeometry() [2/2]

const StraightGeometry & MonitorRep::getGeometry ( ) const
virtual

Get geometry.

Implements Monitor.

Definition at line 61 of file MonitorRep.cpp.

References geometry.

◆ getMisalignment() [1/2]

CoordinateSystemTrafo ElementBase::getMisalignment ( ) const
inlineinherited

Definition at line 593 of file ElementBase.h.

References ElementBase::misalignment_m.

Referenced by ElementBase::getPlacementMisalignment().

◆ getMisalignment() [2/2]

void ElementBase::getMisalignment ( double &  x,
double &  y,
double &  s 
) const
inherited

◆ getName()

◆ getOrigin()

double ElementBase::getOrigin ( ) const
inlinevirtualinherited

Get origin position.

Reimplemented in TBeamline< T >.

Definition at line 485 of file ElementBase.h.

References ElementBase::getGeometry(), and BGeometryBase::getOrigin().

Referenced by BeamlineGeometry::getOrigin().

Here is the call graph for this function:

◆ getOutputFN()

std::string ElementBase::getOutputFN ( ) const
inherited

Get output filename.

Definition at line 138 of file ElementBase.cpp.

References ElementBase::getName(), and ElementBase::outputfn_m.

Referenced by Probe::doInitialise(), PluginElement::initialise(), and Monitor::initialise().

Here is the call graph for this function:

◆ getParticleMatterInteraction()

ParticleMatterInteractionHandler * ElementBase::getParticleMatterInteraction ( ) const
inlinevirtualinherited

Definition at line 517 of file ElementBase.h.

References ElementBase::parmatint_m.

◆ getPlacedElement()

PlacedElement ElementBase::getPlacedElement ( ) const
inlineinherited

Return a placed-element view assembled from the current bridge objects.

Definition at line 571 of file ElementBase.h.

References ElementBase::getPlacementGeometry(), ElementBase::getPlacementMisalignment(), ElementBase::getPlacementPose(), and ElementBase::getPlacementSupport().

Referenced by MeshGenerator::add(), and TEST_F().

Here is the call graph for this function:

◆ getPlacementGeometry()

ElementGeometry ElementBase::getPlacementGeometry ( ) const
inlineinherited

Return the bridge geometry ports assembled from legacy edge state.

The first redesign stage defines a minimal explicit port contract with three named body-relative ports: \(p_{i,\mathrm{entry}}\), \(p_{i,\mathrm{body}}\), \(p_{i,\mathrm{exit}}\). The default bridge preserves current OPALX behavior by deriving those ports from getEntryPort(), getBodyPort(), and getExitPort(), whose straight-element implementations are backed by the legacy getEdgeToBegin() and getEdgeToEnd() methods.

Definition at line 563 of file ElementBase.h.

References ElementBase::getBodyPort(), ElementBase::getEntryPort(), and ElementBase::getExitPort().

Referenced by ElementBase::getPlacedElement().

Here is the call graph for this function:

◆ getPlacementMisalignment()

Misalignment ElementBase::getPlacementMisalignment ( ) const
inlineinherited

Return the local nominal-to-actual correction stored for the element.

Definition at line 559 of file ElementBase.h.

References ElementBase::getMisalignment().

Referenced by ElementBase::getPlacedElement().

Here is the call graph for this function:

◆ getPlacementPose()

PlacementPose ElementBase::getPlacementPose ( ) const
inlineinherited

Return the nominal rigid placement transform of the element.

This is the bridge from the legacy stored CoordinateSystemTrafo to the new placement vocabulary. It preserves current nominal placement semantics and does not apply misalignment.

Definition at line 551 of file ElementBase.h.

References ElementBase::getCSTrafoGlobal2Local().

Referenced by ElementBase::getPlacedElement().

Here is the call graph for this function:

◆ getPlacementSupport()

SupportPlacement ElementBase::getPlacementSupport ( ) const
inlineinherited

Return the support-frame bridge object. The default is the body frame.

Definition at line 567 of file ElementBase.h.

Referenced by ElementBase::getPlacedElement().

◆ getPlane()

Monitor::Plane MonitorRep::getPlane ( ) const
virtual

Get planes.

Implements Monitor.

Definition at line 63 of file MonitorRep.cpp.

References active, Monitor::OFF, and Monitor::XY.

◆ getPotential()

virtual bool Component::getPotential ( const Vector_t< double, 3 > &  ,
const double &  ,
Vector_t< double, 3 > &  ,
double &   
)
inlinevirtualinherited

Calculate the four-potential at some position relative to the component.

Parameters
Rposition in the local coordinate system of the component
ttime
Afilled with the calculated magnetic vector potential
phifilled with the calculated electric potential Note that any existing values in A and phi may be overwritten by this method.
Returns
true if particle is outside the field map, else false Default for component is to return false and make no change to A and phi

Definition at line 155 of file Component.h.

◆ getRequiredNumberOfTimeSteps()

int Monitor::getRequiredNumberOfTimeSteps ( ) const
inlineoverridevirtualinherited

Reimplemented from ElementBase.

Definition at line 120 of file Monitor.h.

Referenced by TEST_F().

◆ getRotationAboutZ()

double ElementBase::getRotationAboutZ ( ) const
inlineinherited

Definition at line 609 of file ElementBase.h.

References ElementBase::rotationZAxis_m.

Referenced by OpalBeamline::compileCompatibilityPlacement().

◆ getTotalTransform()

Euclid3D ElementBase::getTotalTransform ( ) const
inlinevirtualinherited

Get transform.

Reimplemented in TBeamline< T >.

Definition at line 495 of file ElementBase.h.

References ElementBase::getGeometry(), and BGeometryBase::getTotalTransform().

Referenced by BeamlineGeometry::getTotalTransform().

Here is the call graph for this function:

◆ getTransform() [1/2]

Euclid3D ElementBase::getTransform ( double  fromS,
double  toS 
) const
inlinevirtualinherited

Get transform.

Reimplemented in TBeamline< T >.

Definition at line 491 of file ElementBase.h.

References ElementBase::getGeometry(), and BGeometryBase::getTransform().

Referenced by BendBase::getDesignPath(), BeamlineGeometry::getTransform(), TBeamline< T >::getTransform(), and BeamlineGeometry::getTransform().

Here is the call graph for this function:

◆ getTransform() [2/2]

Euclid3D ElementBase::getTransform ( double  s) const
inlinevirtualinherited

Get transform.

Reimplemented in TBeamline< T >.

Definition at line 497 of file ElementBase.h.

References ElementBase::getGeometry(), and BGeometryBase::getTransform().

Here is the call graph for this function:

◆ getType()

ElementType Monitor::getType ( ) const
overridevirtualinherited
Todo:
Check switch statements over ElementType and add a MONITOR case where needed.

Reimplemented from Component.

Definition at line 383 of file Monitor.cpp.

References MONITOR.

Referenced by TEST_F().

◆ getTypeString() [1/2]

std::string ElementBase::getTypeString ( ) const
inlineinherited

Definition at line 611 of file ElementBase.h.

References ElementBase::getType(), and ElementBase::getTypeString().

Referenced by ElementBase::getTypeString().

Here is the call graph for this function:

◆ getTypeString() [2/2]

std::string ElementBase::getTypeString ( ElementType  type)
staticinherited

Definition at line 192 of file ElementBase.cpp.

References ElementBase::elementTypeToString_s.

◆ getWake()

WakeFunction * ElementBase::getWake ( ) const
inlinevirtualinherited

return the attached wake object if there is any

Definition at line 509 of file ElementBase.h.

References ElementBase::wake_m.

◆ goOffline()

void Monitor::goOffline ( )
overridevirtualinherited

Reimplemented from Component.

Definition at line 360 of file Monitor.cpp.

References Monitor::lossDs_m, Monitor::numPassages_m, Monitor::statFileEntries_sm, TEMPORAL, and Monitor::type_m.

Referenced by TEST_F().

◆ goOnline()

void Monitor::goOnline ( const double &  kineticEnergy)
overridevirtualinherited

Reimplemented from Component.

Definition at line 358 of file Monitor.cpp.

References Component::online_m.

Referenced by TEST_F().

◆ hasAttribute()

bool ElementBase::hasAttribute ( const std::string &  aKey) const
virtualinherited

Test for existence of an attribute.

Definition at line 159 of file ElementBase.cpp.

References ElementBase::getConstChannel().

Here is the call graph for this function:

◆ hasBoundaryGeometry()

bool ElementBase::hasBoundaryGeometry ( ) const
inlinevirtualinherited

Definition at line 515 of file ElementBase.h.

References ElementBase::bgeometry_m.

◆ hasParticleMatterInteraction()

bool ElementBase::hasParticleMatterInteraction ( ) const
inlinevirtualinherited

Definition at line 521 of file ElementBase.h.

References ElementBase::parmatint_m.

◆ hasWake()

bool ElementBase::hasWake ( ) const
inlinevirtualinherited

Definition at line 511 of file ElementBase.h.

References ElementBase::wake_m.

◆ initialise()

void Monitor::initialise ( PartBunch_t bunch,
double &  startField,
double &  endField 
)
overridevirtualinherited

◆ isElementPositionSet()

bool ElementBase::isElementPositionSet ( ) const
inlineinherited

Definition at line 626 of file ElementBase.h.

References ElementBase::elemedgeSet_m.

◆ isInside()

bool Monitor::isInside ( const Vector_t< double, 3 > &  r) const
inlineoverridevirtualinherited

Reimplemented from ElementBase.

Definition at line 122 of file Monitor.h.

References ElementBase::getElementLength(), and ElementBase::isInsideTransverse().

Referenced by TEST_F(), and TEST_F().

Here is the call graph for this function:

◆ isInsideTransverse()

◆ isPositioned()

bool ElementBase::isPositioned ( ) const
inlineinherited

Definition at line 599 of file ElementBase.h.

References ElementBase::positionIsFixed.

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

◆ isSharable()

bool ElementBase::isSharable ( ) const
inlineinherited

Test if the element can be shared.

Definition at line 507 of file ElementBase.h.

References ElementBase::shareFlag.

Referenced by ElementBase::copyStructure(), and Sequence::updateList().

◆ makeSharable()

void ElementBase::makeSharable ( )
virtualinherited

Set sharable flag.

Reimplemented in TBeamline< T >.

Definition at line 202 of file ElementBase.cpp.

References ElementBase::shareFlag.

Referenced by OpalMarker::OpalMarker().

◆ Online()

bool Component::Online ( )
virtualinherited

Definition at line 47 of file Component.cpp.

References Component::online_m.

◆ operator=()

void MonitorRep::operator= ( const MonitorRep )
private

◆ releasePosition()

void ElementBase::releasePosition ( )
inlineinherited

Definition at line 595 of file ElementBase.h.

References ElementBase::positionIsFixed.

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

◆ removeAttribute()

void ElementBase::removeAttribute ( const std::string &  aKey)
virtualinherited

Remove an existing attribute.

Definition at line 170 of file ElementBase.cpp.

References AttributeSet::removeAttribute(), and ElementBase::userAttribs.

Here is the call graph for this function:

◆ setActionRange()

void ElementBase::setActionRange ( const std::queue< std::pair< double, double > > &  range)
inlineinherited

Definition at line 601 of file ElementBase.h.

References ElementBase::actionRange_m, and ElementBase::elementEdge_m.

◆ setActive()

void MonitorRep::setActive ( bool  flag = true)
virtual

Set active flag.

Definition at line 65 of file MonitorRep.cpp.

References active.

◆ setAperture()

void ElementBase::setAperture ( const ApertureType type,
const std::vector< double > &  args 
)
inlineinherited

◆ setAttribute()

void ElementBase::setAttribute ( const std::string &  aKey,
double  val 
)
virtualinherited

Set value of an attribute.

Definition at line 172 of file ElementBase.cpp.

References ElementBase::getChannel(), and Channel::isSettable().

Referenced by ElementBase::update(), and OpalElement::updateUnknown().

Here is the call graph for this function:

◆ setBoundaryGeometry()

void ElementBase::setBoundaryGeometry ( BoundaryGeometry geo)
virtualinherited

attach a boundary geometry field to the element

Definition at line 216 of file ElementBase.cpp.

References ElementBase::bgeometry_m.

◆ setCollectionType()

void Monitor::setCollectionType ( CollectionType  type)
inlineinherited

Definition at line 118 of file Monitor.h.

References Monitor::type_m.

Referenced by TEST_F(), and OpalMonitor::update().

◆ setCSTrafoGlobal2Local()

void ElementBase::setCSTrafoGlobal2Local ( const CoordinateSystemTrafo ori)
inlineinherited

◆ setCurrentSCoordinate()

void ElementBase::setCurrentSCoordinate ( double  s)
inherited

Definition at line 224 of file ElementBase.cpp.

References ElementBase::actionRange_m, and ElementBase::elementEdge_m.

◆ setDesignEnergy()

void Component::setDesignEnergy ( const double &  energy,
bool  changeable = true 
)
inlinevirtualinherited

Reimplemented in Corrector, RFCavity, and BendBase.

Definition at line 252 of file Component.h.

◆ setElementLength()

◆ setElementPosition()

void ElementBase::setElementPosition ( double  elemedge)
inlineinherited

Access to ELEMEDGE attribute.

Definition at line 613 of file ElementBase.h.

References ElementBase::elemedgeSet_m, and ElementBase::elementPosition_m.

Referenced by TEST_F(), TEST_F(), TEST_F(), TEST_F(), TEST_F(), TEST_F(), TEST_F(), TEST_F(), and OpalElement::update().

◆ setExitFaceSlope()

void Component::setExitFaceSlope ( const double &  m)
inlineinherited

Definition at line 250 of file Component.h.

References Component::exit_face_slope_m.

◆ setFlagDeleteOnTransverseExit()

void ElementBase::setFlagDeleteOnTransverseExit ( bool  flag = true)
inlineinherited

Definition at line 630 of file ElementBase.h.

References ElementBase::deleteOnTransverseExit_m.

Referenced by OpalElement::update().

◆ setMisalignment()

void ElementBase::setMisalignment ( const CoordinateSystemTrafo cst)
inlineinherited

Definition at line 591 of file ElementBase.h.

References ElementBase::misalignment_m.

Referenced by TEST_F(), and OpalElement::update().

◆ setName()

void ElementBase::setName ( const std::string &  name)
virtualinherited

Set element name.

Definition at line 134 of file ElementBase.cpp.

References ElementBase::elementID.

Referenced by Sequence::insertDrifts(), and VariableRFCavity::operator=().

◆ setOutputFN()

void ElementBase::setOutputFN ( std::string  fn)
inherited

Set output filename.

Definition at line 136 of file ElementBase.cpp.

References ElementBase::outputfn_m.

Referenced by OpalMonitor::update(), and OpalProbe::update().

◆ setParticleMatterInteraction()

void ElementBase::setParticleMatterInteraction ( ParticleMatterInteractionHandler *  spys)
virtualinherited

Definition at line 220 of file ElementBase.cpp.

References ElementBase::parmatint_m.

◆ setPlacementPose()

void ElementBase::setPlacementPose ( const PlacementPose pose)
inlineinherited

Set the nominal rigid placement transform of the element.

This bridge setter preserves the existing storage model by delegating to setCSTrafoGlobal2Local().

Definition at line 555 of file ElementBase.h.

References PlacementPose::getParentToNominal(), and ElementBase::setCSTrafoGlobal2Local().

Here is the call graph for this function:

◆ setRotationAboutZ()

void ElementBase::setRotationAboutZ ( double  rotation)
inlineinherited

Set rotation about z axis in bend frame.

Definition at line 607 of file ElementBase.h.

References ElementBase::rotationZAxis_m.

Referenced by OpalElement::update().

◆ setWake()

void ElementBase::setWake ( WakeFunction *  wf)
virtualinherited

attach a wake field to the element

Definition at line 212 of file ElementBase.cpp.

References ElementBase::wake_m.

◆ trackBunch()

void Component::trackBunch ( PartBunch_t bunch,
const PartData ,
bool  revBeam,
bool  revTrack 
) const
virtualinherited

Track a borrowed particle bunch through a non-standard component.

The default implementation throws a LogicalError.

Parameters
bunchParticle bunch to track. The component does not take ownership.

Definition at line 35 of file Component.cpp.

References ElementBase::getName().

Referenced by Tracker::visitComponent().

Here is the call graph for this function:

◆ trackMap()

void Component::trackMap ( FVps< double, 6 > &  map,
const PartData ,
bool  revBeam,
bool  revTrack 
) const
virtualinherited

Track a map.

Definition at line 39 of file Component.cpp.

References ElementBase::getName().

Here is the call graph for this function:

◆ update()

bool ElementBase::update ( const AttributeSet set)
inherited

Update element.

Definition at line 204 of file ElementBase.cpp.

References AttributeSet::begin(), AttributeSet::end(), and ElementBase::setAttribute().

Referenced by Monitor::driftToCorrectPositionAndSave().

Here is the call graph for this function:

◆ writeStatistics()

void Monitor::writeStatistics ( )
staticinherited

Member Data Documentation

◆ actionRange_m

std::queue<std::pair<double, double> > ElementBase::actionRange_m
privateinherited

◆ active

bool MonitorRep::active
protected

The active/inactive flag.

Definition at line 80 of file MonitorRep.h.

Referenced by getPlane(), and setActive().

◆ aperture_m

std::pair<ApertureType, std::vector<double> > ElementBase::aperture_m
protectedinherited

◆ bgeometry_m

BoundaryGeometry* ElementBase::bgeometry_m
privateinherited

◆ csTrafoGlobal2Local_m

◆ defaultAperture_m

const std::vector< double > Component::defaultAperture_m = std::vector<double>({1e6, 1e6, 1.0})
staticprotectedinherited

Definition at line 221 of file Component.h.

Referenced by Component::Component().

◆ deleteOnTransverseExit_m

bool ElementBase::deleteOnTransverseExit_m = true
privateinherited

◆ elemedgeSet_m

bool ElementBase::elemedgeSet_m
privateinherited

◆ elementEdge_m

double ElementBase::elementEdge_m
protectedinherited

◆ elementID

std::string ElementBase::elementID
privateinherited

Definition at line 451 of file ElementBase.h.

Referenced by ElementBase::getName(), and ElementBase::setName().

◆ elementPosition_m

double ElementBase::elementPosition_m
privateinherited

ELEMEDGE attribute.

Definition at line 466 of file ElementBase.h.

Referenced by ElementBase::getElementPosition(), and ElementBase::setElementPosition().

◆ elementTypeToString_s

const std::map< ElementType, std::string > ElementBase::elementTypeToString_s
staticprivateinherited
Initial value:

Definition at line 73 of file ElementBase.h.

Referenced by ElementBase::getTypeString().

◆ exit_face_slope_m

double Component::exit_face_slope_m
protectedinherited

Definition at line 222 of file Component.h.

Referenced by Component::setExitFaceSlope().

◆ field

NullField MonitorRep::field
protected

The zero magnetic field.

Definition at line 74 of file MonitorRep.h.

Referenced by getField(), and getField().

◆ filename_m

std::string Monitor::filename_m
privateinherited

The name of the output file

Definition at line 107 of file Monitor.h.

Referenced by Monitor::initialise().

◆ geometry

StraightGeometry MonitorRep::geometry
protected

The monitor geometry.

Definition at line 77 of file MonitorRep.h.

Referenced by getGeometry(), and getGeometry().

◆ halfLength_s

const double Monitor::halfLength_s = 0.005
staticprivateinherited

Definition at line 115 of file Monitor.h.

Referenced by Monitor::getFieldExtend(), and Monitor::initialise().

◆ lossDs_m

◆ misalignment_m

CoordinateSystemTrafo ElementBase::misalignment_m
protectedinherited

Definition at line 438 of file ElementBase.h.

Referenced by ElementBase::getMisalignment(), and ElementBase::setMisalignment().

◆ numPassages_m

unsigned int Monitor::numPassages_m
privateinherited

Definition at line 110 of file Monitor.h.

Referenced by Monitor::applyToReferenceParticle(), and Monitor::goOffline().

◆ online_m

◆ outputfn_m

std::string ElementBase::outputfn_m
privateinherited

The name of the outputfile

Definition at line 471 of file ElementBase.h.

Referenced by ElementBase::getOutputFN(), and ElementBase::setOutputFN().

◆ parmatint_m

ParticleMatterInteractionHandler* ElementBase::parmatint_m
privateinherited

◆ plane_m

Plane Monitor::plane_m
privateinherited

Definition at line 108 of file Monitor.h.

◆ positionIsFixed

bool ElementBase::positionIsFixed
privateinherited

◆ RefPartBunch_m

PartBunch_t* Component::RefPartBunch_m
protectedinherited

◆ rotationZAxis_m

double ElementBase::rotationZAxis_m
protectedinherited

◆ shareFlag

bool ElementBase::shareFlag
mutableprotectedinherited

◆ statFileEntries_sm

std::map< double, SetStatistics > Monitor::statFileEntries_sm
staticprivateinherited

◆ type_m

◆ userAttribs

AttributeSet ElementBase::userAttribs
privateinherited

Definition at line 456 of file ElementBase.h.

Referenced by ElementBase::getChannel(), and ElementBase::removeAttribute().

◆ wake_m

WakeFunction* ElementBase::wake_m
privateinherited

Definition at line 458 of file ElementBase.h.

Referenced by ElementBase::getWake(), ElementBase::hasWake(), and ElementBase::setWake().


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