Component placement handler in ring geometry. More...

#include <RingSection.h>

Collaboration diagram for RingSection:

Public Member Functions
	RingSection ()
	RingSection (const RingSection &sec)
RingSection &	operator= (const RingSection &sec)
	~RingSection ()
bool	isOnOrPastStartPlane (const Vector_t< double, 3 > &pos) const
bool	isPastEndPlane (const Vector_t< double, 3 > &pos) const
bool	getFieldValue (const Vector_t< double, 3 > &pos, const Vector_t< double, 3 > &centroid, const double &t, Vector_t< double, 3 > &E, Vector_t< double, 3 > &B) const
std::vector< Vector_t< double, 3 > >	getVirtualBoundingBox () const
bool	doesOverlap (double phiStart, double phiEnd) const
void	setComponent (Component *component)
Component *	getComponent () const
void	setStartPosition (Vector_t< double, 3 > pos)
Vector_t< double, 3 >	getStartPosition () const
void	setStartNormal (Vector_t< double, 3 > orientation)
Vector_t< double, 3 >	getStartNormal () const
void	setEndPosition (Vector_t< double, 3 > pos)
Vector_t< double, 3 >	getEndPosition () const
void	setEndNormal (Vector_t< double, 3 > orientation)
Vector_t< double, 3 >	getEndNormal () const
void	setComponentPosition (Vector_t< double, 3 > position)
Vector_t< double, 3 >	getComponentPosition () const
void	setComponentOrientation (Vector_t< double, 3 > orientation)
Vector_t< double, 3 >	getComponentOrientation () const

Private Member Functions
void	rotate (Vector_t< double, 3 > &vector) const
void	rotate_back (Vector_t< double, 3 > &vector) const
Vector_t< double, 3 > &	normalise (Vector_t< double, 3 > &vector) const
void	rotateToTCoordinates (Vector_t< double, 3 > &vec) const
void	rotateToCyclCoordinates (Vector_t< double, 3 > &vec) const
void	updateComponentOrientation ()

Private Attributes
Component *	component_m
Vector_t< double, 3 >	componentPosition_m
Vector_t< double, 3 >	componentOrientation_m
Vector_t< double, 3 >	startPosition_m
Vector_t< double, 3 >	startOrientation_m
Vector_t< double, 3 >	endPosition_m
Vector_t< double, 3 >	endOrientation_m
double	sin2_m
double	cos2_m

Detailed Description

Component placement handler in ring geometry.

RingSection handles placement of a component when it is placed in a ring geometry. Here the primary index for section placement is azimuthal angle. RingSection assumes that ring objects occupy a space defined by a start plane and another end plane.

All vectors should be in cartesian coordinates (x,y,z); with z being the axis of the ring.

Parameters

component_m	component that the OpalSection wraps - this is a borrowed reference (RingSection does not own the memory)
startPosition_m	position of the centre of the start face in cylindrical polar coordinates
startOrientation_m	vector normal to the start face pointing towards the field map
endPosition_m	position of the centre of the end face in cylindrical polar coordinates
endOrientation_m	vector normal to the end face pointing away from the field map
componentPosition_m	field map position relative to component start
componentRotation_m	field map rotation R

So field maps are calculated in local coordinate system U_local = V+R*U_global where R is rotation matrix and V is componentPosition_m.

Return field values are returned like B_global = R^{-1}*B_local

Definition at line 67 of file RingSection.h.

Constructor & Destructor Documentation

◆ RingSection() [1/2]

RingSection::RingSection ( )

Construct a ring section - positions, orientations etc default to 0.

Definition at line 33 of file RingSection.cpp.

References component_m, componentOrientation_m, componentPosition_m, endOrientation_m, endPosition_m, startOrientation_m, and startPosition_m.

Referenced by doesOverlap(), operator=(), and RingSection().

Here is the caller graph for this function:

◆ RingSection() [2/2]

RingSection::RingSection ( const RingSection & sec )

Copy constructor; deepcopies the Component (and copies everything else)

Definition at line 40 of file RingSection.cpp.

References component_m, componentOrientation_m, componentPosition_m, endOrientation_m, endPosition_m, RingSection(), startOrientation_m, and startPosition_m.

