massDistribution

R2026b

Class: simscape.multibody.GeneralSolid
Namespace: simscape.multibody

Extract mass distribution of GeneralSolid object

Since R2026b

Syntax

md = massDistribution(solid)

Description

md = massDistribution(solid) extracts the mass distribution of the specified solid and returns the result as a simscape.multibody.MassDistribution object. The returned values are always in SI units regardless of the units used to define the solid properties.

Input Arguments

solid — Solid

simscape.multibody.GeneralSolid object

Solid, specified as a simscape.multibody.GeneralSolid object.

Output Arguments

md — Mass distribution

simscape.multibody.MassDistribution object

Mass distribution of the solid relative to its reference frame R, returned as a simscape.multibody.MassDistribution object.

Attributes

Access

public

To learn about attributes of methods, see Method Attributes.

Examples

Extract Mass Distribution of a Solid

This example shows how to create a solid and extract its mass distribution.

Create a solid with a cylinder geometry and specified inertia properties.

cyl = simscape.multibody.Cylinder(simscape.Value(0.02,"m"), ...
    simscape.Value(0.5,"m"));
inertia = simscape.multibody.GeneralInertia( ...
    simscape.Value(2.5,"kg"), ...
    simscape.Value([0.1 0 0],"m"), ...
    simscape.Value([0.04 0.05 0.06],"kg*m^2"), ...
    simscape.Value([0 0 0],"kg*m^2"));
solid = simscape.multibody.GeneralSolid(cyl,inertia);

Extract the mass distribution of the solid.

md = massDistribution(solid)

md =
  MassDistribution with properties:

                 Mass: 2.5000 (kg)
         CenterOfMass: [0.1000 0 0] (m)
     MomentsOfInertia: [0.0400 0.0500 0.0600] (kg*m^2)
    ProductsOfInertia: [0 0 0] (kg*m^2)

Version History

Introduced in R2026b