Expand description
3D Anatomy Qapp — factor / body-system model (the domain core both audience lenses build on).
A Factor — any of {pathology finding, condition, medication, food, herb, tea, nutrient,
supplement, lifestyle, environmental} — maps onto one or more body systems with an Effect
(adverse / supportive / modulating), an EvidenceTier, and a magnitude. From a person’s active
factors, accumulate rolls per-system burden, interactions finds compounding / opposing /
herb–drug pairs, and systemic_implications emits proposals — never diagnoses.
The temporal layer turns static factors into time-stamped FactorEvents with kinetics
(onset → clearance), EnvironmentModulators, and per-system recovery trajectories — so the view
can show that different subsystems recover on different clocks and respond to different
interventions (the hot-week / beer / water example).
Honesty boundaries baked in: every emitted SystemicImplication carries
EpistemicStatus::Hypothesis() and the dominant evidence tier of its contributors; community /
anecdotal claims sit at the lowest tier; temporal projection is coarse (RecoveryBand “hours vs
days”, never a BAC or a fitness-to-operate claim); no advice. The 17 systems mirror
bundled/qapps/Anatomy/Knowledge/system-map.json so the native 3D view and this engine agree on
identity.
Structs§
- Absent
Part - A structure the person says is not on their body (so the reference mesh is hidden).
- AgeOntogeny
Profile - Multi-axis ontogenetic age profile separating chronological, skeletal bone, and tissue ages.
- Anatomical
Calibration Input - Input bundle for
derive_anatomical_calibration. - Anatomical
Calibration Result - Full 3-stage calibration output preserving backward compatibility via
body_fit. - Anatomical
Observation Record - Subject-scoped anatomical or densitometric observation wrapping
EvidenceDetail(7-tierEpistemicTier,q42m:*ObservationMethod,ObserverRole, and 4-axisTemporalObservationAxis). - Anatomy
View - The full view for one lens.
- Ancestry
Record - Genetic-ancestry context. Exists only when the person imported a record they chose.
- Aspect
Score - One aspect’s accumulated score, its band, and — crucially — the linkages that produced it.
- Body
Attributes - Person-authored attributes that change which parts are shown, or apply a named coarse shape (pregnancy abdomen). Not a diagnosis.
- Body
Characteristics - Relatively stable facts the person declares about their body (not a measurement).
- Body
Constitution - The full constitution the person may author. Empty = identity fit (reference body as published).
- BodyFit
- Numeric view transform applied to decoded organ vertices in CCF space, before the portal’s global orbit-frame normalise.
- Body
Measurements - Lengths and girths the person may declare. Units are millimetres / grams so the stored numbers are integers (no float health arithmetic in the record).
- Body
Observation - One coded observation about the subject. Integer value + UCUM unit (no float health arithmetic in the record).
- Body
System - A body system.
id/labelmirror the Anatomy qapp’ssystem-map.json;plain_labelis an accessibility-first, general-audience wording (plain, non-diagnostic — accessibility is core, not a mode). The clinicallabelremains available behind progressive disclosure. - Bone
Affine Correction - Stage 2 per-bone locally affine stiffness-penalized correction
(A_b, t_b). - Bone
Scale Loading - Per-bone sensitivity of log-scale
(sx, sy, sz)to a singleSsdmShapeMode. - Bone
Scale Tensor - Non-uniform affine bone scaling tensor
S_b = diag(s_{b,x}, s_{b,y}, s_{b,z})and compartmental bone mineral stiffness from Stage 1 SSDM projection. - Bridge
Result - The outcome of mapping records to factors: what resolved, and what didn’t (honestly surfaced).
- Calibration
Observation - Weighted anthropometric or anatomical landmark observation for Stage 2 registration.
- Contribution
- A single linkage to an underlying consideration — the traceability that makes the score-card the opposite of a black box. Says what contributed, how much (weighted), and on what evidence.
- Credential
Ref - A reference to a verifiable credential (
br:Credential/br:hasCredential). Abstract here — the VC / identity layer resolves and verifies it. - Digital
Birth Record - A Digital Birth Record — the foundational, self-owned, biometric-extended record produced at birth. An inalienable prosthetic extension of the person: they own it; the guardianship commons stewards it (and the data store) as their agency develops.
- Dyad
Consideration - A cross-body proposal about the dyad — always
EpistemicStatus::Hypothesis, never a determination. P2 emits only structural / rights / science considerations; medical correlations are deferred curation (§9.3). - Emerging
Child - The developing child: an emerging entity indexed on the
t(gestational-age) axis. Its identifier fabric is pairwise, uncorrelated, and never collapsed into any adult’s record. - Endocrine
Osteo State - Systemic endocrine, renal, and vitamin-D bone/ligament turnover state (Spec §5.3 & §5.5).
- Environment
Modulator - An environmental condition (heat, season, sustained activity) that scales matching contributions over a time window. Entered or imported — never a live weather/cloud call.
- Ethnicity
Affiliation - One self-identified affiliation. Repeatable. Open vocabulary.
- Factor
- A factor mapping onto the body.
- Factor
Event - A
Factorapplied at a point in time, with a dose scaler and per-system kinetics. - Factor
Knowledge - A reusable, provenance-tagged, versioned knowledge template for one named factor.
- Factor
Target - One (system, effect, evidence, magnitude) mapping carried by a factor.
weight_milliis a bounded 0..=1000 contribution magnitude (integer, no float health arithmetic). - Fracture
Callus State - Five-stage (0..=4) mechanobiological fracture-healing state (Claes & Heigele 1999; Spec §5.3 & §9.1).
- Guardianship
- Guardianship as a permissive-commons stewardship among
Stewards — the correct model for an infant/child, and the illustration of why “self-sovereign” is wrong (an infant is not sovereign; it is stewarded, between guardians, in a commons). Not a single owner: a set of stewards holding distributed responsibilities, in the child’s interest. By default the biological parents, subject to official credentials (br:hasCredential) that confirm, add, or override stewards. - Hypothesis
- A hypothesis under investigation — e.g. a converging
SystemicImplicationor a score-card aspect. Carries a coarse prior (0..=1000: how much is currently pointing at it) and its evidence tier. Never a diagnosis; a thing worth finding out more about. - Import
Result - The result of an import: the entries that resolved, plus honest warnings for any that didn’t.
- Interaction
- A compounding or opposing pair of factors on the same system.
- Investigative
Pathway - A ranked investigative pathway — the steps that would most help, most-valuable first. A proposal, never a plan imposed on the person.
- Investigative
Step - One investigative step, and which hypotheses it bears on — the linkage that makes the pathway
traceable rather than a black box. A signed bearing per hypothesis:
> 0a result would support it,< 0a result would tell against it (that combination is what lets a step discriminate). - Kinetics
- How a factor-event’s contribution to a system rises to a peak, then clears.
- Knowledge
Base - The factor-knowledge base: entries keyed by their stable
key, plus the source registry. - Knowledge
Consideration - A hypothesis produced when the person’s context matches a pack edge.
- Knowledge
Context Edge - One curated (or illustrative) context → topic edge.
- Knowledge
Source - A trusted knowledge source and the ceiling evidence tier it may assert.
- Knowledge
Target - One (system, effect, evidence, weight, kinetics) mapping in a knowledge template. Mirrors a
FactorTargetplus the defaultKineticsthe temporal layer uses when this becomes an event. - Known
Observation Code - A seed code the environment already knows how to bind.
- Laterality
Profile - Bilateral dominance and visceral situs profile (Spec §5.5).
- Maternal
Body - The mother in the dyad: the gestational mother — the data-subject who carries, and the emerging
child’s guardian during gestation. Her whole-body model is in a pregnant
PhysiologicalState. - Maternal
Fetal Dyad - The dyad: two coupled principals joined by the interface. Sanctuary-class, forum-internum data.
- Measurement
Spec - One curated measurement the person may declare.
- Mobility
AndFracture Risk Report - Coupled functional mobility, effort reserve, balance stability, and bone fracture-risk report
(Spec §5.4). Always
EpistemicStatus::Hypothesis. - Mobility
Task Input - Kinematic & external-load task inputs for
evaluate_mobility_and_fracture_risk. - Muscle
Quality Profile - Skeletal muscle architectural and myosteatosis quality profile (Spec §5.4).
- Organ
Cavity Transfer - Stage 3 deformed internal organ / soft-tissue cavity point with Jacobian volume check.
- Parentage
- The distinct biological + social roles around the emerging child — modelled on the science, not on a
presumed family shape. Genetic (the two
Progenitors), and social (declaredintended_parents). The gestational role lives onMaternalBody(she carries), and guardianship during gestation is hers (MaternalFetalDyad::guardian). - Physiological
Modifier Summary - Summary of physiological modifiers applied to bone and muscle profiles.
- Principal
Ref - A reference to a rights-bearing principal by identifier — a DID, kept as an identifier and never treated as an identity (a DID identifies; identity is a probabilistic fabric that must not collapse onto one identifier). Abstract here — the identity/guardianship layer resolves it.
- Provenance
- Where a knowledge datum came from. Imported offline; never a live fetch.
- Ranked
Step - A step ranked by its value of information.
- Record
Ref - A normalized reference to one health record — the minimum the bridge needs.
- Reference
Girths - Seed girths for the chosen Visible Human reference (not measured on the mesh).
- Score
Card - The whole card — one
AspectScoreperAspect, inAspect::allorder. - Skeletal
Density Profile - Multi-scale cortical and trabecular skeletal densitometry profile (Spec §5.1–5.3).
- Ssdm
Basis - Low-rank Statistical Shape & Density Mode basis for Stage 1 projection.
- Ssdm
Density Mode - One principal bone-mineral-density (BMD) mode in
SsdmBasis. - Ssdm
Shape Mode - One principal geometric mode in the Statistical Shape & Density Model (
SsdmBasis). - State
Modulator - Per-system whole-body modulation induced by a physiological state — the structural sibling of
EnvironmentModulator, but keyed by the current state and applying across the whole body. - Steward
- One steward in the guardianship commons — a guardian holding one or more
StewardRoles. Stewardship is held in trust, in the child’s interest — it is never ownership of the person. - Subject
Knowledge Context - The person’s declared / imported knowledge context. Never a fit input.
- System
Aspect Weight - One weight in the model: how much a body system contributes to an aspect (percent;
0= not at all,100= fully). Plain and inspectable — this is the “human weights model”, written out. - System
Burden - Aggregated load on one body system.
- System
Coverage - One row of the seed coverage matrix.
- System
Def - A first-class body system: identity, human + plain-language labels, how it renders, its overlay hosts (for a distributed system), a default colour, its place in the hierarchy, its structural links to other systems, and its provenance.
- System
Engagement - One system’s engagement under a physiological state.
- System
Registry - An extensible set of
SystemDefs. Seeded with the 17 built-in systems;registeradds/refines more. Lookups are by id (and by human label, for importing label-keyed knowledge files). Cloneable and serialisable so an app can persist / ship an extended taxonomy. - System
Relation - A structural link from one system to another, with a plain-language reason. Curation-grade seed (well-established relationships), extensible via the same registry mechanism.
- System
View - One system’s entry in a view.
- Systemic
Implication - A computed, contestable proposal about a system under accumulated load. Never a diagnosis.
- Timeline
- A person’s timeline of factor events + interventions + environment. Interventions are simply
FactorEvents carryingEffect::Supportivetargets — no separate type, so they net against adverse load through the same slice-1 accumulation. - Trajectory
Point - One sampled point of a system’s burden over time.
- Weight
Model - A readable, editable table of
(system, aspect) → weight. The interpretive core of the card, exposed rather than hidden.
Enums§
- Absence
Reason - Why a named structure is not present on this person’s body.
- Agency
Stage - Where a person is on the developmental accrual of agency and personhood — a gradient, not a binary
“sovereign self” switch. Agency accrues gradually and relationally; the endpoint is the capacity to
maintain adult personhood if healthy; continued stewardship for those who need it is
SupportedAdult— full personhood with supports, never a lesser status. - Anatomy
Model - Which Visible Human reference model the 3D body renders.
- Ancestry
Invalid - Why an ancestry record was refused.
- Aspect
- A health-relevant aspect the card interprets — a discussion lens, not a diagnosis axis.
- Biometric
Class - A class of biometric a birth record references — the record’s structure, never the datum. The
actual biometric (a DNA sequence, a blood type) is
Sanctuary-class, held in the person’s data store and referenced, not inlined here (data-minimisation). - Birth
Record Invalid - A reason a birth record is structurally invalid — a rights violation or an impossibility.
- Callus
Healing Phase - Named phase corresponding to the 5 stages (
0..=4) ofFractureCallusState. - Consideration
Kind - Context
Edge Kind - Kind of biomedical edge a context token can activate.
- Contribution
Kind - What kind of underlying consideration a
Contributionlinks to. - Cycle
Phase - A phase of the menstrual cycle. The recurring ~monthly timeline (§1.3); ordered as it progresses.
- Dominant
Side - Side the person names as dominant, if they name one.
- Dyad
Invalid - A reason a dyad is structurally invalid — a rights violation or an impossibility.
- Effect
- The direction of a factor’s effect on a system.
- Engagement
Level - How heavily a state engages a body system — a descriptive, non-pathological classification (a state is not “burden”). Derived from the seed scale.
- Evidence
Tier - Evidence backing a factor→system mapping, highest → lowest. Traditional-medicine and community knowledge are preserved at their own tier, never collapsed into “medical fact”.
- Factor
Kind - The kind of factor mapping onto the body. Open-ended via
Other. - Forum
Class - Where a piece of content sits in the selfhood / personhood taxonomy.
- Guardianship
Credential - The kind of official credential that establishes or overrides a stewardship relation (
br:hasCredential). - Handedness
- Handedness classification.
- Instrument
Kind - Where a value came from. Extensible via
InstrumentKind::Other. - Interaction
Kind - Interface
Kind - The maternal–fetal interface coupling the two bodies.
- Karyotype
- The declared chromosomal basis — the user’s “DNA selection”. A biological-substrate attribute, not an identity or gender claim.
- Lens
- Which audience the view is shaped for.
- Limb
Dominance - Regional limb dominance classification (bridges
DominantSide). - Measurement
Group - Form / catalog grouping.
- Measurement
Input Unit - How the person types the number. Stored unit is always mm or g.
- Measurement
Use - Who consumes this measure. A field can serve several.
- Ontogenetic
Stage - Coarse ontogenetic life stage derived from chronological or skeletal bone age (Spec §5.5).
- Physeal
Fusion Status - Ontogenetic epiphyseal growth-plate (physis) fusion status (Spec §5.5, §9.1).
- Physiological
State - The physiological-state axis. Currently the reproductive continuum plus a neutral
Baseline; the enum leaves room for other whole-body physiological states later without inventing them now. - Progenitor
- A genetic progenitor — one gamete source. There are two per emerging entity (ovum + sperm). A progenitor may be a known principal, a donor (identity withheld/pseudonymous by arrangement — possibly resolvable later for the child’s right to know their origins, a governance policy not asserted here), or simply unknown/unrecorded (a father may not be known, or not know).
- Recovery
Band - A coarse, honest recovery horizon — never a precise time or a safety threshold.
- Representation
Bind - How (if at all) this observation may affect the rendered body. Closed on purpose: a new watch metric does not get a new shader until a bind is curated.
- Reproductive
Endocrine Phase - Endocrine & reproductive-continuum phase for musculoskeletal turnover and ligamentous laxity calibration (Spec §5.5).
- Reproductive
State - A point on the reproductive continuum — baseline biology, modelled as a whole-body physiological
state rather than an event on the
reproductivesystem (§1.1). This is the “dignity of people born female” spine: the continuum is the model, not the steady state. - Rights
Stage - Where the emerging entity is on the path to social/legal personhood.
- Score
Band - A coarse, dignity-framed band. Never a clinical grade or a pass/fail.
- Situs
Classification - Visceral / thoracic organ situs classification.
- Social
Rights Threshold - The deferred values decision: when a born child’s social/legal rights are recognised as accruing. Timothy flagged uncertainty (at birth, or after the fourth trimester); the model carries the choice, it does not assert one. Whatever the threshold, personhood is never withheld beyond it and never applied during gestation (which would subordinate the gestational mother’s autonomy).
- Species
Densitometry Preset - Curated comparative and human clinical densitometry presets (Spec §5.2–5.3).
- Step
Kind - The kind of investigative step — the modes of moving from a hypothesis toward knowing/acting.
- Steward
Basis - How a steward holds their role — the biological-parent default, or an official credential.
- Steward
Role - A responsibility a steward holds. Stewardship is not one unitary “ownership” — it is a variety of distinct responsibilities, which may be held by different stewards (a medical decision-maker who is not the day-to-day carer; a cultural/heritage steward; a financial trustee). Illustrative set — the authoritative roles are curation/legal (Timothy/§9.4).
- System
Provenance - Where a body-system definition came from — so an auditor (and the person) can see whether a system is a built-in seed, curated, ontology-derived, or self-declared. Additions are transparent, never silent (the same honesty stance as the knowledge base’s source provenance).
- System
Relation Kind - How one system functionally relates to another. Structural context only — this does NOT propagate burden. An adverse load on one system does not automatically imply load on a related one; the link explains how the systems depend on / act upon each other, for the person’s understanding. (Timothy’s call, 2026-07-11: structural links, no automatic propagation.)
- System
Representation - How a body system is rendered on the 3D body.
- System
Tier - Where a system sits in the anatomy hierarchy. The body is classically divided into 11 major organ systems; finer/emerging systems are taught as sub-branches of a major, and some are body-wide networks that cut across majors. Marking this keeps the canonical framing honest while the registry stays open.
- Trimester
- A trimester of pregnancy — the staged ~40-week timeline (§1.3).
- Wellbeing
Level - A coarse, plain wellbeing level for a system — never a diagnosis, never a number to the person.
- WhoDensity
Category - WHO (1994) diagnostic classification for areal bone mineral density (DEXA).
Constants§
- AGE_
MONTHS_ RANGE - CIRC_
MM_ RANGE - Legacy torso-girth window (kept for callers). Per-field ranges live on the catalog.
- KNOWN_
OBSERVATION_ CODES - Seed binds. New instruments: add a row here or register via the graph (W16).
- MEASUREMENT_
CATALOG - Authoritative field list. New garment/helmet measures get a row here — not a vendor struct.
- NEUTRAL_
SYSTEM_ RGBA - The neutral render colour for a system with no seeded/registered colour (linear RGBA). A person’s σ-derived burden colour overrides this at runtime; this is only the default identity swatch.
- REF_
INSEAM_ RATIO - Typical inseam / stature ratio on the adult reference (seed).
- REF_
SITTING_ RATIO - Typical sitting-height / stature ratio on the adult reference (seed).
- SSDM_
FEATURE_ COUNT - Number of standardized anthropometric / ontogenetic / endocrine features in
SsdmBasis. - STATURE_
MM_ RANGE - Soft clamps so a typo cannot explode a consumer. Values outside are rejected on save.
- VH_
FEMALE_ STATURE_ MM - Visible Human Female standing height used by the CCF / HRA female reference set.
- VH_
MALE_ STATURE_ MM - Visible Human Male standing height used by the CCF / HRA male reference set. NLM Visible Human Project (male donor). Seed reference, not a population mean.
- WEIGHT_
G_ RANGE
Statics§
- BODY_
SYSTEMS - The 17 seeded body systems (extensible — jurisdiction/ontology packs can add more later).
Functions§
- accumulate
- Roll a set of factors into per-system burden. Deterministic; systems appear in
BODY_SYSTEMSorder (unknown ids after, alphabetically); only systems with any contribution are returned. - affiliations_
from_ observations - Collect declared ethnicity observations. Genetic-ancestry codes are not turned into
affiliations here — ancestry requires
AncestryRecord::from_import. - apply_
physiological_ modifiers_ to_ density - Apply age, endocrine/reproductive continuum, and bilateral laterality modifiers to
baseline
SkeletalDensityProfileandMuscleQualityProfilerecords (Spec §5.5). - bind_
for_ code - Bind for a code. Unknown →
RepresentationBind::None(extensible store). - body_
system - Look up a body system by id.
- body_
system_ by_ label - Look up a body system by its human label (case-insensitive, trimmed). Lets us import the bundled
knowledge files (e.g.
condition-map.json), which key systems by label (“Endocrine System”), into this id-keyed model. - body_
system_ for_ organ - The primary body-system id for an HRA/CCF organ (after
normalize_organ_key), orNoneif the organ is not in the curated map. An organ is a building block that participates in several systems (the pancreas is digestive and endocrine); this returns its primary macroscopic home — the one used for default colour/placement. Usesystem_memberships_for_organfor the full set. - build_
view - Build the view for a lens from a person’s factors.
convergence_thresholdis the number of distinct adverse factors on a system before it is “flagged” (seesystemic_implications). - build_
view_ from_ records - One-shot: records → factors → an
AnatomyViewfor a lens. Returns the view plus the unmapped set. - burden_
to_ sigma - Encode an accumulated system burden (
net_milli, 0..=1000) as σ — a position on the shared EMF spectrum (400–700 nm) that the engine’s parity oracles render to both the visual spectrum (qualia_core_db::render::spectral::sigma_to_linear_rgb) and the sonic spectrum (render::acoustic::sigma_to_center_frequency_hz). σ is the one truth; colour and pitch are two encodings of it — an organ under strain both looks and sounds it. σ is also the tenth axis ofTensor10D, so an organ’s.10dnode can carry this value directly. - considerations_
for_ context - Match the person’s context against a pack. Empty pack or no matching tokens → no considerations
(honest empty, not a guess). Every hit is a
EpistemicStatus::Hypothesis. - default_
registry - The built-in default registry — the 17 seeded systems. Callers with extensions build their own
(
SystemRegistry::seed()thenregister(...), or loaded from a.q42/ontology pack). - derive_
anatomical_ calibration - Derive the full 3-stage anatomical, densitometric, and organ-cavity calibration.
- evaluate_
mobility_ and_ fracture_ risk - Evaluate coupled mobility effort (
RER), dynamic balance (MoS), and skeletal factor-of-risk (Phi) from calibrated skeletal and muscle quality profiles. - harmonic_
tps_ organ_ transfer - Stage 3: Harmonic / 3D biharmonic Thin-Plate Spline soft-tissue & organ-cavity transfer.
- hypotheses_
from_ implications - Derive investigable
Hypothesises from the anatomy engine’sSystemicImplicationproposals — the bridge from “where is load converging” to “what’s worth finding out about”. The implication’s net load becomes the coarse prior; its dominant evidence carries through. - illustrative_
context_ pack - Small public-knowledge examples so the machinery is exercisable. Not a guideline set, not a racial typology, not appearance.
- import_
condition_ map - Import the bundled
condition-map.json(condition → primary system label). Each condition becomes a chronic clinicalFactorKnowledgetargeting its primary system, resolved throughsystems— so a condition that maps to a registered extension system (beyond the seeded 17) resolves and is evaluated, not silently dropped. A label that resolves to no registered system is still skipped with a warning (you can’t map to a system nobody has defined) — register it first. Passsuper::registry::default_registryfor just the seeded 17, or an extended registry. - import_
entries - Import a native knowledge JSON (an array of
FactorKnowledge). The content hash of each entry is recomputed and verified against the importedcontent_hash(if present); a mismatch is a warning, not a silent accept. - interactions
- Find pairwise interactions among factors sharing a system. O(system × factors²) but bounded by a person’s factor count; deterministic ordering.
- investigative_
pathway - Build the VOI-ranked investigative pathway for a set of hypotheses + candidate steps. Deterministic: steps sort by VOI descending, then by id. Steps with zero VOI (bear on nothing live) are dropped — the pathway shows only what would actually help.
- is_
known_ code - when known-code.
- knowledge_
key_ candidates - The knowledge key candidates for a record (kind-appropriate prefixes × slugified label).
- measurement_
catalog_ json - Grouped catalog for the Care form and for clothing/helmet consumers.
- normalize_
organ_ key - Normalize a CCF/HRA organ key to a model-agnostic base token: strip the
3d-vh-m-/3d-vh-f-asset prefix, the.glbsuffix, and a trailing laterality (-l/-r/-left/-right), leaving the bare organ ("3d-vh-m-eye-l.glb"→"eye","blood-vasculature"→"blood-vasculature"). - overlay_
host_ systems - For a
SystemRepresentation::DistributedOverlaysystem, the discrete systems whose organ meshes it should be highlighted over — anatomical placement hints for the overlay render. The enteric nervous system lines the gut → overlay the digestive organs; the glymphatic system clears the brain → overlay the nervous system; the endocannabinoid system’s receptors are body-wide → an empty slice meaning a whole-body cue rather than a localised highlight. Returns&[]for discrete-organ systems (they paint their own mesh and have no overlay host); call it only for distributed systems. - records_
to_ factors - Map records to non-temporal
Factors via the knowledge base. Each factor keeps the record’s id (so a view can trace back to the source record). - records_
to_ timeline - Map records to a temporal
Timelinevia the knowledge base (uses each record’sat_minute/dose_scale_pct, defaulting to 0 / 100). Unmapped records are returned alongside. - recovery_
band - Classify a system trajectory’s recovery horizon into a coarse band. Finds the peak net burden, then
the first later sample at or below a near-baseline threshold (10% of peak, floored at 20 milli), and
buckets the elapsed time. Returns
Noneif there is no adverse load to recover from. - score_
card - Compute the full score-card from a person’s factors, at a physiological state, under a weights model.
- seed_
knowledge_ base - A small, honestly sourced illustrative seed — enough to exercise every tier and the temporal wiring end-to-end. It is not an authoritative corpus: entries carry conservative weights, no fabricated citations, and general well-known reference classes as sources. Timothy supplies / points at the real corpus (⚑ S3 curation datum); replacing or extending this is expected.
- seed_
system_ coverage - Coverage of the 17 seeded systems against the curated organ map (not a pack on disk).
- seed_
system_ coverage_ markdown - Markdown table for manuals / CLI (cold path).
- seed_
weight_ model - The illustrative seed weights (§: curation-grade content deferred to Timothy/an expert). Encodes only well-established directions — which systems carry the stress axis, which carry resilience- relevant recovery — coarse, not authoritative magnitudes. Extend/replace with a curated model.
- slugify
- Lower-kebab a human label for use in a knowledge key (
"Type 2 Diabetes"→"type-2-diabetes"). Shared by the knowledge importer, ethnicity tokens, and the record→factor bridge so keys line up. - state_
modulator - The illustrative-seed
StateModulatorfor a physiological state. - system_
memberships_ for_ organ - System memberships for an organ.
- system_
representation - Classify one of the 17 systems by how it is rendered. This is an anatomical fact, not a coverage gap: the endocannabinoid system (CB1/CB2 receptors throughout the CNS + periphery), the enteric-nervous system (the ~500-million-neuron web lining the gut), and the glymphatic system (astrocyte + cerebrospinal-fluid clearance in the brain) are real and first-class in the taxonomy — they accumulate burden and get a σ percept — but they have no single organ to paint, so they are surfaced as an overlay on their host structures. Every other system has discrete organs.
- systemic_
implications - Emit systemic-implication proposals for systems where at least
convergence_thresholddistinct factors converge adverse load (and net load is non-zero). Deterministic, canonical-system order. - value_
of_ information - Value of information (0..=1000) of a step given the current hypotheses — the new primitive.
- whole_
body_ profile - The whole-body engagement profile for a physiological state: the systems this state engages above
baseline, in canonical
BODY_SYSTEMSorder, each with a coarseEngagementLevel. This is the dignified representation of “a state re-parameterises all systems” — heightened engagement, not adverse burden, and never a claim about a specific person. Systems at baseline are omitted.
Type Aliases§
- Myological
Quality Profile - Alias matching the name referenced in Spec §12.3 (
BIO-WP-05). - Skeletal
Densitometry Profile - Alias matching the name referenced in Spec §12.3 (
BIO-WP-05).