# txstcodeplayground/codecs4337fall2026 architecture

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

- Interactive diagram: https://gitdiagram.com/txstcodeplayground/codecs4337fall2026
- Repository: https://github.com/txstcodeplayground/codecs4337fall2026

## Overview

This repository is a collection of self-contained CS4337 teaching projects for training and inspecting vision models, not one unified application. Its main workflow is to select a project and config, load a dataset, construct and train or evaluate a model, then inspect local results or tracking dashboards. The graph keeps the documented MLP/ConvNet progression, hyperparameter-search projects, and the U-Net, transfer-learning, and YOLO examples distinct. Edges reflect README-documented capabilities and progression; unsampled implementations are not inferred in detail.

Main entry points: [`HyperparameterSearchConvnets/main.py`](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/HyperparameterSearchConvnets/main.py) (ConvNet Search Run), [`LitWBTransferLearningResnet/main.py`](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/LitWBTransferLearningResnet/main.py) (Flowers-102 Transfer), [`UnetSemanticSegmentationExample/main.py`](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/UnetSemanticSegmentationExample/main.py) (U-Net Segmentation), [`TensorBoardTrainingBasicNeuralNetwork/main.py`](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/TensorBoardTrainingBasicNeuralNetwork/main.py) (TensorBoard MLP)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_foundations["Training Foundations"]
  node_plain_mlp["Plain MLP<br/>[main.py]"]
  node_mlp_model["MLP Model<br/>[mlp.py]"]
  node_mlp_trainer["MLP Trainer<br/>[trainer.py]"]
  node_plain_conv["Plain ConvNet<br/>[main.py]"]
  node_conv_trainer["ConvNet Trainer<br/>[trainer.py]"]
end

subgraph group_lightning["Lightning Training"]
  node_tensorboard["TensorBoard MLP<br/>[main.py]"]
  node_tb_trainer["TensorBoard Trainer<br/>[trainer.py]"]
  node_lit_mlp["Lightning MLP<br/>[main.py]"]
  node_lit_conv["Lightning ConvNet<br/>[main.py]"]
  node_wb_mlp["W&amp;B MLP<br/>[main.py]"]
  node_wb_conv["W&amp;B ConvNet<br/>[main.py]"]
end

subgraph group_search["Hyperparameter Search"]
  node_optuna_mlp["MLP Search<br/>[search.py]"]
  node_search_mlp_main["MLP Search Run<br/>[main.py]"]
  node_optuna_conv["ConvNet Search<br/>[search.py]"]
  node_search_conv_main["ConvNet Search Run<br/>[main.py]"]
  node_conv_blocks["ConvNet Blocks<br/>[convnet.py]"]
  node_search_litconv["Search Lightning Model<br/>[lit_convnet.py]"]
  node_search_data["Search Data Loader<br/>[fashion_mnist.py]"]
end

subgraph group_vision["Vision Applications"]
  node_flowers["Flowers-102 Transfer<br/>[main.py]"]
  node_flowers_data["Flowers Data Loader<br/>[flowers102.py]"]
  node_resnet["ResNet Model<br/>[resnet.py]"]
  node_flowers_eval["Evaluation Reports"]
  node_unet["U-Net Segmentation<br/>[main.py]"]
  node_kvasir["Kvasir Data Loader<br/>[kvasir_seg.py]"]
  node_unet_model["U-Net Models<br/>[unet.py]"]
  node_seg_callback["Segmentation Reports"]
  node_yolo["YOLO Detection<br/>[main.py]"]
  node_pennfudan["Penn-Fudan Data<br/>[pennfudan.py]"]
  node_yolo_model["YOLO Model Setup<br/>[loading.py]"]
end

subgraph group_observability["Experiment Outputs"]
  node_tb_logs["TensorBoard Logging"]
end

node_learner(("Learner"))
node_fashion[("Fashion-MNIST")]
node_wb_service["Weights &amp; Biases"]
node_tensorboard_service["TensorBoard Dashboard"]

