#include <PyOpalObject.h>

Inheritance diagram for PyOpal::PyOpalObjectNS::PyOpalObject< C >:

Collaboration diagram for PyOpal::PyOpalObjectNS::PyOpalObject< C >:

Public Types
typedef PyOpalObject< C >	PyC

Public Member Functions
	PyOpalObject ()
	PyOpalObject (std::shared_ptr< C > object)
	PyOpalObject (const PyOpalObject< C > &rhs)
virtual	~PyOpalObject ()=default
boost::python::class_< PyC >	make_class (const char *className)
boost::python::class_< PyC >	make_element_class (const char *className)
boost::python::class_< PyC >	make_generic_class (const char *className)
template<class PYCLASS>
void	addAttributes (PYCLASS &pyclass)
template<class PYCLASS>
void	addExecute (PYCLASS &pyclass)
template<class PYCLASS>
void	addRegister (PYCLASS &pyclass)
template<class PYCLASS>
void	addGetOpalName (PYCLASS &pyclass)
template<class PYCLASS>
void	addSetAttributes (PYCLASS &pyclass)
template<class PYCLASS>
void	addSetOpalName (PYCLASS &pyclass)
template<class PYCLASS>
void	addSetOpalElementName (PYCLASS &pyclass)
template<class PYCLASS>
void	addGetOpalElement (PYCLASS &pyclass)
template<class PYCLASS>
void	addGetFieldValue (PYCLASS &pyclass, double distanceUnits, double timeUnits, double bfieldUnits, double efieldUnits)
template<class ValueType>
ValueType	dummyGet () const
virtual void	doSetup ()
template<class ValueType>
void	dummySet (ValueType test)
PyObject *	getAttribute (AttributeType type, std::string opalName) const
void	setAttribute (AttributeType type, std::string opalName, PyObject *value)
std::shared_ptr< C >	getOpalShared ()
std::shared_ptr< C >	getOpalShared () const
	PyOpalObject ()
void	doSetup ()
	PyOpalObject ()
void	doSetup ()
void	doSetup ()
void	doSetup ()

Protected Member Functions
std::string	getDocString (AttributeDef &def)
std::vector< PyOpalObjectNS::AttributeDef >	attributes
std::string	classDocstring
std::vector< PyOpalObjectNS::AttributeDef >	attributes
std::string	classDocstring
std::vector< PyOpalObjectNS::AttributeDef >	attributes
std::vector< PyOpalObjectNS::AttributeDef >	attributes
std::vector< PyOpalObjectNS::AttributeDef >	attributes
std::string	classDocstring
std::vector< PyOpalObjectNS::AttributeDef >	attributes
std::string	classDocstring
std::vector< PyOpalObjectNS::AttributeDef >	attributes
std::string	classDocstring
std::vector< PyOpalObjectNS::AttributeDef >	attributes
std::string	classDocstring
std::vector< PyOpalObjectNS::AttributeDef >	attributes
std::string	classDocstring
std::string	classDocstring
std::vector< PyOpalObjectNS::AttributeDef >	attributes
std::vector< PyOpalObjectNS::AttributeDef >	attributes
std::string	classDocstring
std::vector< PyOpalObjectNS::AttributeDef >	attributes
std::string	classDocstring
std::vector< PyOpalObjectNS::AttributeDef >	attributes
std::string	classDocstring
std::vector< PyOpalObjectNS::AttributeDef >	attributes
std::string	classDocstring
std::vector< PyOpalObjectNS::AttributeDef >	attributes
std::string	classDocstring
std::vector< PyOpalObjectNS::AttributeDef >	attributes
std::string	classDocstring
std::vector< PyOpalObjectNS::AttributeDef >	attributes
std::vector< PyOpalObjectNS::AttributeDef >	attributes
std::vector< PyOpalObjectNS::AttributeDef >	attributes
std::vector< PyOpalObjectNS::AttributeDef >	attributes
std::vector< PyOpalObjectNS::AttributeDef >	attributes
std::vector< PyOpalObjectNS::AttributeDef >	attributes
std::string	classDocstring

Static Protected Member Functions
static boost::python::object	getFieldValue (PyOpalObjectNS::PyOpalObject< C > &pyobject, double x, double y, double z, double t)
static std::string	getOpalName (const PyOpalObject< C > &pyobject)
static void	setOpalName (PyOpalObject< C > &pyobject, std::string name)
static void	setOpalElementName (PyOpalObject< C > &pyobject, std::string name)
static void	execute (PyOpalObject< C > &pyobject)
static void	registerObject (PyOpalObject< C > &pyobject)
static boost::python::object	getPyOpalElement (PyOpalObject< C > &pyobject)
static boost::python::object	setAttributes (boost::python::tuple args, boost::python::dict kwargs)

Protected Attributes
std::shared_ptr< C >	object_m

Static Protected Attributes
static std::vector< AttributeDef >	attributes
static std::map< std::string, AttributeDef >	pyNameToAttribute
static std::string	classDocstring
static bool	converterRegistered
static double	distanceUnits_m
static double	timeUnits_m
static double	bfieldUnits_m
static double	efieldUnits_m
static const std::string	getFieldValueDocString

Detailed Description

template<class C>
class PyOpal::PyOpalObjectNS::PyOpalObject< C >

PyOpalObject<C> is the basic wrapper class for Opal Objects

PyOpalObject<C> is a wrapper for an Opal Object C. Opal Attributes are implemented in python as properties (public member data). Some default method calls can be enabled in the concrete implementation by setting flags. Docstring can be enabled by setting classDocString.

element_m: pointer to the base element attributes: vector of attributes. The order of the vector is the order that attributes will appear in the docstring classDocString: overall docstring. docstrings on each property and method are added automatically by the framework.

