#include <ArmarXCore/core/application/properties/PropertyDefinitionContainer.h>

Inheritance diagram for PropertyDefinitionContainer:

Public Types
typedef std::map< std::string, PropertyDefinitionBase * >	DefinitionContainer

Public Member Functions
template<typename PropertyType >
void	component (IceInternal::ProxyHandle< PropertyType > &setter, const std::string &default_name="", const std::string &property_name="", const std::string &description="")

template<typename PropertyType >
PropertyDefinition< PropertyType > &	defineOptionalProperty (const std::string &name, PropertyType defaultValue, const std::string &description="", PropertyDefinitionBase::PropertyConstness constness=PropertyDefinitionBase::eConstant)

template<typename EigenVectorType >
PropertyDefinition< EigenVectorType > &	defineOptionalPropertyVector (const std::string &name, EigenVectorType defaultValue, const std::string &description, char delimiter)

template<typename EigenVectorType >
PropertyDefinition< EigenVectorType > &	defineOptionalPropertyVector (const std::string &name, EigenVectorType defaultValue, const std::string &description, char delimiter, PropertyDefinitionBase::PropertyConstness constness)

template<typename EigenVectorType >
PropertyDefinition< EigenVectorType > &	defineOptionalPropertyVector (const std::string &name, EigenVectorType defaultValue, const std::string &description="", const std::string &delimiter=" ", PropertyDefinitionBase::PropertyConstness constness=PropertyDefinitionBase::eConstant)
	Define a required property for an Eigen vector type. More...

template<typename PropertyType >
PropertyDefinition< PropertyType > &	defineRequiredProperty (const std::string &name, const std::string &description="", PropertyDefinitionBase::PropertyConstness constness=PropertyDefinitionBase::eConstant)

template<typename EigenVectorType >
PropertyDefinition< EigenVectorType > &	defineRequiredPropertyVector (const std::string &name, const std::string &description, char delimiter)

template<typename EigenVectorType >
PropertyDefinition< EigenVectorType > &	defineRequiredPropertyVector (const std::string &name, const std::string &description, char delimiter, PropertyDefinitionBase::PropertyConstness constness)

template<typename EigenVectorType >
PropertyDefinition< EigenVectorType > &	defineRequiredPropertyVector (const std::string &name, const std::string &description="", const std::string &delimiter=" ", PropertyDefinitionBase::PropertyConstness constness=PropertyDefinitionBase::eConstant)
	Define a required property for an Eigen vector type. More...

PropertyDefinitionBase *	getDefinitionBase (const std::string &name)

template<typename PropertyType >
PropertyDefinition< PropertyType > &	getDefintion (const std::string &name)

std::string	getDescription () const
	Returns the detailed description of the property user. More...

std::string	getPrefix ()

Ice::PropertiesPtr	getProperties ()

std::map< std::string, std::string >	getPropertyValues (const std::string &prefix="") const

std::map< std::string, ProxyPropertyDefinitionBase * >	getProxyDefinitions ()

std::vector< std::string >	getSubscribedTopicDefinitions ()

std::string	getValue (const std::string &name)

bool	hasDefinition (const std::string &name) const

bool	isPropertySet (const std::string &name)

template<typename PropertyType >
decltype(auto)	optional (PropertyType &setter, const std::string &name, const std::string &description="", PropertyDefinitionBase::PropertyConstness constness=PropertyDefinitionBase::eConstant)

	PropertyDefinitionContainer (const std::string &prefix)

template<typename PropertyType >
decltype(auto)	required (PropertyType &setter, const std::string &name, const std::string &description="", PropertyDefinitionBase::PropertyConstness constness=PropertyDefinitionBase::eConstant)

template<typename PropertyType >
decltype(auto)	requiredOrOptional (bool isRequired, PropertyType &setter, const std::string &name, const std::string &description="", PropertyDefinitionBase::PropertyConstness constness=PropertyDefinitionBase::eConstant)

void	setDescription (const std::string &description)
	Sets the detailed description of the property user. More...

void	setPrefix (std::string prefix)

void	setProperties (Ice::PropertiesPtr properties)

template<typename PropertyType >
void	topic (IceInternal::ProxyHandle< PropertyType > &setter, const std::string &default_name="", const std::string &property_name="", const std::string &description="")
	Define a property to set the name of a topic which is subscribed to. More...

