artisynth.core.fields

Class ScalarSubElemField

java.lang.Object

artisynth.core.modelbase.ModelComponentBase

artisynth.core.fields.FemFieldComp

artisynth.core.fields.ScalarFemField

artisynth.core.fields.ScalarSubElemField

All Implemented Interfaces:

FieldComponent, ModelComponent, PostScannable, RenderableComponent, ScalarFieldComponent, java.lang.Cloneable, HasProperties, HierarchyNode, HasRenderProps, IsRenderable, IsSelectable, Renderable, Scannable

public class ScalarSubElemField
extends ScalarFemField

A scalar field defined over an FEM model, using values set at the element integration points. Values at other points are obtained by interpolation within the elements nearest to those points. Values at elements for which no explicit values have been set are given by the field's default value.

For a given element elem, values should be specified for all integration points, as returned by FemElement3dBase.getAllIntegrationPoints(). This includes the regular integration points, as well as the warping point, which is located at the element center and is used by corotated linear materials. Integration point indices should be in the range 0 to FemElement3dBase.numAllIntegrationPoints() - 1.

Nested Class Summary

Nested classes/interfaces inherited from class artisynth.core.fields.ScalarFemField

ScalarFemField.Visualization

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

ModelComponent.NavpanelVisibility

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	DEFAULT_SHELL_ELEMS_VISIBLE
static boolean	DEFAULT_VOLUME_ELEMS_VISIBLE
static PropertyList	myProps

Fields inherited from class artisynth.core.fields.ScalarFemField

DEFAULT_COLOR_INTERPOLATION, DEFAULT_VISUALIZATION

Fields inherited from class artisynth.core.modelbase.ModelComponentBase

enforceUniqueCompositeNames, enforceUniqueNames, myNumber, NULL_OBJ, useCompactPathNames

Fields inherited from interface maspack.render.IsRenderable

TRANSPARENT, TWO_DIMENSIONAL

Constructor Summary

Constructors

Constructor and Description
ScalarSubElemField() This constructor should not be called by applications, unless ModelComponentBase.scan(maspack.util.ReaderTokenizer, java.lang.Object) is called immediately after.
ScalarSubElemField(FemModel3d fem) Constructs a field for a given FEM model, with a default value of 0.
ScalarSubElemField(FemModel3d fem, double defaultValue) Constructs a field for a given FEM model and default value.
ScalarSubElemField(java.lang.String name, FemModel3d fem) Constructs a named field for a given FEM model, with a default value of 0.
ScalarSubElemField(java.lang.String name, FemModel3d fem, double defaultValue) Constructs a named field for a given FEM model and default value.

Method Summary

Modifier and Type	Method and Description
void	clearAllValues() Clear all values defined for the features (e.g., nodes, elements) associated with this field.
void	clearValue(FemElement3dBase elem, int subIdx) Clears the value at an integration of an element (either volumetric or shell).
boolean	equals(ScalarSubElemField field) Returns true if this field is functionally equal to another field.
PropertyList	getAllPropertyInfo() Returns a list giving static information about all properties exported by this object.
double	getElementValue(int elemNum, int subIdx) Returns the value at an integration point of a volumetric element.
double	getShellElementValue(int elemNum, int subIdx) Returns the value at an integration point of a shell element.
boolean	getShellElemsVisible()
void	getSoftReferences(java.util.List<ModelComponent> refs) Appends all soft references for this component to a list.
double	getValue(FemElement3dBase elem, int subIdx) Returns the value at an integration point of an element (either volumetric or shell).
double	getValue(FemFieldPoint fp) Returns the value of the this field at a specified FEM field point.
double	getValue(Point3d pos) Returns the value of the this field at a specified spatial position.
Range	getVisualizationRange()
boolean	getVolumeElemsVisible()
boolean	isValueSet(FemElement3dBase elem, int subIdx) Queries whether a value has been seen at an integration point of an element (either volumetric or shell).
void	postscan(java.util.Deque<ScanToken> tokens, CompositeComponent ancestor) Performs any required post-scanning for this component.
void	setShellElemsVisible(boolean visible)
void	setValue(FemElement3dBase elem, int subIdx, double value) Sets the value at an integration point of an element (either volumetric or shell).
void	setVolumeElemsVisible(boolean visible)
void	updateReferences(boolean undo, java.util.Deque<java.lang.Object> undoInfo) May be called by the system if any of the soft references for this component are removed from the the component hierarchy.

