FemNode3d (Artisynth API documentation)

java.lang.Object
- artisynth.core.modelbase.ModelComponentBase
- - artisynth.core.modelbase.RenderableComponentBase
  - - artisynth.core.mechmodels.DynamicComponentBase
    - - artisynth.core.mechmodels.Point
      - artisynth.core.mechmodels.Particle
        
        artisynth.core.femmodels.FemNode
        
        artisynth.core.femmodels.FemNode3d

All Implemented Interfaces:

CollidableDynamicComponent, DynamicAgent, DynamicComponent, ForceEffector, MotionTargetComponent, PointAttachable, CopyableComponent, HasNumericState, ModelComponent, PostScannable, RenderableComponent, Traceable, TransformableGeometry, ScalableUnits, java.lang.Cloneable, Boundable, HasProperties, HierarchyNode, HasRenderProps, IsRenderable, IsSelectable, Renderable, Scannable

Direct Known Subclasses:

MFreeNode3d
```
public class FemNode3d
extends FemNode
implements Boundable
```

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class FemNode3d.CoordType
Specifies a nodal coordinate type
- Nested classes/interfaces inherited from interface artisynth.core.modelbase.ModelComponent
  ModelComponent.NavpanelVisibility

Nested Classes
Modifier and Type	Class and Description
`static class`	`FemNode3d.CoordType` Specifies a nodal coordinate type

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`COMPUTE_STRAIN_EXTERNAL` Flag indicating external (application) request to compute stress for this node.
`static int`	`COMPUTE_STRAIN_INTERNAL` Flag indicating internal request to compute stress for this node.
`static int`	`COMPUTE_STRESS_EXTERNAL` Flag indicating external (application) request to compute stress for this node.
`static int`	`COMPUTE_STRESS_INTERNAL` Flag indicating internal request to compute stress for this node.
`static PropertyList`	`myProps`
`static int`	`NEEDS_STRAIN` Flag indicating if strain values should be computed for this node
`static int`	`NEEDS_STRESS` Flag indicating if stress values should be computed for this node
`static int`	`REST_POSITION_SCANNED` Flag indicating that the rest position was read during scan

Fields inherited from class artisynth.core.mechmodels.Point
myRenderCoords

Fields inherited from class artisynth.core.modelbase.ModelComponentBase
enforceUniqueCompositeNames, enforceUniqueNames, myNumber, NULL_OBJ, useCompactPathNames

Fields inherited from interface artisynth.core.modelbase.CopyableComponent
COPY_REFERENCES, REST_POSITION

Fields inherited from interface artisynth.core.modelbase.TransformableGeometry
TG_ARTICULATED, TG_DRAGGER, TG_PRESERVE_ORIENTATION, TG_SIMULATING

Fields inherited from interface maspack.render.IsRenderable
TRANSPARENT, TWO_DIMENSIONAL

Constructor Summary

Constructors
Constructor and Description

FemNode3d()

FemNode3d(double x, double y, double z)

FemNode3d(Point3d p)

Constructors
Constructor and Description
`FemNode3d()`
`FemNode3d(double x, double y, double z)`
`FemNode3d(Point3d p)`

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`addElementDependency(FemElement3dBase e)`
`FemNodeNeighbor`	`addIndirectNeighbor(FemNode3d nbrNode)`
`void`	`addLocalForce(Vector3d f)`
`void`	`addScaledStrain(double s, SymmetricMatrix3d sig)`
`void`	`addTransformableDependencies(TransformGeometryContext context, int flags)` Adds to `context` any transformable components which should be transformed as the same time as this component.
`void`	`clearDirector()`
`void`	`clearIndirectNeighbors()`
`void`	`clearRestDirector()`
`void`	`computeCentroid(Vector3d centroid)` Computed the centroid of this element.
`double`	`computeCovariance(Matrix3d C)` Not implemented for FemNode3d.
`double`	`computeMassFromDensity()`
`void`	`computeRestDirector()`
`void`	`computeRestDirector(Vector3d dir)`
`void`	`connectToHierarchy(CompositeComponent hcomp)` Called by the system after this component, or an ancestor of this component, is added to the component hierarchy (i.e., added as a child of another CompositeComponent).
`FemNode3d`	`copy(int flags, java.util.Map<ModelComponent,ModelComponent> copyMap)` Create a copy of this component.
`void`	`deregisterNodeNeighbor(FemNode3d nbrNode, boolean shell)`
`void`	`disconnectFromHierarchy(CompositeComponent hcomp)` Called by the system after this component, or an ancestor of this component, is removed from the component hierarchy (i.e., removed as a child of its parent).
`java.util.List<FemElement3dBase>`	`getAdjacentElements()` Returns all elements (either shell or volumetric) that reference this node.
`java.util.List<ShellElement3d>`	`getAdjacentShellElements()` Returns all shell elements that reference this node.
`java.util.List<FemElement3d>`	`getAdjacentVolumeElements()` Returns all volumetric elements that reference this node.
`PropertyList`	`getAllPropertyInfo()` Returns a list giving static information about all properties exported by this object.
`Point3d`	`getBackCoordinates(FemNode3d.CoordType ctype)`
`Vector3d`	`getBackForce()`
`Vector3d`	`getBackInternalForce()`
`BackNode3d`	`getBackNode()`
`Point3d`	`getBackPosition()`
`Point3d`	`getBackRenderPosition()`
`Point3d`	`getBackRestPosition()`
`int`	`getBackSolveIndex()`
`Vector3d`	`getBackVelocity()`
`boolean`	`getComputeStrain()` Queries whether strain computation has been explicitly enabled for this node.
`boolean`	`getComputeStress()` Queries whether stress computation has been explicitly enabled for this node.
`Point3d`	`getCoordinates(FemNode3d.CoordType ctype)`
`Vector3d`	`getDirector()`
`void`	`getDirector(Vector3d dir)`
`Vector3d`	`getDirectorVel()`
`Vector3d`	`getDisplacement()`
`java.util.LinkedList<FemElement3d>`	`getElementDependencies()` Deprecated.
`DynamicAttachment`	`getFrameAttachment()`
`FrameNode3d`	`getFrameNode()`
`int`	`getIncompressIndex()`
`int`	`getIndex()`
`FemNodeNeighbor`	`getIndirectNeighbor(FemNode3d node)`
`FemNodeNeighbor`	`getIndirectNeighborBySolveIndex(int idx)`
`java.util.LinkedList<FemNodeNeighbor>`	`getIndirectNeighbors()`
`Vector3d`	`getInternalForce()`
`Point3d`	`getLocalCoordinates(FemNode3d.CoordType ctype)`
`Vector3d`	`getLocalForce()`
`Point3d`	`getLocalPosition()`
`Point3d`	`getLocalRenderPosition()`
`Point3d`	`getLocalRestPosition()`
`int`	`getLocalSolveIndex()`
`Vector3d`	`getLocalVelocity()`
`double`	`getMAPStrain()` Returns the principal strain with the maximum absolute value for this node.
`double`	`getMAPStress()` Returns the principal stress with the maximum absolute value for this node.
`double`	`getMaxShearStrain()` Returns the maximum shear atrain for this node.
`double`	`getMaxShearStress()` Returns the maximum shear stress for this node.
`FemNodeNeighbor`	`getNodeNeighbor(FemNode3d node)`
`FemNodeNeighbor`	`getNodeNeighborBySolveIndex(int idx)`
`java.util.ArrayList<FemNodeNeighbor>`	`getNodeNeighbors()`
`Point3d`	`getPoint(int idx)` Returns the `idx`-th point associated with this element.
`Point3d`	`getRenderPosition()`
`Point3d`	`getRestDirector()`
`void`	`getRestDirector(Vector3d rdir)`
`Point3d`	`getRestPosition()`
`void`	`getState(DataBuffer data)` Saves state information for this component by adding data to the supplied DataBuffer.
`SymmetricMatrix3d`	`getStrain()` Returns the average strain for this node.
`SymmetricMatrix3d`	`getStress()` Returns the average stress for this node.
`Vector3d`	`getTargetDisplacement()`
`double`	`getVonMisesStrain()` Returns the von Mises strain for this node.
`double`	`getVonMisesStress()` Returns the von Mises stress for this node.
`boolean`	`hasDirector()`
`void`	`invalidateRestDirectorIfNecessary()`
`boolean`	`isActiveLocal()`
`boolean`	`isRestDirectorExplicit()`
`int`	`needsStressStrain()` Returns flags indicating if stress or strain values should be computed for this node.
`int`	`numAdjacentElements()`
`int`	`numAdjacentShellElements()`
`int`	`numAdjacentVolumeElements()`
`int`	`numPoints()` Returns the number of points associated with this element, if any, or zero otherwise.
`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).
`void`	`removeElementDependency(FemElement3dBase e)`
`void`	`resetEffectiveMass()` Resets the effective mass of this component to the nominal mass.
`void`	`resetRestPosition()`
`void`	`scaleDistance(double s)` Scales all distance coordinates.
`void`	`scan(ReaderTokenizer rtok, java.lang.Object ref)` Scans this element from a ReaderTokenizer.
`boolean`	`scanItem(ReaderTokenizer rtok, java.util.Deque<ScanToken> tokens)`
`void`	`setAttached(DynamicAttachment at)` Attach this component to another via a DynamicAttachment object.
`void`	`setBackForce(Vector3d f)`
`void`	`setBackPosition(Point3d pos)`
`void`	`setBackRestPosition(Point3d rest)`
`void`	`setBackVelocity(Vector3d vel)`
`void`	`setComputeStrain(boolean enable)` Explicitly enables or disables strain computation for this node, regardless of whether it is needed for surface rendering.
`void`	`setComputeStress(boolean enable)` Explicitly enables or disables stress computation for this node, regardless of whether it is needed for surface rendering.
`void`	`setDirector(Vector3d dir)`
`void`	`setDirectorVel(Vector3d vel)`
`void`	`setDynamic(boolean enable)`
`void`	`setExplicitMass(double m)` Sets the mass for this node to an explicit value.
`void`	`setFrameNode(FrameNode3d fnode)`
`void`	`setIncompressIndex(int idx)`
`void`	`setIndex(int idx)`
`void`	`setLocalForce(Vector3d f)`
`void`	`setRestDirector(Vector3d restDir)`
`void`	`setRestPosition(Point3d pos)`
`void`	`setState(DataBuffer data)` Restores the state for this component by reading from the supplied data buffer, starting at the current buffer offsets.
`void`	`setStrain(double vms)`
`void`	`setStress(double vms)`
`void`	`setTargetDisplacement(Vector3d del)`
`void`	`transformGeometry(GeometryTransformer gt, TransformGeometryContext context, int flags)` Transforms the geometry of this component, using the geometry transformer `gtr` to transform its individual attributes.
`void`	`zeroForces()`
`void`	`zeroStrain()`
`void`	`zeroStress()`
`void`	`zeroStressStrain()`

Methods inherited from class artisynth.core.femmodels.FemNode
addMass, clearMass, getMass, invalidateMassIfNecessary, isMassExplicit, scaleMass, setMass, unsetExplicitMass

Methods inherited from class artisynth.core.mechmodels.Particle
addEffectiveMass, applyGravity, applyPosImpulse, createPointAttachment, getCopyReferences, getEffectiveMass, getEffectiveMass, getInverseMass, getMass, getMass, getVelDerivative, isDuplicatable, mulInverseEffectiveMass

Methods inherited from class artisynth.core.mechmodels.Point
addExternalForce, addForce, addForce, addPosImpulse, addPosJacobian, addScaledExternalForce, addScaledForce, addSolveBlock, addSolveBlocks, addTargetJacobian, addToPointVelocity, addToSolveBlockDiagonal, addVelJacobian, applyExternalForces, applyForces, createMassBlock, createRenderProps, createSolveBlock, defaultRenderPropsAreNull, distance, distance, getEffectiveMassForces, getExternalForce, getForce, getForce, getJacobianType, getPointDamping, getPointDampingMode, getPosDerivative, getPosition, getPosition, getPosState, getPosStateSize, getRenderCoords, getRenderProps, getSelection, getTargetActivity, getTargetPos, getTargetPosition, getTargetVel, getTargetVelocity, getTraceablePositionProperty, getTraceables, getVelocity, getVelocity, getVelState, getVelStateSize, hasForce, isMassConstant, isSelectable, render, resetTargets, setContactConstraint, setExternalForce, setForce, setForce, setPointDamping, setPointDampingMode, setPosition, setPosition, setPosState, setRandomForce, setRandomPosState, setRandomVelState, setRenderProps, setScaledExternalForce, setState, setTargetActivity, setTargetPos, setTargetPosition, setTargetVel, setTargetVelocity, setVelocity, setVelocity, setVelState, subForce, updateBounds, updatePosState, updateVelState, velocityLimitExceeded, zeroExternalForces

Methods inherited from class artisynth.core.mechmodels.DynamicComponentBase
addAttachmentRequest, addConstrainer, addMasterAttachment, getAttachment, getConstrainers, getMasterAttachments, getSolveIndex, hasState, isActive, isAttached, isControllable, isDynamic, isParametric, removeAttachmentRequest, removeConstrainer, removeMasterAttachment, setSolveIndex, transformGeometry

Methods inherited from class artisynth.core.modelbase.RenderableComponentBase
getRenderHints, isVisible, numSelectionQueriesNeeded, setVisible, updateRenderProps

Methods inherited from class artisynth.core.modelbase.ModelComponentBase
checkFlag, checkName, checkNameUniqueness, clearFlag, clone, createTempFlag, getChildren, getGrandParent, getHardReferences, getName, getNameRange, getNavpanelVisibility, getNavpanelVisibility, getNumber, getParent, getProperty, getSoftReferences, hasChildren, isFixed, isMarked, isScanning, isSelected, isWritable, makeValidName, makeValidName, notifyParentOfChange, postscan, printReferences, recursivelyContained, recursivelyContains, removeTempFlag, setFixed, setFlag, setMarked, setName, setNavpanelVisibility, setNavpanelVisibility, setNumber, setParent, setScanning, setSelected, setWritable, updateReferences, write

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface maspack.geometry.Boundable
updateBounds

Methods inherited from interface artisynth.core.modelbase.ModelComponent
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
getProperty

Methods inherited from interface maspack.properties.HierarchyNode
getChildren, hasChildren

Methods inherited from interface artisynth.core.modelbase.PostScannable
postscan

Methods inherited from interface maspack.util.Scannable
isWritable, write

Methods inherited from interface artisynth.core.mechmodels.DynamicComponent
addAttachmentRequest, removeAttachmentRequest

Methods inherited from interface artisynth.core.mechmodels.DynamicAgent
addConstrainer, addMasterAttachment, getAttachment, getConstrainers, getMasterAttachments, getSolveIndex, isActive, isAttached, isControllable, isDynamic, isParametric, removeConstrainer, removeMasterAttachment, setSolveIndex

Methods inherited from interface artisynth.core.modelbase.HasNumericState
advanceState, getAuxVarDerivative, getAuxVarState, getStateVersion, hasState, numAuxVars, requiresAdvance, setAuxVarState

Methods inherited from interface artisynth.core.modelbase.TransformableGeometry
transformGeometry

- Field Detail
  - NEEDS_STRESS
```
public static int NEEDS_STRESS
```
    Flag indicating if stress values should be computed for this node
  - NEEDS_STRAIN
```
public static int NEEDS_STRAIN
```
    Flag indicating if strain values should be computed for this node
  - REST_POSITION_SCANNED
```
public static int REST_POSITION_SCANNED
```
    Flag indicating that the rest position was read during scan
  - COMPUTE_STRESS_EXTERNAL
```
public static int COMPUTE_STRESS_EXTERNAL
```
    Flag indicating external (application) request to compute stress for this node.
  - COMPUTE_STRESS_INTERNAL
```
public static int COMPUTE_STRESS_INTERNAL
```
    Flag indicating internal request to compute stress for this node.
  - COMPUTE_STRAIN_EXTERNAL
```
public static int COMPUTE_STRAIN_EXTERNAL
```
    Flag indicating external (application) request to compute stress for this node.
  - COMPUTE_STRAIN_INTERNAL
```
public static int COMPUTE_STRAIN_INTERNAL
```
    Flag indicating internal request to compute stress for this node.
  - myProps
```
public static PropertyList myProps
```
- Constructor Detail
  - FemNode3d
```
public FemNode3d()
```
  - FemNode3d
```
public FemNode3d(Point3d p)
```
  - FemNode3d
```
public FemNode3d(double x,
                 double y,
                 double z)
