# felipe-ssc/prototipo-cherry-control architecture

> Architecture diagram of the GitHub repository felipe-ssc/prototipo-cherry-control, 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/felipe-ssc/prototipo-cherry-control
- Repository: https://github.com/felipe-ssc/prototipo-cherry-control

## Overview

Prototipo de control de calidad visual de cerezas: captura imágenes, permite ajustar la segmentación por color y procesa cada fruta para clasificarla y estimar su calibre. Los resultados se guardan como CSV y vistas anotadas; otro script compara métricas de calibre y un notebook explora CSV. El README documenta el flujo principal; las conexiones de implementación se limitan a las visibles en los extractos. El notebook y parte de las salidas están descritos, pero su código no fue muestreado.

Main entry points: [`scripts/clasificar_cerezas.py`](https://github.com/felipe-ssc/prototipo-cherry-control/blob/main/scripts/clasificar_cerezas.py) (Clasificación y calibre), [`scripts/color_mask_interactivo.py`](https://github.com/felipe-ssc/prototipo-cherry-control/blob/main/scripts/color_mask_interactivo.py) (Ajuste HSV interactivo), [`detecciones`](https://github.com/felipe-ssc/prototipo-cherry-control/tree/main/detecciones) (Salidas de detección), [`fotos`](https://github.com/felipe-ssc/prototipo-cherry-control/tree/main/fotos) (Fotos originales)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Captura"]
  node_capture_tool["Captura de fotos<br/>[capturar_fotos.py]"]
  node_raw_photos[("Fotos originales")]
end

subgraph group_vision["Segmentación y ajuste"]
  node_mask_tuner["Ajuste HSV interactivo"]
  node_fixed_mask["Máscara fija<br/>[color_mask.py]"]
end

subgraph group_analysis["Análisis de cerezas"]
  node_fruit_analysis["Clasificación y calibre"]
  node_metric_diagnostic["Comparación de calibres<br/>[medir_cerezas.py]"]
end

subgraph group_results["Resultados"]
  node_detections[("Salidas de detección")]
  node_csv_explorer["Exploración de CSV<br/>[csv_result.ipynb]"]
end

node_operator(("Operador"))
node_camera["Cámara o URL"]

node_camera -->|"provee frames"| node_capture_tool
node_operator -->|"captura fotos"| node_capture_tool
node_capture_tool -->|"guarda imágenes"| node_raw_photos
node_operator -->|"ajusta umbrales"| node_mask_tuner
node_raw_photos -->|"muestra imagen"| node_mask_tuner
node_mask_tuner -->|"guarda máscara y parámetros"| node_detections
node_operator -->|"ejecuta análisis"| node_fruit_analysis
node_raw_photos -->|"lee foto"| node_fruit_analysis
node_mask_tuner -->|"provee parámetros"| node_fruit_analysis
node_fruit_analysis -->|"usa segmentación"| node_mask_tuner
node_fruit_analysis -->|"escribe CSV y vista"| node_detections
node_operator -->|"ejecuta diagnóstico"| node_metric_diagnostic
node_metric_diagnostic -->|"usa métricas"| node_fruit_analysis
node_metric_diagnostic -->|"escribe CSV y vista"| node_detections
node_operator -->|"explora resultados"| node_csv_explorer
node_detections -->|"lee CSV"| node_csv_explorer
node_operator -->|"ejecuta referencia"| node_fixed_mask

click node_capture_tool "https://github.com/felipe-ssc/prototipo-cherry-control/blob/main/scripts/capturar_fotos.py"
click node_raw_photos "https://github.com/felipe-ssc/prototipo-cherry-control/tree/main/fotos"
click node_mask_tuner "https://github.com/felipe-ssc/prototipo-cherry-control/blob/main/scripts/color_mask_interactivo.py"
click node_fixed_mask "https://github.com/felipe-ssc/prototipo-cherry-control/blob/main/scripts/color_mask.py"
click node_fruit_analysis "https://github.com/felipe-ssc/prototipo-cherry-control/blob/main/scripts/clasificar_cerezas.py"
click node_metric_diagnostic "https://github.com/felipe-ssc/prototipo-cherry-control/blob/main/scripts/medir_cerezas.py"
click node_detections "https://github.com/felipe-ssc/prototipo-cherry-control/tree/main/detecciones"
click node_csv_explorer "https://github.com/felipe-ssc/prototipo-cherry-control/blob/main/scripts/csv_result.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_capture_tool,node_raw_photos toneBlue
class node_mask_tuner,node_fixed_mask toneAmber
class node_fruit_analysis,node_metric_diagnostic toneMint
class node_detections,node_csv_explorer toneRose
class node_operator,node_camera toneIndigo
```

## Components

### Captura

- [Captura de fotos](https://github.com/felipe-ssc/prototipo-cherry-control/blob/main/scripts/capturar_fotos.py): `scripts/capturar_fotos.py`
- [Fotos originales](https://github.com/felipe-ssc/prototipo-cherry-control/tree/main/fotos): `fotos`

### Segmentación y ajuste

- [Ajuste HSV interactivo](https://github.com/felipe-ssc/prototipo-cherry-control/blob/main/scripts/color_mask_interactivo.py): `scripts/color_mask_interactivo.py`
- [Máscara fija](https://github.com/felipe-ssc/prototipo-cherry-control/blob/main/scripts/color_mask.py): `scripts/color_mask.py`

### Análisis de cerezas

- [Clasificación y calibre](https://github.com/felipe-ssc/prototipo-cherry-control/blob/main/scripts/clasificar_cerezas.py): `scripts/clasificar_cerezas.py`
- [Comparación de calibres](https://github.com/felipe-ssc/prototipo-cherry-control/blob/main/scripts/medir_cerezas.py): `scripts/medir_cerezas.py`

### Resultados

- [Salidas de detección](https://github.com/felipe-ssc/prototipo-cherry-control/tree/main/detecciones): `detecciones`
- [Exploración de CSV](https://github.com/felipe-ssc/prototipo-cherry-control/blob/main/scripts/csv_result.ipynb): `scripts/csv_result.ipynb`

### Other components

- **Operador**
- **Cámara o URL**

## Connections

- Cámara o URL → Captura de fotos: provee frames (evidence: `scripts/capturar_fotos.py`)
- Operador → Captura de fotos: captura fotos (evidence: `README.md`)
- Captura de fotos → Fotos originales: guarda imágenes (evidence: `scripts/capturar_fotos.py`)
- Operador → Ajuste HSV interactivo: ajusta umbrales (evidence: `README.md`)
- Fotos originales → Ajuste HSV interactivo: muestra imagen (evidence: `README.md`)
- Ajuste HSV interactivo → Salidas de detección: guarda máscara y parámetros (evidence: `README.md`)
- Operador → Clasificación y calibre: ejecuta análisis (evidence: `README.md`)
- Fotos originales → Clasificación y calibre: lee foto (evidence: `README.md`)
- Ajuste HSV interactivo → Clasificación y calibre: provee parámetros (evidence: `README.md`)
- Clasificación y calibre → Ajuste HSV interactivo: usa segmentación (evidence: `scripts/clasificar_cerezas.py`)
- Clasificación y calibre → Salidas de detección: escribe CSV y vista (evidence: `README.md`)
- Operador → Comparación de calibres: ejecuta diagnóstico (evidence: `README.md`)
- Comparación de calibres → Clasificación y calibre: usa métricas (evidence: `scripts/medir_cerezas.py`)
- Comparación de calibres → Salidas de detección: escribe CSV y vista (evidence: `scripts/medir_cerezas.py`)
- Operador → Exploración de CSV: explora resultados (evidence: `README.md`)
- Salidas de detección → Exploración de CSV: lee CSV (evidence: `README.md`)
- Operador → Máscara fija: ejecuta referencia (evidence: `README.md`)
