Main Content

Variable Mass

Time-varying mass specified as physical signal input


Inertias & Loads

  • Variable Mass block


This block models the effects of a time-varying mass. Components with variable mass include fuel tanks with progressively lower fuel contents. A physical signal input port provides the instantaneous mass at each time step throughout simulation. To minimize solver errors, avoid discontinuities and abrupt changes in the input signal.

As the component mass changes, so does the inertial force acting on that component:



  • FI is the inertial force.

  • m is the variable mass.

  • v is the velocity of the mass.

The physical signal input saturates at the minimum mass specified in the block property inspector. Whenever the input falls below the minimum mass, the block performs its calculations on the minimum mass instead. The inertial force becomes:



  • mMin is the minimum mass allowed.

The linear momentum of the variable mass is conserved. In the absence of external forces, a decrease in mass leads to a proportional increase in linear velocity. The linear momentum remains constant until a net external force causes it to change.


Use the Variables tab to set the priority and initial target values for the block variables before simulating. For more information, see Set Priority and Initial Target for Block Variables.


The block has one conserving translational port and one physical signal input port. The conserving translational port identifies the driveline component whose mass varies with time. The physical signal input port provides the means to specify the mass as a function of time.


Minimum mass

Lowest value that the variable mass can take on during simulation. The physical signal input saturates at this value. If the input falls below the minimum mass, it is set equal to the minimum mass value. The default value is 0.1 kg.

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.

Version History

Introduced in R2015b