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
echo-lab	Probe-driven synthetic anatomy, acquisition rendering, learner measurements and source-versioned echo teaching content	lib/echo-lab/engine.ts · lib/echo-lab/render.ts · lib/echo-lab/render-worker.ts · lib/echo-lab/render-client.ts · lib/echo-lab/mmode.ts · lib/echo-lab/history.ts · lib/echo-lab/anatomy-gpu.ts · lib/echo-lab/anatomy-surface.ts · lib/echo-lab/mitral-surface.ts · lib/echo-lab/anatomy-client.ts · lib/echo-lab/anatomy-worker.ts · lib/echo-lab/anatomy-transfer.ts · lib/echo-lab/interaction.ts · lib/echo-lab/frame-policy.ts · lib/echo-lab/quality.ts · lib/echo-lab/measurements.ts · lib/echo-lab/content.ts · lib/echo-lab/quantification-content.ts · lib/echo-lab/session.ts
ep-mapping	Browser-local ILAM research, distinct critical-isthmus and exit/breakthrough assessments, blinded prediction snapshots, target-matched VT registration, preliminary ECG rules and opt-in ECG image review	lib/ep/types.ts · lib/ep/engine.ts · lib/ep/registration.ts · lib/ep/worker.ts · lib/ep/import.ts · lib/ep/electrogram.ts · lib/ep/view.ts · lib/ep/workflow.ts · lib/ep/demo.ts · lib/ep/ecg.ts · lib/ep/ecg-image.ts · lib/ep/ecg-image-server.ts · lib/ep/vt-hypothesis.ts
ai-chat	Server-only AI access, bounded educational requests, evidence context and request quotas	lib/ai-access.ts · lib/ai-chat.ts · lib/ai-chat-server.ts · lib/ai-scenario.ts · lib/ai-medication.ts · lib/ai-medication-evidence.ts
pipeline	Shared intervention ordering and final circulation	lib/intervention-simulation.ts
baselines	Reference pressures, rate, disease selection and phenotype data, including nonobstructive severe LVH with preserved reference EF	lib/physiology-data.ts · lib/condition-selection.ts
mixed	Disease composition, explicit pericarditis phase baselines and independent paired valve burdens	lib/mixed-state.ts · lib/valve-interactions.ts
atrial-myxoma	Selected mobile atrial mass and deterministic beat-dependent inflow obstruction	lib/atrial-myxoma.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, contraction kinetics and shared live signal registry	lib/hemodynamics.ts · lib/waveform-kinetics.ts · lib/live-waveforms.ts
peripheral	Peripheral transmission and catheter/transducer artifacts	lib/peripheral-arterial.ts · lib/pressure-recording.ts · lib/catheter-artifacts.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/pulmonary-therapy.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/reperfusion.ts · 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, splitting and local synthesized PCG audio	lib/heart-sounds.ts · lib/cardiophonogram.ts · lib/cardiophonogram-audio.ts · lib/pcg-acoustics.ts
pullback	LV/LVOT/aortic and PA/RV pullback positions, plus 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	Authored cases/figures, scripted tour, circuit and generated quiz	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/teacher-workflows.ts · lib/teacher-workflow-state.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
classroom	Read-only live teaching, capability authorization, shared state and timing	lib/classroom.ts · lib/classroom-server.ts · lib/classroom-db.ts
pulmonary-hypertension	Public pulmonary vascular learning, drug mechanisms, shared-engine demonstrations, trial evidence, qualitative benefit–risk appraisals, PAH risk scores and conditional therapy rules	lib/ph-ctd.ts · lib/ph-ctd-literature.ts · lib/ph-risk.ts · lib/ph-workup.ts · lib/ph-classification.ts · lib/ph-management.ts · lib/ph-content.ts · lib/ph-mechanisms.ts · lib/ph-trials.ts · lib/ph-trials-pah.ts · lib/ph-trials-other.ts · lib/ph-trials-expanded.ts · lib/ph-trial-index.ts · lib/ph-trial-taxonomy.ts · lib/ph-trial-routes.ts · lib/ph-trial-routes-pah.ts · lib/ph-trial-routes-other.ts · lib/ph-trial-routes-hfpef.ts · lib/ph-trial-landscape.ts · lib/ph-evidence-review.ts · lib/ph-trials-watch.ts · lib/ph-trials-watch-pah.ts · lib/ph-trials-watch-20261102-pah.ts · lib/ph-trials-watch-20261109.ts · lib/ph-trials-watch-20261109-pah.ts · lib/ph-trials-watch-20261109-left-lung.ts · lib/ph-trials-watch-20261109-other.ts · lib/ph-trials-watch-20261102-left-lung.ts · lib/ph-trials-watch-20261102-other.ts · lib/ph-trials-watch-lung-left.ts · lib/ph-trials-watch-cteph-other.ts · lib/ph-trials-comprehensive-additions.ts · lib/ph-trial-families.ts · lib/ph-trial-families-types.ts · lib/ph-trial-followups.ts · lib/ph-trial-followups-extensions.ts · lib/ph-trial-followups-substudies.ts · lib/ph-trial-followups-other.ts · lib/ph-literature-types.ts · lib/ph-literature-stream.ts · lib/ph-literature-inventory.ts · lib/ph-literature-coverage.json · lib/ph-literature-screening.json · lib/ph-literature-raw.d.ts · lib/ph-traces.ts · lib/ph-hemodynamic-lab.ts · lib/ph-trial-additional-followups.ts · lib/ph-real-world-evidence.ts · lib/ph-real-world-lung.ts · lib/ph-trials-hfpef-mra.ts · lib/ph-trials-hfpef-finerenone.ts · lib/ph-trials-hfpef-spironolactone.ts · lib/ph-benefit-risk.ts · lib/ph-trials-hfpef-eplerenone.ts · lib/ph-trials-hfpef-other-mra.ts
source-map	Reference navigation, indexed content, anonymous site visits, public teaching modules and the learning-access boundary for cases and EP Mapping	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 · lib/ph-access.ts · lib/ph-access-server.ts · lib/site-visits.ts
structural	Synthetic repairs and mechanics, local DICOM geometry, persistence and worker interfaces	lib/structural/types.ts · lib/structural/model.ts · lib/structural/clip-devices.ts · lib/structural/editor-history.ts · lib/structural/editing.ts · lib/structural/solver.ts · lib/structural/playback.ts · lib/structural/ecg.ts · lib/structural/context-menu.ts · lib/structural/echo.ts · lib/structural/anatomical-context.ts · lib/structural/ventricular-context.ts · lib/structural/valve-mechanisms.ts · lib/structural/print-export.ts · lib/structural/repair-assessment.ts · lib/structural/suspected-severity.ts · lib/structural/persistence.ts · lib/structural/worker.ts · lib/structural/dicom.ts · lib/structural/dicom-codecs.ts · lib/structural/dicom-philips.ts · lib/structural/dicom-display.ts · lib/structural/dicom-worker.ts · lib/structural/image-model.ts · lib/structural/image-reslice.ts · lib/structural/image-valve-estimate.ts · lib/structural/image-procedural.ts · lib/structural/mitral-chamber-context.ts · lib/structural/image-worker.ts · lib/structural/nrrd.ts · lib/structural/nrrd-fixture.ts · lib/structural/image-volume.ts · lib/structural/image-anatomy.ts · lib/structural/image-repair.ts · lib/structural/image-project.ts · lib/structural/image-mechanical-mapping.ts · lib/structural/image-quantification.ts · lib/structural/tee-reslice.ts · lib/structural/tee-worker.ts · lib/structural/tee-editor-state.ts · lib/structural/slicerheart-companion.ts · lib/structural/ge-volume-client.ts · lib/structural/ge-conversion-metadata.ts · lib/structural/worker-import.d.ts
validation	Clinical bibliographic provenance	lib/complete-sources.json

Presentation and routes

The Lab at /lab and Tutorial share components/lab-simulator.tsx. The root landing page introduces the platform; legacy root session and case links redirect to /lab. 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

Structural Heart, Pulmonary Hypertension and the Academic Halfday lesson at /academic-halfday/hemodynamics are public. EP Mapping, the clinical-case collection, individual case pages and teaching-case API retain the learning-access server gate for ordinary pages and direct RSC requests. Case passwords and signing secrets stay on the server; missing configuration and invalid or expired sessions remain locked. AI chat has a separate password and signed session that does not unlock cases. 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 ↑