Skip to content

dancinlab/hexa-cern

Repository files navigation

πŸ’« hexa-cern

hexa-cern β€” n=6 sigma-cascade 6-order benchtop accelerator (100 MeV / 1 GeV/m, mini + parent + classical 3-pillar).

A petite, peer-of-Lumière standalone repo from the dancinlab org. Where Lumière takes the camera/character axes, hexa-cern takes the accelerator axis: three pillars distilled from the n6-architecture physics domain into a single MIT-licensed bundle.


Β§ Why β€” benchtop CERN

LHC fills a 27 km tunnel for 7 TeV. DESY runs a 1 GeV/m laser-plasma prototype on a research-lab footprint. hexa-cern's design target is a benchtop Οƒ-Ο†=10 GeV/m continuous-mode accelerator at 100 MeV total, threaded by the n=6 perfect-number lattice (Οƒ(6)=12, Ο„(6)=4, Ο†(6)=2).

The design ceiling β€” what the spec claims if Stage-1+ empirical builds confirm the Οƒ-cascade β€” is 6 orders of practical change vs current tech:

effect LHC/DESY current hexa-cern design ceiling
precision 1.0 unit Οƒ-Ο† = 10Γ— gain
throughput 1.0Γ— σ² = 144Γ—
energy cost 100% 1/Οƒ β‰ˆ 8.3%
equipment size 1.0 L (or 27 km) 1/(Οƒ-Ο†) = 0.1 L benchtop
error rate 1% 1/σ² β‰ˆ 0.7%
lifetime 1 year σ·τ = 48 months

This is the why: a CERN you can put on a bench, drawn from the same n=6 invariant that threads the rest of the HEXA family.


Β§ Verbs β€” 3 pillars

hexa-cern <pillar>            description                                  status
─────────────────────────────────────────────────────────────────────────────────────
hexa-cern mini                HEXA-MINI-ACCEL                              SPEC-ONLY
                                benchtop laser-plasma 100 MeV / 1 GeV/m
hexa-cern parent              HEXA-PACCEL                                  SPEC-ONLY
                                integrated parent particle accelerator
hexa-cern classical           HEXA-CLASSIC-ACCEL                           SPEC-ONLY
                                classical-mechanics baseline reference

Plus utility subcmds:

hexa-cern status              0/3-wired pillar table + verdict + caveats
hexa-cern selftest            3-pillar sentinel sweep
hexa-cern verify [<sub>]      n=6 invariant + per-pillar calculator audits
                                sub: all (default) | lattice | cross-doc
                                   | wakefield | sigma | classical | falsifier
hexa-cern --version           print version
hexa-cern --help              full usage

Pillar specs live under <pillar>/doc/:


Β§ Verification + Status

Status

v1.0.0 specs frozen + v1.1.0-pre .hexa runnable surface on main. 3-pillar bundle: HEXA-MINI-ACCEL (λ²€μΉ˜ν†± 100 MeV / 1 GeV/m laser-plasma)

  • HEXA-PACCEL (integrated parent) + HEXA-CLASSIC-ACCEL. LHC 7 TeV/27km & DESY 1 GeV/m 기쀀선에 λŒ€ν•œ n=6 Οƒ-cascade 6-order 비ꡐ가 paper-only둜 λͺ…μ‹œ. 싀증은 F-PCERN-1/2/3 falsifierκ°€ λ‹«νž λ•ŒκΉŒμ§€ UNVERIFIED.

v1.0.0 ships (frozen 2026-05-06):

  • 3 pillar specs (.md, extracted from n6-architecture@c0f1f570)
  • a cli/hexa-cern.hexa dispatcher with 3 pillar verbs + status / selftest

v1.1.0-pre adds (on main, 2026-05-07):

  • verify/ β€” 12 .hexa scripts auditing n=6 lattice + per-pillar derivations + numerical solvers
  • build/ β€” pandoc + xelatex Makefile that regenerates 3 pillar PDFs (clean)
  • tests/ β€” 4 .hexa test cases (+ test_all.hexa aggregator); 4/4 PASS
  • cli/hexa-cern.hexa verify [<sub>] β€” 6-runner aggregator subcommand
  • hexa.toml v1.1.0-pre [closure] block: verify_pass: 6/6, tests: 4/4