property access is set up in make_class using add_property from boost::python. Normally, the "get" method can't take any data; this would mean that we can't pass an Attribute name for the OpalElement lookup. In order to get around this limitation, we have a "dummy" getter dummyGet. Then there is a "real" getter, which is hidden in the call policy for the property (a sort of pre- and post- decorator). We use PyOpalObjectGetProperty to hold the Attribute name and then dummyGet just tells PyElementGetProperty the address of the PyOpalObject. PyElementGetProperty does a postcall action to overwrite the return value with the "real" return value, based on the stored Attribute name.

Setters work in exactly the same way, except now we have dummySet and PyElementSetProperty to handle the interface.

The routine then looks like: python::boost calls dummyGet; dummyGet tells PyElementGetProperty pointer to PyOpalObject python::boost calls PyElementGetProperty.postcall PyElementGetProperty.postcall calls PyOpalObject->getAttribute; where getAttribute takes the name of the Attribute as a string. It's a bit of a faff.

Definition at line 138 of file PyOpalObject.h.

Member Typedef Documentation

◆ PyC

template<class C>

typedef PyOpalObject<C> PyOpal::PyOpalObjectNS::PyOpalObject< C >::PyC

Definition at line 140 of file PyOpalObject.h.

Constructor & Destructor Documentation

◆ PyOpalObject() [1/5]

template<class C>

PyOpal::PyOpalObjectNS::PyOpalObject< C >::PyOpalObject ( )

inline

Default constructor

Definition at line 530 of file PyOpalObject.h.

References object_m.

Referenced by PyOpal::PyLine_< TBeamline< FlaggedElmPtr > >::execute(), execute(), PyOpal::PyLine_< TBeamline< FlaggedElmPtr > >::getOpalName(), getOpalName(), PyOpal::PyLine_< TBeamline< FlaggedElmPtr > >::getPyOpalElement(), getPyOpalElement(), PyOpalObject(), PyOpal::PyLine_< TBeamline< FlaggedElmPtr > >::registerObject(), setAttributes(), PyOpal::PyLine_< TBeamline< FlaggedElmPtr > >::setOpalElementName(), setOpalElementName(), PyOpal::PyLine_< TBeamline< FlaggedElmPtr > >::setOpalName(), and setOpalName().

◆ PyOpalObject() [2/5]

template<class C>

PyOpal::PyOpalObjectNS::PyOpalObject< C >::PyOpalObject ( std::shared_ptr< C > object )

inline

Constructor taking the element as argument

Definition at line 144 of file PyOpalObject.h.

References object_m.

◆ PyOpalObject() [3/5]

template<class C>

PyOpal::PyOpalObjectNS::PyOpalObject< C >::PyOpalObject ( const PyOpalObject< C > & rhs )

Copying is disabled

Definition at line 693 of file PyOpalObject.h.

References object_m, and PyOpalObject().

Here is the call graph for this function:

◆ ~PyOpalObject()

template<class C>

virtual PyOpal::PyOpalObjectNS::PyOpalObject< C >::~PyOpalObject ( )

virtualdefault

Default destructor

◆ PyOpalObject() [4/5]

PyOpal::PyOpalObjectNS::PyOpalObject< OpalElement >::PyOpalObject ( )

◆ PyOpalObject() [5/5]

PyOpal::PyOpalObjectNS::PyOpalObject< OpalElement >::PyOpalObject ( )

Definition at line 19 of file PyOpalElement.cpp.

References object_m.

Member Function Documentation

◆ addAttributes()

template<class C>

template<class PYCLASS>

void PyOpal::PyOpalObjectNS::PyOpalObject< C >::addAttributes ( PYCLASS & pyclass )

Add attributes to the python class.

Definition at line 820 of file PyOpalObject.h.

References attributes, PyOpal::PyOpalObjectNS::BOOL, PyOpal::PyOpalObjectNS::DOUBLE, dummyGet(), dummySet(), PyOpal::PyOpalObjectNS::FLOAT_LIST, getDocString(), PyOpal::PyOpalObjectNS::INT, PyOpal::PyOpalObjectNS::PREDEFINED_STRING, pyNameToAttribute, PyOpal::PyOpalObjectNS::STRING, PyOpal::PyOpalObjectNS::STRING_LIST, and PyOpal::PyOpalObjectNS::UPPER_CASE_STRING.

Referenced by make_generic_class().

Here is the call graph for this function:

◆ addExecute()

template<class C>

template<class PYCLASS>

void PyOpal::PyOpalObjectNS::PyOpalObject< C >::addExecute ( PYCLASS & pyclass )

Add an "execute" method to the python class (e.g. if it is an ACTION)

Definition at line 761 of file PyOpalObject.h.

References execute().

Referenced by PyOpal::PyDistributionNS::BOOST_PYTHON_MODULE(), PyOpal::PyOptionNS::BOOST_PYTHON_MODULE(), and PyOpal::PyTrackRunNS::BOOST_PYTHON_MODULE().

Here is the call graph for this function:

◆ addGetFieldValue()

template<class C>

template<class PYCLASS>

void PyOpal::PyOpalObjectNS::PyOpalObject< C >::addGetFieldValue	(	PYCLASS &	pyclass,
		double	distanceUnits,
		double	timeUnits,
		double	bfieldUnits,
		double	efieldUnits )

Add a "get_field_value" method to the python class (for elements that expose a field)

PYCLASS: instance of the class to which the field is added
distanceUnits: set the distance units so that UI is in OPAL units
timeUnits: set the time units so that UI is in OPAL units
bfieldUnits: set the bfield units so that UI is in OPAL units
efieldUnits: set the efield units so that UI is in OPAL units

It is encouraged to expose the field map for field-type objects, for user to check that the field is as expected.

Note that conversion factors for units in distance, time, bfield and efield should be provided - the OPAL unit system should be exposed to user (see OPAL docs for current recommendation). Opal will call element->apply(R*distanceUnits, P, t*timeUnits, Efield, Bfield) and return Efield*efieldUnits, BField*bfield units.

Definition at line 805 of file PyOpalObject.h.