```
- Method Detail
  - getAllPropertyInfo
```
public PropertyList getAllPropertyInfo()
```
    Description copied from interface: HasProperties
    
    Returns a list giving static information about all properties exported by this object.
    
    Specified by:
    
    getAllPropertyInfo in interface HasProperties
    
    Overrides:
    
    getAllPropertyInfo in class Particle
    
    Returns:
    
    static information for all exported properties
  - getLocalCoordinates
```
public Point3d getLocalCoordinates(FemNode3d.CoordType ctype)
```
  - getCoordinates
```
public Point3d getCoordinates(FemNode3d.CoordType ctype)
```
  - getIndex
```
public int getIndex()
```
  - setIndex
```
public void setIndex(int idx)
```
  - getIncompressIndex
```
public int getIncompressIndex()
```
  - setIncompressIndex
```
public void setIncompressIndex(int idx)
```
  - getVonMisesStress
```
public double getVonMisesStress()
```
    Returns the von Mises stress for this node. This is equal to sqrt (3 J2), where J2 is the second invariant of the average deviatoric stress for the node.
    This quantity is available only when stress values are being computed for this node, as described in the documentation for getStress(). If stress values are not being computed, 0 is returned.
    
    Returns:
    
    van Mises stress, or 0 is stress is not being computed
  - getMAPStress
```
public double getMAPStress()
```
    Returns the principal stress with the maximum absolute value for this node.
    This quantity is available only when stress values are being computed for this node, as described in the documentation for getStress(). If stress values are not being computed, 0 is returned.
    
    Returns:
    
    max abs principal stress, or 0 is stress is not being computed
  - getMaxShearStress
```
public double getMaxShearStress()
```
    Returns the maximum shear stress for this node. The maximum shear stress is given by
```
 max (|s0-s1|/2, |s1-s2|/2, |s2-s0|/2)
 
