artisynth.core.femmodels

Class AuxMaterialElementDesc

java.lang.Object

artisynth.core.modelbase.ModelComponentBase

artisynth.core.modelbase.RenderableComponentBase

artisynth.core.femmodels.AuxMaterialElementDesc

All Implemented Interfaces:

AuxiliaryMaterial, HasMaterialState, ModelComponent, PostScannable, RenderableComponent, TransformableGeometry, ScalableUnits, java.lang.Cloneable, HasProperties, HierarchyNode, HasRenderProps, IsRenderable, IsSelectable, Renderable, Clonable, Scannable

public class AuxMaterialElementDesc
extends RenderableComponentBase
implements AuxiliaryMaterial, ScalableUnits, TransformableGeometry

A class wrapping the description of each FEM element. It implements the AuxiliaryMaterial required to mix material types together within a single element.

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 PropertyList	myProps

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 maspack.render.IsRenderable

TRANSPARENT, TWO_DIMENSIONAL

Constructor Summary

Constructors

Constructor and Description
AuxMaterialElementDesc()
AuxMaterialElementDesc(FemElement3d elem)
AuxMaterialElementDesc(FemElement3d elem, FemMaterial mat, double frac)

Method Summary

Modifier and Type	Method and Description
void	addTransformableDependencies(TransformGeometryContext context, int flags) Adds to context any transformable components which should be transformed as the same time as this component.
void	advanceState(MaterialStateObject state, double t0, double t1)
double	computeStrainEnergyDensity(DeformedPoint def, IntegrationPoint3d pt, IntegrationData3d dt, MaterialStateObject state)
void	computeStressAndTangent(SymmetricMatrix3d sigma, Matrix6d D, DeformedPoint def, IntegrationPoint3d pt, IntegrationData3d dt, MaterialStateObject state)
void	connectToHierarchy(CompositeComponent hcomp) Called by the system after this component, or an ancestor of this component, is added to the component hierarchy (i.e., added as a child of another CompositeComponent).
MaterialStateObject	createStateObject()
boolean	defaultRenderPropsAreNull()
void	disconnectFromHierarchy(CompositeComponent hcomp) Called by the system after this component, or an ancestor of this component, is removed from the component hierarchy (i.e., removed as a child of its parent).
PropertyList	getAllPropertyInfo() Returns a list giving static information about all properties exported by this object.
FemElement3d	getElement()
double	getFraction()
double[]	getFractions()
boolean	hasState() Queries if this component has state.
boolean	hasSymmetricTangent()
boolean	isCorotated() Deformation is computed by first removing a rotation component (either explicit or computed from strain)
boolean	isInvertible()
boolean	isLinear() Linear stress/stiffness response to deformation, allows tangent to be pre-computed and stored.
void	printElementReference(java.io.PrintWriter pw, CompositeComponent ancestor)
void	render(Renderer renderer, int flags) Render this object using the functionality of the supplied Renderer.
void	render(Renderer renderer, RenderProps props, int flags)
void	renderFraction(Renderer renderer, RenderProps props, double rad, AuxMaterialBundle.FractionRenderType renderType)
void	scaleDistance(double s) Scales all distance coordinates.
void	scaleMass(double s) Scales all mass units.
boolean	scanItem(ReaderTokenizer rtok, java.util.Deque<ScanToken> tokens)
void	setElement(FemElement3d elem)
void	setFraction(double frac)
void	setFractions(double[] fracs)
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	updateBounds(Vector3d pmin, Vector3d pmax) Update the minimum and maximum points for this object.
void	write(java.io.PrintWriter pw, NumberFormat fmt, java.lang.Object ref) Writes a text description of this element to a PrintWriter.

Methods inherited from class artisynth.core.modelbase.RenderableComponentBase

copy, createRenderProps, getRenderHints, getRenderProps, getSelection, isSelectable, isVisible, numSelectionQueriesNeeded, prerender, 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

Methods inherited from class java.lang.Object

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

Methods inherited from interface maspack.util.Clonable

clone

Methods inherited from interface artisynth.core.modelbase.TransformableGeometry

transformPriority

Methods inherited from interface artisynth.core.modelbase.ModelComponent

getHardReferences, getName, getNavpanelVisibility, getNumber, getParent, getSoftReferences, 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

Field Detail

myProps

public static PropertyList myProps

Constructor Detail

AuxMaterialElementDesc

public AuxMaterialElementDesc()

AuxMaterialElementDesc

public AuxMaterialElementDesc(FemElement3d elem)

AuxMaterialElementDesc

public AuxMaterialElementDesc(FemElement3d elem,
                              FemMaterial mat,
                              double frac)

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 RenderableComponentBase

Returns:

static information for all exported properties

setFraction

public void setFraction(double frac)

setFractions

public void setFractions(double[] fracs)

getFraction

public double getFraction()

getFractions

