diff --git a/LAYMANS_EXPLANATION.md b/LAYMANS_EXPLANATION.md
new file mode 100644
index 0000000..d68d5f8
--- /dev/null
+++ b/LAYMANS_EXPLANATION.md
@@ -0,0 +1,458 @@
+# Understanding the Neuro-Coherence Framework
+## A Simple Explanation for Everyone
+
+**Last Updated**: February 13, 2026
+
+---
+
+## What Is This Project About?
+
+Imagine your brain as a massive orchestra with billions of musicians (neurons) that need to play in harmony. When everything works well, the music is beautiful and coordinated. But in Bipolar I disorder, this "orchestra" loses its ability to stay in sync.
+
+This project presents a **new way of thinking about Bipolar I disorder**. Instead of viewing it as just a "chemical imbalance" (like having too much or too little of one instrument), it proposes that the problem is actually about the **coordination and synchronization** across the entire brain.
+
+---
+
+## The Big Idea: From Chemical Imbalance to Coordination Breakdown
+
+### Traditional View (Simplified)
+- **Problem**: "Your brain has too much or too little of certain chemicals"
+- **Solution**: "Take medication to adjust those chemicals"
+- **Goal**: Manage symptoms lifelong
+
+### This Framework's View (Simplified)
+- **Problem**: "Your brain's different systems can't coordinate and communicate properly"
+- **Solution**: "Help the brain learn to re-synchronize itself"
+- **Goal**: Restore the brain's natural ability to stay balanced
+
+Think of it like this:
+- **Old approach**: Your car engine is misfiring, so we suppress the bad cylinder
+- **New approach**: Your car's timing is off, so let's help all cylinders learn to fire in perfect rhythm again
+
+---
+
+## What Did They Create?
+
+The researchers built:
+
+1. **A Mathematical Formula (Ψ - "Psi")** that measures how well your brain's systems are synchronized
+2. **Computer Simulations** that can model what happens during manic episodes, depressive episodes, and healthy states
+3. **A Way to Measure This** using existing brain imaging technology (EEG, fMRI, PET scans)
+
+---
+
+## The Four Key Factors (Operators)
+
+The framework says your brain's coordination depends on four independent factors working together:
+
+### 1. **Γ (Gamma) - Adaptive Gain: "The Responsiveness Factor"**
+**What it is**: How well your brain adapts and responds to changes
+
+**In everyday terms**: 
+- Like a car's shock absorbers - they adjust to bumps in the road
+- In a **healthy brain**: Responds appropriately to stress or excitement
+- In a **manic episode**: Over-responds to everything (shock absorbers too loose)
+- In **depression**: Barely responds at all (shock absorbers frozen)
+
+**How we measure it**: Brain wave recovery after stimulation
+
+---
+
+### 2. **Θ (Theta) - Thermodynamic Stability: "The Energy Factor"**
+**What it is**: How stable your brain's energy supply is
+
+**In everyday terms**:
+- Like your phone's battery health - not just charge level, but how stable it is
+- In a **healthy brain**: Steady, reliable energy supply
+- In **manic episode**: Energy system stressed but functioning
+- In **depression**: Energy system severely depleted
+
+**How we measure it**: Metabolic markers (ATP production, oxygen consumption)
+
+---
+
+### 3. **Δ (Delta) - Connectivity Variance: "The Coordination Factor"**
+**What it is**: How well different brain regions synchronize with each other
+
+**In everyday terms**:
+- Like a group of dancers staying in formation
+- In a **healthy brain**: All dancers moving together smoothly
+- In **manic episode**: Dancers moving fast but chaotically, out of sync
+- In **depression**: Dancers barely moving, scattered
+
+**How we measure it**: fMRI brain network connectivity patterns
+
+---
+
+### 4. **Λ (Lambda) - Spatiotemporal Coherence: "The Rhythm Factor"**
+**What it is**: How well brain waves across different regions stay in phase
+
+**In everyday terms**:
+- Like musicians playing to the same beat
+- In a **healthy brain**: Orchestra playing in perfect rhythm
+- In **manic episode**: Everyone playing too fast, out of tempo
+- In **depression**: Weak, inconsistent rhythm
+
+**How we measure it**: Brain wave phase synchronization (EEG)
+
+---
+
+## The Magic Formula: Why ALL Four Matter
+
+Here's the crucial insight: These four factors **multiply together**, not add.
+
+**What this means in practice**:
+
+If you have a score of:
+- **ALL factors good** (each at 0.9): 0.9 × 0.9 × 0.9 × 0.9 = **0.66 (pretty good!)**
+- **One factor fails** (0.9 × 0.9 × 0.9 × 0.1) = **0.07 (terrible!)**
+
+**The takeaway**: You can't fix bipolar disorder by improving just one thing. All four systems need to work together.
+
+It's like a car - you can have a perfect engine, perfect transmission, and perfect wheels, but if you have no steering, you're not going anywhere safely.
+
+---
+
+## What the Numbers Mean: The Ψ Score
+
+The framework calculates a single number called **Ψ (Psi)** that represents overall brain coordination:
+
+| Ψ Score | State | What It Means |
+|---------|-------|---------------|
+| **0.7 - 1.0** | Healthy (Euthymic) | Brain is well-coordinated, stable |
+| **0.3 - 0.6** | Manic Episode | High energy but poor coordination |
+| **0.1 - 0.4** | Depressive Episode | Low energy, weak coordination |
+
+---
+
+## What the Images Show
+
+### Image 1: Quick Start Results
+**What you're seeing**: Four different charts showing the fundamental findings
+
+**Top Left - Ψ Across Different States**:
+- **Blue line (Euthymic)**: Bounces around 0.8-1.0 - stable and high
+- **Orange line (Manic)**: Middle range 0.3-0.6 - unstable coordination
+- **Green line (Depressive)**: Very low 0.1-0.3 - severely impaired
+
+**Top Right - Recovery Dynamics**:
+Shows how the brain recovers from a disturbance. The green line shows it takes time (about 150 time units) to climb from a disrupted state (0.3) back to healthy (0.85). This is KEY - it shows the brain CAN recover, but it takes time.
+
+**Bottom Left - Operator Values**:
+The four bars show the four factors in a healthy brain:
+- **Γ (blue)**: 1.37 - excellent responsiveness
+- **Θ (orange)**: 0.98 - great energy stability  
+- **1-Δ (green)**: 0.83 - good coordination
+- **Λ (red)**: 0.80 - strong rhythm
+
+**Bottom Right - Comparison Across States**:
+Clear visual proof: Healthy (0.89) vs Manic (0.47) vs Depressive (0.17)
+
+---
+
+### Image 2: Multimodal Comparison
+**What you're seeing**: How the framework uses different types of brain scans
+
+This shows that using **multiple measurement types** gives a more complete picture:
+
+**Top Row** - Three different measurements:
+- **EEG Phase Locking**: Brain wave synchronization (green=healthy is high, red/blue=episodes are lower)
+- **EEG Coherence**: Overall brain wave harmony (similar across states, but subtle differences)
+- **fMRI Network Variance**: How scattered brain networks are (green=healthy has low variance, episodes have high variance)
+
+**Bottom Left - Integrated Ψ**:
+When you combine all measurements: Healthy (1.41) >> Manic (0.38) ≈ Depressive (0.51)
+
+**Bottom Middle/Right - Operator Breakdowns**:
+Shows exactly which factors are failing in each state:
+- **Manic**: High Γ (over-responsive) but low Λ (poor rhythm)
+- **Depressive**: Low everything, especially Θ (energy) and Γ (responsiveness)
+
+---
+
+### Image 3: Multiple Perturbation Experiment
+**What you're seeing**: What happens when you "disturb" the brain multiple times
+
+The colored vertical lines show when the brain gets a disturbance (like a stressful event). 
+
+**Key finding**: The brain can handle occasional disturbances and recover. BUT:
+- Each disturbance causes a temporary drop in coordination
+- The brain bounces back, but it takes time
+- If disturbances come too frequently, the brain might not fully recover before the next hit
+
+**Real-world meaning**: Why stress management and routine matter - your brain needs time to recover between challenges.
+
+---
+
+### Image 4: Longitudinal Analysis (Bipolar Trajectory)
+**What you're seeing**: What bipolar disorder looks like over time
+
+**Top Graph - Bipolar Disorder Pattern**:
+Shows how Ψ changes over 1,500 time units (imagine months/years):
+- **Green zones** (Euthymic): Brain coordination is high (0.8-1.0)
+- **Pink zones** (Manic): Coordination drops to mid-range (0.4-0.6)
+- **Rose zones** (Depressive): Coordination crashes (0.1-0.3)
+
+**The pattern**: The brain cycles through these states. The framework can track these transitions.
+
+**Bottom Graph - Healthy Control**:
+For comparison, a healthy brain stays consistently in the high range (0.7-1.0) with natural variation but no dramatic crashes.
+
+**The stark difference**: Bipolar = wild swings. Healthy = stable with minor fluctuations.
+
+---
+
+## Key Findings (In Simple Terms)
+
+### 1. **Different Episodes Have Different "Fingerprints"**
+
+Each type of episode shows a distinct pattern:
+
+**Manic Episode**:
+- Think of it as: "Accelerator stuck, but steering wheel is loose"
+- High responsiveness (Γ) 
+- Poor coordination (Λ)
+- Result: Lots of activity but chaotic
+
+**Depressive Episode**:
+- Think of it as: "Running on empty with a dead battery"
+- Low energy (Θ)
+- Low responsiveness (Γ)
+- Result: Everything slows down dramatically
+
+### 2. **Recovery Takes Time and Follows a Predictable Pattern**
+
+The simulations show recovery isn't instant - it follows an exponential curve:
+- **Healthy people**: Bounce back relatively quickly (like a rubber ball)
+- **Bipolar disorder**: Bounce back much more slowly (like a bowling ball in molasses)
+- **Prediction**: People with bipolar should show 2.5x slower recovery in brain wave patterns
+
+### 3. **You Can't Fix Just One Thing**
+
+Because the four factors multiply:
+- Fixing energy (Θ) alone won't work if rhythm (Λ) is still broken
+- Boosting responsiveness (Γ) won't help if coordination (Δ) is poor
+- **You need multi-pronged approaches** to improve brain coordination
+
+### 4. **It's Measurable**
+
+Unlike vague concepts, Ψ can be calculated from:
+- EEG brain wave recordings
+- fMRI brain scans
+- PET metabolic imaging
+- Blood tests for metabolic markers
+
+This means doctors could potentially track it over time.
+
+---
+
+## The Three Big Predictions (How We Know If This Is Right)
+
+Science requires testable predictions. This framework will **fail** if these don't hold true:
+
+### Prediction 1: Recovery Speed
+**Hypothesis**: People with bipolar disorder recover brain wave synchronization **2.5x slower** after a perturbation compared to healthy people
+
+**How to test**: Use TMS (brain stimulation) + EEG and measure recovery time
+**Pass/Fail**: If bipolar patients recover just as fast, framework is wrong
+
+---
+
+### Prediction 2: Ψ Tracks Symptoms  
+**Hypothesis**: As Ψ goes down, symptoms get worse (and vice versa)
+
+**How to test**: Calculate Ψ from brain scans and compare to clinical symptom ratings
+**Pass/Fail**: If there's no correlation, framework is wrong
+
+---
+
+### Prediction 3: All Four Factors Matter
+**Hypothesis**: You need all four operators - no single factor can predict stability alone
+
+**How to test**: Statistical analysis to see if combining all four predicts better than any single one
+**Pass/Fail**: If one factor explains everything, framework is wrong
+
+---
+
+## What Makes This Significant?
+
+### 1. **New Perspective**
+Instead of "fix the chemicals," it's "restore the coordination"
+
+### 2. **Unified Framework**
+First time anyone has tried to combine brain waves, metabolism, brain networks, and plasticity into one mathematical model
+
+### 3. **Interpretable**
+Unlike AI black boxes, every number has physical meaning
+- Doctors can understand what's failing
+- Researchers can test specific parts
+- Patients can grasp what's happening
+
+### 4. **Guides Treatment**
+If validated, could tell us:
+- Which systems need help in each patient
+- Whether treatment is working (track Ψ over time)
+- When someone might be heading toward an episode
+
+---
+
+## Important Disclaimers
+
+### What This Is NOT:
+❌ A cure for bipolar disorder  
+❌ A treatment you can use today  
+❌ Clinically validated or proven  
+❌ Peer-reviewed science (yet)  
+❌ Medical advice  
+
+### What This IS:
+✅ A theoretical framework  
+✅ A computational research tool  
+✅ A new way of thinking about the problem  
+✅ A set of testable predictions  
+✅ Open-source code for researchers to explore  
+
+---
+
+## Current Status: Where We Are Now
+
+**Phase**: Early research and development
+
+**What's Complete**:
+- ✅ Mathematical theory developed
+- ✅ Computer simulations working
+- ✅ 46 automated tests passing
+- ✅ Synthetic data analysis complete
+- ✅ Visualizations generated
+
+**What's Missing**:
+- ❌ Real patient data testing
+- ❌ Clinical validation
+- ❌ Peer review
+- ❌ FDA approval (not applicable yet)
+
+**Next Steps**:
+1. Test on existing brain scan databases
+2. Design clinical study to test the three predictions
+3. Refine the model based on real data
+4. Publish findings in scientific journals
+
+---
+
+## Bottom Line: What Does This All Mean?
+
+### The Simple Summary
+
+**Current Understanding**: Bipolar disorder = chemical imbalance, treat with lifelong medication to suppress symptoms
+
+**This Framework's Proposal**: Bipolar disorder = coordination breakdown across four brain systems, potentially restore by helping brain re-learn synchronization
+
+**Evidence Level**: Strong theoretical foundation, good computer simulations, **ZERO clinical validation yet**
+
+**Potential Impact**: If proven correct, could change how we:
+- Understand bipolar disorder
+- Predict episodes
+- Monitor treatment
+- Design new therapies
+
+**Realistic Assessment**: Interesting idea with mathematical rigor, but needs years of clinical research to prove or disprove
+
+---
+
+## Analogies to Help You Understand
+
+### The Orchestra Analogy
+- **Healthy brain**: Orchestra playing Beethoven beautifully
+- **Manic episode**: Orchestra playing too fast, musicians not listening to each other
+- **Depressive episode**: Orchestra exhausted, barely making sound, out of sync
+
+### The Car Analogy
+- **Γ (Responsiveness)**: Shock absorbers that adjust to road conditions
+- **Θ (Energy)**: Fuel system that provides steady power
+- **Δ (Coordination)**: Transmission that keeps all parts working together
+- **Λ (Rhythm)**: Timing belt that keeps engine firing in sequence
+
+**All four must work** - you can't drive safely with three good systems and one broken one.
+
+### The Smartphone Analogy
+- **Γ**: Processor speed and responsiveness
+- **Θ**: Battery health and power management
+- **Δ**: How well apps and OS communicate
+- **Λ**: Clock synchronization keeping everything timed
+
+When your phone freezes, it's usually not just one thing - it's multiple systems failing to coordinate.
+
+---
+
+## Frequently Asked Questions
+
+### Q: Is this a cure for bipolar disorder?
+**A**: No. This is a research framework to better understand the condition. It's not a treatment.
+
+### Q: Can I use this to diagnose or treat myself/loved ones?
+**A**: Absolutely not. This is theoretical research, not validated for clinical use.
+
+### Q: Has this been tested on real patients?
+**A**: Not yet. Currently only computer simulations with synthetic data.
+
+### Q: Is this better than current treatments?
+**A**: Unknown. Current treatments work for many people. This framework might help us understand WHY they work and potentially develop better approaches in the future.
+
+### Q: How is this different from other bipolar research?
+**A**: It's unique in trying to integrate multiple brain systems (waves, metabolism, networks, plasticity) into one mathematical framework. Most research focuses on one aspect at a time.
+
+### Q: When will we know if this is correct?
+**A**: Years. Needs clinical studies with hundreds of patients, brain scans, longitudinal data. Estimate: 3-5 years minimum.
+
+### Q: What if the predictions fail?
+**A**: Then the framework is wrong, and we learned what doesn't work. That's still valuable in science.
+
+---
+
+## For the Technically Curious
+
+If you want to understand more:
+
+1. **Start with**: `FINDINGS_SUMMARY.md` - Quick technical overview
+2. **Then read**: `AI_PERSPECTIVE_ANALYSIS.md` - Detailed assessment
+3. **For theory**: `docs/theoretical-framework/` - Mathematical details
+4. **To experiment**: `examples/quickstart.py` - Run the code yourself
+
+---
+
+## Final Thoughts
+
+This framework represents a **bold new way of thinking** about bipolar disorder. Instead of viewing it as a simple chemical problem, it treats it as a complex coordination challenge across multiple brain systems.
+
+**Is it right?** We don't know yet. That's what science is for - making testable predictions and checking them against reality.
+
+**Is it interesting?** Absolutely. The mathematical sophistication, computational implementation, and clear predictions make this serious research worth investigating.
+
+**Should you get excited?** Cautiously optimistic is appropriate. It could lead to breakthroughs, or it could be disproven. Either way, we'll learn something.
+
+**The most important thing**: This research is being done openly, with falsifiable predictions and honest acknowledgment of limitations. That's how good science should work.
+
+---
+
+**Remember**: If you or someone you love has bipolar disorder, continue working with qualified healthcare professionals. This framework is research, not treatment.
+
+---
+
+**Document Version**: 1.0  
+**Created**: February 13, 2026  
+**Author**: Analysis of Neuro-Coherence Framework Repository  
+**Audience**: General public, non-specialists
+
+---
+
+## Want to Learn More?
+
+- Read the main `README.md` for technical details
+- Explore the code in `examples/` to see it in action
+- Check the visualizations in `docs/figures/`
+- Review the theoretical papers in `docs/theoretical-framework/`
+
+---
+
+**"Not to impose stability through suppression, but to teach the system to stabilize itself."**  
+*— Core principle of the Neuro-Coherence Framework*