Skip to main content

Crate tpt_sci_hemodynamics

Crate tpt_sci_hemodynamics 

Source
Expand description

§tpt-sci-hemodynamics

1-D compliant-vessel hemodynamics for the tpt-science pillar, built on tpt_sci_cfd_core and tpt_sci_ode. It models blood flow in a compliant arterial network using the 1-D augmented Navier–Stokes equations reduced to a vessel centerline, with:

  • A Vessel carrying a cross-sectional area A, flow Q, and a linear pressure–area (tube) law p = p0 + (β/A0)·(sqrt(A) - sqrt(A0)) (tube_law_beta).
  • Womersley pulsatile inlet conditions womersley_velocity for a given cardiac frequency and vessel radius (analytic oscillatory profile).
  • A non-Newtonian (shear-thinning) viscosity correction casson_viscosity via the Casson model.
  • A Network that steps a Vessel forward in time with the method of lines (area/flow ODE integrated by tpt-sci-ode).
  • The exact Womersley pulsatile solution womersley_velocity_profile (complex-Bessel J0/J1), including the analytic flow-rate formula.
  • 0-D/1-D/3-D coupling: a lumped Windkessel (RCR) terminal load and a couple step, plus the CfdCoupling trait a tpt-sci-cfd-core 3-D domain can implement.

The model is a 1-D reduced-order vascular primitive — not a patient-specific 3-D solver.

§Example

use tpt_sci_hemodynamics::{Vessel, tube_law_beta};

// Aortic-scale vessel, A0 = 1 cm², wall stiffness beta.
let beta = tube_law_beta(1.0e5, 1.0, 1.0);
let v = Vessel::new(1.0, 0.0, 1.0, beta).unwrap();
assert!(v.area > 0.0);

Structs§

Network
A small compliant arterial Network that advances a Vessel state with the 1-D area/flow ODE dA/dt = -∂Q/∂x, dQ/dt = ... (method of lines, integrated by tpt_sci_ode).
Vessel
Wall stiffness β requires a reference area; see tube_law_beta.
Windkessel
A 3-element RCR (Windkessel) lumped model: a characteristic resistance r_c in series with a parallel compliance c and peripheral resistance r_d.

Enums§

HemodynamicsError
Errors raised by the hemodynamics model.

Traits§

CfdCoupling
Thin interface a tpt-sci-cfd-core 3-D domain implements so the 1-D hemodynamic network can exchange boundary data with it. The 3-D domain receives the 1-D outlet pressure and returns the boundary flow it imposes back (the coupling mechanism; actual meshing/assembly is out of scope).

Functions§

bessel_j0
Bessel function of the first kind J0(z) for a complex argument, evaluated by a converging power series (valid for all z; accurate to ~1e-6 across the Womersley-number range used here, |z| ≲ 30).
bessel_j1
Bessel function of the first kind J1(z) for a complex argument.
casson_viscosity
Casson non-Newtonian viscosity μ = (sqrt(μ∞) + sqrt(τy·(3n+1)/(4n)) / sqrt(γ̇))² evaluated at shear rate gamma_dot, with asymptotic viscosity mu_inf and yield stress tau_y. Returns mu_inf when gamma_dot is 0 (fully yielded limit handled by caller).
couple
Drive a 1-D Network outlet through a Windkessel terminal load for one step dt. The last vessel’s outflow enters the Windkessel; the resulting proximal pressure is imposed back on the outlet vessel (through the linear tube law) as a weak boundary condition. Returns the outlet pressure applied.
tube_law_beta
Stiffness parameter β = sqrt(π·E·h) / (2·sqrt(A0)) for the linear tube law p = p0 + β·(sqrt(A) - sqrt(A0)), given Young’s modulus e, wall thickness h, and reference area a0.
womersley_complex_velocity
Complex axial-velocity amplitude U(r) for a unit pressure-gradient amplitude G = 1 (∂p/∂z = -e^{i·ω·t}), so the physical velocity is u(r,t) = Re{ U(r)·e^{i·ω·t} }:
womersley_factor
i^{3/2} = e^{i·3π/4} = (−1 + i)/√2, the complex factor in the Womersley argument i^{3/2}·α.
womersley_flow_rate_analytic
Analytic Womersley volumetric flow-rate amplitude Q̃ = (π·R²/(i·ω·ρ))·[1 − 2·J1(i^{3/2}·α)/(i^{3/2}·α·J0(i^{3/2}·α))] for a unit pressure-gradient amplitude.
womersley_flow_rate_numeric
Volumetric flow-rate amplitude obtained by numerically integrating the complex velocity profile U(r) over the cross-section (2π·∫ U(r)·r·dr), using n midpoint samples. Used to validate womersley_flow_rate_analytic.
womersley_number
Womersley number α = R·√(ω/ν) = R·√(ω·ρ/μ) for radius r0, angular frequency omega, and kinematic viscosity nu.
womersley_velocity
Approximate analytic Womersley axial velocity profile amplitude at radius r (parabolic Poiseuille shape modulated by a flattening factor). For the exact complex-Bessel solution, see womersley_velocity_profile.
womersley_velocity_profile
Physical axial velocity u(r,t) (real) of the exact Womersley solution for a unit pressure-gradient amplitude, given radius r, vessel radius r0, Womersley number alpha, angular frequency omega, density rho, and time t. Scales linearly with the imposed pressure-gradient amplitude.