# christy62/ml-project-digit-recognition architecture

> Architecture diagram of the GitHub repository christy62/ml-project-digit-recognition, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/christy62/ml-project-digit-recognition
- Repository: https://github.com/christy62/ml-project-digit-recognition

## Overview

This is a handwritten-digit classification project: its manually created image dataset represents digits 0–9 as 25×25 pixel arrays, and a PyTorch neural network is trained and evaluated on separate test data. The documented model uses a 128-neuron ReLU hidden layer and produces ten classes; evaluation includes a confusion matrix. The notebook is the only executable source shown, so internal processing stages are represented at the level supported by the README rather than inferred from unsampled code.

Main entry points: [`training_ml_digit_recognition.ipynb`](https://github.com/christy62/ml-project-digit-recognition/blob/main/training_ml_digit_recognition.ipynb) (Test evaluation), [`images`](https://github.com/christy62/ml-project-digit-recognition/tree/main/images) (Handwritten images)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["Image data"]
  node_image_dataset["Handwritten images"]
  node_test_set["Separate test set"]
end

subgraph group_model["Recognition model"]
  node_training["Train model"]
  node_digit_classifier["Digit classifier"]
end

subgraph group_evaluation["Model evaluation"]
  node_evaluation["Test evaluation"]
  node_confusion_matrix["Confusion matrix"]
end

node_user(("Project user"))

node_user -->|"creates"| node_image_dataset
node_image_dataset -->|"provides images"| node_training
node_training -->|"trains"| node_digit_classifier
node_test_set -->|"provides test data"| node_evaluation
node_digit_classifier -->|"is evaluated"| node_evaluation
node_evaluation -->|"generates"| node_confusion_matrix

click node_image_dataset "https://github.com/christy62/ml-project-digit-recognition/tree/main/images"
click node_training "https://github.com/christy62/ml-project-digit-recognition/blob/main/training_ml_digit_recognition.ipynb"
click node_digit_classifier "https://github.com/christy62/ml-project-digit-recognition/blob/main/training_ml_digit_recognition.ipynb"
click node_test_set "https://github.com/christy62/ml-project-digit-recognition/blob/main/training_ml_digit_recognition.ipynb"
click node_evaluation "https://github.com/christy62/ml-project-digit-recognition/blob/main/training_ml_digit_recognition.ipynb"
click node_confusion_matrix "https://github.com/christy62/ml-project-digit-recognition/blob/main/training_ml_digit_recognition.ipynb"

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_image_dataset,node_test_set,node_user toneBlue
class node_training,node_digit_classifier toneAmber
class node_evaluation,node_confusion_matrix toneMint
```

## Components

### Image data

- [Handwritten images](https://github.com/christy62/ml-project-digit-recognition/tree/main/images): `images`
- [Separate test set](https://github.com/christy62/ml-project-digit-recognition/blob/main/training_ml_digit_recognition.ipynb): `training_ml_digit_recognition.ipynb`

### Recognition model

- [Train model](https://github.com/christy62/ml-project-digit-recognition/blob/main/training_ml_digit_recognition.ipynb): `training_ml_digit_recognition.ipynb`
- [Digit classifier](https://github.com/christy62/ml-project-digit-recognition/blob/main/training_ml_digit_recognition.ipynb): `training_ml_digit_recognition.ipynb`

### Model evaluation

- [Test evaluation](https://github.com/christy62/ml-project-digit-recognition/blob/main/training_ml_digit_recognition.ipynb): `training_ml_digit_recognition.ipynb`
- [Confusion matrix](https://github.com/christy62/ml-project-digit-recognition/blob/main/training_ml_digit_recognition.ipynb): `training_ml_digit_recognition.ipynb`

### Other components

- **Project user**

## Connections

- Project user → Handwritten images: creates (evidence: `README.md`)
- Handwritten images → Train model: provides images (evidence: `README.md`)
- Train model → Digit classifier: trains (evidence: `README.md`)
- Separate test set → Test evaluation: provides test data (evidence: `README.md`)
- Digit classifier → Test evaluation: is evaluated (evidence: `README.md`)
- Test evaluation → Confusion matrix: generates (evidence: `README.md`)
