artisynth.core.modelbase

Interface Model

All Superinterfaces:

Disposable, HasProperties, HasState, HierarchyNode, ModelComponent, Scannable

All Known Subinterfaces:

MechSystemModel

All Known Implementing Classes:

AjlCollisionTest, ArticulatedBeamBody, ArticulatedDemo, ArticulatedFem, AttachDemo, AttachedBeamBody, AttachedBeamDemo, BallPlateCollide, BeamBodyCollide, BlockTest, BlockTestX, ColoredFemBeam3d, ColoredMeshDemo, ColoredSphereTest, CompliantConstraintDemo, ConstrainedParticle, CoupledSolveDemo, CylinderWrapping, DeformedJointedCollide, DicomLoader, DicomTest, DoubleArmDemo, DrawModeTest, EditableMeshTest, EllipsoidWrapTest, EmbeddedSurface, FallingSkull, Fem3dBlock, FemBeam, FemBeam3d, FemBeamColored, FemBeamMech, FemBeamTest, FemBeamWithBlock, FemBeamWithFemSphere, FemBeamWithMuscle, FemCollision, FemCollisions, FemEmbeddedSphere, FemFrictionBeam, FemModel, FemModel3d, FemModelDeformer, FemMuscleArm, FemMuscleBeams, FemMuscleDemo, FemMuscleHeart, FemMuscleModel, FemPlaneCollide, FemSkinDemo, FemSurfaceTargetDemo, FemWithBeamBody, FishDemo, ForceTargetDemo, FrameBodyAttachment, FrameFemAttachment, FrameSpringDemo, FullPlanarJointDemo, Hello, Hex3dBlock, HexBeam3d, HexFrame, HexIncompress, HydrostatDemo, HydrostatInvDemo, HydrostatModel, InstancedRenderingTest, JointedCollide, JointedFemBeams, LaymanBowl, LaymanDemo, LaymanModel, LinearAuxiliaryTest, LockingDemo, LumbarFrameSpring, LumbarSpringDemo, MappingDemo, MappingTest, MassSpringDemo, MechModel, MechModelCollide, MechModelDemo, MechSystemBase, MeshBodyTest, MeshEditTest, MeshTestBase, MFreeModel3d, MFreeMuscleModel, ModelBase, ModelBaseOld, MultiMuscleDemo, MultiSpringDemo, MultiSpringTest, MuscleArm, NetDemo, NetDemo, NetDemoWithPan, NetDemoWithRefs, ParticleAttachment, ParticleSpring, PenetrationRender, PenetrationRendererDemo, PlanarConnectorDemo, PlaneConstrainedFem, PointFemAttachment, PointForceDemo, PointMeshTest, PointModel, PointModel1d, PointModel2d, PointModel3d, PointToPointMuscle, PolygonalMeshTest, PolylineMeshTest, PressureShell, PuppetDemo, PyramidBeam3d, QuadFishDemo, QuadhexBeam3d, QuadpyramidBeam3d, QuadraticLockingDemo, QuadtetBeam3d, QuadwedgeBeam3d, RenderableModelBase, RenderableModelBaseOld, RigidBodyCollision, RigidBodyDemo, RigidBodyJoint, RigidBodySpring, RigidCompositeCollide, RobustCube, RollPitchJointDemo, RootModel, SDGridTest, SegmentedPlaneDemo, SelfCollision, SimpleCollide, SimpleMuscle, SimpleMuscleWithController, SimpleMuscleWithPanel, SimpleMuscleWithProbes, SimpleMuscleWithProbes2, SimpleMuscleWithProperties, SinCosMonitorProbe, SingleHex, SinglePyramid, SingleQuadhex, SingleQuadpyramid, SingleQuadtet, SingleQuadwedge, SingleTet, SingleWedge, SkinDemo, SkullParticles, SpecularTest, SphericalJointDemo, SphericalTextureMapping, SpinControlProbe, SpongeDemo, SpongeModel, SpringMeshDemo, TetBeam3d, TextTest, TorusDemo, TorusWrapTest, TransverseIsotropy, TransverseIsotropyTest, TubeDemo, TwoStrandWrapBase, ViscousBeam, WedgeBeam3d

public interface Model
extends ModelComponent, Disposable, HasState

Basic interface requirements for all Artisynth models

Nested Class Summary

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

ModelComponent.NavpanelVisibility

Method Summary

Modifier and Type	Method and Description
StepAdjustment	advance(double t0, double t1, int flags) Advances this object from time t0 to time t1.
void	dispose() Called when the model is discarded.
double	getMaxStepSize() Returns the maximum step by which this object should be advanced within a simulation loop.
void	initialize(double t) Causes this model to initialize itself at time t.
StepAdjustment	preadvance(double t0, double t1, int flags) Prepares this object for advance from time t0 to time t1.

Methods inherited from interface artisynth.core.modelbase.ModelComponent

connectToHierarchy, disconnectFromHierarchy, 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

getAllPropertyInfo, 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.HasState

createState, getInitialState, getState, setState

Method Detail

initialize

void initialize(double t)

Causes this model to initialize itself at time t. This method will be called at the very beginning of the simulation (with t = 0), or immediately after the model's state has been reset using HasState.setState(artisynth.core.modelbase.ComponentState), in which case t may have an arbitrary value.

Parameters:

t - initialization time (seconds)

preadvance

StepAdjustment preadvance(double t0,
                          double t1,
                          int flags)

Prepares this object for advance from time t0 to time t1. Often this method does nothing; it is provided in case a model needs to update internal state at the very beginning a step before input probes and controllers are applied.

If the method determines that the step size should be reduced, it can return a StepAdjustment object indicating the recommended reduction. Otherwise, the method may return null

Parameters:

t0 - current time (seconds)

t1 - new time to advance to (seconds)

flags - reserved for future use

Returns:

null, or a step adjustment recommendation

advance

StepAdjustment advance(double t0,
                       double t1,
                       int flags)

Advances this object from time t0 to time t1.

If the method determines that the step size should be reduced, it can return a StepAdjustment object indicating the recommended reduction. Otherwise, the method may return null

Parameters:

t0 - current time (seconds)

t1 - new time to advance to (seconds)

flags - reserved for future use

Returns:

null, or a step adjustment recommendation

getMaxStepSize

double getMaxStepSize()

Returns the maximum step by which this object should be advanced within a simulation loop.

Returns:

maximum step size (seconds)

dispose

void dispose()

Called when the model is discarded. Disposes of any resources used.

Specified by:

dispose in interface Disposable