# mohdhamzakhan/image_checker architecture

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

- Interactive diagram: https://gitdiagram.com/mohdhamzakhan/image_checker
- Repository: https://github.com/mohdhamzakhan/image_checker

## Overview

Image_Checker is a Windows desktop image-inspection product with a separate command-line training entry point. The main user workflow is to configure or load a model, predict labels for images, review inspection outcomes, and optionally monitor incoming folders or update models from corrections. Its distinct capabilities include classical and neural training, one-class anomaly detection, explanations, demand forecasting, and hardware control. Edges are limited to relationships visible in excerpts or the source index; several included subsystems have no asserted links because their wiring was not shown.

Main entry points: [`Image_Checker.WinForm/Form1.cs`](https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker.WinForm/Form1.cs) (Inspection UI), [`Image_Checker.WinForm/ModelBuilderForm.Cnn.cs`](https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker.WinForm/ModelBuilderForm.Cnn.cs) (CNN builder UI), [`Image_Checker/Services/ExplainSession.cs`](https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/ExplainSession.cs) (Explanation session), [`Image_Checker/Services/OneClassChecker.cs`](https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/OneClassChecker.cs) (One-class anomaly detection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop inspection"]
  node_desktop_app["Inspection UI<br/>[Form1.cs]"]
  node_builders["Model builder UI"]
  node_cnn_builder["CNN builder UI"]
  node_sales_builder["Sales model builder"]
  node_prediction_ui["Prediction UI"]
end

subgraph group_data["Data and corrections"]
  node_dataset["Image dataset<br/>[ImageData.cs]"]
  node_preprocessing["Image preprocessing"]
  node_validation["Dataset validation<br/>[DataValidator.cs]"]
  node_corrections["Correction management"]
  node_merge["Correction merging"]
end

subgraph group_models["Model lifecycle"]
  node_predictor["Image prediction<br/>[Predictor.cs]"]
  node_trainer["Classical model training<br/>[ModelTrainer.cs]"]
  node_cnn["Torch image checker"]
  node_oneclass["One-class anomaly detection<br/>[OneClassChecker.cs]"]
  node_incremental["Incremental training"]
  node_true_incremental["True incremental training"]
end

subgraph group_insight["Insights and reporting"]
  node_explain["Explanation session<br/>[ExplainSession.cs]"]
  node_mismatch["Mismatch explanations"]
  node_forecast["Demand forecasting"]
  node_reports["Prediction reporting<br/>[Reportgenerator.cs]"]
end

subgraph group_operations["Monitoring and hardware"]
  node_monitor_ui["Monitoring UI"]
  node_folder_monitor["Folder image monitor"]
  node_usb_light["USB light control"]
  node_usb_power["USB port control"]
end

node_operator(("Operator"))
node_filesystem[("Image files")]

node_operator -->|"uses"| node_desktop_app
node_desktop_app -->|"predicts with"| node_predictor
node_desktop_app -->|"updates model"| node_incremental
node_desktop_app -->|"updates model"| node_true_incremental
node_desktop_app -->|"uses"| node_oneclass
node_desktop_app -->|"uses"| node_cnn
node_desktop_app -->|"merges corrections"| node_merge
node_desktop_app -->|"controls"| node_usb_light
node_desktop_app -->|"controls"| node_usb_power
node_builders -->|"uses"| node_preprocessing
node_sales_builder -->|"uses"| node_preprocessing
node_cnn_builder -->|"uses"| node_cnn
node_cnn_builder -->|"uses"| node_oneclass
node_cnn_builder -->|"trains"| node_oneclass
node_monitor_ui -->|"starts"| node_folder_monitor
node_monitor_ui -->|"uses"| node_mismatch
node_explain -->|"explains with"| node_mismatch
node_explain -->|"scores with"| node_predictor
node_explain -->|"reads image"| node_filesystem
node_filesystem -.->|"provides images"| node_dataset
node_operator -.->|"configures"| node_builders
node_operator -.->|"submits images"| node_prediction_ui
node_operator -.->|"configures"| node_sales_builder
node_trainer -->|"validates data"| node_validation
node_operator -.->|"requests forecast"| node_forecast
node_operator -.->|"requests report"| node_reports
node_filesystem -.->|"supplies images"| node_folder_monitor

click node_desktop_app "https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker.WinForm/Form1.cs"
click node_builders "https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker.WinForm/ModelBuilderForm.cs"
click node_cnn_builder "https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker.WinForm/ModelBuilderForm.Cnn.cs"
click node_sales_builder "https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker.Forms/ModelBuilderFormForSales.cs"
click node_prediction_ui "https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker.Forms/ModelPredictionForm.cs"
click node_dataset "https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/DataModels/ImageData.cs"
click node_preprocessing "https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/DataPreprocessor.cs"
click node_validation "https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/DataValidator.cs"
click node_corrections "https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/CorrectionManager.cs"
click node_merge "https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/CorrectionsMerger.cs"
click node_predictor "https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/Predictor.cs"
click node_trainer "https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/ModelTrainer.cs"
click node_cnn "https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/TorchImageChecker.cs"
click node_oneclass "https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/OneClassChecker.cs"
click node_incremental "https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/IncrementalModelTrainer.cs"
click node_true_incremental "https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/TrueIncrementalTrainer.cs"
click node_explain "https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/ExplainSession.cs"
click node_mismatch "https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/MismatchExplainer.cs"
click node_forecast "https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/SmartDemandForecastService.cs"
click node_reports "https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/Reportgenerator.cs"
click node_monitor_ui "https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker.WinForm/Form1.Monitoring.cs"
click node_folder_monitor "https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/FolderImageMonitor.cs"
click node_usb_light "https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/UsbLightController.cs"
click node_usb_power "https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/UsbPortPowerController.cs"

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_desktop_app,node_builders,node_cnn_builder,node_sales_builder,node_prediction_ui toneBlue
class node_dataset,node_preprocessing,node_validation,node_corrections,node_merge,node_filesystem toneAmber
class node_predictor,node_trainer,node_cnn,node_oneclass,node_incremental,node_true_incremental toneMint
class node_explain,node_mismatch,node_forecast,node_reports toneRose
class node_monitor_ui,node_folder_monitor,node_usb_light,node_usb_power,node_operator toneIndigo
```

## Components

### Desktop inspection

- [Inspection UI](https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker.WinForm/Form1.cs): `Image_Checker.WinForm/Form1.cs`
- [Model builder UI](https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker.WinForm/ModelBuilderForm.cs): `Image_Checker.WinForm/ModelBuilderForm.cs`
- [CNN builder UI](https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker.WinForm/ModelBuilderForm.Cnn.cs): `Image_Checker.WinForm/ModelBuilderForm.Cnn.cs`
- [Sales model builder](https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker.Forms/ModelBuilderFormForSales.cs): `Image_Checker.Forms/ModelBuilderFormForSales.cs`
- [Prediction UI](https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker.Forms/ModelPredictionForm.cs): `Image_Checker.Forms/ModelPredictionForm.cs`

### Data and corrections

- [Image dataset](https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/DataModels/ImageData.cs): `Image_Checker/DataModels/ImageData.cs`
- [Image preprocessing](https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/DataPreprocessor.cs): `Image_Checker/Services/DataPreprocessor.cs`
- [Dataset validation](https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/DataValidator.cs): `Image_Checker/Services/DataValidator.cs`
- [Correction management](https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/CorrectionManager.cs): `Image_Checker/Services/CorrectionManager.cs`
- [Correction merging](https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/CorrectionsMerger.cs): `Image_Checker/Services/CorrectionsMerger.cs`

### Model lifecycle

- [Image prediction](https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/Predictor.cs): `Image_Checker/Services/Predictor.cs`
- [Classical model training](https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/ModelTrainer.cs): `Image_Checker/Services/ModelTrainer.cs`
- [Torch image checker](https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/TorchImageChecker.cs): `Image_Checker/Services/TorchImageChecker.cs`
- [One-class anomaly detection](https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/OneClassChecker.cs): `Image_Checker/Services/OneClassChecker.cs`
- [Incremental training](https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/IncrementalModelTrainer.cs): `Image_Checker/Services/IncrementalModelTrainer.cs`
- [True incremental training](https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/TrueIncrementalTrainer.cs): `Image_Checker/Services/TrueIncrementalTrainer.cs`

### Insights and reporting

- [Explanation session](https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/ExplainSession.cs): `Image_Checker/Services/ExplainSession.cs`
- [Mismatch explanations](https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/MismatchExplainer.cs): `Image_Checker/Services/MismatchExplainer.cs`
- [Demand forecasting](https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/SmartDemandForecastService.cs): `Image_Checker/Services/SmartDemandForecastService.cs`
- [Prediction reporting](https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/Reportgenerator.cs): `Image_Checker/Services/Reportgenerator.cs`

### Monitoring and hardware

- [Monitoring UI](https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker.WinForm/Form1.Monitoring.cs): `Image_Checker.WinForm/Form1.Monitoring.cs`
- [Folder image monitor](https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/FolderImageMonitor.cs): `Image_Checker/Services/FolderImageMonitor.cs`
- [USB light control](https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/UsbLightController.cs): `Image_Checker/Services/UsbLightController.cs`
- [USB port control](https://github.com/mohdhamzakhan/image_checker/blob/master/Image_Checker/Services/UsbPortPowerController.cs): `Image_Checker/Services/UsbPortPowerController.cs`

### Other components

- **Operator**
- **Image files**

## Connections

- Operator → Inspection UI: uses
- Inspection UI → Image prediction: predicts with (evidence: `Image_Checker.WinForm/Form1.cs`)
- Inspection UI → Incremental training: updates model (evidence: `Image_Checker.WinForm/Form1.cs`)
- Inspection UI → True incremental training: updates model (evidence: `Image_Checker.WinForm/Form1.cs`)
- Inspection UI → One-class anomaly detection: uses (evidence: `Image_Checker.WinForm/Form1.cs`)
- Inspection UI → Torch image checker: uses (evidence: `Image_Checker.WinForm/Form1.cs`)
- Inspection UI → Correction merging: merges corrections (evidence: `Image_Checker.WinForm/Form1.cs`)
- Inspection UI → USB light control: controls (evidence: `Image_Checker.WinForm/Form1.cs`)
- Inspection UI → USB port control: controls (evidence: `Image_Checker.WinForm/Form1.cs`)
- Model builder UI → Image preprocessing: uses
- Sales model builder → Image preprocessing: uses (evidence: `Image_Checker.Forms/ModelBuilderFormForSales.cs`)
- CNN builder UI → Torch image checker: uses (evidence: `Image_Checker.WinForm/ModelBuilderForm.Cnn.cs`)
- CNN builder UI → One-class anomaly detection: uses (evidence: `Image_Checker.WinForm/ModelBuilderForm.Cnn.cs`)
- CNN builder UI → One-class anomaly detection: trains (evidence: `Image_Checker.WinForm/ModelBuilderForm.Cnn.cs`)
- Monitoring UI → Folder image monitor: starts (evidence: `Image_Checker.WinForm/Form1.Monitoring.cs`)
- Monitoring UI → Mismatch explanations: uses (evidence: `Image_Checker.WinForm/Form1.Monitoring.cs`)
- Explanation session → Mismatch explanations: explains with (evidence: `Image_Checker/Services/ExplainSession.cs`)
- Explanation session → Image prediction: scores with (evidence: `Image_Checker/Services/ExplainSession.cs`)
- Explanation session → Image files: reads image (evidence: `Image_Checker/Services/ExplainSession.cs`)
- Image files → Image dataset: provides images
- Operator → Model builder UI: configures
- Operator → Prediction UI: submits images
- Operator → Sales model builder: configures
- Classical model training → Dataset validation: validates data (evidence: `Image_Checker/Services/ModelTrainer.cs`)
- Operator → Demand forecasting: requests forecast
- Operator → Prediction reporting: requests report
- Image files → Folder image monitor: supplies images
