Hydraulic Volume
HydraulicsThe Hydraulic Volume is a chamber of fluid that compresses slightly: pressure builds as flow goes in. Put one where a line, cylinder or hose stores oil; it is what makes pressure rise over time instead of instantly.
It is the hydraulic capacitor, from its port to ambient.
Real-World Analog: Represents a fluid chamber, hydraulic cylinder barrel, valve manifold passage, or rigid hydraulic accumulator exhibiting fluid compressibility and compliance.
Mathematical Model
Where:
β_effis the effective bulk modulus of the fluid and entrained air (Pa)C_eff(p)is the pressure-dependent hydraulic compliance (m³/Pa)Vis the chamber fluid volume (m³)q_inis the net flow into the port (m³/s)
Aeration and Variable Bulk Modulus
When free entrained air is present with initial volume fraction at atmospheric pressure , the effective compressibility follows the Nykanen/Merritt bulk modulus formula:
where is the absolute pressure and is the polytropic exponent of the air bubbles ( for adiabatic transients, for isothermal). At low pressure near 0 bar gauge, the volume is spongy and compliant; as pressure increases, the air pockets compress and approaches the pure liquid bulk modulus .
Inputs & Outputs
| Direction | ID | Label | Type | Status |
|---|---|---|---|---|
| → In | p |
P | number | Required |
| → In | H |
H | number | Optional |
Parameters
| Parameters | Label | Type | Default | Description |
|---|---|---|---|---|
volume |
Volume | number | 0.0001 |
Fluid volume of the chamber and its lines |
initial_pressure |
Initial pressure (gauge) | number | 0 |
Pressure at t = 0 when the network starts at rest (Steady start off on a reservoir) |
air_fraction |
Entrained air fraction (α₀) | number | 0 |
Free air volume fraction at atmospheric pressure [0..0.2]. At α₀ = 0 bulk modulus is constant; > 0 models soft, spongy fluid compliance at low pressures. |
polytropic_index |
Polytropic exponent (γ) | number | 1.4 |
Polytropic exponent of entrained air bubbles (1.0 = isothermal, 1.4 = adiabatic) |
Usage Examples
Chamber Fluid Compressibility and Pressure Rise
The example examples/basic-hydraulicvolume.json charges a compliant chamber volume (V = 0.5 L) from a 20 bar supply through a hydraulic pipe line, demonstrating pressure accumulation dp/dt = (β/V)·q.
Water hammer when a valve shuts
The example examples/water-hammer.json runs water from 5 bar through a 100 m rigid pipe with fluid inertia.
Remarks & Best Practices
- Stiff: oil is hard to compress, so small volumes react in microseconds. Use TR-BDF2; an explicit solver needs a tiny step.
- 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).
Related Components
- FluidReservoir: Fluid Reservoir
- HydraulicPipe: Hydraulic Pipe
- HydraulicValve: Hydraulic Valve
- ReliefValve: Relief Valve
- PressureSensor: Pressure Sensor
- FlowSensor: Flow Sensor