Harmonic Packet Library¶
Mathematical Organization of Packet Families
Overview¶
The Harmonic Packet Library forms the mathematical foundation of REVA v4.0.
Rather than presenting hundreds of unrelated packet structures, REVA organizes waveform geometries into coherent mathematical categories.
This approach improves:
- navigation,
- reproducibility,
- scalability,
- operator usability.
Fundamental Philosophy¶
A packet family should not exist in isolation.
Families sharing common mathematical relationships are grouped together.
This creates a hierarchical organization:
Category
↓
Family
↓
Segment
↓
Pulse Count + Gap Time
Each level provides additional detail.
Why Categories Exist¶
Earlier approaches exposed large numbers of unrelated packet structures.
As the number of available families increased, navigation became increasingly difficult.
REVA v4.0 instead organizes packet structures according to mathematical relationships.
This allows families to be understood as members of a larger system.
Available Categories¶
Current categories include:
- Harmonic
- Subharmonic
- Octave
- Odd / Even
- Fibonacci
- Lucas
- Golden Ratio
- Prime
Each category contains multiple packet families.
Harmonic Category¶
Harmonic families are based on integer-ratio relationships.
Examples:
1
2
3
4
6
8
12
16
Characteristics:
- regular spacing,
- high symmetry,
- predictable structure.
Fibonacci Category¶
Fibonacci families are derived from recursive growth.
Example:
1
1
2
3
5
8
13
21
Characteristics:
- progressive expansion,
- asymmetry,
- natural growth patterns.
Lucas Category¶
Lucas families are closely related to Fibonacci structures.
Example:
2
1
3
4
7
11
18
29
Characteristics:
- recursive growth,
- Fibonacci-like behavior,
- alternative scaling relationships.
Golden Ratio Category¶
Golden Ratio families are derived from:
( \phi = 1.6180339887... )
Characteristics:
- self-similarity,
- proportional growth,
- geometric scaling.
Prime Category¶
Prime-based families use prime number relationships.
Example:
2
3
5
7
11
13
17
19
Characteristics:
- irregular spacing,
- reduced symmetry,
- non-periodic geometry.
Compile-Time Category Selection¶
The active category is selected within the firmware.
Example:
#define ACTIVE_PACKET_CATEGORY CATEGORY_GOLDEN_RATIO
This decision was intentional.
The operator typically selects:
- carrier frequency,
- packet category,
during firmware configuration.
Runtime controls are then reserved for:
- family selection,
- pulse scaling,
- gap scaling.
This prevents excessive menu complexity.
Runtime Operation¶
During operation the operator works within a selected category.
Example:
Golden Ratio Category
↓
Family 1
Family 2
Family 3
Family 4
The category remains fixed while families can be explored.
Relationship to Packet Executor¶
The packet library defines waveform geometry.
The Packet Executor converts that geometry into timing instructions.
Packet Library
↓
Packet Executor
↓
Timer2
↓
Timer1
The library defines.
The executor performs.
Engineering Perspective¶
The Harmonic Packet Library can be viewed as a mathematical database.
Mathematical Relationships
↓
Packet Families
↓
Packet Geometry
↓
Execution
This organization is one of the defining architectural features of REVA v4.0.