ChimeraTK-ApplicationCore  04.01.00
ChimeraTK::VariableGroup Class Reference

#include <VariableGroup.h>

+ Inheritance diagram for ChimeraTK::VariableGroup:
+ Collaboration diagram for ChimeraTK::VariableGroup:

Public Member Functions

 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. More...
 
 VariableGroup ()=default
 Default constructor: Allows late initialisation of VariableGroups (e.g. More...
 
 VariableGroup (VariableGroup &&other) noexcept
 Move constructor. More...
 
 VariableGroup (const VariableGroup &other) noexcept=delete
 
VariableGroupoperator= (VariableGroup &&other) noexcept
 Move assignment. More...
 
VariableGroupoperator= (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. More...
 
ChimeraTK::Model::VariableGroupProxy getModel ()
 Return the application model proxy representing this module. More...
 
std::string getVirtualQualifiedName () const override
 
void unregisterModule (Module *module) override
 Unregister another module as a sub-module. More...
 
- 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. More...
 
 Module ()=default
 Default constructor: Allows late initialisation of modules (e.g. More...
 
 ~Module () override
 Destructor. More...
 
 Module (Module &&other) noexcept
 Move constructor. More...
 
Moduleoperator= (Module &&other) noexcept
 Move assignment operator. More...
 
virtual void prepare ()
 Prepare the execution of the module. More...
 
virtual void run ()
 Execute the module. More...
 
virtual void terminate ()
 Terminate the module. More...
 
ChimeraTK::ReadAnyGroup readAnyGroup ()
 Create a ChimeraTK::ReadAnyGroup for all readable variables in this Module. More...
 
void readAll (bool includeReturnChannels=false)
 Read all readable variables in the group. More...
 
void readAllNonBlocking (bool includeReturnChannels=false)
 Just call readNonBlocking() on all readable variables in the group. More...
 
void readAllLatest (bool includeReturnChannels=false)
 Just call readLatest() on all readable variables in the group. More...
 
void writeAll (bool includeReturnChannels=false)
 Just call write() on all writable variables in the group. More...
 
void writeAllDestructively (bool includeReturnChannels=false)
 Just call writeDestructively() on all writable variables in the group. More...
 
std::string getQualifiedName () const override
 Get the fully qualified name of the module instance, i.e. More...
 
std::string getFullDescription () const override
 Obtain the full description including the full description of the owner. More...
 
void setOwner (EntityOwner *newOwner)
 Set a new owner. More...
 
EntityOwnergetOwner () const
 
VersionNumber getCurrentVersionNumber () const override
 Return the current version number which has been received with the last push-type read operation. More...
 
void setCurrentVersionNumber (VersionNumber version) override
 Set the current version number. More...
 
DataValidity getDataValidity () const override
 Return the data validity flag. More...
 
void incrementDataFaultCounter () override
 Set the data validity flag to fault and increment the fault counter. More...
 
void decrementDataFaultCounter () override
 Decrement the fault counter and set the data validity flag to ok if the counter has reached 0. More...
 
std::list< EntityOwner * > getInputModulesRecursively (std::list< EntityOwner * > startList) override
 Use pointer to the module as unique identifier. More...
 
size_t getCircularNetworkHash () const override
 Get the ID of the circular dependency network (0 if none). More...
 
ModulefindApplicationModule ()
 Find ApplicationModule owner. More...
 
void disable ()
 Disable the module such that it is not part of the Application. More...
 
- 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. More...
 
 EntityOwner ()
 Default constructor just for late initialisation. More...
 
virtual ~EntityOwner ()=default
 Virtual destructor to make the type polymorphic. More...
 
 EntityOwner (EntityOwner &&other) noexcept
 Move constructor. More...
 
 EntityOwner (const EntityOwner &other)=delete
 
EntityOwneroperator= (EntityOwner &&other) noexcept
 Move assignment operator. More...
 
EntityOwneroperator= (const EntityOwner &other)=delete
 
const std::string & getName () const
 Get the name of the module instance. More...
 
std::string getQualifiedNameWithType () const
 Get the fully qualified name of the module instance, followed by the C++ data type (in pointy brackets) More...
 
const std::string & getDescription () const
 Get the description of the module instance. More...
 
std::list< VariableNetworkNodegetAccessorList () const
 Obtain the list of accessors/variables directly associated with this instance. More...
 
std::list< Module * > getSubmoduleList () const
 Obtain the list of submodules associated with this instance. More...
 
std::list< VariableNetworkNodegetAccessorListRecursive () const
 Obtain the list of accessors/variables associated with this instance and any submodules. More...
 
std::list< Module * > getSubmoduleListRecursive () const
 Obtain the list of submodules associated with this instance and any submodules. More...
 
void registerAccessor (VariableNetworkNode accessor)
 Called inside the constructor of Accessor: adds the accessor to the list. More...
 
void unregisterAccessor (const VariableNetworkNode &accessor)
 Called inside the destructor of Accessor: removes the accessor from the list. More...
 
void registerModule (Module *module, bool addTags=true)
 Register another module as a sub-module. More...
 
void addTag (const std::string &tag)
 Add a tag to all Application-type nodes inside this group. More...
 
void dump (const std::string &prefix="", std::ostream &stream=std::cout) const
 Print the full hierarchy to given stream. More...
 
bool hasReachedTestableMode ()
 Check whether this module has declared that it reached the testable mode. More...
 
template<typename T >
std::string constant (T value)
 Create a variable name which will be automatically connected with a constant value. More...
 

Protected Attributes

ChimeraTK::Model::VariableGroupProxy _model
 
- Protected Attributes inherited from ChimeraTK::Module
EntityOwner_owner {nullptr}
 Owner of this instance. More...
 
- Protected Attributes inherited from ChimeraTK::EntityOwner
std::string _name
 The name of this instance. More...
 
std::string _description
 The description of this instance. More...
 
std::list< VariableNetworkNode_accessorList
 List of accessors owned by this instance. More...
 
std::list< Module * > _moduleList
 List of modules owned by this instance. More...
 
std::unordered_set< std::string > _tags
 List of tags to be added to all accessors and modules inside this module. More...
 
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. More...
 

Friends

class ChimeraTK::Model::Impl
 
class ApplicationModule
 

Additional Inherited Members

- Public Types inherited from ChimeraTK::EntityOwner
enum  ModuleType {
  ModuleType::ApplicationModule, ModuleType::ModuleGroup, ModuleType::VariableGroup, ModuleType::ControlSystem,
  ModuleType::Device, ModuleType::Invalid
}
 
- Static Public Member Functions inherited from ChimeraTK::Module
static ConfigReaderappConfig ()
 Obtain the ConfigReader instance of the application. More...
 
- Static Public Attributes inherited from ChimeraTK::EntityOwner
static constexpr std::string_view namePrefixConstant {"/@CONST@"}
 Prefix for constants created by constant(). More...
 

Detailed Description

Definition at line 22 of file VariableGroup.h.

Constructor & Destructor Documentation

◆ VariableGroup() [1/4]

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.

Parameters
ownerThe owning VariableGroup or ApplicationModule.
nameName of this group. The name may be qualified (e.g. start with "../" or "/").
descriptionA short description of this group.
tagsList of tags to be attached to all owned variables (directly or indirectly).

Definition at line 13 of file VariableGroup.cc.

+ Here is the call graph for this function:

◆ VariableGroup() [2/4]

ChimeraTK::VariableGroup::VariableGroup ( )
default

Default constructor: Allows late initialisation of VariableGroups (e.g.

when creating arrays of VariableGroups).

◆ VariableGroup() [3/4]

ChimeraTK::VariableGroup::VariableGroup ( VariableGroup &&  other)
inlinenoexcept

Move constructor.

Definition at line 41 of file VariableGroup.h.

+ Here is the call graph for this function:

◆ VariableGroup() [4/4]

ChimeraTK::VariableGroup::VariableGroup ( const VariableGroup other)
deletenoexcept

Member Function Documentation

◆ getModel()

ChimeraTK::Model::VariableGroupProxy ChimeraTK::VariableGroup::getModel ( )
inline

Return the application model proxy representing this module.

Definition at line 51 of file VariableGroup.h.

+ Here is the caller graph for this function:

◆ getModuleType()

ModuleType ChimeraTK::VariableGroup::getModuleType ( ) const
inlineoverridevirtual

Return the module type of this module, or in case of a VirtualModule the module type this VirtualModule was derived from.

Implements ChimeraTK::EntityOwner.

Definition at line 48 of file VariableGroup.h.

◆ getVirtualQualifiedName()

std::string ChimeraTK::VariableGroup::getVirtualQualifiedName ( ) const
overridevirtual

Implements ChimeraTK::Module.

Definition at line 56 of file VariableGroup.cc.

+ Here is the call graph for this function:

◆ operator=() [1/2]

VariableGroup& ChimeraTK::VariableGroup::operator= ( const VariableGroup other)
deletenoexcept

◆ operator=() [2/2]

VariableGroup & ChimeraTK::VariableGroup::operator= ( VariableGroup &&  other)
noexcept

Move assignment.

Definition at line 38 of file VariableGroup.cc.

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ unregisterModule()

void ChimeraTK::VariableGroup::unregisterModule ( Module module)
overridevirtual

Unregister another module as a sub-module.

Will be called automatically by all modules in their destructors.

Reimplemented from ChimeraTK::EntityOwner.

Definition at line 62 of file VariableGroup.cc.

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

Friends And Related Function Documentation

◆ ApplicationModule

friend class ApplicationModule
friend

Definition at line 62 of file VariableGroup.h.

◆ ChimeraTK::Model::Impl

friend class ChimeraTK::Model::Impl
friend

Definition at line 59 of file VariableGroup.h.

Member Data Documentation

◆ _model

ChimeraTK::Model::VariableGroupProxy ChimeraTK::VariableGroup::_model
protected

Definition at line 58 of file VariableGroup.h.


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