# Variable Cylindrical Solid

Solid cylinder with variable mass and size

• Library:
• Simscape / Multibody / Body Elements / Variable Mass

## Description

The Variable Cylindrical Solid block adds to the attached frame a solid cylinder with variable mass and side. The mass, radius, and length of the cylinder can each be constant or vary with time. A variable quantity can be specified directly as a physical signal or it can be calculated as a function of the remaining quantities. Either the mass or the cylinder dimensions can be calculated during simulation, but not both simultaneously.

A reference frame encodes the position and orientation of the solid in a model. The frame is fixed to the solid with the frame origin at the center of the lower surface (as observed with a `Z up` view convention). This placement is preserved throughout simulation. Length increases asymmetrically relative to the lower surface, along the positive direction of the z-axis.

Variable Cylinder with Length Calculated from Mass

Visualization is dynamic. Solid dimensions update continuously as they occur, in the visualization pane of Mechanics Explorer. The initial dimensions of the solid depend on the parameters and physical signals that you specify. It is possible for a variable dimension to begin with a zero value—for example, if it derives from a physical signal whose initial value is zero also.

Density can itself be constant or variable. This quantity is specified as a constant if at least one solid parameter is calculated during simulation. It is calculated as a variable if all solid parameters are explicitly specified, either as (constant) block parameters or as physical signals. As in the case of the solid blocks, you can specify a negative density, for example, to model voids in compound bodies.

## Ports

### Frame

expand all

Local reference frame of the solid. This frame is fixed with respect to the solid geometry. The frame origin is on the xy-plane at the center of the xy cross-section. The z-axis aligns with the longitudinal axis of the cylinder. Connect this port to a frame entity—port, line, or junction—to resolve the frame placement in a model. For more information, see Working with Frames.

### Physical Signal Input

expand all

Input port for the length of the cylinder.

Input port for the radius of the cylinder.

Input port for the mass of the cylinder.

### Physical Signal Output

expand all

Output port for the length of the cylinder.

Output port for the width of the cylinder.

Output port for the mass of the cylinder.

Output port for the center of mass of the cylinder, reported as a three-element vector with Cartesian coordinates resolved in the reference frame of the solid.

Output port for the inertia matrix of the cylinder, reported as a nine-element matrix, resolved in the reference frame of the block. The diagonal matrix elements are the moments of inertia. The off-diagonal elements are the products of inertia.

## Parameters

expand all

Geometry and Inertia

Parameterization of the radius of the solid. Select `Constant` to specify a fixed value as a block parameter. Select `Provided by Input` to specify a variable value as a physical signal input. Use the default setting (`Calculated from Mass`) to obtain this parameter from the specified solid density and remaining dimensions. Selecting `Provided by Input` exposes a new physical signal input port, labeled r, through which to specify the variable value.

Radius of the solid. The longitudinal axis of the solid is aligned with the z-axis of the local reference frame. The z dimension is constant when this block parameter is active.

#### Parameter Dependencies

This parameter is active when the Radius parameter is set to `Constant`.

Parameterization of the length of the solid. Select `Constant` to specify a fixed value as a block parameter. Select `Provided by Input` to specify a variable value as a physical signal input. Use the default setting (`Calculated from Mass`) to obtain this parameter from the specified solid density and remaining dimensions. Selecting `Provided by Input` exposes a new physical signal input port, labeled len, through which to specify the variable value.

Length of the solid. The longitudinal axis of the cylinder is aligned with the z-axis of the local reference frame. The z dimension is constant when this block parameter is active.

#### Parameter Dependencies

This parameter is active when the Length parameter is set to `Constant`.

Parameterization of the mass of the solid. Select ```Calculate from Geometry``` to obtain this parameter from the specified solid density and dimensions. Use the default setting (```Provided by Input```) to specify this parameter directly as a time-variable physical signal. This option exposes a new physical signal input port, labeled M, through which to specify the time-variable solid mass.

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. The default value, ```1000 kg/m^3```, is characteristic of polymers such as ABS plastic.

#### Parameter Dependencies

This parameter is active when the Mass parameter is set to `Calculate from Geometry`.

Sensing

Sensing selection for the radius of the solid. Check to expose a new physical signal output port, labeled r, through which to output the time-varying value of the radius.

Sensing selection for the z dimension of the solid. Check to expose a new physical signal output port, labeled len, through which to output the time-varying value of the length.

