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:
Where:
mis the mass in kilograms ().vis the linear velocity in meters per second ().\sum Fis the net external force applied to the mass in Newtons ().
The kinetic energy stored in the body is:
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 :
ForceSource(force=20.0) -> Mass(m=2.5) -> TranslationalDamper(d=5.0) -> TranslationalReferenceRemarks & Best Practices
- Inertial Reference: The mass terminal velocity is measured with respect to the absolute stationary inertial reference frame ().
- 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
- TranslationalSpring: Linear compliant restoring spring element
- TranslationalDamper: Viscous friction and dashpot shock absorber
- ForceSource: Prescribed mechanical force generator
- TranslationalReference: Fixed stationary mechanical ground