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)