artisynth.core.femmodels

Class FemNode3d

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, DynamicComponent, ForceEffector, MotionTargetComponent, PointAttachable, CopyableComponent, ModelComponent, RenderableComponent, Traceable, TransformableGeometry, ScalableUnits, java.lang.Cloneable, HasProperties, HierarchyNode, HasRenderProps, IsRenderable, IsSelectable, Renderable, Scannable

Direct Known Subclasses:

MFreeNode3d

public class FemNode3d
extends FemNode

Nested Class Summary

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

ModelComponent.NavpanelVisibility

Field Summary

Fields

Modifier and Type	Field and Description
static PropertyList	myProps

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

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)

Method Summary

Modifier and Type	Method and Description
void	addElementDependency(FemElement3d e)
FemNodeNeighbor	addIndirectNeighbor(FemNode3d nbrNode)
void	addScaledStrain(double s, SymmetricMatrix3d sig)
void	addScaledStress(double s, SymmetricMatrix3d sig)
void	clearIndirectNeighbors()
double	computeMassFromDensity()
void	connectToHierarchy() Called by the system after this component is added to the component hierarchy (i.e., when it is 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)
void	disconnectFromHierarchy() Called by the system after this component is removed from the component hierarchy (i.e., when it is removed as a child of its parent).
PropertyList	getAllPropertyInfo() Returns a list giving static information about all properties exported by this object.
Vector3d	getDisplacement()
java.util.LinkedList<FemElement3d>	getElementDependencies()
int	getIncompressIndex()
int	getIndex()
FemNodeNeighbor	getIndirectNeighbor(FemNode3d node)
FemNodeNeighbor	getIndirectNeighborBySolveIndex(int idx)
java.util.LinkedList<FemNodeNeighbor>	getIndirectNeighbors() Indirect neighbors are the neighbors-of-neighbors.
Vector3d	getInternalForce()
Point3d	getLocalRestPosition()
FemNodeNeighbor	getNodeNeighbor(FemNode3d node)
FemNodeNeighbor	getNodeNeighborBySolveIndex(int idx)
java.util.LinkedList<FemNodeNeighbor>	getNodeNeighbors()
Point3d	getRestPosition()
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.
int	numAdjacentElements()
void	removeElementDependency(FemElement3d e)
void	resetRestPosition()
void	scaleDistance(double s) Scales all distance coordinates.
boolean	scanItem(ReaderTokenizer rtok, java.util.Deque<ScanToken> tokens)
void	setFrame(Frame frame)
void	setIncompressIndex(int idx)
void	setIndex(int idx)
void	setRestPosition(Point3d pos)
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	zeroStrain()
void	zeroStress()

Methods inherited from class artisynth.core.femmodels.FemNode

addMass, clearMass, getMass, invalidateMassIfNecessary, isMassExplicit, scaleMass, setMass, setMassExplicit

Methods inherited from class artisynth.core.mechmodels.Particle

addEffectiveMass, applyGravity, applyPosImpulse, createPointAttachment, getConstraint, getCopyReferences, getEffectiveMass, getEffectiveMass, getInverseMass, getMass, getMass, getVelDerivative, isDuplicatable, mulInverseEffectiveMass, resetEffectiveMass, setConstraint, setDynamic

Methods inherited from class artisynth.core.mechmodels.Point

addExternalForce, addForce, addLocalForce, addPosImpulse, addPosJacobian, addScaledExternalForce, addScaledForce, addScaledLocalForce, addSolveBlock, addSolveBlocks, addTargetJacobian, addToPointVelocity, addToSolveBlockDiagonal, addTransformableDependencies, addVelJacobian, applyExternalForces, applyForces, createMassBlock, createRenderProps, createSolveBlock, distance, distance, getEffectiveMassForces, getExternalForce, getForce, getForce, getJacobianType, getLocalPosition, getLocalPosition, getLocalVelocity, getLocalVelocity, getPointDamping, getPointDampingMode, getPointFrame, getPosDerivative, getPosition, getPosition, getPosState, getPosStateSize, getRenderCoords, getRenderProps, getSelection, getState, getTargetActivity, getTargetPos, getTargetPosition, getTargetVel, getTargetVelocity, getTraceablePositionProperty, getTraceables, getVelocity, getVelocity, getVelState, getVelStateSize, isMassConstant, isSelectable, prerender, render, resetTargets, setContactConstraint, setExternalForce, setForce, setForce, setLocalPosition, setLocalPosition, setLocalVelocity, setLocalVelocity, setPointDamping, setPointDampingMode, setPointFrame, setPosition, setPosition, setPosState, setRenderProps, setScaledExternalForce, setState, setState, setTargetActivity, setTargetPos, setTargetPosition, setTargetVel, setTargetVelocity, setVelocity, setVelocity, setVelState, subForce, subLocalForce, updateBounds, updatePosState, updateVelState, velocityLimitExceeded, zeroExternalForces, zeroForces

Methods inherited from class artisynth.core.mechmodels.DynamicComponentBase

