Mass ​
Represents a sliding mass with inertia, subject to external and gravitational forces.
This component models the translational motion of a point mass along a single axis. It considers the mass's inertia, external forces applied through its two mechanical connection flanges (flange_a and flange_b), and a gravitational effect determined by parameters g and theta. The position s, velocity v, and acceleration a are related by v = der(s) and a = der(v). The core dynamic behavior is defined by Newton's second law, expressed as:
math where m is the mass, a is its acceleration, g is the gravitational acceleration parameter, \theta is the angle parameter, and \text{flange_a.f} + \text{flange_b.f} represents the sum of external forces applied via the flanges.
This component extends from PartialRigid
Usage ​
TranslationalComponents.Mass(L=0.0, m, g=-9.80665, theta=0.0)
Parameters: ​
| Name | Description | Units | Default value |
|---|---|---|---|
L | Length of component, from left flange to right flange | m | 0 |
m | Mass of the sliding body | kg | |
g | Acceleration due to gravity; its effect is scaled by sin(theta) using the specified default or user-provided value. | m/s2 | -9.80665 |
theta | Angle defining the path of motion relative to how gravity's influence is calculated as per the component's equations (0 for horizontal). | rad | 0 |
Connectors ​
flange_a- This connector represents a mechanical flange with position and force as the potential and flow variables, respectively. (Flange)flange_b- This connector represents a mechanical flange with position and force as the potential and flow variables, respectively. (Flange)
Variables ​
| Name | Description | Units |
|---|---|---|
s | Absolute position of center of component | m |
v | Absolute velocity of the mass along its path of motion | m/s |
a | Absolute acceleration of the mass along its path of motion | m/s2 |
Behavior ​
using TranslationalComponents #hide
using ModelingToolkit #hide
@variables L #hide
@variables m #hide
@variables g #hide
@variables theta #hide
@named sys = TranslationalComponents.Mass(L=L, m=m, g=g, theta=theta) #hide
full_equations(sys) #hide<< @example-block not executed in draft mode >>Source ​
"""
Represents a sliding mass with inertia, subject to external and gravitational forces.
This component models the translational motion of a point mass along a single axis. It considers the mass's inertia, external forces applied through its two mechanical connection flanges (`flange_a` and `flange_b`), and a gravitational effect determined by parameters `g` and `theta`. The position `s`, velocity `v`, and acceleration `a` are related by `v = der(s)` and `a = der(v)`. The core dynamic behavior is defined by Newton's second law, expressed as:math m \cdot (a + g \cdot \sin(\theta)) = \text{flange_a.f} + \text
Flattened Source
"""
Represents a sliding mass with inertia, subject to external and gravitational forces.
This component models the translational motion of a point mass along a single axis. It considers the mass's inertia, external forces applied through its two mechanical connection flanges (`flange_a` and `flange_b`), and a gravitational effect determined by parameters `g` and `theta`. The position `s`, velocity `v`, and acceleration `a` are related by `v = der(s)` and `a = der(v)`. The core dynamic behavior is defined by Newton's second law, expressed as:math m \cdot (a + g \cdot \sin(\theta)) = \text{flange_a.f} + \text
Test Cases ​
No test cases defined.
Related ​
Examples
Experiments
Analyses
Tests