API 4.4.1-2022-10-19-2c4045e59
For MATLAB, Python, Java, and C++ users
OpenSim::PropertyDblVec_< M > Class Template Reference

Class PropertyDblVec_ extends class Property. More...

+ Inheritance diagram for OpenSim::PropertyDblVec_< M >:

Public Member Functions

 PropertyDblVec_ ()
 Default constructor. More...
 
 PropertyDblVec_ (const std::string &aName, const SimTK::Vec< M > &aVec)
 Construct from name and value. More...
 
 PropertyDblVec_ (const std::string &aName, const Array< double > &anArray)
 Construct from name and value as an Array<double> More...
 
PropertyDblVec_clone () const override
 Return a new instance of this concrete property object, containing new copies of this property's values. More...
 
void assign (const AbstractProperty &that) override
 Assign (copy) property that to this object. More...
 
std::string getTypeName () const override
 Get the type of this property as a string. More...
 
void setValue (const SimTK::Vec< M > &aVec)
 set value of property from an equivalently sized Vec More...
 
void setValue (const Array< double > &anArray) override
 set value of this property from an array of doubles of equal or greater length More...
 
SimTK::Vec< M > & getValueDblVec ()
 get writable reference to the value More...
 
const SimTK::Vec< M > & getValueDblVec () const
 get const (read-only) reference to the value More...
 
void setValue (int aSize, const double aArray[]) override
 set value from double array More...
 
const Array< double > & getValueDblArray () const override
 get value as double array More...
 
Array< double > & getValueDblArray () override
 Nonconst version of accessor for use by GUI. More...
 
std::string toString () const override
 Get a constant String representing the value of this property. More...
 
int getArraySize () const override
 
bool isArrayProperty () const override
 Return true if this is an array property. More...
 
int getNumValues () const override
 How may values are currently stored in this property? If this is an object property you can use this with getValueAsObject() to iterate over the contained objects. More...
 
virtual void setValue (bool aValue)
 
virtual void setValue (int aValue)
 
virtual void setValue (double aValue)
 
virtual void setValue (const std::string &aValue)
 
virtual void setValue (int aSize, const bool aArray[])
 
virtual void setValue (const Array< bool > &aArray)
 
virtual void setValue (int aSize, const int aArray[])
 
virtual void setValue (const Array< int > &aArray)
 
virtual void setValue (int aSize, const double aArray[])
 
virtual void setValue (const Array< double > &aArray)
 
virtual void setValue (int aSize, const std::string aArray[])
 
virtual void setValue (const Array< std::string > &aArray)
 
virtual void setValue (Object *aValue)
 
- Public Member Functions inherited from OpenSim::Property_Deprecated
 Property_Deprecated ()
 
 Property_Deprecated (PropertyType aType, const std::string &aName)
 
 Property_Deprecated (const Property_Deprecated &aProperty)
 
virtual PropertyType getPropertyType () const
 Return the enum value corresponding to the concrete property. More...
 
void setMatchName (bool aMatchName)
 By default deprecated PropertyObj properties will ignore the name associated with the read-in object. More...
 
bool getMatchName () const
 Return the value of the matchName flag for this (deprecated) property. More...
 
bool isEqualTo (const AbstractProperty &other) const override
 The base class equals() method will have already done a lot of checking prior to calling this method, including verifying that both values are non-default and that the value lists are the same size; the concrete property need only compare the values. More...
 
virtual void readFromXMLElement (SimTK::Xml::Element &propertyElement, int versionNumber) override
 Read in a new value for this property from the XML element propertyElement. More...
 
virtual void writeToXMLElement (SimTK::Xml::Element &propertyElement) const override
 Output a serialized representation of this property by writing its value to the given XML property element. More...
 
void clearValues () override
 If the concrete property allows it, clear the value list. More...
 
bool isUnnamedProperty () const override
 An unnamed property is a one-object property whose name was given as null or as the contained object's type tag. More...
 
bool isObjectProperty () const override
 Return true if this is an "object property", meaning that its values are all concrete objects of types that ultimately derive from the OpenSim serializable base class Object. More...
 
bool isAcceptableObjectTag (const std::string &objectTypeTag) const override
 Return true if the given string is the XML tag name for one of the Object-derived types that is allowed by this property. More...
 
const ObjectgetValueAsObject (int index=-1) const override
 For an object property, the values can be obtained as references to the abstract base class Object from which all the objects derive. More...
 