addConstrainer, addMasterAttachment, getAttachment, getConstrainers, getMasterAttachments, getSolveIndex, hasState, isActive, isAttached, isControllable, isDynamic, isParametric, removeConstrainer, removeMasterAttachment, setAttached, setSolveIndex, transformGeometry

Methods inherited from class artisynth.core.modelbase.RenderableComponentBase

getRenderHints, numSelectionQueriesNeeded, 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, isConnectedToHierarchy, isFixed, isMarked, isSelected, isWritable, makeValidName, makeValidName, notifyParentOfChange, postscan, printReferences, recursivelyContained, recursivelyContains, removeTempFlag, scan, setFixed, setFlag, setMarked, setName, setNavpanelVisibility, setNavpanelVisibility, setNumber, setParent, setSelected, updateReferences, write

Methods inherited from class java.lang.Object

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

Methods inherited from interface artisynth.core.modelbase.ModelComponent

getHardReferences, getName, getNavpanelVisibility, getNumber, getParent, getSoftReferences, hasState, isFixed, isMarked, isSelected, notifyParentOfChange, postscan, scan, setFixed, setMarked, setName, setNumber, setParent, setSelected, 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.mechmodels.DynamicComponent

addConstrainer, addMasterAttachment, checkFlag, clearFlag, getAttachment, getConstrainers, getMasterAttachments, getSolveIndex, isActive, isAttached, isControllable, isDynamic, isParametric, removeConstrainer, removeMasterAttachment, setAttached, setFlag, setSolveIndex

Methods inherited from interface artisynth.core.modelbase.TransformableGeometry

transformGeometry

Field Detail

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

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 computed from the average nodal stress, which is in turn computed only when computeNodeStresses is enabled for the FEM model containing this node.

Returns:

van Mises stress

getDisplacement

public Vector3d getDisplacement()

getTargetDisplacement

public Vector3d getTargetDisplacement()

setTargetDisplacement

public void setTargetDisplacement(Vector3d del)

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 only when computeNodeStresses is enabled for the FEM model containing this node.

Returns:

average nodal stress (should not be modified)

setStress

public void setStress(double vms)

zeroStress

public void zeroStress()

addScaledStress

public void addScaledStress(double s,
                            SymmetricMatrix3d sig)

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 computed from the average nodal strain, which is in turn computed only when computeNodeStrain is enabled for the FEM model containing this node.

Returns:

von Mises strain

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 only when computeNodeStrain is enabled for the FEM model containing this node.

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)

getInternalForce

public Vector3d getInternalForce()

getNodeNeighbors

public java.util.LinkedList<FemNodeNeighbor> getNodeNeighbors()

getNodeNeighborBySolveIndex

public FemNodeNeighbor getNodeNeighborBySolveIndex(int idx)

getNodeNeighbor

public FemNodeNeighbor getNodeNeighbor(FemNode3d node)

getIndirectNeighbors

public java.util.LinkedList<FemNodeNeighbor> getIndirectNeighbors()

Indirect neighbors are the neighbors-of-neighbors. We need to keep track of them in the special situation where we are computing soft nodal-based incompressibility. That's because in soft nodal-based incompressibility, all the nodes for all the elements connected to a node form a single force-producing - essentially a "super-element", in that a change in any nodes position affects the soft-nodal-incompressible force on all of the nodes. Hence when computing overall forces and stiffness matrices, each node has a larger set of nodes that influence it.

getIndirectNeighborBySolveIndex

public FemNodeNeighbor getIndirectNeighborBySolveIndex(int idx)

getIndirectNeighbor

public FemNodeNeighbor getIndirectNeighbor(FemNode3d node)

clearIndirectNeighbors

public void clearIndirectNeighbors()

addIndirectNeighbor

public FemNodeNeighbor addIndirectNeighbor(FemNode3d nbrNode)

deregisterNodeNeighbor

public void deregisterNodeNeighbor(FemNode3d nbrNode)

scanItem

public boolean scanItem(ReaderTokenizer rtok,
                        java.util.Deque<ScanToken> tokens)
                 throws java.io.IOException

Overrides:

scanItem in class FemNode

Throws:

java.io.IOException

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(FemElement3d e)

removeElementDependency

public void removeElementDependency(FemElement3d e)

getElementDependencies

public java.util.LinkedList<FemElement3d> getElementDependencies()

numAdjacentElements

public int numAdjacentElements()

computeMassFromDensity

public double computeMassFromDensity()

Specified by:

computeMassFromDensity in class FemNode

connectToHierarchy

public void connectToHierarchy()

Description copied from class: ModelComponentBase

Called by the system after this component is added to the component hierarchy (i.e., when it is added as a child of another CompositeComponent). This method is responsible for doing any required hierarchy-dependent initialization.

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 ModelComponentBase

disconnectFromHierarchy

public void disconnectFromHierarchy()

Description copied from class: ModelComponentBase

Called by the system after this component is removed from the component hierarchy (i.e., when it is removed as a child of its parent). This method is responsible for any required hierarchy-dependent deinitialization.

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 ModelComponentBase

setFrame

public void setFrame(Frame frame)

resetRestPosition

public void resetRestPosition()

getRestPosition

public Point3d getRestPosition()

getLocalRestPosition

public Point3d getLocalRestPosition()

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