```
    where s0, s1, and s2 are the eigenvalues of the stress tensor.
    This quantity is available only when stress values are being computed for this node, as described in the documentation for getStress(). If stress values are not being computed, 0 is returned.
    Returns:
    
    maximum shear stress, or 0 is stress is not being computed
  - getVonMisesStrain
```
public double getVonMisesStrain()
```
    Returns the von Mises strain for this node. This is equal to sqrt (4/3 J2), where J2 is the second invariant of the average deviatoric strain for the node.
    This quantity is available only when strain values are being computed for this node, as described in the documentation for getStrain(). If strain values are not being computed, 0 is returned.
    
    Returns:
    
    von Mises strain, or 0 is strain is not being computed
  - getMAPStrain
```
public double getMAPStrain()
```
    Returns the principal strain with the maximum absolute value for this node.
    This quantity is available only when strain values are being computed for this node, as described in the documentation for getStrain(). If strain values are not being computed, 0 is returned.
    
    Returns:
    
    max abs strain, or 0 is strain is not being computed
  - getMaxShearStrain
```
public double getMaxShearStrain()
```
    Returns the maximum shear atrain for this node. The maximum shear strain is given by
```
 max (|s0-s1|/2, |s1-s2|/2, |s2-s0|/2)
 
```
    where s0, s1, and s2 are the eigenvalues of the strain tensor.
    This quantity is available only when strain values are being computed for this node, as described in the documentation for getStrain(). If strain values are not being computed, 0 is returned.
    Returns:
    
    maximum shear strain, or 0 is strain is not being computed
  - getDisplacement
```
public Vector3d getDisplacement()
```
  - getTargetDisplacement
```
public Vector3d getTargetDisplacement()
```
  - setTargetDisplacement
```
public void setTargetDisplacement(Vector3d del)
```
  - zeroStressStrain
```
public void zeroStressStrain()
```
  - needsStressStrain
```
public int needsStressStrain()
```
    Returns flags indicating if stress or strain values should be computed for this node.
    
    Returns:
    
    stress/strain compute flags
  - getStress
```
public SymmetricMatrix3d getStress()
```
    Returns the average stress for this node. Average node stresses are computed by extrapolating the integration point stresses back to the nodes for each element, and then computing the average of these extrapolated values at each node.
    Average nodal stress is computed for this node only when explicitly requested using setComputeStress(boolean) (or FemModel3d.setComputeNodalStress(boolean) in its FEM model), or when needed internally, such as when an FEM mesh containing this node is rendered using stress information. If stress is not being computed for this node, then this method returns a zero-valued matrix.
    
    Returns:
    
    average nodal stress (should not be modified)
  - setStress
```
public void setStress(double vms)
```
  - zeroStress
```
public void zeroStress()
```
  - setComputeStress
```
public void setComputeStress(boolean enable)
```
    Explicitly enables or disables stress computation for this node, regardless of whether it is needed for surface rendering.
    
    Parameters:
    
    enable - if true, enables explicit stress computation
  - getComputeStress
```
public boolean getComputeStress()
```
    Queries whether stress computation has been explicitly enabled for this node.
    
    Returns:
    
    true if explicit stress computation is enabled
  - getStrain
```
public SymmetricMatrix3d getStrain()
```
    Returns the average strain for this node. Average node strains are computed by extrapolating the integration point strains back to the nodes for each element, and then computing the average of these extrapolated values at each node.
    Average nodal strain is computed for this node only when explicitly requested using setComputeStrain(boolean) (or FemModel3d.setComputeNodalStrain(boolean) in its FEM model), or when needed internally, such as when an FEM mesh containing this node is rendered using strain information. If strain is not being computed for this node, then this method returns a zero-valued matrix.
    
    Returns:
    
    average nodal strain (should not be modified)
  - setStrain
```
public void setStrain(double vms)
```
  - zeroStrain
```
public void zeroStrain()
```
  - addScaledStrain
```
public void addScaledStrain(double s,
                            SymmetricMatrix3d sig)
```
  - setComputeStrain
```
public void setComputeStrain(boolean enable)
```
    Explicitly enables or disables strain computation for this node, regardless of whether it is needed for surface rendering.
    
    Parameters:
    
    enable - if true, enables explicit strain computation
  - getComputeStrain
```
public boolean getComputeStrain()
```
    Queries whether strain computation has been explicitly enabled for this node.
    
    Returns:
    
    true if explicit strain computation is enabled
  - getInternalForce
```
public Vector3d getInternalForce()
```
  - getNodeNeighbors
```
public java.util.ArrayList<FemNodeNeighbor> getNodeNeighbors()
```
  - getNodeNeighbor
```
public FemNodeNeighbor getNodeNeighbor(FemNode3d node)
```
  - getNodeNeighborBySolveIndex
```
public FemNodeNeighbor getNodeNeighborBySolveIndex(int idx)
```
  - deregisterNodeNeighbor
```
public void deregisterNodeNeighbor(FemNode3d nbrNode,
                                   boolean shell)
```
  - getIndirectNeighbors
```
public java.util.LinkedList<FemNodeNeighbor> getIndirectNeighbors()
```
  - getIndirectNeighbor
```
public FemNodeNeighbor getIndirectNeighbor(FemNode3d node)
```
  - getIndirectNeighborBySolveIndex
```
public FemNodeNeighbor getIndirectNeighborBySolveIndex(int idx)
```
  - addIndirectNeighbor
```
public FemNodeNeighbor addIndirectNeighbor(FemNode3d nbrNode)
```
  - clearIndirectNeighbors
```
public void clearIndirectNeighbors()
```
  - scanItem
```
public boolean scanItem(ReaderTokenizer rtok,
                        java.util.Deque<ScanToken> tokens)
                 throws java.io.IOException
```
    Overrides:
    
    scanItem in class FemNode
    
    Throws:
    
    java.io.IOException
  - scan
```
public void scan(ReaderTokenizer rtok,
                 java.lang.Object ref)
          throws java.io.IOException
```
    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 ModelComponentBase
    
    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
  - addTransformableDependencies
```
public void addTransformableDependencies(TransformGeometryContext context,
                                         int flags)
```
    Description copied from interface: TransformableGeometry
    
    Adds to context any transformable components which should be transformed as the same time as this component. This will generally include descendant components, and may also include other components to which this component is connected in some way.
    This method is generally called from with the TransformGeometryContext.apply(maspack.geometry.GeometryTransformer, int) method of a TransformGeometryContext.
    
    Specified by:
    
    addTransformableDependencies in interface TransformableGeometry
    
    Overrides:
    
    addTransformableDependencies in class Point
    
    Parameters:
    
    context - context information, to which the dependent components are added.
    
    flags - specifies conditions associated with the transformation
  - transformGeometry
```
public void transformGeometry(GeometryTransformer gt,
                              TransformGeometryContext context,
                              int flags)
```
    Description copied from interface: TransformableGeometry
    
    Transforms the geometry of this component, using the geometry transformer gtr to transform its individual attributes. The context argument supplies information about what other components are currently being transformed, and also allows the requesting of update actions to be performed after all transform called have completed. The context is also the usual entity that calls this method, from within its TransformGeometryContext.apply(maspack.geometry.GeometryTransformer, int) method. The argument flags provides flags to specify various conditions associated with the the transformation. At present, the available flags are TransformableGeometry.TG_SIMULATING and TransformableGeometry.TG_ARTICULATED.
    This method is not usually called directly by applications. Instead, it is typically called from within the TransformGeometryContext.apply(maspack.geometry.GeometryTransformer, int) method of the context, which takes care of the various operations needed for a complete transform operation, including calling TransformableGeometry.addTransformableDependencies(artisynth.core.modelbase.TransformGeometryContext, int) to collect other components that should be transformed, calling TransformableGeometry.transformGeometry(maspack.matrix.AffineTransform3dBase) for each component, notifying component parents that the geometry has changed, and calling any requested TransformGeometryActions. More details are given in the documentation for TransformGeometryContext.apply(maspack.geometry.GeometryTransformer, int).
    TransformGeometryContext provides a number of static convenience transform methods which take care of building the context and calling apply() for a specified set of components.
    This method should not generally call transformGeometry() for its descendant components. Instead, descendants needing transformation should be specified by adding them to the context in the method TransformableGeometry.addTransformableDependencies(artisynth.core.modelbase.TransformGeometryContext, int).
    
    Specified by:
    
    transformGeometry in interface TransformableGeometry
    
    Overrides:
    
    transformGeometry in class Point
    
    Parameters:
    
    gt - transformer implementing the transform
    
    context - context information, including what other components are being transformed
    
    flags - specifies conditions associated with the transformation
  - scaleDistance
```
public void scaleDistance(double s)
```
    Description copied from interface: ScalableUnits
    
    Scales all distance coordinates.
    
    Specified by:
    
    scaleDistance in interface ScalableUnits
    
    Overrides:
    
    scaleDistance in class Particle
    
    Parameters:
    
    s - scaling factor
  - addElementDependency
```
public void addElementDependency(FemElement3dBase e)
```
  - removeElementDependency
```
public void removeElementDependency(FemElement3dBase e)
```
  - getElementDependencies
```
public java.util.LinkedList<FemElement3d> getElementDependencies()
```
    Deprecated.
    
    Returns all the volumetric elements referencing this node. Should use getAdjacentElements(), getAdjacentVolumeElements(), or getAdjacentShellElements(), as appropriate.
    
    Returns:
    
    list of all volumetric elements referencing this node
  - getAdjacentElements
```
public java.util.List<FemElement3dBase> getAdjacentElements()
```
    Returns all elements (either shell or volumetric) that reference this node.
    
    Returns:
    
    List of all elements referencing this node.
  - getAdjacentVolumeElements
```
public java.util.List<FemElement3d> getAdjacentVolumeElements()
```
    Returns all volumetric elements that reference this node.
    
    Returns:
    
    List of all volumetric elements referencing this node.
  - getAdjacentShellElements
```
public java.util.List<ShellElement3d> getAdjacentShellElements()
```
    Returns all shell elements that reference this node.
    
    Returns:
    
    List of all shell elements referencing this node.
  - numAdjacentElements
```
public int numAdjacentElements()
```
  - numAdjacentShellElements
```
public int numAdjacentShellElements()
```
  - numAdjacentVolumeElements
```
public int numAdjacentVolumeElements()
```
  - computeMassFromDensity
```
public double computeMassFromDensity()
```
    Specified by:
    
    computeMassFromDensity in class FemNode
  - resetEffectiveMass
```
public void resetEffectiveMass()
```
    Description copied from interface: DynamicAgent
    
    Resets the effective mass of this component to the nominal mass.
    
    Specified by:
    
    resetEffectiveMass in interface DynamicAgent
    
    Overrides:
    
    resetEffectiveMass in class Particle
  - setExplicitMass
```
public void setExplicitMass(double m)
```
    Description copied from class: FemNode
    
    Sets the mass for this node to an explicit value. This means that the mass will no longer be determined from the masses of the surrounding elements.
    
    Overrides:
    
    setExplicitMass in class FemNode
    
    Parameters:
    
    m - explicit mass value
  - connectToHierarchy
```
public void connectToHierarchy(CompositeComponent hcomp)
```
    Description copied from class: ModelComponentBase
    
    Called by the system after this component, or an ancestor of this component, is added to the component hierarchy (i.e., added as a child of another CompositeComponent). This method is responsible for doing any required hierarchy-dependent initialization, including any updating of referenced components.
    When this method is called, ModelComponent.getParent() will return the new parent component; the system will have set this beforehand.
    
    Specified by:
    
    connectToHierarchy in interface ModelComponent
    
    Overrides:
    
    connectToHierarchy in class DynamicComponentBase
    
    Parameters:
    
    hcomp - hierarchy component to which this component, or its ancestor, was attached
  - disconnectFromHierarchy
```
public void disconnectFromHierarchy(CompositeComponent hcomp)
```
    Description copied from class: ModelComponentBase
    
    Called by the system after this component, or an ancestor of this component, is removed from the component hierarchy (i.e., removed as a child of its parent). This method is responsible for any required hierarchy-dependent deinitialization, including any updating of referenced components.
    When this method is called, ModelComponent.getParent() will still return this original parent component; the system will set this to null after.
    
    Specified by:
    
    disconnectFromHierarchy in interface ModelComponent
    
    Overrides:
    
    disconnectFromHierarchy in class DynamicComponentBase
    
    Parameters:
    
    hcomp - hierarchy component from which this component, or its ancestor, was detached
  - resetRestPosition
```
public void resetRestPosition()
```
  - getRestPosition
```
public Point3d getRestPosition()
```
    Specified by:
    
    getRestPosition in class FemNode
  - getRenderPosition
```
public Point3d getRenderPosition()
```
  - setRestPosition
```
public void setRestPosition(Point3d pos)
```
  - copy
```
public FemNode3d copy(int flags,
                      java.util.Map<ModelComponent,ModelComponent> copyMap)