ObjectupdValueAsObject (int index=-1) override
 Get writable access to an existing object value. More...
 
void setValueAsObject (const Object &obj, int index=-1) override
 Set the indicated value element to a new copy of the supplied object. More...
 
void setNull ()
 
Property_Deprecatedoperator= (const Property_Deprecated &aProperty)
 
virtual bool operator== (const Property_Deprecated &aProperty) const
 
virtual bool operator< (const Property_Deprecated &aProperty) const
 
void setType (PropertyType aType)
 
PropertyType getType () const
 
virtual bool & getValueBool ()
 
virtual const bool & getValueBool () const
 
virtual int & getValueInt ()
 
virtual const int & getValueInt () const
 
virtual double & getValueDbl ()
 
virtual const double & getValueDbl () const
 
virtual std::string & getValueStr ()
 
virtual const std::string & getValueStr () const
 
virtual Array< bool > & getValueBoolArray ()
 
virtual const Array< bool > & getValueBoolArray () const
 
virtual Array< int > & getValueIntArray ()
 
virtual const Array< int > & getValueIntArray () const
 
virtual Array< std::string > & getValueStrArray ()
 
virtual const Array< std::string > & getValueStrArray () const
 
virtual bool isValidObject (const Object *aValue) const
 
virtual ObjectgetValueObj ()
 
virtual const ObjectgetValueObj () const
 
virtual const ObjectgetValueObjPtr () const
 
virtual const ObjectgetValueObjPtr (int index) const
 
virtual void appendValue (Object *obj)
 
virtual void clearObjArray ()
 
template<class T >
T & getValue ()
 
template<class T >
const T & getValue () const
 
template<class T >
Array< T > & getValueArray ()
 
template<class T >
const Array< T > & getValueArray () const
 
template<>
bool & getValue ()
 
template<>
const bool & getValue () const
 
template<>
Array< bool > & getValueArray ()
 
template<>
const Array< bool > & getValueArray () const
 
- Public Member Functions inherited from OpenSim::AbstractProperty
void setAllowableListSize (int aMin, int aMax)
 Require that the number of values n in the value list of this property be in the range aMin <= n <= aMax. More...
 
void setAllowableListSize (int aNum)
 Require that the number of values n in the value list of this property be exactly n=aNum values. More...
 
virtual ~AbstractProperty ()
 Return all heap space used by this property. More...
 
virtual std::string toStringForDisplay (const int precision) const
 For relatively simple types, return the current value of this property in a string suitable for displaying to a user in the GUI (i.e., this number may be rounded and not an exact representation of the actual value being used). More...
 
bool equals (const AbstractProperty &other) const
 Compare this property with another one; this is primarily used for testing. More...
 
bool isSamePropertyClass (const AbstractProperty &other) const
 Return true if the other property is an object of exactly the same concrete class as this one. More...
 
bool operator== (const AbstractProperty &other) const
 See the equals() method for the meaning of this operator. More...
 
void setAllPropertiesUseDefault (bool shouldUseDefault)
 This method sets the "use default" flag for this property and the properties of any objects it contains to the given value. More...
 
void readFromXMLParentElement (SimTK::Xml::Element &parent, int versionNumber)
 Given an XML parent element expected to contain a value for this property as an immediate child element, find that property element and set the property value from it. More...
 
void writeToXMLParentElement (SimTK::Xml::Element &parent) const
 Given an XML parent element, append a single child element representing the serialized form of this property. More...
 
void setName (const std::string &name)
 Set the property name. More...
 
void setComment (const std::string &aComment)
 Set a user-friendly comment to be associated with property. More...
 
void setValueIsDefault (bool isDefault)
 Set flag indicating whether the value of this property was simply taken from a default object and thus should not be written out when serializing. More...
 
const std::string & getName () const
 Get the property name. More...
 
const std::string & getComment () const
 Get the comment associated with this property. More...
 
