artisynth.core.opensim.components

Class MultiPointMuscleOsim

java.lang.Object

artisynth.core.modelbase.ModelComponentBase

artisynth.core.mechmodels.Spring

artisynth.core.mechmodels.PointSpringBase

artisynth.core.mechmodels.MultiPointSpring

artisynth.core.mechmodels.MultiPointMuscle

artisynth.core.opensim.components.MultiPointMuscleOsim

All Implemented Interfaces:

ExcitationComponent, ForceComponent, ForceEffector, HasSlaveObjects, MuscleComponent, RequiresPrePostAdvance, ComponentChangeListener, CompositeComponent, CopyableComponent, HasNumericState, IndexedComponentList, ModelComponent, PostScannable, RenderableComponent, TransformableGeometry, ScalableUnits, java.lang.Cloneable, HasProperties, HierarchyNode, HasRenderProps, IsRenderable, IsSelectable, Renderable, Scannable

public class MultiPointMuscleOsim
extends MultiPointMuscle
implements CompositeComponent

Extension to ArtiSynth MultiPointMuscle component that contains its path points in a component list named "pathpoints".

Nested Class Summary

Nested classes/interfaces inherited from class artisynth.core.mechmodels.MultiPointSpring

MultiPointSpring.Segment, MultiPointSpring.SegmentSpec, MultiPointSpring.SubSegment, MultiPointSpring.WrapKnot, MultiPointSpring.WrapSegment

Nested classes/interfaces inherited from interface artisynth.core.modelbase.CompositeComponent

CompositeComponent.NavpanelDisplay

Nested classes/interfaces inherited from interface artisynth.core.modelbase.ModelComponent

ModelComponent.FilePathSaveType, ModelComponent.NavpanelVisibility

Nested classes/interfaces inherited from interface artisynth.core.mechmodels.ExcitationComponent

ExcitationComponent.CombinationRule

Field Summary

Fields inherited from class artisynth.core.mechmodels.MultiPointMuscle

myProps

Fields inherited from class artisynth.core.mechmodels.MultiPointSpring

maxForceNorm, maxLengthErr, myDebug, myDrawWrapPoints, sumForceNorm, sumLengthErr, totalCalls, totalFails, totalFalseStuck, totalStuck

Fields inherited from class artisynth.core.mechmodels.PointSpringBase

myIgnoreCoriolisInJacobian, useMaterial

Fields inherited from class artisynth.core.modelbase.ModelComponentBase

enforceUniqueCompositeNames, enforceUniqueNames, myNumber, NULL_OBJ, useCompactPathNames

Fields inherited from interface maspack.render.IsRenderable

TRANSPARENT, TWO_DIMENSIONAL

Fields inherited from interface artisynth.core.modelbase.TransformableGeometry

TG_ARTICULATED, TG_DRAGGER, TG_PRESERVE_ORIENTATION, TG_SIMULATING

Fields inherited from interface artisynth.core.modelbase.CopyableComponent

COPY_REFERENCES, REST_POSITION

Constructor Summary

Constructors

Constructor and Description
MultiPointMuscleOsim()
MultiPointMuscleOsim(java.lang.String name)

Method Summary

Modifier and Type	Method and Description
void	add(ModelComponent comp)
void	componentChanged(ComponentChangeEvent e) Notifies this composite component that a change has occured within one or more of its descendants.
ModelComponent	findComponent(java.lang.String path) Recursively searches for a subcomponent of this ModelComponent, identified by a path of component names.
ModelComponent	get(int idx) Returns a specific subcomponent of this ModelComponent, identified by index.
ModelComponent	get(java.lang.String nameOrNumber) Returns a specific subcomponent of this ModelComponent, identified by name or string representation of the subcomponent's number
ModelComponent	getByNumber(int num) Returns a specific subcomponent of this ModelComponent, identified by number.
java.util.Iterator<? extends HierarchyNode>	getChildren()
CompositeComponent.NavpanelDisplay	getNavpanelDisplay() Returns the DisplayMode for this component.
int	getNumberLimit() Returns the current upper limit for numbers among all subcomponents in this composite.
PointList<Marker>	getPathPoints()
boolean	hasChildren()
boolean	hierarchyContainsReferences() Returns true if the component hierarchy formed by this component and its descendents is closed with respect to references.
int	indexOf(ModelComponent comp) Returns the index of a specified subcomponent, or -1 if that the component is not present.
int	numComponents() Returns the number of components in this CompositeComponent.
void	postscan(java.util.Deque<ScanToken> tokens, CompositeComponent ancestor) Performs any required post-scanning for this component.
void	prerender(RenderList list) Called prior to rendering to allow this object to update the internal state required for rendering (such as by caching rendering coordinates).
boolean	remove(ModelComponent comp)
void	scan(ReaderTokenizer rtok, java.lang.Object ref) Scans this element from a ReaderTokenizer.
void	setDisplayMode(CompositeComponent.NavpanelDisplay mode) Sets the display mode for this component.
void	updateNameMap(java.lang.String newName, java.lang.String oldName, ModelComponent comp)