Sensing selection for the total mass of the solid. Check to expose a new physical signal output port, labeled m, through which to output the time-varying value of the solid mass.

Sensing selection for the coordinates of the center of mass of the solid. Check to expose a new physical signal output port, labeled com, through which to output the time-varying coordinates. The output is a three-element vector with Cartesian coordinates resolved in the reference frame of the solid.

Sensing selection for the inertia matrix of the solid. Check to expose a new physical signal output port, labeled I, through which to output the time-varying inertia matrix. The output is a nine-element matrix with the moments of inertia in the diagonal positions and the products of inertia in the off-diagonal positions. The moments and products of inertia are resolve in the inertia frame of resolution—a frame with axes parallel to those of the reference frame but origin at the center of mass.

### Graphic

Type of the visual representation of the solid, specified as `From Geometry`, `Marker`, or `None`. Set the parameter to `From Geometry` to show the visual representation of the solid. Set the parameter to `Marker` to represent the solid as a marker. Set the parameter to `None` to hide the solid in the model visualization.

Parameterizations for specifying visual properties. Select `Simple` to specify Diffuse Color and Opacity. Select `Advanced` to specify more visual properties, such as Specular Color, Ambient Color, Emissive Color, and Shininess.

#### Dependencies

To enable this parameter, set Type to ```From Geometry``` or `Marker`.

Shape of the marker by means of which to visualize the solid. The motion of the marker reflects the motion of the solid itself.

#### Dependencies

To enable this parameter, set Type to `Marker`.

Width of the marker in pixels. This width does not scale with zoom level. Note that the apparent size of the marker depends partly on screen resolution, with higher resolutions packing more pixels per unit length, and therefore producing smaller icons.

#### Dependencies

To enable this parameter, set Type to `Marker`.

Color of the light due to diffuse reflection, specified as an [R,G,B] or [R,G,B,A] vector with values in the range of 0 to 1. The vector can be a row or column vector. The optional fourth element specifies the color opacity. Omitting the opacity element is equivalent to specifying a value of 1.

The diffuse color reflects the main color of the rendered solid and provides shading that gives the rendered object a three-dimensional appearance.

#### Dependencies

To enable this parameter, set:

1. Type to `From Geometry` or `Marker`

2. Visual Properties to `Advanced`

Graphic opacity, specified as a scalar in the range of 0 to 1. A scalar of 0 corresponds to completely transparent, and a scalar of 1 corresponds to completely opaque.

#### Dependencies

To enable this parameter, set:

1. Type to `From Geometry` or `Marker`

2. Visual Properties to `Simple`

Color of the light due to specular reflection, specified as an [R,G,B] or [R,G,B,A] vector with values in the range of 0 to 1. The vector can be a row or column vector. The optional fourth element specifies the color opacity. Omitting the opacity element is equivalent to specifying a value of 1. This parameter changes the color of the specular highlight, which is the bright spot on the rendered solid due to the reflection of the light from the light source.

#### Dependencies

To enable this parameter, set:

1. Type to `From Geometry` or `Marker`

2. Visual Properties to `Advanced`

Color of the ambient light, specified as an [R,G,B] or [R,G,B,A] vector with values in the range of 0 to 1. The vector can be a row or column vector. The optional fourth element specifies the color opacity. Omitting the opacity element is equivalent to specifying a value of 1.

Ambient light refers to a general level of illumination that does not come directly from a light source. The Ambient light consists of light that has been reflected and re-reflected so many times that it is no longer coming from any particular direction. You can adjust this parameter to change the shadow color of the rendered solid.

#### Dependencies

To enable this parameter, set:

1. Type to `From Geometry` or `Marker`

2. Visual Properties to `Advanced`

Color due to self illumination, specified as an [R,G,B] or [R,G,B,A] vector in the range of 0 to 1. The vector can be a row or column vector. The optional fourth element specifies the color opacity. Omitting the opacity element is equivalent to specifying a value of 1.

The emission color is color that does not come from any external source, and therefore seems to be emitted by the solid itself. When a solid has a emissive color, the solid can be seen even if there is no external light source.

#### Dependencies

To enable this parameter, set:

1. Type to `From Geometry` or `Marker`

2. Visual Properties to `Advanced`

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.

#### Dependencies

To enable this parameter, set:

1. Type to `From Geometry` or `Marker`

2. Visual Properties to `Advanced`

## Version History

Introduced in R2017b