Torque Source
MechanicsThe 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:
Where:
\tauis the prescribed torque in Newton-meters ().\tau_ais the torque leaving flange A into the driven system.\tau_bis the reaction torque entering flange B.
When the causal input signal is connected:
Mechanical power delivered to the network is:
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) -> RotationalReferenceRemarks & 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_bto a reaction body, such asRotationalReferenceor 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
- AngularVelocitySource: Ideal across-variable rotational speed source
- Inertia: Rotating inertial mass
- TorqueSensor: In-line measurement of transmitted torque
- RotationalReference: Clamped stationary mechanical housing (0 rad/s)