Methods inherited from class artisynth.core.mechmodels.MultiPointMuscle

addExcitationSource, computeDFdl, computeDFdldot, computeF, computePassiveF, createConstant, createConstant, createLinear, createLinear, createPai, createPai, createPeck, createPeck, createPeck, getAllPropertyInfo, getCombinationRule, getExcitation, getExcitationColor, getExcitationColorMode, getExcitationGain, getForceNorm, getJacobianType, getMaxColoredExcitation, getMaxColoredExcitationMode, getNetExcitation, getPassiveForceNorm, getRenderColor, getSoftReferences, getState, hasState, isEnabled, removeExcitationSource, resetLengthProps, scaleDistance, scaleMass, setCombinationRule, setEnabled, setExcitation, setExcitationColor, setExcitationColorMode, setExcitationGain, setMaxColoredExcitation, setMaxColoredExcitationMode, setState, updateReferences

Methods inherited from class artisynth.core.mechmodels.MultiPointSpring

addPoint, addPoint, addPosJacobian, addPosJacobianOld, addSegmentPosBlocks, addSegmentVelBlocks, addSolveBlocks, addTransformableDependencies, addVelJacobian, addVelJacobianOld, addWrappable, addWrappable, applyForces, clearPoints, clearWrappables, clearWrappableSegment, containsWrappable, containsWrappable, copy, getABPointColor, getActiveLength, getActiveLengthDot, getAllABPoints, getContactCount, getContactDamping, getContactingKnotsColor, getContactStiffness, getConvergedCount, getConvergenceTol, getCopyReferences, getDebugLevel, getDrawABPoints, getDrawDisplacements, getDrawKnots, getHardReferences, getInitializingPoints, getIterationCount, getKnot, getLength, getLengthDot, getLineSearch, getMaxWrapDisplacement, getMaxWrapIterations, getNumKnots, getPoint, getPrintProfiling, getProfileCount, getProfileTimeUsec, getProfiling, getSegment, getSegments, getSegmentSpec, getSor, getStateVersion, getUpdateContactsCount, getWrapDamping, getWrapKnotDensity, getWrapKnotDensityMode, getWrappable, getWrappableRange, getWrappables, getWrapStiffness, hasConditionalPoints, hasMovingMarkers, hasWrappableSegments, indexOfPoint, indexOfWrappable, indexOfWrappable, initializeSegment, isDuplicatable, isSegmentPassive, isSegmentWrappable, main, numKnots, numPassiveSegments, numPoints, numSegments, numSegmentSpecs, numWrappables, pathWrapString, postadvance, preadvance, printSegments, printSegmentSpecs, removePoint, removeWrappable, removeWrappable, render, setABPointColor, setAllSegmentsWrappable, setContactDamping, setContactingKnotsColor, setContactStiffness, setConvergenceTol, setDebugLevel, setDrawABPoints, setDrawDisplacements, setDrawKnots, setInitializingPoints, setKnotPositions, setLineSearch, setMaxWrapDisplacement, setMaxWrapIterations, setNumKnots, setPoint, setPrintProfiling, setProfiling, setRestLengthFromPoints, setSegmentPassive, setSegmentPassive, setSegmentWrappable, setSegmentWrappable, setSegmentWrappable, setSor, setWrapDamping, setWrapKnotDensity, setWrapKnotDensityMode, setWrapStiffness, transformGeometry, transformGeometry, updateBounds, updateSlavePos, updateSlaveVel, updateStructure, updateWrapSegments, updateWrapSegments

Methods inherited from class artisynth.core.mechmodels.PointSpringBase

