Color Quantizer and Clustering

Este bloque de función reduce la cantidad de colores distintos en una imagen agrupando colores similares en clústeres. Es útil para simplificar la información de color con fines de visualización, segmentación o para acelerar pasos de procesamiento posteriores.

📥 Entradas

• Image Any — Imagen que se va a cuantizar y agrupar.

📤 Salidas

• Image Any — Imagen con paleta de colores reducida (resultado de cuantización).

• Clustered Colors (B,G,R) — Lista de valores de color por clúster que representan la paleta encontrada (un color por clúster).

🕹️ Controles

• K Coefficient — Deslizador para elegir cuántos clústeres de color calculará el bloque. Valores más bajos producen menos colores; valores más altos conservan más detalles de color.

🎨 Características

• Reducción de la paleta de colores para facilitar la inspección visual o el procesamiento posterior.

• Devuelve tanto la imagen procesada como la paleta resultante para reutilizarla en anotaciones, visualizaciones o comparaciones.

• Agrupamiento rápido, adecuado para ajuste interactivo mediante el deslizador.

⚙️ Mecanismo de funcionamiento

• Al activarse, el bloque analiza la imagen de entrada, agrupa colores similares en K clústeres (definidos por K Coefficient) y reemplaza cada píxel por el color de su clúster.

• Como salidas se producen la imagen cuantizada y la lista de colores de clúster para previsualizar o usar la paleta en otros bloques.

📝 Cómo usar

1. Conecta un bloque que produzca imagen al Image Any de entrada.

2. Ajusta el deslizador K Coefficient para seleccionar el número de clústeres de color deseado.

3. Observa la imagen cuantizada en la salida Image Any e inspecciona la lista de clústeres en Clustered Colors (B,G,R).

💡 Consejos prácticos

• Para imágenes grandes, usa Image Resizer antes de este bloque para acelerar el procesamiento manteniendo colores representativos.

• Si la imagen tiene ruido, añade un bloque Blur aguas arriba para estabilizar el resultado del agrupamiento.

• Para ver el resultado a tamaño completo, conecta la salida a Show Image.

• Si quieres analizar o comparar canales individuales, usa Split Image antes del agrupamiento o realiza conversiones con Color Space.

• Usa Image Logger o Image Write después de este bloque para guardar imágenes cuantizadas y revisarlas más tarde.

• Para mejorar el contraste de color antes de cuantizar, prueba Auto Contrast o Contrast Optimization aguas arriba.

🛠️ Solución de problemas

• Si el resultado se ve demasiado posterizado o pierde detalles importantes, aumenta K Coefficient.

• Si el agrupamiento es muy lento con imágenes grandes, reduce el tamaño con Image Resizer o disminuye K Coefficient.

• Si los colores no coinciden con lo esperado (por ejemplo, por el espacio de color), añade un bloque Color Space para convertir entre BGR/RGB u otros espacios antes del agrupamiento.