GD_xPRIMEray: Curved Ray Transport Engine for GRIN Fields¶

A research-grade ray propagation framework for Godot, combining gradient-index (GRIN) optics with symbolic + numerical ray integration.
Positioned as both a scientific research toolkit and an open-source GPU/CPU optical transport engine.

Overview¶

GD_xPRIMEray is a hybrid symbolic-numeric ray transport system built on Godot Engine. It augments Godot’s renderer with curved ray physics — enabling simulation of graded refractive media, advanced optical phenomena, and non-Euclidean propagation domains.

Rather than tracing straight rays through space, GD_xPRIMEray integrates rays through fields defined by continuous curvature functions, enabling higher-fidelity modeling of refractive and metric-driven transport.

Documentation Hub¶

Start here¶

System Architecture — compact pipeline summary
Architecture Overview — renderer structure and subsystem boundaries
Architecture Review — deeper review of renderer behavior and architecture constraints
Code Map (Big 12) — contributor-facing code map
Validation Framework — validation modes and verification context
Boundary Layer Fixtures — validation fixtures for BoundaryLayerVolume crossing behavior, policies, and nested shell ordering
Specification Index — full spec map, current vs legacy, and support docs
Architecture Charter (Current) — current working charter

Physics and transport references¶

Current / revised specifications¶

Legacy baseline specifications¶

These are still useful for historical context and design evolution comparison.

Calibration roadmap patch logs¶

🔬 Research & Experimental Frameworks¶

Curved Ray Transport Model Review
GRIN Fixture Auto-Calibration Framework
Fixture Research Note Pattern — shared note/template guidance, including canonical analysis basis declarations for future fixtures
Fixture 001: Radial GRIN Baseline — baseline note for the A2 scheduler-clean run plus the first fully verified control-surface characterization pass
Fixture 002: Linear Transport Baseline — next sub-canonical / xZeno-canonical characterization fixture using the same hardened pipeline with a simpler single-row control surface
Fixture 003: Offset Field Baseline — first spatial-regime shift after Fixture 002, keeping the single-row topology while moving the field center off-axis to create a clean asymmetry baseline
Fixture 004: Dual Attractor Baseline — first multi-attractor characterization fixture, keeping the Fixture 003 operating style while replacing the single field center with two controlled horizontal attractors

Symmetric fixtures usually map cleanly to image-center analysis because the effective field center and image center remain aligned. Asymmetric fixtures should prefer field-relative analysis as the primary basis, while keeping image-center artifacts as companion diagnostics for screen-space interpretation.

Archive¶

Notes¶

The MkDocs configuration should set docs_dir: Docs so GitHub Actions builds from the correct capitalized folder.
The current navigation treats _1 spec files as the active revised versions, while the non-_1 files are retained as legacy baselines.
The current index.md intentionally avoids linking to non-existent assets like icon.webp or missing screenshot paths.