OPAL (Object Oriented Parallel Accelerator Library) 2022.1
OPAL
Public Member Functions | Private Member Functions | Private Attributes | List of all members
CCollimator Class Reference

#include <CCollimator.h>

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

Public Member Functions

 CCollimator (const std::string &name)
 Constructor with given name. More...
 
 CCollimator ()
 
 CCollimator (const CCollimator &rhs)
 
void operator= (const CCollimator &)=delete
 
virtual ~CCollimator ()
 
virtual void accept (BeamlineVisitor &) const override
 Apply visitor to CCollimator. More...
 
void print ()
 unused check method More...
 
void setDimensions (double xstart, double xend, double ystart, double yend, double zstart, double zend, double width)
 Set dimensions and consistency checks. More...
 
void setDimensions (double xstart, double xend, double ystart, double yend)
 unhide PluginElement::setDimensions(double xstart, double xend, double ystart, double yend) More...
 
virtual void goOnline (const double &kineticEnergy) override
 Override implementation of PluginElement. More...
 
virtual ElementType getType () const override
 Get element type std::string. More...
 
virtual void getDimensions (double &zBegin, double &zEnd) const override
 
double getZStart ()
 Member variable access. More...
 
double getZEnd ()
 
double getWidth ()
 
- Public Member Functions inherited from PluginElement
 PluginElement (const std::string &name)
 Constructor with given name. More...
 
 PluginElement ()
 
 PluginElement (const PluginElement &)
 
void operator= (const PluginElement &)=delete
 
virtual ~PluginElement ()
 
void setDimensions (double xstart, double xend, double ystart, double yend)
 Set dimensions and consistency checks. More...
 
bool check (PartBunchBase< double, 3 > *bunch, const int turnnumber, const double t, const double tstep)
 
int checkPoint (const double &x, const double &y) const
 Checks if coordinate is within element. More...
 
void save ()
 Save output. More...
 
virtual void initialise (PartBunchBase< double, 3 > *bunch, double &startField, double &endField) override
 Pure virtual implementation of Component. More...
 
void initialise (PartBunchBase< double, 3 > *bunch)
 
virtual void finalise () final
 
virtual void goOffline () final
 
virtual bool bends () const override
 
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
 
double getXStart () const
 Member variable access. More...
 
double getXEnd () const
 
double getYStart () const
 
double getYEnd () const
 
- 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 size_t &i, const double &t, Vector_t &E, Vector_t &B)
 
virtual bool apply (const Vector_t &R, const Vector_t &P, const double &t, Vector_t &E, Vector_t &B)
 