template<typename PropertyType >
void	topic (std::string default_name="", std::string property_name="", std::string description="")
	Define a topic which is offered from the component via the template parameter. More...

std::string	toString (PropertyDefinitionFormatter &formatter)

void	writeProxyValues (IceManagerPtr)

void	writeValues ()

	~PropertyDefinitionContainer () override

Static Public Member Functions
template<typename EigenVectorType >
static EigenVectorType	eigenVectorFactoryFunction (std::string string, std::string delim)
	Parses `string` to an Eigen vector of type `EigenVectorType`. More...

static std::string	eigenVectorPropertyDescription (const std::string &description, long size, std::string delim)

template<typename EigenVectorType >
static std::string	eigenVectorToString (const EigenVectorType &vector, std::string delim)

Protected Attributes
std::string	briefDescription
	PropertyUser brief description. More...

DefinitionContainer	definitions
	Property definitions container. More...

std::string	description
	Property User description. More...

std::string	prefix
	Prefix of the properties such as namespace, domain, component name, etc. More...

Ice::PropertiesPtr	properties

std::map< std::string, ProxyPropertyDefinitionBase * >	proxies

std::vector< std::string >	subscribedTopics

Detailed Description

PropertyDefinitionContainer.

Definition at line 53 of file PropertyDefinitionContainer.h.

Member Typedef Documentation

◆ DefinitionContainer

typedef std::map<std::string, PropertyDefinitionBase*> DefinitionContainer

Definition at line 58 of file PropertyDefinitionContainer.h.

Constructor & Destructor Documentation

◆ PropertyDefinitionContainer()

PropertyDefinitionContainer ( const std::string & prefix )

Definition at line 54 of file PropertyDefinitionContainer.cpp.

Here is the call graph for this function:

◆ ~PropertyDefinitionContainer()

~PropertyDefinitionContainer ( )

override

Definition at line 62 of file PropertyDefinitionContainer.cpp.

Member Function Documentation

◆ component()

void component	(	IceInternal::ProxyHandle< PropertyType > &	setter,
		const std::string &	default_name = `""`,
		const std::string &	property_name = `""`,
		const std::string &	description = `""`
	)

Definition at line 404 of file PropertyDefinitionContainer.h.

Here is the caller graph for this function:

◆ defineOptionalProperty()

PropertyDefinition< PropertyType > & defineOptionalProperty	(	const std::string &	name,
		PropertyType	defaultValue,
		const std::string &	description = `""`,
		PropertyDefinitionBase::PropertyConstness	constness = `PropertyDefinitionBase::eConstant`
	)

Definition at line 533 of file PropertyDefinitionContainer.h.

Here is the caller graph for this function:

◆ defineOptionalPropertyVector() [1/3]

PropertyDefinition<EigenVectorType>& defineOptionalPropertyVector	(	const std::string &	name,
		EigenVectorType	defaultValue,
		const std::string &	description,
		char	delimiter
	)

inline

Definition at line 248 of file PropertyDefinitionContainer.h.

◆ defineOptionalPropertyVector() [2/3]

PropertyDefinition<EigenVectorType>& defineOptionalPropertyVector	(	const std::string &	name,
		EigenVectorType	defaultValue,
		const std::string &	description,
		char	delimiter,
		PropertyDefinitionBase::PropertyConstness	constness
	)

inline

Definition at line 241 of file PropertyDefinitionContainer.h.

◆ defineOptionalPropertyVector() [3/3]

PropertyDefinition< EigenVectorType > & defineOptionalPropertyVector	(	const std::string &	name,
		EigenVectorType	defaultValue,
		const std::string &	description = `""`,
		const std::string &	delimiter = `" "`,
		PropertyDefinitionBase::PropertyConstness	constness = `PropertyDefinitionBase::eConstant`
	)

Define a required property for an Eigen vector type.

The EigenVectorType can be any Eigen::Vector type, (Vector3f, VectorXd, ...).

Parameters

delimiter the delimiter between vector coefficients in the string representation

Usage example:

// Definition
 // defaults to "0 0 0", accepts e.g. "1.0 2.0 3.0" and "1.0 -.3 .5"
 defineOptionalPropertyVector<Eigen::Vector3f>(
     "Position", Eigen::Vector3f::Zero(), "The position.");
 // defaults to "640x480", accepts e.g. "1920x1080"
 defineOptionalPropertyVector<Eigen::Vector2i>(
     "Resolution", Eigen::Vector2f(640, 480), "The resolution.", 'x');
 // defaults to "0,1,2,3,4,5,6,7,8,9", accepts e.g. "1" or "1,2,3"
 Eigen::VectorXd valuesDefault(10);
 valuesDefault << 0, 1, 2, 3, 4, 5, 6, 7, 8, 9;
 defineOptionalPropertyVector<Eigen::VectorXd>(
     "Values", valuesDefault, "The values.", ',');
 
// Usage:
 Eigen::Vector3f position = getProperty<Eigen::Vector3f>("Position");
 Eigen::Vector2i resolution = getProperty<Eigen::Vector2i>("Resolution");
 Eigen::VectorXd values = getProperty<Eigen::VectorXd>("Values");
 // .getValue() can trigger Eigen's implicit conversion
 Eigen::VectorXf positionX = getProperty<Eigen::VectorXf>("Position").getValue();
 
// Specification on command line:
 ./<binary> --ArmarX.<ComponentName>.Position="1 2 3"

Definition at line 581 of file PropertyDefinitionContainer.h.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ defineRequiredProperty()

PropertyDefinition< PropertyType > & defineRequiredProperty	(	const std::string &	name,
		const std::string &	description = `""`,
		PropertyDefinitionBase::PropertyConstness	constness = `PropertyDefinitionBase::eConstant`
	)

Definition at line 516 of file PropertyDefinitionContainer.h.

Here is the caller graph for this function:

◆ defineRequiredPropertyVector() [1/3]

PropertyDefinition<EigenVectorType>& defineRequiredPropertyVector	(	const std::string &	name,
		const std::string &	description,
		char	delimiter
	)

inline

Definition at line 194 of file PropertyDefinitionContainer.h.

◆ defineRequiredPropertyVector() [2/3]

PropertyDefinition<EigenVectorType>& defineRequiredPropertyVector	(	const std::string &	name,
		const std::string &	description,
		char	delimiter,
		PropertyDefinitionBase::PropertyConstness	constness
	)

inline

Definition at line 187 of file PropertyDefinitionContainer.h.

◆ defineRequiredPropertyVector() [3/3]

PropertyDefinition< EigenVectorType > & defineRequiredPropertyVector	(	const std::string &	name,
		const std::string &	description = `""`,
		const std::string &	delimiter = `" "`,
		PropertyDefinitionBase::PropertyConstness	constness = `PropertyDefinitionBase::eConstant`
	)

Define a required property for an Eigen vector type.

The EigenVectorType can be any Eigen::Vector type, (Vector3f, VectorXd, ...).

Parameters

delimiter the delimiter between vector coefficients in the string representation

Usage example:

// Definition
 // accepts e.g. "1.0 2.0 3.0" and "1.0 -.3 .5"
 defineRequiredPropertyVector<Eigen::Vector3f>("Position", "The position.");
 // accepts e.g. "640x480" and "1920x1080"
 defineRequiredPropertyVector<Eigen::Vector2i>("Resolution", "The resolution.", 'x');
 // accepts e.g. "0,1,2,3,4,5,6,7,8,9" and "1"
 defineRequiredPropertyVector<Eigen::VectorXd>("Values", "The values.", ',');
 
// Usage:
 Eigen::Vector3f position = getProperty<Eigen::Vector3f>("Position");
 Eigen::Vector2i resolution = getProperty<Eigen::Vector2i>("Resolution");
 Eigen::VectorXd values = getProperty<Eigen::VectorXd>("Values");
 // .getValue() can trigger Eigen's implicit conversion
 Eigen::VectorXf positionX = getProperty<Eigen::VectorXf>("Position").getValue();
 
// Specification on command line:
 ./<binary> --ArmarX.<ComponentName>.Position="1 2 3"

Definition at line 555 of file PropertyDefinitionContainer.h.

Here is the call graph for this function:

◆ eigenVectorFactoryFunction()

