FemModel3d (Artisynth API documentation)

java.lang.Object
- artisynth.core.modelbase.ModelComponentBase
- - artisynth.core.modelbase.ComponentList<ModelComponent>
  - - artisynth.core.modelbase.ModelBase
    - - artisynth.core.modelbase.RenderableModelBase
      - artisynth.core.mechmodels.MechSystemBase
        
        artisynth.core.femmodels.FemModel
        
        artisynth.core.femmodels.FemModel3d

All Implemented Interfaces:

Collidable, ConnectableBody, Constrainer, ForceEffector, FrameAttachable, HasSlaveObjects, HasSurfaceMesh, MechSystem, MechSystemModel, PointAttachable, ComponentChangeListener, ComponentListView<ModelComponent>, CompositeComponent, CopyableComponent, HasMenuItems, HasNumericState, HasState, IndexedComponentList, Model, ModelComponent, MutableCompositeComponent<ModelComponent>, PostScannable, PropertyChangeListener, RenderableComponent, TransformableGeometry, ScalableUnits, java.awt.event.ActionListener, java.lang.Cloneable, java.lang.Iterable<ModelComponent>, java.util.Collection<ModelComponent>, java.util.EventListener, HasProperties, HierarchyNode, HasRenderProps, IsRenderable, IsSelectable, Renderable, Disposable, ListView<ModelComponent>, ParameterizedClass, Scannable

Direct Known Subclasses:

FemModelDeformer, FemMuscleModel, MFreeModel3d
```
public class FemModel3d
extends FemModel
implements TransformableGeometry, ScalableUnits, Collidable, CopyableComponent, HasNumericState, HasSurfaceMesh, PointAttachable, ConnectableBody
```

Nested Class Summary
- Nested classes/interfaces inherited from class artisynth.core.femmodels.FemModel
  FemModel.ElementFilter, FemModel.IncompMethod, FemModel.Ranging, FemModel.SurfaceRender
- Nested classes/interfaces inherited from class artisynth.core.mechmodels.MechSystemBase
  MechSystemBase.ConstraintForceStateSaver
- Nested classes/interfaces inherited from interface artisynth.core.mechmodels.Collidable
  Collidable.Collidability, Collidable.Group
- Nested classes/interfaces inherited from interface artisynth.core.modelbase.ModelComponent
  ModelComponent.NavpanelVisibility
- Nested classes/interfaces inherited from interface artisynth.core.mechmodels.MechSystem
  MechSystem.ConstraintInfo
- Nested classes/interfaces inherited from interface artisynth.core.modelbase.CompositeComponent
  CompositeComponent.NavpanelDisplay

Field Summary

Fields
Modifier and Type	Field and Description
`static boolean`	`abortOnInvertedElems`
`static boolean`	`checkTangentStability`
`static boolean`	`debugx`
`static boolean`	`DEFAULT_ABORT_ON_INVERTED_ELEMENTS`
`static FemModel.IncompMethod`	`DEFAULT_HARD_INCOMP`
`static FemModel.IncompMethod`	`DEFAULT_SOFT_INCOMP`
`static java.lang.String`	`DEFAULT_SURFACEMESH_NAME`
`static boolean`	`defaultAutoGenerateSurface`
`static double`	`detJStepReductionLimit`
`static double`	`frameMassFraction`
`static PropertyList`	`myProps`
`static boolean`	`noIncompressStiffnessDamping`
`static boolean`	`useFrameRelativeCouplingMasses`
`static boolean`	`useNodalMassWeights`

Fields inherited from class artisynth.core.mechmodels.MechSystemBase
DEFAULT_STABILIZATION, DEFAULT_USE_IMPLICIT_FRICTION, myParametricsInSystemMatrix, mySaveForcesAsState, useAllDynamicComps

Fields inherited from class artisynth.core.modelbase.ModelBase
DEFAULT_MAX_STEP_SIZE

Fields inherited from class artisynth.core.modelbase.ComponentList
DEFAULT_NAVPANEL_DISPLAY

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

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

Fields inherited from interface artisynth.core.mechmodels.Collidable
All, AllBodies, Deformable, Rigid, Self

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

Fields inherited from interface artisynth.core.modelbase.Model
STATE_IS_VOLATILE

Fields inherited from interface artisynth.core.mechmodels.MechSystem
COMPUTE_CONTACTS, UPDATE_CONTACTS

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

Constructor Summary

Constructors
Constructor and Description

FemModel3d()

FemModel3d(java.lang.String name)

