Skip to content

A systems-level analysis engine that models sleep as a recovery debt process rather than a nightly outcome. Using physiological traits and ecological pressure signals, it estimates predicted sleep need, quantifies sleep debt, and visualizes how stress accumulates silently before visible fatigue or failure occurs.

License

Notifications You must be signed in to change notification settings

AmirhosseinHonardoust/Physiological-Debt-Accumulation-Engine

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Systems Interpretation & Visual Deep Dive


Physiological Debt Accumulation Engine

This section exists for readers who do not want a demo, a dashboard, or a prediction.

It is written for readers who want to understand:

  • What kind of system is being modeled
  • Why sleep is treated as a debt rather than a behavior
  • Why failure does not appear suddenly
  • Why prediction is secondary to pressure accounting

Why This Project Exists

Most sleep analytics tools ask:

“How many hours did you sleep?”

This engine asks a more dangerous question:

“How much recovery did your physiology require and did you pay for it?”

That distinction changes everything.

Sleep duration is an output variable. Sleep need is a hidden state.

This engine is built around the idea that biological systems fail due to accumulated imbalance, not discrete mistakes.


Conceptual Model: Physiological Debt

Physiological debt is defined here as:

The persistent gap between required recovery and realized recovery under structural constraints.

Key properties of physiological debt:

  • It accumulates silently
  • It is partially buffered
  • It becomes visible only after buffers degrade
  • It explains delayed collapse better than point predictions

This mirrors real-world phenomena:

  • Burnout
  • Immune suppression
  • Cognitive fatigue
  • Injury risk escalation
  • Ecosystem collapse

Profile Snapshot, Defining the System’s Constraints

Screenshot 2025-12-19 at 15-13-34 Physiological Debt Accumulation Engine

What a “profile” actually means

A profile is not an individual. It is a closed biological system with fixed structural properties.

These properties define:

  • Baseline metabolic load
  • Repair complexity
  • Long-term survivability
  • Stress tolerance

They do not change quickly, and therefore:

  • Cannot be “optimized away”
  • Cannot be compensated by motivation
  • Cannot be overridden by discipline

This is why the model does not treat sleep as a choice.


Why body and brain weight are log-scaled

Biological scaling laws are nonlinear.

A doubling in body mass does not double energy cost, it changes it asymmetrically.

Log transforms:

  • Preserve comparative meaning
  • Prevent dominance by large species
  • Encode allometric relationships implicitly

This is not a modeling trick, it is a biological assumption.


Debt Summary, Turning Recovery Into an Accounting System

Screenshot 2025-12-19 at 15-15-01 Physiological Debt Accumulation Engine

Observed Sleep

Observed sleep is treated as:

  • A measured outcome
  • Not a control variable
  • Not evidence of recovery

Sleeping less than needed can still feel normal, until it doesn’t.


Predicted Sleep Need

Predicted sleep need is the model’s estimate of:

“Minimum recovery required to maintain equilibrium under current physiological and ecological load.”

This value increases when:

  • Metabolic cost rises
  • Cognitive maintenance increases
  • Environmental danger increases
  • Sleep opportunity degrades

This is why stress increases sleep need, even when sleep duration doesn’t change.


Sleep Debt

Sleep debt is not “fatigue”.

It is unpaid recovery.

Negative sleep debt means:

  • Repair processes are deferred
  • Buffers are being consumed
  • Future resilience is being borrowed

This is why the project treats debt as directional and cumulative.


Debt Regime Classification

The regime label is not cosmetic.

It encodes the qualitative phase of the system:

  • Stable Recovery roughly matches demand. Buffers intact.

  • Accumulating Debt exists but is not yet destabilizing.

  • Critical Buffers are depleted. Small shocks can cause failure.

This mirrors phase transitions in:

  • Materials science
  • Ecology
  • Finance
  • Human physiology

Debt Landscape, Population-Level Fragility

Why individual numbers are misleading

A sleep debt of -1.2 hours means nothing in isolation.

What matters is:

  • How common it is
  • Where it lies relative to others
  • Whether it sits near regime boundaries

This view embeds the individual inside a population pressure field.


Reading the diagonal

The diagonal represents perfect equilibrium.

Points below it are:

  • Accumulating unpaid recovery
  • Increasing vulnerability
  • Often asymptomatic, until collapse

The absence of sharp clusters reinforces the thesis:

There is no single “bad night” that causes failure.


Contribution Decomposition, Making Pressure Visible

Screenshot 2025-12-19 at 15-15-14 Physiological Debt Accumulation Engine

Why this decomposition matters

Without decomposition:

  • The model is a black box
  • Scientific reasoning stops
  • Trust erodes

This view answers:

“Which forces are doing the work?”


Interpreting contribution direction

  • Positive contribution Increases predicted sleep need → more recovery required

  • Negative contribution Reduces predicted sleep need → lower baseline demand

Importantly:

  • Contributions are contextual
  • A factor can help in one regime and hurt in another

Why intercept dominates

The intercept represents:

  • Baseline physiological maintenance
  • Non-negotiable biological cost

This reinforces a core message:

You cannot optimize away being biological.


Scenario Simulator, Stress Without Forecasting

Screenshot 2025-12-19 at 15-16-14 Physiological Debt Accumulation Engine

What counterfactual stress testing is

This simulator asks:

“If pressure increased, would the current recovery still be sufficient?”

It does not ask:

  • What will happen
  • When failure occurs
  • How behavior changes

Why this matters

Most failures happen because:

  • Systems look stable
  • Stress increases quietly
  • Recovery does not scale

This tool reveals latent fragility.


Dataset Explorer, Radical Transparency

Screenshot 2025-12-19 at 15-16-33 Physiological Debt Accumulation Engine

Why exposing the dataset is non-negotiable

Any system that:

  • Computes hidden states
  • Assigns regimes
  • Labels stability

...must allow full inspection.

This view exists to:

  • Enable auditing
  • Encourage skepticism
  • Support reinterpretation

System Philosophy

This engine is built on five principles:

  1. Failure is preceded by imbalance
  2. Imbalance accumulates before symptoms
  3. Recovery is constrained, not chosen
  4. Prediction without pressure is misleading
  5. Warning systems matter more than decisions

What This Engine Is For

  • Research exploration
  • Systems thinking
  • Leading-indicator analysis
  • Educational demonstrations
  • Conceptual reframing of sleep

What This Engine Is Not For

  • Medical diagnosis
  • Prescriptive advice
  • Optimization of sleep hacks
  • Performance guarantees

Final Perspective

Sleep is not rest.

Sleep is maintenance.

Maintenance deferred becomes debt. Debt ignored becomes collapse.

This engine exists to make that invisible process visible.

About

A systems-level analysis engine that models sleep as a recovery debt process rather than a nightly outcome. Using physiological traits and ecological pressure signals, it estimates predicted sleep need, quantifies sleep debt, and visualizes how stress accumulates silently before visible fatigue or failure occurs.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages