> 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/denoising.md).

# Denoising

Este bloque de función reduce el ruido en imágenes utilizando un método rápido de denoising non-local means. Funciona tanto para imágenes en color como en escala de grises y proporciona deslizadores para equilibrar la eliminación de ruido y la preservación de detalles.

## 📥 Entradas

`Image Any` Conecta una imagen (a color o en escala de grises) que quieras denoising.

(pista: este es un socket de entrada)

## 📤 Salidas

`Image Any` Aquí se entrega la imagen denoised.

(pista: este es un socket de salida)

## 🕹️ Controles

`Strength` Ajusta la intensidad general de la reducción de ruido. Valores más altos eliminan más ruido pero pueden difuminar detalles finos.

`Averaging` Controla la potencia de promediado usada para el suavizado. Aumentarlo puede reducir ruido pero también suaviza los bordes.

`Blend Noise (Colored)` Ajusta la combinación de canales de color para imágenes a color. Úsalo para controlar cómo se trata el ruido de color en relación con el ruido de luminancia.

(pista: estos son deslizadores interactivos visibles en el bloque)

## ⚙️ Mecanismo de ejecución

* Cuando el bloque recibe una imagen por la entrada `Image Any`, aplica los parámetros de denoising seleccionados y actualiza la salida con la imagen procesada.
* Los parámetros se leen de los deslizadores en cada ejecución, por lo que cambiar un deslizador afecta la siguiente evaluación.
* El bloque maneja tanto imágenes de un solo canal como multicanal, seleccionando automáticamente el procesamiento apropiado.

## ✨ Características

* Funciona para imágenes en escala de grises y en color.
* Ajuste de parámetros en tiempo real mediante deslizadores para feedback visual inmediato.
* Eliminación de ruido balanceada para preservar bordes si se ajusta adecuadamente.

## 📝 Instrucciones de uso

1. Conecta un bloque que produzca imágenes a la entrada `Image Any`.
2. Ajusta `Strength` para controlar cuán agresiva será la eliminación de ruido.
3. Afina `Averaging` para equilibrar suavidad frente a detalle.
4. Para imágenes en color, ajusta `Blend Noise (Colored)` para tratar el ruido específico de color.
5. Observa el resultado denoised desde la salida `Image Any` (conecta a un visor o guardador).

## 💡 Consejos y trucos

* Para capturas de cámara con mucho ruido, prueba combinar este bloque con `Bilateral Filter` o `Blur` antes del denoising para reducir ruido impulsivo y obtener resultados más limpios.
* Usa `Show Image` para previsualizar resultados en vivo mientras ajustas los deslizadores.
* Para guardar ejemplos y compararlos después, conecta la salida a `Image Logger` o `Image Write`.
* Si quieres mantener un fotograma estable durante el ajuste, usa `Image Memory` para congelar un fotograma elegido mientras modificas controles.
* Recorta primero la región de interés con `Image ROI Select` para centrar el denoising solo donde importa y ahorrar cómputo.

(pista: los bloques complementarios recomendados aparecen arriba para flujos de trabajo comunes)

## 🛠️ Resolución de problemas

* Si el resultado se ve demasiado suave o se pierden detalles: baja `Strength` y reduce `Averaging`.
* Si aparecen artefactos de color tras el denoising: reduce `Blend Noise (Colored)` o prueba preprocesar con `Blur`.
* Si el rendimiento es lento en imágenes grandes: redimensiona con `Image Resizer` o procesa ROIs más pequeños usando `Image ROI Select`.

Si necesitas más depuración visual mientras ajustas, conecta la salida a `Show Image` para inspeccionar los cambios fotograma a fotograma.