Zero .py was added β€” the runnable surface is 100% .hexa. This is deliberate: hexa-cern is a hexa-family member, and the migration target across dancinlab repos is .hexa-native tooling.

What it does not ship: actual particle acceleration, Geant4/MAD-X bridge, real-time beam diagnostics, LHC/DESY data ingestion. The Οƒ-cascade 6-order claim is a design-target ceiling, not a measurement.

Verification

The verify/ surface (all .hexa) audits n=6 closure + per-pillar derivations:

script check result
verify/lattice_check.hexa Οƒ(6)Β·Ο†(6) = nΒ·Ο„(6) = Jβ‚‚ = 24 across roadmap + 3 pillars 23/23 PASS
verify/cross_doc_audit.hexa LHC / DESY / OEIS / BT cross-link consistency 11/11 PASS
verify/calc_wakefield.hexa mini β€” E_peak = σ·(Οƒ-Ο†) = 120 GV/m, aβ‚€ = n = 6, R = 10 cm 6/6 PASS
verify/numerics_wakefield.hexa mini β€” closed-form plasma numerics (n_e, L_d via math_pure) 4/4 PASS
verify/calc_sigma_cascade.hexa parent β€” E_0..E_6 chain (10 MeV β†’ 100 TeV) 8/8 PASS
verify/numerics_sigma_cascade.hexa parent β€” relativistic Ξ³ progression numerics (Ξ³_6/Ξ³_2 β‰ˆ 10⁡, ultrarel) 10/10 PASS
verify/calc_classical.hexa classical β€” DOF = n = 6, phase-space dim = Οƒ = 12 11/11 PASS
verify/numerics_classical.hexa classical β€” symplectic leapfrog (Ο„=4 quadrants, 1-DOF, Ξ”state
verify/numerics_cross_pillar.hexa cross-pillar numerical consistency (mini ↔ parent ↔ classical, Ξ»_p / Ξ»_laser, Ξ³@100 MeV) 8/8 PASS
verify/numerics_lhc_parity.hexa F-PCERN-1 collider parity (LEP/Tevatron/LHC/FCC vs Οƒ-cascade) 10/10 PASS
verify/numerics_lwfa_parity.hexa F-PCERN-3 LWFA parity (BELLA/FACET/ATHENA/FLASHFwd vs hexa-cern design point) 7/7 PASS
verify/falsifier_check.hexa F-PCERN-1/2/3 preregister checklist 3/3 registered (UNVERIFIED v1.0)

Run them all with the unified CLI subcommand:

hexa-cern verify all      # 12/12 PASS expected

Or build the 3 pillar PDFs:

make -C build check       # verify pandoc + xelatex + hexa available
make -C build all         # rebuild all 3 pillar PDFs into build/out/

Empirical wiring (laser-plasma sandbox, parent integration, classical baseline solver) is deferred to Stage-1+ benchtop builds. See docs/cern_baseline.md for the LHC 7 TeV/27 km vs DESY 1 GeV/m vs HEXA Οƒ-Ο†=10 GeV/m comparison table, and docs/numerics_methodology.md for how the verify surface is structured (3-tier evidence ladder, F-PCERN closure pct, math_pure conventions, recipe for adding new numerics).


Β§ Install

# package manager (recommended)
hx install hexa-cern

# or clone directly:
git clone https://github.com/dancinlab/hexa-cern
cd hexa-cern
hexa run cli/hexa-cern.hexa status
hexa run cli/hexa-cern.hexa verify all   # 12/12 PASS expected

After hx install hexa-cern, the shim lands at ~/.hx/bin/hexa-cern. Run hexa-cern verify all from anywhere β€” the CLI auto-resolves PETITE_CERN_ROOT from ~/.hx/packages/hexa-cern.

Cost (Mac local): $0 β€” verify scripts are pure .hexa (file reads + arithmetic).


Β§ Repository layout

hexa-cern/
β”œβ”€β”€ README.md                     ← this file
β”œβ”€β”€ LICENSE                       ← MIT
β”œβ”€β”€ hexa.toml                     ← package manifest (hx install hexa-cern)
β”œβ”€β”€ install.hexa                  ← hx install hook (post-install selftest)
β”œβ”€β”€ .roadmap.hexa_cern            ← cross-cutting state (lattice / cycles / falsifiers)
β”œβ”€β”€ CHANGELOG.md                  ← release history
β”œβ”€β”€ RELEASE_NOTES_v1.0.0.md       ← v1.0.0 cut notes
β”‚
β”œβ”€β”€ mini/doc/mini-accelerator.md                            ← pillar 1 (47 KB)
β”œβ”€β”€ parent/doc/particle-accelerator.md                      ← pillar 2 (14 KB)
β”œβ”€β”€ classical/doc/classical-mechanics-accelerator.md        ← pillar 3 (47 KB)
β”‚
β”œβ”€β”€ cli/
β”‚   └── hexa-cern.hexa            ← CLI router (status/selftest/verify/mini/parent/classical)
β”œβ”€β”€ verify/                       ← v1.1.0-pre β€” n=6 audit surface (.hexa)
β”‚   β”œβ”€β”€ lattice_check.hexa            ← σ·φ = nΒ·Ο„ = Jβ‚‚ = 24 closure   (23/23)
β”‚   β”œβ”€β”€ cross_doc_audit.hexa          ← LHC/DESY/OEIS/BT cross-pillar (11/11)
β”‚   β”œβ”€β”€ calc_wakefield.hexa           ← mini β€” laser-wakefield n=6   ( 6/ 6)
β”‚   β”œβ”€β”€ numerics_wakefield.hexa       ← mini β€” closed-form n_e/L_d   ( 4/ 4)
β”‚   β”œβ”€β”€ numerics_lwfa_parity.hexa     ← mini β€” vs DESY/SLAC LWFA refs ( 7/ 7)
β”‚   β”œβ”€β”€ calc_sigma_cascade.hexa       ← parent β€” E_0..E_6 chain      ( 8/ 8)
β”‚   β”œβ”€β”€ numerics_sigma_cascade.hexa   ← parent β€” relativistic Ξ³      (10/10)
β”‚   β”œβ”€β”€ numerics_lhc_parity.hexa      ← parent β€” vs LEP/Tev/LHC/FCC  (10/10)
β”‚   β”œβ”€β”€ calc_classical.hexa           ← classical β€” Lagrange/Hamilton(11/11)
β”‚   β”œβ”€β”€ numerics_classical.hexa       ← classical β€” symplectic leap. ( 9/ 9)
β”‚   β”œβ”€β”€ numerics_cross_pillar.hexa    ← mini ↔ parent ↔ classical    ( 8/ 8)
β”‚   └── falsifier_check.hexa          ← F-PCERN-1/2/3 + closure %    (11/11)
β”œβ”€β”€ build/
β”‚   β”œβ”€β”€ Makefile                  ← pandoc + xelatex 3-PDF rebuild
β”‚   β”œβ”€β”€ header.tex                ← LaTeX include (CJK + monospace; soft-guarded)
β”‚   └── out/*.pdf                 ← generated, .gitignore'd
β”œβ”€β”€ tests/                        ← v1.1.0-pre β€” regression suite (.hexa)
β”‚   β”œβ”€β”€ test_selftest.hexa
β”‚   β”œβ”€β”€ test_lattice.hexa
β”‚   β”œβ”€β”€ test_calculators.hexa
β”‚   β”œβ”€β”€ test_cli_verify.hexa
β”‚   └── test_all.hexa             ← runs everything above (4/4 PASS)
└── docs/cern_baseline.md         ← LHC vs DESY vs hexa-cern comparison

The verify/ + build/ + tests/ triad is the canonical runnable surface for hexa-cern: every audit + every PDF + every test is .hexa end-to-end (no Python, no shell-only logic).


Β§ Cross-link

dependency / cousin repo role
SC magnet substrate dancinlab/hexa-rtsc superconducting magnet primitive
cousin (PET cyclotron, antimatter) dancinlab/hexa-antimatter parallel acceleration use case
Stage-3 propulsion dependent dancinlab/hexa-ufo downstream propulsion consumer

Provenance: extracted from n6-architecture at SHA c0f1f570 on 2026-05-06.

Sister repo (peer extraction): dancinlab/lumiere β€” camera-filter + hexa-main-character apps-axis.


Β§ License

MIT β€” see LICENSE.

Copyright (c) 2026 dancinlab (λ°•λ―Όμš° nerve011235@gmail.com)

About

πŸ’« hexa-cern β€” n=6 sigma-cascade 6-order benchtop accelerator (100 MeV / 1 GeV/m, mini + parent + classical 3-pillar).

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors