SimMechanics™

Rendering Body Shapes

About Body Shapes

You can choose how the visualization window renders the bodies; see Choosing the Body Shape. There are two available rendering shapes:

• Equivalent ellipsoid for each body, based on its mass properties and center of gravity (CG) position, explained in Equivalent Ellipsoids

• Convex hull for each body, based on its Body coordinate systems (CSs), explained in Convex Hulls

Back to Top

Choosing the Body Shape

You choose the body rendering in the SimMechanics™ toolbar of the SimMechanics visualization window. You can render the bodies of your machine with either convex hulls, or ellipsoids, or both. See Introducing the SimMechanics™ Visualization Window in this chapter for visualization control details.

Back to Top

Equivalent Ellipsoids

The inertia tensor I of a rigid body is real and symmetric, so it has three real eigenvalues (I₁, I₂, I₃) and three orthogonal eigenvectors. These eigenvectors are the principal axes of the body. In the coordinate system defined by those axes, the inertia tensor is diagonal. The trace of the inertia tensor, Tr(I) = I₁+ I₂ + I₃, is the same in any coordinate system with its origin at the body's center of gravity (CG).

Every rigid body has a unique equivalent ellipsoid, a homogeneous solid ellipsoid of the same inertia tensor. The ellipsoid surface is given by

The three parameters (a_x, a_y, a_z) are the generalized radii of the ellipsoid. For axis i = 1,2,3,

Triangle Inequalities

The principal moments (I₁, I₂, I₃) must satisfy the triangle inequalities:

Violation of the triangle inequality for I_i leads to an unphysical imaginary generalized radius a_i.

Caution   Visualizing the equivalent ellipsoid of a body whose principal moments do not satisfy the triangle inequalities leads to a SimMechanics warning indicating that one or more triangle inequalities have been violated. The simulation continues, but the body in violation is not displayed.

Ellipsoids with Special Symmetry

In general, all three I_i, i = 1,2,3, are unequal. Such a body is an asymmetric top. If two of the three I_i are equal (double degeneracy), the body is a symmetric top. The third axis is the axis of symmetry. If all three I_i are equal (triple degeneracy), the body is a spherical top and dynamically equivalent to a homogeneous sphere.

Reduced-Dimension Ellipsoids

In special cases, the equivalent ellipsoid reduces to a planar, linear, or point figure.

Let (i,j,k) label the three axes (1,2,3) = (x,y,z) in any order.

• For a true ellipsoid, with nonzero volume, all the a_i are nonzero. The triangle inequalities are strict inequalities in this case:

  

• For an ellipse, with zero volume but nonzero area, one a_i = 0 and the other two a_j, a_k are nonzero. One of the triangle inequalities becomes an equality:

  

• For a line, with zero volume and area but nonzero length, two a_i, a_j = 0 and the third a_k is nonzero. Two of the triangle inequalities become equalities:

  

  Equivalently, I_i = I_j are nonzero and I_k = 0.

• For a point, with no spatial size, all three a_i vanish. All three triangle inequalities become equalities:

  

  Equivalently, all three I_i vanish.

Example: Simple Pendulum Rod

Consider the simple pendulum rod in Visualizing a Simple Mechanical Model in the Visualizing and Animating Machines chapter. You can open the model by entering mech_spen at the command line.

The rod length L = 1 m, and its radius r = 1 cm. The inertia tensor is

Because the rod has an axis of symmetry, the x-axis in this case, two of its three principal moments are equal: I_yy = I_zz, and two of its three generalized radii are equal: a_y = a_z. The rod is a symmetric top and, since r is much smaller than L, its equivalent ellipsoid is almost a line of zero volume and area.

The generalized radii of the equivalent ellipsoid are a_x = = 0.646 m and a_y = a_z = = 1.12 cm. This is the rod so rendered:

Back to Top

Convex Hulls

Every Body has at least one Body coordinate system (CS) at the CG. A Body also has one or more extra Body CSs for the attached Joints, as well as possible Actuators and Sensors. Each Body CS has an origin point, and the collection of all these points, in general, defines a volume in space. The minimum outward-bending surface enclosing such a volume is the convex hull of the Body CSs, and this is the alternative SimMechanics body rendering.

To enclose a nonzero volume, the set must have at least four non-coplanar Body CSs. Three non-collinear Body CSs are rendered instead by a triangle, and two non-coincident origins by a line. One is displayed just as a point. (The minimum one Body CS would be just the CG CS.) Four or more coplanar origins are rendered by a triangle, three or more collinear origins are rendered by a line, and two or more coincident origins are rendered by a point.

Example: Four-Cylinder Engine Crank

Refer to the four-cylinder engine model of the Demos library by entering mech_fceng at the command line.

Double-click the Engine Block subsystem and note the Crank block representing the engine crank. This Body block has six Body CSs. Visualize the engine as convex hulls with the SimMechanics visualization window. The large block in your visualization is this engine crank, and it encloses a nonzero volume.

Four Cylinder Engine Example: Engine Crank Convex Hull (Yellow)

Back to Top

About SimMechanics™ Visualization

Introducing the SimMechanics™ Visualization Window