Generic module to pipe through a scalar value without altering it. More...

#include <Pipe.h>

Inheritance diagram for ChimeraTK::ArrayPipe< Type >:

Collaboration diagram for ChimeraTK::ArrayPipe< Type >:

Public Member Functions
	ArrayPipe (ModuleGroup *owner, const std::string &name, const std::string &unit, size_t nElements, const std::string &description, const std::unordered_set< std::string > &tagsInput={}, const std::unordered_set< std::string > &tagsOutput={})

	ArrayPipe (ModuleGroup *owner, const std::string &inputName, const std::string &outputName, const std::string &unit, size_t nElements, const std::string &description, const std::unordered_set< std::string > &tagsInput={}, const std::unordered_set< std::string > &tagsOutput={})

	ArrayPipe ()=default

void	mainLoop () override
	To be implemented by the user: function called in a separate thread executing the main loop of the module.

Public Member Functions inherited from ChimeraTK::ApplicationModule
	ApplicationModule (ModuleGroup *owner, const std::string &name, const std::string &description, const std::unordered_set< std::string > &tags={})
	Create ApplicationModule and register it with its owner.

	ApplicationModule ()=default
	Default constructor: Allows late initialisation of modules (e.g.

	ApplicationModule (ApplicationModule &&other) noexcept
	Move operation with the move constructor.

ApplicationModule &	operator= (ApplicationModule &&other) noexcept
	Move assignment.

	~ApplicationModule () override
	Destructor.

void	run () override
	Execute the module.

void	terminate () override
	Terminate the module.

ModuleType	getModuleType () const override
	Return the module type of this module, or in case of a VirtualModule the module type this VirtualModule was derived from.

VersionNumber	getCurrentVersionNumber () const override
	Return the current version number which has been received with the last push-type read operation.

DataValidity	getDataValidity () const override
	Return the data validity flag.

void	incrementDataFaultCounter () override
	Set the data validity flag to fault and increment the fault counter.

void	decrementDataFaultCounter () override
	Decrement the fault counter and set the data validity flag to ok if the counter has reached 0.

size_t	getDataFaultCounter () const
	Get the Number of inputs which report DataValidity::faulty.

void	setCurrentVersionNumber (VersionNumber versionNumber) override
	Set the current version number.

std::list< EntityOwner * >	getInputModulesRecursively (std::list< EntityOwner * > startList) override
	Use pointer to the module as unique identifier.

size_t	getCircularNetworkHash () const override
	Get the ID of the circular dependency network (0 if none).

void	setCircularNetworkHash (size_t circularNetworkHash)
	Set the ID of the circular dependency network.

ChimeraTK::Model::ApplicationModuleProxy	getModel ()
	Return the application model proxy representing this module.

void	unregisterModule (Module *module) override
	Unregister another module as a sub-module.

Logger::StreamProxy	logger (Logger::Severity severity)
	Convenicene function to obtain a logger stream with the given Severity.

Public Member Functions inherited from ChimeraTK::VariableGroup
	VariableGroup (VariableGroup *owner, const std::string &name, const std::string &description, const std::unordered_set< std::string > &tags={})
	Constructor: Create VariableGroup register it with its owner.

	VariableGroup ()=default
	Default constructor: Allows late initialisation of VariableGroups (e.g.

	VariableGroup (VariableGroup &&other) noexcept
	Move constructor.

	VariableGroup (const VariableGroup &other) noexcept=delete

VariableGroup &	operator= (VariableGroup &&other) noexcept
	Move assignment.

VariableGroup &	operator= (const VariableGroup &other) noexcept=delete

ModuleType	getModuleType () const override
	Return the module type of this module, or in case of a VirtualModule the module type this VirtualModule was derived from.

ChimeraTK::Model::VariableGroupProxy	getModel ()
	Return the application model proxy representing this module.

std::string	getVirtualQualifiedName () const override

void	unregisterModule (Module *module) override
	Unregister another module as a sub-module.

Public Member Functions inherited from ChimeraTK::Module
	Module (EntityOwner *owner, const std::string &name, const std::string &description, const std::unordered_set< std::string > &tags={})
	Constructor: Create Module by the given name with the given description and register it with its owner.

	Module ()=default
	Default constructor: Allows late initialisation of modules (e.g.

	~Module () override
	Destructor.

	Module (Module &&other) noexcept
	Move constructor.

Module &	operator= (Module &&other) noexcept
	Move assignment operator.

virtual void	postConstruct ()
	Hook function called on all Modules of an Application after the Application constructor is complete but before the PV connections are being finalised.

virtual void	prepare ()
	Prepare the execution of the module.

ChimeraTK::ReadAnyGroup	readAnyGroup ()
	Create a ChimeraTK::ReadAnyGroup for all readable variables in this Module.

void	readAll (bool includeReturnChannels=false)
	Read all readable variables in the group.

void	readAllNonBlocking (bool includeReturnChannels=false)
	Just call readNonBlocking() on all readable variables in the group.

void	readAllLatest (bool includeReturnChannels=false)
	Just call readLatest() on all readable variables in the group.

void	writeAll (bool includeReturnChannels=false)
	Just call write() on all writable variables in the group.

void	writeAllDestructively (bool includeReturnChannels=false)
	Just call writeDestructively() on all writable variables in the group.

std::string	getQualifiedName () const override
	Get the fully qualified name of the module instance, i.e.

std::string	getFullDescription () const override
	Obtain the full description including the full description of the owner.

void	setOwner (EntityOwner *newOwner)
	Set a new owner.

EntityOwner *	getOwner () const

VersionNumber	getCurrentVersionNumber () const override
	Return the current version number which has been received with the last push-type read operation.

void	setCurrentVersionNumber (VersionNumber version) override
	Set the current version number.

DataValidity	getDataValidity () const override
	Return the data validity flag.

void	incrementDataFaultCounter () override
	Set the data validity flag to fault and increment the fault counter.

void	decrementDataFaultCounter () override
	Decrement the fault counter and set the data validity flag to ok if the counter has reached 0.

std::list< EntityOwner * >	getInputModulesRecursively (std::list< EntityOwner * > startList) override
	Use pointer to the module as unique identifier.

size_t	getCircularNetworkHash () const override
	Get the ID of the circular dependency network (0 if none).

Module *	findApplicationModule ()
	Find ApplicationModule owner.

void	disable ()
	Disable the module such that it is not part of the Application.

Public Member Functions inherited from ChimeraTK::EntityOwner
	EntityOwner (std::string name, std::string description, std::unordered_set< std::string > tags={})
	Constructor: Create EntityOwner by the given name with the given description.

	EntityOwner ()
	Default constructor just for late initialisation.

virtual	~EntityOwner ()=default
	Virtual destructor to make the type polymorphic.

	EntityOwner (EntityOwner &&other) noexcept
	Move constructor.

	EntityOwner (const EntityOwner &other)=delete

EntityOwner &	operator= (EntityOwner &&other) noexcept
	Move assignment operator.

EntityOwner &	operator= (const EntityOwner &other)=delete

const std::string &	getName () const
	Get the name of the module instance.

std::string	getQualifiedNameWithType () const
	Get the fully qualified name of the module instance, followed by the C++ data type (in pointy brackets)

const std::string &	getDescription () const
	Get the description of the module instance.

std::list< VariableNetworkNode >	getAccessorList () const
	Obtain the list of accessors/variables directly associated with this instance.

std::list< Module * >	getSubmoduleList () const
	Obtain the list of submodules associated with this instance.

std::list< VariableNetworkNode >	getAccessorListRecursive () const
	Obtain the list of accessors/variables associated with this instance and any submodules.

std::list< Module * >	getSubmoduleListRecursive () const
	Obtain the list of submodules associated with this instance and any submodules.

void	registerAccessor (VariableNetworkNode accessor)
	Called inside the constructor of Accessor: adds the accessor to the list.

void	unregisterAccessor (const VariableNetworkNode &accessor)
	Called inside the destructor of Accessor: removes the accessor from the list.

void	registerModule (Module *module, bool addTags=true)
	Register another module as a sub-module.

void	addTag (const std::string &tag)
	Add a tag to all Application-type nodes inside this group.

void	dump (const std::string &prefix="", std::ostream &stream=std::cout) const
	Print the full hierarchy to given stream.

bool	hasReachedTestableMode ()
	Check whether this module has declared that it reached the testable mode.

template<typename T >
std::string	constant (T value)
	Create a variable name which will be automatically connected with a constant value.

Public Attributes
ArrayPushInput< Type >	input

ArrayOutput< Type >	output

Additional Inherited Members
Public Types inherited from ChimeraTK::EntityOwner
enum class	ModuleType { ApplicationModule , ModuleGroup , VariableGroup , ControlSystem , Device , Invalid }

Static Public Member Functions inherited from ChimeraTK::Module
static ConfigReader &	appConfig ()
	Obtain the ConfigReader instance of the application.

Static Public Attributes inherited from ChimeraTK::EntityOwner
static constexpr std::string_view	namePrefixConstant {"/@CONST@"}
	Prefix for constants created by constant().

Protected Member Functions inherited from ChimeraTK::ApplicationModule
void	mainLoopWrapper ()
	Wrapper around mainLoop(), to execute additional tasks in the thread before entering the main loop.

std::string	className ()
	Name of the module class, used for logging and debugging purposes.

Protected Attributes inherited from ChimeraTK::ApplicationModule
boost::thread	_moduleThread
	The thread executing mainLoop()

VersionNumber	_currentVersionNumber {nullptr}
	Version number of last push-type read operation - will be passed on to any write operations.

std::atomic< size_t >	_dataFaultCounter {0}
	Number of inputs which report DataValidity::faulty.

size_t	_circularNetworkHash {0}
	Unique ID for the circular dependency network.

detail::CircularDependencyDetectionRecursionStopper	_recursionStopper
	Helper needed to stop the recursion when detecting circular dependency networks.

ChimeraTK::Model::ApplicationModuleProxy	_model

Protected Attributes inherited from ChimeraTK::VariableGroup
ChimeraTK::Model::VariableGroupProxy	_model

Protected Attributes inherited from ChimeraTK::Module
EntityOwner *	_owner {nullptr}
	Owner of this instance.

Protected Attributes inherited from ChimeraTK::EntityOwner
std::string	_name
	The name of this instance.

std::string	_description
	The description of this instance.

std::list< VariableNetworkNode >	_accessorList
	List of accessors owned by this instance.

std::list< Module * >	_moduleList
	List of modules owned by this instance.

std::unordered_set< std::string >	_tags
	List of tags to be added to all accessors and modules inside this module.

std::atomic< bool >	_testableModeReached {false}
	Flag used by the testable mode to identify whether a thread within the EntityOwner has reached the point where the testable mode lock is acquired.

Detailed Description

template<typename Type>
struct ChimeraTK::ArrayPipe< Type >

Generic module to pipe through a scalar value without altering it.

Todo:: Make it more efficient by removing this module entirely in the ApplicationCore connection logic!

Definition at line 53 of file Pipe.h.

Constructor & Destructor Documentation

◆ ArrayPipe() [1/3]

template<typename Type >

ChimeraTK::ArrayPipe< Type >::ArrayPipe	(	ModuleGroup *	owner,
		const std::string &	name,
		const std::string &	unit,
		size_t	nElements,
		const std::string &	description,
		const std::unordered_set< std::string > &	tagsInput = `{}`,
		const std::unordered_set< std::string > &	tagsOutput = `{}`
	)

inline

Definition at line 54 of file Pipe.h.

◆ ArrayPipe() [2/3]

template<typename Type >

ChimeraTK::ArrayPipe< Type >::ArrayPipe	(	ModuleGroup *	owner,
		const std::string &	inputName,
		const std::string &	outputName,
		const std::string &	unit,
		size_t	nElements,
		const std::string &	description,
		const std::unordered_set< std::string > &	tagsInput = `{}`,
		const std::unordered_set< std::string > &	tagsOutput = `{}`
	)

inline

Definition at line 62 of file Pipe.h.

◆ ArrayPipe() [3/3]

template<typename Type >

ChimeraTK::ArrayPipe< Type >::ArrayPipe ( )

default

Member Function Documentation

◆ mainLoop()

template<typename Type >

void ChimeraTK::ArrayPipe< Type >::mainLoop ( )

inlineoverridevirtual

To be implemented by the user: function called in a separate thread executing the main loop of the module.

Implements ChimeraTK::ApplicationModule.

Definition at line 75 of file Pipe.h.

Member Data Documentation

◆ input

template<typename Type >

ArrayPushInput<Type> ChimeraTK::ArrayPipe< Type >::input

Definition at line 72 of file Pipe.h.

◆ output

template<typename Type >

ArrayOutput<Type> ChimeraTK::ArrayPipe< Type >::output

Definition at line 73 of file Pipe.h.

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

/scratch/dragon/sources/ChimeraTK-ApplicationCore/Modules/include/Pipe.h

Public Member Functions

Public Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ArrayPipe() [1/3]

◆ ArrayPipe() [2/3]

◆ ArrayPipe() [3/3]

Member Function Documentation

◆ mainLoop()

Member Data Documentation

◆ input

◆ output