artisynth.core.mechmodels

Class EllipsoidJoint3d

java.lang.Object

artisynth.core.modelbase.ModelComponentBase

artisynth.core.modelbase.RenderableComponentBase

artisynth.core.mechmodels.BodyConnector

artisynth.core.mechmodels.JointBase

artisynth.core.mechmodels.EllipsoidJoint3d

All Implemented Interfaces:

Constrainer, CopyableComponent, HasCoordinateFrame, HasNumericState, ModelComponent, PostScannable, RenderableComponent, TransformableGeometry, ScalableUnits, java.lang.Cloneable, HasProperties, HierarchyNode, HasRenderProps, IsRenderable, IsSelectable, Renderable, Scannable

public class EllipsoidJoint3d
extends JointBase
implements CopyableComponent

Implements a 3 DOF joint, in which the origin of frame C is constrained to lie on the surface of an ellipsoid in frame D, while being free to rotate about the axis normal to the ellipsoid surface. The x and y displacements of C are given by the coordinates x and y, while the (counter-clockwise) rotation of C about z is given by the coordinate theta.

The x, y theta values are available as properties (given in degrees) which can be read and also, under appropriate circumstances, set. Setting these values causes an adjustment in the positions of one or both bodies connected to this joint, along with adjacent bodies connected to them, with preference given to bodies that are not attached to ``ground''. If this is done during simulation, and particularly if one or both of the bodies connected to this joint are moving dynamically, the results will be unpredictable and will likely conflict with the simulation.

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
static int	THETA_IDX
static int	X_IDX
static int	Y_IDX

Fields inherited from class artisynth.core.mechmodels.JointBase

DEFAULT_SHAFT_LENGTH, DEFAULT_SHAFT_RADIUS

Fields inherited from class artisynth.core.mechmodels.BodyConnector

debug, useOldDerivativeMethod

Fields inherited from class artisynth.core.modelbase.ModelComponentBase

enforceUniqueCompositeNames, enforceUniqueNames, myNumber, NULL_OBJ, useCompactPathNames

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

Fields inherited from interface maspack.render.IsRenderable

TRANSPARENT, TWO_DIMENSIONAL

Constructor Summary

Constructors

Constructor and Description
EllipsoidJoint3d(ConnectableBody bodyA, ConnectableBody bodyB, RigidTransform3d TCW, RigidTransform3d TDW, double a, double b, double c, boolean useOpenSimApprox) Creates a EllipsoidJoint connecting two connectable bodies, bodyA and bodyB.
EllipsoidJoint3d(double a, double b, double c, boolean useOpenSimApprox) Creates a PlanarJoint which is not attached to any bodies.
EllipsoidJoint3d(RigidBody bodyA, RigidTransform3d TCA, RigidBody bodyB, RigidTransform3d TDB, double a, double b, double c, boolean useOpenSimApprox) Creates a EllipsoidJoint connecting two rigid bodies, bodyA and bodyB.

Method Summary

Modifier and Type	Method and Description
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.
EllipsoidCoupling3d	getCoupling() Returns the coupling used by this connector.
boolean	getDrawEllipsoid()
double	getMaxTheta() Queries the upper theta range limit for this joint, in degrees.
double	getMaxX() Queries the upper x range limit for this joint, in degrees.
double	getMaxY() Queries the upper x range limit for this joint, in degrees.
double	getMinTheta() Queries the lower theta range limit for this joint, in degrees.
double	getMinX() Queries the lower x range limit for this joint, in degrees.
double	getMinY() Queries the lower x range limit for this joint, in degrees.
double	getPlaneSize() Queries the size used to render this joint's tangent plane as a square.
double	getTheta() Queries this joint's theta value, in degrees.
DoubleInterval	getThetaRange() Queries the theta range limits for this joint, in degrees.
boolean	getUseOpenSimApprox()
double	getX() Queries the x range limits for this joint.
DoubleInterval	getXRange() Queries the x range limits for this joint.
double	getY() Queries this joint's y value.
DoubleInterval	getYRange() Queries the y range limits for this joint.
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	setDrawEllipsoid(boolean enable)
void	setMaxTheta(double max) Sets the upper theta range limit for this joint, in degrees.
void	setMaxX(double max) Sets the upper x range limit for this joint.
void	setMaxY(double max) Sets the upper y range limit for this joint.
void	setMinTheta(double min) Sets the lower theta range limit for this joint, in degrees.
void	setMinX(double min) Sets the lower x range limit for this joint.
void	setMinY(double min) Sets the lower y range limit for this joint.
void	setPlaneSize(double size) Sets the size used to render this joint's tangent plane as a square.
void	setTheta(double theta) Sets this joint's theta value, in degrees.
void	setThetaRange(double min, double max) Sets the theta range limits for this joint.
void	setThetaRange(DoubleInterval range) Sets the theta range limits for this joint, in degrees.
void	setX(double x) Sets this joint's x value.
void	setXRange(double min, double max) Sets the x range limits for this joint.
void	setXRange(DoubleInterval range) Sets the x range limits for this joint.
void	setY(double y) Sets this joint's y value.
void	setYRange(double min, double max) Sets the y range limits for this joint.
void	setYRange(DoubleInterval range) Sets the y range limits for this joint.
void	updateBounds(Vector3d pmin, Vector3d pmax) Update the minimum and maximum points for this object.