Constructors
Constructor and Description
`FemModel3d()`
`FemModel3d(java.lang.String name)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`addAuxMaterialBundle(AuxMaterialBundle bundle)`
`int`	`addBilateralConstraints(SparseBlockMatrix GT, VectorNd dg, int numb)` Appends the current bilateral force constraint matrix `Gc^T` to the matrix `GT`, by appending block columns to it.
`void`	`addConnector(BodyConnector c)`
`void`	`addCutPlane(FemCutPlane cutPlane)`
`void`	`addElement(FemElement3d e)`
`void`	`addElements(java.util.Collection<? extends FemElement3d> elems)`
`void`	`addField(FieldComponent field)`
`void`	`addGeneralMassBlocks(SparseNumberedBlockMatrix M)`
`void`	`addMarker(FemMarker mkr)` Adds a marker to this FemModel.
`FemMarker`	`addMarker(Point3d pos)` Creates and adds a marker to this FemModel.
`FemMarker`	`addMarker(Point3d pos, boolean project)` Creates and adds a marker to this FemModel.
`void`	`addMaterialBundle(MaterialBundle bundle)`
`FemMeshComp`	`addMesh(MeshBase mesh)`
`FemMeshComp`	`addMesh(java.lang.String name, MeshBase mesh)`
`void`	`addMeshComp(FemMeshComp surf)`
`void`	`addNode(FemNode3d p)`
`void`	`addNodes(java.util.Collection<? extends FemNode3d> nodes)`
`void`	`addNumberedElement(FemElement3d e, int elemId)`
`FemMarker`	`addNumberedMarker(Point3d pos, boolean project, int markerId)`
`FemMarker`	`addNumberedMarker(Point3d pos, int markerId)`
`void`	`addNumberedNode(FemNode3d p, int number)`
`void`	`addNumberedShellElement(ShellElement3d e, int elemId)`
`void`	`addPosJacobian(SparseNumberedBlockMatrix M, double s)` Scales the components of the position Jacobian associated with this force effector and adds it to the supplied solve matrix M.
`void`	`addShellElement(ShellElement3d e)`
`void`	`addShellElements(java.util.Collection<? extends ShellElement3d> elems)`
`void`	`addSolveBlocks(SparseNumberedBlockMatrix S)` Adds any needed blocks to a solve matrix in order to accomodate the Jacobian terms associated with this force effector.
`void`	`addTransformableDependencies(TransformGeometryContext context, int flags)` Adds to `context` any transformable components which should be transformed as the same time as this component.
`void`	`addVelJacobian(SparseNumberedBlockMatrix M, double s)` Scales the components of the velocity Jacobian associated with this force effector and adds it to the supplied solve matrix M.
`void`	`attachFrame(RigidTransform3d TRW)`
`boolean`	`checkElementCondition(FemElement3dBase e, double detJ, boolean recordInversion)`
`void`	`clearAuxMaterialBundles()`
`void`	`clearCutPlanes()`
`void`	`clearElementConditionInfo()`
`void`	`clearElements()`
`void`	`clearFields()`
`void`	`clearMaterialBundles()`
`void`	`clearMeshComps()`
`void`	`clearShellElements()`
`void`	`computeStressAndStiffness(FemElement3d e, FemMaterial mat, java.util.ArrayList<FemMaterial> amats, Matrix6d D, FemModel.IncompMethod softIncomp)`
`boolean`	`containsConnector(BodyConnector c)`
`FemModel3d`	`copy(int flags, java.util.Map<ModelComponent,ModelComponent> copyMap)` Create a copy of this component.
`static ColorMapBase`	`createDefaultColorMap()`
`FrameFem3dAttachment`	`createFrameAttachment(Frame frame, RigidTransform3d TFW)` Returns a FrameAttachment that attaches a `frame` to this component.
`FrameFem3dAttachment`	`createFrameAttachment(Frame frame, RigidTransform3d TFW, boolean project)` Returns a FrameAttachment that attaches a `frame` to this component.
`PointAttachment`	`createPointAttachment(Point pnt)` Returns a PointAttachment that attaches `pnt` to this component.
`PointAttachment`	`createPointAttachment(Point pnt, double reduceTol)`
`FemMeshComp`	`createSurfaceMesh(FemModel.ElementFilter efilter)`
`void`	`dispose()` Called when the model is discarded.
`FemElement3d`	`findContainingElement(Point3d pnt)` Returns the element within an FEM that contains a specified point, or `null` if there is no such element.
`FemElement3dBase`	`findNearestElement(Point3d loc, Point3d pnt)` Returns the element within an FEM that contains a specified point, or if there is no such element, finds the nearest element.
`FemElement3dBase`	`findNearestElement(Point3d loc, Point3d pnt, FemModel.ElementFilter filter)`
`FemNode3d`	`findNearestNode(Point3d pnt, double maxDist)` Finds the nearest node to a specified point that is within a specified maximum distance.
`java.util.ArrayList<FemNode3d>`	`findNearestNodes(Point3d pnt, double maxDist)` Finds and returns a list of all the nodes of an FEM that are within a specified maximum distance of a specified point.
`ShellElement3d`	`findNearestShellElement(Point3d loc, Point3d pnt)` Returns the shell element within an FEM that is nearest to a specified point.
`FemElement3dBase`	`findNearestSurfaceElement(Point3d loc, Point3d pnt)` Returns the nearest surface element to a specified point, which is found by projecting the point onto the FEM surface.
`FemElement3d`	`findNearestVolumetricElement(Point3d loc, Point3d pnt)` Returns the volumetric element within an FEM that contains a specified point, or if there is no such element, finds the nearest element.
`java.util.ArrayList<FemElement3dBase>`	`getAllElements()` Returns a list of all elements, volumetric and shell.
`PropertyList`	`getAllPropertyInfo()` Returns a list giving static information about all properties exported by this object.
`void`	`getAttachments(java.util.List<DynamicAttachment> list, int level)`
`java.util.ArrayList<FemMaterial>`	`getAugmentingMaterials()` Returns a list of augmenting materials which are applied to all elements, or `null` if there are none.
`RenderableComponentList<AuxMaterialBundle>`	`getAuxMaterialBundles()`
`void`	`getAuxStateComponents(java.util.List<HasNumericState> comps, int level)`
`double`	`getAxisLength()`
`int`	`getBilateralForces(VectorNd lam, int idx)` Returns the bilateral forces that were most recently set for this constrainer using `Constrainer.setBilateralForces(maspack.matrix.VectorNd, double, int)`.
`int`	`getBilateralInfo(MechSystem.ConstraintInfo[] ginfo, int idx)` Returns constraint information for each row of the bilateral constraint system
`void`	`getBilateralSizes(VectorNi sizes)` Returns the sizes of each block column in the bilateral force constraint matrix.
`BVTree`	`getBVTree()` Return BV tree for those who know what to do with it
`FemNode3d`	`getByNumber(int num)` Deprecated. use `getNodeByNumber(int)` instead
`Collidable.Collidability`	`getCollidable()` Returns the `Collidable.Collidability` of this Collidable.
`Collidable`	`getCollidableAncestor()` Returns the most immediate Collidable ancestor of this Collidable, if any.
`void`	`getCollidables(java.util.List<Collidable> list, int level)`
`ColorMapBase`	`getColorMap()`
`PropertyMode`	`getColorMapMode()`
`java.util.List<BodyConnector>`	`getConnectors()`
`void`	`getConstrainedComponents(java.util.List<DynamicComponent> list)` Collected all the dynamic components constrained by this constrainer.
`boolean`	`getCopyReferences(java.util.List<ModelComponent> refs, ModelComponent ancestor)` Collects external references which must also be copied in order to duplicate this component.
`FemCutPlane`	`getCutPlane(int idx)`
`RenderableComponentList<FemCutPlane>`	`getCutPlanes()`
`double`	`getDirectorRenderLen()`
`void`	`getDynamicComponents(java.util.List<DynamicComponent> comps)`
`void`	`getDynamicComponents(java.util.List<DynamicComponent> active, java.util.List<DynamicComponent> attached, java.util.List<DynamicComponent> parametric)`
`FemElement3d`	`getElement(int idx)`
`FemElement3d`	`getElementByNumber(int num)`
`FemMaterial`	`getElementMaterial(FemElement3dBase e)`
`java.util.LinkedList<FemElement3d>`	`getElementNeighbors(FemNode3d node)`
`java.util.ArrayList<Element3dValuePair>`	`getElementRestVolumes()` Returns a list of element-value pairs describing the rest volumes of all the volumetric elements in this model.
`FemElement3dList<FemElement3d>`	`getElements()`
`double`	`getElementWidgetSize()`
`PropertyMode`	`getElementWidgetSizeMode()`
`FieldComponent`	`getField(java.lang.String name)`
`ComponentList<FieldComponent>`	`getFields()`
`FemModelFrame`	`getFrame()`
`FrameFem3dConstraint`	`getFrameConstraint()`
`FemModel.IncompMethod`	`getHardIncompMethod()`
`double`	`getIncompCompliance()`
`int`	`getIncompForces(double[] lbuf, int idx)`
`FemModel.IncompMethod`	`getIncompressible()`
`Range`	`getIncompressibleRange()`
`int`	`getJacobianType()` Returns a code indicating the matrix type that results when the Jacobian terms of this force effector are added to the solve matrix.
`void`	`getMassMatrixValues(SparseNumberedBlockMatrix M, VectorNd f, double t)`
`RenderableComponentList<MaterialBundle>`	`getMaterialBundles()`
`FemMeshComp`	`getMeshComp(int idx)`
`FemMeshComp`	`getMeshComp(java.lang.String name)`
`MeshComponentList<FemMeshComp>`	`getMeshComps()`
`DoubleInterval`	`getNodalPlotRange(FemModel.SurfaceRender rendering)`
`FemNode3d`	`getNode(int idx)`
`FemNode3d`	`getNodeByNumber(int num)` Locates a node within this FEM by number instead of index.
`java.util.ArrayList<FemNodeNeighbor>`	`getNodeNeighbors(FemNode3d node)`
`PointList<FemNode3d>`	`getNodes()`
`boolean`	`getOneBasedNodeElementNumbering()` Queries whether the numbering for the nodes, elements and shell elements in this FEM is one-based.
`void`	`getSelection(java.util.LinkedList<java.lang.Object> list, int qid)` Append to `list` the component (or components) associated with the `qid`-th selection query issued by this component's render method.
`ShellElement3d`	`getShellElement(int idx)`
`ShellElement3d`	`getShellElementByNumber(int num)`
`FemElement3dList<ShellElement3d>`	`getShellElements()`
`ShellElement3d`	`getShellSurfaceElement(Face face)`
`FemModel.IncompMethod`	`getSoftIncompMethod()`
`Range`	`getSoftIncompMethodRange()`
`void`	`getState(DataBuffer data)` Saves state information for this component by adding data to the supplied DataBuffer.
`FemElement3dBase`	`getSurfaceElement(Face face)`
`PolygonalMesh`	`getSurfaceMesh()` Returns the surface mesh associated with this component, or `null` if no mesh exists.
`FemMeshComp`	`getSurfaceMeshComp()`
`PolygonalMesh[]`	`getSurfaceMeshes()` Returns an array listing all the (non-null) surface meshes associated with this component, or a zero-length array if there are none.
`FemNode3d`	`getSurfaceNode(Vertex3d vtx)` Returns the FEM node (if any) associated with a specified surface mesh vertex.
`Vertex3d`	`getSurfaceVertex(FemNode3d node)` Returns the surface mesh vertex (if any) associated with a specified node.
`java.util.ArrayList<Element3dValuePair>`	`getTetAspectRatios()` Returns a list of element-value pairs describing the aspect ratios of all the tet elements in this model.
`boolean`	`getUseConsistentMass()`
`void`	`handleComponentChanged(ComponentChangeEvent e)`
`boolean`	`hasHexMesh()`
`boolean`	`hasTetMesh()`
`void`	`invalidateElementRotationData()`
`void`	`invalidateRestData()`
`void`	`invalidateStressAndStiffness()`
`void`	`invalidateSurfaceMesh()`
`boolean`	`isAbortOnInvertedElements()`
`boolean`	`isAutoGeneratingSurface()`
`boolean`	`isCompound()` Queries whether or not this collidable has sub-collidables.
`boolean`	`isDeformable()` Returns `true` if this collidable is deformable.
`boolean`	`isDuplicatable()` Returns true if this component can be duplicated.
`boolean`	`isFrameRelative()`
`boolean`	`isFreeBody()`
`boolean`	`isSurfaceEdge(FemNode3d node0, FemNode3d node1)` Returns true if a specified node pair lies along an edge of the surface mesh returned by `getSurfaceMesh()`.
`boolean`	`isSurfaceMeshValid()`
`boolean`	`isSurfaceNode(FemNode3d node)` Returns true if a specified node lies on the surface mesh returned by `getSurfaceMesh()`.
`boolean`	`isVolumeValid()`
`boolean`	`isWarnOnInvertedElements()`
`int`	`markInvertedRestElements()`
`void`	`mulInverseMass(SparseBlockMatrix M, VectorNd a, VectorNd f)`
`int`	`numAllElements()` Returns the number of all elements, volumetric and shell.
`int`	`numCutPlanes()`
`int`	`numElements()`
`int`	`numFields()`
`int`	`numHexElements()`
`int`	`numMeshComps()`
`int`	`numQuadraticElements()`
`int`	`numShellElements()`
`int`	`numSurfaceMeshes()` Returns the number of surfaces meshes associated with this component, or 0 if no meshes exist.
`int`	`numTetElements()`
`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).
`void`	`printANSYSElements(java.io.PrintWriter pw)` Prints the elements of this FEM in a format which is compatible with ANSYS.
`void`	`printANSYSNodes(java.io.PrintWriter pw)` Prints the nodes of this FEM in a format which is compatible with ANSYS.
`void`	`recursivelyFinalizeAdvance(StepAdjustment stepAdjust, double t0, double t1, int flags, int level)`
`void`	`recursivelyInitialize(double t, int level)`
`boolean`	`removeAuxMaterialBundle(AuxMaterialBundle bundle)`
`void`	`removeConnector(BodyConnector c)`
`boolean`	`removeCutPlane(FemCutPlane cutPlane)`
`boolean`	`removeElement(FemElement3d e)`
`boolean`	`removeField(FieldComponent field)`
`boolean`	`removeMaterialBundle(MaterialBundle bundle)`
`boolean`	`removeMeshComp(FemMeshComp surf)`
`boolean`	`removeNode(FemNode3d p)`
`boolean`	`removeShellElement(ShellElement3d e)`
`void`	`render(Renderer renderer, int flags)` Render this object using the functionality of the supplied `Renderer`.
`void`	`resetRestPosition()`
`void`	`scaleDistance(double s)` Scales all distance coordinates.
`void`	`scaleMass(double s)` Scales all mass units.
`void`	`scan(ReaderTokenizer rtok, java.lang.Object ref)` Scans this element from a ReaderTokenizer.
`FemMeshComp`	`scanMesh(ReaderTokenizer rtok)`
`FemMeshComp`	`scanMesh(java.lang.String fileName)`
`FemMeshComp`	`scanSurfaceMesh(ReaderTokenizer rtok)`
`FemMeshComp`	`scanSurfaceMesh(java.lang.String fileName)`
`void`	`setAbortOnInvertedElements(boolean set)`
`void`	`setAutoGenerateSurface(boolean val)`
`void`	`setAxisLength(double len)`
`int`	`setBilateralForces(VectorNd lam, double s, int idx)` Sets the bilateral forces that were computed to enforce this constraint.
`void`	`setCollidable(Collidable.Collidability c)`
`void`	`setColorMap(ColorMapBase colorMap)`
`void`	`setColorMapMode(PropertyMode mode)`
`void`	`setComputeNodalStrain(boolean enable)` Explicitly enables or disables strain computation for all the nodes in this FEM, regardless of whether it is needed for surface rendering.
`void`	`setComputeNodalStress(boolean enable)` Explicitly enables or disables stress computation for all the nodes in this FEM, regardless of whether it is needed for surface rendering.
`void`	`setDirectorRenderLen(double len)`
`void`	`setElementWidgetSize(double size)`
`void`	`setElementWidgetSizeMode(PropertyMode mode)`
`void`	`setFrameRelative(boolean enable)`
`void`	`setIncompCompliance(double c)`
`int`	`setIncompForces(double[] lbuf, double s, int idx)`
`void`	`setIncompressible(FemModel.IncompMethod method)`
`<T extends FemMaterial> void`	`setMaterial(T mat)`
`void`	`setOneBasedNodeElementNumbering(boolean oneBased)` Sets the numbering for the nodes, elements and shell elements in this FEM to be one-based (as opposed to the default numbering, which is zero-based).
`void`	`setSoftIncompMethod(FemModel.IncompMethod method)`
`void`	`setState(DataBuffer data)` Restores the state for this component by reading from the supplied data buffer, starting at the current buffer offsets.
`FemMeshComp`	`setSurfaceMesh(PolygonalMesh mesh)`
`void`	`setSurfaceMeshComp(FemMeshComp mesh)`
`void`	`setSurfaceRendering(FemModel.SurfaceRender mode)`
`void`	`setUseConsistentMass(boolean enable)`
`void`	`setWarnOnInvertedElements(boolean set)`
`void`	`subdivideHex(HexElement hex)`
`void`	`subdivideHexs(java.util.List<HexElement> hexs)`
`void`	`transformGeometry(AffineTransform3dBase X)` Applies an affine transformation to the geometry of this component.
`void`	`transformGeometry(GeometryTransformer gtr, TransformGeometryContext context, int flags)` Transforms the geometry of this component, using the geometry transformer `gtr` to transform its individual attributes.
`void`	`transformPose(RigidTransform3d T)`
`void`	`updateBounds(Vector3d pmin, Vector3d pmax)` Update the minimum and maximum points for this object.
`double`	`updateConstraints(double t, int flags)` Updates the current set of constraints, and returns the maximum penetration `>` 0 associated with all of them.
`void`	`updateInternalNodalStrainSettings()`
`void`	`updateInternalNodalStressSettings()`
`void`	`updateSlavePos()` Called when the system's dynamic position state changes, to update the position state of the slave objects.
`void`	`updateStress()`
`void`	`updateStressAndStiffness()`
`boolean`	`usingAttachedRelativeFrame()`
`boolean`	`writeSurfaceMesh(java.io.PrintWriter pw)`
`void`	`writeSurfaceMesh(java.lang.String fileName)`
`void`	`zeroForces()` Zeros all bilateral and unilateral constraint forces in this constraint.

Methods inherited from class artisynth.core.femmodels.FemModel
addFrictionConstraints, addMarker, addMarker, addMarker, addMarker, addMarker, addMarker, addUnilateralConstraints, applyForces, attachments, attachPoint, checkVelocityStability, clear, componentChanged, createDefaultMaterial, detachAllNodes, detachPoint, forcesNeedUpdating, getCharacteristicSize, getCollidables, getConstrainers, getDensity, getDensityMode, getEnergy, getForceEffectors, getFrictionForces, getFrictionState, getGravity, getGravityMode, getImplicitIterations, getImplicitPrecision, getMass, getMassDamping, getMaterial, getNodeMass, getNumInverted, getParticleDamping, getRestVolume, getSlaveObjectComponents, getStiffnessDamping, getStressPlotRange, getStressPlotRangeMode, getStressPlotRanging, getStressPlotRangingMode, getSurfaceRendering, getSurfaceRenderingMode, getToleranceType, getUnilateralForces, getUnilateralInfo, getUnilateralSizes, getUnilateralState, getVolume, hasState, markers, maxFrictionConstraintSets, numNodes, printNodeMasses, propertyChanged, removeMarker, resetStressPlotRange, setBounds, setDensity, setDensityMode, setFrictionForces, setFrictionState, setGravity, setGravity, setGravityMode, setImplicitIterations, setImplicitPrecision, setLinearMaterial, setMassDamping, setMaxStepSize, setParticleDamping, setStiffnessDamping, setStressPlotRange, setStressPlotRangeMode, setStressPlotRanging, setStressPlotRangingMode, setSurfaceRenderingMode, setToleranceType, setUnilateralForces, setUnilateralState, updateRestVolume, updateSlaveVel, updateVolume, zeroExternalForces

Methods inherited from class artisynth.core.mechmodels.MechSystemBase
addActivePosImpulse, addAttachmentJacobian, addAttachmentSolveBlocks, addGeneralSolveBlocks, addPosJacobian, addVelJacobian, advance, advanceAuxState, applyAttachmentForces, buildMassMatrix, buildSolveMatrix, closePrintStateFile, collectInitialForces, createState, createVelocityJacobian, getActiveDampingMatrix, getActiveDynamicComponents, getActiveForces, getActiveMass, getActiveMassMatrix, getActivePosDerivative, getActivePosState, getActivePosStateSize, getActiveStiffnessMatrix, getActiveVelState, getActiveVelState, getActiveVelStateSize, getAttachmentConstraints, getAttachmentDerivatives, getAuxAdvanceState, getAuxVarDerivative, getAuxVarState, getAuxVarStateSize, getBilateralConstraints, getBilateralConstraintSizes, getBilateralForces, getBilateralInfo, getDefaultMatrixSolver, getDefaultStabilization, getDefaultUseImplicitFriction, getDynamicComponents, getDynamicDOFs, getDynamicsEnabled, getForces, getFrictionConstraints, getFrictionForces, getFrictionState, getInitialState, getIntegrator, getInverseMassMatrix, getMassMatrix, getMatrixSolver, getMatrixSolverRange, getNumBilateralForces, getNumUnilateralForces, getParametricForces, getParametricPosState, getParametricPosStateSize, getParametricPosTarget, getParametricVelState, getParametricVelStateSize, getParametricVelTarget, getPenetrationLimit, getPrintState, getProfiling, getSolveMatrixType, getSolver, getStabilization, getState, getStructureVersion, getUnilateralConstraints, getUnilateralConstraintSizes, getUnilateralForces, getUnilateralInfo, getUnilateralState, getUpdateForcesAtStepEnd, getUpdateForcesAtStepEndMode, getUseImplicitFriction, initialize, isBilateralStructureConstant, numActiveComponents, numAttachedComponents, numParametricComponents, openPrintStateFile, placeDynamicComponent, preadvance, printActiveMass, printActiveMass, printActiveStiffness, printActiveStiffness, recursivelyPrepareAdvance, reduceVelocityJacobian, reopenPrintStateFile, setActiveForces, setActivePosState, setActiveVelState, setAuxAdvanceState, setAuxVarState, setBilateralForces, setDefaultMatrixSolver, setDefaultStabilization, setDefaultUseImplicitFriction, setDynamicsEnabled, setForces, setFrictionForces, setFrictionState, setIntegrator, setMatrixSolver, setParametricForces, setParametricPosState, setParametricVelState, setPenetrationLimit, setPrintState, setPrintState, setProfiling, setStabilization, setState, setUnilateralForces, setUnilateralState, setUpdateForcesAtStepEnd, setUpdateForcesAtStepEndMode, setUseImplicitFriction, topMechSystem, updateAttachmentPos, updateAttachmentVel, updateConstraints, updateForces, updatePosState, updateVelState, writeBilateralConstraintMatrix, writeBilateralConstraintMatrix, writeMassMatrix, writeMassMatrix, writePrintStateHeader, writeStiffnessMatrix, writeStiffnessMatrix

Methods inherited from class artisynth.core.modelbase.RenderableModelBase
createRenderProps, getRenderHints, getRenderProps, isSelectable, numSelectionQueriesNeeded, setRenderProps

Methods inherited from class artisynth.core.modelbase.ModelBase
actionPerformed, copy, getDefaultMaxStepSize, getMaxStepSize, getMenuItems, hasParameterizedType, hierarchyContainsReferences, setDefaultMaxStepSize

Methods inherited from class artisynth.core.modelbase.ComponentList
add, add, addAll, addComponents, addFixed, addNumbered, clone, contains, contains, containsAll, ensureCapacity, findComponent, get, get, getChildren, getNavpanelDisplay, getNumberLimit, getOneBasedNumbering, getParameterType, getShortName, hasChildren, indexOf, invalidateNumbers, isEditable, isEmpty, iterator, nextComponentNumber, numComponents, remove, remove, removeAll, removeAll, removeComponents, resetNumbersToIndices, retainAll, set, setEditable, setNavpanelDisplay, setNumbered, setOneBasedNumbering, setShortName, size, toArray, toArray, updateNameMap

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

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

Methods inherited from interface artisynth.core.modelbase.ModelComponent
connectToHierarchy, disconnectFromHierarchy, getHardReferences, getName, getNavpanelVisibility, getNumber, 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 maspack.util.Scannable
isWritable, write

Methods inherited from interface artisynth.core.modelbase.Model
getMaxStepSize

Methods inherited from interface artisynth.core.modelbase.ComponentListView
getName

