MASS

Mass

Mechanics
Run the live example Free · no sign-up · runs in your browser

The Mass block models a rigid 1D body moving with linear velocity and storing kinetic energy. It represents moving carriages, vehicle bodies, elevator cabins, and hydraulic cylinder loads in 1D mechanical translational networks.

It features a conserving translational terminal (flange) carrying linear velocity across and transmitting force through the connection axis.

Real-World Analog: Represents a linear sliding carriage, machine tool gantry, vehicle body, or payload block accelerating under net forces.

Mathematical Model

The dynamic behavior is governed by Newton's second law of motion:

mdvdt=∑Fm \frac{dv}{dt} = \sum F

Where:

  • m is the mass in kilograms (kg\text{kg}).
  • v is the linear velocity in meters per second (m/s\text{m/s}).
  • \sum F is the net external force applied to the mass in Newtons (N\text{N}).

The kinetic energy stored in the body is:

Ek=12mv2E_k = \frac{1}{2} m v^2

Inputs & Outputs

Direction ID Label Type Status
→ In flange F number Required
→ In H H number Optional
← Out q_diss Q_diss number Output

Parameters

Parameters Label Type Default Description
mass Mass (m) number 1 Translational mass m in kilograms
initial_velocity Initial Velocity (v0) number 0 Initial velocity at t=0 in m/s
incline_angle Incline Angle (θ) number 0 Incline tilt angle in degrees (creates gravity downhill force F_g = -m·g·sin(θ))
drag_coefficient Aerodynamic Drag (0.5·ρ·Cd·A) number 0 Aerodynamic drag factor c_drag in N·s²/m² (0 = lossless/vacuum)

Usage Examples

Free Rundown with Linear Damper

A moving mass slows down smoothly through viscous friction against a stationary base:

Mass(m=2.0, v0=10.0) -> TranslationalDamper(d=4.0) -> TranslationalReference

Driven Mass with Constant Force

A constant force accelerates a mass resisted by viscous friction to a steady-state velocity vss=F/dv_{ss} = F / d:

ForceSource(force=20.0) -> Mass(m=2.5) -> TranslationalDamper(d=5.0) -> TranslationalReference

Remarks & Best Practices

  • Inertial Reference: The mass terminal velocity is measured with respect to the absolute stationary inertial reference frame (0 m/s0\text{ m/s}).
  • Bond Graph Equivalence: Acts as an ideal Generalized Inertia (I-element) or capacitor in MNA force-current analogy.
  • Algebraic Loop Prevention: Acts as a state integrator, breaking algebraic circular dependencies in mechanical kinematic chains.
  • Symplectic Energy Conservation: Solved with implicit TR-BDF2 or RK4 without numerical artificial damping.

Related Components