> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/spanish/function-blocks/blocks-reference/image-transformations/transformation-filters/contrast-optimization.md).

# Contrast Optimization

Este bloque de función mejora el contraste local de las imágenes usando una técnica de ecualización de histograma adaptativa con límite de contraste (CLAHE). Es útil cuando los detalles están escondidos en regiones con brillo similar y quieres hacer esos detalles más visibles sin amplificar demasiado el ruido.

## 📥 Entradas

* `Image Any` — La imagen de entrada cuyo contraste se desea mejorar. Funciona con imágenes en color o en escala de grises.

## 📤 Salidas

* `Image Any` — La imagen de salida con el contraste mejorado.

## 🕹️ Controls

* `Grid Size` — Ajusta el tamaño de la rejilla local usada para la ecualización de contraste. Valores mayores crean mosaicos más grandes y ajustes locales más gruesos.
* `Clip Limit` — Controla cuánto se limita el contraste para evitar amplificar en exceso el ruido. Valores más altos aumentan la intensidad de la mejora de contraste.

## 🎨 Features

* Realza detalles locales en sombras y altas luces mientras evita una fuerte amplificación del ruido.
* Funciona en imágenes en color aplicando la mejora al canal de luminosidad y preservando el color.
* Los deslizadores interactivos permiten ajustar el bloque en tiempo real según tu escena.

## 📝 Usage Instructions

1. Conecta una fuente de imagen a `Image Any`.
2. Ajusta `Grid Size` para controlar la escala de los parches locales de contraste.
3. Ajusta `Clip Limit` para controlar la fuerza de la mejora.
4. Observa el resultado en la salida `Image Any` y ajusta los deslizadores según sea necesario.

## 📊 Evaluation

Al ejecutarse, este bloque procesa la imagen entrante y produce una imagen mejorada que revela diferencias de contraste local manteniendo el ruido bajo control.

## 💡 Tips and Tricks

* Para imágenes muy grandes, usa `Image Resizer` para reducir el tamaño de entrada antes de ejecutar este bloque y acelerar el procesamiento.
* Si el resultado parece ruidoso, prueba `Denoising` antes de aplicar este bloque y compáralo con el original.
* Para previsualizar resultados mientras construyes tu flujo, conecta la salida a `Show Image`.
* Si solo necesitas mejorar un área específica, recorta primero con `Image ROI` y luego aplica este bloque.
* Combina con `Auto Contrast` o `Normalize Image` para comparar la mejora global vs. local y elegir el mejor resultado para tu aplicación.
* Guarda imágenes finales con `Image Write` o registra múltiples resultados con `Image Logger`.

## 🛠️ Troubleshooting

* Si las imágenes se ven sobresaturadas o ruidosas, reduce el `Clip Limit` o preprocesa con `Denoising`.
* Si desaparecen detalles muy pequeños, aumenta el `Grid Size` para evitar ajustes excesivamente locales.
* Si el procesamiento es lento, reduce el tamaño de la imagen con `Image Resizer` antes de ingresarla a este bloque.