Methods inherited from interface java.util.Collection
equals, hashCode, parallelStream, removeIf, spliterator, stream

Methods inherited from interface java.lang.Iterable
forEach

- Field Detail
  - useFrameRelativeCouplingMasses
```
public static boolean useFrameRelativeCouplingMasses
```
  - DEFAULT_ABORT_ON_INVERTED_ELEMENTS
```
public static boolean DEFAULT_ABORT_ON_INVERTED_ELEMENTS
```
  - abortOnInvertedElems
```
public static boolean abortOnInvertedElems
```
  - checkTangentStability
```
public static boolean checkTangentStability
```
  - noIncompressStiffnessDamping
```
public static boolean noIncompressStiffnessDamping
```
  - useNodalMassWeights
```
public static boolean useNodalMassWeights
```
  - detJStepReductionLimit
```
public static double detJStepReductionLimit
```
  - frameMassFraction
```
public static double frameMassFraction
```
  - DEFAULT_HARD_INCOMP
```
public static FemModel.IncompMethod DEFAULT_HARD_INCOMP
```
  - DEFAULT_SOFT_INCOMP
```
public static FemModel.IncompMethod DEFAULT_SOFT_INCOMP
```
  - myProps
```
public static PropertyList myProps
```
  - defaultAutoGenerateSurface
```
public static boolean defaultAutoGenerateSurface
```
  - DEFAULT_SURFACEMESH_NAME
```
public static java.lang.String DEFAULT_SURFACEMESH_NAME
```
  - debugx
```
public static boolean debugx
```
- Constructor Detail
  - FemModel3d
```
public FemModel3d()
```
  - FemModel3d
```
public FemModel3d(java.lang.String name)
```
- 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 FemModel
    
    Returns:
    
    static information for all exported properties
  - getAxisLength
```
public double getAxisLength()
```
  - setAxisLength
```
public void setAxisLength(double len)
```
  - isFrameRelative
```
public boolean isFrameRelative()
```
  - setFrameRelative
```
public void setFrameRelative(boolean enable)
```
  - setElementWidgetSize
```
public void setElementWidgetSize(double size)
```
  - getElementWidgetSize
```
public double getElementWidgetSize()
```
  - setElementWidgetSizeMode
```
public void setElementWidgetSizeMode(PropertyMode mode)
```
  - getElementWidgetSizeMode
```
public PropertyMode getElementWidgetSizeMode()
```
  - getIncompressible
```
public FemModel.IncompMethod getIncompressible()
```
  - getHardIncompMethod
```
public FemModel.IncompMethod getHardIncompMethod()
```
  - setIncompressible
```
public void setIncompressible(FemModel.IncompMethod method)
```
  - getIncompressibleRange
```
public Range getIncompressibleRange()
```
  - setSoftIncompMethod
```
public void setSoftIncompMethod(FemModel.IncompMethod method)
```
  - getSoftIncompMethod
```
public FemModel.IncompMethod getSoftIncompMethod()
```
  - getSoftIncompMethodRange
```
public Range getSoftIncompMethodRange()
```
  - getIncompCompliance
```
public double getIncompCompliance()
```
  - setIncompCompliance
```
public void setIncompCompliance(double c)
```
  - createDefaultColorMap
```
public static ColorMapBase createDefaultColorMap()
```
  - getColorMap
```
public ColorMapBase getColorMap()
```
  - setColorMap
```
public void setColorMap(ColorMapBase colorMap)
```
  - getColorMapMode
```
public PropertyMode getColorMapMode()
```
  - setColorMapMode
```
public void setColorMapMode(PropertyMode mode)
```
  - getDirectorRenderLen
```
public double getDirectorRenderLen()
```
  - setDirectorRenderLen
```
public void setDirectorRenderLen(double len)
```
  - getCollidable
```
public Collidable.Collidability getCollidable()
```
    Description copied from interface: Collidable
    
    Returns the Collidable.Collidability of this Collidable. This provides control over whether external and/or internal collisions are enabled for this Collidable. This setting takes precedence over default and explicitly requested collision behaviors.
    Note that for collisions to actually occur, they still need to be enabled through either a default or explicit collision behavior in the MechModel.
    
    Specified by:
    
    getCollidable in interface Collidable
    
    Returns:
    
    Collidability of this collidable.
  - setCollidable
```
public void setCollidable(Collidable.Collidability c)
```
  - getUseConsistentMass
```
public boolean getUseConsistentMass()
```
  - setUseConsistentMass
```
public void setUseConsistentMass(boolean enable)
```
  - setMaterial
```
public <T extends FemMaterial> void setMaterial(T mat)
```
    Overrides:
    
    setMaterial in class FemModel
  - getElementMaterial
```
public FemMaterial getElementMaterial(FemElement3dBase e)
```
  - setComputeNodalStress
```
public void setComputeNodalStress(boolean enable)
```
    Explicitly enables or disables stress computation for all the nodes in this FEM, regardless of whether it is needed for surface rendering.
    
    Parameters:
    
    enable - if true, enables explicit stress computation
  - updateInternalNodalStressSettings
```
public void updateInternalNodalStressSettings()
```
  - setComputeNodalStrain
```
public void setComputeNodalStrain(boolean enable)
```
    Explicitly enables or disables strain computation for all the nodes in this FEM, regardless of whether it is needed for surface rendering.
    
    Parameters:
    
    enable - if true, enables explicit strain computation
  - updateInternalNodalStrainSettings
```
public void updateInternalNodalStrainSettings()
```
  - addAuxMaterialBundle
```
public void addAuxMaterialBundle(AuxMaterialBundle bundle)
```
  - removeAuxMaterialBundle
```
public boolean removeAuxMaterialBundle(AuxMaterialBundle bundle)
```
  - clearAuxMaterialBundles
```
public void clearAuxMaterialBundles()
```
  - getAuxMaterialBundles
```
public RenderableComponentList<AuxMaterialBundle> getAuxMaterialBundles()
```
  - addMaterialBundle
```
public void addMaterialBundle(MaterialBundle bundle)
```
  - removeMaterialBundle
```
public boolean removeMaterialBundle(MaterialBundle bundle)
```
  - clearMaterialBundles
```
public void clearMaterialBundles()
```
  - getMaterialBundles
```
public RenderableComponentList<MaterialBundle> getMaterialBundles()
```
  - getNodes
```
public PointList<FemNode3d> getNodes()
```
    Specified by:
    
    getNodes in class FemModel
  - getNode
```
public FemNode3d getNode(int idx)
```
    Specified by:
    
    getNode in class FemModel
  - getByNumber
```
public FemNode3d getByNumber(int num)
```
    Deprecated. use getNodeByNumber(int) instead
    
    Description copied from class: ComponentList
    
    Get the component with the specified number, or null if there is no such component.
    
    Specified by:
    
    getByNumber in interface ComponentListView<ModelComponent>
    
    Specified by:
    
    getByNumber in interface CompositeComponent
    
    Overrides:
    
    getByNumber in class ComponentList<ModelComponent>
    
    Parameters:
    
    num - number of the component
    
    Returns:
    
    component with specified number
  - getNodeByNumber
```
public FemNode3d getNodeByNumber(int num)
```
    Locates a node within this FEM by number instead of index.
    
    Specified by:
    
    getNodeByNumber in class FemModel
    
    Parameters:
    
    num - number of the node to locate
    
    Returns:
    
    node with the specified number, or null if no such node is present
  - addNode
```
public void addNode(FemNode3d p)
```
  - addNodes
```
public void addNodes(java.util.Collection<? extends FemNode3d> nodes)
```
  - addNumberedNode
```
public void addNumberedNode(FemNode3d p,
                            int number)
```
  - removeNode
```
public boolean removeNode(FemNode3d p)
```
  - getNodeNeighbors
```
public java.util.ArrayList<FemNodeNeighbor> getNodeNeighbors(FemNode3d node)
```
  - getAllElements
```
public java.util.ArrayList<FemElement3dBase> getAllElements()
```
    Returns a list of all elements, volumetric and shell. This is the concatination of the element lists returned by getElements() and getShellElements().
    
    Specified by:
    
    getAllElements in class FemModel
    
    Returns:
    
    list of all elements
  - numAllElements
```
public int numAllElements()
```
    Returns the number of all elements, volumetric and shell. This is the addition of the numbers returned by numElements() and numShellElements().
    
    Specified by:
    
    numAllElements in class FemModel
    
    Returns:
    
    number of all elements
  - getElement
```
public FemElement3d getElement(int idx)
```
  - getElementByNumber
```
public FemElement3d getElementByNumber(int num)
```
  - getElements
```
public FemElement3dList<FemElement3d> getElements()
```
  - numElements
```
public int numElements()
```
  - getElementNeighbors
```
public java.util.LinkedList<FemElement3d> getElementNeighbors(FemNode3d node)
```
  - getSurfaceElement
```
public FemElement3dBase getSurfaceElement(Face face)
```
  - addElement
```
public void addElement(FemElement3d e)
```
  - addElements
```
public void addElements(java.util.Collection<? extends FemElement3d> elems)
```
  - addNumberedElement
```
public void addNumberedElement(FemElement3d e,
                               int elemId)
```
  - removeElement
```
public boolean removeElement(FemElement3d e)
```
  - clearElements
```
public void clearElements()
```
  - numShellElements
```
public int numShellElements()
```
  - getShellElement
```
public ShellElement3d getShellElement(int idx)
```
  - getShellElementByNumber
```
public ShellElement3d getShellElementByNumber(int num)
```
  - getShellElements
```
public FemElement3dList<ShellElement3d> getShellElements()
```
  - getShellSurfaceElement
```
public ShellElement3d getShellSurfaceElement(Face face)
```
  - addShellElement
```
public void addShellElement(ShellElement3d e)
```
  - addShellElements
```
public void addShellElements(java.util.Collection<? extends ShellElement3d> elems)
```
  - addNumberedShellElement
```
public void addNumberedShellElement(ShellElement3d e,
                                    int elemId)
```
  - removeShellElement
```
public boolean removeShellElement(ShellElement3d e)
```
  - clearShellElements
```
public void clearShellElements()
```
  - addMarker
```
public void addMarker(FemMarker mkr)
```
    Adds a marker to this FemModel. If the marker has not already been set (i.e., if no nodes or elements have been assigned to it), then it is attached to the nearest element in the model. This is either the containing element, or the nearest element on the model's surface.
    
    Overrides:
    
    addMarker in class FemModel
    
    Parameters:
    
    mkr - marker point to add to the model
  - addMarker
```
public FemMarker addMarker(Point3d pos)
```
    Creates and adds a marker to this FemModel. The element to which it belongs is determined automatically. If the marker's current position does not lie within the model, it is projected onto the model's surface.
    
    Parameters:
    
    pos - position to place a marker in the model
    
    Returns:
    
    created marker
  - addMarker
```
public FemMarker addMarker(Point3d pos,
                           boolean project)
```
    Creates and adds a marker to this FemModel. The element to which it belongs is determined automatically. If the marker's current position does not lie within the model and project == true, it will be projected onto the model's surface.
    
    Parameters:
    
    pos - position to place a marker in the model
    
    project - if true and pnt is outside the model, projects to the nearest element. Otherwise, uses the original position.
    
    Returns:
    
    created marker
  - addNumberedMarker
```
public FemMarker addNumberedMarker(Point3d pos,
                                   int markerId)
```
  - addNumberedMarker
```
public FemMarker addNumberedMarker(Point3d pos,
                                   boolean project,
                                   int markerId)
```
  - findContainingElement
```
public FemElement3d findContainingElement(Point3d pnt)
```
    Returns the element within an FEM that contains a specified point, or null if there is no such element.
    
    Parameters:
    
    pnt - Point for which containing element is desired.
    
    Returns:
    
    containing element, or null.
  - findNearestSurfaceElement
```
public FemElement3dBase findNearestSurfaceElement(Point3d loc,
                                                  Point3d pnt)
```
    Returns the nearest surface element to a specified point, which is found by projecting the point onto the FEM surface. The location of the projection is returned in loc.
    
    Parameters:
    
    loc - Projected location of the point onto the surface.
    
    pnt - Point for which nearest surface element is desired.
    
    Returns:
    
    Nearest surface element.
  - findNearestElement
```
public FemElement3dBase findNearestElement(Point3d loc,
                                           Point3d pnt,
                                           FemModel.ElementFilter filter)
```
  - findNearestElement
```
public FemElement3dBase findNearestElement(Point3d loc,
                                           Point3d pnt)
```
    Returns the element within an FEM that contains a specified point, or if there is no such element, finds the nearest element.
    
    Parameters:
    
    loc - (optional) If non-null, returns the location of the point, within the FEM or projected onto the nearest element.
    
    pnt - Point for which the nearest element is desired.
    
    Returns:
    
    Nearest element.
  - findNearestVolumetricElement
```
public FemElement3d findNearestVolumetricElement(Point3d loc,
                                                 Point3d pnt)
```
    Returns the volumetric element within an FEM that contains a specified point, or if there is no such element, finds the nearest element.
    
    Parameters:
    
    loc - (optional) If non-null, returns the location of the point, within the FEM or projected onto the nearest element.
    
    pnt - Point for which the nearest element is desired.
    
    Returns:
    
    Nearest element.
  - findNearestShellElement
```
public ShellElement3d findNearestShellElement(Point3d loc,
                                              Point3d pnt)
```
    Returns the shell element within an FEM that is nearest to a specified point.
    
    Parameters:
    
    loc - (optional) If non-null, returns the location of the point projected onto the nearest element.
    
    pnt - Point for which the nearest element is desired.
    
    Returns:
    
    Nearest element.
  - findNearestNode
```
public FemNode3d findNearestNode(Point3d pnt,
                                 double maxDist)
```
    Finds the nearest node to a specified point that is within a specified maximum distance. If no node is within the specified maximum distance, null is returned.
    
    Parameters:
    
    pnt - Point for which the nearest node should be located
    
    maxDist - Maximum distance that the node must be from the point. If maxDist < 0, then null will be returned.
    
    Returns:
    
    Nearest point within the prescribed distance, or null if there is no such point
  - findNearestNodes
```
public java.util.ArrayList<FemNode3d> findNearestNodes(Point3d pnt,
                                                       double maxDist)
```
    Finds and returns a list of all the nodes of an FEM that are within a specified maximum distance of a specified point. The nodes are sorted from nearest to farthest. If no node is within the maximum distance, the returned list is empty.
    
    Parameters:
    
    pnt - Point for which the nearest nodes should be located
    
    maxDist - Maximum distance that the nodes must be from the point
    
    Returns:
    
    List of the nearest points
  - addMesh
```
public FemMeshComp addMesh(MeshBase mesh)
```
  - addMesh
```
public FemMeshComp addMesh(java.lang.String name,
                           MeshBase mesh)
```
  - getMeshComp
```
public FemMeshComp getMeshComp(java.lang.String name)
```
  - getMeshComp
```
public FemMeshComp getMeshComp(int idx)
```
  - getMeshComps
```
public MeshComponentList<FemMeshComp> getMeshComps()
```
  - numMeshComps
```
public int numMeshComps()
```
  - addMeshComp
```
public void addMeshComp(FemMeshComp surf)
```
  - removeMeshComp
```
public boolean removeMeshComp(FemMeshComp surf)
```
  - clearMeshComps
```
public void clearMeshComps()
```
  - getCutPlane
```
public FemCutPlane getCutPlane(int idx)
```
  - getCutPlanes
```
public RenderableComponentList<FemCutPlane> getCutPlanes()
```
  - numCutPlanes
```
public int numCutPlanes()
```
  - addCutPlane
```
public void addCutPlane(FemCutPlane cutPlane)
```
  - removeCutPlane
```
public boolean removeCutPlane(FemCutPlane cutPlane)
```
  - clearCutPlanes
```
public void clearCutPlanes()
```
  - getField
```
public FieldComponent getField(java.lang.String name)
```
  - getFields
```
public ComponentList<FieldComponent> getFields()
```
  - numFields
```
public int numFields()
```
  - addField
```
public void addField(FieldComponent field)
```
  - removeField
```
public boolean removeField(FieldComponent field)
```
  - clearFields
```
public void clearFields()
```
  - getSurfaceVertex
```
public Vertex3d getSurfaceVertex(FemNode3d node)
```
    Returns the surface mesh vertex (if any) associated with a specified node. The mesh checked is the one returned by getSurfaceMesh().
    
    Parameters:
    
    node - node to check
    
    Returns:
    
    surface vertex associated with node, or null if no such vertex exists
  - getSurfaceNode
```
public FemNode3d getSurfaceNode(Vertex3d vtx)
```
    Returns the FEM node (if any) associated with a specified surface mesh vertex. The mesh checked is the one returned by getSurfaceMesh().
    
    Parameters:
    
    vtx - vertex to check
    
    Returns:
    
    FEM node associated with vtx, or null if no such node exists
  - isSurfaceNode
```
public boolean isSurfaceNode(FemNode3d node)
```
    Returns true if a specified node lies on the surface mesh returned by getSurfaceMesh().
    
    Parameters:
    
    node - node to check
    
    Returns:
    
    true if node lies on the surface mesh
  - isSurfaceEdge
```
public boolean isSurfaceEdge(FemNode3d node0,
                             FemNode3d node1)
```
    Returns true if a specified node pair lies along an edge of the surface mesh returned by getSurfaceMesh().
    
    Parameters:
    
    node0 - first node to check
    
    node1 - secnd node to check
    
    Returns:
    
    true if both nodes form an edge on the surface mesh
  - createSurfaceMesh
```
public FemMeshComp createSurfaceMesh(FemModel.ElementFilter efilter)
```
  - getSurfaceMeshComp
```
public FemMeshComp getSurfaceMeshComp()
```
  - getSurfaceMesh
```
public PolygonalMesh getSurfaceMesh()
```
    Description copied from interface: HasSurfaceMesh
    
    Returns the surface mesh associated with this component, or null if no mesh exists. If multiple surface meshes exist, this should be first one in the array returned by HasSurfaceMesh.getSurfaceMeshes().
    
    Specified by:
    
    getSurfaceMesh in interface HasSurfaceMesh
    
    Returns:
    
    component's (primary) surface mesh
  - numSurfaceMeshes
```
public int numSurfaceMeshes()
```
    Description copied from interface: HasSurfaceMesh
    
    Returns the number of surfaces meshes associated with this component, or 0 if no meshes exist. If HasSurfaceMesh.getSurfaceMesh() returns null, then this method should return 0.
    
    Specified by:
    
    numSurfaceMeshes in interface HasSurfaceMesh
    
    Returns:
    
    number of surface meshes associated with this component
  - getSurfaceMeshes
```
public PolygonalMesh[] getSurfaceMeshes()
```
    Description copied from interface: HasSurfaceMesh
    
    Returns an array listing all the (non-null) surface meshes associated with this component, or a zero-length array if there are none. If HasSurfaceMesh.getSurfaceMesh() returns null, then a zero-length array should be returned.
    
    Specified by:
    
    getSurfaceMeshes in interface HasSurfaceMesh
    
    Returns:
    
    surface meshes associated with this component
  - setAutoGenerateSurface
```
public void setAutoGenerateSurface(boolean val)
```
  - isAutoGeneratingSurface
```
public boolean isAutoGeneratingSurface()
```
  - isSurfaceMeshValid
```
public boolean isSurfaceMeshValid()
```
  - setSurfaceMesh
```
public FemMeshComp setSurfaceMesh(PolygonalMesh mesh)
```
  - setSurfaceMeshComp
```
public void setSurfaceMeshComp(FemMeshComp mesh)
```
  - invalidateSurfaceMesh
```
public void invalidateSurfaceMesh()
```
  - setSurfaceRendering
```
public void setSurfaceRendering(FemModel.SurfaceRender mode)
```
    Overrides:
    
    setSurfaceRendering in class FemModel
  - getCollidables
```
public void getCollidables(java.util.List<Collidable> list,
                           int level)
```
    Specified by:
    
    getCollidables in interface MechSystemModel
  - getCollidableAncestor
```
public Collidable getCollidableAncestor()
```
    Description copied from interface: Collidable
    
    Returns the most immediate Collidable ancestor of this Collidable, if any. Otherwise, return null.
    
    Specified by:
    
    getCollidableAncestor in interface Collidable
    
    Returns:
    
    immediate Collidable ancestor, or null.
  - isCompound
```
public boolean isCompound()
```
    Description copied from interface: Collidable
    
    Queries whether or not this collidable has sub-collidables.
    
    Specified by:
    
    isCompound in interface Collidable
    
    Returns:
    
    true if this collidable has sub-collidables
  - isDeformable
```
public boolean isDeformable()
```
    Description copied from interface: Collidable
    
    Returns true if this collidable is deformable. Whether or not a collidable is deformable determines how it responds to default collision behaviors involving deformable and rigid collidables. Also, self-collisions among sub-collidables of a collidable A are permitted only if A is deformable.
    
    Specified by:
    
    isDeformable in interface Collidable
    
    Specified by:
    
    isDeformable in interface ConnectableBody
    
    Returns:
    
    true if this collidable is deformable
  - transformGeometry
```
public void transformGeometry(AffineTransform3dBase X)
```
    Description copied from interface: TransformableGeometry
    Applies an affine transformation to the geometry of this component. This method should be equivalent to
```
 TransformGeometryContext.transform (this, X, 0);
 
```
    Specified by:
    
    transformGeometry in interface TransformableGeometry
    
    Parameters:
    
    X - affine transformation to apply to the component
  - transformGeometry
```
public void transformGeometry(GeometryTransformer gtr,
                              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
    
    Parameters:
    
    gtr - transformer implementing the transform
    
    context - context information, including what other components are being transformed
    
    flags - specifies conditions associated with the transformation
  - 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
    
    Parameters:
    
    context - context information, to which the dependent components are added.
    
    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 FemModel
    
    Parameters:
    
    s - scaling factor
  - scaleMass
```
public void scaleMass(double s)
```
    Description copied from interface: ScalableUnits
    
    Scales all mass units.
    
    Specified by:
    
    scaleMass in interface ScalableUnits
    
    Overrides:
    
    scaleMass in class FemModel
    
    Parameters:
    
    s - scaling factor
  - addConnector
```
public void addConnector(BodyConnector c)
```
    Specified by:
    
    addConnector in interface ConnectableBody
  - removeConnector
```
public void removeConnector(BodyConnector c)
```
    Specified by:
    
    removeConnector in interface ConnectableBody
  - containsConnector
```
public boolean containsConnector(BodyConnector c)
```
    Specified by:
    
    containsConnector in interface ConnectableBody
  - getConnectors
```
public java.util.List<BodyConnector> getConnectors()
```
    Specified by:
    
    getConnectors in interface ConnectableBody
  - transformPose
```
public void transformPose(RigidTransform3d T)
```
    Specified by:
    
    transformPose in interface ConnectableBody
  - isFreeBody
```
public boolean isFreeBody()
```
    Specified by:
    
    isFreeBody in interface ConnectableBody
  - handleComponentChanged
```
public void handleComponentChanged(ComponentChangeEvent e)
```
  - invalidateRestData
```
public void invalidateRestData()
```
    Overrides:
    
    invalidateRestData in class FemModel
  - resetRestPosition
```
public void resetRestPosition()
```
  - updateSlavePos
```
public void updateSlavePos()
```
    Description copied from interface: HasSlaveObjects
    
    Called when the system's dynamic position state changes, to update the position state of the slave objects.
    
    Specified by:
    
    updateSlavePos in interface HasSlaveObjects
    
    Overrides:
    
    updateSlavePos in class FemModel
  - invalidateElementRotationData
```
public void invalidateElementRotationData()
```
  - isAbortOnInvertedElements
```
public boolean isAbortOnInvertedElements()
```
  - setAbortOnInvertedElements
```
public void setAbortOnInvertedElements(boolean set)
```
  - setWarnOnInvertedElements
```
public void setWarnOnInvertedElements(boolean set)
```
  - isWarnOnInvertedElements
```
public boolean isWarnOnInvertedElements()
```
  - markInvertedRestElements
```
public int markInvertedRestElements()
```
  - isVolumeValid
```
public boolean isVolumeValid()
```
  - recursivelyFinalizeAdvance
```
public void recursivelyFinalizeAdvance(StepAdjustment stepAdjust,
                                       double t0,
                                       double t1,
                                       int flags,
                                       int level)
```
    Specified by:
    
    recursivelyFinalizeAdvance in interface MechSystemModel
    
    Overrides:
    
    recursivelyFinalizeAdvance in class MechSystemBase
  - recursivelyInitialize
```
public void recursivelyInitialize(double t,
                                  int level)
```
    Specified by:
    
    recursivelyInitialize in interface MechSystemModel
    
    Overrides:
    
    recursivelyInitialize in class FemModel
  - invalidateStressAndStiffness
```
public void invalidateStressAndStiffness()
```
    Overrides:
    
    invalidateStressAndStiffness in class FemModel
  - updateStress
```
public void updateStress()
```
  - updateStressAndStiffness
```
public void updateStressAndStiffness()
```
  - computeStressAndStiffness
```
public void computeStressAndStiffness(FemElement3d e,
                                      FemMaterial mat,
                                      java.util.ArrayList<FemMaterial> amats,
                                      Matrix6d D,
                                      FemModel.IncompMethod softIncomp)
```
  - getJacobianType
```
public int getJacobianType()
```
    Description copied from interface: ForceEffector
    
    Returns a code indicating the matrix type that results when the Jacobian terms of this force effector are added to the solve matrix. This should be a logical or-ing of either Matrix.SYMMETRIC or Matrix.POSITIVE_DEFINITE. The former should be set if adding the Jacobian terms preserves symmetry, and the latter should be set if positive definiteness if preserved. Both should be set if there is no Jacobian for this effector (i.e., the Jacobian methods are not implemented). Matrix types from all the force effectors are logically and-ed together to determine the type for the entire solve matrix.
    
    Specified by:
    
    getJacobianType in interface ForceEffector
    
    Overrides:
    
    getJacobianType in class FemModel
    
    Returns:
    
    solve matrix type resulting from adding Jacobian terms
  - getAugmentingMaterials
```
public java.util.ArrayList<FemMaterial> getAugmentingMaterials()
```
    Returns a list of augmenting materials which are applied to all elements, or null if there are none.
  - addSolveBlocks
```
public void addSolveBlocks(SparseNumberedBlockMatrix S)
```
    Description copied from interface: ForceEffector
    
    Adds any needed blocks to a solve matrix in order to accomodate the Jacobian terms associated with this force effector. In general, blocks will be need to be added at locations given by the block indices (bi, bj), where bi and bj correspond to the solve indices (as returned by getSolveIndex) for all dynamic or attached components affected by this force effector.
    
    Specified by:
    
    addSolveBlocks in interface ForceEffector
    
    Specified by:
    
    addSolveBlocks in class FemModel
    
    Parameters:
    
    S - solve matrix to which blocks should be added
  - addVelJacobian
```
public void addVelJacobian(SparseNumberedBlockMatrix M,
                           double s)
```
    Description copied from interface: ForceEffector
    
    Scales the components of the velocity Jacobian associated with this force effector and adds it to the supplied solve matrix M.
    M is guaranteed to be the same matrix supplied in the most recent call to addSolveBlocks, and so implementations may choose to cache the relevant matrix blocks from that call, instead of retrieving them directly from M.
    
    Specified by:
    
    addVelJacobian in interface ForceEffector
    
    Parameters:
    
    M - solve matrix to which scaled velocity Jacobian is to be added
    
    s - scaling factor for velocity Jacobian
  - addPosJacobian
```
public void addPosJacobian(SparseNumberedBlockMatrix M,
                           double s)
```
    Description copied from interface: ForceEffector
    
    Scales the components of the position Jacobian associated with this force effector and adds it to the supplied solve matrix M.
    M is guaranteed to be the same matrix supplied in the most recent call to addSolveBlocks, and so implementations may choose to cache the relevant matrix blocks from that call, instead of retrieving them directly from M.
    
    Specified by:
    
    addPosJacobian in interface ForceEffector
    
    Parameters:
    
    M - solve matrix to which scaled position Jacobian is to be added
    
    s - scaling factor for position Jacobian
  - getNodalPlotRange
```
public DoubleInterval getNodalPlotRange(FemModel.SurfaceRender rendering)
```
  - numTetElements
```
public int numTetElements()
```
  - hasTetMesh
```
public boolean hasTetMesh()
```
  - numHexElements
```
public int numHexElements()
```
  - hasHexMesh
```
public boolean hasHexMesh()
```
  - numQuadraticElements
```
public int numQuadraticElements()
```
  - getTetAspectRatios
```
public java.util.ArrayList<Element3dValuePair> getTetAspectRatios()
```
    Returns a list of element-value pairs describing the aspect ratios of all the tet elements in this model. Thie is sorted into descending order, so that the lowest quality elements appear at the beginning.
  - getElementRestVolumes
```
public java.util.ArrayList<Element3dValuePair> getElementRestVolumes()
```
    Returns a list of element-value pairs describing the rest volumes of all the volumetric elements in this model. Thie is sorted into ascending order, so that the smallest elements appear at the beginning.
  - clearElementConditionInfo
```
public void clearElementConditionInfo()
```
  - checkElementCondition
```
public boolean checkElementCondition(FemElement3dBase e,
                                     double detJ,
                                     boolean recordInversion)