Here is the call graph for this function:

◆ ~RingSection()

RingSection::~RingSection ( )

Destructor - does nothing

Definition at line 48 of file RingSection.cpp.

Member Function Documentation

◆ doesOverlap()

bool RingSection::doesOverlap	(	double	phiStart,
		double	phiEnd ) const

Return true if the phi range overlaps bounding box elements

Definition at line 137 of file RingSection.cpp.

References getVirtualBoundingBox(), isOnOrPastStartPlane(), isPastEndPlane(), RingSection(), setEndNormal(), setEndPosition(), setStartNormal(), and setStartPosition().

Here is the call graph for this function:

◆ getComponent()

Component * RingSection::getComponent ( ) const

inline

Get the component wrapped by RingSection

Component* is not owned by caller or RingSection

Definition at line 142 of file RingSection.h.

References component_m.

◆ getComponentOrientation()

Vector_t< double, 3 > RingSection::getComponentOrientation ( ) const

inline

Get the rotation for the component relative to the section start

Definition at line 196 of file RingSection.h.

References componentOrientation_m.

◆ getComponentPosition()

Vector_t< double, 3 > RingSection::getComponentPosition ( ) const

inline

Get the displacement for the component relative to the section start

Definition at line 188 of file RingSection.h.

References componentPosition_m.

◆ getEndNormal()

Vector_t< double, 3 > RingSection::getEndNormal ( ) const

inline

Get the normal vector to the section end plane

Definition at line 178 of file RingSection.h.

References endOrientation_m.

Referenced by Ring::appendElement(), and getVirtualBoundingBox().

Here is the caller graph for this function:

◆ getEndPosition()

Vector_t< double, 3 > RingSection::getEndPosition ( ) const

inline

Get a position on the section end plane

Definition at line 170 of file RingSection.h.

References endPosition_m.

Referenced by Ring::appendElement(), and getVirtualBoundingBox().

Here is the caller graph for this function:

◆ getFieldValue()

bool RingSection::getFieldValue	(	const Vector_t< double, 3 > &	pos,
		const Vector_t< double, 3 > &	centroid,
		const double &	t,
		Vector_t< double, 3 > &	E,
		Vector_t< double, 3 > &	B ) const

Return field value in global coordinate system

Parameters

pos	Position in global Cartesian coordinates
t	time in lab frame
centroid	Not sure what this is
E	Vector to be filled with electric field values; will always overwrite with 0. before filling field
B	Vector to be filled with magnetic field values; will always overwrite with 0. before filling field

Returns: true if pos is outside of the field bounding box, else false

Note; does not check for component == nullptr; caller must assign component_m (using setComponent) before calling this function.

Definition at line 95 of file RingSection.cpp.

References component_m, componentPosition_m, rotate(), rotate_back(), rotateToCyclCoordinates(), and rotateToTCoordinates().

Here is the call graph for this function:

◆ getStartNormal()

Vector_t< double, 3 > RingSection::getStartNormal ( ) const

inline

Get the normal vector to the section start plane

Definition at line 160 of file RingSection.h.

References startOrientation_m.

Referenced by Ring::appendElement(), and getVirtualBoundingBox().

Here is the caller graph for this function:

◆ getStartPosition()

Vector_t< double, 3 > RingSection::getStartPosition ( ) const

inline

Get a position on the plane of the section start

Definition at line 152 of file RingSection.h.

References startPosition_m.

Referenced by Ring::appendElement(), and getVirtualBoundingBox().

Here is the caller graph for this function:

◆ getVirtualBoundingBox()

std::vector< Vector_t< double, 3 > > RingSection::getVirtualBoundingBox ( ) const

Get the "Virtual" bounding box for the RingSection

Defined by the point one radial distance along each face of the element either towards the centre of the ring or towards the outside of the ring

Return order is; start outside, start inside, end outside, end inside

An improvement would be to put the crossing point if the two faces cross before they reach the radial apertures described above.

Definition at line 119 of file RingSection.cpp.

References getEndNormal(), getEndPosition(), getStartNormal(), getStartPosition(), and normalise().

