Rotational Spring
Mechanics
Run the live example
Free · no sign-up · runs in your browser
The Rotational Spring block models a linear elastic torsional spring. It represents flexible coupling elements, torsion bars, elastic shafts, and compliant drivetrains in rotational mechanical systems.
It features two conserving rotational flanges (flange_a and flange_b) transmitting restoring torque proportional to relative angular twist.
Real-World Analog: Represents a torsion spring, flexible shaft coupling, or long drive shaft twisting elastically under applied torque.
Mathematical Model
The constitutive equation relating transmitted torque to angular velocity difference is:
Integrating with respect to time yields the torsional Hooke's law:
Where:
\tauis the transmitted torque from flange A to flange B in Newton-meters ().kis the torsional stiffness (spring rate) in Newton-meters per radian ().\omega_a, \omega_bare the angular velocities at flanges A and B in radians per second ().\tau_0is the initial preload torque in Newton-meters ().
Stored elastic potential energy is:
Inputs & Outputs
| Direction | ID | Label | Type | Status |
|---|---|---|---|---|
| → In | flange_a |
A | number | Required |
| → In | flange_b |
B | number | Required |
Parameters
| Parameters | Label | Type | Default | Description |
|---|---|---|---|---|
spring_rate |
Spring Rate (k) | number | 100 |
Torsional stiffness k in N·m/rad |
initial_torque |
Initial Torque (τ0) | number | 0 |
Initial preload torque at t=0 in N·m |
stiffness_cubic |
Nonlinear Duffing stiffness (k3) | number | 0 |
Cubic torsional hardening stiffness k3 in τ = k1·θ + k3·θ³ (0 = linear spring) |
Usage Examples
Torsional Harmonic Resonator
A torsion bar spring coupled to a flywheel exhibits natural resonance:
RotationalReference -> RotationalSpring(k=400) -> Inertia(J=0.25, w0=10)
Compliant Shaft Driveline
Two inertias connected by an elastic shaft transmitting power:
Inertia1(J=1.0) -> RotationalSpring(k=1000) -> Inertia2(J=2.0)Remarks & Best Practices
- Inductive MNA Branch: Mapped as a through-variable dynamic state (inductor ) with derivative .
- Energy Conservation: Purely reactive element with zero internal dissipation.
- Preload Support: Parameterized via
initial_torquefor pre-stressed mechanical linkages.
Related Components
- Inertia: Rotating mass storing rotational kinetic energy
- RotationalDamper: Rotary viscous damping and energy dissipation
- TorqueSensor: In-line measurement of transmitted shaft torque
- RotationalReference: Fixed stationary mechanical ground