Methods inherited from class artisynth.core.mechmodels.JointBase

addCoordinateSolveBlocks, addCoordinateVelJacobian, applyCoordinateForce, coordinatesToTCD, getCoordinate, getCoordinateDeg, getCoordinateIndex, getCoordinateMotionType, getCoordinateName, getCoordinateRange, getCoordinateRangeDeg, getCoordinates, getCoordinateSpeed, getCoordinateValue, getMaxCoordinate, getMaxCoordinateDeg, getMinCoordinate, getMinCoordinateDeg, getPosition, getShaftLength, getShaftRadius, getStoredCoordinates, getStoredTCD, getStoredTCD, isCoordinateLocked, numCoordinates, setCoordinate, setCoordinateDeg, setCoordinateLocked, setCoordinateName, setCoordinateRange, setCoordinateRangeDeg, setCoordinates, setShaftLength, setShaftRadius

Methods inherited from class artisynth.core.mechmodels.BodyConnector

addBilateralConstraints, addFrictionConstraints, addMasterBlocks, addTransformableDependencies, addUnilateralConstraints, computeConstraintMatrixA, computeConstraintMatrixB, connectToHierarchy, copy, disconnectFromHierarchy, findAttachedBodies, getActivation, getAxisLength, getBilateralForceInA, getBilateralForceInA, getBilateralForceInB, getBilateralForceInB, getBilateralForceInC, getBilateralForceInC, getBilateralForces, getBilateralInfo, getBilateralSizes, getBodyA, getBodyB, getCompliance, getConstrainedComponents, getConstraint, getConstraintFlags, getConstraintForce, getCopyReferences, getCurrentTCD, getCurrentTCW, getCurrentTCW, getCurrentTDW, getCurrentTDW, getDamping, getDrawFrameC, getDrawFrameD, getFrameAttachmentA, getFrameAttachmentB, getFrictionForces, getFrictionState, getHardReferences, getLinearCompliance, getPenetrationTol, getPenetrationTolMode, getPose, getRenderFrame, getRotaryCompliance, getRotaryLimitTol, getRotaryLimitTolMode, getState, getStateVersion, getTransformDGeometryOnly, getTransformPositionOnly, getUnilateralForceInA, getUnilateralForceInA, getUnilateralForceInB, getUnilateralForceInB, getUnilateralForceInC, getUnilateralForceInC, getUnilateralForces, getUnilateralInfo, getUnilateralSizes, getUnilateralState, hasState, isActive, isConnectedToBodies, isDuplicatable, isEnabled, isNotAttached, maxFrictionConstraintSets, numBilateralConstraints, numConstraints, numEngagedUnilateralConstraints, numUnilateralConstraints, printConnectedBodies, printConstraintInfo, scaleDistance, scaleMass, setAlwaysAdjustBodyA, setAxisLength, setBilateralForces, setBodies, setBodies, setBodies, setBodies, setCompliance, setCurrentTCW, setCurrentTDW, setDamping, setDrawFrameC, setDrawFrameD, setEnabled, setFrictionForces, setFrictionState, setLinearCompliance, setPenetrationTol, setPenetrationTolMode, setRotaryCompliance, setRotaryLimitTol, setRotaryLimitTolMode, setState, setTransformDGeometryOnly, setTransformPositionOnly, setUnilateralForces, setUnilateralState, transformGeometry, transformGeometry, updateAttachments, updateConstraints, zeroForces

Methods inherited from class artisynth.core.modelbase.RenderableComponentBase

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

Methods inherited from class artisynth.core.modelbase.ModelComponentBase

checkFlag, checkName, checkNameUniqueness, clearFlag, clone, createTempFlag, getChildren, getGrandParent, 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.CopyableComponent

copy, getCopyReferences, isDuplicatable

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 artisynth.core.modelbase.TransformableGeometry

transformPriority

Methods inherited from interface artisynth.core.modelbase.HasNumericState

advanceState, getAuxVarDerivative, getAuxVarState, numAuxVars, requiresAdvance, setAuxVarState

Field Detail

X_IDX

public static final int X_IDX

See Also:

Constant Field Values

Y_IDX

public static final int Y_IDX

See Also:

Constant Field Values

THETA_IDX

public static final int THETA_IDX

See Also:

Constant Field Values

myProps

public static PropertyList myProps

Constructor Detail

EllipsoidJoint3d

public EllipsoidJoint3d(double a,
                        double b,
                        double c,
                        boolean useOpenSimApprox)

Creates a PlanarJoint which is not attached to any bodies. It can subsequently be connected using one of the setBodies methods.

EllipsoidJoint3d

public EllipsoidJoint3d(RigidBody bodyA,
                        RigidTransform3d TCA,
                        RigidBody bodyB,
                        RigidTransform3d TDB,
                        double a,
                        double b,
                        double c,
                        boolean useOpenSimApprox)

Creates a EllipsoidJoint connecting two rigid bodies, bodyA and bodyB. If A and B describe the coordinate frames of bodyA and bodyB, then TCA and TDB give the (fixed) transforms from the joint's C and D frames to A and B, respectively. Since C and D are specified independently, the joint transform TCD may not necessarily be initialized to the identity.

Specifying bodyB as null will cause bodyA to be connected to ground, with TDB then being the same as TDW.

Parameters:

bodyA - rigid body A

TCA - transform from joint frame C to body frame A

bodyB - rigid body B (or null)

TDB - transform from joint frame D to body frame B

EllipsoidJoint3d

public EllipsoidJoint3d(ConnectableBody bodyA,
                        ConnectableBody bodyB,
                        RigidTransform3d TCW,
                        RigidTransform3d TDW,
                        double a,
                        double b,
                        double c,
                        boolean useOpenSimApprox)

Creates a EllipsoidJoint connecting two connectable bodies, bodyA and bodyB. The joint frames C and D are located independently with respect to world coordinates by TCW and TDW.

Specifying bodyB as null will cause bodyA to be connected to ground.

Parameters:

bodyA - body A

bodyB - body B (or null)

TCW - initial transform from joint frame C to world

TDW - initial transform from joint frame D to world

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 JointBase

Returns:

static information for all exported properties

getDrawEllipsoid

public boolean getDrawEllipsoid()

setDrawEllipsoid

public void setDrawEllipsoid(boolean enable)

getCoupling

public EllipsoidCoupling3d getCoupling()

Description copied from class: BodyConnector

Returns the coupling used by this connector.

Overrides:

getCoupling in class BodyConnector

Returns:

coupling used by this connector

getUseOpenSimApprox

public boolean getUseOpenSimApprox()

getX

public double getX()

Queries the x range limits for this joint. See setXRange(DoubleInterval) for more details.

Returns:

x range limits for this joint

setX

public void setX(double x)

Sets this joint's x value. This describes the displacement of frame C along the x axis of frame D. See this class's Javadoc header for a discussion of what happens when this value is set.

Parameters:

x - new x value

getXRange

public DoubleInterval getXRange()

Queries the x range limits for this joint. See setXRange(DoubleInterval) for more details.

Returns:

x range limits for this joint

getMinX

public double getMinX()

Queries the lower x range limit for this joint, in degrees.

Returns:

lower x range limit

getMaxX

public double getMaxX()

Queries the upper x range limit for this joint, in degrees.

Returns:

upper x range limit

setXRange

public void setXRange(DoubleInterval range)

Sets the x range limits for this joint. The default range is [-inf, inf], which implies no limits. If x travels beyond these limits during dynamic simulation, unilateral constraints will be activated to enforce them. Setting the lower limit to -inf or the upper limit to inf removes the lower or upper limit, respectively. Specifying range as null will set the range to (-inf, inf).

Parameters:

range - x range limits for this joint

setXRange

public void setXRange(double min,
                      double max)

Sets the x range limits for this joint. This is a convenience wrapper for setXRange(DoubleInterval).