```
  - createPointAttachment
```
public PointAttachment createPointAttachment(Point pnt)
```
    Description copied from interface: PointAttachable
    
    Returns a PointAttachment that attaches pnt to this component. It should not be assumed that pnt is currently connected to the component hierarchy, and no attempt should be made to connect the returned attachment to the hierarchy; the latter, if desired, is the responsibility of the caller.
    In some cases, it may not be possible to attach the point at its present location. In that case, the method will create an attachment to the nearest feasible location.
    
    Specified by:
    
    createPointAttachment in interface PointAttachable
    
    Parameters:
    
    pnt - point for which an attachment should be created
    
    Returns:
    
    attachment connecting pnt to this component
  - createPointAttachment
```
public PointAttachment createPointAttachment(Point pnt,
                                             double reduceTol)
```
  - createFrameAttachment
```
public FrameFem3dAttachment createFrameAttachment(Frame frame,
                                                  RigidTransform3d TFW)
```
    Returns a FrameAttachment that attaches a frame to this component. Once attached the frame will follow the body around. The initial pose of the frame is specified by TFW, which gives its position and orientation in world coordinates. If TFW is null, then the current pose of the frame is used. If frame is null, then a virtual attachment is created at the initial pose specified by TFW. frame and TFW cannot both be null.
    In some cases, it may not be possible to attach the frame at the requested location. In that case, the method will relocate the frame to the nearest feasible attachment location.
    
    Specified by:
    
    createFrameAttachment in interface FrameAttachable
    
    Parameters:
    
    frame - frame to be attached
    
    TFW - transform from (initial) frame coordinates to world coordinates
    
    Returns:
    
    attachment connecting frame to this component
  - createFrameAttachment
```
public FrameFem3dAttachment createFrameAttachment(Frame frame,
                                                  RigidTransform3d TFW,
                                                  boolean project)
```
    Returns a FrameAttachment that attaches a frame to this component. Once attached the frame will follow the body around. The initial pose of the frame is specified by TFW, which gives its position and orientation in world coordinates. If TFW is null, then the current pose of the frame is used. If frame is null, then a virtual attachment is created at the initial pose specified by TFW. frame and TFW cannot both be null.
    
    Parameters:
    
    frame - frame to be attached
    
    TFW - transform from (initial) frame coordinates to world coordinates
    
    project - if true and if the frame is outside the FEM, then the frame gets projected to the nearest point on the FEM
    
    Returns:
    
    attachment attaching frame to this component
  - subdivideHexs
```
public void subdivideHexs(java.util.List<HexElement> hexs)
```
  - subdivideHex
```
public void subdivideHex(HexElement hex)
```
  - updateConstraints
```
public double updateConstraints(double t,
                                int flags)
```
    Description copied from interface: Constrainer
    
    Updates the current set of constraints, and returns the maximum penetration > 0 associated with all of them. If no constraints are presently active, returns -1.
    
    Specified by:
    
    updateConstraints in interface Constrainer
    
    Overrides:
    
    updateConstraints in class FemModel
  - getConstrainedComponents
```
public void getConstrainedComponents(java.util.List<DynamicComponent> list)
```
    Description copied from interface: Constrainer
    
    Collected all the dynamic components constrained by this constrainer. Not currently used.
    
    Specified by:
    
    getConstrainedComponents in interface Constrainer
    
    Overrides:
    
    getConstrainedComponents in class FemModel
    
    Parameters:
    
    list - list to which constrained components should be appended
  - setIncompForces
```
public int setIncompForces(double[] lbuf,
                           double s,
                           int idx)
```
  - setBilateralForces
```
public int setBilateralForces(VectorNd lam,
                              double s,
                              int idx)
```
    Description copied from interface: Constrainer
    
    Sets the bilateral forces that were computed to enforce this constraint. These are the Lagrange multipliers for the columns of the transposed bilateral constraint matrix. The forces are supplied in lam, starting at the index idx, and should be scaled by s. (In practice, s is used to convert from impulses to forces.) The method must return an updated value of idx, incremented by the number of forces associated with this constraint.
    
    Specified by:
    
    setBilateralForces in interface Constrainer
    
    Overrides:
    
    setBilateralForces in class FemModel
    
    Parameters:
    
    lam - supplies the force impulses, which should be scaled by s
    
    s - scaling factor for the force values
    
    idx - starting index of forces in lam
    
    Returns:
    
    updated value of idx
  - zeroForces
```
public void zeroForces()
```
    Description copied from interface: Constrainer
    
    Zeros all bilateral and unilateral constraint forces in this constraint.
    
    Specified by:
    
    zeroForces in interface Constrainer
    
    Overrides:
    
    zeroForces in class FemModel
  - getIncompForces
```
public int getIncompForces(double[] lbuf,
                           int idx)
```
  - getBilateralForces
```
public int getBilateralForces(VectorNd lam,
                              int idx)
```
    Description copied from interface: Constrainer
    
    Returns the bilateral forces that were most recently set for this constrainer using Constrainer.setBilateralForces(maspack.matrix.VectorNd, double, int). The forces are returned in lam, starting at the index idx. The method must return an updated value of idx, incremented by the number of forces associated with this constraint.
    
    Specified by:
    
    getBilateralForces in interface Constrainer
    
    Overrides:
    
    getBilateralForces in class FemModel
    
    Parameters:
    
    lam - returns the forces
    
    idx - starting index for forces in lam
    
    Returns:
    
    updated value of idx
  - getBilateralSizes
```
public void getBilateralSizes(VectorNi sizes)
```
    Description copied from interface: Constrainer
    
    Returns the sizes of each block column in the bilateral force constraint matrix. The size for each block should be appended to the vector sizes.
    
    Specified by:
    
    getBilateralSizes in interface Constrainer
    
    Overrides:
    
    getBilateralSizes in class FemModel
    
    Parameters:
    
    sizes - vector to which the block column sizes are appended
  - addBilateralConstraints
```
public int addBilateralConstraints(SparseBlockMatrix GT,
                                   VectorNd dg,
                                   int numb)
```
    Description copied from interface: Constrainer
    Appends the current bilateral force constraint matrix Gc^T to the matrix GT, by appending block columns to it. If the argument dg is non-null, it should be used to return the velocity constraint time derivative, defined by
```
 \dot Gc vel
 
```
    starting at the location numb. In all cases, the method must return an updated value of numb, incremented by the total row size of Gc.
    Specified by:
    
    addBilateralConstraints in interface Constrainer
    
    Overrides:
    
    addBilateralConstraints in class FemModel
    
    Parameters:
    
    GT - matrix to which the bilateral force contraint matrix is appended.
    
    dg - if non-null, returns the velocity constraint time derivative
    
    numb - starting index for time derivative in dg
    
    Returns:
    
    updated value of numb
  - getBilateralInfo
```
public int getBilateralInfo(MechSystem.ConstraintInfo[] ginfo,
                            int idx)
```
    Description copied from interface: Constrainer
    Returns constraint information for each row of the bilateral constraint system
```
 Gc vel = 0.
 
```
    This information is placed in pre-allocated MechSystem.ConstraintInfo structures in ginfo, starting at idx. The method must return an updated value of idx, incremented by the number of rows of Gc.
    The constraint information to be set in ConstraintInfo includes:
```
   dist        // distance to the constraint surface.
   compliance  // if > 0, gives constraint compliance value
   damping     // damping; only used if compliance > 0
   force       // used for computing non-linear compliance
 
```
    Specified by:
    
    getBilateralInfo in interface Constrainer
    
    Overrides:
    
    getBilateralInfo in class FemModel
    
    Parameters:
    
    ginfo - returns the constraint information
    
    idx - starting location in ginfo for returning constraint info
    
    Returns:
    
    updated value of idx
  - getAuxStateComponents
```
public void getAuxStateComponents(java.util.List<HasNumericState> comps,
                                  int level)
```
    Specified by:
    
    getAuxStateComponents in interface MechSystemModel
  - 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 HasNumericState
    
    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 HasNumericState
    
    Parameters:
    
    data - buffer containing the state information
  - getSelection
```
public void getSelection(java.util.LinkedList<java.lang.Object> list,
                         int qid)
```
    Description copied from interface: IsSelectable
    
    Append to list the component (or components) associated with the qid-th selection query issued by this component's render method. This will only be called if this component manages its own selection (i.e., the number nums returned by IsSelectable.numSelectionQueriesNeeded() is positive), and qid will in turn be a number between 0 and nums-1.
    
    Specified by:
    
    getSelection in interface IsSelectable
    
    Overrides:
    
    getSelection in class RenderableModelBase
    
    Parameters:
    
    list - selected objects are appended to the end of this list
    
    qid - index of the selection query
  - 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 RenderableModelBase
    
    Parameters:
    
    list - list of objects to be rendered
  - render
```
public void render(Renderer renderer,
                   int flags)
```
    Description copied from interface: IsRenderable
    
    Render this object using the functionality of the supplied Renderer.
    
    Specified by:
    
    render in interface IsRenderable
    
    Overrides:
    
    render in class FemModel
    
    Parameters:
    
    renderer - provides the functionality used to perform the rendering.
    
    flags - flags that may be used to control different aspects of the rendering. Flags are defined in Renderer and currently include Renderer.HIGHLIGHT and Renderer.SORT_FACES.
  - updateBounds
```
public void updateBounds(Vector3d pmin,
                         Vector3d pmax)
