# UNNS COLLISION → STRUCTURAL ANALYSIS PIPELINE

PROJECT: CMS Collision Data → UNNS Structural Regime Analysis
FOLDER: REGIME_SYNTHESIS / supernova light curves vs. non-sensitive seismic event waveforms

---

0. FILE OVERVIEW (ACTUAL WORKING SET)

---

RAW DATA:

* 2e2mu_2012.csv

CORE SCRIPTS:

* collision_to_trajectory.py
* generate_ladders.py
* plot_collision_trajectory.py

INTERMEDIATE DATA:

* unns_collision_trajectory.csv

LADDERS:

* ladder_trajectory.csv
* ladder_gaps.csv
* ladder_peaks.csv

STRUCTURAL ENGINE:

* struc_perc_i_v2_5_0.html

RESULTS:

* struc_perc_batch_results.csv
* struc_perc_batch_results.json

LEGACY / IGNORE:

* prepare_for_struc_perc.py
* collision_ladder_ranked.csv

---

1. STEP 1 — RAW COLLISION DATA

---

INPUT:
2e2mu_2012.csv

DESCRIPTION:
CMS Open Data (Higgs → 4-lepton channel)
Each row = one collision event

KEY CONTENT:
E1, E2, E3, E4 (energies)
px, py, pz (momenta)
M (invariant mass, if present)

---

2. STEP 2 — BUILD UNNS SIGNAL

---

RUN:
python collision_to_trajectory.py

OUTPUT:
unns_collision_trajectory.csv

FORMAT:
t, signal

LOGIC:
signal = invariant mass (preferred)
OR total energy (fallback)

PURPOSE:
Convert discrete collision events → ordered structural trajectory

---

3. STEP 3 — VISUAL CHECK (OPTIONAL)

---

RUN:
python plot_collision_trajectory.py

OUTPUT:
Figure_1.png

PURPOSE:
Inspect signal behavior before structural transformation

---

4. STEP 4 — GENERATE STRUCTURAL LADDERS

---

RUN:
python generate_ladders.py

INPUT:
unns_collision_trajectory.csv

OUTPUT FILES:

1. ladder_trajectory.csv

   * Raw ordered signal
   * Represents structural path

2. ladder_gaps.csv

   * Δ between consecutive values
   * CRITICAL: reveals discontinuities

3. ladder_peaks.csv

   * Local maxima (extreme events)
   * Captures high-energy bursts

---

5. STEP 5 — STRUCTURAL PERCOLATION ANALYSIS

---

OPEN:
struc_perc_i_v2_5_0.html

FOR EACH LADDER:

```
ladder_trajectory.csv
ladder_gaps.csv
ladder_peaks.csv
```

DO:

```
1. Drag file into UI
2. Click:
    RUN FULL PRP
```

---

6. STEP 6 — ENGINE OUTPUT INTERPRETATION

---

KEY METRICS:

* Verdict:
  FULL / PARTIAL / FRAGMENTED

* Giant Ratio:
  Connectivity of system

* Median Gap:
  Structural scale indicator

* Outliers:
  Structural anomalies

* Phase Transition Signature:
  Stability vs fragmentation curve

---

7. STEP 7 — BATCH EXPORT

---

FILES:

* struc_perc_batch_results.csv
* struc_perc_batch_results.json

CONTAINS:
Aggregated results across ladders

---

8. STRUCTURAL INTERPRETATION (UNNS LEVEL)

---

ladder_trajectory:
→ global structural continuity

ladder_gaps:
→ collision discontinuities
→ MOST PHYSICALLY IMPORTANT

ladder_peaks:
→ high-energy extreme events

---

9. CRITICAL RULES

---

DO NOT:

✗ Sort ladders (breaks physics)
✗ Over-smooth signal
✗ Use ranked ladders
✗ Use prepare_for_struc_perc.py

ALWAYS:

✓ Preserve event order
✓ Use raw trajectory
✓ Analyze multiple ladders

---

10. EXTENSION PATH (NEXT STAGE)

---

CURRENT:
Static collision ensemble

NEXT:

A) Multi-channel ladders:
- invariant mass
- total energy
- transverse momentum (pt)

B) Time-evolving systems:
- supernova light curves
- seismic rupture data
- plasma bursts

---

## FINAL PIPELINE FLOW

2e2mu_2012.csv
↓
collision_to_trajectory.py
↓
unns_collision_trajectory.csv
↓
generate_ladders.py
↓
[trajectory | gaps | peaks]
↓
STRUC_PERC (HTML engine)
↓
struc_perc_batch_results

---

## STATUS

✔ Pipeline operational
✔ Data valid
✔ Structural regime detected

NEXT STEP:
Multi-ladder comparison OR cross-domain dataset
-----------------------------------------------
DATA source: https://opendata.cern.ch/record/5200