bool getValueIsDefault () const
 Get the flag indicating whether the current value is just the default value for this property (in which case it doesn't need to be written out). More...
 
int getMinListSize () const
 Get the minimum number of values allowed in this property's value list. More...
 
int getMaxListSize () const
 Get the maximum number of values allowed in this property's value list. More...
 
bool isOptionalProperty () const
 This is an "optional" property if its value list can contain at most one value. More...
 
bool isListProperty () const
 This is a "list" property if its value list can contain more than one value. More...
 
bool isOneValueProperty () const
 This is a "one-value" property if its value list must always contain exactly one value. More...
 
bool isOneObjectProperty () const
 This is a "one-object" property if it is a "one-value" property and it contains an Object-derived value. More...
 
int size () const
 Return the number of values currently in this property's value list. More...
 
bool empty () const
 Return true if this property's value list is currently empty. More...
 
void clear ()
 Empty the value list for this property; fails if zero is not an allowable size for this property. More...
 
template<class T >
const T & getValue (int index=-1) const
 Return one of the values in this property as type T; this works only if the underlying concrete property stores type T and if the indexed element is present, otherwise throws an exception. More...
 
template<class T >
T & updValue (int index=-1)
 Return a writable reference to one of the values in this property as type T; this works only if the underlying concrete property is actually of type T and the indexed element is present. More...
 
template<class T >
int appendValue (const T &value)
 Append a new value of type T to the end of the list of values currently contained in this property. More...
 

Detailed Description

template<int M>
class OpenSim::PropertyDblVec_< M >

Class PropertyDblVec_ extends class Property.

It consists of a small vector of doubles (i.e., SimTK::Vec<M>) and the methods for accessing and modifying this Vec<M>.

Author
Ayman Habib, Ajay Seth, Michael Sherman

Constructor & Destructor Documentation

◆ PropertyDblVec_() [1/3]

◆ PropertyDblVec_() [2/3]

template<int M>
OpenSim::PropertyDblVec_< M >::PropertyDblVec_ ( const std::string &  aName,
const SimTK::Vec< M > &  aVec 
)
inline

◆ PropertyDblVec_() [3/3]

template<int M>
OpenSim::PropertyDblVec_< M >::PropertyDblVec_ ( const std::string &  aName,
const Array< double > &  anArray 
)
inline

Member Function Documentation

◆ assign()

template<int M>
void OpenSim::PropertyDblVec_< M >::assign ( const AbstractProperty that)
inlineoverridevirtual

Assign (copy) property that to this object.

Implements OpenSim::AbstractProperty.

References OpenSim::AbstractProperty::getTypeName(), and OpenSim::PropertyDblVec_< M >::getTypeName().

◆ clone()

template<int M>
PropertyDblVec_ * OpenSim::PropertyDblVec_< M >::clone ( ) const
inlineoverridevirtual

Return a new instance of this concrete property object, containing new copies of this property's values.

The new property object is allocated on the heap and it is up to the caller to delete it when done.

Implements OpenSim::Property_Deprecated.

◆ getArraySize()

template<int M>
int OpenSim::PropertyDblVec_< M >::getArraySize ( ) const
inlineoverridevirtual

Reimplemented from OpenSim::Property_Deprecated.

◆ getNumValues()

template<int M>
int OpenSim::PropertyDblVec_< M >::getNumValues ( ) const
inlineoverridevirtual

How may values are currently stored in this property? If this is an object property you can use this with getValueAsObject() to iterate over the contained objects.

Reimplemented from OpenSim::Property_Deprecated.

◆ getTypeName()

template<int M>
std::string OpenSim::PropertyDblVec_< M >::getTypeName ( ) const
inlineoverridevirtual

Get the type of this property as a string.

Implements OpenSim::Property_Deprecated.

Referenced by OpenSim::PropertyDblVec_< M >::assign().

◆ getValueDblArray() [1/2]

template<int M>
const Array< double > & OpenSim::PropertyDblVec_< M >::getValueDblArray ( ) const
inlineoverridevirtual

get value as double array

Reimplemented from OpenSim::Property_Deprecated.

◆ getValueDblArray() [2/2]

template<int M>
Array< double > & OpenSim::PropertyDblVec_< M >::getValueDblArray ( )
inlineoverridevirtual

Nonconst version of accessor for use by GUI.

Reimplemented from OpenSim::Property_Deprecated.

◆ getValueDblVec() [1/2]

template<int M>
SimTK::Vec< M > & OpenSim::PropertyDblVec_< M >::getValueDblVec ( )
inline

get writable reference to the value

◆ getValueDblVec() [2/2]

template<int M>
const SimTK::Vec< M > & OpenSim::PropertyDblVec_< M >::getValueDblVec ( ) const
inline

get const (read-only) reference to the value

◆ isArrayProperty()

template<int M>
bool OpenSim::PropertyDblVec_< M >::isArrayProperty ( ) const
inlineoverridevirtual

Return true if this is an array property.

Reimplemented from OpenSim::Property_Deprecated.

◆ setValue() [1/16]

template<int M>
virtual void OpenSim::Property_Deprecated::setValue ( bool  aValue)
inlinevirtual

Reimplemented from OpenSim::Property_Deprecated.

◆ setValue() [2/16]

template<int M>
virtual void OpenSim::Property_Deprecated::setValue ( const Array< bool > &  aArray)
inlinevirtual

Reimplemented from OpenSim::Property_Deprecated.

◆ setValue() [3/16]

template<int M>
virtual void OpenSim::Property_Deprecated::setValue ( const Array< double > &  aArray)
inlinevirtual

Reimplemented from OpenSim::Property_Deprecated.

◆ setValue() [4/16]

template<int M>
void OpenSim::PropertyDblVec_< M >::setValue ( const Array< double > &  anArray)
inlineoverridevirtual

set value of this property from an array of doubles of equal or greater length

Reimplemented from OpenSim::Property_Deprecated.

References OpenSim::Array< T >::getSize().

◆ setValue() [5/16]

template<int M>
virtual void OpenSim::Property_Deprecated::setValue ( const Array< int > &  aArray)
inlinevirtual

Reimplemented from OpenSim::Property_Deprecated.

◆ setValue() [6/16]

template<int M>
virtual void OpenSim::Property_Deprecated::setValue ( const Array< std::string > &  aArray)
inlinevirtual

Reimplemented from OpenSim::Property_Deprecated.

◆ setValue() [7/16]

template<int M>
void OpenSim::PropertyDblVec_< M >::setValue ( const SimTK::Vec< M > &  aVec)
inline

set value of property from an equivalently sized Vec

Referenced by OpenSim::PropertyDblVec_< M >::PropertyDblVec_(), and OpenSim::PropertyDblVec_< M >::setValue().

◆ setValue() [8/16]

template<int M>
virtual void OpenSim::Property_Deprecated::setValue ( const std::string &  aValue)
inlinevirtual

Reimplemented from OpenSim::Property_Deprecated.

◆ setValue() [9/16]

template<int M>
virtual void OpenSim::Property_Deprecated::setValue ( double  aValue)
inlinevirtual

Reimplemented from OpenSim::Property_Deprecated.

◆ setValue() [10/16]

template<int M>
virtual void OpenSim::Property_Deprecated::setValue ( int  aSize,
const bool  aArray[] 
)
inlinevirtual

Reimplemented from OpenSim::Property_Deprecated.

◆ setValue() [11/16]

template<int M>
virtual void OpenSim::Property_Deprecated::setValue ( int  aSize,
const double  aArray[] 
)
inlinevirtual

Reimplemented from OpenSim::Property_Deprecated.

◆ setValue() [12/16]

template<int M>
void OpenSim::PropertyDblVec_< M >::setValue ( int  aSize,
const double  aArray[] 
)
inlineoverridevirtual

set value from double array

Reimplemented from OpenSim::Property_Deprecated.

References OpenSim::PropertyDblVec_< M >::setValue().

◆ setValue() [13/16]

template<int M>
virtual void OpenSim::Property_Deprecated::setValue ( int  aSize,
const int  aArray[] 
)
inlinevirtual

Reimplemented from OpenSim::Property_Deprecated.

◆ setValue() [14/16]

template<int M>
virtual void OpenSim::Property_Deprecated::setValue ( int  aSize,
const std::string  aArray[] 
)
inlinevirtual

Reimplemented from OpenSim::Property_Deprecated.

◆ setValue() [15/16]

template<int M>
virtual void OpenSim::Property_Deprecated::setValue ( int  aValue)
inlinevirtual

Reimplemented from OpenSim::Property_Deprecated.

◆ setValue() [16/16]

template<int M>
virtual void OpenSim::Property_Deprecated::setValue ( Object aValue)
inlinevirtual

Reimplemented from OpenSim::Property_Deprecated.

◆ toString()

template<int M>
std::string OpenSim::PropertyDblVec_< M >::toString ( ) const
inlineoverridevirtual

Get a constant String representing the value of this property.

Implements OpenSim::Property_Deprecated.


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