Skip to content

diagrams

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

diagrams

README.md

RPP Diagrams and Visualizations

Visual documentation for the Rotational Packet Protocol specification.

⚠️ NOTICE: These diagrams depict the legacy 28-bit format. The current canonical format is Ra-Canonical v2.0 (32-bit): [θ:5][φ:3][h:3][r:8][reserved:13]. See spec/RPP-CANONICAL-v2.md for the authoritative specification.

Static Diagrams

Address Structure (Legacy 28-bit)

Address Structure

Shows the legacy 28-bit address layout with Shell, Theta, Phi, and Harmonic fields.

Bridge Architecture

Bridge Architecture

Illustrates how RPP routes to existing storage systems via the resolver layer.

Sector Map

Sector Map

Circular diagram showing the 8 functional sectors defined by theta values.

Interactive Visualization

RPP Address Explorer

Open interactive-explorer.html in a browser to:

  • Adjust Shell, Theta, Phi, and Harmonic values with sliders
  • See real-time address encoding (hex and decimal)
  • View bit-level representation with color-coded fields
  • Understand semantic interpretation (sector, grounding level, tier)
  • Visualize position on spherical coordinate representation

Usage

All diagrams are released under CC BY 4.0 license.

Embedding in Documentation

<img src="diagrams/address-structure.svg" alt="RPP Address Structure">

Hosting Interactive Explorer

The HTML file is self-contained with no external dependencies. Simply serve it from any web server or open directly in a browser.

Author

Alexander Liam Lennon

License

CC BY-SA 4.0 - See LICENSE in repository root.