ROTGND

Rotational Reference

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

The Rotational Reference block establishes the absolute stationary reference frame (ω=0 rad/s\omega = 0\text{ rad/s}) 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:

ω(flange)=0 rad/s\omega(\text{flange}) = 0 \text{ rad/s}

Where:

  • \omega(\text{flange}) is the angular velocity of conserving terminal flange.
  • The reaction torque τ\tau 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