Parameters:

min - minimum x value

max - maximum x value

setMaxX

public void setMaxX(double max)

Sets the upper x range limit for this joint. Setting a value of inf removes the upper limit.

Parameters:

max - upper x range limit

setMinX

public void setMinX(double min)

Sets the lower x range limit for this joint. Setting a value of -inf removes the lower limit.

Parameters:

min - lower x range limit

getY

public double getY()

Queries this joint's y value. See setY(double) for more details.

Returns:

current y value

setY

public void setY(double y)

Sets this joint's y value. This describes the displacement of frame C along the y axis of frame D. See this class's Javadoc header for a discussion of what happens when this value is set.

Parameters:

y - new y value

getYRange

public DoubleInterval getYRange()

Queries the y range limits for this joint. See setYRange(DoubleInterval) for more details.

Returns:

y range limits for this joint

getMinY

public double getMinY()

Queries the lower x range limit for this joint, in degrees.

Returns:

lower x range limit

getMaxY

public double getMaxY()

Queries the upper x range limit for this joint, in degrees.

Returns:

upper x range limit

setYRange

public void setYRange(DoubleInterval range)

Sets the y range limits for this joint. The default range is [-inf, inf], which implies no limits. If y travels beyond these limits during dynamic simulation, unilateral constraints will be activated to enforce them. Setting the lower limit to -inf or the upper limit to inf removes the lower or upper limit, respectively. Specifying range as null will set the range to (-inf, inf).

Parameters:

range - y range limits for this joint

setYRange

public void setYRange(double min,
                      double max)

Sets the y range limits for this joint. This is a convenience wrapper for setYRange(DoubleInterval).

Parameters:

min - minimum y value

max - maximum y value

setMaxY

public void setMaxY(double max)

Sets the upper y range limit for this joint. Setting a value of inf removes the upper limit.

Parameters:

max - upper y range limit

setMinY

public void setMinY(double min)

Sets the lower y range limit for this joint. Setting a value of -inf removes the lower limit.

Parameters:

min - lower y range limit

getTheta

public double getTheta()

Queries this joint's theta value, in degrees. See setTheta(double) for more details.

Returns:

current theta value

setTheta

public void setTheta(double theta)

Sets this joint's theta value, in degrees. This describes the clockwise rotation of frame C about the z axis of frame D. See this class's Javadoc header for a discussion of what happens when this value is set.

Parameters:

theta - new theta value

getThetaRange

public DoubleInterval getThetaRange()

Queries the theta range limits for this joint, in degrees. See setThetaRange(DoubleInterval) for more details.

Returns:

theta range limits for this joint

getMinTheta

public double getMinTheta()

Queries the lower theta range limit for this joint, in degrees.

Returns:

lower theta range limit

getMaxTheta

public double getMaxTheta()

Queries the upper theta range limit for this joint, in degrees.

Returns:

upper theta range limit

setThetaRange

public void setThetaRange(DoubleInterval range)

Sets the theta range limits for this joint, in degrees. The default range is [-inf, inf], which implies no limits. If theta travels beyond these limits during dynamic simulation, unilateral constraints will be activated to enforce them. Setting the lower limit to -inf or the upper limit to inf removes the lower or upper limit, respectively. Specifying range as null will set the range to (-inf, inf).

Parameters:

range - theta range limits for this joint

setThetaRange

public void setThetaRange(double min,
                          double max)

Sets the theta range limits for this joint. This is a convenience wrapper for setThetaRange(DoubleInterval).

Parameters:

min - minimum theta value

max - maximum theta value

setMaxTheta

public void setMaxTheta(double max)

Sets the upper theta range limit for this joint, in degrees. Setting a value of inf removes the upper limit.

Parameters:

max - upper theta range limit

setMinTheta

public void setMinTheta(double min)

Sets the lower theta range limit for this joint, in degrees. Setting a value of -inf removes the lower limit.

Parameters:

min - lower theta range limit

getPlaneSize

public double getPlaneSize()

Queries the size used to render this joint's tangent plane as a square.

Returns:

size used to render the plane

setPlaneSize

public void setPlaneSize(double size)

Sets the size used to render this joint's tangent plane as a square.

Parameters:

size - used to render the plane

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 RenderableComponentBase

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 BodyConnector

Parameters:

list - list of objects to be rendered

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 BodyConnector

Parameters:

pmin - minimum point

pmax - maximum point

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 BodyConnector

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.