EigenVectorType eigenVectorFactoryFunction	(	std::string	string,
		std::string	delim
	)

static

Parses string to an Eigen vector of type EigenVectorType.

Parameters

delim The delimiter between coefficients.

Exceptions

std::bad_cast If parsing string fails.

Definition at line 645 of file PropertyDefinitionContainer.h.

Here is the call graph for this function:

◆ eigenVectorPropertyDescription()

std::string eigenVectorPropertyDescription	(	const std::string &	description,
		long	size,
		std::string	delim
	)

static

Definition at line 261 of file PropertyDefinitionContainer.cpp.

Here is the caller graph for this function:

◆ eigenVectorToString()

std::string eigenVectorToString	(	const EigenVectorType &	vector,
		std::string	delim
	)

static

Definition at line 686 of file PropertyDefinitionContainer.h.

◆ getDefinitionBase()

PropertyDefinitionBase * getDefinitionBase ( const std::string & name )

Definition at line 137 of file PropertyDefinitionContainer.cpp.

◆ getDefintion()

PropertyDefinition< PropertyType > & getDefintion ( const std::string & name )

Definition at line 610 of file PropertyDefinitionContainer.h.

◆ getDescription()

std::string getDescription ( ) const

Returns the detailed description of the property user.

Returns: detailed description text

Definition at line 192 of file PropertyDefinitionContainer.cpp.

◆ getPrefix()

std::string getPrefix ( )

Definition at line 207 of file PropertyDefinitionContainer.cpp.

Here is the caller graph for this function:

◆ getProperties()

Ice::PropertiesPtr getProperties ( )

Definition at line 124 of file PropertyDefinitionContainer.cpp.

◆ getPropertyValues()

std::map< std::string, std::string > getPropertyValues ( const std::string & prefix = "" ) const

Definition at line 230 of file PropertyDefinitionContainer.cpp.

Here is the call graph for this function:

◆ getProxyDefinitions()

std::map< std::string, ProxyPropertyDefinitionBase * > getProxyDefinitions ( )

Definition at line 111 of file PropertyDefinitionContainer.cpp.

◆ getSubscribedTopicDefinitions()

std::vector< std::string > getSubscribedTopicDefinitions ( )

Definition at line 118 of file PropertyDefinitionContainer.cpp.

◆ getValue()

std::string getValue ( const std::string & name )

Definition at line 218 of file PropertyDefinitionContainer.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ hasDefinition()

bool hasDefinition ( const std::string & name ) const

inline

Definition at line 259 of file PropertyDefinitionContainer.h.

◆ isPropertySet()

bool isPropertySet ( const std::string & name )

Definition at line 212 of file PropertyDefinitionContainer.cpp.

Here is the call graph for this function:

◆ optional()

decltype(auto) optional	(	PropertyType &	setter,
		const std::string &	name,
		const std::string &	description = `""`,
		PropertyDefinitionBase::PropertyConstness	constness = `PropertyDefinitionBase::eConstant`
	)

inline

Definition at line 84 of file PropertyDefinitionContainer.h.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ required()

decltype(auto) required	(	PropertyType &	setter,
		const std::string &	name,
		const std::string &	description = `""`,
		PropertyDefinitionBase::PropertyConstness	constness = `PropertyDefinitionBase::eConstant`
	)

inline

Definition at line 74 of file PropertyDefinitionContainer.h.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ requiredOrOptional()

decltype(auto) requiredOrOptional	(	bool	isRequired,
		PropertyType &	setter,
		const std::string &	name,
		const std::string &	description = `""`,
		PropertyDefinitionBase::PropertyConstness	constness = `PropertyDefinitionBase::eConstant`
	)

Here is the caller graph for this function:

◆ setDescription()

void setDescription ( const std::string & description )

Sets the detailed description of the property user.

Parameters

description detailed description text

Definition at line 197 of file PropertyDefinitionContainer.cpp.

Here is the caller graph for this function:

◆ setPrefix()

void setPrefix ( std::string prefix )

Definition at line 202 of file PropertyDefinitionContainer.cpp.

Here is the caller graph for this function:

◆ setProperties()

void setProperties ( Ice::PropertiesPtr properties )

Definition at line 130 of file PropertyDefinitionContainer.cpp.

