SPRING

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:

dτdt=k⋅(ωa−ωb)\frac{d\tau}{dt} = k \cdot (\omega_a - \omega_b)

Integrating with respect to time yields the torsional Hooke's law:

τ(t)=τ0+k⋅(θa(t)−θb(t))\tau(t) = \tau_0 + k \cdot (\theta_a(t) - \theta_b(t))

Where:

  • \tau is the transmitted torque from flange A to flange B in Newton-meters (N⋅m\text{N}\cdot\text{m}).
  • k is the torsional stiffness (spring rate) in Newton-meters per radian (N⋅m/rad\text{N}\cdot\text{m/rad}).
  • \omega_a, \omega_b are the angular velocities at flanges A and B in radians per second (rad/s\text{rad/s}).
  • \tau_0 is the initial preload torque in Newton-meters (N⋅m\text{N}\cdot\text{m}).

Stored elastic potential energy is:

Ep=12k(θa−θb)2=τ22kE_p = \frac{1}{2} k (\theta_a - \theta_b)^2 = \frac{\tau^2}{2 k}

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 L=1/kL = 1/k) with derivative dτdt=kΔω\frac{d\tau}{dt} = k \Delta\omega.
  • Energy Conservation: Purely reactive element with zero internal dissipation.
  • Preload Support: Parameterized via initial_torque for pre-stressed mechanical linkages.

Related Components