#include <Enge.h>

Inheritance diagram for endfieldmodel::Enge:

Collaboration diagram for endfieldmodel::Enge:

Public Member Functions
	Enge ()
	Enge (const std::vector< double > a, double x0, double lambda)
	~Enge ()
Enge *	clone () const
void	rescale (double scaleFactor)
double	function (double x, int n) const
double	getEndLength () const
double	getCentreLength () const
std::ostream &	print (std::ostream &out) const
std::vector< double >	getCoefficients () const
void	setCoefficients (std::vector< double > a)
double	getLambda () const
void	setLambda (double lambda)
double	getX0 () const
void	setX0 (double x0)
void	setMaximumDerivative (size_t n)
double	getEnge (double x, int n) const
double	getDoubleEnge (double x, int n) const
double	hN (double x, int n) const
double	gN (double x, int n) const

Static Public Member Functions
static void	setEngeDiffIndices (size_t n)
static std::vector< std::vector< int > >	getQIndex (int n)
static std::vector< std::vector< int > >	getHIndex (int n)
static std::shared_ptr< EndFieldModel >	getEndFieldModel (std::string name)
static void	setEndFieldModel (std::string name, std::shared_ptr< EndFieldModel > efm)
static std::string	getName (std::shared_ptr< EndFieldModel > efm)

Private Member Functions
	Enge (const Enge &enge)
Enge &	operator= (const Enge &enge)

Private Attributes
std::vector< double >	_a
double	_lambda
double	_x0

Static Private Attributes
static std::vector< std::vector< std::vector< int > > >	_q
static std::vector< std::vector< std::vector< int > > >	_h
static std::map< std::string, std::shared_ptr< EndFieldModel > >	efm_map

Detailed Description

Enge class is a symmetric Enge function for analytical field models

Enge function is

\(f(x) = 1/(1+exp(h(x-x0)))+1/(1+exp(h(-x-x0)))-1\).

where h is a polynomial in x/lambda with polynomial coefficients a

Definition at line 47 of file Enge.h.

Constructor & Destructor Documentation

◆ Enge() [1/3]

endfieldmodel::Enge::Enge ( )

inline

Default constructor

Definition at line 50 of file Enge.h.

References _a, _lambda, and setEngeDiffIndices().

Referenced by clone(), Enge(), and operator=().

Here is the call graph for this function:

◆ Enge() [2/3]

endfieldmodel::Enge::Enge	(	const std::vector< double >	a,
		double	x0,
		double	lambda )

Builds Enge function with parameters a_0, a_1, ..., lambda and x0.

Note that this class is in the inner loop of tracking, so many function calls are not checked for correct indexing. Call setMaximumDerivative before use.

Definition at line 153 of file Enge.cpp.

References _a, _lambda, _x0, and a.

◆ ~Enge()

endfieldmodel::Enge::~Enge ( )

inline

Destructor - no mallocs, so does nothing

Definition at line 60 of file Enge.h.

◆ Enge() [3/3]

endfieldmodel::Enge::Enge ( const Enge & enge )

private

References Enge().

Here is the call graph for this function:

Member Function Documentation

◆ clone()

Enge * endfieldmodel::Enge::clone ( ) const

virtual

Inheritable copy constructor - no mallocs, so does nothing

Implements endfieldmodel::EndFieldModel.

Definition at line 157 of file Enge.cpp.

References _a, _lambda, _x0, and Enge().

Here is the call graph for this function:

◆ function()

double endfieldmodel::Enge::function	(	double	x,
		int	n ) const

inlinevirtual

Return the value of enge(x+x0) + enge(-x-x0) at some point x

Implements endfieldmodel::EndFieldModel.

Definition at line 155 of file Enge.h.

References getDoubleEnge().

Here is the call graph for this function:

◆ getCentreLength()

double endfieldmodel::Enge::getCentreLength ( ) const

inlinevirtual

Nominal centre length is x0/2

Implements endfieldmodel::EndFieldModel.

Definition at line 176 of file Enge.h.

References _x0.

◆ getCoefficients()

std::vector< double > endfieldmodel::Enge::getCoefficients ( ) const

inline

Returns the enge polynomial coefficients (a_i)

Definition at line 84 of file Enge.h.

References _a.

◆ getDoubleEnge()

double endfieldmodel::Enge::getDoubleEnge	(	double	x,
		int	n ) const

inline

Returns \(Enge(x-x0) + Enge(-x-x0)-1\) and its derivatives

