Packet Categories¶

Mathematical Packet Libraries of REVA v4.0

Overview¶

REVA v4.0 organizes packet structures into mathematical categories.

Rather than presenting a large collection of unrelated waveform definitions, packet families are grouped according to common mathematical relationships.

This approach improves:

organization,
navigation,
reproducibility,
scalability.

Category Hierarchy¶

All packet structures follow the same hierarchy.

Category
        ↓
Family
        ↓
Segment
        ↓
Packet Geometry
        ↓
Execution

Each level adds additional detail.

Purpose of Categories¶

Categories provide a framework for organizing packet families.

Each category is based upon a specific mathematical principle.

Examples include:

integer ratios,
recursive sequences,
proportional growth,
prime-number relationships.

Categories define the mathematical foundation from which packet families are derived.

Available Categories¶

Harmonic¶

Based on integer-ratio relationships.

harmonic

Subharmonic¶

Based on divisions of harmonic structures.

subharmonic

Octave¶

Based on powers-of-two relationships.

octave

Odd / Even¶

Based on parity relationships.

odd_even

Fibonacci¶

Based on recursive Fibonacci growth.

fibonacci

Lucas¶

Based on Lucas-number sequences.

lucas

Golden Ratio¶

Based on geometric scaling using the golden ratio.

golden_ratio

Prime¶

Based on prime-number relationships.

prime

Runtime Operation¶

Only one packet category is active at a time.

The active category determines which packet families are available during operation.

Active Category
        ↓
Available Families
        ↓
Family Selection
        ↓
Packet Execution

The category remains fixed while individual families may be selected.

Relationship to the Packet Engine¶

Packet categories do not generate timing.

Their purpose is to provide waveform geometry.

The Packet Executor converts this geometry into executable timing instructions.

Packet Category
        ↓
Packet Family
        ↓
Packet Executor
        ↓
Timer2 Scheduler
        ↓
Timer1 Carrier Engine

Category Comparison¶

The mathematical characteristics of each category are summarized in:

comparison_matrix

This page provides a side-by-side overview of the available packet libraries.

Design Philosophy¶

REVA treats packet families as members of larger mathematical systems.

This organization provides a structured method for exploring waveform geometries while maintaining consistency throughout the firmware.