compute_hydraulic_conductance
compute_hydraulic_conductance(
soln,
direction=None,
nu=None,
dx_m=None,
mu_phys=None,
verbose=True,
)Compute hydraulic conductance g from a single-phase LBM simulation.
The conductance is defined by \(Q = g * (P_in - P_out)\), where \(Q\) is the volumetric flow rate through the conduit. For a circular cylinder of radius \(R\) and length \(L\) this equals the Hagen-Poiseuille value \(g = pi * R^4 / (8 * mu * L)\).
Parameters
| Name | Type | Description | Default |
|---|---|---|---|
| soln | FlowResult | A FlowResult returned by solve_flow(). direction and nu default to the values stored in the result. |
required |
| direction | (x, y, z) | Flow direction. If None, taken from soln.direction. |
'x' |
| nu | float or None | Kinematic viscosity used in the LBM simulation (lattice units). If None, taken from soln.nu. |
None |
| dx_m | float or None | Physical voxel size in metres. Required for physical-unit output. | None |
| mu_phys | float or None | Dynamic viscosity of the fluid in Pa·s (e.g. water at 20 °C ≈ 1e-3). Required for physical-unit output. Ignored if dx_m is None. |
None |
| verbose | bool | Print a summary of results to stdout. Default True. | True |
Returns
| Name | Type | Description |
|---|---|---|
| dict with keys: | Q_lu – volumetric flow rate in lattice units (lu^3/ts) dP_lu – total pressure drop in lattice units g_lu – conductance in lattice units (lu^3/ts / lu_pressure) Q_m3s – volumetric flow rate in m^3/s (None if dx_m/mu_phys not given) dP_Pa – total pressure drop in Pa (None if dx_m/mu_phys not given) g_SI – conductance in m^3/(Pa·s) (None if dx_m/mu_phys not given) summary – human-readable result summary string (always populated) |