Definition at line 167 of file Enge.h.

References _x0, and getEnge().

Referenced by function().

Here is the call graph for this function:

◆ getEndFieldModel()

std::shared_ptr< EndFieldModel > endfieldmodel::EndFieldModel::getEndFieldModel ( std::string name )

staticinherited

Look up the EndFieldModel that has a given name

Parameters

name	name of the EndFieldModel

Returns: shared_ptr to the appropriate EndFieldModel.

Exceptions

GeneralClassicException if name is not recognised

Definition at line 63 of file EndFieldModel.cpp.

References efm_map, and name.

Referenced by PyOpal::PyEndFieldModel::function(), and ScalingFFAMagnet::setupEndField().

◆ getEndLength()

double endfieldmodel::Enge::getEndLength ( ) const

inlinevirtual

Nominal end length is lambda

Implements endfieldmodel::EndFieldModel.

Definition at line 180 of file Enge.h.

References _lambda.

◆ getEnge()

double endfieldmodel::Enge::getEnge	(	double	x,
		int	n ) const

Returns the value of the Enge function or its \(n^{th}\) derivative.

Please call setEngeDiffIndices(n) before calling if n > max_index

Definition at line 40 of file Enge.cpp.

References getQIndex(), and gN().

Referenced by getDoubleEnge().

Here is the call graph for this function:

◆ getHIndex()

std::vector< std::vector< int > > endfieldmodel::Enge::getHIndex ( int n )

inlinestatic

Return the indices for calculating the nth derivative of g(x) ito h(x)

Definition at line 163 of file Enge.h.

References _h.

◆ getLambda()

double endfieldmodel::Enge::getLambda ( ) const

inline

Returns the value of lambda

Definition at line 90 of file Enge.h.

References _lambda.

◆ getName()

std::string endfieldmodel::EndFieldModel::getName ( std::shared_ptr< EndFieldModel > efm )

staticinherited

Get the name corresponding to a given EndFieldModel

Parameters

efm	EndFieldModel to lookup

Returns: name corresponding to the EndFieldModel. Note that this just does a dumb loop over the stored map values; so O(N).

Exceptions

GeneralClassicException if efm is not recognised

Definition at line 77 of file EndFieldModel.cpp.

References efm_map.

◆ getQIndex()

std::vector< std::vector< int > > endfieldmodel::Enge::getQIndex ( int n )

inlinestatic

Return the indices for calculating the nth derivative of Enge ito g(x)

Definition at line 159 of file Enge.h.

References _q.

Referenced by getEnge().

◆ getX0()

double endfieldmodel::Enge::getX0 ( ) const

inline

Returns the value of x0

Definition at line 96 of file Enge.h.

References _x0.

◆ gN()

double endfieldmodel::Enge::gN	(	double	x,
		int	n ) const

Returns \(g(x)\) or its \(n^{th}\) derivative.

Here \(g(x) = 1+exp(h(x))\). Please call setEngeDiffIndices(n) before calling if n > max_index

Definition at line 69 of file Enge.cpp.

References _h, exp(), and hN().

Referenced by getEnge().

Here is the call graph for this function:

◆ hN()

double endfieldmodel::Enge::hN	(	double	x,
		int	n ) const

Returns \(h(x)\) or its \(n^{th}\) derivative.

Here \(h(x) = a_0 + a_1 x/\lambda + a_2 x^2/lambda^2 + \ldots \) Please call setEngeDiffIndices(n) before calling if n > max_index

Definition at line 58 of file Enge.cpp.

References _a, and _lambda.

Referenced by gN().

◆ operator=()

Enge & endfieldmodel::Enge::operator= ( const Enge & enge )

private

References Enge().

Here is the call graph for this function:

◆ print()

std::ostream & endfieldmodel::Enge::print ( std::ostream & out ) const

virtual

Print human-readable version of enge

Implements endfieldmodel::EndFieldModel.

Definition at line 167 of file Enge.cpp.

References _a, _lambda, and _x0.

◆ rescale()

void endfieldmodel::Enge::rescale ( double scaleFactor )

virtual

Rescale so Enge(x) -> Enge(scaleFactor*x)

Sets x0 to scaleFactor*x0 and lambda to scaleFactor*lambda

Implements endfieldmodel::EndFieldModel.

Definition at line 162 of file Enge.cpp.

References _lambda, and _x0.

◆ setCoefficients()

void endfieldmodel::Enge::setCoefficients ( std::vector< double > a )

inline

Sets the enge polynomial coefficients (a_i)

Definition at line 87 of file Enge.h.

References _a, and a.

◆ setEndFieldModel()

void endfieldmodel::EndFieldModel::setEndFieldModel	(	std::string	name,
		std::shared_ptr< EndFieldModel >	efm )

staticinherited

Add a value to the lookup table

Parameters

name	name of the EndFieldModel. If name already exists in the map, it is overwritten with the new value.
efm	shared_ptr to the EndFieldModel.

Definition at line 72 of file EndFieldModel.cpp.

References efm_map, and name.

Referenced by OpalScalingFFAMagnet::setupDefaultEndField(), OpalAsymmetricEnge::update(), and OpalEnge::update().

◆ setEngeDiffIndices()

void endfieldmodel::Enge::setEngeDiffIndices ( size_t n )

static

Recursively calculate the indices for Enge and H

This will calculate the indices for Enge and H that are required to calculate the differential up to order n.

Definition at line 91 of file Enge.cpp.

References _h, _q, and endfieldmodel::CompactVector().

Referenced by Enge(), endfieldmodel::AsymmetricEnge::setMaximumDerivative(), and setMaximumDerivative().

Here is the call graph for this function:

◆ setLambda()

void endfieldmodel::Enge::setLambda ( double lambda )

inline

Sets the value of lambda

Definition at line 93 of file Enge.h.

References _lambda.

◆ setMaximumDerivative()

void endfieldmodel::Enge::setMaximumDerivative ( size_t n )

inlinevirtual

Calls setEngeDiffIndices to set the maximum derivative

Implements endfieldmodel::EndFieldModel.

Definition at line 151 of file Enge.h.

References setEngeDiffIndices().

Here is the call graph for this function:

◆ setX0()

void endfieldmodel::Enge::setX0 ( double x0 )

inline

Sets the value of x0

Definition at line 99 of file Enge.h.

References _x0.

Member Data Documentation

◆ _a

std::vector<double> endfieldmodel::Enge::_a

private

Definition at line 142 of file Enge.h.

Referenced by clone(), Enge(), Enge(), getCoefficients(), hN(), print(), and setCoefficients().

◆ _h

std::vector< std::vector< std::vector< int > > > endfieldmodel::Enge::_h

staticprivate

Indexes the derivatives of g in terms of h

Definition at line 148 of file Enge.h.

Referenced by getHIndex(), gN(), and setEngeDiffIndices().

◆ _lambda

double endfieldmodel::Enge::_lambda

private

Definition at line 143 of file Enge.h.

Referenced by clone(), Enge(), Enge(), getEndLength(), getLambda(), hN(), print(), rescale(), and setLambda().

◆ _q

std::vector< std::vector< std::vector< int > > > endfieldmodel::Enge::_q

staticprivate

Indexes the derivatives of enge in terms of g

Definition at line 146 of file Enge.h.

Referenced by getQIndex(), and setEngeDiffIndices().

◆ _x0

double endfieldmodel::Enge::_x0

private

Definition at line 143 of file Enge.h.

Referenced by clone(), Enge(), getCentreLength(), getDoubleEnge(), getX0(), print(), rescale(), and setX0().

◆ efm_map

std::map< std::string, std::shared_ptr< EndFieldModel > > endfieldmodel::EndFieldModel::efm_map

staticprivateinherited

Definition at line 108 of file EndFieldModel.h.

Referenced by getEndFieldModel(), getName(), and setEndFieldModel().

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

Public Member Functions

Static Public Member Functions

Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ Enge() [1/3]

◆ Enge() [2/3]

◆ ~Enge()

◆ Enge() [3/3]

Member Function Documentation

◆ clone()

◆ function()

◆ getCentreLength()

◆ getCoefficients()

◆ getDoubleEnge()

◆ getEndFieldModel()

◆ getEndLength()

◆ getEnge()

◆ getHIndex()

◆ getLambda()

◆ getName()

◆ getQIndex()

◆ getX0()

◆ gN()

◆ hN()

◆ operator=()

◆ print()

◆ rescale()

◆ setCoefficients()

◆ setEndFieldModel()

◆ setEngeDiffIndices()

◆ setLambda()

◆ setMaximumDerivative()

◆ setX0()

Member Data Documentation

◆ _a

◆ _h

◆ _lambda

◆ _q

◆ _x0

◆ efm_map