Public Member Functions |
| Delp1990Muscle_Deprecated () |
| Delp1990Muscle_Deprecated (const std::string &aName, double aMaxIsometricForce, double aOptimalFiberLength, double aTendonSlackLength, double aPennationAngle) |
| Delp1990Muscle_Deprecated (const Delp1990Muscle_Deprecated &aMuscle) |
virtual | ~Delp1990Muscle_Deprecated () |
Delp1990Muscle_Deprecated & | operator= (const Delp1990Muscle_Deprecated &aMuscle) |
void | copyData (const Delp1990Muscle_Deprecated &aMuscle) |
virtual double | getTimeScale () const |
virtual double | getMass () const |
virtual bool | setTimeScale (double aTimeScale) |
virtual bool | setActivation1 (double aActivation1) |
virtual bool | setActivation2 (double aActivation2) |
virtual bool | setMass (double aMass) |
virtual double | getFiberVelocity (const SimTK::State &s) const |
| get current fiber velocity (m/s) positive is lengthening
|
virtual void | setFiberVelocity (SimTK::State &s, double fiberVelocity) const |
virtual double | getFiberVelocityDeriv (const SimTK::State &s) const |
virtual void | setFiberVelocityDeriv (const SimTK::State &s, double fiberVelocityDeriv) const |
virtual void | setActiveForce (const SimTK::State &s, double aForce) const |
virtual double | getActiveForce (const SimTK::State &s) const |
virtual double | computeActuation (const SimTK::State &s) const |
| Actuator interface for a muscle computes the tension in the muscle and applied by the tendon to bones (i.e.
|
virtual double | computeIsometricForce (SimTK::State &s, double activation) const |
virtual Function * | getActiveForceLengthCurve () const |
virtual bool | setActiveForceLengthCurve (Function *aActiveForceLengthCurve) |
virtual Function * | getPassiveForceLengthCurve () const |
virtual bool | setPassiveForceLengthCurve (Function *aPassiveForceLengthCurve) |
virtual Function * | getTendonForceLengthCurve () const |
virtual bool | setTendonForceLengthCurve (Function *aTendonForceLengthCurve) |
virtual Function * | getForceVelocityCurve () const |
virtual bool | setForceVelocityCurve (Function *aForceVelocityCurve) |
| ActivationFiberLengthMuscle_Deprecated () |
virtual void | equilibrate (SimTK::State &state) const |
| Find and set the equilibrium state of the muscle (if any)
|
virtual double | getDefaultActivation () const |
virtual void | setDefaultActivation (double activation) |
virtual double | getDefaultFiberLength () const |
virtual void | setDefaultFiberLength (double length) |
virtual double | getFiberLength (const SimTK::State &s) const |
| get the current working fiber length (m) for the muscle
|
virtual void | setFiberLength (SimTK::State &s, double fiberLength) const |
virtual double | getFiberLengthDeriv (const SimTK::State &s) const |
virtual void | setFiberLengthDeriv (const SimTK::State &s, double fiberLengthDeriv) const |
virtual double | getNormalizedFiberLength (const SimTK::State &s) const |
| get the current normalized fiber length (fiber_length/optimal_fiber_length)
|
virtual double | getFiberLengthAlongTendon (const SimTK::State &s) const |
| get the current fiber length (m) projected (*cos(pennationAngle)) onto the tendon direction
|
virtual double | getTendonLength (const SimTK::State &s) const |
| get the current tendon length (m) given the current joint angles and fiber length
|
virtual double | getFiberForce (const SimTK::State &s) const |
| get the current fiber force (N) applied to the tendon
|
virtual double | getActiveFiberForce (const SimTK::State &s) const |
| get the current active fiber force (N) due to activation*force_length*force_velocity relationships
|
virtual double | getPassiveFiberForce (const SimTK::State &s) const |
| get the current passive fiber force (N) passive_force_length relationship
|
virtual double | getActiveFiberForceAlongTendon (const SimTK::State &s) const |
| get the current active fiber force (N) projected onto the tendon direction
|
virtual double | getPassiveFiberForceAlongTendon (const SimTK::State &s) const |
| get the current passive fiber force (N) projected onto the tendon direction
|
virtual double | getPassiveForce (const SimTK::State &s) const |
virtual void | setPassiveForce (const SimTK::State &s, double aForce) const |
virtual double | getTendonForce (const SimTK::State &s) const |
| get the current tendon force (N) applied to bones
|
virtual void | setTendonForce (const SimTK::State &s, double aForce) const |
virtual double | getActivation (const SimTK::State &s) const |
| get the activation level of the muscle, which modulates the active force of the muscle and has a normalized (0 to 1) value TODO: virtual to allow override by deprecated muscles.
|
virtual void | setActivation (SimTK::State &s, double activation) const |
| DEPRECATED: only for backward compatibility.
|
virtual double | getActivationDeriv (const SimTK::State &s) const |
virtual void | setActivationDeriv (const SimTK::State &s, double activationDeriv) const |
virtual double | getExcitation (const SimTK::State &s) const |
virtual double | getStress (const SimTK::State &s) const |
| get the stress in the muscle (part of the Actuator interface as well)
|
virtual void | computeInitialFiberEquilibrium (SimTK::State &s) const |
| compute initial fiber length (velocity) such that muscle fiber and tendon are in static equilibrium and update the state
|
virtual double | calcInextensibleTendonActiveFiberForce (SimTK::State &s, double aActivation) const |
virtual double | evaluateForceLengthVelocityCurve (double aActivation, double aNormalizedLength, double aNormalizedVelocity) const |
virtual double | calcPennation (double aFiberLength, double aOptimalFiberLength, double aInitialPennationAngle) const |
virtual Array< std::string > | getStateVariableNames () const |
| Get the names of "continuous" state variables maintained by the ModelComponent and its subcomponents.
|
virtual SimTK::SystemYIndex | getStateVariableSystemIndex (const std::string &stateVariableName) const |
| Get the System Index of a state variable allocated by this ModelComponent.
|
| OpenSim_DECLARE_PROPERTY (max_isometric_force, double,"Maximum isometric force that the fibers can generate") |
| OpenSim_DECLARE_PROPERTY (optimal_fiber_length, double,"Optimal length of the muscle fibers") |
| OpenSim_DECLARE_PROPERTY (tendon_slack_length, double,"Resting length of the tendon") |
| OpenSim_DECLARE_PROPERTY (pennation_angle_at_optimal, double,"Angle between tendon and fibers at optimal fiber length expressed in radians") |
| OpenSim_DECLARE_PROPERTY (max_contraction_velocity, double,"Maximum contraction velocity of the fibers, in optimal fiberlengths/second") |
| OpenSim_DECLARE_PROPERTY (ignore_tendon_compliance, bool,"Compute muscle dynamics ignoring tendon compliance. Tendon is assumed to be rigid.") |
| OpenSim_DECLARE_PROPERTY (ignore_activation_dynamics, bool,"Compute muscle dynamics ignoring activation dynamics. Activation is equivalent to excitation.") |
| Muscle () |
| Default constructor.
|
double | getMaxIsometricForce () const |
| get/set the maximum isometric force (in N) that the fibers can generate
|
void | setMaxIsometricForce (double maxIsometricForce) |
double | getOptimalFiberLength () const |
| get/set the optimal length (in m) of the muscle fibers (lumped as a single fiber)
|
void | setOptimalFiberLength (double optimalFiberLength) |
double | getTendonSlackLength () const |
| get/set the resting (slack) length (in m) of the tendon that is in series with the muscle fiber
|
void | setTendonSlackLength (double tendonSlackLength) |
double | getPennationAngleAtOptimalFiberLength () const |
| get/set the angle (in radians) between fibers at their optimal fiber length and the tendon
|
void | setPennationAngleAtOptimalFiberLength (double pennationAngle) |
double | getMaxContractionVelocity () const |
| get/set the maximum contraction velocity of the fibers, in optimal fiber-lengths per second
|
void | setMaxContractionVelocity (double maxContractionVelocity) |
bool | getIgnoreTendonCompliance (const SimTK::State &s) const |
| Get/set Modeling (runtime) option to ignore tendon compliance when
computing muscle dynamics.
|
void | setIgnoreTendonCompliance (SimTK::State &s, bool ignore) const |
bool | getIgnoreActivationDynamics (const SimTK::State &s) const |
| Get/set Modeling (runtime) option to ignore activation dynamics when
computing muscle dynamics.
|
void | setIgnoreActivationDynamics (SimTK::State &s, bool ignore) const |
double | getPennationAngle (const SimTK::State &s) const |
| get the current pennation angle (radians) between the fiber and tendon at the current fiber length
|
double | getTendonStrain (const SimTK::State &s) const |
| get the current tendon strain (delta_l/tendon_slack_length is dimensionless)
|
double | getFiberPotentialEnergy (const SimTK::State &s) const |
| the potential energy (J) stored in the fiber due to its parallel elastic element
|
double | getTendonPotentialEnergy (const SimTK::State &s) const |
| the potential energy (J) stored in the tendon
|
double | getMusclePotentialEnergy (const SimTK::State &s) const |
| the total potential energy (J) stored in the muscle
|
double | getPassiveForceMultiplier (const SimTK::State &s) const |
| get the passive fiber (parallel elastic element) force multiplier
|
double | getActiveForceLengthMultiplier (const SimTK::State &s) const |
| get the active fiber (contractile element) force multiplier due to current fiber length
|
double | getNormalizedFiberVelocity (const SimTK::State &s) const |
| get normalize fiber velocity (fiber_lengths/s / max_contraction_velocity)
|
double | getFiberVelocityAlongTendon (const SimTK::State &s) const |
| get the current afiber velocity (m/s) projected onto the tendon direction
|
double | getPennationAngularVelocity (const SimTK::State &s) const |
| get pennation angular velocity (radians/s)
|
double | getTendonVelocity (const SimTK::State &s) const |
| get the tendon velocity (m/s) positive is lengthening
|
double | getForceVelocityMultiplier (const SimTK::State &s) const |
| get the dimensionless multiplier resulting from the fiber's force-velocity curve
|
double | getFiberStiffness (const SimTK::State &s) const |
| get the current fiber stiffness (N/m) defined as the partial derivative of fiber force w.r.t.
|
double | getTendonStiffness (const SimTK::State &s) const |
| get the current tendon stiffness (N/m) defined as the partial derivative of tendon force w.r.t.
|
double | getMuscleStiffness (const SimTK::State &s) const |
| get the current muscle stiffness (N/m) defined as the partial derivative of muscle force w.r.t.
|
double | getFiberActivePower (const SimTK::State &s) const |
| get the current active fiber power (W)
|
double | getFiberPassivePower (const SimTK::State &s) const |
| get the current passive fiber power (W)
|
double | getTendonPower (const SimTK::State &s) const |
| get the current tendon power (W)
|
double | getMusclePower (const SimTK::State &s) const |
| get the current muscle power (W)
|
void | setExcitation (SimTK::State &s, double excitation) const |
| set the excitation (control) for this muscle.
|
| PathActuator () |
GeometryPath & | updGeometryPath () |
const GeometryPath & | getGeometryPath () const |
virtual bool | hasGeometryPath () const |
| Return a flag indicating whether the Force is applied along a Path.
|
void | setOptimalForce (double aOptimalForce) |
double | getOptimalForce () const |
virtual double | getLength (const SimTK::State &s) const |
virtual double | getLengtheningSpeed (const SimTK::State &s) const |
virtual double | getPower (const SimTK::State &s) const |
void | addNewPathPoint (const std::string &proposedName, OpenSim::Body &aBody, const SimTK::Vec3 &aPositionOnBody) |
| Note that this function does not maintain the State and so should be used only before a valid State is created.
|
virtual double | computeMomentArm (SimTK::State &s, Coordinate &aCoord) const |
virtual void | updateFromXMLNode (SimTK::Xml::Element &aNode, int versionNumber=-1) |
| Use this method to deserialize an object from a SimTK::Xml::Element.
|
virtual void | preScale (const SimTK::State &s, const ScaleSet &aScaleSet) |
virtual void | scale (const SimTK::State &s, const ScaleSet &aScaleSet) |
virtual VisibleObject * | getDisplayer () const |
| Methods to support making the object displayable in the GUI or Visualizer Implemented only in few objects.
|
virtual void | updateDisplayer (const SimTK::State &s) |
| In case the ModelComponent has a visual representation (VisualObject), override this method to update it.
|
| OpenSim_DECLARE_UNNAMED_PROPERTY (GeometryPath,"The set of points defining the path of the muscle.") |
| OpenSim_DECLARE_PROPERTY (optimal_force, double,"The maximum force this actuator can produce.") |
| Actuator () |
virtual double | getControl (const SimTK::State &s) const |
| Convenience method to set controls given scalar (double) valued control.
|
virtual int | numControls () const |
virtual void | setForce (const SimTK::State &s, double aForce) const |
virtual double | getForce (const SimTK::State &s) const |
virtual void | setSpeed (const SimTK::State &s, double aspeed) const |
virtual double | getSpeed (const SimTK::State &s) const |
void | setMinControl (const double &aMinControl) |
double | getMinControl () const |
void | setMaxControl (const double &aMaxControl) |
double | getMaxControl () const |
void | overrideForce (SimTK::State &s, bool flag) const |
|
Overriding forces
The force normally produced by an Actuator can be overriden and When the Actuator's force is overriden, the Actuator will by defualt produce a constant force which can be set with setOverrideForce().
|
bool | isForceOverriden (const SimTK::State &s) const |
| return Actuator's override status
|
void | setOverrideForce (SimTK::State &s, double value) const |
| set the force value used when the override is true
|
double | getOverrideForce (const SimTK::State &s) const |
| return override force
|
| OpenSim_DECLARE_PROPERTY (min_control, double,"Minimum allowed value for control signal. Used primarily when solving ""for control values.") |
| Default is -Infinity (no limit).
|
| OpenSim_DECLARE_PROPERTY (max_control, double,"Maximum allowed value for control signal. Used primarily when solving ""for control values.") |
| Default is Infinity (no limit).
|
| Actuator_ () |
virtual const SimTK::Vector | getDefaultControls () |
| Actuator default controls are zero.
|
virtual const
SimTK::VectorView_< double > | getControls (const SimTK::State &s) const |
virtual void | getControls (const SimTK::Vector &modelControls, SimTK::Vector &actuatorControls) const |
| Convenience methods for getting, setting and adding to actuator controls from/into the model controls.
|
virtual void | setControls (const SimTK::Vector &actuatorControls, SimTK::Vector &modelControls) const |
| set actuator controls subvector into the right slot in the system-wide model controls
|
virtual void | addInControls (const SimTK::Vector &actuatorControls, SimTK::Vector &modelControls) const |
| add actuator controls to the values already occupying the slot in the system-wide model controls
|
virtual void | computeEquilibrium (SimTK::State &s) const |
| Force (const Force &aForce) |
| Implements a copy constructor just so it can invalidate the
SimTK::Force index after copying.
|
Force & | operator= (const Force &aForce) |
| Implements a copy assignment operator just so it can invalidate the
SimTK::Force index after the assignment.
|
bool | isDisabled (const SimTK::State &s) const |
| Return if the Force is disabled or not.
|
void | setDisabled (SimTK::State &s, bool disabled) |
| Set the Force as disabled (true) or not (false).
|
| OpenSim_DECLARE_PROPERTY (isDisabled, bool,"Flag indicating whether the force is disabled or not. Disabled means"" that the force is not active in subsequent dynamics realizations.") |
| A Force element is active (enabled) by default.
|
| ModelComponent () |
| Default constructor.
|
| ModelComponent (const std::string &aFileName, bool aUpdateFromXMLNode=true) SWIG_DECLARE_EXCEPTION |
| Construct ModelComponent from an XML file.
|
| ModelComponent (SimTK::Xml::Element &aNode) |
| Construct ModelComponent from a specific node in an XML document.
|
| ModelComponent (const ModelComponent &source) |
| Construct ModelComponent with its contents copied from another
ModelComponent; this is a deep copy so nothing is shared with the source after the copy.
|
virtual | ~ModelComponent () |
| Destructor is virtual to allow concrete model component cleanup.
|
ModelComponent & | operator= (const ModelComponent &aModelComponent) |
| Assignment operator to copy contents of an existing component.
|
const Model & | getModel () const |
| Get a const reference to the Model this component is part of.
|
Model & | updModel () |
| Get a modifiable reference to the Model this component is part of.
|
virtual int | getNumStateVariables () const |
| Get the number of "Continuous" state variables maintained by the ModelComponent and its specified subcomponents.
|
int | getModelingOption (const SimTK::State &state, const std::string &name) const |
| Get a ModelingOption flag for this ModelComponent by name.
|
void | setModelingOption (SimTK::State &state, const std::string &name, int flag) const |
| Set the value of a ModelingOption flag for this ModelComponent.
|
double | getStateVariable (const SimTK::State &state, const std::string &name) const |
| Get the value of a state variable allocated by this ModelComponent.
|
void | setStateVariable (SimTK::State &state, const std::string &name, double value) const |
| Set the value of a state variable allocated by this ModelComponent by name.
|
double | getDiscreteVariable (const SimTK::State &state, const std::string &name) const |
| Get the value of a discrete variable allocated by this ModelComponent by name.
|
void | setDiscreteVariable (SimTK::State &state, const std::string &name, double value) const |
| Set the value of a discrete variable allocated by this ModelComponent by name.
|
template<typename T > |
const T & | getCacheVariable (const SimTK::State &state, const std::string &name) const |
| Get the value of a cache variable allocated by this ModelComponent by name.
|
template<typename T > |
T & | updCacheVariable (const SimTK::State &state, const std::string &name) const |
| Obtain a writable cache variable value allocated by this ModelComponent by name.
|
void | markCacheVariableValid (const SimTK::State &state, const std::string &name) const |
| After updating a cache variable value allocated by this ModelComponent, you can mark its value as valid, which will not change until the realization stage falls below the minimum set at the time the cache variable was created.
|
void | markCacheVariableInvalid (const SimTK::State &state, const std::string &name) const |
| Mark a cache variable value allocated by this ModelComponent as invalid.
|
bool | isCacheVariableValid (const SimTK::State &state, const std::string &name) const |
| Enables the to monitor the validity of the cache variable value using the returned flag.
|
template<typename T > |
void | setCacheVariable (const SimTK::State &state, const std::string &name, T &value) const |
| Set cache variable value allocated by this ModelComponent by name.
|
virtual | ~Object () |
| Virtual destructor for cleanup.
|
virtual Object * | clone () const =0 |
| Create a new heap-allocated copy of the concrete object to which this
Object refers.
|
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.
|
virtual VisibleObject * | updDisplayer () |
| get Non const pointer to VisibleObject
|
bool | isEqualTo (const Object &aObject) const |
| Equality operator wrapper for use from languages not supporting operator overloading.
|
Object & | operator= (const Object &aObject) |
| Copy assignment copies he base class fields, including the
properties.
|
virtual bool | operator== (const Object &aObject) const |
| Determine if two objects are equal.
|
virtual bool | operator< (const Object &aObject) const |
| Provide an ordering for objects so they can be put in sorted
containers.
|
void | setName (const std::string &name) |
| Set the name of the Object.
|
const std::string & | getName () const |
| Get the name of this Object.
|
void | setDescription (const std::string &description) |
| Set description, a one-liner summary.
|
const std::string & | getDescription () const |
| Get description, a one-liner summary.
|
const std::string & | getAuthors () const |
| Get Authors of this Object.
|
void | setAuthors (const std::string &authors) |
| Set Authors of this object, call this method in your constructor if needed.
|
const std::string & | getReferences () const |
| Get references or publications to cite if using this object.
|
void | setReferences (const std::string &references) |
| Set references or publications to cite if using this object.
|
int | getNumProperties () const |
| Determine how many properties are stored with this Object.
|
const AbstractProperty & | getPropertyByIndex (int propertyIndex) const |
| Get a const reference to a property by its index number, returned as
an AbstractProperty.
|
AbstractProperty & | updPropertyByIndex (int propertyIndex) |
| Get a writable reference to a property by its index number, returned as
an AbstractProperty.
|
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.
|
const AbstractProperty & | getPropertyByName (const std::string &name) const |
| Get a const reference to a property by its name, returned as
an AbstractProperty.
|
AbstractProperty & | updPropertyByName (const std::string &name) |
| Get a writable reference to a property by its name, returned as
an AbstractProperty.
|
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.
|
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.
|
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.
|
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.
|
bool | isObjectUpToDateWithProperties () const |
| Returns \c true if any property's value has changed since the last time
setObjectIsUpToDateWithProperties() was called.
|
void | readObjectFromXMLNodeOrFile (SimTK::Xml::Element &objectElement, int versionNumber) |
| We're given an XML element from which we are to populate this Object.
|
virtual void | updateXMLNode (SimTK::Xml::Element &parent) |
| Serialize this object into the XML node that represents it.
|
bool | getInlined () const |
| Inlined means an in-memory Object that is not associated with
an XMLDocument.
|
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.
|
std::string | getDocumentFileName () const |
| If there is a document associated with this object then return the
file name maintained by the document.
|
void | setAllPropertiesUseDefault (bool aUseDefault) |
bool | print (const std::string &fileName) |
| Write this %Object into an XML file of the given name; conventionally
the suffix to use is ".osim".
|
std::string | dump (bool dumpName=false) |
| dump the XML representation of this Object into an std::string and return it.
|
void | clearObjectIsUpToDateWithProperties () |
| For testing or debugging purposes, manually clear the "object is up to
date with respect to properties" flag.
|
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.
|
const std::string & | toString () const |
| Wrapper to be used on Java side to display objects in tree; this returns
just the object's name.
|
PropertySet & | getPropertySet () |
| OBSOLETE: Get a reference to the PropertySet maintained by the
Object.
|
const PropertySet & | getPropertySet () const |