# canyon289/bayesian-model-evaluation architecture

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

- Interactive diagram: https://gitdiagram.com/canyon289/bayesian-model-evaluation
- Repository: https://github.com/canyon289/bayesian-model-evaluation

## Overview

This repository is a teaching tutorial for Bayesian model evaluation and criticism, delivered through Jupyter notebooks, lesson-plan material, and supporting examples. The README identifies the Bayesian refresher notebook as the learner’s starting point; it describes reproducible evaluation and sharing as tutorial goals. The graph preserves the documented subject areas without implying unverified notebook-to-notebook calls. Utility modules show example sampling and data-generation behavior; notebook internals were not sampled.

Main entry points: [`notebooks/1_BayesianWorkflow/1_Ins_BayesRefresher.ipynb`](https://github.com/canyon289/bayesian-model-evaluation/blob/master/notebooks/1_BayesianWorkflow/1_Ins_BayesRefresher.ipynb) (Bayes Refresher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Bayesian Workflow"]
  node_refresher["Bayes Refresher"]
  node_model_fitting["Model Fitting"]
  node_workflow_endtoend["End-to-End Workflow"]
  node_lessonplans["Lesson Plans<br/>[README.md]"]
end

subgraph group_data["Data and Models"]
  node_data_structures["Bayesian Data Structures"]
  node_treatment_data["Treatment Data Generator<br/>[plant_treatment.py]"]
  node_growth_data["Growth Data Generator<br/>[plant_growth.py]"]
  node_mh_sampler["Metropolis Sampler"]
  node_interactive_demo["Noisy Data Demo<br/>[noisyData.js]"]
end

subgraph group_diagnostics["Model Diagnostics"]
  node_visual_diagnostics["Visual Diagnostics"]
  node_numerical_diagnostics["Numerical Diagnostics"]
end

subgraph group_results["Results and Comparison"]
  node_single_results["Single-Model Results"]
  node_comparison["Model Comparison"]
end

node_learner(("Learner"))

node_learner -->|"opens first"| node_refresher

click node_refresher "https://github.com/canyon289/bayesian-model-evaluation/blob/master/notebooks/1_BayesianWorkflow/1_Ins_BayesRefresher.ipynb"
click node_model_fitting "https://github.com/canyon289/bayesian-model-evaluation/blob/master/notebooks/1_BayesianWorkflow/2_Stu_ModelFitting.ipynb"
click node_workflow_endtoend "https://github.com/canyon289/bayesian-model-evaluation/blob/master/notebooks/1_BayesianWorkflow/3_Ins_EndtoEndWorkflow.ipynb"
click node_data_structures "https://github.com/canyon289/bayesian-model-evaluation/blob/master/notebooks/2_DataStructures/1_Ins_DataStructures.ipynb"
click node_treatment_data "https://github.com/canyon289/bayesian-model-evaluation/blob/master/notebooks/utils/plant_treatment.py"
click node_growth_data "https://github.com/canyon289/bayesian-model-evaluation/blob/master/notebooks/utils/plant_growth.py"
click node_mh_sampler "https://github.com/canyon289/bayesian-model-evaluation/blob/master/notebooks/utils/metropolis_hastings.py"
click node_visual_diagnostics "https://github.com/canyon289/bayesian-model-evaluation/blob/master/notebooks/3_SinglePlotDiagnostics/1_Ins_SingleModelVisualDiagnostics.ipynb"
click node_numerical_diagnostics "https://github.com/canyon289/bayesian-model-evaluation/blob/master/notebooks/3_SinglePlotDiagnostics/3_Ins_SingleModelNumericalDiagnostics.ipynb"
click node_single_results "https://github.com/canyon289/bayesian-model-evaluation/blob/master/notebooks/4_SingleModelResults/1_Ins_SingleModelVisualization.ipynb"
click node_comparison "https://github.com/canyon289/bayesian-model-evaluation/blob/master/notebooks/5_ModelComparison/1_Ins_ModelComparison.ipynb"
click node_lessonplans "https://github.com/canyon289/bayesian-model-evaluation/blob/master/lessonplans/README.md"
click node_interactive_demo "https://github.com/canyon289/bayesian-model-evaluation/blob/master/img/noisyData.js"

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_refresher,node_model_fitting,node_workflow_endtoend,node_lessonplans toneBlue
class node_data_structures,node_treatment_data,node_growth_data,node_mh_sampler,node_interactive_demo toneAmber
class node_visual_diagnostics,node_numerical_diagnostics toneMint
class node_single_results,node_comparison toneRose
class node_learner toneIndigo
```

## Components

### Bayesian Workflow

- [Bayes Refresher](https://github.com/canyon289/bayesian-model-evaluation/blob/master/notebooks/1_BayesianWorkflow/1_Ins_BayesRefresher.ipynb): `notebooks/1_BayesianWorkflow/1_Ins_BayesRefresher.ipynb`
- [Model Fitting](https://github.com/canyon289/bayesian-model-evaluation/blob/master/notebooks/1_BayesianWorkflow/2_Stu_ModelFitting.ipynb): `notebooks/1_BayesianWorkflow/2_Stu_ModelFitting.ipynb`
- [End-to-End Workflow](https://github.com/canyon289/bayesian-model-evaluation/blob/master/notebooks/1_BayesianWorkflow/3_Ins_EndtoEndWorkflow.ipynb): `notebooks/1_BayesianWorkflow/3_Ins_EndtoEndWorkflow.ipynb`
- [Lesson Plans](https://github.com/canyon289/bayesian-model-evaluation/blob/master/lessonplans/README.md): `lessonplans/README.md`

### Data and Models

- [Bayesian Data Structures](https://github.com/canyon289/bayesian-model-evaluation/blob/master/notebooks/2_DataStructures/1_Ins_DataStructures.ipynb): `notebooks/2_DataStructures/1_Ins_DataStructures.ipynb`
- [Treatment Data Generator](https://github.com/canyon289/bayesian-model-evaluation/blob/master/notebooks/utils/plant_treatment.py): `notebooks/utils/plant_treatment.py`
- [Growth Data Generator](https://github.com/canyon289/bayesian-model-evaluation/blob/master/notebooks/utils/plant_growth.py): `notebooks/utils/plant_growth.py`
- [Metropolis Sampler](https://github.com/canyon289/bayesian-model-evaluation/blob/master/notebooks/utils/metropolis_hastings.py): `notebooks/utils/metropolis_hastings.py`
- [Noisy Data Demo](https://github.com/canyon289/bayesian-model-evaluation/blob/master/img/noisyData.js): `img/noisyData.js`

### Model Diagnostics

- [Visual Diagnostics](https://github.com/canyon289/bayesian-model-evaluation/blob/master/notebooks/3_SinglePlotDiagnostics/1_Ins_SingleModelVisualDiagnostics.ipynb): `notebooks/3_SinglePlotDiagnostics/1_Ins_SingleModelVisualDiagnostics.ipynb`
- [Numerical Diagnostics](https://github.com/canyon289/bayesian-model-evaluation/blob/master/notebooks/3_SinglePlotDiagnostics/3_Ins_SingleModelNumericalDiagnostics.ipynb): `notebooks/3_SinglePlotDiagnostics/3_Ins_SingleModelNumericalDiagnostics.ipynb`

### Results and Comparison

- [Single-Model Results](https://github.com/canyon289/bayesian-model-evaluation/blob/master/notebooks/4_SingleModelResults/1_Ins_SingleModelVisualization.ipynb): `notebooks/4_SingleModelResults/1_Ins_SingleModelVisualization.ipynb`
- [Model Comparison](https://github.com/canyon289/bayesian-model-evaluation/blob/master/notebooks/5_ModelComparison/1_Ins_ModelComparison.ipynb): `notebooks/5_ModelComparison/1_Ins_ModelComparison.ipynb`

### Other components

- **Learner**

## Connections

- Learner → Bayes Refresher: opens first (evidence: `README.md`)