References bfieldUnits_m, distanceUnits_m, efieldUnits_m, getFieldValue(), getFieldValueDocString, and timeUnits_m.

Referenced by PyOpal::PyMultipoleT::BOOST_PYTHON_MODULE(), PyOpal::PyRingDefinition::BOOST_PYTHON_MODULE(), PyOpal::PyScalingFFAMagnet::BOOST_PYTHON_MODULE(), PyOpal::PyVariableRFCavity::BOOST_PYTHON_MODULE(), PyOpal::PyVariableRFCavityFringeField::BOOST_PYTHON_MODULE(), and PyOpal::PyVerticalFFAMagnet::BOOST_PYTHON_MODULE().

Here is the call graph for this function:

◆ addGetOpalElement()

template<class C>

template<class PYCLASS>

void PyOpal::PyOpalObjectNS::PyOpalObject< C >::addGetOpalElement ( PYCLASS & pyclass )

Add a "get_opal_element" method to the python class (to overload as a PyOpalElement)

This is required for OpalElement objects, in order that they can be used in a OPAL line object (for setting up beamlines having multiple elements). In general, if C is an OpalElement, developer should call addGetOpalElement in the module setup function.

Definition at line 799 of file PyOpalObject.h.

References getPyOpalElement().

Referenced by PyOpal::PyLineNS::BOOST_PYTHON_MODULE(), and make_element_class().

Here is the call graph for this function:

◆ addGetOpalName()

template<class C>

template<class PYCLASS>

void PyOpal::PyOpalObjectNS::PyOpalObject< C >::addGetOpalName ( PYCLASS & pyclass )

Add a get_opal_name method to the python class (to get the opal internal string that uniquely identifies the object)

Definition at line 773 of file PyOpalObject.h.

References getOpalName().

Referenced by make_generic_class().

Here is the call graph for this function:

◆ addRegister()

template<class C>

template<class PYCLASS>

void PyOpal::PyOpalObjectNS::PyOpalObject< C >::addRegister ( PYCLASS & pyclass )

Add a "register" method to the python class (to register against opal global data object)

Definition at line 767 of file PyOpalObject.h.

References registerObject().

Referenced by PyOpal::PyBeamNS::BOOST_PYTHON_MODULE().

Here is the call graph for this function:

◆ addSetAttributes()

template<class C>

template<class PYCLASS>

void PyOpal::PyOpalObjectNS::PyOpalObject< C >::addSetAttributes ( PYCLASS & pyclass )

Add a set_attributes method to the python class (to setup opalobject from a dictionary of kwargs)

Definition at line 779 of file PyOpalObject.h.

References setAttributes().

Referenced by make_generic_class().

Here is the call graph for this function:

◆ addSetOpalElementName()

template<class C>

template<class PYCLASS>

void PyOpal::PyOpalObjectNS::PyOpalObject< C >::addSetOpalElementName ( PYCLASS & pyclass )

Add a set_opal_name method to the python class (to set the opal internal string that uniquely identifies the object). This version has bindings specifically for OpalElements

Definition at line 793 of file PyOpalObject.h.

References setOpalElementName().

Referenced by make_element_class().

Here is the call graph for this function:

◆ addSetOpalName()

template<class C>

template<class PYCLASS>

void PyOpal::PyOpalObjectNS::PyOpalObject< C >::addSetOpalName ( PYCLASS & pyclass )

Add a set_opal_name method to the python class (to set the opal internal string that uniquely identifies the object)

Definition at line 787 of file PyOpalObject.h.

References setOpalName().

Referenced by make_class().

Here is the call graph for this function:

◆ attributes() [1/22]

std::vector< PyOpalObjectNS::AttributeDef > PyOpal::PyOpalObjectNS::PyOpalObject< OpalAsymmetricEnge >::attributes

protected

Definition at line 12 of file PyAsymmetricEnge.cpp.

References attributes, PyOpal::PyOpalObjectNS::DOUBLE, and PyOpal::PyOpalObjectNS::FLOAT_LIST.

◆ attributes() [2/22]

std::vector< PyOpalObjectNS::AttributeDef > PyOpal::PyOpalObjectNS::PyOpalObject< OpalEnge >::attributes

protected

Definition at line 11 of file PyEnge.cpp.

References attributes, PyOpal::PyOpalObjectNS::DOUBLE, and PyOpal::PyOpalObjectNS::FLOAT_LIST.

◆ attributes() [3/22]

std::vector< PyOpalObjectNS::AttributeDef > PyOpal::PyOpalObjectNS::PyOpalObject< OpalOffset::OpalGlobalCartesianOffset >::attributes

protected

Definition at line 11 of file PyGlobalCartesianOffset.cpp.

References attributes, and PyOpal::PyOpalObjectNS::DOUBLE.

◆ attributes() [4/22]

std::vector< PyOpalObjectNS::AttributeDef > PyOpal::PyOpalObjectNS::PyOpalObject< OpalOffset::OpalLocalCartesianOffset >::attributes

protected

Definition at line 11 of file PyLocalCartesianOffset.cpp.

References attributes, and PyOpal::PyOpalObjectNS::DOUBLE.

◆ attributes() [5/22]

std::vector< PyOpalObjectNS::AttributeDef > PyOpal::PyOpalObjectNS::PyOpalObject< OpalMultipoleT >::attributes

protected

Definition at line 41 of file PyMultipoleT.cpp.

References attributes, PyOpal::PyOpalObjectNS::BOOL, PyOpal::PyOpalObjectNS::DOUBLE, PyOpal::PyOpalObjectNS::FLOAT_LIST, and PyOpal::PyOpalObjectNS::STRING.

◆ attributes() [6/22]

std::vector< PyOpalObjectNS::AttributeDef > PyOpal::PyOpalObjectNS::PyOpalObject< OpalElement >::attributes

protected

Definition at line 11 of file PyOpalElement.cpp.

References attributes.

◆ attributes() [7/22]

std::vector< PyOpalObjectNS::AttributeDef > PyOpal::PyOpalObjectNS::PyOpalObject< OpalOutputPlane >::attributes

protected

Definition at line 24 of file PyOutputPlane.cpp.

References attributes, PyOpal::PyOpalObjectNS::DOUBLE, PyOpal::PyOpalObjectNS::FLOAT_LIST, PyOpal::PyOpalObjectNS::INT, PyOpal::PyOpalObjectNS::PREDEFINED_STRING, and PyOpal::PyOpalObjectNS::STRING.

◆ attributes() [8/22]

std::vector< PyOpalObjectNS::AttributeDef > PyOpal::PyOpalObjectNS::PyOpalObject< OpalPolynomialTimeDependence >::attributes

protected

Definition at line 11 of file PyPolynomialTimeDependence.cpp.

References attributes, PyOpal::PyOpalObjectNS::DOUBLE, and PyOpal::PyOpalObjectNS::FLOAT_LIST.

◆ attributes() [9/22]

std::vector< PyOpalObjectNS::AttributeDef > PyOpal::PyOpalObjectNS::PyOpalObject< OpalProbe >::attributes

protected

Definition at line 10 of file PyProbe.cpp.

References attributes, PyOpal::PyOpalObjectNS::DOUBLE, and PyOpal::PyOpalObjectNS::STRING.

◆ attributes() [10/22]

std::vector< PyOpalObjectNS::AttributeDef > PyOpal::PyOpalObjectNS::PyOpalObject< OpalRingDefinition >::attributes

protected

Definition at line 44 of file PyRingDefinition.cpp.

References attributes, PyOpal::PyOpalObjectNS::BOOL, PyOpal::PyOpalObjectNS::DOUBLE, and PyOpal::PyOpalObjectNS::INT.

◆ attributes() [11/22]

std::vector< PyOpalObjectNS::AttributeDef > PyOpal::PyOpalObjectNS::PyOpalObject< OpalScalingFFAMagnet >::attributes

protected

Definition at line 39 of file PyScalingFFAMagnet.cpp.

References attributes, PyOpal::PyOpalObjectNS::DOUBLE, PyOpal::PyOpalObjectNS::INT, and PyOpal::PyOpalObjectNS::STRING.

◆ attributes() [12/22]

std::vector< PyOpalObjectNS::AttributeDef > PyOpal::PyOpalObjectNS::PyOpalObject< OpalSinusoidalTimeDependence >::attributes

protected

Definition at line 28 of file PySinusoidalTimeDependence.cpp.

References attributes, and PyOpal::PyOpalObjectNS::FLOAT_LIST.

◆ attributes() [13/22]

std::vector< PyOpalObjectNS::AttributeDef > PyOpal::PyOpalObjectNS::PyOpalObject< OpalSplineTimeDependence >::attributes

protected

Definition at line 37 of file PySplineTimeDependence.cpp.

References attributes, PyOpal::PyOpalObjectNS::DOUBLE, and PyOpal::PyOpalObjectNS::FLOAT_LIST.

◆ attributes() [14/22]

std::vector< PyOpalObjectNS::AttributeDef > PyOpal::PyOpalObjectNS::PyOpalObject< OpalVariableRFCavity >::attributes

protected

Definition at line 42 of file PyVariableRFCavity.cpp.

References attributes, PyOpal::PyOpalObjectNS::DOUBLE, and PyOpal::PyOpalObjectNS::STRING.

◆ attributes() [15/22]

std::vector< PyOpalObjectNS::AttributeDef > PyOpal::PyOpalObjectNS::PyOpalObject< OpalVariableRFCavityFringeField >::attributes

protected

Definition at line 43 of file PyVariableRFCavityFringeField.cpp.

References attributes, PyOpal::PyOpalObjectNS::DOUBLE, and PyOpal::PyOpalObjectNS::STRING.

◆ attributes() [16/22]

std::vector< PyOpalObjectNS::AttributeDef > PyOpal::PyOpalObjectNS::PyOpalObject< OpalVerticalFFAMagnet >::attributes

protected

Definition at line 25 of file PyVerticalFFAMagnet.cpp.

References attributes, PyOpal::PyOpalObjectNS::DOUBLE, and PyOpal::PyOpalObjectNS::INT.

◆ attributes() [17/22]

std::vector< PyOpalObjectNS::AttributeDef > PyOpal::PyOpalObjectNS::PyOpalObject< Beam >::attributes

protected

Definition at line 26 of file PyBeam.cpp.

References attributes, PyOpal::PyOpalObjectNS::DOUBLE, and PyOpal::PyOpalObjectNS::PREDEFINED_STRING.

◆ attributes() [18/22]

std::vector< PyOpalObjectNS::AttributeDef > PyOpal::PyOpalObjectNS::PyOpalObject< Distribution >::attributes

protected

Definition at line 25 of file PyDistribution.cpp.

References attributes, PyOpal::PyOpalObjectNS::PREDEFINED_STRING, and PyOpal::PyOpalObjectNS::STRING.

◆ attributes() [19/22]

std::vector< PyOpalObjectNS::AttributeDef > PyOpal::PyOpalObjectNS::PyOpalObject< FieldSolver >::attributes

protected

Definition at line 27 of file PyFieldSolver.cpp.

References attributes, PyOpal::PyOpalObjectNS::BOOL, PyOpal::PyOpalObjectNS::DOUBLE, PyOpal::PyOpalObjectNS::PREDEFINED_STRING, and PyOpal::PyOpalObjectNS::UPPER_CASE_STRING.

◆ attributes() [20/22]

std::vector< PyOpalObjectNS::AttributeDef > PyOpal::PyOpalObjectNS::PyOpalObject< Option >::attributes

protected

Definition at line 26 of file PyOption.cpp.

References attributes, PyOpal::PyOpalObjectNS::BOOL, PyOpal::PyOpalObjectNS::DOUBLE, and PyOpal::PyOpalObjectNS::PREDEFINED_STRING.

