FLUID

Hydraulic Fluid

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

The 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:

ρ=ρ(T,medium),μ=μ(T,medium),β=β(medium)\rho = \rho(T, \text{medium}), \quad \mu = \mu(T, \text{medium}), \quad \beta = \beta(\text{medium})

Where:

  • ρ\rho is the mass density (kg/m3\text{kg/m}^3)
  • μ\mu is the dynamic viscosity (Pa⋅s\text{Pa}\cdot\text{s})
  • β\beta is the fluid bulk modulus (Pa\text{Pa})

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 p is 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 FluidReservoir blocks.
  • Incompressibility: The fluid model is treated as nearly incompressible; compliance is concentrated in HydraulicVolume and wave-propagation HydraulicPipe blocks using the bulk modulus β\beta.

Related Components