MicroVasc is a multiscale computational oncology library for modeling tumor microvascular sprouting, endothelial Delta-Notch lateral inhibition, network hemodynamics, and clinical anti-VEGF vascular normalization therapy.
flowchart TD
subgraph Microenvironment["Biochemical Transport (Reaction-Diffusion)"]
O2["Oxygen Field pO2(x,y)"] -->|Hypoxia Induction| HIF["HIF-1alpha Activation"]
HIF -->|Secretion| VEGF["VEGF Chemokine Gradient grad(C_V)"]
VEGF -->|Receptor Binding| VEGFR2["Endothelial VEGFR2"]
end
subgraph Cellular["Cellular Signaling & Sprouting"]
VEGFR2 -->|Dll4 Synthesis| Delta["Delta (Dll4) Expression"]
Delta -->|Lateral Inhibition| Notch["Notch1 Activation in Neighbors"]
Notch -->|Downregulation| Phenotype{"Phenotype: Tip vs Stalk"}
Phenotype -->|High Delta| TipCell["Chemotactic Tip Cell Migration"]
Phenotype -->|High Notch| StalkCell["Proliferating Stalk Lumen"]
TipCell -->|Snail Trail| Branching["Sprouting & Anastomosis Loops"]
end
subgraph Hemodynamics["Microvascular Hemodynamics"]
Branching --> Circuit["Closed Capillary Graph Network"]
Circuit --> Kirchhoff["Kirchhoff Nodal Pressure Solver"]
Kirchhoff --> Poiseuille["Poiseuille Flow & Shear Stress tau_w"]
Poiseuille --> Perfusion["Functional Blood Perfusion & O2 Delivery"]
Perfusion -.->|Negative Feedback| O2
end
subgraph Clinical["Clinical Oncology & Therapy"]
AntiVEGF["Anti-VEGF Therapy (e.g. Bevacizumab)"] -->|Prune Immature Non-perfused Sprouts| Normalization["Vascular Normalization Window"]
Normalization --> ReducedIFP["Decreased Interstitial Fluid Pressure"]
Normalization --> ImprovedChemo["Optimized Chemotherapy & Radiation Timing"]
end
The spatial transport of vascular endothelial growth factor (
Where:
-
$D_V, D_{O2}$ are the effective tissue diffusion coefficients. -
$\mathcal{H}$ is the Heaviside step function inducing VEGF synthesis upon cellular hypoxia ($pO_2 < 10\text{ mmHg}$ ). -
$k_{\text{bind}} B_{\text{anti-VEGF}} C_V$ models pharmacological neutralization by monoclonal antibodies (e.g., Bevacizumab).
Endothelial cells along the sprouting front differentiate into migratory tip cells or proliferative stalk cells via Notch1-Delta-like 4 (Dll4) juxtacrine lateral inhibition:
Cells expressing
In newly anastomosed capillary loops, blood flow rate
Enforcing Kirchhoff's current conservation at all internal vascular junctions yields:
Endothelial wall shear stress is computed as:
Following Rakesh K. Jain's vascular normalization hypothesis, anti-angiogenic therapy selectively prunes hyperpermeable, non-perfused immature sprouts, reducing Interstitial Fluid Pressure (IFP) and decreasing the tumor hypoxic fraction (
When
Requires Python 3.11, 3.12, or 3.14.
git clone https://github.com/ZengLLQ/micro-vasc.git
cd micro-vasc
pip install -e ".[dev]"micro-vasc simulate --grid 48 --steps 35 --radius 10micro-vasc delta-notch --cells 12 --vegf 1.5 --steps 100micro-vasc normalize --grid 48 --dose 25.0from micro_vasc import AngiogenesisSimulator
from micro_vasc.visualizer import AsciiVisualizer
# 1. Initialize coupled multiscale simulator
sim = AngiogenesisSimulator(grid_size=48, tumor_radius=10, rng_seed=42)
# 2. Advance 30 temporal steps of sprouting & anastomosis
sim.run(steps=30)
# 3. Render real-time spatial tissue map
print(AsciiVisualizer.render_spatial_map(sim.env, sim.network, display_size=24))
# 4. Evaluate clinical normalization audit
metrics = sim.audit_normalization()
print(AsciiVisualizer.render_clinical_report(metrics))
# 5. Administer targeted anti-VEGF therapy (e.g. 20 nM Bevacizumab)
pruned_vessels = sim.therapy.prune_immature_vessels(anti_vegf_dose_nm=20.0)
print(f"Pruned {pruned_vessels} immature sprouts.")Run the full pytest suite locally:
pytest -vAll unit and integration tests run across Ubuntu, macOS, and Windows runners in GitHub Actions CI.
This project is licensed under the MIT License - see the LICENSE file for details.