◆ attributes() [21/22]

std::vector< PyOpalObjectNS::AttributeDef > PyOpal::PyOpalObjectNS::PyOpalObject< TrackCmd >::attributes

protected

Definition at line 25 of file PyTrackCmd.cpp.

References attributes, PyOpal::PyOpalObjectNS::DOUBLE, PyOpal::PyOpalObjectNS::FLOAT_LIST, PyOpal::PyOpalObjectNS::PREDEFINED_STRING, and PyOpal::PyOpalObjectNS::STRING.

◆ attributes() [22/22]

std::vector< PyOpalObjectNS::AttributeDef > PyOpal::PyOpalObjectNS::PyOpalObject< TrackRun >::attributes

protected

Definition at line 28 of file PyTrackRun.cpp.

References attributes, PyOpal::PyOpalObjectNS::DOUBLE, PyOpal::PyOpalObjectNS::PREDEFINED_STRING, PyOpal::PyOpalObjectNS::STRING, and PyOpal::PyOpalObjectNS::STRING_LIST.

◆ classDocstring() [1/15]

std::string PyOpal::PyOpalObjectNS::PyOpalObject< OpalAsymmetricEnge >::classDocstring

protected

Definition at line 22 of file PyAsymmetricEnge.cpp.

References classDocstring.

◆ classDocstring() [2/15]

std::string PyOpal::PyOpalObjectNS::PyOpalObject< OpalEnge >::classDocstring

protected

Definition at line 18 of file PyEnge.cpp.

References classDocstring.

◆ classDocstring() [3/15]

std::string PyOpal::PyOpalObjectNS::PyOpalObject< OpalMultipoleT >::classDocstring

protected

Definition at line 61 of file PyMultipoleT.cpp.

References classDocstring.

◆ classDocstring() [4/15]

std::string PyOpal::PyOpalObjectNS::PyOpalObject< OpalElement >::classDocstring

protected

Definition at line 14 of file PyOpalElement.cpp.

References classDocstring.

◆ classDocstring() [5/15]

std::string PyOpal::PyOpalObjectNS::PyOpalObject< OpalOutputPlane >::classDocstring

protected

Definition at line 45 of file PyOutputPlane.cpp.

References classDocstring.

◆ classDocstring() [6/15]

std::string PyOpal::PyOpalObjectNS::PyOpalObject< OpalPolynomialTimeDependence >::classDocstring

protected

Definition at line 20 of file PyPolynomialTimeDependence.cpp.

References classDocstring.

◆ classDocstring() [7/15]

std::string PyOpal::PyOpalObjectNS::PyOpalObject< OpalProbe >::classDocstring

protected

Definition at line 24 of file PyProbe.cpp.

References classDocstring.

◆ classDocstring() [8/15]

std::string PyOpal::PyOpalObjectNS::PyOpalObject< OpalRingDefinition >::classDocstring

protected

Definition at line 29 of file PyRingDefinition.cpp.

References classDocstring.

◆ classDocstring() [9/15]

std::string PyOpal::PyOpalObjectNS::PyOpalObject< OpalScalingFFAMagnet >::classDocstring

protected

Definition at line 57 of file PyScalingFFAMagnet.cpp.

References classDocstring.

◆ classDocstring() [10/15]

std::string PyOpal::PyOpalObjectNS::PyOpalObject< OpalSinusoidalTimeDependence >::classDocstring

protected

Definition at line 36 of file PySinusoidalTimeDependence.cpp.

References classDocstring.

◆ classDocstring() [11/15]

std::string PyOpal::PyOpalObjectNS::PyOpalObject< OpalSplineTimeDependence >::classDocstring

protected

Definition at line 44 of file PySplineTimeDependence.cpp.

References classDocstring.

◆ classDocstring() [12/15]

std::string PyOpal::PyOpalObjectNS::PyOpalObject< OpalVariableRFCavity >::classDocstring

protected

Definition at line 52 of file PyVariableRFCavity.cpp.

References classDocstring.

◆ classDocstring() [13/15]

std::string PyOpal::PyOpalObjectNS::PyOpalObject< OpalVariableRFCavityFringeField >::classDocstring

protected

Definition at line 57 of file PyVariableRFCavityFringeField.cpp.

References classDocstring.

◆ classDocstring() [14/15]

std::string PyOpal::PyOpalObjectNS::PyOpalObject< OpalVerticalFFAMagnet >::classDocstring

protected

Definition at line 38 of file PyVerticalFFAMagnet.cpp.

References classDocstring.

◆ classDocstring() [15/15]

std::string PyOpal::PyOpalObjectNS::PyOpalObject< TrackRun >::classDocstring

protected

Definition at line 42 of file PyTrackRun.cpp.

References classDocstring.

◆ doSetup() [1/5]

template<class C>

virtual void PyOpal::PyOpalObjectNS::PyOpalObject< C >::doSetup ( )

inlinevirtual

Overload the method to perform any additional setup that can be made before the OpalObject is accessed, after OpalObject->update() is called.

Definition at line 258 of file PyOpalObject.h.

Referenced by PyOpal::PyMultipoleT::BOOST_PYTHON_MODULE(), PyOpal::PyScalingFFAMagnet::BOOST_PYTHON_MODULE(), PyOpal::PyVariableRFCavity::BOOST_PYTHON_MODULE(), PyOpal::PyVariableRFCavityFringeField::BOOST_PYTHON_MODULE(), and getFieldValue().

◆ doSetup() [2/5]

void PyOpal::PyOpalObjectNS::PyOpalObject< OpalMultipoleT >::doSetup ( )

Overload this method on the PyOpalObject - it is supposed to be called every time the cavity is updated (i.e. every time get_field_value is called from python).

The point is the TimeDependence could have changed and we redo setup just in case (terribly inefficient, but only effects python side)

Definition at line 33 of file PyMultipoleT.cpp.

References MultipoleT::initialiseTimeDepencencies(), and object_m.

Here is the call graph for this function:

◆ doSetup() [3/5]

void PyOpal::PyOpalObjectNS::PyOpalObject< OpalScalingFFAMagnet >::doSetup ( )

Overload this method on the PyOpalObject - it is supposed to be called every time the magnet is updated (i.e. every time get_field_value is called from python).

The point is the EndFieldModel could have changed and we redo setup just in case (terribly inefficient)

Definition at line 32 of file PyScalingFFAMagnet.cpp.

References object_m, and ScalingFFAMagnet::setupEndField().

Here is the call graph for this function:

◆ doSetup() [4/5]

void PyOpal::PyOpalObjectNS::PyOpalObject< OpalVariableRFCavity >::doSetup ( )

Overload this method on the PyOpalObject - it is supposed to be called every time the cavity is updated (i.e. every time get_field_value is called from python).

The point is the TimeDependence could have changed and we redo setup just in case (terribly inefficient, but only effects python side)

Definition at line 34 of file PyVariableRFCavity.cpp.

References VariableRFCavity::initialise(), and object_m.

Here is the call graph for this function:

◆ doSetup() [5/5]

void PyOpal::PyOpalObjectNS::PyOpalObject< OpalVariableRFCavityFringeField >::doSetup ( )

Overload this method on the PyOpalObject - it is supposed to be called every time the cavity is updated (i.e. every time get_field_value is called from python).

The point is the TimeDependence could have changed and we redo setup just in case (terribly inefficient, but only effects python side)

Definition at line 34 of file PyVariableRFCavityFringeField.cpp.

References VariableRFCavityFringeField::initialise(), and object_m.

Here is the call graph for this function:

◆ dummyGet()

template<class C>

template<class ValueType>

ValueType PyOpal::PyOpalObjectNS::PyOpalObject< C >::dummyGet ( ) const

inline

dummyGet sets the object ptr for PyOpalObjectGetProperty but doesn't actually do the get(...)

Definition at line 253 of file PyOpalObject.h.

References PyOpal::PyOpalObjectNS::PyOpalObjectGetProperty< C >::setObject().

Referenced by addAttributes().

Here is the call graph for this function:

◆ dummySet()

template<class C>

template<class ValueType>

void PyOpal::PyOpalObjectNS::PyOpalObject< C >::dummySet ( ValueType test )

inline

dummySet sets the element ptr for PyOpalObjectSetProperty but doesn't actually do the set(...)

Definition at line 347 of file PyOpalObject.h.

References PyOpal::PyOpalObjectNS::PyOpalObjectSetProperty< C >::setObject().

Referenced by addAttributes().

Here is the call graph for this function:

◆ execute()

template<class C>

void PyOpal::PyOpalObjectNS::PyOpalObject< C >::execute ( PyOpalObject< C > & pyobject )

staticprotected

method to call "execute" on an object

Definition at line 473 of file PyOpalObject.h.

References getOpalShared(), and PyOpalObject().

Referenced by addExecute().

Here is the call graph for this function:

◆ getAttribute()

template<class C>

PyObject * PyOpal::PyOpalObjectNS::PyOpalObject< C >::getAttribute	(	AttributeType	type,
		std::string	opalName ) const

Get the value of an attribute

type: the type expected for python
opalName: the name of the Opal Attribute Returns a PyObject holding data; INCREF is called on the object i.e. it is a new object, not borrowed.

It is an error if the Attribute does not exist (throws OpalException)

Definition at line 533 of file PyOpalObject.h.

References PyOpal::PyOpalObjectNS::attributeName, PyOpal::PyOpalObjectNS::BOOL, PyOpal::PyOpalObjectNS::DOUBLE, PyOpal::PyOpalObjectNS::FLOAT_LIST, Attributes::getBool(), Attributes::getReal(), Attributes::getRealArray(), Attributes::getString(), Attributes::getStringArray(), PyOpal::PyOpalObjectNS::INT, object_m, PyOpal::PyOpalObjectNS::PREDEFINED_STRING, PyOpal::PyOpalObjectNS::STRING, PyOpal::PyOpalObjectNS::STRING_LIST, and PyOpal::PyOpalObjectNS::UPPER_CASE_STRING.

Here is the call graph for this function:

◆ getDocString()

template<class C>

std::string PyOpal::PyOpalObjectNS::PyOpalObject< C >::getDocString ( AttributeDef & def )

protected

pointer to the element Generates a docstring from the attribute

Definition at line 697 of file PyOpalObject.h.

References PyOpal::PyOpalObjectNS::attributeName, PyOpal::PyOpalObjectNS::AttributeDef::docString_m, Attribute::getHelp(), object_m, PyOpal::PyOpalObjectNS::AttributeDef::opalName_m, PyOpal::PyOpalObjectNS::AttributeDef::pyName_m, and PyOpal::PyOpalObjectNS::AttributeDef::type_m.

Referenced by addAttributes().

Here is the call graph for this function:

◆ getFieldValue()

template<class C>

boost::python::object PyOpal::PyOpalObjectNS::PyOpalObject< C >::getFieldValue	(	PyOpalObjectNS::PyOpalObject< C > &	pyobject,
		double	x,
		double	y,
		double	z,
		double	t )

staticprotected

method to get field at a point in space-time

Definition at line 353 of file PyOpalObject.h.

References Component::apply(), bfieldUnits_m, distanceUnits_m, doSetup(), efieldUnits_m, getOpalShared(), and timeUnits_m.

Referenced by addGetFieldValue().

Here is the call graph for this function:

◆ getOpalName()

template<class C>

std::string PyOpal::PyOpalObjectNS::PyOpalObject< C >::getOpalName ( const PyOpalObject< C > & pyobject )

staticprotected

method to get the opal name of an object

Definition at line 491 of file PyOpalObject.h.

References getOpalShared(), and PyOpalObject().

Referenced by addGetOpalName().

Here is the call graph for this function:

◆ getOpalShared() [1/2]

template<class C>

