# syeddaniyalg/geodialect-hypothesis architecture

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

- Interactive diagram: https://gitdiagram.com/syeddaniyalg/geodialect-hypothesis
- Repository: https://github.com/syeddaniyalg/geodialect-hypothesis

## Overview

GeoDialect Hypothesis is a reproducible research artifact, not a packaged application: researchers prepare dialect datasets in notebooks, run experiments for three hypotheses, and analyze results for the paper. The reusable H1/H2/H3 implementations and their shared types are the main internal runtime layer; README documentation says H2 and H3 build on H1’s reusable computation state. The README also describes ablations, signal-regime analysis, and figure generation. Notebook internals were not sampled, so links involving those stages reflect documented workflow rather than inspected calls.

Main entry points: [`notebooks/hypothesis_experiments/native`](https://github.com/syeddaniyalg/geodialect-hypothesis/tree/main/notebooks/hypothesis_experiments/native) (Native experiments), [`src/geodialect/hypothesis_tests/h1.py`](https://github.com/syeddaniyalg/geodialect-hypothesis/blob/main/src/geodialect/hypothesis_tests/h1.py) (H1 predictive signal), [`src/geodialect/hypothesis_tests/_types.py`](https://github.com/syeddaniyalg/geodialect-hypothesis/blob/main/src/geodialect/hypothesis_tests/_types.py) (Inputs and results), [`notebooks/hypothesis_experiments/ablations`](https://github.com/syeddaniyalg/geodialect-hypothesis/tree/main/notebooks/hypothesis_experiments/ablations) (Ablation experiments)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_research["Research workflow"]
  node_dataset_docs["Dataset materials"]
  node_registry["Dataset registry<br/>[datasets.py]"]
  node_preprocessing["Dataset preprocessing"]
  node_defaults["Experiment defaults"]
end

subgraph group_experiments["Hypothesis experiments"]
  node_native["Native experiments"]
  node_ablations["Ablation experiments"]
end

subgraph group_analysis["Analysis and reporting"]
  node_outputs["Experiment outputs"]
  node_regime["Signal-regime analysis"]
  node_figures["Figure generation"]
  node_paper["Study paper"]
end

subgraph group_runtime["Reusable experiment code"]
  node_h1["H1 predictive signal<br/>[h1.py]"]
  node_h2["H2 field behavior<br/>[h2.py]"]
  node_h3["H3 exclusion<br/>[h3.py]"]
  node_types["Inputs and results<br/>[_types.py]"]
  node_engine["Cell execution helpers<br/>[_engine.py]"]
  node_metrics["Metrics and inference<br/>[metrics.py]"]
end

node_researcher(("Researcher"))

node_researcher -->|"prepares data"| node_preprocessing
node_dataset_docs -->|"guides preparation"| node_preprocessing
node_registry -->|"centralizes paths"| node_preprocessing
node_researcher -->|"runs experiments"| node_native
node_researcher -->|"runs experiments"| node_ablations
node_defaults -->|"supplies settings"| node_native
node_defaults -->|"supplies settings"| node_ablations
node_native -->|"runs H1"| node_h1
node_native -->|"runs H2"| node_h2
node_native -->|"runs H3"| node_h3
node_ablations -->|"evaluates hypotheses"| node_h1
node_h1 -->|"provides reusable state"| node_h2
node_h1 -->|"provides reusable state"| node_h3
node_native -->|"saves results"| node_outputs
node_ablations -->|"saves results"| node_outputs
node_outputs -->|"supports analysis"| node_regime
node_outputs -->|"supports figures"| node_figures
node_regime -->|"informs findings"| node_paper
node_figures -->|"produces figures"| node_paper
node_types -->|"defines inputs"| node_h1
node_types -->|"defines inputs"| node_h2
node_types -->|"defines inputs"| node_h3
node_engine -->|"provides helpers"| node_h1
node_engine -->|"provides helpers"| node_h2
node_engine -->|"provides helpers"| node_h3
node_metrics -->|"uses result types"| node_types

click node_dataset_docs "https://github.com/syeddaniyalg/geodialect-hypothesis/tree/main/datasets"
click node_registry "https://github.com/syeddaniyalg/geodialect-hypothesis/blob/main/configs/datasets.py"
click node_preprocessing "https://github.com/syeddaniyalg/geodialect-hypothesis/tree/main/notebooks/processing"
click node_defaults "https://github.com/syeddaniyalg/geodialect-hypothesis/blob/main/configs/hypothesis_defaults.py"
click node_native "https://github.com/syeddaniyalg/geodialect-hypothesis/tree/main/notebooks/hypothesis_experiments/native"
click node_ablations "https://github.com/syeddaniyalg/geodialect-hypothesis/tree/main/notebooks/hypothesis_experiments/ablations"
click node_h1 "https://github.com/syeddaniyalg/geodialect-hypothesis/blob/main/src/geodialect/hypothesis_tests/h1.py"
click node_h2 "https://github.com/syeddaniyalg/geodialect-hypothesis/blob/main/src/geodialect/hypothesis_tests/h2.py"
click node_h3 "https://github.com/syeddaniyalg/geodialect-hypothesis/blob/main/src/geodialect/hypothesis_tests/h3.py"
click node_types "https://github.com/syeddaniyalg/geodialect-hypothesis/blob/main/src/geodialect/hypothesis_tests/_types.py"
click node_engine "https://github.com/syeddaniyalg/geodialect-hypothesis/blob/main/src/geodialect/hypothesis_tests/_engine.py"
click node_metrics "https://github.com/syeddaniyalg/geodialect-hypothesis/blob/main/src/geodialect/hypothesis_tests/metrics.py"
click node_outputs "https://github.com/syeddaniyalg/geodialect-hypothesis/tree/main/results/hypothesis"
click node_regime "https://github.com/syeddaniyalg/geodialect-hypothesis/tree/main/notebooks/analysis"
click node_figures "https://github.com/syeddaniyalg/geodialect-hypothesis/tree/main/notebooks/post-processing"
click node_paper "https://github.com/syeddaniyalg/geodialect-hypothesis/tree/main/paper"

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_dataset_docs,node_registry,node_preprocessing,node_defaults toneBlue
class node_native,node_ablations toneAmber
class node_outputs,node_regime,node_figures,node_paper toneMint
class node_h1,node_h2,node_h3,node_types,node_engine,node_metrics toneRose
class node_researcher toneIndigo
```

## Components

### Research workflow

- [Dataset materials](https://github.com/syeddaniyalg/geodialect-hypothesis/tree/main/datasets): `datasets`
- [Dataset registry](https://github.com/syeddaniyalg/geodialect-hypothesis/blob/main/configs/datasets.py): `configs/datasets.py`
- [Dataset preprocessing](https://github.com/syeddaniyalg/geodialect-hypothesis/tree/main/notebooks/processing): `notebooks/processing`
- [Experiment defaults](https://github.com/syeddaniyalg/geodialect-hypothesis/blob/main/configs/hypothesis_defaults.py): `configs/hypothesis_defaults.py`

### Hypothesis experiments

- [Native experiments](https://github.com/syeddaniyalg/geodialect-hypothesis/tree/main/notebooks/hypothesis_experiments/native): `notebooks/hypothesis_experiments/native`
- [Ablation experiments](https://github.com/syeddaniyalg/geodialect-hypothesis/tree/main/notebooks/hypothesis_experiments/ablations): `notebooks/hypothesis_experiments/ablations`

### Analysis and reporting

- [Experiment outputs](https://github.com/syeddaniyalg/geodialect-hypothesis/tree/main/results/hypothesis): `results/hypothesis`
- [Signal-regime analysis](https://github.com/syeddaniyalg/geodialect-hypothesis/tree/main/notebooks/analysis): `notebooks/analysis`
- [Figure generation](https://github.com/syeddaniyalg/geodialect-hypothesis/tree/main/notebooks/post-processing): `notebooks/post-processing`
- [Study paper](https://github.com/syeddaniyalg/geodialect-hypothesis/tree/main/paper): `paper`

### Reusable experiment code

- [H1 predictive signal](https://github.com/syeddaniyalg/geodialect-hypothesis/blob/main/src/geodialect/hypothesis_tests/h1.py): `src/geodialect/hypothesis_tests/h1.py`
- [H2 field behavior](https://github.com/syeddaniyalg/geodialect-hypothesis/blob/main/src/geodialect/hypothesis_tests/h2.py): `src/geodialect/hypothesis_tests/h2.py`
- [H3 exclusion](https://github.com/syeddaniyalg/geodialect-hypothesis/blob/main/src/geodialect/hypothesis_tests/h3.py): `src/geodialect/hypothesis_tests/h3.py`
- [Inputs and results](https://github.com/syeddaniyalg/geodialect-hypothesis/blob/main/src/geodialect/hypothesis_tests/_types.py): `src/geodialect/hypothesis_tests/_types.py`
- [Cell execution helpers](https://github.com/syeddaniyalg/geodialect-hypothesis/blob/main/src/geodialect/hypothesis_tests/_engine.py): `src/geodialect/hypothesis_tests/_engine.py`
- [Metrics and inference](https://github.com/syeddaniyalg/geodialect-hypothesis/blob/main/src/geodialect/hypothesis_tests/metrics.py): `src/geodialect/hypothesis_tests/metrics.py`

### Other components

- **Researcher**

## Connections

- Researcher → Dataset preprocessing: prepares data (evidence: `README.md`)
- Dataset materials → Dataset preprocessing: guides preparation (evidence: `README.md`)
- Dataset registry → Dataset preprocessing: centralizes paths (evidence: `configs/datasets.py`)
- Researcher → Native experiments: runs experiments (evidence: `README.md`)
- Researcher → Ablation experiments: runs experiments (evidence: `README.md`)
- Experiment defaults → Native experiments: supplies settings (evidence: `configs/hypothesis_defaults.py`)
- Experiment defaults → Ablation experiments: supplies settings (evidence: `configs/hypothesis_defaults.py`)
- Native experiments → H1 predictive signal: runs H1 (evidence: `README.md`)
- Native experiments → H2 field behavior: runs H2 (evidence: `README.md`)
- Native experiments → H3 exclusion: runs H3 (evidence: `README.md`)
- Ablation experiments → H1 predictive signal: evaluates hypotheses (evidence: `README.md`)
- H1 predictive signal → H2 field behavior: provides reusable state (evidence: `src/geodialect/hypothesis_tests/h2.py`)
- H1 predictive signal → H3 exclusion: provides reusable state (evidence: `src/geodialect/hypothesis_tests/h3.py`)
- Native experiments → Experiment outputs: saves results (evidence: `README.md`)
- Ablation experiments → Experiment outputs: saves results (evidence: `README.md`)
- Experiment outputs → Signal-regime analysis: supports analysis (evidence: `README.md`)
- Experiment outputs → Figure generation: supports figures (evidence: `README.md`)
- Signal-regime analysis → Study paper: informs findings (evidence: `README.md`)
- Figure generation → Study paper: produces figures (evidence: `README.md`)
- Inputs and results → H1 predictive signal: defines inputs (evidence: `src/geodialect/hypothesis_tests/h1.py`)
- Inputs and results → H2 field behavior: defines inputs (evidence: `src/geodialect/hypothesis_tests/h2.py`)
- Inputs and results → H3 exclusion: defines inputs (evidence: `src/geodialect/hypothesis_tests/h3.py`)
- Cell execution helpers → H1 predictive signal: provides helpers (evidence: `src/geodialect/hypothesis_tests/h1.py`)
- Cell execution helpers → H2 field behavior: provides helpers (evidence: `src/geodialect/hypothesis_tests/h2.py`)
- Cell execution helpers → H3 exclusion: provides helpers (evidence: `src/geodialect/hypothesis_tests/h3.py`)
- Metrics and inference → Inputs and results: uses result types (evidence: `src/geodialect/hypothesis_tests/metrics.py`)