virtual bool applyToReferenceParticle (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 void initialise (PartBunchBase< double, 3 > *bunch, double &startField, double &endField)=0
 
virtual void finalise ()=0
 
virtual bool bends () const =0
 
virtual void goOnline (const double &kineticEnergy)
 
virtual void goOffline ()
 
virtual bool Online ()
 
virtual void getDimensions (double &zBegin, double &zEnd) const =0
 
virtual ElementType getType () const
 Get element type std::string. More...
 
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...
 
virtual ElementType getType () const =0
 Get element type std::string. 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 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 void accept (BeamlineVisitor &visitor) const =0
 Apply visitor. 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< ApertureType, std::vector< double > > getAperture () const
 
virtual bool isInside (const Vector_t &r) 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

virtual void doInitialise (PartBunchBase< double, 3 > *bunch) override
 Initialise particle matter interaction. More...
 
virtual bool doCheck (PartBunchBase< double, 3 > *bunch, const int turnnumber, const double t, const double tstep) override
 Record hits when bunch particles pass. More...
 
virtual void doSetGeom () override
 Calculate extend in r. More...
 
virtual void doFinalise () override
 Virtual hook for finalise. More...
 
virtual bool doPreCheck (PartBunchBase< double, 3 > *) override
 Virtual hook for preCheck. More...
 
virtual bool doFinaliseCheck (PartBunchBase< double, 3 > *bunch, bool flagNeedUpdate) override
 Virtual hook for finaliseCheck. More...
 

Private Attributes

bool informed_m = false
 Flag if error information already printed. More...
 
double rmax_m
 maximum extend in r More...
 
ParticleMatterInteractionHandlerparmatint_m = nullptr
 
double zstart_m
 input geometry positions More...
 
double zend_m
 
double width_m
 

Additional Inherited Members

- Static Public Member Functions inherited from ElementBase
static std::string getTypeString (ElementType type)
 
- Protected Member Functions inherited from PluginElement
void setGeom (const double dist)
 Sets geometry geom_m with element width dist. More...
 
void changeWidth (PartBunchBase< double, 3 > *bunch, int i, const double tstep, const double tangle)
 Change probe width depending on step size and angle of particle. More...
 
double calculateIncidentAngle (double xp, double yp) const
 Calculate angle of particle/bunch wrt to element. More...
 
- 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 PluginElement
double rmin_m
 radius closest to the origin More...
 
Point geom_m [5]
 actual geometry positions with adaptive width such that each particle hits element once per turn More...
 
double A_m
 
double B_m
 
double R_m
 
double C_m
 Geometric lengths used in calculations. More...
 
std::unique_ptr< LossDataSinklossDs_m
 Pointer to Loss instance. More...
 
int numPassages_m = 0
 Number of turns (number of times save() method is called) More...
 
double xstart_m
 input geometry positions More...
 
double xend_m
 
double ystart_m
 
double yend_m
 
double rstart_m
 
double rend_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 25 of file CCollimator.h.

Constructor & Destructor Documentation

◆ CCollimator() [1/3]

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

Constructor with given name.

Definition at line 34 of file CCollimator.cpp.

References setDimensions(), and PluginElement::setGeom().

Here is the call graph for this function:

◆ CCollimator() [2/3]

CCollimator::CCollimator ( )

Definition at line 31 of file CCollimator.cpp.

◆ CCollimator() [3/3]

CCollimator::CCollimator ( const CCollimator rhs)

◆ ~CCollimator()

CCollimator::~CCollimator ( )
virtual

Definition at line 50 of file CCollimator.cpp.

Member Function Documentation

◆ accept()

void CCollimator::accept ( BeamlineVisitor visitor) const
overridevirtual

Apply visitor to CCollimator.

Implements ElementBase.

Definition at line 52 of file CCollimator.cpp.

References BeamlineVisitor::visitCCollimator().

Here is the call graph for this function:

◆ doCheck()

bool CCollimator::doCheck ( PartBunchBase< double, 3 > *  bunch,
const int  turnnumber,
const double  t,
const double  tstep 
)
overrideprivatevirtual

Record hits when bunch particles pass.

bunch->Bin[i] != -1 makes sure the particle is not stored in more than one collimator

Implements PluginElement.

Definition at line 78 of file CCollimator.cpp.

References PartBunchBase< T, Dim >::Bin, PartBunchBase< T, Dim >::bunchNum, PluginElement::checkPoint(), PartBunchBase< T, Dim >::getLocalNum(), PartBunchBase< T, Dim >::ID, PluginElement::lossDs_m, PartBunchBase< T, Dim >::M, PartBunchBase< T, Dim >::P, PartBunchBase< T, Dim >::Q, PartBunchBase< T, Dim >::R, zend_m, and zstart_m.

Here is the call graph for this function:

◆ doFinalise()

void CCollimator::doFinalise ( )
overrideprivatevirtual

Virtual hook for finalise.

Reimplemented from PluginElement.

Definition at line 149 of file CCollimator.cpp.

References endl(), ElementBase::getName(), and gmsg.

Here is the call graph for this function:

◆ doFinaliseCheck()

bool CCollimator::doFinaliseCheck ( PartBunchBase< double, 3 > *  bunch,
bool  flagNeedUpdate 
)
overrideprivatevirtual

◆ doInitialise()

void CCollimator::doInitialise ( PartBunchBase< double, 3 > *  bunch)
overrideprivatevirtual

Initialise particle matter interaction.

Reimplemented from PluginElement.

Definition at line 140 of file CCollimator.cpp.

References ElementBase::getParticleMatterInteraction(), and parmatint_m.

Here is the call graph for this function:

◆ doPreCheck()

bool CCollimator::doPreCheck ( PartBunchBase< double, 3 > *  bunch)
overrideprivatevirtual

Virtual hook for preCheck.

Reimplemented from PluginElement.

Definition at line 56 of file CCollimator.cpp.

References abs(), PartBunchBase< T, Dim >::get_bounds(), max(), min(), rmax_m, PluginElement::rmin_m, zend_m, and zstart_m.

Here is the call graph for this function:

◆ doSetGeom()

void CCollimator::doSetGeom ( )
overrideprivatevirtual

Calculate extend in r.

Reimplemented from PluginElement.

Definition at line 193 of file CCollimator.cpp.

References PluginElement::geom_m, max(), and rmax_m.

Here is the call graph for this function:

◆ getDimensions()

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

Reimplemented from PluginElement.

Definition at line 184 of file CCollimator.cpp.

References ElementBase::getElementLength().

Here is the call graph for this function:

◆ getType()

ElementType CCollimator::getType ( ) const
overridevirtual

Get element type std::string.

Reimplemented from Component.

Definition at line 189 of file CCollimator.cpp.

References CCOLLIMATOR.

◆ getWidth()

double CCollimator::getWidth ( )
inline

Definition at line 100 of file CCollimator.h.

References width_m.

Referenced by ParallelCyclotronTracker::visitCCollimator().

◆ getZEnd()

double CCollimator::getZEnd ( )
inline

Definition at line 95 of file CCollimator.h.

References zend_m.

Referenced by ParallelCyclotronTracker::visitCCollimator().

◆ getZStart()

double CCollimator::getZStart ( )
inline

Member variable access.

Definition at line 90 of file CCollimator.h.

References zstart_m.

Referenced by ParallelCyclotronTracker::visitCCollimator().

◆ goOnline()

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

Override implementation of PluginElement.

Reimplemented from Component.

Definition at line 144 of file CCollimator.cpp.

References Component::online_m, and print().

Here is the call graph for this function:

◆ operator=()

void CCollimator::operator= ( const CCollimator )
delete

◆ print()

void CCollimator::print ( )

unused check method

Some debug print

Definition at line 153 of file CCollimator.cpp.

References endl(), ERRORMSG, informed_m, IpplInfo::myNode(), Component::RefPartBunch_m, and Fieldmap::typeset_msg().

Referenced by goOnline().

Here is the call graph for this function:

◆ setDimensions() [1/2]

void PluginElement::setDimensions ( double  xstart,
double  xend,
double  ystart,
double  yend 
)

◆ setDimensions() [2/2]

void CCollimator::setDimensions ( double  xstart,
double  xend,
double  ystart,
double  yend,
double  zstart,
double  zend,
double  width 
)

Set dimensions and consistency checks.

Definition at line 169 of file CCollimator.cpp.

References setDimensions(), PluginElement::setGeom(), width_m, zend_m, and zstart_m.

Referenced by CCollimator(), setDimensions(), and OpalCCollimator::update().

Here is the call graph for this function:

Member Data Documentation

◆ informed_m

bool CCollimator::informed_m = false
private

Flag if error information already printed.

Definition at line 77 of file CCollimator.h.

Referenced by print().

◆ parmatint_m

ParticleMatterInteractionHandler* CCollimator::parmatint_m = nullptr
private

Definition at line 86 of file CCollimator.h.

Referenced by doFinaliseCheck(), and doInitialise().

◆ rmax_m

double CCollimator::rmax_m
private

maximum extend in r

Definition at line 84 of file CCollimator.h.

Referenced by doPreCheck(), and doSetGeom().

◆ width_m

double CCollimator::width_m
private

Definition at line 82 of file CCollimator.h.

Referenced by CCollimator(), getWidth(), and setDimensions().

◆ zend_m

double CCollimator::zend_m
private

Definition at line 81 of file CCollimator.h.

Referenced by CCollimator(), doCheck(), doPreCheck(), getZEnd(), and setDimensions().

◆ zstart_m

double CCollimator::zstart_m
private

input geometry positions

Definition at line 80 of file CCollimator.h.

Referenced by CCollimator(), doCheck(), doPreCheck(), getZStart(), and setDimensions().


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