std::shared_ptr< C > PyOpal::PyOpalObjectNS::PyOpalObject< C >::getOpalShared ( )

inline

Returns the Opal Object from the PyOpalObject

Definition at line 286 of file PyOpalObject.h.

References object_m.

Referenced by execute(), PyOpal::PyTrackCmdNS::executeWrapper(), PyOpal::PyAbstractTimeDependence::function(), PyOpal::PyEndFieldModel::function(), getFieldValue(), getOpalName(), getPyOpalElement(), PyOpal::PyDistributionNS::registerDistribution(), PyOpal::PyFieldSolverNS::registerFieldSolver(), registerObject(), PyOpal::PyLine_< TBeamline< FlaggedElmPtr > >::setElement(), setOpalElementName(), setOpalName(), and PyOpal::PyOpalObjectNS::update().

◆ getOpalShared() [2/2]

template<class C>

std::shared_ptr< C > PyOpal::PyOpalObjectNS::PyOpalObject< C >::getOpalShared ( ) const

inline

Returns the Opal Object from the PyOpalObject (const version)

Definition at line 289 of file PyOpalObject.h.

References object_m.

◆ getPyOpalElement()

template<class C>

boost::python::object PyOpal::PyOpalObjectNS::PyOpalObject< C >::getPyOpalElement ( PyOpalObjectNS::PyOpalObject< C > & pyobject )

staticprotected

return the underlying element (used e.g. by PyLine)

Definition at line 512 of file PyOpalObject.h.

References getOpalShared(), and PyOpalObject().

Referenced by addGetOpalElement().

Here is the call graph for this function:

◆ make_class()

template<class C>

boost::python::class_< PyOpalObject< C > > PyOpal::PyOpalObjectNS::PyOpalObject< C >::make_class ( const char * className )

inline

This is the basic method to make a class for OpalObjects. It should normally be called when the module is declared, BOOST_PYTHON_MODULE.

Note that while in principle this could be static, in the end we need an instance of C so that we can access the docString from the attribute.

Definition at line 745 of file PyOpalObject.h.

References addSetOpalName(), and make_generic_class().

Referenced by PyOpal::PyBeamNS::BOOST_PYTHON_MODULE(), PyOpal::PyDistributionNS::BOOST_PYTHON_MODULE(), PyOpal::PyEnge::BOOST_PYTHON_MODULE(), PyOpal::PyOpalPolynomialTimeDependence::BOOST_PYTHON_MODULE(), PyOpal::PyOpalSinusoidalTimeDependence::BOOST_PYTHON_MODULE(), PyOpal::PyOpalSplineTimeDependence::BOOST_PYTHON_MODULE(), PyOpal::PyOptionNS::BOOST_PYTHON_MODULE(), PyOpal::PyTrackCmdNS::BOOST_PYTHON_MODULE(), and PyOpal::PyTrackRunNS::BOOST_PYTHON_MODULE().

Here is the call graph for this function:

◆ make_element_class()

template<class C>

boost::python::class_< PyOpalObject< C > > PyOpal::PyOpalObjectNS::PyOpalObject< C >::make_element_class ( const char * className )

inline

This is the basic method to make a class for elements.

This differs from make_class(...) because the setOpalName method sets the underlying element name at the same time.

Definition at line 752 of file PyOpalObject.h.

References addGetOpalElement(), addSetOpalElementName(), and make_generic_class().

Here is the call graph for this function:

◆ make_generic_class()

template<class C>

boost::python::class_< PyOpalObject< C > > PyOpal::PyOpalObjectNS::PyOpalObject< C >::make_generic_class ( const char * className )

inline

This is the basic method to make a class for generic Opal object type.

In this one, the setOpalName method is not assigned, and user has to assign it (if they want it)

Definition at line 711 of file PyOpalObject.h.

References addAttributes(), addGetOpalName(), addSetAttributes(), gmsg, and OpalException::what().

Referenced by make_class(), and make_element_class().

Here is the call graph for this function:

◆ registerObject()

template<class C>

void PyOpal::PyOpalObjectNS::PyOpalObject< C >::registerObject ( PyOpalObjectNS::PyOpalObject< C > & pyobject )

staticprotected

method to call "register" on an object

Definition at line 479 of file PyOpalObject.h.

References OpalData::define(), OpalData::getInstance(), and getOpalShared().

Referenced by addRegister().

Here is the call graph for this function:

◆ setAttribute()

template<class C>

void PyOpal::PyOpalObjectNS::PyOpalObject< C >::setAttribute	(	AttributeType	type,
		std::string	opalName,
		PyObject *	value )

Set the value of an attribute

type: the type expected for python
opalName: the name of the Opal Attribute
value: Python object holding the value to be stored. value refcnt is not changed - caller is responsible for managing the refcnt. It is an error if the Attribute does not exist (throws OpalException)

Definition at line 610 of file PyOpalObject.h.

Referenced by setAttributes().

Here is the call graph for this function:

◆ setAttributes()

template<class C>

boost::python::object PyOpal::PyOpalObjectNS::PyOpalObject< C >::setAttributes	(	boost::python::tuple	args,
		boost::python::dict	kwargs )

staticprotected

set many attributes at once as a dict, stored in kwarg. args should be exactly equal to (self,)

Pass a dictionary of attributes to the pyobject using the python *args **kwargs semantics

Definition at line 378 of file PyOpalObject.h.

References end(), PyOpal::PyOpalObjectNS::AttributeDef::opalName_m, pyNameToAttribute, PyOpalObject(), setAttribute(), and PyOpal::PyOpalObjectNS::AttributeDef::type_m.

Referenced by addSetAttributes().

Here is the call graph for this function:

◆ setOpalElementName()

template<class C>

void PyOpal::PyOpalObjectNS::PyOpalObject< C >::setOpalElementName	(	PyOpalObject< C > &	pyobject,
		std::string	name )

staticprotected

method to set the opal name of an element - elements have two "names", one belonging to the OpalObject and one belonging to the Component

