Hydraulic Fluid
HydraulicsThe Hydraulic Fluid block sets the fluid properties for a hydraulic network in exactly one place. It specifies the medium, temperature, density, dynamic viscosity, and bulk modulus used by all connected hydraulic components (pipes, valves, pumps, volumes, and reservoirs).
When present in a circuit, its properties take precedence over individual reservoir settings. The block can be connected directly to any hydraulic line via its optional conserving port p, or placed on the canvas to configure the network globally.
Real-World Analog: Represents the working fluid specification in a central hydraulic power unit (HPU) or barrel charge, establishing whether the system is filled with mineral oil (ISO VG 46), synthetic ester, water-glycol, or pure water.
Mathematical Model
The block assigns temperature-dependent equations of state and compressibility for the circuit:
Where:
- is the mass density ()
- is the dynamic viscosity ()
- is the fluid bulk modulus ()
Inputs & Outputs
| Direction | ID | Label | Type | Status |
|---|---|---|---|---|
| → In | p |
H | number | Optional |
Parameters
| Parameters | Label | Type | Default | Description |
|---|---|---|---|---|
medium |
Medium | select | Oil |
Working fluid of the hydraulic circuit |
temperature |
Temperature | number | 313.15 |
Sets density and viscosity of oil and water |
custom_density |
Custom density | number | 870 |
Used when Medium is Custom |
custom_viscosity |
Custom viscosity | number | 0.04 |
Used when Medium is Custom |
custom_bulk_modulus |
Custom bulk modulus | number | 1500000000 |
Used when Medium is Custom |
Usage Examples
Circuit Fluid Definition with Reservoir and Pipe
In examples/basic-hydraulicfluid.json, a HydraulicFluid block sets mineral oil (ISO VG 46 at 40 °C) across a transmission line connecting a 10 bar pressurized supply reservoir to an atmospheric return tank.
High-Temperature Water-Hydraulics Loop
A HydraulicFluid block configured with Water at 353.15 K (80 °C) feeds a cooling circuit, automatically scaling line resistance according to the lower viscosity of hot water.
Remarks & Best Practices
- Single point of truth: Avoids discrepancies between different reservoirs or lines by defining fluid properties once per circuit.
- Port connection: The conserving port
pis optional. Connecting it explicitly documents which circuit the fluid belongs to. - Backward compatibility: If no HydraulicFluid block is present, the simulation engine falls back to the medium parameters defined on
FluidReservoirblocks. - Incompressibility: The fluid model is treated as nearly incompressible; compliance is concentrated in
HydraulicVolumeand wave-propagationHydraulicPipeblocks using the bulk modulus .
Related Components
- FluidReservoir: Fluid Reservoir
- HydraulicPipe: Hydraulic Pipe
- HydraulicValve: Hydraulic Valve
- HydraulicVolume: Hydraulic Volume
- GearPump: Gear Pump