# unknown-xenon-star/depth_measure_opencv architecture

> Architecture diagram of the GitHub repository unknown-xenon-star/depth_measure_opencv, 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/unknown-xenon-star/depth_measure_opencv
- Repository: https://github.com/unknown-xenon-star/depth_measure_opencv

## Overview

The repository contains two related but distinct stereo-vision tracks: a documented depth-measurement workflow under `04-09-2026`, and an experimental live object/gimbal-tracking workflow under `main`. The first accepts stereo images, rectifies them, computes disparity and depth, and can assess confidence and evaluation metrics. The second includes stereo tracking, segmentation, and distance/depth utilities. The README also describes camera calibration, object detection, distance measurement, and visualization; several of those capabilities are represented by unsampled modules, so their internal links are omitted where evidence is unavailable.

Main entry points: [`04-09-2026/main.py`](https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/main.py) (Depth runner), [`04-09-2026/confidence/fusion.py`](https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/confidence/fusion.py) (Confidence fusion), [`main/gimbal_tracker_vpython_bt.py`](https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/main/gimbal_tracker_vpython_bt.py) (Gimbal tracker), [`main/gimbal_tracker_vpython_usb.py`](https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/main/gimbal_tracker_vpython_usb.py) (USB tracker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_stereo["Stereo depth"]
  node_stereo_app["Depth runner<br/>[main.py]"]
  node_calibration["Calibration loader<br/>[loader.py]"]
  node_cal_models["Calibration models<br/>[models.py]"]
  node_rectifier["Stereo rectifier<br/>[rectifier.py]"]
  node_sgbm["SGBM matching<br/>[sgbm.py]"]
  node_wls["WLS filtering<br/>[wls.py]"]
  node_depth_converter["Depth conversion<br/>[converter.py]"]
end

subgraph group_quality["Confidence evaluation"]
  node_confidence_api["Confidence package<br/>[__init__.py]"]
  node_confidence_config["Confidence settings<br/>[configs.py]"]
  node_confidence_fusion["Confidence fusion<br/>[fusion.py]"]
  node_lr_quality["LR consistency<br/>[lr_consistency.py]"]
  node_matching_quality["Matching quality"]
  node_texture_quality["Texture confidence<br/>[texture.py]"]
  node_gradient_quality["Gradient confidence<br/>[gradient.py]"]
  node_occlusion_quality["Occlusion confidence<br/>[occlusion.py]"]
  node_geometry_quality["Geometry confidence<br/>[geometry.py]"]
  node_evaluator["Evaluation runner<br/>[evaluator.py]"]
  node_metrics["Evaluation metrics<br/>[metrics.py]"]
end

subgraph group_tracking["Live tracking"]
  node_tracker["Gimbal tracker"]
  node_tracker_usb["USB tracker"]
  node_main_config["Tracker settings<br/>[config.py]"]
end

subgraph group_vision["Tracking vision"]
  node_disparity_tool["Disparity utility<br/>[disparity_map.py]"]
  node_depth_tool["Depth utility<br/>[depth_utils.py]"]
  node_detection["Object detection<br/>[detection.py]"]
  node_hsv["HSV filtering<br/>[hsv_filter.py]"]
  node_segmentation["Hybrid segmentation"]
  node_kalman["Depth tracking<br/>[kalman_filter.py]"]
  node_gimbal_control["Gimbal control"]
end

node_user(("Image user"))

node_user -->|"provides stereo pair"| node_stereo_app
node_stereo_app -->|"loads calibration"| node_calibration
node_stereo_app -->|"rectifies pair"| node_rectifier
node_rectifier -->|"uses parameters"| node_cal_models
node_stereo_app -->|"computes disparity"| node_sgbm
node_stereo_app -->|"filters disparity"| node_wls
node_stereo_app -->|"converts disparity"| node_depth_converter
node_stereo_app -->|"computes confidence"| node_confidence_api
node_confidence_fusion -->|"uses settings"| node_confidence_config
node_confidence_fusion -->|"fuses component"| node_lr_quality
node_confidence_fusion -->|"fuses component"| node_matching_quality
node_confidence_fusion -->|"fuses component"| node_texture_quality
node_confidence_fusion -->|"fuses component"| node_gradient_quality
node_confidence_fusion -->|"fuses component"| node_occlusion_quality
node_confidence_fusion -->|"fuses component"| node_geometry_quality
node_stereo_app -->|"runs evaluation"| node_evaluator
node_evaluator -->|"computes metrics"| node_metrics
node_tracker -->|"computes disparity"| node_disparity_tool
node_tracker -->|"uses depth utility"| node_depth_tool
node_tracker -->|"detects objects"| node_detection
node_tracker -->|"filters colors"| node_hsv
node_tracker -->|"segments frames"| node_segmentation
node_tracker -->|"filters depth"| node_kalman
node_tracker_usb -->|"computes disparity"| node_disparity_tool
node_tracker_usb -->|"uses depth utility"| node_depth_tool
node_tracker_usb -->|"detects objects"| node_detection
node_tracker_usb -->|"filters colors"| node_hsv
node_tracker_usb -->|"segments frames"| node_segmentation
node_tracker_usb -->|"filters depth"| node_kalman
node_tracker -->|"reads settings"| node_main_config
node_tracker_usb -->|"reads settings"| node_main_config

click node_stereo_app "https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/main.py"
click node_calibration "https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/calibration/loader.py"
click node_cal_models "https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/calibration/models.py"
click node_rectifier "https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/stereo/rectifier.py"
click node_sgbm "https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/stereo/disparity/sgbm.py"
click node_wls "https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/stereo/disparity/wls.py"
click node_depth_converter "https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/depth/converter.py"
click node_confidence_api "https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/confidence/__init__.py"
click node_confidence_config "https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/confidence/configs.py"
click node_confidence_fusion "https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/confidence/fusion.py"
click node_lr_quality "https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/confidence/lr_consistency.py"
click node_matching_quality "https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/confidence/matching_quality.py"
click node_texture_quality "https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/confidence/texture.py"
click node_gradient_quality "https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/confidence/gradient.py"
click node_occlusion_quality "https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/confidence/occlusion.py"
click node_geometry_quality "https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/confidence/geometry.py"
click node_evaluator "https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/evaluation/evaluator.py"
click node_metrics "https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/evaluation/metrics.py"
click node_tracker "https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/main/gimbal_tracker_vpython_bt.py"
click node_tracker_usb "https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/main/gimbal_tracker_vpython_usb.py"
click node_main_config "https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/main/config.py"
click node_disparity_tool "https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/main/tools/disparity_map.py"
click node_depth_tool "https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/main/tools/depth_utils.py"
click node_detection "https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/main/tools/detection.py"
click node_hsv "https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/main/tools/hsv_filter.py"
click node_segmentation "https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/main/tools/hybrid_segmentation.py"
click node_kalman "https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/main/tools/kalman_filter.py"
click node_gimbal_control "https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/main/tools/gimbal_angle_controller.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_stereo_app,node_calibration,node_cal_models,node_rectifier,node_sgbm,node_wls,node_depth_converter,node_user toneBlue
class node_confidence_api,node_confidence_config,node_confidence_fusion,node_lr_quality,node_matching_quality,node_texture_quality,node_gradient_quality,node_occlusion_quality,node_geometry_quality,node_evaluator,node_metrics toneAmber
class node_tracker,node_tracker_usb,node_main_config toneMint
class node_disparity_tool,node_depth_tool,node_detection,node_hsv,node_segmentation,node_kalman,node_gimbal_control toneRose
```

## Components

### Stereo depth

- [Depth runner](https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/main.py): `04-09-2026/main.py`
- [Calibration loader](https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/calibration/loader.py): `04-09-2026/calibration/loader.py`
- [Calibration models](https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/calibration/models.py): `04-09-2026/calibration/models.py`
- [Stereo rectifier](https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/stereo/rectifier.py): `04-09-2026/stereo/rectifier.py`
- [SGBM matching](https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/stereo/disparity/sgbm.py): `04-09-2026/stereo/disparity/sgbm.py`
- [WLS filtering](https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/stereo/disparity/wls.py): `04-09-2026/stereo/disparity/wls.py`
- [Depth conversion](https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/depth/converter.py): `04-09-2026/depth/converter.py`

### Confidence evaluation

- [Confidence package](https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/confidence/__init__.py): `04-09-2026/confidence/__init__.py`
- [Confidence settings](https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/confidence/configs.py): `04-09-2026/confidence/configs.py`
- [Confidence fusion](https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/confidence/fusion.py): `04-09-2026/confidence/fusion.py`
- [LR consistency](https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/confidence/lr_consistency.py): `04-09-2026/confidence/lr_consistency.py`
- [Matching quality](https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/confidence/matching_quality.py): `04-09-2026/confidence/matching_quality.py`
- [Texture confidence](https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/confidence/texture.py): `04-09-2026/confidence/texture.py`
- [Gradient confidence](https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/confidence/gradient.py): `04-09-2026/confidence/gradient.py`
- [Occlusion confidence](https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/confidence/occlusion.py): `04-09-2026/confidence/occlusion.py`
- [Geometry confidence](https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/confidence/geometry.py): `04-09-2026/confidence/geometry.py`
- [Evaluation runner](https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/evaluation/evaluator.py): `04-09-2026/evaluation/evaluator.py`
- [Evaluation metrics](https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/04-09-2026/evaluation/metrics.py): `04-09-2026/evaluation/metrics.py`

### Live tracking

- [Gimbal tracker](https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/main/gimbal_tracker_vpython_bt.py): `main/gimbal_tracker_vpython_bt.py`
- [USB tracker](https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/main/gimbal_tracker_vpython_usb.py): `main/gimbal_tracker_vpython_usb.py`
- [Tracker settings](https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/main/config.py): `main/config.py`

### Tracking vision

- [Disparity utility](https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/main/tools/disparity_map.py): `main/tools/disparity_map.py`
- [Depth utility](https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/main/tools/depth_utils.py): `main/tools/depth_utils.py`
- [Object detection](https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/main/tools/detection.py): `main/tools/detection.py`
- [HSV filtering](https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/main/tools/hsv_filter.py): `main/tools/hsv_filter.py`
- [Hybrid segmentation](https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/main/tools/hybrid_segmentation.py): `main/tools/hybrid_segmentation.py`
- [Depth tracking](https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/main/tools/kalman_filter.py): `main/tools/kalman_filter.py`
- [Gimbal control](https://github.com/unknown-xenon-star/depth_measure_opencv/blob/main/main/tools/gimbal_angle_controller.py): `main/tools/gimbal_angle_controller.py`

### Other components

- **Image user**

## Connections

- Image user → Depth runner: provides stereo pair (evidence: `04-09-2026/main.py`)
- Depth runner → Calibration loader: loads calibration (evidence: `04-09-2026/main.py`)
- Depth runner → Stereo rectifier: rectifies pair (evidence: `04-09-2026/main.py`)
- Stereo rectifier → Calibration models: uses parameters (evidence: `04-09-2026/stereo/rectifier.py`)
- Depth runner → SGBM matching: computes disparity (evidence: `04-09-2026/main.py`)
- Depth runner → WLS filtering: filters disparity (evidence: `04-09-2026/main.py`)
- Depth runner → Depth conversion: converts disparity (evidence: `04-09-2026/main.py`)
- Depth runner → Confidence package: computes confidence (evidence: `04-09-2026/main.py`)
- Confidence fusion → Confidence settings: uses settings (evidence: `04-09-2026/confidence/fusion.py`)
- Confidence fusion → LR consistency: fuses component (evidence: `04-09-2026/confidence/fusion.py`)
- Confidence fusion → Matching quality: fuses component (evidence: `04-09-2026/confidence/fusion.py`)
- Confidence fusion → Texture confidence: fuses component (evidence: `04-09-2026/confidence/fusion.py`)
- Confidence fusion → Gradient confidence: fuses component (evidence: `04-09-2026/confidence/fusion.py`)
- Confidence fusion → Occlusion confidence: fuses component (evidence: `04-09-2026/confidence/fusion.py`)
- Confidence fusion → Geometry confidence: fuses component (evidence: `04-09-2026/confidence/fusion.py`)
- Depth runner → Evaluation runner: runs evaluation (evidence: `04-09-2026/main.py`)
- Evaluation runner → Evaluation metrics: computes metrics (evidence: `04-09-2026/evaluation/evaluator.py`)
- Gimbal tracker → Disparity utility: computes disparity (evidence: `main/gimbal_tracker_vpython_bt.py`)
- Gimbal tracker → Depth utility: uses depth utility (evidence: `main/gimbal_tracker_vpython_bt.py`)
- Gimbal tracker → Object detection: detects objects (evidence: `main/gimbal_tracker_vpython_bt.py`)
- Gimbal tracker → HSV filtering: filters colors (evidence: `main/gimbal_tracker_vpython_bt.py`)
- Gimbal tracker → Hybrid segmentation: segments frames (evidence: `main/gimbal_tracker_vpython_bt.py`)
- Gimbal tracker → Depth tracking: filters depth (evidence: `main/gimbal_tracker_vpython_bt.py`)
- USB tracker → Disparity utility: computes disparity (evidence: `main/gimbal_tracker_vpython_usb.py`)
- USB tracker → Depth utility: uses depth utility (evidence: `main/gimbal_tracker_vpython_usb.py`)
- USB tracker → Object detection: detects objects (evidence: `main/gimbal_tracker_vpython_usb.py`)
- USB tracker → HSV filtering: filters colors (evidence: `main/gimbal_tracker_vpython_usb.py`)
- USB tracker → Hybrid segmentation: segments frames (evidence: `main/gimbal_tracker_vpython_usb.py`)
- USB tracker → Depth tracking: filters depth (evidence: `main/gimbal_tracker_vpython_usb.py`)
- Gimbal tracker → Tracker settings: reads settings (evidence: `main/gimbal_tracker_vpython_bt.py`)
- USB tracker → Tracker settings: reads settings (evidence: `main/gimbal_tracker_vpython_usb.py`)
