Moving Body¶
The Moving Body statistics provide time-resolved kinematic and force-related quantities associated with each moving body in the simulation. These outputs describe the motion of the body (position, velocity, rotation), as well as the forces, torques, and stresses exerted on the body by the surrounding fluid. This output produces a tab-separated ASCII .txt file named MovingBody_{DynamicName}.txt, where the dynamic name corresponds to the name of the Moving Body in the Model Tree.
The data is written as a time series, where each row corresponds to a simulation time and each column corresponds to a statistic listed in the table below. Each row in the output file corresponds to a new statistics output time and is appended at the Statistics Output Write Interval.
The reported quantities fall into several categories:
Kinematics: Position, velocity, angular position, angular velocity, and rotation axis describe how the body moves and rotates over time.
Forces and Torques: Force and torque components (X, Y, Z, axial, radial, and orbit-based) quantify the fluid-induced loads acting on the body. Unless otherwise noted, these values exclude contributions from static pressure.
Surface Quantities: Pressure, stress, and shear stress values represent spatial averages (or extrema) over the moving body surface, providing insight into fluid loading and boundary interactions.
Interior Quantities: Interior forces and torques represent contributions from fluid contained within the moving body, when applicable.
Geometric Properties: Area and wetted area describe the effective surface of the body interacting with the fluid.
Derived Quantities: Metrics such as power number provide normalized measures of energy transfer and are useful for comparing operating conditions.
Statistics Table¶
The index table below shows the statistics that will appear in the Moving Body output file. Within this table, each statistic corresponds to a column in the output table that evolves with the time column.
Statistics |
Units |
Details |
When Appears |
|---|---|---|---|
Time |
s |
simulation time |
|
Angular Position |
rad |
angular position of rotation about moving body position |
|
Angular Velocity |
rad/s |
angular velocity of rotation about moving body position |
|
Angular Velocity X |
rad/s |
angular velocity |
|
Angular Velocity Y |
rad/s |
angular velocity |
|
Angular Velocity Z |
rad/s |
angular velocity |
|
Area |
m^2 |
total area of moving body surface |
|
Direction X |
Dimensionless |
orientation direction of ball joint |
|
Direction Y |
Dimensionless |
orientation direction of ball joint |
|
Direction Z |
Dimensionless |
orientation direction of ball joint |
|
Dynamic Pressure |
Pa |
spatial mean over moving body surface of dynamic pressure, does not include static pressure, positive indicates pressure in direction of triangle normal |
|
Dynamic Stress |
Pa |
spatial mean over moving body surface of dynamic stress which is sum of dynamic pressure and shear stress, does not include static pressure |
|
Force Axial |
N |
axial component of total force from fluid on moving body, does not include forces due to static pressure |
|
Force Radial Magnitude |
N |
radial component of total force from fluid on moving body, does not include forces due to static pressure |
|
Force X |
N |
total force from fluid on moving body, does not include forces due to static pressure |
|
Force X |
N |
total force from fluid on moving body, does not include forces due to static pressure |
|
Force X |
N |
total force from fluid on moving body, does not include forces due to static pressure |
|
Force X |
N |
total force from fluid on moving body, does not include forces due to static pressure |
|
Force X |
N |
total force from fluid on moving body, does not include forces due to static pressure |
|
Force X |
N |
total force from fluid on moving body, does not include forces due to static pressure |
|
Force X |
N |
total force from fluid on moving body, does not include forces due to static pressure |
|
Force X |
N |
total force from fluid on moving body, does not include forces due to static pressure |
|
Force Y |
N |
total force from fluid on moving body, does not include forces due to static pressure |
|
Force Y |
N |
total force from fluid on moving body, does not include forces due to static pressure |
|
Force Y |
N |
total force from fluid on moving body, does not include forces due to static pressure |
|
Force Y |
N |
total force from fluid on moving body, does not include forces due to static pressure |
|
Force Y |
N |
total force from fluid on moving body, does not include forces due to static pressure |
|
Force Y |
N |
total force from fluid on moving body, does not include forces due to static pressure |
|
Force Y |
N |
total force from fluid on moving body, does not include forces due to static pressure |
|
Force Y |
N |
total force from fluid on moving body, does not include forces due to static pressure |
|
Force Z |
N |
total force from fluid on moving body, does not include forces due to static pressure |
|
Force Z |
N |
total force from fluid on moving body, does not include forces due to static pressure |
|
Force Z |
N |
total force from fluid on moving body, does not include forces due to static pressure |
|
Force Z |
N |
total force from fluid on moving body, does not include forces due to static pressure |
|
Force Z |
N |
total force from fluid on moving body, does not include forces due to static pressure |
|
Force Z |
N |
total force from fluid on moving body, does not include forces due to static pressure |
|
Force Z |
N |
total force from fluid on moving body, does not include forces due to static pressure |
|
Force Z |
N |
total force from fluid on moving body, does not include forces due to static pressure |
|
Interior Force X |
N |
total force from interior fluid on moving body |
|
Interior Force Y |
N |
total force from interior fluid on moving body |
|
Interior Force Z |
N |
total force from interior fluid on moving body |
|
Interior Torque X |
N-m |
total torque from interior fluid on moving body |
|
Interior Torque Y |
N-m |
total torque from interior fluid on moving body |
|
Interior Torque Z |
N-m |
total torque from interior fluid on moving body |
|
Max Dynamic Stress |
Pa |
spatial max over moving body surface of dynamic stress which is sum of dynamic pressure and shear stress, does not include static pressure |
|
Max Stress |
Pa |
spatial max over moving body surface of total stress, includes static pressure |
|
Orbit Position |
rad |
angular position of rotation about orbit point |
|
Orbit Torque X |
N-m |
total torque from fluid on moving body taken about the orbit axis, does not include forces due to static pressure |
|
Orbit Torque Y |
N-m |
total torque from fluid on moving body taken about the orbit axis, does not include forces due to static pressure |
|
Orbit Torque Z |
N-m |
total torque from fluid on moving body taken about the orbit axis, does not include forces due to static pressure |
|
Position |
m |
translation magnitude from initial location |
|
Position X |
m |
translation from initial location |
|
Position X |
m |
moving body position |
|
Position X |
m |
translation of moving body from initial position |
|
Position Y |
m |
translation from initial location |
|
Position Y |
m |
moving body position |
|
Position Y |
m |
translation of moving body from initial position |
|
Position Z |
m |
translation from initial location |
|
Position Z |
m |
moving body position |
|
Position Z |
m |
translation of moving body from initial position |
|
Power Number |
Dimensionless |
power number, power normalization is done using local density |
|
Power Number Normalized by [dynamic] Density |
Dimensionless |
power number, power normalization is done using fluid 1 density |
|
Rotation Angle |
rad |
angular position of rotation axis |
|
Rotation Angle After |
rad |
angular position of rotation applied after translation |
|
Rotation Angle Before |
rad |
angular position of rotation applied before translation |
|
Rotation Axis X |
Dimensionless |
axis of rotation |
|
Rotation Axis X After |
Dimensionless |
axis of rotation applied after translation |
|
Rotation Axis X Before |
Dimensionless |
axis of rotation applied before translation |
|
Rotation Axis Y |
Dimensionless |
axis of rotation |
|
Rotation Axis Y After |
Dimensionless |
axis of rotation applied after translation |
|
Rotation Axis Y Before |
Dimensionless |
axis of rotation applied before translation |
|
Rotation Axis Z |
Dimensionless |
axis of rotation |
|
Rotation Axis Z After |
Dimensionless |
axis of rotation applied after translation |
|
Rotation Axis Z Before |
Dimensionless |
axis of rotation applied before translation |
|
Rotational Velocity X After |
rad/s |
rotational velocity of rotation applied after translation |
|
Rotational Velocity X Before |
rad/s |
rotational velocity of rotation applied before translation |
|
Rotational Velocity Y After |
rad/s |
rotational velocity of rotation applied after translation |
|
Rotational Velocity Y Before |
rad/s |
rotational velocity of rotation applied before translation |
|
Rotational Velocity Z After |
rad/s |
rotational velocity of rotation applied after translation |
|
Rotational Velocity Z Before |
rad/s |
rotational velocity of rotation applied before translation |
|
Shear Stress |
Pa |
spatial mean over moving body surface of shear stress |
|
Time-Avg Dynamic Pressure |
Pa |
spatial mean over time-averaged moving body surface of dynamic pressure, does not include static pressure, positive indicates pressure in direction of triangle normal |
|
Time-Avg Total Pressure |
Pa |
spatial mean over time-averaged moving body surface of fluid pressure |
|
Time-Avg Total Pressure |
Pa |
spatial mean over time-averaged moving body surface of pressure, includes static pressure |
|
Torque X |
N-m |
total torque from fluid on moving body taken about the axis of rotation, does not include forces due to static pressure |
|
Torque X |
N-m |
total torque from fluid on moving body, does not include forces due to static pressure |
|
Torque X |
N-m |
total torque from fluid on moving body, does not include forces due to static pressure |
|
Torque X |
N-m |
total torque from fluid on moving body, does not include forces due to static pressure |
|
Torque X |
N-m |
total torque from fluid on moving body, does not include forces due to static pressure |
|
Torque Y |
N-m |
total torque from fluid on moving body taken about the axis of rotation, does not include forces due to static pressure |
|
Torque Y |
N-m |
total torque from fluid on moving body, does not include forces due to static pressure |
|
Torque Y |
N-m |
total torque from fluid on moving body, does not include forces due to static pressure |
|
Torque Y |
N-m |
total torque from fluid on moving body, does not include forces due to static pressure |
|
Torque Y |
N-m |
total torque from fluid on moving body, does not include forces due to static pressure |
|
Torque Z |
N-m |
total torque from fluid on moving body taken about the axis of rotation, does not include forces due to static pressure |
|
Torque Z |
N-m |
total torque from fluid on moving body, does not include forces due to static pressure |
|
Torque Z |
N-m |
total torque from fluid on moving body, does not include forces due to static pressure |
|
Torque Z |
N-m |
total torque from fluid on moving body, does not include forces due to static pressure |
|
Torque Z |
N-m |
total torque from fluid on moving body, does not include forces due to static pressure |
|
Total Pressure |
Pa |
spatial mean over moving body surface of fluid pressure |
|
Total Pressure |
Pa |
spatial mean over moving body surface of pressure, includes static pressure |
|
Total Stress |
Pa |
spatial mean over moving body surface of total stress, includes static pressure |
|
Velocity |
m/s |
velocity magnitude in direction of translation |
|
Velocity X |
m/s |
velocity |
|
Velocity X |
m/s |
velocity |
|
Velocity X |
m/s |
velocity |
|
Velocity Y |
m/s |
velocity |
|
Velocity Y |
m/s |
velocity |
|
Velocity Y |
m/s |
velocity |
|
Velocity Z |
m/s |
velocity |
|
Velocity Z |
m/s |
velocity |
|
Velocity Z |
m/s |
velocity |
|
Wetted Area |
m^2 |
total wetted area of moving body surface |
Usage and Interpretation¶
Kinematics
The kinematic quantities (e.g., Position, Velocity, Angular Position, Angular Velocity, Rotation Axis) define how the body translates and rotates over time. These are typically used to verify that the motion matches the intended operating conditions (e.g., impeller speed or orbital motion), and to interpret all force and torque quantities in the correct frame of reference.
Forces and Torques
The force and torque quantities (e.g., Force X/Y/Z, Force Axial, Force Radial Magnitude, Torque X/Y/Z) represent the total fluid-induced loading on the body. These are computed by summing the stress contributions over all mesh triangles belonging to the moving body family. At each triangle, the local pressure and viscous shear stresses act over the surface area, and these contributions are integrated to obtain the total force:
where \(k\) indexes the surface triangles, \(p_k\) is the local pressure, \(\mathbf{n}_k\) is the outward normal, \(\boldsymbol{\tau}_k\) is the shear stress, and \(A_k\) is the triangle area.
Torque is computed from these same surface forces, but with an important distinction: it is evaluated about the moving body family mount point. The torque is given by:
where \(\mathbf{r}_k=\mathbf{x}_k−\mathbf{x}_{mount}\) is the position vector from the family mount point to the triangle centroid. Because torque depends on this reference point, the choice of mount location directly affects the reported values.
Unless otherwise noted, these quantities exclude contributions from static pressure and therefore represent dynamic fluid loading.
Surface Quantities
The surface quantities (e.g., Dynamic Pressure, Shear Stress, Total Stress, Max Stress) represent spatial averages or extrema over the moving body surface. They are computed by integrating local values over all surface triangles in the moving body family.
The surface-averaged quantity \(⟨ϕ⟩\) is computed as an area-weighted average:
where: \(\phi_k\) is the local value on triangle \(k\) (e.g., pressure, shear stress), \(A_k\) is the triangle area, and \({A_{\text{tot}}}=\sum_k, A_k\) is the total surface area of the moving body family.
The dynamic pressure excludes static pressure and is defined as
And the reported Dynamic Pressure is the surface average
The shear stress represents the tangential viscous stress at the surface
And the total stress combines pressure and shear contributions
where this represents the normal component of total stress on the surface.
The maximum stress is computed as the maximum value over all surface triangles:
Interior Quantities
The interior quantities (e.g., Interior Force, Interior Torque) represent contributions from fluid contained within the moving body, when applicable. These terms are important for geometries where fluid exists inside the body volume (e.g., partially filled or porous bodies), and allows separation of external fluid loading from internal fluid contributions.
Geometric Properties
The geometric quantities (e.g., Area, Wetted Area) describe the effective surface of the body interacting with the fluid. These are computed by summing the contributions from all surface triangles belonging to the moving body family.
The total surface area is given by:
where \(A_k\) is the area of triangle \(k\).
The wetted area represents the portion of the surface in contact with the fluid and is computed as
where \(ϕk\) is the fluid volume fraction adjacent to the surface triangles.
Derived Quantities
The power and power number provide a direct link between fluid loading and energy input. The instantaneous power is computed from torque and angular velocity:
The power number is then defined as
where \(ρ\) is the fluid density, \(N\) is the rotational speed (rev/s) derived from the instantaneous angular velocity, and \(D\) is the characteristic diameter defined for the moving body family.
In multiphase systems, the choice of density is not unique. M-Star reports two power number definitions: Local Density-based Power Number uses the instantaneous, local fluid density field. Fluid 1 Density-based Power Number uses the reference density of Fluid 1.
This distinction reflects a modeling choice. Using the local density accounts for spatial and temporal variations in density due to phase distribution, while using Fluid 1 density provides a consistent reference for comparison to single-phase correlations and experimental data.
Both quantities are computed on a total family basis, using the fully integrated torque over all surface triangles. Because the calculation uses instantaneous values, the reported power numbers reflect the current operating condition at each output time.
Important
All Moving Body statistics are computed at the family level, including forces, torques, power, and all derived quantities. Each reported value represents the total or average obtained by integrating all surface triangles associated with the moving body family.
If a family contains multiple child geometries, the reported quantities reflect the combined contribution of all child surfaces within that family. To obtain statistics for individual geometries, each must be assigned to its own moving body family.