Referenced by doesOverlap().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isOnOrPastStartPlane()

bool RingSection::isOnOrPastStartPlane ( const Vector_t< double, 3 > & pos ) const

Return true if pos is on or past start plane

Parameters

pos	position to test

Returns: true if phi(pos) >= phi(start plane), after taking account of the position and rotation of the start face

Definition at line 70 of file RingSection.cpp.

References startOrientation_m, and startPosition_m.

Referenced by doesOverlap().

Here is the caller graph for this function:

◆ isPastEndPlane()

bool RingSection::isPastEndPlane ( const Vector_t< double, 3 > & pos ) const

Return true if pos is past end plane

Returns: true if phi > phi(end plane), after taking account of the position and rotation of the start face

Definition at line 83 of file RingSection.cpp.

References endOrientation_m, and endPosition_m.

Referenced by doesOverlap().

Here is the caller graph for this function:

◆ normalise()

Vector_t< double, 3 > & RingSection::normalise ( Vector_t< double, 3 > & vector ) const

inlineprivate

Definition at line 238 of file RingSection.h.

Referenced by getVirtualBoundingBox(), setEndNormal(), and setStartNormal().

Here is the caller graph for this function:

◆ operator=()

RingSection & RingSection::operator= ( const RingSection & sec )

Definition at line 54 of file RingSection.cpp.

References ElementBase::clone(), component_m, componentOrientation_m, componentPosition_m, endOrientation_m, endPosition_m, RingSection(), startOrientation_m, and startPosition_m.

Here is the call graph for this function:

◆ rotate()

void RingSection::rotate ( Vector_t< double, 3 > & vector ) const

private

Definition at line 184 of file RingSection.cpp.

References cos2_m, and sin2_m.

Referenced by getFieldValue().

Here is the caller graph for this function:

◆ rotate_back()

void RingSection::rotate_back ( Vector_t< double, 3 > & vector ) const

private

Definition at line 190 of file RingSection.cpp.

References cos2_m, and sin2_m.

Referenced by getFieldValue().

Here is the caller graph for this function:

◆ rotateToCyclCoordinates()

void RingSection::rotateToCyclCoordinates ( Vector_t< double, 3 > & vec ) const

inlineprivate

Definition at line 251 of file RingSection.h.

Referenced by getFieldValue().

Here is the caller graph for this function:

◆ rotateToTCoordinates()

void RingSection::rotateToTCoordinates ( Vector_t< double, 3 > & vec ) const

inlineprivate

Definition at line 247 of file RingSection.h.

Referenced by getFieldValue().

Here is the caller graph for this function:

◆ setComponent()

void RingSection::setComponent ( Component * component )

inline

Set the component wrapped by RingSection

This borrows the Component* pointer (caller is responsible for cleanup)

Definition at line 134 of file RingSection.h.

References component_m.

Referenced by Ring::appendElement().

Here is the caller graph for this function:

◆ setComponentOrientation()

void RingSection::setComponentOrientation ( Vector_t< double, 3 > orientation )

inline

Set the rotation for the component relative to the section start

Definition at line 225 of file RingSection.h.

References componentOrientation_m, and updateComponentOrientation().

Referenced by Ring::appendElement().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setComponentPosition()

void RingSection::setComponentPosition ( Vector_t< double, 3 > position )

inline

Set the displacement for the component relative to the section start

Definition at line 183 of file RingSection.h.

References componentPosition_m.

Referenced by Ring::appendElement().

Here is the caller graph for this function:

◆ setEndNormal()

void RingSection::setEndNormal ( Vector_t< double, 3 > orientation )

inline

Set the normal vector to the section end plane

Definition at line 234 of file RingSection.h.

References endOrientation_m, and normalise().

Referenced by Ring::appendElement(), and doesOverlap().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setEndPosition()

void RingSection::setEndPosition ( Vector_t< double, 3 > pos )

inline

Set a position on the section end plane

Definition at line 165 of file RingSection.h.

References endPosition_m.

Referenced by Ring::appendElement(), and doesOverlap().

Here is the caller graph for this function:

◆ setStartNormal()