node_learner -->|"runs project"| node_plain_mlp
node_learner -->|"runs project"| node_plain_conv
node_learner -->|"runs project"| node_tensorboard
node_learner -->|"runs project"| node_lit_mlp
node_learner -->|"runs project"| node_lit_conv
node_learner -->|"runs project"| node_wb_mlp
node_learner -->|"runs project"| node_wb_conv
node_learner -->|"runs search"| node_search_mlp_main
node_learner -->|"runs search"| node_search_conv_main
node_learner -->|"runs project"| node_flowers
node_learner -->|"runs project"| node_unet
node_learner -->|"runs project"| node_yolo
node_fashion -->|"training data"| node_plain_mlp
node_fashion -->|"training data"| node_plain_conv
node_mlp_trainer -.->|"trains model"| node_mlp_model
node_plain_conv -->|"uses trainer"| node_conv_trainer
node_plain_conv -->|"trains on"| node_fashion
node_tensorboard -->|"trains with"| node_tb_trainer
node_tensorboard -->|"logs metrics"| node_tb_logs
node_tb_logs -.->|"view events"| node_tensorboard_service
node_tensorboard -->|"builds on approach"| node_wb_mlp
node_lit_mlp -->|"adds tracking"| node_wb_mlp
node_lit_conv -->|"adds tracking"| node_wb_conv
node_wb_mlp -->|"tracks run"| node_wb_service
node_wb_conv -->|"tracks run"| node_wb_service
node_optuna_mlp -->|"searches parameters"| node_search_mlp_main
node_search_mlp_main -->|"logs best trial"| node_wb_service
node_optuna_conv -->|"searches architecture"| node_search_conv_main
node_search_conv_main -.->|"loads batches"| node_search_data
node_search_conv_main -.->|"builds network"| node_conv_blocks
node_search_conv_main -.->|"trains model"| node_search_litconv
node_search_conv_main -->|"logs results"| node_wb_service
node_flowers -.->|"loads dataset"| node_flowers_data
node_flowers -.->|"trains network"| node_resnet
node_flowers -->|"reports metrics"| node_flowers_eval
node_flowers -->|"logs report"| node_wb_service
node_unet -.->|"loads dataset"| node_kvasir
node_unet -.->|"trains model"| node_unet_model
node_unet -->|"reports predictions"| node_seg_callback
node_unet -->|"tracks experiment"| node_wb_service
node_yolo -->|"prepares data"| node_pennfudan
node_yolo -->|"loads weights"| node_yolo_model
node_yolo -->|"tracks run"| node_wb_service

