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

# Deconvolution

Este bloque de función ayuda a recuperar la nitidez y el detalle en imágenes, especialmente útil para imágenes de objetos en movimiento rápido que aparecen borrosas. Usa los deslizadores provistos para ajustar el efecto de restauración según tu cámara y escena.

## 📥 Entradas <a href="#inputs" id="inputs"></a>

`Image Any` (socket de entrada)\
Una imagen en color o en escala de grises que se va a procesar.

## 📤 Salidas <a href="#outputs" id="outputs"></a>

`Image Any` (socket de salida)\
La imagen procesada con la deconvolución aplicada.

## 🕹️ Controles <a href="#controls" id="controls"></a>

`Angle`\
Ajusta la dirección u orientación del efecto de deconvolución. Útil cuando el desenfoque por movimiento tiene una dirección predominante.

`Diameter`\
Controla el tamaño/fuerza del área de corrección. Valores mayores afectan núcleos de desenfoque más grandes.

`Noise Reduction`\
Controla cuánto se reduce el ruido mientras se restaura el detalle. Aumentar este valor reduce el ruido pero puede suavizar detalles finos.

## 🎨 Características <a href="#features" id="features"></a>

* Recupera la nitidez en imágenes borrosas por movimiento, permitiendo controlar dirección e intensidad.
* Funciona con imágenes en escala de grises y en color (en color se procesa por canal).
* Deslizadores sencillos para experimentar sin conocimientos técnicos.

## ⚙️ Mecanismo de funcionamiento <a href="#how-it-works" id="how-it-works"></a>

Al ejecutarse, el bloque toma la imagen de entrada, aplica el procesamiento de deconvolución considerando los valores de `Angle`, `Diameter` y `Noise Reduction` seleccionados, y produce la imagen corregida. Si la imagen es en color, cada canal se procesa para mantener la información cromática correcta en la salida.

## 📝 Instrucciones de uso <a href="#usage" id="usage"></a>

1. Conecta una cámara o fuente de imagen al puerto `Image Any`.
2. Empieza con valores moderados: ajusta `Angle` para que coincida con la dirección del movimiento (si se conoce), pon `Diameter` en un valor pequeño/medio y `Noise Reduction` bajo.
3. Inspecciona el resultado y ajusta los deslizadores hasta que la imagen se vea nítida sin artefactos excesivos.
4. Usa la imagen de salida en etapas posteriores (mostrar, guardar, medición, etc.).

## 💡 Consejos y trucos <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Combina con `Denoising` antes de este bloque para reducir el ruido del sensor y evitar amplificarlo durante la deconvolución.
* Si la imagen de entrada es muy grande, usa `Image Resize` para bajar la resolución y acelerar las pruebas; vuelve a procesar a tamaño completo para el resultado final.
* Usa `Image ROI` para recortar el área de interés antes de procesar: acelera el ajuste y evita procesar zonas irrelevantes.
* Si el contraste es bajo, prueba `Contrast Optimization` antes de la deconvolución para que los detalles sean más recuperables.
* Usa `Show Image` para previsualizar rápidamente y `Image Logger` para guardar fotogramas procesados y revisarlos después.

## 🛠️ Solución de problemas <a href="#troubleshooting" id="troubleshooting"></a>

* La salida se ve ruidosa o con artefactos: aumenta `Noise Reduction` o añade un bloque `Denoising` antes de la deconvolución.
* No hay mejora visible: ajusta `Angle` para que coincida con la dirección del movimiento y aumenta `Diameter` gradualmente.
* El procesamiento es lento: reduce el tamaño de la imagen con `Image Resize` o limita el área con `Image ROI`.
* Los colores se ven extraños después del procesamiento: confirma que la entrada era una imagen en color y revisa con `Show Image`; si hace falta, reorganiza el flujo (por ejemplo, aplica `Contrast Optimization` antes de la deconvolución).