void RingSection::setStartNormal ( Vector_t< double, 3 > orientation )

inline

Set the normal vector to the section start plane

Definition at line 230 of file RingSection.h.

References normalise(), and startOrientation_m.

Referenced by Ring::appendElement(), and doesOverlap().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setStartPosition()

void RingSection::setStartPosition ( Vector_t< double, 3 > pos )

inline

Set a position on the plane of the section start

Definition at line 147 of file RingSection.h.

References startPosition_m.

Referenced by Ring::appendElement(), and doesOverlap().

Here is the caller graph for this function:

◆ updateComponentOrientation()

void RingSection::updateComponentOrientation ( )

private

Definition at line 114 of file RingSection.cpp.

References componentOrientation_m, cos2_m, and sin2_m.

Referenced by setComponentOrientation().

Here is the caller graph for this function:

Member Data Documentation

◆ component_m

Component* RingSection::component_m

private

Definition at line 207 of file RingSection.h.

Referenced by getComponent(), getFieldValue(), operator=(), RingSection(), RingSection(), and setComponent().

◆ componentOrientation_m

Vector_t<double, 3> RingSection::componentOrientation_m

private

Definition at line 210 of file RingSection.h.

Referenced by getComponentOrientation(), operator=(), RingSection(), RingSection(), setComponentOrientation(), and updateComponentOrientation().

◆ componentPosition_m

Vector_t<double, 3> RingSection::componentPosition_m

private

Definition at line 209 of file RingSection.h.

Referenced by getComponentPosition(), getFieldValue(), operator=(), RingSection(), RingSection(), and setComponentPosition().

◆ cos2_m

double RingSection::cos2_m

private

Definition at line 220 of file RingSection.h.

Referenced by rotate(), rotate_back(), and updateComponentOrientation().

◆ endOrientation_m

Vector_t<double, 3> RingSection::endOrientation_m

private

Definition at line 216 of file RingSection.h.

Referenced by getEndNormal(), isPastEndPlane(), operator=(), RingSection(), RingSection(), and setEndNormal().

◆ endPosition_m

Vector_t<double, 3> RingSection::endPosition_m

private

Definition at line 215 of file RingSection.h.

Referenced by getEndPosition(), isPastEndPlane(), operator=(), RingSection(), RingSection(), and setEndPosition().

◆ sin2_m

double RingSection::sin2_m

private

Definition at line 219 of file RingSection.h.

Referenced by rotate(), rotate_back(), and updateComponentOrientation().

◆ startOrientation_m

Vector_t<double, 3> RingSection::startOrientation_m

private

Definition at line 213 of file RingSection.h.

Referenced by getStartNormal(), isOnOrPastStartPlane(), operator=(), RingSection(), RingSection(), and setStartNormal().

◆ startPosition_m

Vector_t<double, 3> RingSection::startPosition_m

private

Definition at line 212 of file RingSection.h.

Referenced by getStartPosition(), isOnOrPastStartPlane(), operator=(), RingSection(), RingSection(), and setStartPosition().

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

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ RingSection() [1/2]

◆ RingSection() [2/2]

◆ ~RingSection()

Member Function Documentation

◆ doesOverlap()

◆ getComponent()

◆ getComponentOrientation()

◆ getComponentPosition()

◆ getEndNormal()

◆ getEndPosition()

◆ getFieldValue()

◆ getStartNormal()

◆ getStartPosition()

◆ getVirtualBoundingBox()

◆ isOnOrPastStartPlane()

◆ isPastEndPlane()

◆ normalise()

◆ operator=()

◆ rotate()

◆ rotate_back()

◆ rotateToCyclCoordinates()

◆ rotateToTCoordinates()

◆ setComponent()

◆ setComponentOrientation()

◆ setComponentPosition()

◆ setEndNormal()

◆ setEndPosition()

◆ setStartNormal()

◆ setStartPosition()

◆ updateComponentOrientation()

Member Data Documentation

◆ component_m

◆ componentOrientation_m

◆ componentPosition_m

◆ cos2_m

◆ endOrientation_m

◆ endPosition_m

◆ sin2_m

◆ startOrientation_m

◆ startPosition_m