# guisf/riemann_zeta architecture

> Architecture diagram of the GitHub repository guisf/riemann_zeta, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/guisf/riemann_zeta
- Repository: https://github.com/guisf/riemann_zeta

## Overview

This repository is a scientific-computing toolkit for generating Riemann zeta zeros and using them to examine Montgomery’s pair-correlation conjecture and prime counting. The main workflow is to generate or supply zeros, compute correlation or prime-counting tables, then plot results. Separate command-line tools also compare, repair, and visualize zero data. Edges reflect the sampled calls and SOURCE INDEX references; unsampled behavior and wiring are not inferred.

Main entry points: [`lib/graphs.py`](https://github.com/guisf/riemann_zeta/blob/master/lib/graphs.py) (Plot engine), [`lib/prime.py`](https://github.com/guisf/riemann_zeta/blob/master/lib/prime.py) (Prime counting), [`lib/zeros.py`](https://github.com/guisf/riemann_zeta/blob/master/lib/zeros.py) (Zero algorithms), [`lib/gue2.py`](https://github.com/guisf/riemann_zeta/blob/master/lib/gue2.py) (Pair correlation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_zero["Zero computation"]
  node_generate["Zero tools<br/>[genzeros.py]"]
  node_zero_math["Zero algorithms<br/>[zeros.py]"]
  node_zero_files["Zero datasets"]
end

subgraph group_analysis["Numerical analysis"]
  node_raw_pair["Raw pair correlation<br/>[gue1.py]"]
  node_pair_analysis["Pair correlation<br/>[gue2.py]"]
  node_gue_cli["GUE command<br/>[gue.py]"]
  node_prime_cli["Prime-count command<br/>[prime_counting.py]"]
  node_prime_math["Prime counting<br/>[prime.py]"]
  node_analysis_tables["Analysis tables"]
end

subgraph group_plots["Scientific plots"]
  node_plot_engine["Plot engine<br/>[graphs.py]"]
  node_gue_plot["GUE plot command<br/>[guegraph.py]"]
  node_zero_plot["Zero plot command<br/>[zerosgraph.py]"]
  node_equation_plot["Equation plot command<br/>[transeq.py]"]
  node_figures["Generated figures"]
end

node_researcher(("Researcher"))

node_researcher -->|"runs"| node_generate
node_generate -->|"calls"| node_zero_math
node_zero_math -->|"writes zeros"| node_zero_files
node_researcher -->|"runs"| node_gue_cli
node_gue_cli -->|"calls"| node_pair_analysis
node_pair_analysis -->|"reads zeros"| node_zero_files
node_pair_analysis -->|"writes table"| node_analysis_tables
node_raw_pair -->|"uses"| node_zero_math
node_researcher -->|"runs"| node_prime_cli
node_prime_cli -->|"calls"| node_prime_math
node_prime_cli -->|"calls"| node_plot_engine
node_prime_math -->|"uses"| node_zero_math
node_prime_math -->|"reads zeros"| node_zero_files
node_prime_math -->|"writes table"| node_analysis_tables
node_researcher -->|"runs"| node_gue_plot
node_gue_plot -->|"calls"| node_plot_engine
node_plot_engine -->|"reads data"| node_analysis_tables
node_researcher -->|"runs"| node_zero_plot
node_zero_plot -->|"calls"| node_plot_engine
node_researcher -->|"runs"| node_equation_plot
node_equation_plot -->|"calls"| node_plot_engine
node_plot_engine -->|"uses"| node_zero_math
node_plot_engine -->|"uses"| node_prime_math
node_plot_engine -->|"writes figures"| node_figures

click node_generate "https://github.com/guisf/riemann_zeta/blob/master/genzeros.py"
click node_zero_math "https://github.com/guisf/riemann_zeta/blob/master/lib/zeros.py"
click node_zero_files "https://github.com/guisf/riemann_zeta/tree/master/data"
click node_raw_pair "https://github.com/guisf/riemann_zeta/blob/master/lib/gue1.py"
click node_pair_analysis "https://github.com/guisf/riemann_zeta/blob/master/lib/gue2.py"
click node_gue_cli "https://github.com/guisf/riemann_zeta/blob/master/gue.py"
click node_prime_cli "https://github.com/guisf/riemann_zeta/blob/master/prime_counting.py"
click node_prime_math "https://github.com/guisf/riemann_zeta/blob/master/lib/prime.py"
click node_plot_engine "https://github.com/guisf/riemann_zeta/blob/master/lib/graphs.py"
click node_gue_plot "https://github.com/guisf/riemann_zeta/blob/master/guegraph.py"
click node_zero_plot "https://github.com/guisf/riemann_zeta/blob/master/zerosgraph.py"
click node_equation_plot "https://github.com/guisf/riemann_zeta/blob/master/transeq.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_generate,node_zero_math,node_zero_files toneBlue
class node_raw_pair,node_pair_analysis,node_gue_cli,node_prime_cli,node_prime_math,node_analysis_tables toneAmber
class node_plot_engine,node_gue_plot,node_zero_plot,node_equation_plot,node_figures toneMint
class node_researcher toneIndigo
```

## Components

### Zero computation

- [Zero tools](https://github.com/guisf/riemann_zeta/blob/master/genzeros.py): `genzeros.py`
- [Zero algorithms](https://github.com/guisf/riemann_zeta/blob/master/lib/zeros.py): `lib/zeros.py`
- [Zero datasets](https://github.com/guisf/riemann_zeta/tree/master/data): `data`

### Numerical analysis

- [Raw pair correlation](https://github.com/guisf/riemann_zeta/blob/master/lib/gue1.py): `lib/gue1.py`
- [Pair correlation](https://github.com/guisf/riemann_zeta/blob/master/lib/gue2.py): `lib/gue2.py`
- [GUE command](https://github.com/guisf/riemann_zeta/blob/master/gue.py): `gue.py`
- [Prime-count command](https://github.com/guisf/riemann_zeta/blob/master/prime_counting.py): `prime_counting.py`
- [Prime counting](https://github.com/guisf/riemann_zeta/blob/master/lib/prime.py): `lib/prime.py`
- **Analysis tables**

### Scientific plots

- [Plot engine](https://github.com/guisf/riemann_zeta/blob/master/lib/graphs.py): `lib/graphs.py`
- [GUE plot command](https://github.com/guisf/riemann_zeta/blob/master/guegraph.py): `guegraph.py`
- [Zero plot command](https://github.com/guisf/riemann_zeta/blob/master/zerosgraph.py): `zerosgraph.py`
- [Equation plot command](https://github.com/guisf/riemann_zeta/blob/master/transeq.py): `transeq.py`
- **Generated figures**

### Other components

- **Researcher**

## Connections

- Researcher → Zero tools: runs (evidence: `genzeros.py`)
- Zero tools → Zero algorithms: calls (evidence: `genzeros.py`)
- Zero algorithms → Zero datasets: writes zeros (evidence: `lib/zeros.py`)
- Researcher → GUE command: runs (evidence: `gue.py`)
- GUE command → Pair correlation: calls (evidence: `gue.py`)
- Pair correlation → Zero datasets: reads zeros (evidence: `lib/gue2.py`)
- Pair correlation → Analysis tables: writes table (evidence: `lib/gue2.py`)
- Raw pair correlation → Zero algorithms: uses (evidence: `lib/gue1.py`)
- Researcher → Prime-count command: runs (evidence: `prime_counting.py`)
- Prime-count command → Prime counting: calls (evidence: `prime_counting.py`)
- Prime-count command → Plot engine: calls (evidence: `prime_counting.py`)
- Prime counting → Zero algorithms: uses (evidence: `lib/prime.py`)
- Prime counting → Zero datasets: reads zeros (evidence: `lib/prime.py`)
- Prime counting → Analysis tables: writes table (evidence: `lib/prime.py`)
- Researcher → GUE plot command: runs (evidence: `guegraph.py`)
- GUE plot command → Plot engine: calls (evidence: `guegraph.py`)
- Plot engine → Analysis tables: reads data (evidence: `lib/graphs.py`)
- Researcher → Zero plot command: runs (evidence: `zerosgraph.py`)
- Zero plot command → Plot engine: calls (evidence: `zerosgraph.py`)
- Researcher → Equation plot command: runs (evidence: `transeq.py`)
- Equation plot command → Plot engine: calls (evidence: `transeq.py`)
- Plot engine → Zero algorithms: uses (evidence: `lib/graphs.py`)
- Plot engine → Prime counting: uses (evidence: `lib/graphs.py`)
- Plot engine → Generated figures: writes figures (evidence: `lib/graphs.py`)
