Science Commit 5.

Author: mearvk

README.md

@@ -229,6 +229,48 @@ NIO-based front layer that binds local IPs 127.0.0.1 through 127.0.0.17 and brid
 
 ---
 
+## Eigenvector Math System
+
+National observation vectors routed through eigenvector matrices via a programmable frame pipeline. Input values represent national momentums, real angular values, or national rain (caught as-is).
+
+**Pipeline:** `Input → BasicAnatomy × input → [Frame Pipeline] → PerceivedOutput × result → Colored Output`
+
+**Eigenvector Matrices (.CDNS files):**
+
+| Matrix | Role | Dimensions | File |
+|--------|------|------------|------|
+| BasicAnatomy | Input EV | 5×5 | `math/eigenlocator/BasicAnatomy.CDNS` |
+| PerceivedOutput | Output PO | 5×5 | `math/eigenlocator/PerceivedOutput.CDNS` |
+
+**Routing Rules:**
+
+| Parameter | Value |
+|-----------|-------|
+| Forward multipliers (Stage 1) | 1–4 |
+| Total hops | max 51 |
+| Procedure frames | 2–65 |
+| Frame dimensions | 128×128 min, 4000×12800 max |
+| Frame size policy | User-build specified |
+| Standard hops | 1, 2, 3, 4, 6 |
+| Max skip | 16 |
+
+**Path Types:**
+- **Orderly** — Same w.r.t. All spirits; pass through unchanged
+- **Virtue** — Achieve their own virtue; transform independently
+
+**Color assignment** reserved for higher math geniuses (Max Rupplin).
+
+**Source:**
+- `source/math/EigenMultiplier.java` — Direct matrix × vector multiplication
+- `source/math/EigenRouter.java` — Full EV → Frames → PO pipeline
+- `math/eigen-config.xml` — Routing configuration
+- `math/eigenlocator/` — Immutable .CDNS matrix files
+- `math/frames/` — User-programmable procedure frame definitions
+- `math/observations/` — National input vectors
+- `math/results/` — Computed output
+
+---
+
 ## Memory Footprint (Rough Estimates)
 
 Approximate heap/RSS at steady state on Linux x86_64, Java 21 with virtual threads.

STRUCTURE.txt

@@ -5223,6 +5223,42 @@ DATABASES
   nwe_bma                — Brarner.M.Alete™ (species, postal, SSA, art, science)
 
 
+EIGENVECTOR MATH SYSTEM (math/)
+--------------------------------
+  eigenlocator/
+    BasicAnatomy.CDNS          — 5×5 input eigenvector matrix (immutable .CDNS)
+    PerceivedOutput.CDNS       — 5×5 output eigenvector matrix (immutable .CDNS)
+
+  frames/
+    frame-00.frame             — Entry frame (orderly passthrough, hop=1)
+    frame-01.frame             — Ricochet frame (scale:1.1, hop=2)
+    frame-02.frame             — Hot-action frame (skip 4)
+    frame-03.frame             — Terminal frame (orderly exit)
+    *.dat                      — User-built procedure matrices (up to 4000×12800)
+
+  observations/
+    sample-national-input.txt  — Sample 5-element national vectors
+
+  results/
+    *.result                   — EigenMultiplier output
+    *.routed                   — EigenRouter pipeline output
+
+  eigen-config.xml             — Routing config (matrices, hops, frame limits)
+
+  source/math/
+    EigenMultiplier.java       — Direct matrix × vector multiplication
+    EigenRouter.java           — Full pipeline: BasicAnatomy → Frames(2–65) → PerceivedOutput
+
+  Rules:
+    Forward multipliers:       1–4 (Stage 1, based on orderly path detection)
+    Procedure frames:          2–65 (user-programmable)
+    Frame dimensions:          128×128 min → 4000×12800 max (user-build specified)
+    Hop distances:             1, 2, 3, 4, 6 (standard); up to 16 (skip)
+    Total hops:                max 51
+    Path types:                Orderly (same w.r.t. All spirits) or Virtue (own transform)
+    Colors:                    Reserved — assigned by Max Rupplin
+
+
 PORTS
 ------
   2000      Strernary™ Directory Server (menu + XML forwarding)