artisynth.core.femmodels

Class FemCutPlane

java.lang.Object

artisynth.core.modelbase.ModelComponentBase

artisynth.core.modelbase.RenderableComponentBase

artisynth.core.mechmodels.DynamicComponentBase

artisynth.core.mechmodels.Frame

artisynth.core.femmodels.FemCutPlane

All Implemented Interfaces:

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

public class FemCutPlane
extends Frame
implements FemMesh

Class to allow visualization of stress or strain values within a planar slice of an FEM.

Nested Class Summary

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

ModelComponent.FilePathSaveType, ModelComponent.NavpanelVisibility

Field Summary

Fields

Modifier and Type	Field and Description
static Renderer.ColorInterpolation	DEFAULT_COLOR_INTERPOLATION
static PropertyList	myProps

Fields inherited from class artisynth.core.mechmodels.Frame

dynamicVelInWorldCoords, myRenderFrame

Fields inherited from class artisynth.core.modelbase.ModelComponentBase

enforceUniqueCompositeNames, enforceUniqueNames, myNumber, NULL_OBJ, useCompactPathNames

Fields inherited from interface maspack.render.IsRenderable

TRANSPARENT, TWO_DIMENSIONAL

Fields inherited from interface artisynth.core.modelbase.CopyableComponent

COPY_REFERENCES, REST_POSITION

Fields inherited from interface artisynth.core.modelbase.TransformableGeometry

TG_ARTICULATED, TG_DRAGGER, TG_PRESERVE_ORIENTATION, TG_SIMULATING

Constructor Summary

Constructors

Constructor and Description
FemCutPlane()
FemCutPlane(double res)
FemCutPlane(double res, RigidTransform3d TPW)
FemCutPlane(RigidTransform3d TPW)

Method Summary

Modifier and Type	Method and Description
FemCutPlane	copy(int flags, java.util.Map<ModelComponent,ModelComponent> copyMap) Create a copy of this component.
RenderProps	createRenderProps() Factory method to create render properties appropriate to this object.
PropertyList	getAllPropertyInfo() Returns a list giving static information about all properties exported by this object.
Renderer.ColorInterpolation	getColorInterpolation()
ColorMapBase	getColorMap()
PropertyMode	getColorMapMode()
double	getCurrentResolution() Returns the currently computed grid resolution for the display.
FemModel3d	getFem()
boolean	getHighlightColoredMesh()
PolygonalMesh	getMesh()
double	getResolution() Gets the grid resolution of the display, in units of distance.
double	getSquareSize() Gets the size of the square.
DoubleInterval	getStressPlotRange()
PropertyMode	getStressPlotRangeMode()
FemModel.Ranging	getStressPlotRanging()
PropertyMode	getStressPlotRangingMode()
FemModel.SurfaceRender	getSurfaceRendering()
PropertyMode	getSurfaceRenderingMode()
void	invalidateMesh()
boolean	isMeshPolygonal()
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	render(Renderer renderer, int flags) Render this object using the functionality of the supplied Renderer.
void	resetAutoStressPlotRange()
void	setColorInterpolation(Renderer.ColorInterpolation interp)
void	setColorMap(ColorMapBase map)
void	setColorMapMode(PropertyMode mode)
void	setHighlightColoredMesh(boolean enable)
void	setResolution(double res) Sets the grid resolution of the display, in units of distance.
void	setSquareSize(double size) Sets the size of the square.
void	setStressPlotRange(DoubleInterval range)
void	setStressPlotRangeMode(PropertyMode mode)
void	setStressPlotRanging(FemModel.Ranging ranging)
void	setStressPlotRangingMode(PropertyMode mode)
void	setSurfaceRendering(FemModel.SurfaceRender rendering)
void	setSurfaceRenderingMode(PropertyMode mode)
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	updateBounds(Vector3d pmin, Vector3d pmax) Update the minimum and maximum points for this object.

Methods inherited from class artisynth.core.mechmodels.Frame

