#### Geometry

`Shape`

— Geometrical shape of the solid element

Brick (default) | Cylinder | Sphere | Ellipsoid | Regular Extrusion | General Extrusion | Revolution | From File

Geometrical shape of the solid element:

`Cylinder`

— Cylindrical
shape with geometry center coincident with the reference frame origin
and symmetry axis coincident with the reference frame z axis.

`Sphere`

— Spherical
shape with geometry center coincident with the reference frame origin.

`Brick`

— Prismatic
shape with geometry center coincident with the reference frame origin
and prismatic surfaces normal to the reference frame x, y, and z axes.

`Ellipsoid`

— Three-dimensional
extension of the ellipse with geometry center coincident with the
reference frame origin and semi-principal axes coincident with the
reference frame x, y, and z axes.

`Regular Extrusion`

—
Translational sweep of a regular polygon cross section with geometry
center coincident with the reference frame origin and extrusion axis
coincident with the reference frame z axis.

`General Extrusion`

—
Translational sweep of a general cross section with geometry center
coincident with the [0 0] coordinate on the cross-sectional XY plane
and extrusion axis coincident with the reference frame z axis.

`Revolution`

— Rotational
sweep of a general cross section with geometry center coincident with
the [0 0] coordinate on the cross-sectional XZ plane and revolution
axis coincident with the reference frame z axis.

`From File`

— Imported
custom shape with geometry center and orientation as defined in STL
or STEP geometry file.

`Cylinder: Radius`

— Radial distance from the longitudinal axis to the curved surface

1 m (default)

Distance *R* in the figure, specified as a
scalar in terms of the selected physical units.

`Cylinder: Length`

— Longitudinal distance between the cylinder flat ends

1 m (default)

Distance *L* in the figure, specified as a
scalar in terms of the selected physical units.

`Sphere: Radius`

— Distance from the origin of the sphere to its surface

1 m (default)

Distance *R* in the figure, specified as a
scalar in terms of the selected physical units.

`Brick: Dimensions`

— Brick dimensions along the reference frame x, y, and z axes

[1 1 1] m (default)

Dimensions *x*, *y*, and *z* in
the figure, specified in this order as a three-element vector in terms
of the selected physical units.

`Ellipsoid: Radii`

— Ellipsoid dimensions along the x, y, and z semi-principal axes

[1,1,1] m (default)

Dimensions *x*, *y*, and *z* in
the figure, specified in this order as a three-element vector in terms
of the selected physical units. The ellipsoid reduces to a sphere
when all three radii have the same have.

`Regular Extrusion: Number of Sides`

— Number of edges in the regular polygon cross section

3 (default)

Edge count of the polygon cross section, specified as a scalar
number greater than `2`

. The default value of `3`

corresponds
to a triangle, the polygon with the lowest possible number of sides.
The figure shows a regular extrusion with a pentagon for cross section.

`Regular Extrusion: Outer Radius`

— Radial distance from the polygon center to a polygon vertex

1 m (default)

Distance *R* in the figure, specified as a
scalar in terms of the selected physical units. The enveloping circle
highlights the relationship between the outer circle radius and the
polygon center-to-vertex distance.

`Regular Extrusion: Length`

— Longitudinal distance between the extrusion terminal ends

1 m (default)

Distance *L* in the figure, specified as a
scalar in terms of the selected physical units.

`General Extrusion: Cross-section`

— Cross-section coordinates specified on the XY plane

[1 1; -1 1; -1 -1; 1 -1] (default)

Cross-sectional shape specified as an [x,y] coordinate matrix,
with each row corresponding to a point on the cross-sectional profile.
The coordinates specified must define a closed loop with no self-intersecting
segments.

The coordinates must be arranged such that from one point to
the next the solid region always lies to the left. The block extrudes
the cross-sectional shape specified along the z axis to obtain the
extruded solid.

`General Extrusion: Length`

— Sweep angle of the general extrusion

1 m (default)

