Skip to content

Sync upstream main into the fork - #8

Open
ahrazzle wants to merge 4 commits into
mainfrom
sync/upstream-vein-flow-20261113
Open

ahrazzle wants to merge 4 commits into
mainfrom
sync/upstream-vein-flow-20261113

Conversation

@ahrazzle

@ahrazzle ahrazzle commented Nov 13, 2026 •

Copy link
Copy Markdown
Member

This merges rohanarun/virtual-human:main (d6a5963, conserved-flow graphs and the venous-pressure work) into the fork's main. It fixes the compare you flagged, the fork being behind upstream.

The branch is sync/upstream-vein-flow-20261113. It carries only the upstream delta into the fork. That is vh/graph/flow.py, tests/test_flow.py, scripts/validate_flow.py, scripts/plot_flow_explainer.py, the flow docs and figures, and the conflict resolutions (README.md, auto-research/README.md, docs/graph_formalization.md, vh/graph/render.py).

Conflicts were combined, not picked. The fork keeps plasma-reference-basis clearance labels and its Track E credits. Upstream keeps the conserved-flow section. vh/graph/render.py carries both clears and conduit.

Verification on the merged tree: 242 passed, 15 skipped, 1 deselected (test_crossref_doi_check_live, marked network).

Context. The upstream path for the fork's Track E work already exists as rohanarun/virtual-human PRs 5 to 10, layered in order. This PR is only the other direction, upstream into the fork. The Project Asma tooling port stays separate (rohanarun/virtual-human PR 11). Once the upstream stack merges, the fork should sync once more to pick up the final upstream tree.

Automated posting by agentic team with human oversight.

rohanarun and others added 4 commits November 8, 2026 09:01
Adds vh.graph.flow: typed flow graph with R/C/L edge laws, gravity, Bernoulli kinetic term, Starling collapse, and one-way valves. Steady solve is exact for linear networks, uses an active-set complementarity loop for collapse/valves, and transients use an exact matrix-exponential R-C path or implicit Euler.

Validated against exact Hagen-Poiseuille, Windkessel, Starling and R-L solutions, and against the exact Womersley impedance. A lower-limb venous network with anatomical geometry predicts standing foot venous pressure 88.7 mmHg vs the physiological 85-90 mmHg range, with no parameter fitted to that range.

Adds weighted Laplacian / effective resistance / current-flow algorithms, flow tests, a validation report with figures, a Bernoulli derivation, and a prediction-method ladder.
Adds docs/flow_explained.md: the ELI25 version of the conserved-flow work, from why a standing blood column adds ~80 mmHg to the 88.7 vs 85-90 mmHg prediction and its limits. Adds scripts/plot_flow_explainer.py and three charts: the standing venous-pressure mechanism, the vein-vs-stenosis dominant-term comparison, and the validation scorecard. Links the explainer from the README, the validation report, and the auto-research report.
Conserved-flow graphs: validated venous pressure prediction
…ow-20261113

# Conflicts:
#	README.md
#	auto-research/README.md
#	docs/graph_formalization.md
#	vh/graph/render.py
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants