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

#include <Monitor.h>

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

Public Types

enum  Plane { OFF , X , Y , XY }
 Plane selection. More...
 
- 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
}
 

Public Member Functions

 Monitor (const std::string &name)
 Constructor with given name. More...
 
 Monitor ()
 
 Monitor (const Monitor &)
 
virtual ~Monitor ()
 
virtual void accept (BeamlineVisitor &) const override
 Apply visitor to Monitor. More...
 
virtual StraightGeometrygetGeometry () override=0
 Get geometry. More...
 
virtual const StraightGeometrygetGeometry () const override=0
 Get geometry. Version for const object. More...
 
virtual Plane getPlane () const =0
 Get plane on which monitor observes. More...
 
virtual bool apply (const size_t &i, 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 ElementBase::ElementType getType () const override
 Get element type std::string. More...
 
virtual void getDimensions (double &zBegin, double &zEnd) const override
 
void setCollectionType (CollectionType type)
 
virtual int getRequiredNumberOfTimeSteps () const override
 
virtual bool isInside (const Vector_t &r) 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 apply (const Vector_t &R, const Vector_t &P, const double &t, Vector_t &E, Vector_t &B)
 
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 double getArcLength () const
 Get arc length. More...
 
virtual double getElementLength () const
 Get design length. More...
 
virtual void setElementLength (double length)
 Set design length. More...
 
virtual void getElementDimensions (double &begin, double &end) const
 
virtual double getOrigin () const
 Get origin position. More...
 
virtual double getEntrance () const
 Get entrance position. More...
 
virtual double getExit () const
 Get exit position. More...
 
virtual Euclid3D getTransform (double fromS, double toS) const
 Get transform. More...
 
virtual Euclid3D getTransform (double s) const
 Get transform. More...
 
virtual Euclid3D getTotalTransform () const
 Get transform. More...
 
virtual Euclid3D getEntranceFrame () const
 Get transform. More...
 
virtual Euclid3D getExitFrame () const
 Get transform. More...
 
virtual Euclid3D getEntrancePatch () const
 Get patch. More...
 
virtual Euclid3D getExitPatch () const
 Get patch. More...
 
virtual double getAttribute (const std::string &aKey) const
 Get attribute value. More...
 
virtual bool hasAttribute (const std::string &aKey) const
 Test for existence of an attribute. More...
 
virtual void removeAttribute (const std::string &aKey)
 Remove an existing attribute. More...
 
virtual void setAttribute (const std::string &aKey, double val)
 Set value of an attribute. More...
 
virtual ChannelgetChannel (const std::string &aKey, bool create=false)
 Construct a read/write channel. More...
 
virtual const ConstChannelgetConstChannel (const std::string &aKey) const
 Construct a read-only channel. More...
 
virtual 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
 
virtual CoordinateSystemTrafo getEdgeToBegin () const
 
virtual CoordinateSystemTrafo getEdgeToEnd () const
 
void setAperture (const ApertureType &type, const std::vector< double > &args)
 
std::pair< ElementBase::ApertureType, std::vector< double > > getAperture () const
 
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
 
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...
 

Static Public Member Functions

static void writeStatistics ()
 
- Static Public Member Functions inherited from ElementBase
static std::string getTypeString (ElementType type)
 

Private Member Functions

void operator= (const Monitor &)
 

Private Attributes

std::string filename_m
 
Plane plane_m
 
CollectionType type_m
 
unsigned int numPassages_m
 
std::unique_ptr< LossDataSinklossDs_m
 

Static Private Attributes

static std::map< double, SetStatisticsstatFileEntries_sm
 
static const double halfLength_s = 0.005
 

Additional Inherited Members

- 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

Definition at line 32 of file Monitor.h.

Member Enumeration Documentation

◆ Plane

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 37 of file Monitor.h.

Constructor & Destructor Documentation

◆ Monitor() [1/3]

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

Constructor with given name.

Definition at line 53 of file Monitor.cpp.

References SPATIAL.

◆ Monitor() [2/3]

Monitor::Monitor ( )

Definition at line 39 of file Monitor.cpp.

◆ Monitor() [3/3]

Monitor::Monitor ( const Monitor right)

Definition at line 44 of file Monitor.cpp.

◆ ~Monitor()

Monitor::~Monitor ( )
virtual

Definition at line 62 of file Monitor.cpp.

Member Function Documentation

◆ accept()

void Monitor::accept ( BeamlineVisitor visitor) const
overridevirtual

Apply visitor to Monitor.

Implements ElementBase.

Definition at line 66 of file Monitor.cpp.

References BeamlineVisitor::visitMonitor().

Here is the call graph for this function:

◆ apply()

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

◆ applyToReferenceParticle()

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

◆ bends()

bool Monitor::bends ( ) const
overridevirtual

Implements Component.

Definition at line 192 of file Monitor.cpp.

◆ finalise()

void Monitor::finalise ( )
overridevirtual

Implements Component.

Definition at line 173 of file Monitor.cpp.

◆ getDimensions()

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

Implements Component.

Definition at line 196 of file Monitor.cpp.

References halfLength_s.

◆ getGeometry() [1/2]

virtual const StraightGeometry& Monitor::getGeometry ( ) const
overridepure virtual

Get geometry. Version for const object.

Implements ElementBase.

Implemented in MonitorRep.

◆ getGeometry() [2/2]

virtual StraightGeometry& Monitor::getGeometry ( )
overridepure virtual

Get geometry.

Implements ElementBase.

Implemented in MonitorRep.

◆ getPlane()

virtual Plane Monitor::getPlane ( ) const
pure virtual

Get plane on which monitor observes.

Implemented in MonitorRep.

◆ getRequiredNumberOfTimeSteps()

int Monitor::getRequiredNumberOfTimeSteps ( ) const
inlineoverridevirtual

Reimplemented from ElementBase.

Definition at line 117 of file Monitor.h.

◆ getType()

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

Get element type std::string.

Reimplemented from Component.

Definition at line 202 of file Monitor.cpp.

References ElementBase::MONITOR.

◆ goOffline()

void Monitor::goOffline ( )
overridevirtual

Reimplemented from Component.

Definition at line 181 of file Monitor.cpp.

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

◆ goOnline()

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

Reimplemented from Component.

Definition at line 177 of file Monitor.cpp.

References Component::online_m.

◆ initialise()

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

◆ isInside()

bool Monitor::isInside ( const Vector_t r) const
inlineoverridevirtual

Reimplemented from ElementBase.

Definition at line 123 of file Monitor.h.

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

Here is the call graph for this function:

◆ operator=()

void Monitor::operator= ( const Monitor )
private

◆ setCollectionType()

void Monitor::setCollectionType ( CollectionType  type)
inline

Definition at line 112 of file Monitor.h.

References type_m.

Referenced by OpalMonitor::update().

◆ writeStatistics()

void Monitor::writeStatistics ( )
static

Definition at line 206 of file Monitor.cpp.

References MonitorStatisticsWriter::addRow(), OpalData::getInputBasename(), OpalData::getInstance(), Util::rewindLinesSDDS(), and statFileEntries_sm.

Referenced by ParallelTTracker::execute().

Here is the call graph for this function:

Member Data Documentation

◆ filename_m

std::string Monitor::filename_m
private

The name of the outputfile

Definition at line 100 of file Monitor.h.

Referenced by initialise().

◆ halfLength_s

const double Monitor::halfLength_s = 0.005
staticprivate

Definition at line 108 of file Monitor.h.

Referenced by getDimensions(), and initialise().

◆ lossDs_m

std::unique_ptr<LossDataSink> Monitor::lossDs_m
private

Definition at line 105 of file Monitor.h.

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

◆ numPassages_m

unsigned int Monitor::numPassages_m
private

Definition at line 103 of file Monitor.h.

Referenced by applyToReferenceParticle(), and goOffline().

◆ plane_m

Plane Monitor::plane_m
private

Definition at line 101 of file Monitor.h.

◆ statFileEntries_sm

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

Definition at line 107 of file Monitor.h.

Referenced by goOffline(), and writeStatistics().

◆ type_m

CollectionType Monitor::type_m
private

Definition at line 102 of file Monitor.h.

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


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