# ravibalamv/shoe-measurement-ai-opencv architecture

> Architecture diagram of the GitHub repository ravibalamv/shoe-measurement-ai-opencv, 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/ravibalamv/shoe-measurement-ai-opencv
- Repository: https://github.com/ravibalamv/shoe-measurement-ai-opencv

## Overview

This repository is a shoe-measurement computer-vision application, with supporting camera-calibration and YOLO dataset/model workflows. Its primary workflow reads industrial-camera frames, detects shoes, isolates a shoe region, extracts its contour, then measures shoe length and detects/measures a blue tongue relative to the heel. Calibration scripts produce camera parameters or pixel-to-millimeter scale data. Dataset capture, splitting, training, and standalone prediction are separate workflows. The runtime calls are visible in the sampled entry point; relationships among the unsampled training and prediction pieces are not asserted.

Main entry points: [`shoe_measurement/main.py`](https://github.com/ravibalamv/shoe-measurement-ai-opencv/blob/main/shoe_measurement/main.py) (Measurement Loop), [`calculate_scale.py`](https://github.com/ravibalamv/shoe-measurement-ai-opencv/blob/main/calculate_scale.py) (Scale Calculator), [`calibration_images`](https://github.com/ravibalamv/shoe-measurement-ai-opencv/tree/main/calibration_images) (Calibration Images), [`split_dataset.py`](https://github.com/ravibalamv/shoe-measurement-ai-opencv/blob/main/split_dataset.py) (Dataset Splitter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_live["Live Measurement"]
  node_camera["Industrial Camera<br/>[camera.py]"]
  node_runtime["Measurement Loop<br/>[main.py]"]
  node_shoe_model["Shoe Detector<br/>[detector.py]"]
  node_background["Background Removal<br/>[background.py]"]
  node_contours["Contour Finder<br/>[contour.py]"]
  node_measure["Shoe Measurement<br/>[measurement.py]"]
  node_tongue["Tongue Detector<br/>[tongue.py]"]
end

subgraph group_calibration["Camera Calibration"]
  node_scale_calc["Scale Calculator<br/>[calculate_scale.py]"]
  node_scale_data["Scale Settings"]
  node_cal_capture["Calibration Capture"]
  node_camera_cal["Camera Calibration"]
  node_cal_images[("Calibration Images")]
end

subgraph group_dataset["Dataset Preparation"]
  node_dataset_capture["Dataset Capture<br/>[capture_dataset.py]"]
  node_raw_dataset[("Training Images")]
  node_splitter["Dataset Splitter<br/>[split_dataset.py]"]
  node_split_data[("Train Val Test")]
end

subgraph group_model["Model Workflow"]
  node_trainer["Model Training<br/>[train.py]"]
  node_predict["Standalone Prediction<br/>[predict.py]"]
  node_model_weights["Model Weights<br/>[best.pt]"]
end

node_operator(("Operator"))

node_operator -->|"starts"| node_runtime
node_camera -->|"provides frames"| node_runtime
node_runtime -->|"reads frames"| node_camera
node_runtime -->|"detects shoes"| node_shoe_model
node_runtime -->|"removes background"| node_background
node_runtime -->|"finds contour"| node_contours
node_runtime -->|"measures contour"| node_measure
node_runtime -->|"detects tongue"| node_tongue
node_scale_calc -->|"reads image"| node_cal_images
node_scale_calc -->|"writes scale"| node_scale_data
node_measure -->|"loads scale"| node_scale_data
node_tongue -->|"loads scale"| node_scale_data
node_cal_capture -->|"saves images"| node_cal_images
node_camera_cal -->|"reads images"| node_cal_images
node_dataset_capture -->|"saves captures"| node_raw_dataset
node_splitter -->|"reads images"| node_raw_dataset
node_splitter -->|"copies splits"| node_split_data
node_operator -->|"captures data"| node_dataset_capture
node_operator -->|"calibrates scale"| node_scale_calc

click node_camera "https://github.com/ravibalamv/shoe-measurement-ai-opencv/blob/main/shoe_measurement/modules/camera.py"
click node_runtime "https://github.com/ravibalamv/shoe-measurement-ai-opencv/blob/main/shoe_measurement/main.py"
click node_shoe_model "https://github.com/ravibalamv/shoe-measurement-ai-opencv/blob/main/shoe_measurement/modules/detector.py"
click node_background "https://github.com/ravibalamv/shoe-measurement-ai-opencv/blob/main/shoe_measurement/modules/background.py"
click node_contours "https://github.com/ravibalamv/shoe-measurement-ai-opencv/blob/main/shoe_measurement/modules/contour.py"
click node_measure "https://github.com/ravibalamv/shoe-measurement-ai-opencv/blob/main/shoe_measurement/modules/measurement.py"
click node_tongue "https://github.com/ravibalamv/shoe-measurement-ai-opencv/blob/main/shoe_measurement/modules/tongue.py"
click node_scale_calc "https://github.com/ravibalamv/shoe-measurement-ai-opencv/blob/main/calculate_scale.py"
click node_cal_capture "https://github.com/ravibalamv/shoe-measurement-ai-opencv/blob/main/capture_calibration.py"
click node_camera_cal "https://github.com/ravibalamv/shoe-measurement-ai-opencv/blob/main/camera_calibration.py"
click node_cal_images "https://github.com/ravibalamv/shoe-measurement-ai-opencv/tree/main/calibration_images"
click node_dataset_capture "https://github.com/ravibalamv/shoe-measurement-ai-opencv/blob/main/capture_dataset.py"
click node_raw_dataset "https://github.com/ravibalamv/shoe-measurement-ai-opencv/tree/main/train"
click node_splitter "https://github.com/ravibalamv/shoe-measurement-ai-opencv/blob/main/split_dataset.py"
click node_split_data "https://github.com/ravibalamv/shoe-measurement-ai-opencv/tree/main/dataset"
click node_trainer "https://github.com/ravibalamv/shoe-measurement-ai-opencv/blob/main/train.py"
click node_predict "https://github.com/ravibalamv/shoe-measurement-ai-opencv/blob/main/predict.py"
click node_model_weights "https://github.com/ravibalamv/shoe-measurement-ai-opencv/blob/main/shoe_measurement/best.pt"

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_camera,node_runtime,node_shoe_model,node_background,node_contours,node_measure,node_tongue toneBlue
class node_scale_calc,node_scale_data,node_cal_capture,node_camera_cal,node_cal_images toneAmber
class node_dataset_capture,node_raw_dataset,node_splitter,node_split_data toneMint
class node_trainer,node_predict,node_model_weights toneRose
class node_operator toneIndigo
```

## Components

### Live Measurement

- [Industrial Camera](https://github.com/ravibalamv/shoe-measurement-ai-opencv/blob/main/shoe_measurement/modules/camera.py): `shoe_measurement/modules/camera.py`
- [Measurement Loop](https://github.com/ravibalamv/shoe-measurement-ai-opencv/blob/main/shoe_measurement/main.py): `shoe_measurement/main.py`
- [Shoe Detector](https://github.com/ravibalamv/shoe-measurement-ai-opencv/blob/main/shoe_measurement/modules/detector.py): `shoe_measurement/modules/detector.py`
- [Background Removal](https://github.com/ravibalamv/shoe-measurement-ai-opencv/blob/main/shoe_measurement/modules/background.py): `shoe_measurement/modules/background.py`
- [Contour Finder](https://github.com/ravibalamv/shoe-measurement-ai-opencv/blob/main/shoe_measurement/modules/contour.py): `shoe_measurement/modules/contour.py`
- [Shoe Measurement](https://github.com/ravibalamv/shoe-measurement-ai-opencv/blob/main/shoe_measurement/modules/measurement.py): `shoe_measurement/modules/measurement.py`
- [Tongue Detector](https://github.com/ravibalamv/shoe-measurement-ai-opencv/blob/main/shoe_measurement/modules/tongue.py): `shoe_measurement/modules/tongue.py`

### Camera Calibration

- [Scale Calculator](https://github.com/ravibalamv/shoe-measurement-ai-opencv/blob/main/calculate_scale.py): `calculate_scale.py`
- **Scale Settings**
- [Calibration Capture](https://github.com/ravibalamv/shoe-measurement-ai-opencv/blob/main/capture_calibration.py): `capture_calibration.py`
- [Camera Calibration](https://github.com/ravibalamv/shoe-measurement-ai-opencv/blob/main/camera_calibration.py): `camera_calibration.py`
- [Calibration Images](https://github.com/ravibalamv/shoe-measurement-ai-opencv/tree/main/calibration_images): `calibration_images`

### Dataset Preparation

- [Dataset Capture](https://github.com/ravibalamv/shoe-measurement-ai-opencv/blob/main/capture_dataset.py): `capture_dataset.py`
- [Training Images](https://github.com/ravibalamv/shoe-measurement-ai-opencv/tree/main/train): `train`
- [Dataset Splitter](https://github.com/ravibalamv/shoe-measurement-ai-opencv/blob/main/split_dataset.py): `split_dataset.py`
- [Train Val Test](https://github.com/ravibalamv/shoe-measurement-ai-opencv/tree/main/dataset): `dataset`

### Model Workflow

- [Model Training](https://github.com/ravibalamv/shoe-measurement-ai-opencv/blob/main/train.py): `train.py`
- [Standalone Prediction](https://github.com/ravibalamv/shoe-measurement-ai-opencv/blob/main/predict.py): `predict.py`
- [Model Weights](https://github.com/ravibalamv/shoe-measurement-ai-opencv/blob/main/shoe_measurement/best.pt): `shoe_measurement/best.pt`

### Other components

- **Operator**

## Connections

- Operator → Measurement Loop: starts
- Industrial Camera → Measurement Loop: provides frames (evidence: `shoe_measurement/main.py`)
- Measurement Loop → Industrial Camera: reads frames (evidence: `shoe_measurement/main.py`)
- Measurement Loop → Shoe Detector: detects shoes (evidence: `shoe_measurement/main.py`)
- Measurement Loop → Background Removal: removes background (evidence: `shoe_measurement/main.py`)
- Measurement Loop → Contour Finder: finds contour (evidence: `shoe_measurement/main.py`)
- Measurement Loop → Shoe Measurement: measures contour (evidence: `shoe_measurement/main.py`)
- Measurement Loop → Tongue Detector: detects tongue (evidence: `shoe_measurement/main.py`)
- Scale Calculator → Calibration Images: reads image (evidence: `calculate_scale.py`)
- Scale Calculator → Scale Settings: writes scale (evidence: `calculate_scale.py`)
- Shoe Measurement → Scale Settings: loads scale (evidence: `shoe_measurement/modules/measurement.py`)
- Tongue Detector → Scale Settings: loads scale (evidence: `shoe_measurement/modules/tongue.py`)
- Calibration Capture → Calibration Images: saves images (evidence: `capture_calibration.py`)
- Camera Calibration → Calibration Images: reads images (evidence: `camera_calibration.py`)
- Dataset Capture → Training Images: saves captures (evidence: `capture_dataset.py`)
- Dataset Splitter → Training Images: reads images (evidence: `split_dataset.py`)
- Dataset Splitter → Train Val Test: copies splits (evidence: `split_dataset.py`)
- Operator → Dataset Capture: captures data (evidence: `capture_dataset.py`)
- Operator → Scale Calculator: calibrates scale (evidence: `calculate_scale.py`)