◆ topic() [1/2]

void topic	(	IceInternal::ProxyHandle< PropertyType > &	setter,
		const std::string &	default_name = `""`,
		const std::string &	property_name = `""`,
		const std::string &	description = `""`
	)

Define a property to set the name of a topic which is subscribed to.

This defines property to set the name of a topic of the given type from setter. Before Component::onInitComponent(), the component will subscribe to this topic, and before Component::onConnectComponent(), the topic proxy will be written into setter.

Definition at line 416 of file PropertyDefinitionContainer.h.

Here is the caller graph for this function:

◆ topic() [2/2]

void topic	(	std::string	default_name = `""`,
		std::string	property_name = `""`,
		std::string	description = `""`
	)

Define a topic which is offered from the component via the template parameter.

Sane defaults will be chosen for the property name and the default values depending on the template parameter, but these values can all be overridden with the parameters.

Definition at line 428 of file PropertyDefinitionContainer.h.

◆ toString()

std::string toString ( PropertyDefinitionFormatter & formatter )

Definition at line 150 of file PropertyDefinitionContainer.cpp.

Here is the call graph for this function:

◆ writeProxyValues()

void writeProxyValues ( IceManagerPtr ice_manager )

Definition at line 92 of file PropertyDefinitionContainer.cpp.

Here is the call graph for this function:

◆ writeValues()

void writeValues ( )

Definition at line 79 of file PropertyDefinitionContainer.cpp.

Here is the call graph for this function:

Member Data Documentation

◆ briefDescription

std::string briefDescription

protected

PropertyUser brief description.

Definition at line 343 of file PropertyDefinitionContainer.h.

◆ definitions

DefinitionContainer definitions

protected

Property definitions container.

Definition at line 323 of file PropertyDefinitionContainer.h.

◆ description

std::string description

protected

Property User description.

Definition at line 338 of file PropertyDefinitionContainer.h.

◆ prefix

std::string prefix

protected

Prefix of the properties such as namespace, domain, component name, etc.

Definition at line 333 of file PropertyDefinitionContainer.h.

◆ properties

Ice::PropertiesPtr properties

protected

Definition at line 345 of file PropertyDefinitionContainer.h.

◆ proxies

std::map<std::string, ProxyPropertyDefinitionBase*> proxies

protected

Definition at line 325 of file PropertyDefinitionContainer.h.

◆ subscribedTopics

std::vector<std::string> subscribedTopics

protected

Definition at line 327 of file PropertyDefinitionContainer.h.

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

ArmarXCore/core/application/properties/PropertyDefinitionContainer.h
ArmarXCore/core/application/properties/PropertyDefinitionContainer.cpp

Public Types

Public Member Functions

Static Public Member Functions

Protected Attributes

Detailed Description

Member Typedef Documentation

◆ DefinitionContainer

Constructor & Destructor Documentation

◆ PropertyDefinitionContainer()

◆ ~PropertyDefinitionContainer()

Member Function Documentation

◆ component()

◆ defineOptionalProperty()

◆ defineOptionalPropertyVector() [1/3]

◆ defineOptionalPropertyVector() [2/3]

◆ defineOptionalPropertyVector() [3/3]

◆ defineRequiredProperty()

◆ defineRequiredPropertyVector() [1/3]

◆ defineRequiredPropertyVector() [2/3]

◆ defineRequiredPropertyVector() [3/3]

◆ eigenVectorFactoryFunction()

◆ eigenVectorPropertyDescription()

◆ eigenVectorToString()

◆ getDefinitionBase()

◆ getDefintion()

◆ getDescription()

◆ getPrefix()

◆ getProperties()

◆ getPropertyValues()

◆ getProxyDefinitions()

◆ getSubscribedTopicDefinitions()

◆ getValue()

◆ hasDefinition()

◆ isPropertySet()

◆ optional()

◆ required()

◆ requiredOrOptional()

◆ setDescription()

◆ setPrefix()

◆ setProperties()

◆ topic() [1/2]

◆ topic() [2/2]

◆ toString()

◆ writeProxyValues()

◆ writeValues()

Member Data Documentation

◆ briefDescription

◆ definitions

◆ description

◆ prefix

◆ properties

◆ proxies

◆ subscribedTopics