add1DConstraintBlocks, add2DConstraintBlocks, addEffectiveFrameMass, addEffectivePointMass, addExternalForce, addForce, addForce, addFrameForce, addPointForce, addPointForce, addPosImpulse, addPosJacobian, addRelativeVelocity, addScaledExternalForce, addSolveBlock, addSolveBlocks, addTargetJacobian, addToPointVelocity, addTransformableDependencies, addVelJacobian, applyExternalForces, applyForces, applyGravity, collectMasterComponents, computeAppliedWrench, computeForceOnMasters, computeFrameLocation, computeFramePosition, computeFramePosVel, computeFrameVelocity, computePointCoriolis, computePointLocation, computePointPosition, computePointPosVel, computePointVelocity, createFrameAttachment, createMassBlock, createPointAttachment, getAxisDrawStyle, getAxisLength, getBodyForce, getBodyVelocity, getBodyVelState, getCopyReferences, getEffectiveMass, getEffectiveMass, getEffectiveMassForces, getExternalForce, getForce, getForce, getForce, getFrameDamping, getFrameDampingMode, getFrameMarkers, getJacobianType, getMass, getMass, getMoment, getOrientation, getOrientation, getPosDerivative, getPose, getPose, getPosition, getPosState, getPosStateSize, getRenderFrame, getRotaryDamping, getRotaryDampingMode, getRotation, getSelection, getState, getTargetActivity, getTargetOrientation, getTargetPos, getTargetPose, getTargetPosition, getTargetVel, getTargetVelocity, getTraceablePositionProperty, getTraceables, getTransForce, getVelocity, getVelocity, getVelState, getVelStateSize, getWorldVelState, hasForce, isDuplicatable, isMassConstant, mulInverseEffectiveMass, resetEffectiveMass, resetTargets, scaleDistance, scaleMass, setAxisDrawStyle, setAxisLength, setBodyVelocity, setContactConstraint, setExternalForce, setForce, setForce, setFrameDamping, setFrameDampingMode, setOrientation, setPose, setPosition, setPosState, setRandomForce, setRandomPosState, setRandomVelState, setRotaryDamping, setRotaryDampingMode, setRotation, setState, setState, setTargetActivity, setTargetOrientation, setTargetPos, setTargetPose, setTargetPosition, setTargetVel, setTargetVelocity, setVelocity, setVelocity, setVelState, transformPose, updateAttachmentPosStates, velocityLimitExceeded, zeroExternalForces, zeroForces

Methods inherited from class artisynth.core.mechmodels.DynamicComponentBase

addAttachmentRequest, addConstrainer, addMasterAttachment, connectToHierarchy, disconnectFromHierarchy, getAttachment, getConstrainers, getInverseMass, getMasterAttachments, getSolveIndex, hasState, isActive, isAttached, isControllable, isDynamic, isParametric, removeAttachmentRequest, removeConstrainer, removeMasterAttachment, setAttached, setSolveIndex, transformGeometry

Methods inherited from class artisynth.core.modelbase.RenderableComponentBase

defaultRenderPropsAreNull, getRenderHints, getRenderProps, isSelectable, isVisible, numSelectionQueriesNeeded, setRenderProps, setVisible, updateRenderProps

Methods inherited from class artisynth.core.modelbase.ModelComponentBase

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

Methods inherited from class java.lang.Object

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

Methods inherited from interface artisynth.core.modelbase.ModelComponent

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

Methods inherited from interface maspack.properties.HasProperties

getProperty

Methods inherited from interface maspack.properties.HierarchyNode

getChildren, hasChildren

Methods inherited from interface artisynth.core.modelbase.PostScannable

postscan

Methods inherited from interface maspack.util.Scannable

isWritable, write

Methods inherited from interface maspack.render.IsSelectable

getSelection, isSelectable, numSelectionQueriesNeeded

Methods inherited from interface maspack.render.IsRenderable

getRenderHints

Methods inherited from interface maspack.render.HasRenderProps

getRenderProps, setRenderProps

Methods inherited from interface artisynth.core.mechmodels.DynamicComponent

addAttachmentRequest, removeAttachmentRequest

Methods inherited from interface artisynth.core.mechmodels.DynamicAgent

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

Methods inherited from interface artisynth.core.modelbase.HasNumericState

advanceState, getAuxVarDerivative, getAuxVarState, getStateVersion, hasState, numAuxVars, requiresAdvance, setAuxVarState

Methods inherited from interface artisynth.core.modelbase.TransformableGeometry

transformGeometry, transformPriority

Methods inherited from interface artisynth.core.mechmodels.ContactMaster

isControllable

Field Detail

DEFAULT_COLOR_INTERPOLATION

public static final Renderer.ColorInterpolation DEFAULT_COLOR_INTERPOLATION

myProps

public static PropertyList myProps

Constructor Detail

FemCutPlane

public FemCutPlane()

FemCutPlane

public FemCutPlane(RigidTransform3d TPW)

FemCutPlane

public FemCutPlane(double res)

FemCutPlane

public FemCutPlane(double res,
                   RigidTransform3d TPW)

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 Frame

Returns:

static information for all exported properties

getFem

public FemModel3d getFem()

Specified by:

getFem in interface FemMesh

isMeshPolygonal

public boolean isMeshPolygonal()

Specified by:

isMeshPolygonal in interface FemMesh

getMesh

public PolygonalMesh getMesh()

Specified by:

getMesh in interface FemMesh

getColorInterpolation

public Renderer.ColorInterpolation getColorInterpolation()

setColorInterpolation

public void setColorInterpolation(Renderer.ColorInterpolation interp)

getSquareSize

public double getSquareSize()

Gets the size of the square.

Returns:

current square size

See Also:

setSquareSize(double)

setSquareSize

public void setSquareSize(double size)

Sets the size of the square. The square is a square outline of the plane rendered in the viewer to allow visualization and selection. If size <= 0, then the square is not displayed. and selected in the viewer.

Parameters:

size - new square size

getResolution

public double getResolution()

Gets the grid resolution of the display, in units of distance.

See Also:

setResolution(double)

setResolution

public void setResolution(double res)

Sets the grid resolution of the display, in units of distance. Specifying a non-positive value will cause the resolution to be computed automatically from a sampling of the FEM elements.

getCurrentResolution

public double getCurrentResolution()

Returns the currently computed grid resolution for the display. If not set explicitly set by setResolution(double), this will be computed automatically from a sampling of the FEM elements.

setSurfaceRendering

public void setSurfaceRendering(FemModel.SurfaceRender rendering)

getSurfaceRendering

public FemModel.SurfaceRender getSurfaceRendering()

setSurfaceRenderingMode

public void setSurfaceRenderingMode(PropertyMode mode)

getSurfaceRenderingMode

public PropertyMode getSurfaceRenderingMode()

setStressPlotRanging

public void setStressPlotRanging(FemModel.Ranging ranging)

getStressPlotRanging

public FemModel.Ranging getStressPlotRanging()

setStressPlotRangingMode

public void setStressPlotRangingMode(PropertyMode mode)

getStressPlotRangingMode

public PropertyMode getStressPlotRangingMode()

resetAutoStressPlotRange

public void resetAutoStressPlotRange()

setStressPlotRange

public void setStressPlotRange(DoubleInterval range)

getStressPlotRange

public DoubleInterval getStressPlotRange()

setStressPlotRangeMode

public void setStressPlotRangeMode(PropertyMode mode)

getStressPlotRangeMode

public PropertyMode getStressPlotRangeMode()

getHighlightColoredMesh

public boolean getHighlightColoredMesh()

setHighlightColoredMesh

public void setHighlightColoredMesh(boolean enable)

setColorMap

public void setColorMap(ColorMapBase map)

getColorMap

public ColorMapBase getColorMap()

getColorMapMode

public PropertyMode getColorMapMode()

setColorMapMode

public void setColorMapMode(PropertyMode mode)

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 Frame

Parameters:

pmin - minimum point

pmax - maximum point

createRenderProps

public RenderProps createRenderProps()

Description copied from interface: HasRenderProps

Factory method to create render properties appropriate to this object.

Specified by:

createRenderProps in interface HasRenderProps

Overrides:

createRenderProps in class Frame

Returns:

new render properties for this object

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 Frame

Parameters:

list - list of objects to be rendered

invalidateMesh

public void invalidateMesh()

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 Frame

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.

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

Overrides:

transformGeometry in class Frame

Parameters:

gtr - transformer implementing the transform

context - context information, including what other components are being transformed

flags - specifies conditions associated with the transformation

copy

public FemCutPlane 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 Frame

Parameters:

flags - flags to control the copying

copyMap - map to possible existing instances of referenced components

Returns:

copy of this component