Gear Pump
HydraulicsThe Gear Pump is a positive-displacement pump between port A (suction) and port B (outlet). Each shaft revolution moves one displacement of fluid from A to B, whatever the pressure; a little leaks back inside the pump as the pressure rises.
The shaft is an ordinary signal: wire a speed to ω, for instance a DC Motor's speed, and wire the pump's torque output back to that motor's load torque. The motor then slows as the pump works against pressure. Unwired, the pump runs at its speed parameter.
Real-World Analog: Represents an external gear pump driven by an electric motor or PTO shaft, providing positive-displacement hydraulic flow to industrial machinery or vehicle hydraulics.
Mathematical Model
Where:
Vdis the displacement (m³/rev),ωthe shaft speed (rad/s)Δp = p_B − p_Ais the pressure rise (Pa)G = (1 − η_v)·Vd·ω_nom / (2π·Δp_nom)is the leak conductance, fixed by the datasheet efficiencyη_mdivides the ideal torque while pumping and multiplies it when the pump is driven backwards as a motor
Inputs & Outputs
| Direction | ID | Label | Type | Status |
|---|---|---|---|---|
| → In | p |
A (in) | number | Required |
| → In | n |
B (out) | number | Required |
| → In | flange |
Shaft | number | Optional |
| → In | in |
ω | number | Optional |
| → In | H |
H | number | Optional |
| ← Out | torque |
T | number | Output |
| ← Out | flow |
Q | number | Output |
Parameters
| Parameters | Label | Type | Default | Description |
|---|---|---|---|---|
displacement |
Displacement | number | 0.00001 |
Volume per revolution; 1e-5 m³ is 10 cm³/rev |
volumetric_efficiency |
Volumetric efficiency | number | 0.95 |
Delivered over ideal flow at nominal speed and pressure; sets the internal leakage |
mechanical_efficiency |
Mechanical efficiency | number | 0.9 |
Ideal over shaft torque while pumping |
nominal_speed |
Nominal speed | number | 157.08 |
Speed at which the volumetric efficiency is rated; 157.08 rad/s is 1500 rpm |
nominal_pressure |
Nominal pressure | number | 10000000 |
Pressure rise at which the volumetric efficiency is rated |
speed |
Speed | number | 157.08 |
Shaft speed while the ω input is not wired |
flow_ripple |
Gear-tooth flow ripple | boolean | false |
When enabled, models periodic flow pulsation at the tooth-meshing frequency (z · ω); disable for an ideal smooth pump |
teeth_count |
Teeth per gear | number | 8 |
Number of teeth on each pump gear; sets both the visual gears and the flow-ripple frequency |
gear_profile |
Gear profile | select | spur |
Spur involute gears produce sharper handover dips and higher ripple; helical gears mesh gradually with ~65% less ripple |
ripple_amplitude |
Ripple amplitude override | number | 0 |
0 = automatic from teeth count and gear profile (~1/z²); set > 0 to override with a custom fractional amplitude |
Usage Examples
DC motor driving the pump
The example examples/basic-gearpump.json: a 24 V DC motor turns a 2 cm³/rev pump into a 0.5 mm valve, with a 25 bar relief valve to tank. The outlet settles near 18 bar at about 29 rad/s. At t = 3 s the valve closes to 20 %: the pressure climbs into the relief valve, the pump torque rises and the motor slows. Run it on TR-BDF2.
Flow ripple and pressure pulsation analysis
Enabling flow_ripple: true with an 8-tooth spur profile generates high-frequency flow pulsations into a compliant hydraulic volume. A downstream pressure sensor captures the resulting acoustic pressure ripple and harmonic spectrum.
Remarks & Best Practices
- Always give the flow a way out. A positive-displacement pump against a shut valve builds pressure without limit; put a Relief Valve from the outlet to tank.
- Shaft coupling: the torque output feeds the motor's load-torque input. Speed and torque are exchanged as signals, not through a mechanical port.
- Gauge pressure: every hydraulic pressure is relative to ambient; an open tank is 0 Pa.
- Units: pressure in Pa (1 bar = 100 000 Pa), flow in m³/s (1 L/min ≈ 1.667e-5 m³/s), speed in rad/s (1 rpm = 0.1047 rad/s).