```
    Description copied from interface: IsRenderable
    
    Update the minimum and maximum points for this object. In an x-y-z coordinate system with x directed to the right and y directed upwards, the minimum and maximum points can be thought of as defining the left-lower-far and right-upper-near corners of a bounding cube. This method should only reduce the elements of the minimum point and increase the elements of the maximum point, since it may be used as part of an iteration to determine the bounding cube for several different objects.
    
    Specified by:
    
    updateBounds in interface IsRenderable
    
    Overrides:
    
    updateBounds in class FemModel
    
    Parameters:
    
    pmin - minimum point
    
    pmax - maximum point
  - scan
```
public void scan(ReaderTokenizer rtok,
                 java.lang.Object ref)
          throws java.io.IOException
```
    Description copied from class: ModelComponentBase
    
    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 ComponentList<ModelComponent>
    
    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 interface: PostScannable
    
    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 ComponentList<ModelComponent>
    
    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)
  - writeSurfaceMesh
```
public boolean writeSurfaceMesh(java.io.PrintWriter pw)
```
  - writeSurfaceMesh
```
public void writeSurfaceMesh(java.lang.String fileName)
```
  - scanSurfaceMesh
```
public FemMeshComp scanSurfaceMesh(ReaderTokenizer rtok)
                            throws java.io.IOException
```
    Throws:
    
    java.io.IOException
  - scanSurfaceMesh
```
public FemMeshComp scanSurfaceMesh(java.lang.String fileName)
                            throws java.io.IOException
```
    Throws:
    
    java.io.IOException
  - scanMesh
```
public FemMeshComp scanMesh(ReaderTokenizer rtok)
                     throws java.io.IOException
```
    Throws:
    
    java.io.IOException
  - scanMesh
```
public FemMeshComp scanMesh(java.lang.String fileName)
                     throws java.io.IOException
```
    Throws:
    
    java.io.IOException
  - isDuplicatable
```
public boolean isDuplicatable()
```
    Returns true if this component can be duplicated. Duplication means that we can expect to be able to make a complete copy of the component along with all it's external references. This method should return true if and only if CopyableComponent.getCopyReferences(java.util.List<artisynth.core.modelbase.ModelComponent>, artisynth.core.modelbase.ModelComponent) returns true.
    This method is not currently used. It is intended to provide a faster way of determining if a component can be duplicated, without having to use CopyableComponent.getCopyReferences(java.util.List<artisynth.core.modelbase.ModelComponent>, artisynth.core.modelbase.ModelComponent) to build the list of copy references.
    
    Specified by:
    
    isDuplicatable in interface CopyableComponent
    
    Returns:
    
    true if this component can be duplicated.
  - getCopyReferences
```
public boolean getCopyReferences(java.util.List<ModelComponent> refs,
                                 ModelComponent ancestor)
```
    Description copied from interface: CopyableComponent
    
    Collects external references which must also be copied in order to duplicate this component. These references should exclude those which are contained within a specified component hierarchy. This method should return true if and only if CopyableComponent.isDuplicatable() returns true.
    
    Specified by:
    
    getCopyReferences in interface CopyableComponent
    
    Parameters:
    
    refs - list to which references are appended
    
    ancestor - root node of the hierarchy from which references are to be excluded
    
    Returns:
    
    false if it is discovered that the component cannot be duplicated
  - copy
```
public FemModel3d 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 FemModel
    
    Parameters:
    
    flags - flags to control the copying
    
    copyMap - map to possible existing instances of referenced components
    
    Returns:
    
    copy of this component
  - printANSYSNodes
```
public void printANSYSNodes(java.io.PrintWriter pw)
```
    Prints the nodes of this FEM in a format which is compatible with ANSYS.
    
    Parameters:
    
    pw - PrintWriter to which nodes are written
  - printANSYSElements
```
public void printANSYSElements(java.io.PrintWriter pw)
```
    Prints the elements of this FEM in a format which is compatible with ANSYS.
    
    Parameters:
    
    pw - PrintWriter to which elements are written
  - setOneBasedNodeElementNumbering
```
public void setOneBasedNodeElementNumbering(boolean oneBased)
```
    Sets the numbering for the nodes, elements and shell elements in this FEM to be one-based (as opposed to the default numbering, which is zero-based). Numbering for other component lists is unchanged. This method is intended to help make the node and element numbering compatible with FEM systems, such as Abaqus and ANSYS, that use one-based numbering.
    This method is mainly intended to be used for testing and debugging. When one-based numbering is enabled, the numbers of any existing nodes and elements are incremented by one. Likewise, when numbering is disabled, the numbers of existing nodes and elements are decremented incremented by one. To avoid number-related inconsistencies with other components, such as fields, is it recommended that this method be called when the FEM is first created, and before it is used within an Ansys or Abaqus reader.
    
    Parameters:
    
    oneBased - enables (or diables) one-based numbering for this FEM
  - getOneBasedNodeElementNumbering
```
public boolean getOneBasedNodeElementNumbering()
```
    Queries whether the numbering for the nodes, elements and shell elements in this FEM is one-based. See setOneBasedNodeElementNumbering(boolean) for details.
    
    Returns:
    
    true if node and element numbering is one-based.
  - getFrame
```
public FemModelFrame getFrame()
```
  - usingAttachedRelativeFrame
```
public boolean usingAttachedRelativeFrame()
```
  - getFrameConstraint
```
public FrameFem3dConstraint getFrameConstraint()
```
  - attachFrame
```
public void attachFrame(RigidTransform3d TRW)
```
  - getDynamicComponents
```
public void getDynamicComponents(java.util.List<DynamicComponent> active,
                                 java.util.List<DynamicComponent> attached,
                                 java.util.List<DynamicComponent> parametric)
```
    Specified by:
    
    getDynamicComponents in interface MechSystemModel
    
    Overrides:
    
    getDynamicComponents in class FemModel
  - getDynamicComponents
```
public void getDynamicComponents(java.util.List<DynamicComponent> comps)
```
    Specified by:
    
    getDynamicComponents in interface MechSystemModel
    
    Overrides:
    
    getDynamicComponents in class FemModel
  - addGeneralMassBlocks
```
public void addGeneralMassBlocks(SparseNumberedBlockMatrix M)
```
    Specified by:
    
    addGeneralMassBlocks in interface MechSystemModel
    
    Overrides:
    
    addGeneralMassBlocks in class MechSystemBase
  - getMassMatrixValues
```
public void getMassMatrixValues(SparseNumberedBlockMatrix M,
                                VectorNd f,
                                double t)
```
    Specified by:
    
    getMassMatrixValues in interface MechSystemModel
  - mulInverseMass
```
public void mulInverseMass(SparseBlockMatrix M,
                           VectorNd a,
                           VectorNd f)
```
    Specified by:
    
    mulInverseMass in interface MechSystem
    
    Specified by:
    
    mulInverseMass in interface MechSystemModel
  - getAttachments
```
public void getAttachments(java.util.List<DynamicAttachment> list,
                           int level)
```
    Specified by:
    
    getAttachments in interface MechSystemModel
    
    Overrides:
    
    getAttachments in class FemModel
  - dispose
```
public void dispose()
```
    Description copied from class: ModelBase
    
    Called when the model is discarded. Disposes of any resources used.
    
    Specified by:
    
    dispose in interface Model
    
    Specified by:
    
    dispose in interface Disposable
    
    Overrides:
    
    dispose in class ModelBase
  - getBVTree
```
public BVTree getBVTree()
```
    Return BV tree for those who know what to do with it

Class FemModel3d

Nested Class Summary

Nested classes/interfaces inherited from class artisynth.core.femmodels.FemModel

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

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

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

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

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

Field Summary

Fields inherited from class artisynth.core.mechmodels.MechSystemBase

Fields inherited from class artisynth.core.modelbase.ModelBase

Fields inherited from class artisynth.core.modelbase.ComponentList

Fields inherited from class artisynth.core.modelbase.ModelComponentBase

Fields inherited from interface artisynth.core.modelbase.TransformableGeometry

Fields inherited from interface artisynth.core.mechmodels.Collidable

Fields inherited from interface artisynth.core.modelbase.CopyableComponent

Fields inherited from interface artisynth.core.modelbase.Model

Fields inherited from interface artisynth.core.mechmodels.MechSystem

Fields inherited from interface maspack.render.IsRenderable

Constructor Summary

Method Summary

Methods inherited from class artisynth.core.femmodels.FemModel

Methods inherited from class artisynth.core.mechmodels.MechSystemBase

Methods inherited from class artisynth.core.modelbase.RenderableModelBase

Methods inherited from class artisynth.core.modelbase.ModelBase

Methods inherited from class artisynth.core.modelbase.ComponentList

Methods inherited from class artisynth.core.modelbase.ModelComponentBase

Methods inherited from class java.lang.Object

Methods inherited from interface artisynth.core.modelbase.HasNumericState

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 maspack.util.Scannable

Methods inherited from interface artisynth.core.modelbase.Model

Methods inherited from interface artisynth.core.modelbase.ComponentListView

Methods inherited from interface java.util.Collection

Methods inherited from interface java.lang.Iterable

Field Detail

useFrameRelativeCouplingMasses

DEFAULT_ABORT_ON_INVERTED_ELEMENTS

abortOnInvertedElems

checkTangentStability

noIncompressStiffnessDamping

useNodalMassWeights

detJStepReductionLimit

frameMassFraction

DEFAULT_HARD_INCOMP

DEFAULT_SOFT_INCOMP

myProps

defaultAutoGenerateSurface

DEFAULT_SURFACEMESH_NAME

debugx

Constructor Detail

FemModel3d

FemModel3d

Method Detail

getAllPropertyInfo

getAxisLength

setAxisLength

isFrameRelative

setFrameRelative

setElementWidgetSize

getElementWidgetSize

setElementWidgetSizeMode

getElementWidgetSizeMode

getIncompressible

getHardIncompMethod

setIncompressible

getIncompressibleRange

setSoftIncompMethod

getSoftIncompMethod

getSoftIncompMethodRange

getIncompCompliance

setIncompCompliance

createDefaultColorMap

getColorMap

setColorMap

getColorMapMode

setColorMapMode

getDirectorRenderLen