Methods inherited from class artisynth.core.fields.ScalarFemField

addRenderMeshComp, clearRenderMeshComps, createDefaultRenderProps, createRenderProps, equals, getColorInterpolation, getColorMap, getDefaultValue, getRenderMeshComp, getRenderRange, getSelection, getValue, getValueRange, getVisualization, numRenderMeshComps, numSelectionQueriesNeeded, prerender, removeRenderMeshComp, render, setColorInterpolation, setColorMap, setDefaultValue, setRenderRange, setVisualization

Methods inherited from class artisynth.core.fields.FemFieldComp

clearCacheIfNecessary, equals, getFemModel, getRenderHints, getRenderProps, isSelectable, setRenderProps, updateBounds

Methods inherited from class artisynth.core.modelbase.ModelComponentBase

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

Methods inherited from class java.lang.Object

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

Methods inherited from interface maspack.render.IsSelectable

isSelectable

Methods inherited from interface maspack.render.IsRenderable

getRenderHints, updateBounds

Methods inherited from interface maspack.render.HasRenderProps

getRenderProps, setRenderProps

Methods inherited from interface artisynth.core.modelbase.FieldComponent

clearCacheIfNecessary

Methods inherited from interface artisynth.core.modelbase.ModelComponent

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

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

Field Detail

DEFAULT_VOLUME_ELEMS_VISIBLE

public static boolean DEFAULT_VOLUME_ELEMS_VISIBLE

DEFAULT_SHELL_ELEMS_VISIBLE

public static boolean DEFAULT_SHELL_ELEMS_VISIBLE

myProps

public static PropertyList myProps

Constructor Detail

ScalarSubElemField

public ScalarSubElemField()

This constructor should not be called by applications, unless ModelComponentBase.scan(maspack.util.ReaderTokenizer, java.lang.Object) is called immediately after.

ScalarSubElemField

public ScalarSubElemField(FemModel3d fem)

Constructs a field for a given FEM model, with a default value of 0.

Parameters:

fem - FEM model over which the field is defined

ScalarSubElemField

public ScalarSubElemField(FemModel3d fem,
                          double defaultValue)

Constructs a field for a given FEM model and default value.

Parameters:

fem - FEM model over which the field is defined

defaultValue - default value for integration points which don't have explicitly set values

ScalarSubElemField

public ScalarSubElemField(java.lang.String name,
                          FemModel3d fem)

Constructs a named field for a given FEM model, with a default value of 0.

Parameters:

name - name of the field

fem - FEM model over which the field is defined

ScalarSubElemField

public ScalarSubElemField(java.lang.String name,
                          FemModel3d fem,
                          double defaultValue)

Constructs a named field for a given FEM model and default value.

Parameters:

name - name of the field

fem - FEM model over which the field is defined

defaultValue - default value for integration points which don't have explicitly set values

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 ScalarFemField

Returns:

static information for all exported properties

getVisualizationRange

public Range getVisualizationRange()

Overrides:

getVisualizationRange in class ScalarFemField

getVolumeElemsVisible

public boolean getVolumeElemsVisible()

setVolumeElemsVisible

public void setVolumeElemsVisible(boolean visible)

getShellElemsVisible

public boolean getShellElemsVisible()

setShellElemsVisible

public void setShellElemsVisible(boolean visible)

getElementValue

public double getElementValue(int elemNum,
                              int subIdx)

Returns the value at an integration point of a volumetric element. The default value is returned if a value has not been explicitly set for that point. The element is specified by its number; element numbers are used instead of indices as they are more persistent if the FEM model is modified.

Parameters:

elemNum - volumetric element number

subIdx - integration point index, in the range 0 to n-1, where n is the value returned by the element's FemElement3dBase.numAllIntegrationPoints() method

Returns:

value at the integration point

getShellElementValue

public double getShellElementValue(int elemNum,
                                   int subIdx)

Returns the value at an integration point of a shell element. The default value is returned if a value has not been explicitly set for that point. The element is specified by its number; element numbers are used instead of indices as they are more persistent if the FEM model is modified.