advanceState, computeDFdl, computeDFdldot, computeF, containsPoint, createDefaultMaterial, createRenderProps, getAuxVarDerivative, getAuxVarState, getEffectiveMaterial, getForceScaling, getMaterial, getMaxForce, getRenderHints, getRenderProps, getRestLength, getSelection, isSelectable, normalizeForceScaling, numAuxVars, numSelectionQueriesNeeded, requiresAdvance, setAuxVarState, setDamping, setLinearMaterial, setMaterial, setMaxForce, setRenderProps, setRestLength, setStiffness

Methods inherited from class artisynth.core.modelbase.ModelComponentBase

checkFlag, checkName, checkNameUniqueness, clearFlag, clone, connectToHierarchy, createTempFlag, disconnectFromHierarchy, getGrandParent, getName, getNameRange, getNavpanelVisibility, getNavpanelVisibility, getNumber, getParent, getProperty, isFixed, isMarked, isScanning, isSelected, isWritable, makeValidName, makeValidName, notifyParentOfChange, printReferences, recursivelyContained, recursivelyContains, removeTempFlag, setFixed, setFlag, setMarked, setName, setNavpanelVisibility, setNavpanelVisibility, setNumber, setParent, setScanning, setSelected, setWritable, write

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface artisynth.core.modelbase.CompositeComponent

recursivelyFind

Methods inherited from interface artisynth.core.modelbase.ModelComponent

connectToHierarchy, disconnectFromHierarchy, getHardReferences, getName, getNavpanelVisibility, getNumber, getParent, getSoftReferences, hasState, isFixed, isMarked, isSelected, notifyParentOfChange, setFixed, setMarked, setName, setNumber, setParent, setSelected, setWritable, updateReferences

Methods inherited from interface maspack.properties.HasProperties

getAllPropertyInfo, getProperty

Methods inherited from interface maspack.util.Scannable

isWritable, write

Methods inherited from interface artisynth.core.mechmodels.MuscleComponent

getLength, getLengthDot, getMaterial, getPoint, getRestLength, numPoints, setMaterial, setRestLength

Methods inherited from interface artisynth.core.mechmodels.ForceEffector

addPosJacobian, addSolveBlocks, addVelJacobian, applyForces

Methods inherited from interface maspack.render.IsSelectable

getSelection, isSelectable, numSelectionQueriesNeeded

Methods inherited from interface maspack.render.IsRenderable

getRenderHints, render, updateBounds

Methods inherited from interface maspack.render.HasRenderProps

createRenderProps, getRenderProps, setRenderProps

Methods inherited from interface artisynth.core.modelbase.TransformableGeometry

transformPriority

Constructor Detail

MultiPointMuscleOsim

public MultiPointMuscleOsim()

MultiPointMuscleOsim

public MultiPointMuscleOsim(java.lang.String name)

Method Detail

getPathPoints

public PointList<Marker> getPathPoints()

updateNameMap

public void updateNameMap(java.lang.String newName,
                          java.lang.String oldName,
                          ModelComponent comp)

Specified by:

updateNameMap in interface CompositeComponent

findComponent

public ModelComponent findComponent(java.lang.String path)

Recursively searches for a subcomponent of this ModelComponent, identified by a path of component names.

Specified by:

findComponent in interface CompositeComponent

Parameters:

path - path leading to the subcomponent

Returns:

named subcomponent, or null if the component does not exist.

add

public void add(ModelComponent comp)

remove

public boolean remove(ModelComponent comp)

get

public ModelComponent get(java.lang.String nameOrNumber)

Returns a specific subcomponent of this ModelComponent, identified by name or string representation of the subcomponent's number

Specified by:

get in interface CompositeComponent

Parameters:

nameOrNumber - name or number of the subcomponent

Returns:

named subcomponent, or null if the component does not exist.

get

public ModelComponent get(int idx)

Returns a specific subcomponent of this ModelComponent, identified by index.

Specified by:

get in interface CompositeComponent

Specified by:

get in interface IndexedComponentList

Parameters:

idx - index of the subcomponent

Returns:

indexed subcomponent, or null if the component does not exist.

getByNumber

public ModelComponent getByNumber(int num)

Returns a specific subcomponent of this ModelComponent, identified by number.

Specified by:

getByNumber in interface CompositeComponent

Parameters:

num - number of the subcomponent

Returns:

specified subcomponent, or null if the component does not exist.

