# dacorvo/tensorsandbox architecture

> Architecture diagram of the GitHub repository dacorvo/tensorsandbox, 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/dacorvo/tensorsandbox
- Repository: https://github.com/dacorvo/tensorsandbox

## Overview

This repository is a TensorFlow CIFAR-10 image-classification project. Its main workflow builds input batches, selects a CNN, trains it and saves checkpoints; evaluation restores checkpoints and reports predictions and accuracy. It also contains several selectable CNN families, graph-freezing and model-inspection utilities, and distributed-training support. The graph focuses on the CIFAR-10 runtime; source excerpts do not show all utility or model-family internals, so uncertain links are omitted.

Main entry points: [`cifar10/models/select.py`](https://github.com/dacorvo/tensorsandbox/blob/master/cifar10/models/select.py) (Model selector), [`cifar10/models/model.py`](https://github.com/dacorvo/tensorsandbox/blob/master/cifar10/models/model.py) (CNN base layers), [`cifar10/train.py`](https://github.com/dacorvo/tensorsandbox/blob/master/cifar10/train.py) (Training loop), [`cifar10/eval.py`](https://github.com/dacorvo/tensorsandbox/blob/master/cifar10/eval.py) (Evaluation loop)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_input["Data input"]
  node_data["Input pipeline<br/>[data.py]"]
end

subgraph group_models["Model architectures"]
  node_selector["Model selector<br/>[select.py]"]
  node_base_model["CNN base layers<br/>[model.py]"]
  node_alex["AlexNet variants"]
  node_nin["Network-in-Network variants"]
  node_squeeze["SqueezeNet variants"]
  node_convone["ConvOne<br/>[convone.py]"]
  node_cs231n["CS231n CNN<br/>[cs231n.py]"]
  node_tuto["Tutorial CNN<br/>[tuto.py]"]
end

subgraph group_runtime["Training and evaluation"]
  node_trainer["Training loop<br/>[train.py]"]
  node_cluster_train["Cluster training<br/>[train_cluster.py]"]
  node_job["Run configuration<br/>[job.py]"]
  node_checkpoints[("Model checkpoints")]
  node_evaluator["Evaluation loop<br/>[eval.py]"]
end

subgraph group_tools["Model utilities"]
  node_freezer["Graph freezing<br/>[freeze_graph.py]"]
  node_inspector["Model info<br/>[info.py]"]
end

node_user(("Operator"))
node_cifar[("CIFAR-10 files")]
node_dataset_site(("Dataset download"))

node_user -->|"starts training"| node_trainer
node_user -->|"starts evaluation"| node_evaluator
node_trainer -->|"requests batches"| node_data
node_evaluator -->|"requests eval data"| node_data
node_data -->|"reads records"| node_cifar
node_data -->|"downloads archive"| node_dataset_site
node_trainer -->|"selects model"| node_selector
node_evaluator -->|"selects model"| node_selector
node_selector -->|"dispatches variants"| node_alex
node_selector -->|"dispatches variants"| node_nin
node_selector -->|"dispatches variants"| node_squeeze
node_selector -->|"selects model"| node_convone
node_selector -->|"selects model"| node_cs231n
node_selector -->|"selects model"| node_tuto
node_trainer -->|"builds inference and loss"| node_base_model
node_evaluator -->|"builds inference"| node_base_model
node_alex -->|"inherits layers"| node_base_model
node_nin -->|"inherits layers"| node_base_model
node_squeeze -->|"inherits layers"| node_base_model
node_convone -->|"inherits layers"| node_base_model
node_cs231n -->|"inherits layers"| node_base_model
node_tuto -->|"inherits layers"| node_base_model
node_trainer -->|"saves checkpoints"| node_checkpoints
node_evaluator -->|"restores checkpoint"| node_checkpoints
node_cluster_train -->|"delegates training"| node_trainer
node_trainer -->|"imports config"| node_job
node_evaluator -->|"uses log config"| node_job
node_user -.->|"freezes graph"| node_freezer
node_freezer -->|"selects model"| node_selector
node_freezer -->|"uses run config"| node_job
node_user -.->|"inspects model"| node_inspector
node_inspector -->|"selects model"| node_selector
node_inspector -->|"uses data utilities"| node_data

click node_data "https://github.com/dacorvo/tensorsandbox/blob/master/cifar10/models/data.py"
click node_selector "https://github.com/dacorvo/tensorsandbox/blob/master/cifar10/models/select.py"
click node_base_model "https://github.com/dacorvo/tensorsandbox/blob/master/cifar10/models/model.py"
click node_alex "https://github.com/dacorvo/tensorsandbox/tree/master/cifar10/models/alex"
click node_nin "https://github.com/dacorvo/tensorsandbox/tree/master/cifar10/models/nin"
click node_squeeze "https://github.com/dacorvo/tensorsandbox/tree/master/cifar10/models/squeeze"
click node_convone "https://github.com/dacorvo/tensorsandbox/blob/master/cifar10/models/convone.py"
click node_cs231n "https://github.com/dacorvo/tensorsandbox/blob/master/cifar10/models/cs231n.py"
click node_tuto "https://github.com/dacorvo/tensorsandbox/blob/master/cifar10/models/tuto.py"
click node_trainer "https://github.com/dacorvo/tensorsandbox/blob/master/cifar10/train.py"
click node_cluster_train "https://github.com/dacorvo/tensorsandbox/blob/master/cifar10/train_cluster.py"
click node_job "https://github.com/dacorvo/tensorsandbox/blob/master/cifar10/job.py"
click node_checkpoints "https://github.com/dacorvo/tensorsandbox/tree/master/cifar10"
click node_evaluator "https://github.com/dacorvo/tensorsandbox/blob/master/cifar10/eval.py"
click node_freezer "https://github.com/dacorvo/tensorsandbox/blob/master/cifar10/freeze_graph.py"
click node_inspector "https://github.com/dacorvo/tensorsandbox/blob/master/cifar10/info.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_data toneBlue
class node_selector,node_base_model,node_alex,node_nin,node_squeeze,node_convone,node_cs231n,node_tuto,node_cifar toneAmber
class node_trainer,node_cluster_train,node_job,node_checkpoints,node_evaluator toneMint
class node_freezer,node_inspector toneRose
class node_user,node_dataset_site toneIndigo
```

## Components

### Data input

- [Input pipeline](https://github.com/dacorvo/tensorsandbox/blob/master/cifar10/models/data.py): `cifar10/models/data.py`

### Model architectures

- [Model selector](https://github.com/dacorvo/tensorsandbox/blob/master/cifar10/models/select.py): `cifar10/models/select.py`
- [CNN base layers](https://github.com/dacorvo/tensorsandbox/blob/master/cifar10/models/model.py): `cifar10/models/model.py`
- [AlexNet variants](https://github.com/dacorvo/tensorsandbox/tree/master/cifar10/models/alex): `cifar10/models/alex`
- [Network-in-Network variants](https://github.com/dacorvo/tensorsandbox/tree/master/cifar10/models/nin): `cifar10/models/nin`
- [SqueezeNet variants](https://github.com/dacorvo/tensorsandbox/tree/master/cifar10/models/squeeze): `cifar10/models/squeeze`
- [ConvOne](https://github.com/dacorvo/tensorsandbox/blob/master/cifar10/models/convone.py): `cifar10/models/convone.py`
- [CS231n CNN](https://github.com/dacorvo/tensorsandbox/blob/master/cifar10/models/cs231n.py): `cifar10/models/cs231n.py`
- [Tutorial CNN](https://github.com/dacorvo/tensorsandbox/blob/master/cifar10/models/tuto.py): `cifar10/models/tuto.py`

### Training and evaluation

- [Training loop](https://github.com/dacorvo/tensorsandbox/blob/master/cifar10/train.py): `cifar10/train.py`
- [Cluster training](https://github.com/dacorvo/tensorsandbox/blob/master/cifar10/train_cluster.py): `cifar10/train_cluster.py`
- [Run configuration](https://github.com/dacorvo/tensorsandbox/blob/master/cifar10/job.py): `cifar10/job.py`
- [Model checkpoints](https://github.com/dacorvo/tensorsandbox/tree/master/cifar10): `cifar10`
- [Evaluation loop](https://github.com/dacorvo/tensorsandbox/blob/master/cifar10/eval.py): `cifar10/eval.py`

### Model utilities

- [Graph freezing](https://github.com/dacorvo/tensorsandbox/blob/master/cifar10/freeze_graph.py): `cifar10/freeze_graph.py`
- [Model info](https://github.com/dacorvo/tensorsandbox/blob/master/cifar10/info.py): `cifar10/info.py`

### Other components

- **Operator**
- **CIFAR-10 files**
- **Dataset download**

## Connections

- Operator → Training loop: starts training (evidence: `cifar10/train.py`)
- Operator → Evaluation loop: starts evaluation (evidence: `cifar10/eval.py`)
- Training loop → Input pipeline: requests batches (evidence: `cifar10/train.py`)
- Evaluation loop → Input pipeline: requests eval data (evidence: `cifar10/eval.py`)
- Input pipeline → CIFAR-10 files: reads records (evidence: `cifar10/models/data.py`)
- Input pipeline → Dataset download: downloads archive (evidence: `cifar10/models/data.py`)
- Training loop → Model selector: selects model (evidence: `cifar10/train.py`)
- Evaluation loop → Model selector: selects model (evidence: `cifar10/eval.py`)
- Model selector → AlexNet variants: dispatches variants (evidence: `cifar10/models/select.py`)
- Model selector → Network-in-Network variants: dispatches variants (evidence: `cifar10/models/select.py`)
- Model selector → SqueezeNet variants: dispatches variants (evidence: `cifar10/models/select.py`)
- Model selector → ConvOne: selects model (evidence: `cifar10/models/select.py`)
- Model selector → CS231n CNN: selects model (evidence: `cifar10/models/select.py`)
- Model selector → Tutorial CNN: selects model (evidence: `cifar10/models/select.py`)
- Training loop → CNN base layers: builds inference and loss (evidence: `cifar10/train.py`)
- Evaluation loop → CNN base layers: builds inference (evidence: `cifar10/eval.py`)
- AlexNet variants → CNN base layers: inherits layers (evidence: `cifar10/models/alex/alex1.py`)
- Network-in-Network variants → CNN base layers: inherits layers (evidence: `cifar10/models/nin/nin.py`)
- SqueezeNet variants → CNN base layers: inherits layers (evidence: `cifar10/models/squeeze/squeezenet.py`)
- ConvOne → CNN base layers: inherits layers (evidence: `cifar10/models/convone.py`)
- CS231n CNN → CNN base layers: inherits layers (evidence: `cifar10/models/cs231n.py`)
- Tutorial CNN → CNN base layers: inherits layers (evidence: `cifar10/models/tuto.py`)
- Training loop → Model checkpoints: saves checkpoints (evidence: `cifar10/train.py`)
- Evaluation loop → Model checkpoints: restores checkpoint (evidence: `cifar10/eval.py`)
- Cluster training → Training loop: delegates training (evidence: `cifar10/train_cluster.py`)
- Training loop → Run configuration: imports config (evidence: `cifar10/train.py`)
- Evaluation loop → Run configuration: uses log config (evidence: `cifar10/eval.py`)
- Operator → Graph freezing: freezes graph (evidence: `cifar10/freeze_graph.py`)
- Graph freezing → Model selector: selects model (evidence: `cifar10/freeze_graph.py`)
- Graph freezing → Run configuration: uses run config (evidence: `cifar10/freeze_graph.py`)
- Operator → Model info: inspects model (evidence: `cifar10/info.py`)
- Model info → Model selector: selects model (evidence: `cifar10/info.py`)
- Model info → Input pipeline: uses data utilities (evidence: `cifar10/info.py`)
