API
4.3
For MATLAB, Python, Java, and C++ users
|
This is the base class for all OpenSim objects that are serializable (meaning they can be written to and read back from files). More...
Public Member Functions | |
virtual | ~Object () |
Virtual destructor for cleanup. More... | |
virtual Object * | clone () const =0 |
Create a new heap-allocated copy of the concrete object to which this Object refers. More... | |
virtual const std::string & | getConcreteClassName () const =0 |
Returns the class name of the concrete Object-derived class of the actual object referenced by this Object, as a string. More... | |
bool | isEqualTo (const Object &aObject) const |
Equality operator wrapper for use from languages not supporting operator overloading. More... | |
Object & | operator= (const Object &aObject) |
Copy assignment copies he base class fields, including the properties. More... | |
virtual bool | operator== (const Object &aObject) const |
Determine if two objects are equal. More... | |
virtual bool | operator< (const Object &aObject) const |
Provide an ordering for objects so they can be put in sorted containers. More... | |
void | setName (const std::string &name) |
Set the name of the Object. More... | |
const std::string & | getName () const |
Get the name of this Object. More... | |
void | setDescription (const std::string &description) |
Set description, a one-liner summary. More... | |
const std::string & | getDescription () const |
Get description, a one-liner summary. More... | |
const std::string & | getAuthors () const |
Get Authors of this Object. More... | |
void | setAuthors (const std::string &authors) |
Set Authors of this object. More... | |
const std::string & | getReferences () const |
Get references or publications to cite if using this object. More... | |
void | setReferences (const std::string &references) |
Set references or publications to cite if using this object. More... | |
Static Public Member Functions | |
Registration of types and default objects | |
Methods in this section deal with the requirement that all OpenSim types derived from Object must be registered and a default instance provided. This enables reading these objects from XML files. You can also recognize now-obsolete names for objects and have them quietly mapped to their modern names using the renameType() method. Rename can also be used programmatically to replace one registered type with another, because renaming occurs prior to object lookup. | |
static void | registerType (const Object &defaultObject) |
Register an instance of a class; if the class is already registered it will be replaced. More... | |
static void | renameType (const std::string &oldTypeName, const std::string &newTypeName) |
Support versioning by associating the current Object type with an old name. More... | |
static const Object * | getDefaultInstanceOfType (const std::string &concreteClassName) |
Return a pointer to the default instance of the registered (concrete) Object whose class name is given, or NULL if the type is not registered. More... | |
template<class T > | |
static bool | isObjectTypeDerivedFrom (const std::string &concreteClassName) |
Return true if the given concrete object type represents a subclass of the template object type T, and thus could be referenced with a T*. More... | |
static Object * | newInstanceOfType (const std::string &concreteClassName) |
Create a new instance of the concrete Object type whose class name is given as concreteClassName. More... | |
static void | getRegisteredTypenames (Array< std::string > &typeNames) |
Retrieve all the typenames registered so far. More... | |
template<class T > | |
static void | getRegisteredObjectsOfGivenType (ArrayPtrs< T > &rArray) |
Return an array of pointers to the default instances of all registered (concrete) Object types that derive from a given Object-derived type that does not have to be concrete. More... | |
Public access to properties | |
Methods in this section are for public access to the properties maintained by this OpenSim Object. Properties are normally accessed through methods of the concrete Object-derived classes that are generated by the Property declaration macros; see OpenSim::Property for information. However, when dealing with Objects from "the outside", as is done in the GUI, these methods allow access to properties via the property base class AbstractProperty to support various type-independent property services. That is particularly useful for Object-containing properties since the objects can be obtained without knowing their concrete types. For simple types (e.g. int, std::string) you can only obtain the values if you know the expected type. For those types, or when you know the expected Object type, you can use the templatized methods to deal with the concrete values. | |
int | getNumProperties () const |
Determine how many properties are stored with this Object. More... | |
const AbstractProperty & | getPropertyByIndex (int propertyIndex) const |
Get a const reference to a property by its index number, returned as an AbstractProperty. More... | |
AbstractProperty & | updPropertyByIndex (int propertyIndex) |
Get a writable reference to a property by its index number, returned as an AbstractProperty. More... | |
bool | hasProperty (const std::string &name) const |
Return true if this Object has a property of any type with the given name, which must not be empty. More... | |
const AbstractProperty & | getPropertyByName (const std::string &name) const |
Get a const reference to a property by its name, returned as an AbstractProperty. More... | |
AbstractProperty & | updPropertyByName (const std::string &name) |
Get a writable reference to a property by its name, returned as an AbstractProperty. More... | |
template<class T > | |
bool | hasProperty () const |
Return true if this Object contains an unnamed, one-object property that contains objects of the given template type T. More... | |
template<class T > | |
const Property< T > & | getProperty (const PropertyIndex &index) const |
Get property of known type Property<T> as a const reference; the property must be present and have the right type. More... | |
template<class T > | |
Property< T > & | updProperty (const PropertyIndex &index) |
Get property of known type Property<T> as a writable reference; the property must be present and have the right type. More... | |
bool | isObjectUpToDateWithProperties () const |
Returns true if no property's value has changed since the last time setObjectIsUpToDateWithProperties() was called. More... | |
static bool | PrintPropertyInfo (std::ostream &os, const std::string &classNameDotPropertyName, bool printFlagInfo=true) |
Dump formatted property information to a given output stream, useful for creating a "help" facility for registered objects. More... | |
static bool | PrintPropertyInfo (std::ostream &os, const std::string &className, const std::string &propertyName, bool printFlagInfo=true) |
Same as the other signature but the class name and property name are provided as two separate strings. More... | |
XML reading and writing | |
These methods deal with writing out in-memory objects to XML files (serializing) and reading XML files to reconstruct in-memory objects (deserializing). | |
void | readObjectFromXMLNodeOrFile (SimTK::Xml::Element &objectElement, int versionNumber) |
We're given an XML element from which we are to populate this Object. More... | |
virtual void | updateFromXMLNode (SimTK::Xml::Element &objectElement, int versionNumber) |
Use this method to deserialize an object from a SimTK::Xml::Element. More... | |
void | updateXMLNode (SimTK::Xml::Element &parent, const AbstractProperty *prop=nullptr) const |
Serialize this object into the XML node that represents it. More... | |
bool | getInlined () const |
Inlined means an in-memory Object that is not associated with an XMLDocument. More... | |
void | setInlined (bool aInlined, const std::string &aFileName="") |
Mark this as inlined or not and optionally provide a file name to associate with the new XMLDocument for the non-inline case. More... | |
std::string | getDocumentFileName () const |
If there is a document associated with this object then return the file name maintained by the document. More... | |
int | getDocumentFileVersion () const |
If there is a document associated with this object then return its version number. More... | |
void | setAllPropertiesUseDefault (bool aUseDefault) |
bool | print (const std::string &fileName) const |
Write this Object into an XML file of the given name; conventionally the suffix to use is ".osim". More... | |
std::string | dump () const |
dump the XML representation of this Object into an std::string and return it. More... | |
static Object * | makeObjectFromFile (const std::string &fileName) |
Create an OpenSim object whose type is based on the tag at the root node of the XML file passed in. More... | |
void | setObjectIsUpToDateWithProperties () |
When an object is initialized using the current values of its properties, it can set a flag indicating that it is up to date. More... | |
void | clearObjectIsUpToDateWithProperties () |
For testing or debugging purposes, manually clear the "object is up to
date with respect to properties" flag. More... | |
void | makeObjectNamesConsistentWithProperties () |
Make sure the name of an object is consistent with its property type. More... | |
void | updateFromXMLDocument () |
Use this method only if you're deserializing from a file and the object is at the top level; that is, primarily in constructors that take a file name as input. More... | |
void | setDocument (XMLDocument *doc) |
Unconditionally set the XMLDocument associated with this object. More... | |
const XMLDocument * | getDocument () const |
Get a const pointer to the document (if any) associated with this object. More... | |
XMLDocument * | updDocument () |
Get a writable pointer to the document (if any) associated with this object. More... | |
Advanced/Obscure | |
Methods in this section are for specialized purposes not of interest to most OpenSim API users. For example, some of these are services needed by the OpenSim GUI which is written in Java. | |
virtual bool | isA (const char *type) const |
The default implementation returns true only if the supplied string is "Object"; each Object-derived class overrides this to match its own class name. More... | |
const std::string & | toString () const |
Wrapper to be used on Java side to display objects in tree; this returns just the object's name. More... | |
PropertySet & | getPropertySet () |
OBSOLETE: Get a reference to the PropertySet maintained by the Object. More... | |
const PropertySet & | getPropertySet () const |
static const std::string & | getClassName () |
Return the name of this class as a string; i.e., "Object". More... | |
static void | setSerializeAllDefaults (bool shouldSerializeDefaults) |
Static function to control whether all registered objects and their properties are written to the defaults section of output files rather than only those values for which the default was explicitly overwritten when read in from an input file or set programmatically. More... | |
static bool | getSerializeAllDefaults () |
Report the value of the "serialize all defaults" flag. More... | |
static bool | isKindOf (const char *type) |
Returns true if the passed-in string is "Object"; each Object-derived class defines a method of this name for its own class name. More... | |
static void | setDebugLevel (int newLevel) |
Set the amount of logging output. More... | |
static int | getDebugLevel () |
Get the current setting of debug level. More... | |
static Object * | SafeCopy (const Object *aObject) |
Use the clone() method to duplicate the given object unless the pointer is null in which case null is returned. More... | |
static void | RegisterType (const Object &defaultObject) |
OBSOLETE alternate name for registerType(). More... | |
static void | RenameType (const std::string &oldName, const std::string &newName) |
OBSOLETE alternate name for renameType(). More... | |
This is the base class for all OpenSim objects that are serializable (meaning they can be written to and read back from files).
In particular, all ModelComponent objects derive from Object. It provides a common base class from which to derive serializable objects and also some basic functionality, such as writing to files in XML format, managing properties, and the equality, less than, and output operators.
An Object maintains a table of "properties" that know how to read themselves from XML and write themselves to XML. The available Property types are
It is important to note that Objects and Properties together form a recursive tree structure that is the representation of an OpenSim Model. See the documentation for the OpenSim::Property class for more information.
The declaration of every class derived from Object must have its first line (that is, immediately after the "{" in the class declaration) one of four standard "boilerplate" macros:
("Superclass" means the immediate class from which the class derives; that terminology is borrowed from Java. It is often called the "Parent" class but we'll use "Super" which is more precise.) The "_T" variants of the above macros are used for objects that are templatized, like Set<T>.
These macros provide a standardized set of declarations for every object, including
getClassName() is a static method that returns the name of the Object-derived class for which it is invoked. For example, ModelComponent::getClassName() returns "ModelComponent". In contrast, getConcreteClassName() is a pure virtual method of Object that returns the class name of the actual concrete object being referenced through the abstract base class. This method is implemented only in concrete classes.
Note that getClassName() and getConcreteClassName() will return the same string only if the referenced class is concrete. For example,
For concrete objects, the class name is used as the "object type tag", the tag string that will appear in XML files. Also, when a Property<T> has no name (allowed for properties that contain just a single object) the object class name T (which may be abstract like Function or ModelComponent) is used to select the property. See OpenSim::Property for more information.
The standard clone() method produces a duplicate of a concrete object and thus is implemented only for concrete classes. However, the return type must always match the type of the invoking object (this is called a "covariant type" and does not change the method's identity). It is therefore redeclared even in abstract classes, but remains pure virtual in those cases. That means if you invoke Function::clone() you'll get back a Function* rather than an Object*; this avoids many unnecessary invocations of the awkward and expensive dynamic_cast operator.
An Object type needs to be "registered" by calling Object::registerType() with an instance of a concrete object so that the serialization infrastructure knows what kind of Object to create when it encounters a specific XML tag. This associates the concrete object's class name (object type tag) with a default instance of that object. The registration process is normally done during dynamic library (DLL) loading, that is, as part of the static initializer execution that occurs before program execution.
For backwards compatibility, we support a renaming mechanism in which now-deprecated class names can be mapped to their current equivalents. This is done via a string-to-string table mapping the old names to the new ones; only the current names appear in the registered objects table. Specification of these aliases is done immediately after registration in the DLL static initializer.
When an Object is registered (either programmatically, or overridden in the defaults section of a document), a copy of it is maintained in a dictionary as a "default" object of its class. When new instances of this class are requested, the contents of the default object are used to populate the new instance before deserialization. This allows for specifying default values that will be commonly used in one place in the XML file rather than with each object which leads to smaller files that are easier to read. Property values that obtain their values from the defaults and are not subsequently overridden are marked as being default values, allowing us to avoid writing them back out when serializing.
|
virtual |
Virtual destructor for cleanup.
|
protected |
The default constructor is only for use by constructors of derived types.
Initializes all base class data members to innocuous values.
|
explicitprotected |
Constructor from a file, to be called from other constructors that take a file as input.
|
protected |
Copy constructor is invoked automatically by derived classes with default copy constructors; otherwise it must be invoked explicitly.
|
explicitprotected |
Construct the base class portion of an Object from a given Xml element that describes this Object.
Assumes latest XML file format; there is no provision for version numbering.
|
protected |
Define a new list-valued property of known type T, with the given name, associated comment, minimum (==0) and maximum (>0) allowable list lengths, and a zero-length initial value.
The property must have a name (the empty string is not acceptable), and that name must be unique within this Object's property table.
References OpenSim::AbstractProperty::setAllowableListSize(), OpenSim::AbstractProperty::setComment(), and OpenSim::AbstractProperty::setValueIsDefault().
|
protected |
Define a new list-valued property as above, but assigning an initial value via some templatized container class that supports size() and indexing.
Here the minimum size may be greater than zero, provided that the initial value has at least that many element (and no more than the allowed maximum).
References OpenSim::Property< T >::appendValue(), OpenSim::AbstractProperty::setAllowableListSize(), OpenSim::AbstractProperty::setComment(), and OpenSim::AbstractProperty::setValueIsDefault().
|
protected |
Add an optional property, meaning it can contain either no value or a single value.
Here no initial value is provided. The property must have a name (the empty string is not acceptable), and that name must be unique within this Object's property table.
References OpenSim::AbstractProperty::setAllowableListSize(), OpenSim::AbstractProperty::setComment(), and OpenSim::AbstractProperty::setValueIsDefault().
|
protected |
Add an optional property, meaning it can contain either no value or a single value.
Here an initial value is provided. The property must have a name (the empty string is not acceptable), and that name must be unique within this Object's property table.
References OpenSim::Property< T >::appendValue(), OpenSim::AbstractProperty::setAllowableListSize(), OpenSim::AbstractProperty::setComment(), and OpenSim::AbstractProperty::setValueIsDefault().
|
protected |
Define a new single-value property of known type T, with the given name, associated comment, and initial value.
The name must be unique within this Object's property table.
If T is an object type (i.e., derived from Object), it is permissible for the property to be unnamed; pass an empty string for name. You will then be able to select the property using the object class name (that is, T::getClassName()) as though it were the property's name. An Object can thus only have one unnamed property of any particular object type.
References OpenSim::Property< T >::appendValue(), OpenSim::AbstractProperty::setComment(), and OpenSim::AbstractProperty::setValueIsDefault().
|
protected |
Throw an exception if any of the property's values are neither in the provided range nor in the provided set.
References OpenSim::AbstractProperty::getName(), OpenSim::Property< T >::getValue(), and OpenSim::AbstractProperty::size().
|
protected |
Throw an exception if any of the property's values are not in the provided set.
References OpenSim::AbstractProperty::getName(), OpenSim::Property< T >::getValue(), and OpenSim::AbstractProperty::size().
|
protected |
Throw an exception if any of the property's values are not positive.
References OpenSim::AbstractProperty::getName(), OpenSim::Property< T >::getValue(), and OpenSim::AbstractProperty::size().
|
inlineprotected |
For testing or debugging purposes, manually clear the "object is up to date with respect to properties" flag.
This is normally done automatically when a property is modified. Setting the flag is always done manually, however, see setObjectIsUpToDateWithProperties().
|
pure virtual |
Create a new heap-allocated copy of the concrete object to which this Object refers.
It is up to the caller to delete the returned object when no longer needed. Every concrete object deriving from Object implements this pure virtual method automatically, via the declaration macro it invokes (e.g., OpenSim_DECLARE_CONCRETE_OBJECT()). Note that the concrete class overrides modify the return type to be a pointer to the concrete object; that still overrides the base class method because the return type is covariant with (that is, derives from) Object.
Implemented in OpenSim::Bhargava2004MuscleMetabolicsProbe_MetabolicMuscleParameterSet, OpenSim::FrameGeometry, OpenSim::Umberger2010MuscleMetabolicsProbe_MetabolicMuscleParameterSet, OpenSim::Mesh, OpenSim::Brick, OpenSim::Bhargava2004MuscleMetabolicsProbe_MetabolicMuscleParameter, OpenSim::Torus, OpenSim::Umberger2010MuscleMetabolicsProbe_MetabolicMuscleParameter, OpenSim::MocoAverageSpeedGoal, OpenSim::Cone, OpenSim::MocoFinalTimeGoal, OpenSim::MocoProblem, OpenSim::Component, OpenSim::Cylinder, OpenSim::Ellipsoid, OpenSim::Sphere, OpenSim::AnalyticGeometry, OpenSim::Model, OpenSim::Millard2012AccelerationMuscle, OpenSim::ConsoleReporter_< T >, OpenSim::Arrow, OpenSim::EspositoMiller2018Force, OpenSim::Bhargava2004SmoothedMuscleMetabolics, OpenSim::Umberger2010MuscleMetabolicsProbe, OpenSim::TabOpUseAbsoluteStateNames, OpenSim::Millard2012EquilibriumMuscle, OpenSim::LineGeometry, OpenSim::Bhargava2004MuscleMetabolicsProbe, OpenSim::MocoContactTrackingGoal, OpenSim::TableReporter_< InputT, ValueT >, OpenSim::TabOpLowPassFilter, OpenSim::HuntCrossleyForce, OpenSim::ElasticFoundationForce, OpenSim::Blankevoort1991Ligament, OpenSim::ModOpFiberDampingDGF, OpenSim::TabOpConvertDegreesToRadians, OpenSim::MocoTrack, OpenSim::FiberForceLengthCurve, OpenSim::MuscleSecondOrderActivationDynamicModel, OpenSim::ModOpReplaceJointsWithWelds, OpenSim::MeyerFregly2016Force, OpenSim::MocoPathConstraint, OpenSim::TendonForceLengthCurve, OpenSim::MocoInverse, OpenSim::ModOpScaleActiveFiberForceCurveWidthDGF, OpenSim::ForceVelocityCurve, OpenSim::MocoControlTrackingGoal, OpenSim::ModOpAddExternalLoads, OpenSim::ScalarActuator, OpenSim::MocoFinalBounds, OpenSim::HuntCrossleyForce, OpenSim::MocoInitialBounds, OpenSim::ElasticFoundationForce, OpenSim::MocoCasADiSolver, OpenSim::Probe, OpenSim::ActiveForceLengthCurve, OpenSim::Thelen2003Muscle, OpenSim::ModOpPassiveFiberStrainAtOneNormForceDGF, OpenSim::StreamableReference_< T >, OpenSim::StreamableReference_< SimTK::Rotation_< double > >, OpenSim::Joint, OpenSim::ForceVelocityInverseCurve, OpenSim::Reporter< InputT >, OpenSim::Reporter< T >, OpenSim::DeGrooteFregly2016Muscle, OpenSim::MocoPeriodicityGoal, OpenSim::MocoParameter, OpenSim::MocoStepTimeAsymmetryGoal, OpenSim::ModOpIgnorePassiveFiberForcesDGF, OpenSim::Appearance, OpenSim::ModOpAddReserves, OpenSim::MuscleFixedWidthPennationModel, OpenSim::InducedAccelerationsSolver, OpenSim::MocoDirectCollocationSolver, OpenSim::MocoStudy, OpenSim::MarkersReference, OpenSim::ProbeReporter, OpenSim::MocoGoal, OpenSim::ModelComponent, OpenSim::MocoFrameDistanceConstraint, OpenSim::FirstOrderMuscleActivationDynamics, OpenSim::Frame, OpenSim::ModOpRemoveMuscles, OpenSim::MuscleFirstOrderActivationDynamicModel, OpenSim::AckermannVanDenBogert2010Force, OpenSim::Muscle, OpenSim::Control, OpenSim::CMC, OpenSim::ModOpUseImplicitTendonComplianceDynamicsDGF, OpenSim::IMUInverseKinematicsTool, OpenSim::ModelDisplayHints, OpenSim::MocoStateTrackingGoal, OpenSim::FiberCompressiveForceCosPennationCurve, OpenSim::GCVSpline, OpenSim::OrientationsReference, OpenSim::SmoothSphereHalfSpaceForce, OpenSim::IMUDataReporter, OpenSim::OutputReporter, OpenSim::MocoTropterSolver, OpenSim::InducedAccelerations, OpenSim::Storage, OpenSim::AssemblySolver, OpenSim::MocoMarkerTrackingGoal, OpenSim::ExternalLoads, OpenSim::SimbodyEngine, OpenSim::OffsetFrame< PhysicalFrame >, OpenSim::FiberCompressiveForceLengthCurve, OpenSim::MultivariatePolynomialFunction, OpenSim::MocoAccelerationTrackingGoal, OpenSim::InverseDynamicsTool, OpenSim::VectorFunctionForActuators, OpenSim::MocoStepLengthAsymmetryGoal, OpenSim::MarkerPlacer, OpenSim::ClutchedPathSpring, OpenSim::PointKinematics, OpenSim::VectorFunctionUncoupledNxN, OpenSim::JointReaction, OpenSim::MuscleAnalysis, OpenSim::ControlLinear, OpenSim::GeometryPath, OpenSim::PhysicalFrame, OpenSim::Delp1990Muscle_Deprecated, OpenSim::RigidTendonMuscle, OpenSim::VectorFunction, OpenSim::Analysis, OpenSim::ModelComponentSet< T >, OpenSim::RollingOnSurfaceConstraint, OpenSim::ModelComponentSet< ExternalForce >, OpenSim::ModelComponentSet< ContactGeometry >, OpenSim::ModelComponentSet< WrapObject >, OpenSim::ModelComponentSet< Force >, OpenSim::ModelComponentSet< Joint >, OpenSim::ModelComponentSet< Probe >, OpenSim::ModelComponentSet< Controller >, OpenSim::ModelComponentSet< ModelComponent >, OpenSim::ModelComponentSet< Marker >, OpenSim::ModelComponentSet< Body >, OpenSim::ModelComponentSet< Constraint >, OpenSim::ModOpScaleMaxIsometricForce, OpenSim::MocoWeightSet, OpenSim::ScapulothoracicJoint, OpenSim::RRATool, OpenSim::MuscleActivationDynamics, OpenSim::MocoOrientationTrackingGoal, OpenSim::SurfaceProperties, OpenSim::CoordinateLimitForce, OpenSim::ExpressionBasedPointToPointForce, OpenSim::ExternalForce, OpenSim::CMCTool, OpenSim::Function, OpenSim::Controller, OpenSim::ControlLinearNode, OpenSim::InverseDynamicsSolver, OpenSim::ActivationFiberLengthMuscle, OpenSim::Geometry, OpenSim::CMC_Task, OpenSim::Measurement, OpenSim::Actuation, OpenSim::ObjectGroup, OpenSim::MocoAngularVelocityTrackingGoal, OpenSim::MocoControlGoal, OpenSim::Condition, OpenSim::ExpressionBasedBushingForce, OpenSim::FunctionBasedBushingForce, OpenSim::PathSpring, OpenSim::PrescribedForce, OpenSim::ForwardTool, OpenSim::TwoFrameLinker< Force, PhysicalFrame >, OpenSim::TwoFrameLinker< Constraint, PhysicalFrame >, OpenSim::StatesReporter, OpenSim::MocoJointReactionGoal, OpenSim::MocoTranslationTrackingGoal, OpenSim::ActivationFiberLengthMuscle_Deprecated, OpenSim::BushingForce, OpenSim::Coordinate, OpenSim::CustomJoint, OpenSim::AnalyzeTool, OpenSim::DynamicsTool, OpenSim::GenericModelMaker, OpenSim::OrientationWeightSet, OpenSim::Schutte1993Muscle_Deprecated, OpenSim::TorqueActuator, OpenSim::StaticOptimization, OpenSim::MocoContactTrackingGoalGroup, OpenSim::MocoTool, OpenSim::AbstractTool, OpenSim::Ligament, OpenSim::Reference_< T >, OpenSim::BallJoint, OpenSim::CoordinateCouplerConstraint, OpenSim::Reference_< SimTK::Rotation_< double > >, OpenSim::Reference_< double >, OpenSim::Reference_< SimTK::Vec3 >, OpenSim::BodyActuator, OpenSim::PointActuator, OpenSim::Thelen2003Muscle_Deprecated, OpenSim::ForceReporter, OpenSim::GCVSplineSet, OpenSim::SimmSpline, OpenSim::ControlSet, OpenSim::AnalysisSet, OpenSim::FunctionThresholdCondition, OpenSim::ModelScaler, OpenSim::ScaleTool, OpenSim::PointToPointActuator, OpenSim::PiecewiseConstantFunction, OpenSim::MarkerWeight, OpenSim::Actuator, OpenSim::Point, OpenSim::FreeJoint, OpenSim::TransformAxis, OpenSim::UnilateralConstraint, OpenSim::InverseKinematicsTool, OpenSim::ActivationCoordinateActuator, OpenSim::CoordinateActuator, OpenSim::McKibbenActuator, OpenSim::BodyKinematics, OpenSim::MarkerData, OpenSim::PiecewiseLinearFunction, OpenSim::Scale, OpenSim::StepFunction, OpenSim::ForceSet, OpenSim::JointInternalPowerProbe, OpenSim::ModelVisualPreferences, OpenSim::PhysicalOffsetFrame, OpenSim::IMUPlacer, OpenSim::WeldConstraint, OpenSim::TableProcessor, OpenSim::CMC_Joint, OpenSim::CMC_Point, OpenSim::Tool, OpenSim::FunctionSet, OpenSim::MultiplierFunction, OpenSim::ControlSetController, OpenSim::MomentArmSolver, OpenSim::EllipsoidJoint, OpenSim::CMC_Orientation, OpenSim::CorrectionController, OpenSim::InverseKinematicsToolBase, OpenSim::MeasurementSet, OpenSim::ModelProcessor, OpenSim::LinearFunction, OpenSim::AbstractReporter, OpenSim::Sine, OpenSim::TableSource_< ET >, OpenSim::MocoSumSquaredStateGoal, OpenSim::ControlConstant, OpenSim::CoordinateReference, OpenSim::ExperimentalMarker, OpenSim::WrapObject, OpenSim::CMC_TaskSet, OpenSim::TrackingTask, OpenSim::Set< AbstractPathPoint >, OpenSim::Set< Joint, ModelComponent >, OpenSim::Set< Bhargava2004MuscleMetabolicsProbe_MetabolicMuscleParameter >, OpenSim::Set< Marker, ModelComponent >, OpenSim::Set< Umberger2010MuscleMetabolicsProbe_MetabolicMuscleParameter >, OpenSim::Set< Coordinate >, OpenSim::Set< OpenSim::Constraint >, OpenSim::Set< OpenSim::Actuator >, OpenSim::Set< IKTask >, OpenSim::Set< MocoWeight >, OpenSim::Set< MarkerPair >, OpenSim::Set< T, ModelComponent >, OpenSim::Set< Scale >, OpenSim::Set< OpenSim::Force >, OpenSim::Set< ContactGeometry, ModelComponent >, OpenSim::Set< Controller, ModelComponent >, OpenSim::Set< WrapObject, ModelComponent >, OpenSim::Set< const OpenSim::Actuator >, OpenSim::Set< OpenSim::Muscle >, OpenSim::Set< Function >, OpenSim::Set< Probe, ModelComponent >, OpenSim::Set< ModelComponent, ModelComponent >, OpenSim::Set< OrientationWeight >, OpenSim::Set< Body, ModelComponent >, OpenSim::Set< Constraint, ModelComponent >, OpenSim::Set< ExternalForce, ModelComponent >, OpenSim::Set< TrackingTask >, OpenSim::Set< Measurement >, OpenSim::Set< BodyScale >, OpenSim::Set< Analysis >, OpenSim::Set< Control >, OpenSim::Set< Force, ModelComponent >, OpenSim::SpringGeneralizedForce, OpenSim::Kinematics, OpenSim::ScaleSet, OpenSim::BufferedOrientationsReference, OpenSim::ControllerSet, OpenSim::PathActuator, OpenSim::ExperimentalFrame, OpenSim::PinJoint, OpenSim::UniversalJoint, OpenSim::Constant, OpenSim::AccelerationMotion, OpenSim::PrescribedController, OpenSim::ActuatorPowerProbe, OpenSim::ContactGeometry, OpenSim::Force, OpenSim::Marker, OpenSim::MovingPathPoint, OpenSim::MuscleActiveFiberPowerProbe, OpenSim::SystemEnergyProbe, OpenSim::PointConstraint, OpenSim::Solver, OpenSim::SMC_Joint, OpenSim::ModOpIgnoreTendonCompliance, OpenSim::PolynomialFunction, OpenSim::StorageInterface, OpenSim::MocoControlBoundConstraint, OpenSim::ModOpTendonComplianceDynamicsModeDGF, OpenSim::BodyScale, OpenSim::Constraint, OpenSim::GimbalJoint, OpenSim::PlanarJoint, OpenSim::SpatialTransform, OpenSim::WrapCylinder, OpenSim::WrapEllipsoid, OpenSim::WrapSphere, OpenSim::WrapTorus, OpenSim::MarkerPair, OpenSim::MarkerFrame, OpenSim::SignalGenerator, OpenSim::ActuatorForceProbe, OpenSim::ConditionalPathPoint, OpenSim::JointSet, OpenSim::Station, OpenSim::IMU, OpenSim::PositionMotion, OpenSim::Body, OpenSim::SliderJoint, OpenSim::WeldJoint, OpenSim::PathWrapPoint, OpenSim::IKTaskSet, OpenSim::ConstantMuscleActivation, OpenSim::ComponentSet, OpenSim::Ground, OpenSim::PointToPointSpring, OpenSim::ConstantDistanceConstraint, OpenSim::ZerothOrderMuscleActivationDynamics, OpenSim::MocoInitialForceEquilibriumDGFGoal, OpenSim::BodyScaleSet, OpenSim::ElasticFoundationForce, OpenSim::ProbeSet, OpenSim::PointOnLineConstraint, OpenSim::StatesTrajectoryReporter, OpenSim::WrapObjectSet, OpenSim::IKCoordinateTask, OpenSim::MarkerPairSet, OpenSim::MuscleStateTrackingTask, OpenSim::DiscreteForces, OpenSim::MocoInitialVelocityEquilibriumDGFGoal, OpenSim::AbstractPathPoint, OpenSim::ContactGeometrySet, OpenSim::ContactHalfSpace, OpenSim::HuntCrossleyForce, OpenSim::PathPoint, OpenSim::PathPointSet, OpenSim::MocoPhase, OpenSim::BodySet, OpenSim::ConstraintSet, OpenSim::IKMarkerTask, OpenSim::XsensDataReaderSettings, OpenSim::ContactMesh, OpenSim::CoordinateSet, OpenSim::MarkerSet, OpenSim::IKTask, OpenSim::APDMDataReaderSettings, OpenSim::MocoScaleFactor, OpenSim::ExperimentalSensor, OpenSim::MocoBounds, OpenSim::MocoStepTimeAsymmetryGoalGroup, OpenSim::MocoSolver, OpenSim::Bhargava2004SmoothedMuscleMetabolics_MuscleParameters, OpenSim::ContactSphere, OpenSim::MocoInitialActivationGoal, OpenSim::MocoControlTrackingGoalReference, OpenSim::OrientationWeight, OpenSim::MocoConstraintInfo, OpenSim::ExpressionBasedCoordinateForce, OpenSim::TableOperator, OpenSim::MocoVariableInfo, OpenSim::MocoWeight, OpenSim::ModOpIgnoreActivationDynamics, OpenSim::MocoMarkerFinalGoal, OpenSim::ModelOperator, OpenSim::DiscreteController, OpenSim::StationPlaneContactForce, OpenSim::MocoOutputGoal, OpenSim::ModOpReplaceMusclesWithDeGrooteFregly2016, OpenSim::MocoFrameDistanceConstraintPair, and OpenSim::MocoPeriodicityGoalPair.
Referenced by SafeCopy(), OpenSim::PropertyObj::setValueAsObject(), OpenSim::PropertyObjArray< Control >::setValueAsObject(), and OpenSim::PropertyObjPtr< OpenSim::Function >::setValueAsObject().
std::string OpenSim::Object::dump | ( | ) | const |
dump the XML representation of this Object into an std::string and return it.
Mainly intended for debugging and for use by the XML browser in the GUI.
|
inline |
Get Authors of this Object.
|
inlinestatic |
Return the name of this class as a string; i.e., "Object".
See getConcreteClassName() if you want the class name of the underlying concrete object instead. Note that this method is automatically supplied for every class declaration that derives from Object via the standard macro provided for that purpose. See introductory text for this Object class for more information.
|
pure virtual |
Returns the class name of the concrete Object-derived class of the actual object referenced by this Object, as a string.
This is the string that is used as the tag for this concrete object in an XML file. Every concrete class derived from Object automatically overrides this method via the declaration macro it uses. See getClassName() to get the class name of the referencing (possibly abstract) class rather than the concrete object.
Implemented in OpenSim::Bhargava2004MuscleMetabolicsProbe_MetabolicMuscleParameterSet, OpenSim::FrameGeometry, OpenSim::Umberger2010MuscleMetabolicsProbe_MetabolicMuscleParameterSet, OpenSim::Mesh, OpenSim::Brick, OpenSim::Bhargava2004MuscleMetabolicsProbe_MetabolicMuscleParameter, OpenSim::Torus, OpenSim::Umberger2010MuscleMetabolicsProbe_MetabolicMuscleParameter, OpenSim::MocoAverageSpeedGoal, OpenSim::Cone, OpenSim::MocoFinalTimeGoal, OpenSim::MocoProblem, OpenSim::Component, OpenSim::Cylinder, OpenSim::Ellipsoid, OpenSim::Sphere, OpenSim::AnalyticGeometry, OpenSim::Model, OpenSim::Millard2012AccelerationMuscle, OpenSim::ConsoleReporter_< T >, OpenSim::Arrow, OpenSim::EspositoMiller2018Force, OpenSim::Bhargava2004SmoothedMuscleMetabolics, OpenSim::Umberger2010MuscleMetabolicsProbe, OpenSim::TabOpUseAbsoluteStateNames, OpenSim::Millard2012EquilibriumMuscle, OpenSim::LineGeometry, OpenSim::Bhargava2004MuscleMetabolicsProbe, OpenSim::MocoContactTrackingGoal, OpenSim::TableReporter_< InputT, ValueT >, OpenSim::TabOpLowPassFilter, OpenSim::HuntCrossleyForce, OpenSim::ElasticFoundationForce, OpenSim::Blankevoort1991Ligament, OpenSim::ModOpFiberDampingDGF, OpenSim::TabOpConvertDegreesToRadians, OpenSim::MocoTrack, OpenSim::FiberForceLengthCurve, OpenSim::MuscleSecondOrderActivationDynamicModel, OpenSim::ModOpReplaceJointsWithWelds, OpenSim::MeyerFregly2016Force, OpenSim::MocoPathConstraint, OpenSim::TendonForceLengthCurve, OpenSim::MocoInverse, OpenSim::ModOpScaleActiveFiberForceCurveWidthDGF, OpenSim::ForceVelocityCurve, OpenSim::MocoControlTrackingGoal, OpenSim::ModOpAddExternalLoads, OpenSim::ScalarActuator, OpenSim::MocoFinalBounds, OpenSim::HuntCrossleyForce, OpenSim::MocoInitialBounds, OpenSim::ElasticFoundationForce, OpenSim::MocoCasADiSolver, OpenSim::Probe, OpenSim::ActiveForceLengthCurve, OpenSim::Thelen2003Muscle, OpenSim::ModOpPassiveFiberStrainAtOneNormForceDGF, OpenSim::StreamableReference_< T >, OpenSim::StreamableReference_< SimTK::Rotation_< double > >, OpenSim::Joint, OpenSim::ForceVelocityInverseCurve, OpenSim::Reporter< InputT >, OpenSim::Reporter< T >, OpenSim::DeGrooteFregly2016Muscle, OpenSim::MocoPeriodicityGoal, OpenSim::MocoParameter, OpenSim::MocoStepTimeAsymmetryGoal, OpenSim::ModOpIgnorePassiveFiberForcesDGF, OpenSim::Appearance, OpenSim::ModOpAddReserves, OpenSim::MuscleFixedWidthPennationModel, OpenSim::InducedAccelerationsSolver, OpenSim::MocoDirectCollocationSolver, OpenSim::MocoStudy, OpenSim::MarkersReference, OpenSim::ProbeReporter, OpenSim::MocoGoal, OpenSim::ModelComponent, OpenSim::MocoFrameDistanceConstraint, OpenSim::FirstOrderMuscleActivationDynamics, OpenSim::Frame, OpenSim::ModOpRemoveMuscles, OpenSim::MuscleFirstOrderActivationDynamicModel, OpenSim::AckermannVanDenBogert2010Force, OpenSim::Muscle, OpenSim::Control, OpenSim::CMC, OpenSim::ModOpUseImplicitTendonComplianceDynamicsDGF, OpenSim::IMUInverseKinematicsTool, OpenSim::ModelDisplayHints, OpenSim::MocoStateTrackingGoal, OpenSim::FiberCompressiveForceCosPennationCurve, OpenSim::GCVSpline, OpenSim::OrientationsReference, OpenSim::SmoothSphereHalfSpaceForce, OpenSim::IMUDataReporter, OpenSim::OutputReporter, OpenSim::MocoTropterSolver, OpenSim::InducedAccelerations, OpenSim::Storage, OpenSim::AssemblySolver, OpenSim::MocoMarkerTrackingGoal, OpenSim::ExternalLoads, OpenSim::SimbodyEngine, OpenSim::OffsetFrame< PhysicalFrame >, OpenSim::FiberCompressiveForceLengthCurve, OpenSim::MultivariatePolynomialFunction, OpenSim::MocoAccelerationTrackingGoal, OpenSim::InverseDynamicsTool, OpenSim::VectorFunctionForActuators, OpenSim::MocoStepLengthAsymmetryGoal, OpenSim::MarkerPlacer, OpenSim::ClutchedPathSpring, OpenSim::PointKinematics, OpenSim::VectorFunctionUncoupledNxN, OpenSim::JointReaction, OpenSim::MuscleAnalysis, OpenSim::ControlLinear, OpenSim::GeometryPath, OpenSim::PhysicalFrame, OpenSim::Delp1990Muscle_Deprecated, OpenSim::RigidTendonMuscle, OpenSim::VectorFunction, OpenSim::Analysis, OpenSim::ModelComponentSet< T >, OpenSim::RollingOnSurfaceConstraint, OpenSim::ModelComponentSet< ExternalForce >, OpenSim::ModelComponentSet< ContactGeometry >, OpenSim::ModelComponentSet< WrapObject >, OpenSim::ModelComponentSet< Force >, OpenSim::ModelComponentSet< Joint >, OpenSim::ModelComponentSet< Probe >, OpenSim::ModelComponentSet< Controller >, OpenSim::ModelComponentSet< ModelComponent >, OpenSim::ModelComponentSet< Marker >, OpenSim::ModelComponentSet< Body >, OpenSim::ModelComponentSet< Constraint >, OpenSim::ModOpScaleMaxIsometricForce, OpenSim::MocoWeightSet, OpenSim::ScapulothoracicJoint, OpenSim::RRATool, OpenSim::MuscleActivationDynamics, OpenSim::MocoOrientationTrackingGoal, OpenSim::SurfaceProperties, OpenSim::CoordinateLimitForce, OpenSim::ExpressionBasedPointToPointForce, OpenSim::ExternalForce, OpenSim::CMCTool, OpenSim::Function, OpenSim::Controller, OpenSim::ControlLinearNode, OpenSim::InverseDynamicsSolver, OpenSim::ActivationFiberLengthMuscle, OpenSim::Geometry, OpenSim::CMC_Task, OpenSim::Measurement, OpenSim::Actuation, OpenSim::ObjectGroup, OpenSim::MocoAngularVelocityTrackingGoal, OpenSim::MocoControlGoal, OpenSim::Condition, OpenSim::ExpressionBasedBushingForce, OpenSim::FunctionBasedBushingForce, OpenSim::PathSpring, OpenSim::PrescribedForce, OpenSim::ForwardTool, OpenSim::TwoFrameLinker< Force, PhysicalFrame >, OpenSim::TwoFrameLinker< Constraint, PhysicalFrame >, OpenSim::StatesReporter, OpenSim::MocoJointReactionGoal, OpenSim::MocoTranslationTrackingGoal, OpenSim::ActivationFiberLengthMuscle_Deprecated, OpenSim::BushingForce, OpenSim::Coordinate, OpenSim::CustomJoint, OpenSim::AnalyzeTool, OpenSim::DynamicsTool, OpenSim::GenericModelMaker, OpenSim::OrientationWeightSet, OpenSim::Schutte1993Muscle_Deprecated, OpenSim::TorqueActuator, OpenSim::StaticOptimization, OpenSim::MocoContactTrackingGoalGroup, OpenSim::MocoTool, OpenSim::AbstractTool, OpenSim::Ligament, OpenSim::Reference_< T >, OpenSim::BallJoint, OpenSim::CoordinateCouplerConstraint, OpenSim::Reference_< SimTK::Rotation_< double > >, OpenSim::Reference_< double >, OpenSim::Reference_< SimTK::Vec3 >, OpenSim::BodyActuator, OpenSim::PointActuator, OpenSim::Thelen2003Muscle_Deprecated, OpenSim::ForceReporter, OpenSim::GCVSplineSet, OpenSim::SimmSpline, OpenSim::ControlSet, OpenSim::AnalysisSet, OpenSim::FunctionThresholdCondition, OpenSim::ModelScaler, OpenSim::ScaleTool, OpenSim::PointToPointActuator, OpenSim::PiecewiseConstantFunction, OpenSim::MarkerWeight, OpenSim::Actuator, OpenSim::Point, OpenSim::FreeJoint, OpenSim::TransformAxis, OpenSim::UnilateralConstraint, OpenSim::InverseKinematicsTool, OpenSim::ActivationCoordinateActuator, OpenSim::CoordinateActuator, OpenSim::McKibbenActuator, OpenSim::BodyKinematics, OpenSim::MarkerData, OpenSim::PiecewiseLinearFunction, OpenSim::Scale, OpenSim::StepFunction, OpenSim::ForceSet, OpenSim::JointInternalPowerProbe, OpenSim::ModelVisualPreferences, OpenSim::PhysicalOffsetFrame, OpenSim::IMUPlacer, OpenSim::WeldConstraint, OpenSim::TableProcessor, OpenSim::CMC_Joint, OpenSim::CMC_Point, OpenSim::Tool, OpenSim::FunctionSet, OpenSim::MultiplierFunction, OpenSim::ControlSetController, OpenSim::MomentArmSolver, OpenSim::EllipsoidJoint, OpenSim::CMC_Orientation, OpenSim::CorrectionController, OpenSim::InverseKinematicsToolBase, OpenSim::MeasurementSet, OpenSim::ModelProcessor, OpenSim::LinearFunction, OpenSim::AbstractReporter, OpenSim::Sine, OpenSim::TableSource_< ET >, OpenSim::MocoSumSquaredStateGoal, OpenSim::ControlConstant, OpenSim::CoordinateReference, OpenSim::ExperimentalMarker, OpenSim::WrapObject, OpenSim::CMC_TaskSet, OpenSim::TrackingTask, OpenSim::Set< AbstractPathPoint >, OpenSim::Set< Joint, ModelComponent >, OpenSim::Set< Bhargava2004MuscleMetabolicsProbe_MetabolicMuscleParameter >, OpenSim::Set< Marker, ModelComponent >, OpenSim::Set< Umberger2010MuscleMetabolicsProbe_MetabolicMuscleParameter >, OpenSim::Set< Coordinate >, OpenSim::Set< OpenSim::Constraint >, OpenSim::Set< OpenSim::Actuator >, OpenSim::Set< IKTask >, OpenSim::Set< MocoWeight >, OpenSim::Set< MarkerPair >, OpenSim::Set< T, ModelComponent >, OpenSim::Set< Scale >, OpenSim::Set< OpenSim::Force >, OpenSim::Set< ContactGeometry, ModelComponent >, OpenSim::Set< Controller, ModelComponent >, OpenSim::Set< WrapObject, ModelComponent >, OpenSim::Set< const OpenSim::Actuator >, OpenSim::Set< OpenSim::Muscle >, OpenSim::Set< Function >, OpenSim::Set< Probe, ModelComponent >, OpenSim::Set< ModelComponent, ModelComponent >, OpenSim::Set< OrientationWeight >, OpenSim::Set< Body, ModelComponent >, OpenSim::Set< Constraint, ModelComponent >, OpenSim::Set< ExternalForce, ModelComponent >, OpenSim::Set< TrackingTask >, OpenSim::Set< Measurement >, OpenSim::Set< BodyScale >, OpenSim::Set< Analysis >, OpenSim::Set< Control >, OpenSim::Set< Force, ModelComponent >, OpenSim::SpringGeneralizedForce, OpenSim::Kinematics, OpenSim::ScaleSet, OpenSim::BufferedOrientationsReference, OpenSim::ControllerSet, OpenSim::PathActuator, OpenSim::ExperimentalFrame, OpenSim::PinJoint, OpenSim::UniversalJoint, OpenSim::Constant, OpenSim::AccelerationMotion, OpenSim::PrescribedController, OpenSim::ActuatorPowerProbe, OpenSim::ContactGeometry, OpenSim::Force, OpenSim::Marker, OpenSim::MovingPathPoint, OpenSim::MuscleActiveFiberPowerProbe, OpenSim::SystemEnergyProbe, OpenSim::PointConstraint, OpenSim::Solver, OpenSim::SMC_Joint, OpenSim::ModOpIgnoreTendonCompliance, OpenSim::PolynomialFunction, OpenSim::StorageInterface, OpenSim::MocoControlBoundConstraint, OpenSim::ModOpTendonComplianceDynamicsModeDGF, OpenSim::BodyScale, OpenSim::Constraint, OpenSim::GimbalJoint, OpenSim::PlanarJoint, OpenSim::SpatialTransform, OpenSim::WrapCylinder, OpenSim::WrapEllipsoid, OpenSim::WrapSphere, OpenSim::WrapTorus, OpenSim::MarkerPair, OpenSim::MarkerFrame, OpenSim::SignalGenerator, OpenSim::ActuatorForceProbe, OpenSim::ConditionalPathPoint, OpenSim::JointSet, OpenSim::Station, OpenSim::IMU, OpenSim::PositionMotion, OpenSim::Body, OpenSim::SliderJoint, OpenSim::WeldJoint, OpenSim::PathWrapPoint, OpenSim::IKTaskSet, OpenSim::ConstantMuscleActivation, OpenSim::ComponentSet, OpenSim::Ground, OpenSim::PointToPointSpring, OpenSim::ConstantDistanceConstraint, OpenSim::ZerothOrderMuscleActivationDynamics, OpenSim::MocoInitialForceEquilibriumDGFGoal, OpenSim::BodyScaleSet, OpenSim::ElasticFoundationForce, OpenSim::ProbeSet, OpenSim::PointOnLineConstraint, OpenSim::StatesTrajectoryReporter, OpenSim::WrapObjectSet, OpenSim::IKCoordinateTask, OpenSim::MarkerPairSet, OpenSim::MuscleStateTrackingTask, OpenSim::DiscreteForces, OpenSim::MocoInitialVelocityEquilibriumDGFGoal, OpenSim::AbstractPathPoint, OpenSim::ContactGeometrySet, OpenSim::ContactHalfSpace, OpenSim::HuntCrossleyForce, OpenSim::PathPoint, OpenSim::PathPointSet, OpenSim::MocoPhase, OpenSim::BodySet, OpenSim::ConstraintSet, OpenSim::IKMarkerTask, OpenSim::XsensDataReaderSettings, OpenSim::ContactMesh, OpenSim::CoordinateSet, OpenSim::MarkerSet, OpenSim::IKTask, OpenSim::APDMDataReaderSettings, OpenSim::MocoScaleFactor, OpenSim::ExperimentalSensor, OpenSim::MocoBounds, OpenSim::MocoStepTimeAsymmetryGoalGroup, OpenSim::MocoSolver, OpenSim::Bhargava2004SmoothedMuscleMetabolics_MuscleParameters, OpenSim::ContactSphere, OpenSim::MocoInitialActivationGoal, OpenSim::MocoControlTrackingGoalReference, OpenSim::OrientationWeight, OpenSim::MocoConstraintInfo, OpenSim::ExpressionBasedCoordinateForce, OpenSim::TableOperator, OpenSim::MocoVariableInfo, OpenSim::MocoWeight, OpenSim::ModOpIgnoreActivationDynamics, OpenSim::MocoMarkerFinalGoal, OpenSim::ModelOperator, OpenSim::DiscreteController, OpenSim::StationPlaneContactForce, OpenSim::MocoOutputGoal, OpenSim::ModOpReplaceMusclesWithDeGrooteFregly2016, OpenSim::MocoFrameDistanceConstraintPair, and OpenSim::MocoPeriodicityGoalPair.
Referenced by OpenSim::PropertyObjArray< Control >::appendValue().
|
static |
Get the current setting of debug level.
(Deprecated) Use Log::getLevel() instead.
|
static |
Return a pointer to the default instance of the registered (concrete) Object whose class name is given, or NULL if the type is not registered.
Note that this refers to the default Object instance that is stored with the Object class; do not delete it! If you want a copy of this object instead, use newInstanceOfType(). The given concreteClassName will be mapped through the renamed type table if necessary but the returned object will always have the new type name, which may differ from the supplied one. Note that renaming is applied first, prior to looking up the name in the registered objects table.
const std::string& OpenSim::Object::getDescription | ( | ) | const |
Get description, a one-liner summary.
|
inlineprotected |
Get a const pointer to the document (if any) associated with this object.
std::string OpenSim::Object::getDocumentFileName | ( | ) | const |
If there is a document associated with this object then return the file name maintained by the document.
Otherwise return an empty string.
int OpenSim::Object::getDocumentFileVersion | ( | ) | const |
bool OpenSim::Object::getInlined | ( | ) | const |
Inlined means an in-memory Object that is not associated with an XMLDocument.
const std::string& OpenSim::Object::getName | ( | ) | const |
Get the name of this Object.
Referenced by OpenSim::ProbeReporter::disableIntegrationOnlyProbes(), OpenSim::TableReporter_< InputT, ValueT >::extendFinalizeConnections(), OpenSim::ModelComponentSet< Constraint >::extendFinalizeFromProperties(), and OpenSim::TableProcessor::processAndConvertToRadians().
int OpenSim::Object::getNumProperties | ( | ) | const |
Determine how many properties are stored with this Object.
These are numbered 0..n-1 in the order they were created.
const Property< T > & OpenSim::Object::getProperty | ( | const PropertyIndex & | index | ) | const |
const AbstractProperty& OpenSim::Object::getPropertyByIndex | ( | int | propertyIndex | ) | const |
Get a const reference to a property by its index number, returned as an AbstractProperty.
const AbstractProperty& OpenSim::Object::getPropertyByName | ( | const std::string & | name | ) | const |
Get a const reference to a property by its name, returned as an AbstractProperty.
An exception is thrown if no property by this name is present in this Object.
|
inlineprotected |
Look up a property by name and return its PropertyIndex if it is found.
If no property of that name is present, the returned index will be invalid; check with isValid().
|
inlineprotected |
Look up an unnamed property by the type of object it contains, and return its PropertyIndex if it is found.
If no unnamed property of that type is present, the returned index will be invalid; check with isValid().
|
inline |
OBSOLETE: Get a reference to the PropertySet maintained by the Object.
Referenced by OpenSim::CMC_TaskSet::CMC_TaskSet().
|
inline |
|
inline |
Get references or publications to cite if using this object.
|
inlinestatic |
Return an array of pointers to the default instances of all registered (concrete) Object types that derive from a given Object-derived type that does not have to be concrete.
This is useful, for example, to find all Joints, Constraints, ModelComponents, Analyses, etc.
|
static |
Retrieve all the typenames registered so far.
This is done by traversing the registered objects map, so only concrete classes that have registered instances are returned; renamed types will not appear unless they were separately registered. (Note that even if one registered type has been renamed to another, both will appear in the returned list.) The result returned in typeNames should not be cached while more shared libraries or plugins are loaded, because more types may be registered as a result. Instead the list should be reconstructed whenever in doubt.
|
inlinestatic |
Report the value of the "serialize all defaults" flag.
bool OpenSim::Object::hasProperty | ( | const std::string & | name | ) | const |
Return true if this Object has a property of any type with the given name, which must not be empty.
bool OpenSim::Object::hasProperty | ( | ) | const |
Return true if this Object contains an unnamed, one-object property that contains objects of the given template type T.
The type must match exactly the type used when this property was created with addProperty<T>().
|
inlinevirtual |
The default implementation returns true only if the supplied string is "Object"; each Object-derived class overrides this to match its own class name.
|
inline |
Equality operator wrapper for use from languages not supporting operator overloading.
|
inlinestatic |
Returns true if the passed-in string is "Object"; each Object-derived class defines a method of this name for its own class name.
|
inlinestatic |
Return true if the given concrete object type represents a subclass of the template object type T, and thus could be referenced with a T*.
The object type to be tested is given by its class name as a string. For this to work the name must represent an already-registered object type. If necessary concreteClassName will be mapped through the renamed type table, so we'll return true if the class it maps to satisfies the condition. Note that renaming is applied first, prior to looking up the name in the registered objects table.
|
inline |
Returns true
if no property's value has changed since the last time setObjectIsUpToDateWithProperties() was called.
|
static |
Create an OpenSim object whose type is based on the tag at the root node of the XML file passed in.
This is useful since the constructor of Object doesn't have the proper type info. This works by using the defaults table so that Object does not need to know about its derived classes. It uses the defaults table to get an instance.
|
protected |
Make sure the name of an object is consistent with its property type.
A name can be changed independent of the property name, which may be inconsistent with any restrictions specified by the Property. For example, unnamed property object should not have a name. Furthermore, named properties whose object name is empty, should have the property name.
|
static |
Create a new instance of the concrete Object type whose class name is given as concreteClassName.
The instance is initialized to the default object of corresponding type, possibly after renaming to the current class name. Writes a message to stderr and returns null if the tag isn't registered.
|
virtual |
Provide an ordering for objects so they can be put in sorted containers.
Copy assignment copies he base class fields, including the properties.
|
virtual |
Determine if two objects are equal.
They are equal if all the simple base class members are equal, both objects have the same number of properties and corresponding properties are equal, and if the objects are the same concrete type and the concrete class says they are equal. Concrete object classes must override this if they have any fields to compare, but be sure to invoke the base class operator too. To print information about the exact differences, set the debug level (setDebugLevel()) to a number greater than 0.
bool OpenSim::Object::print | ( | const std::string & | fileName | ) | const |
Write this Object into an XML file of the given name; conventionally the suffix to use is ".osim".
This is useful for writing out a Model that has been created programmatically, and also very useful for testing and debugging. If object has invalid connections, then printing is aborted. You can override this behavior by setting the debug level to at least 1 (e.g., Object::setDebugLevel(1)) prior to printing.
|
static |
Dump formatted property information to a given output stream, useful for creating a "help" facility for registered objects.
Object name, property name, and property comment are output. Input is a class name and property name. If the property name is the empty string or just "*", then information for all properties in the class is printed. If the class name is empty, information in all properties of all registered classes is printed.
os | Output stream to which info is printed. |
classNameDotPropertyName | A string combining the class name and property name. The two names should be separated by a period (ClassName.PropertyName). If PropertyName is empty or "*", the information for all properties in the class is printed. If ClassName is empty, the information for the properties of all registered classes is printed. |
printFlagInfo | Print to the ostream some instructions for using the -PropertyInfo command line flag. |
Returns false if the provided names do not match known classes or properties; otherwise, returns true.
|
static |
Same as the other signature but the class name and property name are provided as two separate strings.
Returns false if the provided names do not match known classes or properties; otherwise, returns true.
void OpenSim::Object::readObjectFromXMLNodeOrFile | ( | SimTK::Xml::Element & | objectElement, |
int | versionNumber | ||
) |
We're given an XML element from which we are to populate this Object.
If the element has a file
attribute, we'll instead read the Object from that file. Otherwise we'll invoke updateFromXMLNode() to read the Object directly from the supplied element. Note that a relative file name will be interpreted relative to the current working directory, but that will normally have been set earlier to the directory containing the top-level (root) Object, such as the Model file.
|
static |
Register an instance of a class; if the class is already registered it will be replaced.
This is normally called as part of the static initialization of a dynamic library (DLL). The supplied object's concrete class name will be used as a key, and a copy (via clone()) of the supplied Object is used as the default value for objects of this type when created (typically during the deserialization process when reading an XML file).
|
inlinestatic |
OBSOLETE alternate name for registerType().
|
static |
Support versioning by associating the current Object type with an old name.
This is only allowed if newTypeName has already been registered with registerType(). Renaming is applied first prior to lookup so can be used both for translating now-obsolete names to their new names and for overriding one registered type with another.
|
inlinestatic |
OBSOLETE alternate name for renameType().
void OpenSim::Object::setAllPropertiesUseDefault | ( | bool | aUseDefault | ) |
|
inline |
Set Authors of this object.
Call this method in your constructor if needed.
|
static |
Set the amount of logging output.
Higher numbers generate more logging output.
void OpenSim::Object::setDescription | ( | const std::string & | description | ) |
Set description, a one-liner summary.
|
inlineprotected |
Unconditionally set the XMLDocument associated with this object.
Use carefully – if there was already a document its heap space is lost here.
void OpenSim::Object::setInlined | ( | bool | aInlined, |
const std::string & | aFileName = "" |
||
) |
Mark this as inlined or not and optionally provide a file name to associate with the new XMLDocument for the non-inline case.
If there was already a document associated with this object it is deleted.
void OpenSim::Object::setName | ( | const std::string & | name | ) |
Set the name of the Object.
Referenced by OpenSim::ModelComponentSet< Constraint >::extendFinalizeFromProperties(), OpenSim::Reference_< SimTK::Vec3 >::Reference_(), and OpenSim::Set< Force, ModelComponent >::renameGroup().
|
protected |
When an object is initialized using the current values of its properties, it can set a flag indicating that it is up to date.
This flag is automatically cleared when any property is modified. This allows objects to avoid expensive reinitialization if it is unnecessary (that is, whenever this Object hands out writable access to a property). Note that use of this flag is entirely optional; most Object classes don't have any expensive initialization to worry about.
This flag is cleared automatically but if you want to clear it manually for testing or debugging, see clearObjectIsUpToDateWithProperties().
|
inline |
Set references or publications to cite if using this object.
|
inlinestatic |
Static function to control whether all registered objects and their properties are written to the defaults section of output files rather than only those values for which the default was explicitly overwritten when read in from an input file or set programmatically.
const std::string& OpenSim::Object::toString | ( | ) | const |
Wrapper to be used on Java side to display objects in tree; this returns just the object's name.
|
protected |
Use this method only if you're deserializing from a file and the object is at the top level; that is, primarily in constructors that take a file name as input.
|
virtual |
Use this method to deserialize an object from a SimTK::Xml::Element.
The element is assumed to be in the format consistent with the passed-in versionNumber. If there is a file attribute in objectElement it will be ignored; if you want it processed you should call readObjectFromXMLNodeOrFile() instead.
Reimplemented in OpenSim::Component, OpenSim::Model, OpenSim::AbstractTool, OpenSim::Joint, OpenSim::ModelComponent, OpenSim::Coordinate, OpenSim::Force, OpenSim::TwoFrameLinker< Force, PhysicalFrame >, OpenSim::TwoFrameLinker< Constraint, PhysicalFrame >, OpenSim::Probe, OpenSim::RRATool, OpenSim::PhysicalFrame, OpenSim::RollingOnSurfaceConstraint, OpenSim::ContactGeometry, OpenSim::WrapObject, OpenSim::GCVSpline, OpenSim::Controller, OpenSim::CustomJoint, OpenSim::PointToPointSpring, OpenSim::Appearance, OpenSim::PrescribedForce, OpenSim::SimmSpline, OpenSim::PiecewiseLinearFunction, OpenSim::Constraint, OpenSim::ConstantDistanceConstraint, OpenSim::CMC_Joint, OpenSim::ForwardTool, OpenSim::CMC_Point, OpenSim::InverseDynamicsTool, OpenSim::ExternalLoads, OpenSim::PointConstraint, OpenSim::AbstractPathPoint, OpenSim::Marker, OpenSim::InverseKinematicsTool, OpenSim::MovingPathPoint, and OpenSim::PointOnLineConstraint.
void OpenSim::Object::updateXMLNode | ( | SimTK::Xml::Element & | parent, |
const AbstractProperty * | prop = nullptr |
||
) | const |
Serialize this object into the XML node that represents it.
parent | Parent XML node of this object. Sending in a parent node allows an XML node to be generated for this object if it doesn't already have one. If no parent node is supplied and this object doesn't already have an XML node, this object will become the root node for a new XML document. If this object already has an XML node associated with it, no new nodes are ever generated and the parent node is not used. |
prop | (optional) The pointer to the property that contains this object. If it is present, check if the property is unnamed and if NOT, use the property name as its name when updating the XML node. |
|
inlineprotected |
Get a writable pointer to the document (if any) associated with this object.
Property< T > & OpenSim::Object::updProperty | ( | const PropertyIndex & | index | ) |
AbstractProperty& OpenSim::Object::updPropertyByIndex | ( | int | propertyIndex | ) |
Get a writable reference to a property by its index number, returned as an AbstractProperty.
AbstractProperty& OpenSim::Object::updPropertyByName | ( | const std::string & | name | ) |
Get a writable reference to a property by its name, returned as an AbstractProperty.
An exception is thrown if no property by this name is present in this Object.