How the model works

Implementation index & documentation coverage

Find the modules responsible for each relationship and display.

Overview

This index connects the public model reference to the library modules that implement it. File names are provided for maintainers inspecting a source backup; they are not links to a public code repository. Documentation describes current behavior, including intentionally simplified or unsupported physiology.

The Lab page assembles these modules into the shared simulation state. Specialized components render pressure, ECG, overlay, Wiggers/PV, measurements, imaging and ventilation. The academic, tutorial, mystery and quiz pages select their teaching context around that engine.

Library ownership

Each library module has an explicit documentation home. The build-time coverage test reports newly added or missing modules; it does not certify the clinical validity of their coefficients.

Model topic	Responsibility	Library files
pipeline	Shared intervention ordering and final circulation	lib/intervention-simulation.ts
baselines	Reference pressures, rate, disease selection and phenotype data	lib/physiology-data.ts · lib/condition-selection.ts
mixed	Disease composition and independent paired valve burdens	lib/mixed-state.ts · lib/valve-interactions.ts
controls	Reference flow, filling and vascular-load experiments	lib/filling-pressure.ts · lib/output-control.ts · lib/vascular-resistance.ts · lib/preload-state.ts
valves	Grading, regurgitant fractions and dynamic prolapse	lib/valve-severity.ts · lib/mvp-dynamics.ts
rhythm	Deterministic rhythm, atrial/ventricular and pacing schedules	lib/nonsustained-vt.ts · lib/rhythm-extensions.ts · lib/sinus-node.ts · lib/pacing-timing.ts · lib/temporary-pacing.ts
ecg	Lead voltage, compatible variants and curated findings	lib/sinus-atrial.ts · lib/ecg-final-read.ts · lib/ecg-findings.ts · lib/ecg-highlight.ts · lib/ecg-patterns.ts · lib/ecg-sampling.ts · lib/ecg-segment.ts · lib/ecg-variants.ts · lib/vt-patterns.ts
pressure-generation	Core pressure/ECG functions and shared live signal registry	lib/hemodynamics.ts · lib/live-waveforms.ts
peripheral	Peripheral transmission and transducer response	lib/peripheral-arterial.ts · lib/pressure-recording.ts
measurements	Signal means, completed-beat readouts, units and pressure discrepancies	lib/pressure-summary.ts · lib/beat-pressure.ts · lib/pressure-relationships.ts · lib/display-format.ts
respiration	Respiratory timing, pressure transmission and endpoint comparisons	lib/pericardial-respiration.ts · lib/cycle-respiration.ts
ventilation	Single-compartment mechanics, breath sequences and ventilator gases	lib/ventilator.ts
peep	Positive-pressure loading and external-pressure accounting	lib/peep.ts · lib/airway-pressure.ts
gas	Oxygenation, gas-related pulmonary load and circuit gas limitations	lib/oxygenation.ts · lib/respiratory-loading.ts · lib/mechanical-oxygenation.ts
medications	Medication groups, effect equations and clinical reference content	lib/interventions.ts · lib/intervention-reference.ts · lib/intervention-groups.ts · lib/rate-drugs.ts
sedation	Infusion effects, synergy, drive and critical comparison	lib/sedation.ts
electrical-treatment	Rhythm-dependent conversion and retained myocardial drug effects	lib/rhythm-treatment.ts
maneuvers	Postural endpoints and phase-specific Valsalva response	lib/loading-maneuvers.ts · lib/valsalva-response.ts · lib/valsalva-study.ts
mechanical-support	Device flow, support reservoirs and ventricular pressure	lib/mechanical-support.ts · lib/support-arterial.ts
shunts	Signed shunt branches, flow conservation and saturation mixing	lib/shunts.ts
procedures	Selected decompression and successful valve endpoints	lib/chest-tube.ts · lib/pericardiocentesis.ts · lib/experimental-valves.ts · lib/valve-procedures.ts
pv	LV/RV volume balance, pressure sampling and display smoothing	lib/pressure-volume.ts · lib/pv-display.ts · lib/pv-inspection.ts
wiggers	Cycle pressure, gradient phases and diagram alignment	lib/cycle-hemodynamics.ts · lib/wiggers-display.ts · lib/cardiac-cycle-window.ts
sounds	Sound markers, pressure-dependent delays and splitting	lib/heart-sounds.ts
pullback	LV/LVOT/aortic position and isolated provocative studies	lib/pullback.ts · lib/pullback-teaching.ts · lib/carabello.ts
valve-area	Valve formula estimates and regurgitant volume	lib/valve-calculations.ts
output-methods	Effective output, Fick, thermal curves and method state	lib/cardiac-output.ts · lib/output-measurements.ts · lib/measurement-timing.ts
imaging	Phenotype geometry, shared chamber volume, lung and venous schematics	lib/imaging.ts · lib/echo.ts · lib/echo-devices.ts · lib/echo-renderer.ts · lib/echo-volume.ts · lib/chest-xray.ts · lib/venous-imaging.ts
alerts	Reference ranges, visual emphasis and deterioration comparisons	lib/hemodynamic-alerts.ts · lib/intervention-instability.ts
learning	Public foundations, local lesson progress, authored cases/figures, scripted tour, circuit and generated quiz	lib/foundations.ts · lib/foundation-progress.ts · lib/academic-cases.json · lib/academic-halfday.ts · lib/academic-progress.ts · lib/case-pleth.ts · lib/case-waveform-profiles.ts · lib/case-waveforms.ts · lib/halfday-stages.ts · lib/mystery.ts · lib/teaching-cases.ts · lib/teaching-catalog.ts · lib/teaching-figures.ts · lib/teaching-pearls.ts · lib/waveform-quiz.ts · lib/perfusion-demo.ts · lib/tutorial.ts · lib/tutorial-controls.ts · lib/tutorial-motion.ts · lib/tutorial-trace.ts · lib/tutorial-viewport.ts
rendering	View-only sampling, animation, scales, inspection and interface helpers	lib/animation.ts · lib/graphic-quality.ts · lib/trace-sampling.ts · lib/trace-scale.ts · lib/trace-axis.ts · lib/telemetry-scale.ts · lib/trace-annotations.ts · lib/trace-inspection.ts · lib/overlay-display.ts · lib/circuit-trace-explanation.ts · lib/circuit-trace-gesture.ts · lib/panel-hover.ts · lib/vitals-visibility.ts · lib/menu-labels.ts · lib/pathology-search.ts · lib/utils.ts
source-map	Reference navigation, indexed content and learning-access boundaries	lib/help-core.ts · lib/help-data.ts · lib/help-disclosure.ts · lib/help-events.ts · lib/help-model.ts · lib/help-model-map.ts · lib/help-navigation.ts · lib/help-search.ts · lib/help-types.ts · lib/learn-access.ts · lib/learn-access-server.ts
validation	Clinical bibliographic provenance	lib/complete-sources.json

Presentation and routes

The Lab is assembled in app/page.tsx. The key display components are pressure-table, aortic-tracings, twelve-lead, hemodynamic-overlay, wiggers-diagram, pressure-volume-view, echo-view, chest-xray, venous-ultrasound, ventilator-panel and cardiac-output. Inspection components consume the same signals instead of creating alternate physiology.

Routes under academic-halfday, tutorial, mystery and quiz provide teaching workflows. Help articles are rendered by app/help/[slug]/page.tsx. Shared header/footer/navigation and CSS govern layout; UI primitives do not calculate physiology.

Access, progress and search

The learning-access server gate protects the applicable Learn/case content; it is separate from public model documentation and generic disease presets. The Help index does not expose protected case narratives or embed access secrets. Local teaching progress and interface preferences are presentation state.

Help search tokenizes the written catalogue with aliases and bounded spelling tolerance. It indexes summaries, keywords, article sections, tables and link labels. It ranks close matches; no-match queries return the library. It does not generate medical answers or invoke a GPT API.

For maintainers

When changing a relationship, update its numerical test, this topic and the relevant clinical-source entry. Treat a file-to-topic mapping as the start of review: prose and examples still need human/source verification. Use the original implementation to inspect exact coefficients, limits and control flow.

References & further reading

Works cited · complete source catalog

Back to library Back to top ↑