public double[] getFractions()

isInvertible

public boolean isInvertible()

Specified by:

isInvertible in interface AuxiliaryMaterial

isLinear

public boolean isLinear()

Description copied from interface: AuxiliaryMaterial

Linear stress/stiffness response to deformation, allows tangent to be pre-computed and stored.

Specified by:

isLinear in interface AuxiliaryMaterial

Returns:

true if linear response

isCorotated

public boolean isCorotated()

Description copied from interface: AuxiliaryMaterial

Deformation is computed by first removing a rotation component (either explicit or computed from strain)

Specified by:

isCorotated in interface AuxiliaryMaterial

Returns:

true if material is corotated

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 RenderableComponentBase

Parameters:

pmin - minimum point

pmax - maximum point

computeStressAndTangent

public void computeStressAndTangent(SymmetricMatrix3d sigma,
                                    Matrix6d D,
                                    DeformedPoint def,
                                    IntegrationPoint3d pt,
                                    IntegrationData3d dt,
                                    MaterialStateObject state)

Specified by:

computeStressAndTangent in interface AuxiliaryMaterial

computeStrainEnergyDensity

public double computeStrainEnergyDensity(DeformedPoint def,
                                         IntegrationPoint3d pt,
                                         IntegrationData3d dt,
                                         MaterialStateObject state)

Specified by:

computeStrainEnergyDensity in interface AuxiliaryMaterial

hasSymmetricTangent

public boolean hasSymmetricTangent()

Specified by:

hasSymmetricTangent in interface AuxiliaryMaterial

getElement

public FemElement3d getElement()

setElement

public void setElement(FemElement3d elem)

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

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

Parameters:

s - scaling factor

connectToHierarchy

public void connectToHierarchy(CompositeComponent hcomp)

Description copied from class: ModelComponentBase

Called by the system after this component, or an ancestor of this component, is added to the component hierarchy (i.e., added as a child of another CompositeComponent). This method is responsible for doing any required hierarchy-dependent initialization, including any updating of referenced components.

When this method is called, ModelComponent.getParent() will return the new parent component; the system will have set this beforehand.

Specified by:

connectToHierarchy in interface ModelComponent

Overrides:

connectToHierarchy in class ModelComponentBase

Parameters:

hcomp - hierarchy component to which this component, or its ancestor, was attached

disconnectFromHierarchy

public void disconnectFromHierarchy(CompositeComponent hcomp)

Description copied from class: ModelComponentBase

Called by the system after this component, or an ancestor of this component, is removed from the component hierarchy (i.e., removed as a child of its parent). This method is responsible for any required hierarchy-dependent deinitialization, including any updating of referenced components.

When this method is called, ModelComponent.getParent() will still return this original parent component; the system will set this to null after.

Specified by:

disconnectFromHierarchy in interface ModelComponent

Overrides:

disconnectFromHierarchy in class ModelComponentBase

Parameters:

hcomp - hierarchy component from which this component, or its ancestor, was detached

printElementReference

public void printElementReference(java.io.PrintWriter pw,
                                  CompositeComponent ancestor)
                           throws java.io.IOException

Throws:

java.io.IOException

scanItem

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

Throws:

java.io.IOException

write

public void write(java.io.PrintWriter pw,
                  NumberFormat fmt,
                  java.lang.Object ref)
           throws java.io.IOException

Description copied from class: ModelComponentBase

Writes a text description of this element to a PrintWriter. The text description should be compatable with scan and complete enough to allow full reconstruction of the element.

Specified by:

write in interface Scannable

Overrides:

write in class ModelComponentBase

Parameters:

pw - stream for writing the element

fmt - numeric formating information

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

Throws:

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

defaultRenderPropsAreNull

public boolean defaultRenderPropsAreNull()

Overrides:

defaultRenderPropsAreNull in class RenderableComponentBase

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

Specified by:

render in class RenderableComponentBase

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.

render

public void render(Renderer renderer,
                   RenderProps props,
                   int flags)

renderFraction

public void renderFraction(Renderer renderer,
                           RenderProps props,
                           double rad,
                           AuxMaterialBundle.FractionRenderType renderType)

hasState

public boolean hasState()

Description copied from interface: ModelComponent

Queries if this component has state. Structure change events involving components that have state will cause the current state history of of the system to be cleared.

Specified by:

hasState in interface AuxiliaryMaterial

Specified by:

hasState in interface HasMaterialState

Specified by:

hasState in interface ModelComponent

Overrides:

hasState in class ModelComponentBase

Returns:

true if this component has state

createStateObject

public MaterialStateObject createStateObject()

Specified by:

createStateObject in interface AuxiliaryMaterial

Specified by:

createStateObject in interface HasMaterialState

advanceState

public void advanceState(MaterialStateObject state,
                         double t0,
                         double t1)

Specified by:

advanceState in interface HasMaterialState