# osman209/prime-number-studies architecture

> Architecture diagram of the GitHub repository osman209/prime-number-studies, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/osman209/prime-number-studies
- Repository: https://github.com/osman209/prime-number-studies

## Overview

Prime Number Studies is a collection of independent mathematical re-derivations, computational experiments, and scripts that regenerate reported results. The principal workflow is an engineer or reader running a study-specific verifier or harness to reproduce a table, measurement, or numerical check. The graph preserves major README themes and the documented spectral-form harness. Most individual verifiers and several harness modules were not sampled, so their internal calls are omitted rather than inferred.

Main entry points: [`harness/compare_families.py`](https://github.com/osman209/prime-number-studies/blob/main/harness/compare_families.py) (Family Comparison), [`harness/run_ladder.py`](https://github.com/osman209/prime-number-studies/blob/main/harness/run_ladder.py) (Inertia Ladder), [`harness/builder_periodic.py`](https://github.com/osman209/prime-number-studies/blob/main/harness/builder_periodic.py) (Periodic Builder), [`harness/conventions.py`](https://github.com/osman209/prime-number-studies/blob/main/harness/conventions.py) (Form Conventions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_arithmetic["Division Table"]
  node_division_verify["Table Verifier"]
  node_row_verify["Row Inheritance"]
  node_clock_verify["Sieve Clock"]
  node_angle_verify["Angle Lock"]
  node_division_results["Arithmetic Results"]
end

subgraph group_prime_studies["Prime Studies"]
  node_prime_gap["Prime Gap Study<br/>[prime_edge_rank.py]"]
  node_prime_detection["Detection Index<br/>[detection_index.py]"]
  node_prime_results["Prime Measurements"]
end

subgraph group_zeta_studies["Zeta Studies"]
  node_li_verify["Li Lens Checks<br/>[verify_li_lens.py]"]
  node_phase_verify["Phase Masking"]
  node_core_verify["Core Checks<br/>[verify_core.py]"]
  node_zeta_results["Zeta Results"]
end

subgraph group_spectral_harness["Spectral Harness"]
  node_conventions["Form Conventions<br/>[conventions.py]"]
  node_sine_builder["Sine Builder<br/>[builder_sine.py]"]
  node_periodic_builder["Periodic Builder"]
  node_validator["Zero Validator<br/>[validator.py]"]
  node_ladder["Inertia Ladder<br/>[run_ladder.py]"]
  node_family_compare["Family Comparison"]
  node_unseeded_scan["Odd Zero Scan"]
  node_spectral_results["Spectral Measurements"]
end

node_reader(("Researcher"))

node_reader -->|"runs verifier"| node_division_verify
node_reader -->|"runs verifier"| node_row_verify
node_reader -->|"runs verifier"| node_clock_verify
node_reader -->|"runs verifier"| node_angle_verify
node_division_verify -->|"reports checks"| node_division_results
node_row_verify -->|"reports checks"| node_division_results
node_clock_verify -->|"reports checks"| node_division_results
node_angle_verify -->|"reports checks"| node_division_results
node_reader -->|"runs study"| node_prime_gap
node_reader -->|"runs study"| node_prime_detection
node_prime_gap -->|"reports measurements"| node_prime_results
node_prime_detection -->|"reports measurements"| node_prime_results
node_reader -->|"runs verifier"| node_li_verify
node_reader -->|"runs verifier"| node_phase_verify
node_reader -->|"runs verifier"| node_core_verify
node_li_verify -->|"reports checks"| node_zeta_results
node_phase_verify -->|"reports checks"| node_zeta_results
node_core_verify -->|"reports checks"| node_zeta_results
node_sine_builder -->|"uses conventions"| node_conventions
node_periodic_builder -->|"uses conventions"| node_conventions
node_validator -->|"validates form"| node_conventions
node_reader -->|"runs sweep"| node_ladder
node_reader -->|"runs comparison"| node_family_compare
node_reader -->|"runs scan"| node_unseeded_scan
node_ladder -->|"builds matrices"| node_periodic_builder
node_family_compare -->|"builds family"| node_sine_builder
node_family_compare -->|"builds family"| node_periodic_builder
node_validator -->|"reports validation"| node_spectral_results
node_ladder -->|"reports inertia"| node_spectral_results
node_family_compare -->|"reports comparison"| node_spectral_results
node_unseeded_scan -->|"reports roots"| node_spectral_results

click node_division_verify "https://github.com/osman209/prime-number-studies/blob/main/code/verify_division_table.py"
click node_row_verify "https://github.com/osman209/prime-number-studies/blob/main/code/verify_row_inheritance.py"
click node_clock_verify "https://github.com/osman209/prime-number-studies/blob/main/code/verify_knowledge_clock.py"
click node_angle_verify "https://github.com/osman209/prime-number-studies/blob/main/code/verify_angle_lock.py"
click node_prime_gap "https://github.com/osman209/prime-number-studies/blob/main/code/prime_edge_rank.py"
click node_prime_detection "https://github.com/osman209/prime-number-studies/blob/main/code/detection_index.py"
click node_li_verify "https://github.com/osman209/prime-number-studies/blob/main/code/verify_li_lens.py"
click node_phase_verify "https://github.com/osman209/prime-number-studies/blob/main/code/verify_phase_masking.py"
click node_core_verify "https://github.com/osman209/prime-number-studies/blob/main/code/verify_core.py"
click node_conventions "https://github.com/osman209/prime-number-studies/blob/main/harness/conventions.py"
click node_sine_builder "https://github.com/osman209/prime-number-studies/blob/main/harness/builder_sine.py"
click node_periodic_builder "https://github.com/osman209/prime-number-studies/blob/main/harness/builder_periodic.py"
click node_validator "https://github.com/osman209/prime-number-studies/blob/main/harness/validator.py"
click node_ladder "https://github.com/osman209/prime-number-studies/blob/main/harness/run_ladder.py"
click node_family_compare "https://github.com/osman209/prime-number-studies/blob/main/harness/compare_families.py"
click node_unseeded_scan "https://github.com/osman209/prime-number-studies/blob/main/harness/odd_sector_unseeded_scan.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_division_verify,node_row_verify,node_clock_verify,node_angle_verify,node_division_results toneBlue
class node_prime_gap,node_prime_detection,node_prime_results toneAmber
class node_li_verify,node_phase_verify,node_core_verify,node_zeta_results toneMint
class node_conventions,node_sine_builder,node_periodic_builder,node_validator,node_ladder,node_family_compare,node_unseeded_scan,node_spectral_results toneRose
class node_reader toneIndigo
```

## Components

### Division Table

- [Table Verifier](https://github.com/osman209/prime-number-studies/blob/main/code/verify_division_table.py): `code/verify_division_table.py`
- [Row Inheritance](https://github.com/osman209/prime-number-studies/blob/main/code/verify_row_inheritance.py): `code/verify_row_inheritance.py`
- [Sieve Clock](https://github.com/osman209/prime-number-studies/blob/main/code/verify_knowledge_clock.py): `code/verify_knowledge_clock.py`
- [Angle Lock](https://github.com/osman209/prime-number-studies/blob/main/code/verify_angle_lock.py): `code/verify_angle_lock.py`
- **Arithmetic Results**

### Prime Studies

- [Prime Gap Study](https://github.com/osman209/prime-number-studies/blob/main/code/prime_edge_rank.py): `code/prime_edge_rank.py`
- [Detection Index](https://github.com/osman209/prime-number-studies/blob/main/code/detection_index.py): `code/detection_index.py`
- **Prime Measurements**

### Zeta Studies

- [Li Lens Checks](https://github.com/osman209/prime-number-studies/blob/main/code/verify_li_lens.py): `code/verify_li_lens.py`
- [Phase Masking](https://github.com/osman209/prime-number-studies/blob/main/code/verify_phase_masking.py): `code/verify_phase_masking.py`
- [Core Checks](https://github.com/osman209/prime-number-studies/blob/main/code/verify_core.py): `code/verify_core.py`
- **Zeta Results**

### Spectral Harness

- [Form Conventions](https://github.com/osman209/prime-number-studies/blob/main/harness/conventions.py): `harness/conventions.py`
- [Sine Builder](https://github.com/osman209/prime-number-studies/blob/main/harness/builder_sine.py): `harness/builder_sine.py`
- [Periodic Builder](https://github.com/osman209/prime-number-studies/blob/main/harness/builder_periodic.py): `harness/builder_periodic.py`
- [Zero Validator](https://github.com/osman209/prime-number-studies/blob/main/harness/validator.py): `harness/validator.py`
- [Inertia Ladder](https://github.com/osman209/prime-number-studies/blob/main/harness/run_ladder.py): `harness/run_ladder.py`
- [Family Comparison](https://github.com/osman209/prime-number-studies/blob/main/harness/compare_families.py): `harness/compare_families.py`
- [Odd Zero Scan](https://github.com/osman209/prime-number-studies/blob/main/harness/odd_sector_unseeded_scan.py): `harness/odd_sector_unseeded_scan.py`
- **Spectral Measurements**

### Other components

- **Researcher**

## Connections

- Researcher → Table Verifier: runs verifier
- Researcher → Row Inheritance: runs verifier
- Researcher → Sieve Clock: runs verifier
- Researcher → Angle Lock: runs verifier
- Table Verifier → Arithmetic Results: reports checks
- Row Inheritance → Arithmetic Results: reports checks
- Sieve Clock → Arithmetic Results: reports checks
- Angle Lock → Arithmetic Results: reports checks
- Researcher → Prime Gap Study: runs study
- Researcher → Detection Index: runs study
- Prime Gap Study → Prime Measurements: reports measurements
- Detection Index → Prime Measurements: reports measurements
- Researcher → Li Lens Checks: runs verifier
- Researcher → Phase Masking: runs verifier
- Researcher → Core Checks: runs verifier
- Li Lens Checks → Zeta Results: reports checks
- Phase Masking → Zeta Results: reports checks
- Core Checks → Zeta Results: reports checks
- Sine Builder → Form Conventions: uses conventions
- Periodic Builder → Form Conventions: uses conventions
- Zero Validator → Form Conventions: validates form
- Researcher → Inertia Ladder: runs sweep
- Researcher → Family Comparison: runs comparison
- Researcher → Odd Zero Scan: runs scan
- Inertia Ladder → Periodic Builder: builds matrices
- Family Comparison → Sine Builder: builds family
- Family Comparison → Periodic Builder: builds family
- Zero Validator → Spectral Measurements: reports validation
- Inertia Ladder → Spectral Measurements: reports inertia
- Family Comparison → Spectral Measurements: reports comparison
- Odd Zero Scan → Spectral Measurements: reports roots