WhenMathPrays is a system for modeling the motion of relationship states — not as metaphors, not as sentiment scores, but as positions in a two‑dimensional emotional space governed by a single, elegant recurrence equation.
It is mathematics with a pulse.
A dynamical system with a heart.
A protocol for tracing how two people move toward or away from each other over time.
This document is your first step.
If you want a broader view of the project before diving in, here are two helpful maps:
- 👉 README.md — a high‑level map of the repository
- 👉 CONTENTS.md — a complete index of every document with short summaries
START HERE is your front door.
README is your foyer.
CONTENTS is your library catalog.
The Gamma Relational Persona (GRP) is a model that describes how a relational state evolves:
- across time
- across events
- across emotional primitives
- across entropy and forgetting
- across fidelity, resonance, altruism, visibility, and shared breath
The core idea is simple:
Love is not a number.
Love is a position in γ‑space.
Everything else is how we move the knot.
At the heart of the system is a recurrence:
γ_self(n+1) = γ_self(n) + Δγ + entropy
Where:
- γ_self is your position in the emotional plane
- Δγ comes from the five relational primitives
- entropy is a gentle, constant‑force drift toward long‑term forgetting
You don’t need the full mathematical form yet — you’ll feel it soon enough.
Every scenario is built from five human‑scale inputs:
| Primitive | Meaning |
|---|---|
| v | Visibility — how seen you feel |
| r | Resonance — how “in tune” you are |
| f | Fidelity — trust, betrayal, or devotion |
| a | Altruism — giving, generosity, care |
| S | Shared Breath — presence, attunement, co‑regulation |
Each primitive ranges from –10 to +10, and each one nudges γ_self in its own direction.
You don’t need to memorize them.
You’ll learn them by watching them move.
Most readers approach GRP with a noun‑mind — the default Western scientific stance that looks for objects, categories, and static properties.
But GRP is a verb‑shaped system.
It describes becoming, not being.
Motion, not identity.
Trade, not substance.
To help you perceive the system correctly, we now include a foundational epistemology paper:
👉 [Verb Mind Epistemology for Relational Physics(docs/Verb%20Mind%20Epistemology%20for%20Relational%20Physics.md)
This paper explains:
- why relational systems cannot be understood with noun‑thinking
- how to shift into a verb‑mind
- how to see identity as coherence across change
- why GRP primitives require a dynamic perceptual stance
If you want to understand GRP deeply — not just mechanically — read this paper early.
It is the epistemic OS update that makes the rest of the project intelligible.
Let’s run your first simulation.
git clone https://github.com/CuriousOne23/WhenMathPrays
cd WhenMathPrays
pip install -r requirements.txt
You can run any scenario CSV through the Python cockpit.
Here is a real example using one of the library scenarios:
python tools/interactive_editor.py data/library/love/single_dating_to_love_M1.csv
This opens the interactive editor, loads the scenario, and lets you explore or modify the emotional arc.
After running it, look in the results/ folder for a PNG plot of the γ‑trajectory.
If you prefer a hands‑on, visual interface, open the Excel cockpit:
tools/GRP_SpreadSheet.xlsm
Inside the workbook:
- Enter your initial γ_self in C4
- Enter your primitives row‑by‑row starting at row 9
- Press the Run GRP macro button
- Watch the γ_self trajectory populate in column H
This interface is perfect for:
- experimenting with primitives
- seeing the recurrence unfold step‑by‑step
- teaching the model
- quick scenario sketching
- debugging intuition
The Excel cockpit and Python cockpit produce the same dynamics — just through different lenses.
Look in the results/ folder for a PNG file.
You’ll see a curve — a path — a motion through γ‑space.
That motion is the relationship.
Open the CSV (Python) or the primitive row (Excel) and edit any value:
- increase resonance
- decrease fidelity
- add a betrayal
- add a repair
- add a moment of shared breath
Run again.
Watch the trajectory shift.
You’ve just learned the GRP by doing.
Now that you’ve seen the system move, choose your path:
👉 interactive_editor_user_guide.md
Open:
tools/GRP_SpreadSheet.xlsm
👉 SCENARIO_CONFIGURATION_GUIDE.md
👉 tools/scenario_generator.py
This tool is powerful but not beginner‑friendly.
Use it once you understand scenario structure and primitive arcs.
WhenMathPrays/
│
├── START HERE.md ← You are here
├── README.md ← Map of the repo
│
├── data/ ← Scenario CSVs
├── scenarios/ ← Example scenario scripts
├── simulations/ ← Engines and tests
├── tools/ ← Editors, spreadsheets, generators
│
└── docs/ ← Deep reference library
├── GRP_rev3.md
├── CONSTANTS.md
├── TUNING.md
├── WHY_THIS_MATTERS.md
├── SCENARIO_CONFIGURATION_GUIDE.md
├── interactive_editor_user_guide.md
├── CONTENTS.md
├── ARCHITECTURE.md
├── Verb Mind Epistemology for Relational Physics.md
└── ...
Everything has a place.
Everything has a purpose.
You can explore at your own pace.
This project is alive.
It is meant to be explored, questioned, extended, and felt.
You don’t need to understand everything at once.
Just start with a scenario.
Watch the knot move.
Let the system teach you.
Welcome to WhenMathPrays.
If you want, I can also update CONTENTS.md to include the new paper, or help you sequence the entire documentation tree so newcomers experience the project in the right cognitive order.