Crate dodecet_encoder 

Dodecet Encoder

A revolutionary 12-bit dodecet encoding system optimized for geometric and calculus operations.

What is a Dodecet?

A dodecet is a 12-bit unit composed of 3 nibbles (4-bit sets):

┌─────────────────────────────────────────┐
│           DODECET (12 bits)             │
├─────────────────────────────────────────┤
│  Nibble 2  │  Nibble 1  │  Nibble 0    │
│  (4 bits)  │  (4 bits)  │  (4 bits)    │
│  [11:8]    │  [7:4]     │  [3:0]       │
├─────────────────────────────────────────┤
│  Example:   0xA        0xB        0xC  │
│  Hex: 0xABC = 1010 1011 1100 (binary)  │
└─────────────────────────────────────────┘

Why 12 Bits?

• Hex-Friendly: Each dodecet = 3 hex digits (e.g., 0xABC)
• Geometric: 12 bits can encode 4096 values (vs 256 for 8-bit)
• Calculus-Optimized: Natural alignment for derivatives and integrals
• Shape Encoding: Perfect for vertices, edges, faces (3D geometry)

Quick Start

use dodecet_encoder::{Dodecet, DodecetArray};

// Create a dodecet from hex
let d = Dodecet::from_hex(0xABC);

// Access nibbles
assert_eq!(d.nibble(0).unwrap(), 0xC);
assert_eq!(d.nibble(1).unwrap(), 0xB);
assert_eq!(d.nibble(2).unwrap(), 0xA);

// Geometric encoding: 3D point (x, y, z)
let point: DodecetArray<3> = DodecetArray::from_slice(&[0x123, 0x456, 0x789]);

Architecture

This crate provides:

• Core Types: Dodecet, DodecetArray, DodecetString
• Geometric Operations: Vector math, transformations, rotations
• Hex Encoding: Bidirectional hex conversion
• Performance: SIMD-optimized operations where possible

Re-exports

pub use dodecet::Dodecet;

pub use array::DodecetArray;

pub use string::DodecetString;

pub use geometric::Point3D;

pub use geometric::Vector3D;

pub use geometric::Transform3D;

Modules

array

DodecetArray: Fixed-size arrays of dodecets

calculus

Calculus operations with dodecet encoding

dodecet

Dodecet: The 12-bit Building Block

eisenstein

Eisenstein Constraint Module for Dodecet Encoder

geometric

Geometric Primitives with Dodecet Encoding

hex

Hex encoding/decoding utilities

lighthouse

PLATO Agent Runtime — Agents live in rooms, Forgemaster is the lighthouse.

seed_discovery

Seed Discovery Engine — Rapid Iteration with Tiny Models to Discover Response Tiles

simd

SIMD-optimized operations for dodecet processing

string

DodecetString: Variable-length strings of dodecets

temporal

Temporal Constraint Agent — Agentic Controls for Temporal Intelligence

Enums

DodecetError

Error type for dodecet operations

Constants

CAPACITY

Number of values a dodecet can represent

DODECET_BITS

Number of bits in a dodecet

MAX_DODECET

Maximum value of a dodecet (12 bits = 4095)

NIBBLES

Number of nibbles in a dodecet

Type Aliases

Result

Result type for dodecet operations