SimTK::MobilizedBody::Ellipsoid Class Reference

Three mobilities -- coordinated rotation and translation along the surface of an ellipsoid fixed to the parent (inboard) body. More...

#include <MobilizedBody.h>

Inheritance diagram for SimTK::MobilizedBody::Ellipsoid:

List of all members.

Public Member Functions
	Ellipsoid (Direction=Forward)
	The ellipsoid is placed on the mobilizer's inboard frame F, with half-axis dimensions along F's x,y,z respectively.
	Ellipsoid (MobilizedBody &parent, const Body &, Direction=Forward)
	By default the parent body frame and the body's own frame are used as the inboard and outboard mobilizer frames, resp.
	Ellipsoid (MobilizedBody &parent, const Transform &inbFrame, const Body &, const Transform &outbFrame, Direction=Forward)
	Use this constructor to specify mobilizer frames which are not coincident with the body frames.
	Ellipsoid (MobilizedBody &parent, const Transform &inbFrame, const Body &, const Transform &outbFrame, const Vec3 &radii, Direction=Forward)
	Use this constructor to specify mobilizer frames which are not coincident with the body frames, and give the radii at the same time.
Ellipsoid &	addBodyDecoration (const Transform &X_BD, const DecorativeGeometry &g)
	Add decorative geometry specified relative to the new (outboard) body's reference frame B, or to the outboard mobilizer frame M attached to body B, or to the inboard mobilizer frame F attached to the parent body P.
Ellipsoid &	addOutboardDecoration (const Transform &X_MD, const DecorativeGeometry &g)
	Add decorative geometry specified relative to the outboard mobilizer frame M attached to body B.
Ellipsoid &	addInboardDecoration (const Transform &X_FD, const DecorativeGeometry &g)
	Add decorative geometry specified relative to the inboard mobilizer frame F attached to the parent body P.
Ellipsoid &	setDefaultInboardFrame (const Transform &X_PF)
	Change this mobilizer's frame F on the parent body P.
Ellipsoid &	setDefaultOutboardFrame (const Transform &X_BM)
	Change this mobilizer's frame M fixed on this (the outboard) body B.
Ellipsoid &	setDefaultRotation (const Rotation &R_FM)
Rotation	getDefaultRotation () const
Ellipsoid &	setDefaultRadii (const Vec3 &r)
const Vec3 &	getDefaultRadii () const
const Quaternion &	getDefaultQ () const
Quaternion &	updDefaultQ ()
Ellipsoid &	setDefaultQ (const Quaternion &q)
const Vec4 &	getQ (const State &) const
const Vec4 &	getQDot (const State &) const
const Vec4 &	getQDotDot (const State &) const
const Vec3 &	getU (const State &) const
const Vec3 &	getUDot (const State &) const
void	setQ (State &, const Vec4 &) const
void	setU (State &, const Vec3 &) const
const Vec4 &	getMyPartQ (const State &, const Vector &qlike) const
const Vec3 &	getMyPartU (const State &, const Vector &ulike) const
Vec4 &	updMyPartQ (const State &, Vector &qlike) const
Vec3 &	updMyPartU (const State &, Vector &ulike) const
	SimTK_INSERT_DERIVED_HANDLE_DECLARATIONS (Ellipsoid, EllipsoidImpl, MobilizedBody)

---

Detailed Description

Three mobilities -- coordinated rotation and translation along the surface of an ellipsoid fixed to the parent (inboard) body.

The generalized coordinates are the same as for a Ball (Orientation) joint, that is, a quaternion or 1-2-3 Euler sequence.

---

Constructor & Destructor Documentation

SimTK::MobilizedBody::Ellipsoid::Ellipsoid

(

Direction

= Forward

)

[explicit]

The ellipsoid is placed on the mobilizer's inboard frame F, with half-axis dimensions along F's x,y,z respectively.

SimTK::MobilizedBody::Ellipsoid::Ellipsoid	(	MobilizedBody &	parent,
		const Body &	,
		Direction	= Forward
	)

By default the parent body frame and the body's own frame are used as the inboard and outboard mobilizer frames, resp.

SimTK::MobilizedBody::Ellipsoid::Ellipsoid	(	MobilizedBody &	parent,
		const Transform &	inbFrame,
		const Body &	,
		const Transform &	outbFrame,
		Direction	= Forward
	)

Use this constructor to specify mobilizer frames which are not coincident with the body frames.

SimTK::MobilizedBody::Ellipsoid::Ellipsoid	(	MobilizedBody &	parent,
		const Transform &	inbFrame,
		const Body &	,
		const Transform &	outbFrame,
		const Vec3 &	radii,
		Direction	= Forward
	)

Use this constructor to specify mobilizer frames which are not coincident with the body frames, and give the radii at the same time.

---

Member Function Documentation

Ellipsoid& SimTK::MobilizedBody::Ellipsoid::addBodyDecoration	(	const Transform &	X_BD,
		const DecorativeGeometry &	g
	)		[inline]

Add decorative geometry specified relative to the new (outboard) body's reference frame B, or to the outboard mobilizer frame M attached to body B, or to the inboard mobilizer frame F attached to the parent body P.

Note that the body itself may already have had some decorative geometry on it when it was first put into this MobilizedBody; in that case this just adds more.

Reimplemented from SimTK::MobilizedBody.

Ellipsoid& SimTK::MobilizedBody::Ellipsoid::addOutboardDecoration	(	const Transform &	X_MD,
		const DecorativeGeometry &
	)		[inline]

Add decorative geometry specified relative to the outboard mobilizer frame M attached to body B.

If body B already has decorative geometry on it, this just adds some more.

Reimplemented from SimTK::MobilizedBody.

Ellipsoid& SimTK::MobilizedBody::Ellipsoid::addInboardDecoration	(	const Transform &	X_FD,
		const DecorativeGeometry &
	)		[inline]

Add decorative geometry specified relative to the inboard mobilizer frame F attached to the parent body P.

If body P already has decorative geometry on it, this just adds some more.

Reimplemented from SimTK::MobilizedBody.

Ellipsoid& SimTK::MobilizedBody::Ellipsoid::setDefaultInboardFrame

(

const Transform &

X_PF

)

[inline]

Change this mobilizer's frame F on the parent body P.

Calling this method invalidates the MobilizedBody's topology, so the containing matter subsystem's realizeTopology() method must be called again. A reference to this MobilizedBody is returned so that this can be chained like an assignment operator.

Reimplemented from SimTK::MobilizedBody.

Ellipsoid& SimTK::MobilizedBody::Ellipsoid::setDefaultOutboardFrame

(

const Transform &

X_BM

)

[inline]

Change this mobilizer's frame M fixed on this (the outboard) body B.

Calling this method invalidates the MobilizedBody's topology, so the containing matter subsystem's realizeTopology() method must be called again. A reference to this MobilizedBody is returned so that this can be chained like an assignment operator.

Reimplemented from SimTK::MobilizedBody.

Ellipsoid& SimTK::MobilizedBody::Ellipsoid::setDefaultRotation

(

const Rotation &

R_FM

)

[inline]

Rotation SimTK::MobilizedBody::Ellipsoid::getDefaultRotation

(

)

const [inline]

Ellipsoid& SimTK::MobilizedBody::Ellipsoid::setDefaultRadii

(

const Vec3 &

r

)

const Vec3& SimTK::MobilizedBody::Ellipsoid::getDefaultRadii

(

)

const

const Quaternion& SimTK::MobilizedBody::Ellipsoid::getDefaultQ

(

)

const

Quaternion& SimTK::MobilizedBody::Ellipsoid::updDefaultQ

(

)

Ellipsoid& SimTK::MobilizedBody::Ellipsoid::setDefaultQ

(

const Quaternion &

q

)

[inline]

const Vec4& SimTK::MobilizedBody::Ellipsoid::getQ

(

const State &

)

const

const Vec4& SimTK::MobilizedBody::Ellipsoid::getQDot

(

const State &

)

const

const Vec4& SimTK::MobilizedBody::Ellipsoid::getQDotDot

(

const State &

)

const

const Vec3& SimTK::MobilizedBody::Ellipsoid::getU

(

const State &

)

const

const Vec3& SimTK::MobilizedBody::Ellipsoid::getUDot

(

const State &

)

const

void SimTK::MobilizedBody::Ellipsoid::setQ	(	State &	,
		const Vec4 &
	)		const

void SimTK::MobilizedBody::Ellipsoid::setU	(	State &	,
		const Vec3 &
	)		const

const Vec4& SimTK::MobilizedBody::Ellipsoid::getMyPartQ	(	const State &	,
		const Vector &	qlike
	)		const

const Vec3& SimTK::MobilizedBody::Ellipsoid::getMyPartU	(	const State &	,
		const Vector &	ulike
	)		const

Vec4& SimTK::MobilizedBody::Ellipsoid::updMyPartQ	(	const State &	,
		Vector &	qlike
	)		const

Vec3& SimTK::MobilizedBody::Ellipsoid::updMyPartU	(	const State &	,
		Vector &	ulike
	)		const

SimTK::MobilizedBody::Ellipsoid::SimTK_INSERT_DERIVED_HANDLE_DECLARATIONS	(	Ellipsoid	,
		EllipsoidImpl	,
		MobilizedBody
	)

---

The documentation for this class was generated from the following file:

• MobilizedBody.h