click node_plain_mlp "https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/TrainingBasicNeuralNetwork/main.py"
click node_mlp_model "https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/TrainingBasicNeuralNetwork/models/mlp.py"
click node_mlp_trainer "https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/TrainingBasicNeuralNetwork/trainers/trainer.py"
click node_plain_conv "https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/TrainingBasicConvnet/main.py"
click node_conv_trainer "https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/TrainingBasicConvnet/trainers/trainer.py"
click node_tensorboard "https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/TensorBoardTrainingBasicNeuralNetwork/main.py"
click node_tb_trainer "https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/TensorBoardTrainingBasicNeuralNetwork/trainers/trainer.py"
click node_tb_logs "https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/TensorBoardTrainingBasicNeuralNetwork/utils/tensorboard_logging.py"
click node_lit_mlp "https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/LitTrainingBasicNeuralNetwork/main.py"
click node_lit_conv "https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/LitTrainingBasicConvnet/main.py"
click node_wb_mlp "https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/LitWBTrainingBasicNeuralNetwork/main.py"
click node_wb_conv "https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/LitWBTrainingBasicConvnet/main.py"
click node_optuna_mlp "https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/LitWBHSTrainingBasicNeuralNetwork/search.py"
click node_search_mlp_main "https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/LitWBHSTrainingBasicNeuralNetwork/main.py"
click node_optuna_conv "https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/HyperparameterSearchConvnets/search.py"
click node_search_conv_main "https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/HyperparameterSearchConvnets/main.py"
click node_conv_blocks "https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/HyperparameterSearchConvnets/models/components/convnet.py"
click node_search_litconv "https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/HyperparameterSearchConvnets/models/lit_convnet.py"
click node_search_data "https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/HyperparameterSearchConvnets/dataloaders/fashion_mnist.py"
click node_flowers "https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/LitWBTransferLearningResnet/main.py"
click node_flowers_data "https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/LitWBTransferLearningResnet/dataloaders/flowers102.py"
click node_resnet "https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/LitWBTransferLearningResnet/models/components/resnet.py"
click node_flowers_eval "https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/LitWBTransferLearningResnet/callbacks/wandb_evaluation.py"
click node_unet "https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/UnetSemanticSegmentationExample/main.py"
click node_kvasir "https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/UnetSemanticSegmentationExample/dataloaders/kvasir_seg.py"
click node_unet_model "https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/UnetSemanticSegmentationExample/models/components/unet.py"
click node_seg_callback "https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/UnetSemanticSegmentationExample/callbacks/wandb_segmentation.py"
click node_yolo "https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/YoloExample/main.py"
click node_pennfudan "https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/YoloExample/dataloaders/pennfudan.py"
click node_yolo_model "https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/YoloExample/models/loading.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_plain_mlp,node_mlp_model,node_mlp_trainer,node_plain_conv,node_conv_trainer toneBlue
class node_tensorboard,node_tb_trainer,node_lit_mlp,node_lit_conv,node_wb_mlp,node_wb_conv,node_fashion toneAmber
class node_optuna_mlp,node_search_mlp_main,node_optuna_conv,node_search_conv_main,node_conv_blocks,node_search_litconv,node_search_data toneMint
class node_flowers,node_flowers_data,node_resnet,node_flowers_eval,node_unet,node_kvasir,node_unet_model,node_seg_callback,node_yolo,node_pennfudan,node_yolo_model toneRose
class node_tb_logs,node_learner,node_wb_service,node_tensorboard_service toneIndigo
```

## Components

### Training Foundations

- [Plain MLP](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/TrainingBasicNeuralNetwork/main.py): `TrainingBasicNeuralNetwork/main.py`
- [MLP Model](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/TrainingBasicNeuralNetwork/models/mlp.py): `TrainingBasicNeuralNetwork/models/mlp.py`
- [MLP Trainer](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/TrainingBasicNeuralNetwork/trainers/trainer.py): `TrainingBasicNeuralNetwork/trainers/trainer.py`
- [Plain ConvNet](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/TrainingBasicConvnet/main.py): `TrainingBasicConvnet/main.py`
- [ConvNet Trainer](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/TrainingBasicConvnet/trainers/trainer.py): `TrainingBasicConvnet/trainers/trainer.py`

### Lightning Training

- [TensorBoard MLP](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/TensorBoardTrainingBasicNeuralNetwork/main.py): `TensorBoardTrainingBasicNeuralNetwork/main.py`
- [TensorBoard Trainer](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/TensorBoardTrainingBasicNeuralNetwork/trainers/trainer.py): `TensorBoardTrainingBasicNeuralNetwork/trainers/trainer.py`
- [Lightning MLP](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/LitTrainingBasicNeuralNetwork/main.py): `LitTrainingBasicNeuralNetwork/main.py`
- [Lightning ConvNet](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/LitTrainingBasicConvnet/main.py): `LitTrainingBasicConvnet/main.py`
- [W&B MLP](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/LitWBTrainingBasicNeuralNetwork/main.py): `LitWBTrainingBasicNeuralNetwork/main.py`
- [W&B ConvNet](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/LitWBTrainingBasicConvnet/main.py): `LitWBTrainingBasicConvnet/main.py`

### Hyperparameter Search

- [MLP Search](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/LitWBHSTrainingBasicNeuralNetwork/search.py): `LitWBHSTrainingBasicNeuralNetwork/search.py`
- [MLP Search Run](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/LitWBHSTrainingBasicNeuralNetwork/main.py): `LitWBHSTrainingBasicNeuralNetwork/main.py`
- [ConvNet Search](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/HyperparameterSearchConvnets/search.py): `HyperparameterSearchConvnets/search.py`
- [ConvNet Search Run](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/HyperparameterSearchConvnets/main.py): `HyperparameterSearchConvnets/main.py`
- [ConvNet Blocks](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/HyperparameterSearchConvnets/models/components/convnet.py): `HyperparameterSearchConvnets/models/components/convnet.py`
- [Search Lightning Model](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/HyperparameterSearchConvnets/models/lit_convnet.py): `HyperparameterSearchConvnets/models/lit_convnet.py`
- [Search Data Loader](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/HyperparameterSearchConvnets/dataloaders/fashion_mnist.py): `HyperparameterSearchConvnets/dataloaders/fashion_mnist.py`

### Vision Applications

- [Flowers-102 Transfer](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/LitWBTransferLearningResnet/main.py): `LitWBTransferLearningResnet/main.py`
- [Flowers Data Loader](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/LitWBTransferLearningResnet/dataloaders/flowers102.py): `LitWBTransferLearningResnet/dataloaders/flowers102.py`
- [ResNet Model](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/LitWBTransferLearningResnet/models/components/resnet.py): `LitWBTransferLearningResnet/models/components/resnet.py`
- [Evaluation Reports](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/LitWBTransferLearningResnet/callbacks/wandb_evaluation.py): `LitWBTransferLearningResnet/callbacks/wandb_evaluation.py`
- [U-Net Segmentation](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/UnetSemanticSegmentationExample/main.py): `UnetSemanticSegmentationExample/main.py`
- [Kvasir Data Loader](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/UnetSemanticSegmentationExample/dataloaders/kvasir_seg.py): `UnetSemanticSegmentationExample/dataloaders/kvasir_seg.py`
- [U-Net Models](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/UnetSemanticSegmentationExample/models/components/unet.py): `UnetSemanticSegmentationExample/models/components/unet.py`
- [Segmentation Reports](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/UnetSemanticSegmentationExample/callbacks/wandb_segmentation.py): `UnetSemanticSegmentationExample/callbacks/wandb_segmentation.py`
- [YOLO Detection](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/YoloExample/main.py): `YoloExample/main.py`
- [Penn-Fudan Data](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/YoloExample/dataloaders/pennfudan.py): `YoloExample/dataloaders/pennfudan.py`
- [YOLO Model Setup](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/YoloExample/models/loading.py): `YoloExample/models/loading.py`

### Experiment Outputs

- [TensorBoard Logging](https://github.com/txstcodeplayground/codecs4337fall2026/blob/main/TensorBoardTrainingBasicNeuralNetwork/utils/tensorboard_logging.py): `TensorBoardTrainingBasicNeuralNetwork/utils/tensorboard_logging.py`

### Other components

- **Learner**
- **Fashion-MNIST**
- **Weights & Biases**
- **TensorBoard Dashboard**

## Connections

- Learner → Plain MLP: runs project (evidence: `README.md`)
- Learner → Plain ConvNet: runs project (evidence: `README.md`)
- Learner → TensorBoard MLP: runs project (evidence: `README.md`)
- Learner → Lightning MLP: runs project (evidence: `README.md`)
- Learner → Lightning ConvNet: runs project (evidence: `README.md`)
- Learner → W&B MLP: runs project (evidence: `README.md`)
- Learner → W&B ConvNet: runs project (evidence: `README.md`)
- Learner → MLP Search Run: runs search (evidence: `README.md`)
- Learner → ConvNet Search Run: runs search (evidence: `README.md`)
- Learner → Flowers-102 Transfer: runs project (evidence: `README.md`)
- Learner → U-Net Segmentation: runs project (evidence: `README.md`)
- Learner → YOLO Detection: runs project (evidence: `README.md`)
- Fashion-MNIST → Plain MLP: training data (evidence: `README.md`)
- Fashion-MNIST → Plain ConvNet: training data (evidence: `README.md`)
- MLP Trainer → MLP Model: trains model
- Plain ConvNet → ConvNet Trainer: uses trainer (evidence: `TrainingBasicConvnet/main.py`)
- Plain ConvNet → Fashion-MNIST: trains on (evidence: `README.md`)
- TensorBoard MLP → TensorBoard Trainer: trains with (evidence: `TensorBoardTrainingBasicNeuralNetwork/main.py`)
- TensorBoard MLP → TensorBoard Logging: logs metrics (evidence: `TensorBoardTrainingBasicNeuralNetwork/main.py`)
- TensorBoard Logging → TensorBoard Dashboard: view events
- TensorBoard MLP → W&B MLP: builds on approach (evidence: `README.md`)
- Lightning MLP → W&B MLP: adds tracking (evidence: `README.md`)
- Lightning ConvNet → W&B ConvNet: adds tracking (evidence: `README.md`)
- W&B MLP → Weights & Biases: tracks run (evidence: `README.md`)
- W&B ConvNet → Weights & Biases: tracks run (evidence: `README.md`)
- MLP Search → MLP Search Run: searches parameters (evidence: `README.md`)
- MLP Search Run → Weights & Biases: logs best trial (evidence: `README.md`)
- ConvNet Search → ConvNet Search Run: searches architecture (evidence: `README.md`)
- ConvNet Search Run → Search Data Loader: loads batches
- ConvNet Search Run → ConvNet Blocks: builds network
- ConvNet Search Run → Search Lightning Model: trains model
- ConvNet Search Run → Weights & Biases: logs results (evidence: `HyperparameterSearchConvnets/main.py`)
- Flowers-102 Transfer → Flowers Data Loader: loads dataset
- Flowers-102 Transfer → ResNet Model: trains network
- Flowers-102 Transfer → Evaluation Reports: reports metrics (evidence: `LitWBTransferLearningResnet/main.py`)
- Flowers-102 Transfer → Weights & Biases: logs report (evidence: `README.md`)
- U-Net Segmentation → Kvasir Data Loader: loads dataset
- U-Net Segmentation → U-Net Models: trains model
- U-Net Segmentation → Segmentation Reports: reports predictions (evidence: `README.md`)
- U-Net Segmentation → Weights & Biases: tracks experiment (evidence: `README.md`)
- YOLO Detection → Penn-Fudan Data: prepares data (evidence: `YoloExample/main.py`)
- YOLO Detection → YOLO Model Setup: loads weights (evidence: `YoloExample/main.py`)
- YOLO Detection → Weights & Biases: tracks run (evidence: `README.md`)