```
    Description copied from interface: CopyableComponent
    
    Create a copy of this component. If COPY_REFERENCES is set in flags, then any component referenced by this component should itself be set to a copy. This should be done first checking copyMap for an existing copy of the referenced component. If there is no existing copy, then a copy should be created by calling copy recursively and adding the new copy to copyMap.
    
    Specified by:
    
    copy in interface CopyableComponent
    
    Overrides:
    
    copy in class FemNode
    
    Parameters:
    
    flags - flags to control the copying
    
    copyMap - map to possible existing instances of referenced components
    
    Returns:
    
    copy of this component
  - numPoints
```
public int numPoints()
```
    Returns the number of points associated with this element, if any, or zero otherwise. If the element has points, then it's spatial extent is assumed to be enclosed within their convex hull. At present, elements that do not have points cannot be enclosed within oriented bounding box (OBB) trees.
    
    Specified by:
    
    numPoints in interface Boundable
    
    Returns:
    
    number of points associated with this element
  - getPoint
```
public Point3d getPoint(int idx)
```
    Returns the idx-th point associated with this element.
    
    Specified by:
    
    getPoint in interface Boundable
    
    Parameters:
    
    idx - index of the point (must be on the range 0 to Boundable.numPoints()).
    
    Returns:
    
    idx-th point associated with this element. Must not be modified.
  - computeCentroid
```
public void computeCentroid(Vector3d centroid)
```
    Computed the centroid of this element.
    
    Specified by:
    
    computeCentroid in interface Boundable
    
    Parameters:
    
    centroid - returns the computed centroid value.
  - computeCovariance
```
public double computeCovariance(Matrix3d C)
```
    Not implemented for FemNode3d.
    
    Specified by:
    
    computeCovariance in interface Boundable
    
    Parameters:
    
    C - returns the covariance
    
    Returns:
    
    -1 (not implemented)
  - setFrameNode
```
public void setFrameNode(FrameNode3d fnode)
```
  - getFrameNode
```
public FrameNode3d getFrameNode()
```
  - getFrameAttachment
```
public DynamicAttachment getFrameAttachment()
```
  - setAttached
```
public void setAttached(DynamicAttachment at)
```
    Description copied from interface: DynamicAgent
    
    Attach this component to another via a DynamicAttachment object. This method is intended for internal use by attachment components.
    
    Specified by:
    
    setAttached in interface DynamicAgent
    
    Overrides:
    
    setAttached in class DynamicComponentBase
    
    Parameters:
    
    at - Specifies the attachment relationship between this component and its master(s)
  - setDynamic
```
public void setDynamic(boolean enable)
```
    Overrides:
    
    setDynamic in class Particle
  - getLocalPosition
```
public Point3d getLocalPosition()
```
  - getLocalVelocity
```
public Vector3d getLocalVelocity()
```
  - getLocalSolveIndex
```
public int getLocalSolveIndex()
```
  - getLocalForce
```
public Vector3d getLocalForce()
```
  - addLocalForce
```
public void addLocalForce(Vector3d f)
```
  - setLocalForce
```
public void setLocalForce(Vector3d f)
```
  - isActiveLocal
```
public boolean isActiveLocal()
```
  - getLocalRestPosition
```
public Point3d getLocalRestPosition()
```
  - getLocalRenderPosition
```
public Point3d getLocalRenderPosition()
```
  - getState
```
public void getState(DataBuffer data)
```
    Description copied from interface: HasNumericState
    
    Saves state information for this component by adding data to the supplied DataBuffer. Existing data in the buffer should not be disturbed.
    
    Specified by:
    
    getState in interface DynamicAgent
    
    Specified by:
    
    getState in interface HasNumericState
    
    Overrides:
    
    getState in class Point
    
    Parameters:
    
    data - buffer for storing the state values.
  - setState
```
public void setState(DataBuffer data)
```
    Description copied from interface: HasNumericState
    
    Restores the state for this component by reading from the supplied data buffer, starting at the current buffer offsets.
    
    Specified by:
    
    setState in interface DynamicAgent
    
    Specified by:
    
    setState in interface HasNumericState
    
    Overrides:
    
    setState in class Point
    
    Parameters:
    
    data - buffer containing the state information
  - getBackSolveIndex
```
public int getBackSolveIndex()
```
  - getBackNode
```
public BackNode3d getBackNode()
```
  - hasDirector
```
public boolean hasDirector()
```
  - getDirector
```
public Vector3d getDirector()
```
  - getDirector
```
public void getDirector(Vector3d dir)
```
  - setDirector
```
public void setDirector(Vector3d dir)
```
  - clearDirector
```
public void clearDirector()
```
  - getDirectorVel
```
public Vector3d getDirectorVel()
```
  - setDirectorVel
```
public void setDirectorVel(Vector3d vel)
```
  - getRestDirector
```
public Point3d getRestDirector()
```
  - getRestDirector
```
public void getRestDirector(Vector3d rdir)
```
  - setRestDirector
```
public void setRestDirector(Vector3d restDir)
```
  - isRestDirectorExplicit
```
public boolean isRestDirectorExplicit()
```
  - clearRestDirector
```
public void clearRestDirector()
```
  - invalidateRestDirectorIfNecessary
```
public void invalidateRestDirectorIfNecessary()
```
  - getBackPosition
```
public Point3d getBackPosition()
```
  - setBackPosition
```
public void setBackPosition(Point3d pos)
```
  - getBackRestPosition
```
public Point3d getBackRestPosition()
```
  - setBackRestPosition
```
public void setBackRestPosition(Point3d rest)
```
  - getBackRenderPosition
```
public Point3d getBackRenderPosition()
```
  - getBackVelocity
```
public Vector3d getBackVelocity()
```
  - setBackVelocity
```
public void setBackVelocity(Vector3d vel)
```
  - getBackForce
```
public Vector3d getBackForce()
```
  - setBackForce
```
public void setBackForce(Vector3d f)
```
  - getBackInternalForce
```
public Vector3d getBackInternalForce()
```
  - zeroForces
```
public void zeroForces()
```
    Specified by:
    
    zeroForces in interface DynamicAgent
    
    Overrides:
    
    zeroForces in class Point
  - computeRestDirector
```
public void computeRestDirector()
```
  - computeRestDirector
```
public void computeRestDirector(Vector3d dir)
```
  - prerender
```
public void prerender(RenderList list)
```
    Description copied from interface: IsRenderable
    
    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 Point
    
    Parameters:
    
    list - list of objects to be rendered
  - getBackCoordinates
```
public Point3d getBackCoordinates(FemNode3d.CoordType ctype)
```

Class FemNode3d

Nested Class Summary

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

Field Summary

Fields inherited from class artisynth.core.mechmodels.Point

Fields inherited from class artisynth.core.modelbase.ModelComponentBase

Fields inherited from interface artisynth.core.modelbase.CopyableComponent

Fields inherited from interface artisynth.core.modelbase.TransformableGeometry

Fields inherited from interface maspack.render.IsRenderable

Constructor Summary

Method Summary

Methods inherited from class artisynth.core.femmodels.FemNode

Methods inherited from class artisynth.core.mechmodels.Particle

Methods inherited from class artisynth.core.mechmodels.Point

Methods inherited from class artisynth.core.mechmodels.DynamicComponentBase

Methods inherited from class artisynth.core.modelbase.RenderableComponentBase

Methods inherited from class artisynth.core.modelbase.ModelComponentBase

Methods inherited from class java.lang.Object

Methods inherited from interface maspack.geometry.Boundable

Methods inherited from interface artisynth.core.modelbase.ModelComponent

Methods inherited from interface maspack.properties.HasProperties

Methods inherited from interface maspack.properties.HierarchyNode

Methods inherited from interface artisynth.core.modelbase.PostScannable

Methods inherited from interface maspack.util.Scannable

Methods inherited from interface artisynth.core.mechmodels.DynamicComponent

Methods inherited from interface artisynth.core.mechmodels.DynamicAgent

Methods inherited from interface artisynth.core.modelbase.HasNumericState

Methods inherited from interface artisynth.core.modelbase.TransformableGeometry

Field Detail

NEEDS_STRESS

NEEDS_STRAIN

REST_POSITION_SCANNED

COMPUTE_STRESS_EXTERNAL

COMPUTE_STRESS_INTERNAL

COMPUTE_STRAIN_EXTERNAL

COMPUTE_STRAIN_INTERNAL

myProps

Constructor Detail

FemNode3d

FemNode3d

FemNode3d

Method Detail

getAllPropertyInfo

getLocalCoordinates

getCoordinates

getIndex

setIndex

getIncompressIndex

setIncompressIndex

getVonMisesStress

getMAPStress

getMaxShearStress

getVonMisesStrain

getMAPStrain

getMaxShearStrain

getDisplacement

getTargetDisplacement

setTargetDisplacement

zeroStressStrain

needsStressStrain

getStress

setStress

zeroStress

setComputeStress

getComputeStress

getStrain

setStrain

zeroStrain

addScaledStrain

setComputeStrain

getComputeStrain

getInternalForce

getNodeNeighbors

getNodeNeighbor

getNodeNeighborBySolveIndex

deregisterNodeNeighbor

getIndirectNeighbors

getIndirectNeighbor

getIndirectNeighborBySolveIndex

addIndirectNeighbor