Rotational Reference
MechanicsThe Rotational Reference block establishes the absolute stationary reference frame () for a rotational physical network. In acausal physical networks solved via Modified Nodal Analysis (MNA), at least one reference node is mathematically required to anchor the absolute angular velocities across all connected components and prevent a singular matrix.
It represents a rigid machine bed, mounting chassis, engine block, or immovable casing. Multiple Rotational Reference blocks can be placed across a diagram; all connect to the same global zero-velocity mechanical ground.
Real-World Analog: Represents a rigid machine casing, chassis mount, or stationary stator frame defining zero absolute angular velocity (0 rad/s).
Mathematical Model
The Rotational Reference block clamps the angular velocity of its conserving terminal flange to zero:
Where:
\omega(\text{flange})is the angular velocity of conserving terminalflange.- The reaction torque absorbed by the reference adjusts dynamically according to torque equilibrium (d'Alembert's principle).
Inputs & Outputs
| Direction | ID | Label | Type | Status |
|---|---|---|---|---|
| → In | flange |
G | number | Required |
Usage Examples
Stationary Chassis Grounding
In examples/basic-rotational-reference.json, the Rotational Reference establishes the stationary frame (ω = 0 rad/s), anchoring reaction torque from a rotary damper resisting flywheel motion.
Reaction Torque Anchoring
Anchor a reaction damper to the rigid stationary machine frame:
RotatingShaft → RotationalDamper → RotationalReference
Remarks & Best Practices
- Reference Requirement: Solvable rotational physical networks require at least one reference anchor to prevent singular MNA matrices.
- Multiple Instances: Placing multiple Rotational Reference blocks is topologically equivalent to connecting them with ideal rigid shafts to the same chassis.
- WASM Engine: Directly mapped to node 0 in the Rust WASM physical network solver.
Related Components
- Inertia: Rigid rotating body storing kinetic energy
- RotationalDamper: Viscous dissipation against casing
- TorqueSource: Prescribed mechanical torque generator
- AngularVelocitySource: Ideal angular velocity generator