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
Vesselcarrying a cross-sectional areaA, flowQ, and a linear pressure–area (tube) lawp = p0 + (β/A0)·(sqrt(A) - sqrt(A0))(tube_law_beta). - Womersley pulsatile inlet conditions
womersley_velocityfor a given cardiac frequency and vessel radius (analytic oscillatory profile). - A non-Newtonian (shear-thinning) viscosity correction
casson_viscosityvia the Casson model. - A
Networkthat steps aVesselforward in time with the method of lines (area/flow ODE integrated bytpt-sci-ode). - The exact Womersley pulsatile solution
womersley_velocity_profile(complex-BesselJ0/J1), including the analytic flow-rate formula. - 0-D/1-D/3-D coupling: a lumped
Windkessel(RCR) terminal load and acouplestep, plus theCfdCouplingtrait atpt-sci-cfd-core3-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
Networkthat advances aVesselstate with the 1-D area/flow ODEdA/dt = -∂Q/∂x,dQ/dt = ...(method of lines, integrated bytpt_sci_ode). - Vessel
- Wall stiffness
βrequires a reference area; seetube_law_beta. - Windkessel
- A 3-element RCR (Windkessel) lumped model: a characteristic resistance
r_cin series with a parallel compliancecand peripheral resistancer_d.
Enums§
- Hemodynamics
Error - Errors raised by the hemodynamics model.
Traits§
- CfdCoupling
- Thin interface a
tpt-sci-cfd-core3-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 allz; 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 rategamma_dot, with asymptotic viscositymu_infand yield stresstau_y. Returnsmu_infwhengamma_dotis 0 (fully yielded limit handled by caller). - couple
- Drive a 1-D
Networkoutlet through aWindkesselterminal load for one stepdt. 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 lawp = p0 + β·(sqrt(A) - sqrt(A0)), given Young’s moduluse, wall thicknessh, and reference areaa0. - womersley_
complex_ velocity - Complex axial-velocity amplitude
U(r)for a unit pressure-gradient amplitudeG = 1(∂p/∂z = -e^{i·ω·t}), so the physical velocity isu(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 argumenti^{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), usingnmidpoint samples. Used to validatewomersley_flow_rate_analytic. - womersley_
number - Womersley number
α = R·√(ω/ν) = R·√(ω·ρ/μ)for radiusr0, angular frequencyomega, and kinematic viscositynu. - 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, seewomersley_velocity_profile. - womersley_
velocity_ profile - Physical axial velocity
u(r,t)(real) of the exact Womersley solution for a unit pressure-gradient amplitude, given radiusr, vessel radiusr0, Womersley numberalpha, angular frequencyomega, densityrho, and timet. Scales linearly with the imposed pressure-gradient amplitude.