Parameters:

elemNum - volumetric element number

subIdx - integration point index, in the range 0 to n-1, where n is the value returned by the element's FemElement3dBase.numAllIntegrationPoints() method

Returns:

value at the integration point

getValue

public double getValue(FemElement3dBase elem,
                       int subIdx)

Returns the value at an integration point of an element (either volumetric or shell). The default value is returned if a value has not been explicitly set for that point.

Parameters:

elem - element containing the integration point

subIdx - integration point index, in the range 0 to n-1, where n is the value returned by the element's FemElement3dBase.numAllIntegrationPoints() method

Returns:

value at the integration point

getValue

public double getValue(FemFieldPoint fp)

Returns the value of the this field at a specified FEM field point.

Parameters:

fp - point at which value is requested

Returns:

value at the point

getValue

public double getValue(Point3d pos)

Returns the value of the this field at a specified spatial position.

Specified by:

getValue in interface ScalarFieldComponent

Specified by:

getValue in class ScalarFemField

Parameters:

pos - position at which value is requested

Returns:

value at the position

setValue

public void setValue(FemElement3dBase elem,
                     int subIdx,
                     double value)

Sets the value at an integration point of an element (either volumetric or shell).

Parameters:

elem - element containing the integration point

subIdx - integration point index, in the range 0 to n-1, where n is the value returned by the element's FemElement3dBase.numAllIntegrationPoints() method

value - new value for the integration point

isValueSet

public boolean isValueSet(FemElement3dBase elem,
                          int subIdx)

Queries whether a value has been seen at an integration point of an element (either volumetric or shell).

Parameters:

elem - element containing the integration point

subIdx - integration point index, in the range 0 to n-1, where n is the value returned by the element's FemElement3dBase.numAllIntegrationPoints() method

Returns:

true if a value has been set at the integration point

clearValue

public void clearValue(FemElement3dBase elem,
                       int subIdx)

Clears the value at an integration of an element (either volumetric or shell). After this call, the point will be associated with the default value.

Parameters:

elem - element containing the integration point

subIdx - integration point index, in the range 0 to n-1, where n is the value returned by the element's FemElement3dBase.numAllIntegrationPoints() method

clearAllValues

public void clearAllValues()

Clear all values defined for the features (e.g., nodes, elements) associated with this field. After this call, the field will have a uniform value defined by its defaultValue.

Specified by:

clearAllValues in class ScalarFemField

postscan

public void postscan(java.util.Deque<ScanToken> tokens,
                     CompositeComponent ancestor)
              throws java.io.IOException

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 ModelComponentBase

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)

getSoftReferences

public void getSoftReferences(java.util.List<ModelComponent> refs)

Appends all soft references for this component to a list. References are other components, outside of this component's immediate ancestry, on which this component depends. For example, an ExcitationComponent may refer to one or more other ExcitationComponents to act as excitation sources. A soft reference is one which can be removed from the referring component. In particular, if any soft references for a component are deleted, then that component's updateReferences() method will be called to update its internal reference information.

Specified by:

getSoftReferences in interface ModelComponent

Overrides:

getSoftReferences in class ScalarFemField

Parameters:

refs - list to which soft references are appended

updateReferences

public void updateReferences(boolean undo,
                             java.util.Deque<java.lang.Object> undoInfo)

May be called by the system if any of the soft references for this component are removed from the the component hierarchy. If called with undo equal to false, this component should then examine its soft references and use ComponentUtils.areConnected() to determine which of them have been disconnected from the hierarchy. Disconnected references should be removed, and sufficient information should be appended to undoInfo to allow this update to be undone if this method is called later with undo equal to true. When undoing an update, the undo information should be removed from the front of undoInfo.

Specified by:

updateReferences in interface ModelComponent

Overrides:

updateReferences in class ScalarFemField

Parameters:

undo - if true, indicates that the most recent reference update should be undone, using the supplied undo information.

undoInfo - if undo is false, should be used to store information allowing the reference update to be undone. Otherwise, if undo is true, then this supplied information to undo the most recent update.

equals

public boolean equals(ScalarSubElemField field)

Returns true if this field is functionally equal to another field. Intended mainly for testing and debugging.