Definition at line 503 of file PyOpalObject.h.

References getOpalShared(), name, and PyOpalObject().

Referenced by addSetOpalElementName().

Here is the call graph for this function:

◆ setOpalName()

template<class C>

void PyOpal::PyOpalObjectNS::PyOpalObject< C >::setOpalName	(	PyOpalObject< C > &	pyobject,
		std::string	name )

staticprotected

method to set the opal name of an object

Definition at line 497 of file PyOpalObject.h.

References getOpalShared(), name, and PyOpalObject().

Referenced by addSetOpalName().

Here is the call graph for this function:

Member Data Documentation

◆ attributes

template<class C>

std::vector<AttributeDef> PyOpal::PyOpalObjectNS::PyOpalObject< C >::attributes

staticprotected

Definition at line 293 of file PyOpalObject.h.

Referenced by addAttributes(), and attributes().

◆ bfieldUnits_m

template<class C>

double PyOpal::PyOpalObjectNS::PyOpalObject< C >::bfieldUnits_m

staticprotected

Definition at line 325 of file PyOpalObject.h.

Referenced by addGetFieldValue(), and getFieldValue().

◆ classDocstring

template<class C>

std::string PyOpal::PyOpalObjectNS::PyOpalObject< C >::classDocstring

staticprotected

maps python name to AttributeDef for fast lookup

Definition at line 295 of file PyOpalObject.h.

Referenced by classDocstring().

◆ converterRegistered

template<class C>

bool PyOpal::PyOpalObjectNS::PyOpalObject< C >::converterRegistered

staticprotected

class docstring

Definition at line 296 of file PyOpalObject.h.

◆ distanceUnits_m

template<class C>

double PyOpal::PyOpalObjectNS::PyOpalObject< C >::distanceUnits_m

staticprotected

Definition at line 323 of file PyOpalObject.h.

Referenced by addGetFieldValue(), and getFieldValue().

◆ efieldUnits_m

template<class C>

double PyOpal::PyOpalObjectNS::PyOpalObject< C >::efieldUnits_m

staticprotected

Definition at line 326 of file PyOpalObject.h.

Referenced by addGetFieldValue(), and getFieldValue().

◆ getFieldValueDocString

template<class C>

const std::string PyOpal::PyOpalObjectNS::PyOpalObject< C >::getFieldValueDocString

staticprotected

Definition at line 327 of file PyOpalObject.h.

Referenced by addGetFieldValue().

◆ object_m

template<class C>

std::shared_ptr<C> PyOpal::PyOpalObjectNS::PyOpalObject< C >::object_m

protected

set to true if the converter has been registered

Definition at line 297 of file PyOpalObject.h.

Referenced by doSetup(), getAttribute(), getDocString(), getOpalShared(), getOpalShared(), PyOpalObject(), PyOpalObject(), PyOpalObject(), and setAttribute().

◆ pyNameToAttribute

template<class C>

std::map<std::string, AttributeDef> PyOpal::PyOpalObjectNS::PyOpalObject< C >::pyNameToAttribute

staticprotected

class data (attributes)

Definition at line 294 of file PyOpalObject.h.

Referenced by addAttributes(), and setAttributes().

◆ timeUnits_m

template<class C>

double PyOpal::PyOpalObjectNS::PyOpalObject< C >::timeUnits_m

staticprotected

Definition at line 324 of file PyOpalObject.h.

Referenced by addGetFieldValue(), and getFieldValue().

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

PyOpalObject.h

Public Types

Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Static Protected Attributes

Detailed Description

Member Typedef Documentation

◆ PyC

Constructor & Destructor Documentation

◆ PyOpalObject() [1/5]

◆ PyOpalObject() [2/5]

◆ PyOpalObject() [3/5]

◆ ~PyOpalObject()

◆ PyOpalObject() [4/5]

◆ PyOpalObject() [5/5]

Member Function Documentation

◆ addAttributes()

◆ addExecute()

◆ addGetFieldValue()

◆ addGetOpalElement()

◆ addGetOpalName()

◆ addRegister()

◆ addSetAttributes()

◆ addSetOpalElementName()

◆ addSetOpalName()

◆ attributes() [1/22]

◆ attributes() [2/22]

◆ attributes() [3/22]

◆ attributes() [4/22]

◆ attributes() [5/22]

◆ attributes() [6/22]

◆ attributes() [7/22]

◆ attributes() [8/22]

◆ attributes() [9/22]

◆ attributes() [10/22]

◆ attributes() [11/22]

◆ attributes() [12/22]

◆ attributes() [13/22]

◆ attributes() [14/22]

◆ attributes() [15/22]

◆ attributes() [16/22]

◆ attributes() [17/22]

◆ attributes() [18/22]

◆ attributes() [19/22]

◆ attributes() [20/22]

◆ attributes() [21/22]

◆ attributes() [22/22]

◆ classDocstring() [1/15]

◆ classDocstring() [2/15]

◆ classDocstring() [3/15]

◆ classDocstring() [4/15]

◆ classDocstring() [5/15]

◆ classDocstring() [6/15]

◆ classDocstring() [7/15]

◆ classDocstring() [8/15]

◆ classDocstring() [9/15]

◆ classDocstring() [10/15]

◆ classDocstring() [11/15]

◆ classDocstring() [12/15]

◆ classDocstring() [13/15]

◆ classDocstring() [14/15]

◆ classDocstring() [15/15]

◆ doSetup() [1/5]

◆ doSetup() [2/5]

◆ doSetup() [3/5]

◆ doSetup() [4/5]

◆ doSetup() [5/5]

◆ dummyGet()

◆ dummySet()

◆ execute()

◆ getAttribute()

◆ getDocString()

◆ getFieldValue()

◆ getOpalName()

◆ getOpalShared() [1/2]

◆ getOpalShared() [2/2]

◆ getPyOpalElement()

◆ make_class()

◆ make_element_class()