Distance to sweep the extrusion cross section by. The block
extrudes the cross section by half the extrusion length along the
+z axis and by half along the -z axis.

`Revolution: Cross-section`

— Cross-section coordinates specified on the XZ plane

[1 1; 1 -1; 2 -1; 2 1] m (default)

Cross-sectional shape specified as an [x,z] coordinate matrix,
with each row corresponding to a point on the cross-sectional profile.
The coordinates specified must define a closed loop with no self-intersecting
segments.

The coordinates must be arranged such that from one point to
the next the solid region always lies to the left. The block revolves
the cross-sectional shape specified about the reference frame z axis
to obtain the revolved solid.

`Revolution: Extent of Revolution`

— Choice of full or partial revolution sweeps

Full (default) | Custom

Type of revolution sweep to use. Use the default setting of `Full`

to
revolve the cross-sectional shape by the maximum 360 degrees. Select `Custom`

to
revolve the cross-sectional shape by a lesser angle.

`Revolution: Revolution Angle`

— Sweep angle of a partial revolution

`180`

(default) | Scalar number in the specified units

Angle to sweep a partial revolution cross section by. The block
revolves the specified cross section by half the revolution angle
in the clockwise direction and by half in the counterclockwise direction.

`From File: File Type`

— Geometry file type to import

STEP (default) | STL

Geometry file type to import. The block provides automatic inertia
calculation from geometry for STEP files only. For STL geometry files,
you must manually enter the solid inertia using the `Custom`

or ```
Point
Mass
```

parameterization.

`From File: File Name`

— Geometry file name

Character vector with the geometry file name

Geometry file name, complete with path and extension—e.g.,
‘C:/Users/Jdoe/Documents/myShape.STEP'

`From File: Units`

— STL file unit of length

m (default) | cm | mm | km | in | ft | yd | mi

Unit of length for STL file coordinates.

#### Inertia

`Type`

— Inertia parameterization to use

Calculate from Geometry (default) | Point Mass | Custom

Inertia parameterization to use. Select `Point Mass`

to
model a concentrated mass with negligible rotational inertia. Select `Custom`

to
model a distributed mass with the specified moments and products of
inertia. The default setting, `Calculate from Geometry`

,
enables the block to automatically calculate the rotational inertia
properties from the solid geometry and specified mass or mass density.

`Based on`

— Parameter to base inertia calculation on

Density (default) | Mass

Parameter to use in inertia calculation. The block obtains the
inertia tensor from the solid geometry and the parameter selected.
Use `Density`

if the material properties
are known. Use `Mass`

if the total solid
mass if known.

`Density`

— Mass per unit volume of material

1000 kg/m^3 (default)

Mass per unit volume of material. The mass density can take
on a positive or negative value. Specify a negative mass density to
model the effects of a void or cavity in a solid body.

`Mass`

— Aggregate mass of the solid

1 kg (default)

Aggregate mass of the solid. The mass can be a positive or negative
value. Specify a negative mass to model the aggregate effect of voids
and cavities in a compound body.

`Custom: Center of Mass`

— Center-of-mass coordinates

[0 0 0] m (default)

[x y z] coordinates of the center of mass relative to the block
reference frame. The center of mass coincides with the center of gravity
in uniform gravitational fields only.

`Custom: Moments of Inertia`

— Diagonal elements of inertia tensor

[1 1 1] kg*m^2 (default)

Three-element vector with the [I_{xx} I_{yy} I_{zz}]
moments of inertia specified relative to a frame with origin at the
center of mass and axes parallel to the block reference frame. The
moments of inertia are the diagonal elements of the inertia tensor

$$\left(\begin{array}{ccc}{I}_{xx}& & \\ & {I}_{yy}& \\ & & {I}_{zz}\end{array}\right),$$

where:

$${I}_{xx}={\displaystyle \underset{V}{\int}\left({y}^{2}+{z}^{2}\right)\text{\hspace{0.17em}}dm}$$

$${I}_{yy}={\displaystyle \underset{V}{\int}\left({x}^{2}+{z}^{2}\right)\text{\hspace{0.17em}}dm}$$

$${I}_{zz}={\displaystyle \underset{V}{\int}\left({x}^{2}+{y}^{2}\right)\text{\hspace{0.17em}}dm}$$

`Custom: Products of Inertia`

— Off-diagonal elements of inertia tensor

[0 0 0] kg*m^2 (default)

Three-element vector with the [I_{yz} I_{zx} I_{xy}]
products of inertia specified relative to a frame with origin at the
center of mass and axes parallel to the block reference frame. The
products of inertia are the off-diagonal elements of the inertia tensor

$$\left(\begin{array}{ccc}& {I}_{xy}& {I}_{zx}\\ {I}_{xy}& & {I}_{yz}\\ {I}_{zx}& {I}_{yz}& \end{array}\right),$$

where:

$${I}_{yz}=-{\displaystyle \underset{V}{\int}yz\text{\hspace{0.17em}}dm}$$

$${I}_{zx}=-{\displaystyle \underset{V}{\int}zx\text{\hspace{0.17em}}dm}$$

$${I}_{xy}=-{\displaystyle \underset{V}{\int}xy\text{\hspace{0.17em}}dm}$$

#### Graphic

`Type`

— Solid visualization setting

From Geometry (default) | Marker | None

Visualization setting for this solid. Use the default setting, ```
From
Geometry
```

, to show the solid geometry. Select `Marker`

to
show a graphic marker such as a sphere or frame. Select `None`

to
disable visualization for this solid.

`Marker: Shape`

— Shape of the graphic marker.

Sphere (default) | Cube | Frame

Geometrical shape of the graphic marker. Mechanics Explorer
shows the marker using the selected shape.

`Marker: Size`

— Pixel size of the graphic marker

10 (default)

Absolute size of the graphic marker in screen pixels. The marker
size is invariant with zoom level.

`Visual Properties`

— Parameterizations for color and opacity

Simple (default) | Advanced

Parameterization for specifying visual properties. Select `Simple`

to
specify color and opacity. Select `Advanced`

to
add specular highlights, ambient shadows, and self-illumination effects.

`Simple: Color`

— True color as [R,G,B] vector on 0–1 scale

[0.5 0.5 0.5] (default)

RGB color vector with red (R), green (G), and blue (B) color
amounts specified on a 0–1 scale. A color picker provides an
alternative interactive means of specifying a color. If you change
the **Visual Properties** setting to `Advanced`

,
the color specified in this parameter becomes the **Diffuse
Color** vector.

`Simple: Opacity`

— Surface opacity as scalar number on 0–1 scale

1.0 (default)

Graphic opacity specified on a scale of 0–1. An opacity
of `0`

corresponds to a completely transparent graphic
and an opacity of `1`

to a completely opaque graphic.

`Advanced: Diffuse Color`

— True color as [R,G,B,A] vector on 0–1 scale

[0.5 0.5 0.5] (default)

True color under direct white light specified as an [R,G,B]
or [R,G,B,A] vector on a 0–1 scale. An optional fourth element
specifies the color opacity also on a scale of 0–1. Omitting
the opacity element is equivalent to specifying a value of `1`

.

`Advanced: Specular Color`

— Highlight color as [R,G,B,A] vector on 0–1 scale

[0.5 0.5 0.5 1.0] (default)

Color of specular highlights specified as an [R,G,B] or [R,G,B,A]
vector on a 0–1 scale. The optional fourth element specifies
the color opacity. Omitting the opacity element is equivalent to specifying
a value of `1`

.

`Advanced: Ambient Color`

— Shadow color as [R,G,B,A] vector on 0–1 scale

[0.5 0.5 0.5 1.0] (default)

Color of shadow areas in diffuse ambient light, specified as
an [R,G,B] or [R,G,B,A] vector on a 0–1 scale. The optional
fourth element specifies the color opacity. Omitting the opacity element
is equivalent to specifying a value of `1`

.

`Advanced: Emissive Color`

— Self-illumination color as [R,G,B] vector on 0–1 scale

[0.5 0.5 0.5 1.0] (default)

Surface color due to self illumination, specified as an [R,G,B]
or [R,G,B,A] vector on a 0–1 scale. The optional fourth element
specifies the color opacity. Omitting the opacity element is equivalent
to specifying a value of `1`

.

`Advanced: Shininess`

— Highlight sharpness as scalar number on 0–128 scale

75 (default)

Sharpness of specular light reflections, specified as a scalar
number on a 0–128 scale. Increase the shininess value for smaller
but sharper highlights. Decrease the value for larger but smoother
highlights.

#### Frames

`Show Port R`

— Show the reference frame port for connection to other blocks

Checked (default) | Cleared

Clear the check box to hide the reference frame port in the
Solid block. Hiding the reference frame port suppresses the frame
visualization in Mechanics Explorer. You must expose the reference
frame port if the block has no custom frames.

`New Frame`

— Create a custom frame for connection to other blocks

Empty (default)

#### Frame Creation Interface

`Frame Name`

— MATLAB^{®} string used to identify the custom frame

Custom name

Frame identifier specified as a MATLAB string. This string
identifies the frame port in the block diagram and in the tree view
pane of Mechanics Explorer. Keep the frame name short to ensure it
fits in the block icon width.

`Frame Origin`

— Position of the custom frame origin

At Reference Frame Origin (default) | At Center of Mass | Based on Geometric Feature

Select the location of the frame origin. Options include:

**At Reference Frame Origin** —
Make the new frame origin coincident with the reference frame origin.
This is the default option.

**At Center of Mass** — Make
the new frame origin coincident with the solid center of mass. The
reference frame origin is located at the center of mass in symmetrical
shapes such as spheres and bricks but not in certain extrusions or
revolutions.

**Based on Geometric Feature** —
Place the new frame origin at the center of the selected geometry
feature. Valid geometry features include surfaces, lines, and points.
You must select a geometry feature from the visualization pane and
then select the **Use Selected Feature** button.
The name of the selected geometry feature appears in the field below
this option.

`Frame Axes: Primary Axis`

— Axis used to constrain the possible directions of the remaining frame axes

Along Reference Frame Axis (default) | Along Principal Inertia Axis | Based on Geometric Feature

Select the axis of the new frame that you want to set as the
primary axis. The primary axis constrains the possible orientations
of the remaining two axes. Specify the orientation of the primary
axis by selecting from the following options:

**Along Reference Frame Axis** —
Align the primary axis with the selected axis of the reference frame.

**Along Principal Inertia Axis** —
Align the primary axis with the selected principal inertia axis. The
principal inertia axes are those about which the products of inertia
are zero.

**Based on Geometric Feature** —
Align the primary axis with the vector associated with the selected
geometric feature. Valid geometric features include surfaces and lines.

`Frame Axes: Secondary Axis`

— Axis used to constrain the possible directions of the remaining frame axis

Along Reference Frame Axis (default) | Along Principal Inertia Axis | Based on Geometric Feature

Select the axis of the new frame that you want to set as the
secondary axis. The secondary axis is the projection of the selected
direction onto the normal plane of the primary axis. Select the direction
to project from the following options:

**Along Reference Frame Axis** —
Project the selected reference frame axis onto the normal plane of
the primary axis. Align the secondary axis with the projection.

**Along Principal Inertia Axis** —
Project the selected principal inertia axis onto the normal plane
of the primary axis. Align the secondary axis with the projection.
The principal inertia axes are those about which the products of inertia
are zero.

**Based on Geometric Feature** —
Project the vector associated with the selected geometry feature onto
the normal plane of the primary axis. Align the secondary axis with
the projection. Valid geometry features include surfaces and lines.
You must select a geometry feature from the visualization pane and
then select the **Use Selected Feature** button.