getNumberLimit

public int getNumberLimit()

Returns the current upper limit for numbers among all subcomponents in this composite. This is one greater than the maximum subcomponent number currently assigned. A value of 0 means that there are no subcomponents. This method is useful for creating and sizing arrays whose contents are indexed by component numbers.

Specified by:

getNumberLimit in interface CompositeComponent

Returns:

upper limit for numbers among all subcomponents

indexOf

public int indexOf(ModelComponent comp)

Returns the index of a specified subcomponent, or -1 if that the component is not present.

Specified by:

indexOf in interface CompositeComponent

Parameters:

comp - component whose index is requested

Returns:

indexed subcomponent

numComponents

public int numComponents()

Returns the number of components in this CompositeComponent.

Specified by:

numComponents in interface CompositeComponent

Specified by:

numComponents in interface IndexedComponentList

Returns:

number of subcomponents

componentChanged

public void componentChanged(ComponentChangeEvent e)

Notifies this composite component that a change has occured within one or more of its descendants. When this occurs, the composite may need to invalidate cached information that depends on the descendants.

This method should propagate the notification up the component hierarchy by calling notifyParentOfChange.

Specified by:

componentChanged in interface ComponentChangeListener

Specified by:

componentChanged in interface CompositeComponent

Parameters:

e - optional argument giving specific information about the change

getNavpanelDisplay

public CompositeComponent.NavpanelDisplay getNavpanelDisplay()

Returns the DisplayMode for this component. This specifies how the component should be displayed in a navigation panel.

Specified by:

getNavpanelDisplay in interface CompositeComponent

Returns:

display mode for this component

setDisplayMode

public void setDisplayMode(CompositeComponent.NavpanelDisplay mode)

Sets the display mode for this component. This controls how the component is displayed in a navigation panel. The default setting is NORMAL.

Parameters:

mode - new display mode

hierarchyContainsReferences

public boolean hierarchyContainsReferences()

Returns true if the component hierarchy formed by this component and its descendents is closed with respect to references. In other words, all components referenced by components within the hierarchy are themselves components within the hierarchy.

In particular, this means that one does not need to search outside the hierarchy when looking for dependencies.

Specified by:

hierarchyContainsReferences in interface CompositeComponent

Returns:

true if this component's hierarchy is closed with respect to references.

getChildren

public java.util.Iterator<? extends HierarchyNode> getChildren()

Specified by:

getChildren in interface HierarchyNode

Overrides:

getChildren in class ModelComponentBase

hasChildren

public boolean hasChildren()

Specified by:

hasChildren in interface HierarchyNode

Overrides:

hasChildren in class ModelComponentBase

prerender

public void prerender(RenderList list)

Description copied from class: MultiPointSpring

Called prior to rendering to allow this object to update the internal state required for rendering (such as by caching rendering coordinates). The object may add internal objects to the list of objects being rendered, by calling

list.addIfVisible (obj);

for each of the objects in question.

Specified by:

prerender in interface IsRenderable

Overrides:

prerender in class MultiPointMuscle

Parameters:

list - list of objects to be rendered

scan

public void scan(ReaderTokenizer rtok,
                 java.lang.Object ref)
          throws java.io.IOException

Description copied from class: MultiPointSpring

Scans this element from a ReaderTokenizer. The expected text format is assumed to be compatible with that produced by write.

Specified by:

scan in interface ModelComponent

Specified by:

scan in interface Scannable

Overrides:

scan in class MultiPointSpring

Parameters:

rtok - Tokenizer from which to scan the element

ref - optional reference object which can be used for resolving references to other objects

Throws:

java.io.IOException - if an I/O or formatting error occured

postscan

public void postscan(java.util.Deque<ScanToken> tokens,
                     CompositeComponent ancestor)
              throws java.io.IOException

Description copied from class: MultiPointSpring

Performs any required post-scanning for this component. This involves handling any information whose processing was deferred during the scan() method and stored in the token queue. The most common use of this method is to resolve the paths of component references, which may not have been created at the time of the initial scan() call.

Specified by:

postscan in interface PostScannable

Overrides:

postscan in class MultiPointSpring

Parameters:

tokens - token information that was stored during scan().

ancestor - ancestor component with respect to which reference component paths are defined.

Throws:

java.io.IOException - if an error is encountered (such as a reference to a non-existent component)