OPAL (Object Oriented Parallel Accelerator Library)  2.2.0
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

Interface for beam position monitors. More...

#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...
 
enum  Type { TEMPORAL, SPATIAL }
 
- 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
}
 

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 setOutputFN (std::string fn)
 
void setType (Type type)
 
- 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 void addKR (int i, double t, Vector_t &K)
 
virtual void addKT (int i, double t, Vector_t &K)
 
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 &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 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 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
 
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
 
virtual bool isInside (const Vector_t &r) 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...
 

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
 
Type type_m
 
unsigned int numPassages_m
 
std::unique_ptr< LossDataSinklossDs_m
 

Static Private Attributes

static std::map< double,
SetStatistics
statFileEntries_sm
 
static const double halfLength_s = 0.005
 

Additional Inherited Members

- 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 beam position monitors.

Definition at line 41 of file Monitor.h.

Member Enumeration Documentation

Plane selection.

Enumerator
OFF 

Monitor is off (inactive).

X 

Monitor acts on x-plane.

Y 

Monitor acts on y-plane.

XY 

Monitor acts on both planes.

Definition at line 46 of file Monitor.h.

Enumerator
TEMPORAL 
SPATIAL 

Definition at line 57 of file Monitor.h.

Constructor & Destructor Documentation

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

Constructor with given name.

Definition at line 57 of file Monitor.cpp.

Monitor::Monitor ( )

Definition at line 43 of file Monitor.cpp.

Monitor::Monitor ( const Monitor right)

Definition at line 48 of file Monitor.cpp.

Monitor::~Monitor ( )
virtual

Definition at line 66 of file Monitor.cpp.

Member Function Documentation

void Monitor::accept ( BeamlineVisitor visitor) const
overridevirtual

Apply visitor to Monitor.

Implements ElementBase.

Definition at line 70 of file Monitor.cpp.

References BeamlineVisitor::visitMonitor().

Here is the call graph for this function:

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

Implements Component.

Definition at line 191 of file Monitor.cpp.

void Monitor::finalise ( )
overridevirtual

Implements Component.

Definition at line 172 of file Monitor.cpp.

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

Implements Component.

Definition at line 199 of file Monitor.cpp.

References halfLength_s.

virtual StraightGeometry& Monitor::getGeometry ( )
overridepure virtual

Get geometry.

Implements ElementBase.

Implemented in MonitorRep.

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

Get geometry. Version for const object.

Implements ElementBase.

Implemented in MonitorRep.

virtual Plane Monitor::getPlane ( ) const
pure virtual

Get plane on which monitor observes.

Implemented in MonitorRep, XMonitorRep, and YMonitorRep.

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

Get element type std::string.

Reimplemented from Component.

Definition at line 205 of file Monitor.cpp.

References ElementBase::MONITOR.

Referenced by initialise().

void Monitor::goOffline ( )
overridevirtual

Reimplemented from Component.

Definition at line 180 of file Monitor.cpp.

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

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

Reimplemented from Component.

Definition at line 176 of file Monitor.cpp.

References Component::online_m.

void Monitor::initialise ( PartBunchBase< double, 3 > *  bunch,
double &  startField,
double &  endField 
)
overridevirtual
void Monitor::operator= ( const Monitor )
private
void Monitor::setOutputFN ( std::string  fn)

Definition at line 195 of file Monitor.cpp.

References filename_m.

Referenced by OpalMonitor::update().

void Monitor::setType ( Monitor::Type  type)
inline

Definition at line 124 of file Monitor.h.

References type_m.

Referenced by OpalMonitor::update().

void Monitor::writeStatistics ( )
static

Definition at line 209 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

std::string Monitor::filename_m
private

The name of the outputfile

Definition at line 112 of file Monitor.h.

Referenced by initialise(), and setOutputFN().

const double Monitor::halfLength_s = 0.005
staticprivate

Definition at line 120 of file Monitor.h.

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

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

Definition at line 117 of file Monitor.h.

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

unsigned int Monitor::numPassages_m
private

Definition at line 115 of file Monitor.h.

Referenced by applyToReferenceParticle(), and goOffline().

Plane Monitor::plane_m
private

Definition at line 113 of file Monitor.h.

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

Definition at line 119 of file Monitor.h.

Referenced by goOffline(), and writeStatistics().

Type Monitor::type_m
private

Definition at line 114 of file Monitor.h.

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


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