TS

Torque Source

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

The Torque Source block models an ideal mechanical torque generator driving a rotational network. It generates a prescribed torque between two conserving rotational flanges (flange_a and flange_b).

Flange A acts as the positive drive shaft while flange B provides the reaction torque (typically tied to mechanical ground or motor housing). If the optional causal input port in is connected, the applied torque dynamically tracks the input signal, overriding the static parameter.

Real-World Analog: Represents a torque-controlled motor drive, magnetic particle clutch, or torsion wrench exerting an active twisting effort.

Mathematical Model

The torque source imposes a through-variable torque balance across its terminals:

τa=τ,τb=−τ\tau_a = \tau, \quad \tau_b = -\tau

Where:

  • \tau is the prescribed torque in Newton-meters (N⋅m\text{N}\cdot\text{m}).
  • \tau_a is the torque leaving flange A into the driven system.
  • \tau_b is the reaction torque entering flange B.

When the causal input signal u(t)u(t) is connected:

τ(t)=u(t)\tau(t) = u(t)

Mechanical power delivered to the network is:

P=τ⋅(ωa−ωb)P = \tau \cdot (\omega_a - \omega_b)

Inputs & Outputs

Direction ID Label Type Status
→ In in Ctrl number Optional
→ In flange_a A number Required
→ In flange_b B number Required

Parameters

Parameters Label Type Default Description
torque Torque (τ) number 10 Applied torque in Newton-meters (N·m)

Usage Examples

Constant Motor Torque Acceleration

Accelerate a flywheel against viscous bearing damping:

TorqueSource(torque=20) -> Inertia(J=0.5) -> RotationalDamper(d=0.1) -> RotationalReference

Closed-Loop Torque Control

Drive a shaft with a dynamic torque signal from a PID controller:

PIDController -> TorqueSource(in) -> Inertia(J=1.0) -> RotationalReference

Remarks & Best Practices

  • Flow / Through Source: Equivalent to an ideal current source in electrical networks or heat flow source in thermal networks.
  • Reaction Flange: Always connect flange_b to a reaction body, such as RotationalReference or an engine mount, to satisfy torque equilibrium.
  • Dynamic Control: Seamlessly transitions between constant torque parameterization and continuous dynamic signal control via port in.

Related Components