Normalize Image

Este bloque de función reescala los valores de los píxeles de una imagen usando métodos de normalización seleccionables para mejorar la visualización o ajustar el rango dinámico. También permite recortar valores basados en estadísticas de la imagen para reducir el efecto de valores atípicos.

📥 Entradas

Reference La imagen principal que se desea normalizar. (conector de entrada)

Second Image Imagen opcional usada para calcular las estadísticas de normalización. Si se conecta, se usan sus estadísticas en lugar de las de Reference. (conector de entrada)

📤 Salidas

Image Any La imagen normalizada, lista para visualizar o procesar posteriormente. (conector de salida)

🕹️ Controles

Morph Type Elija el método de normalización. Opciones comunes:

• NORM_MINMAX Reescala los valores de píxel a un rango especificado para visualización.

• NORM_INF Acota los valores en relación al máximo, útil para ajustar el rango dinámico.

Pixel Range Seleccione el rango de salida deseado para los valores de píxel mediante un control deslizante horizontal. Define los valores mínimo y máximo después de la normalización.

Clip Intensity Ajusta cuánto se recortan los valores de píxel alrededor de la media (expresado en porcentaje). Valores más altos reducen los extremos recortando fuera de mean ± (clip × std).

⚙️ Mecanismo de ejecución

• Al ejecutarse, el bloque lee los controles Morph Type, Pixel Range y Clip Intensity y aplica la normalización a la imagen Reference.

• Si Second Image está conectada, su media y desviación estándar se usan para determinar los rangos de recorte; en caso contrario se usan las estadísticas de Reference.

• Primero se recortan los valores extremos alrededor de la media según Clip Intensity, y luego se mapean los valores de píxel al Pixel Range elegido usando el método de normalización seleccionado, produciendo la imagen de salida.

🎨 Características

• Selección rápida entre escalado orientado a visualización (NORM_MINMAX) y escalado acotado por máximo (NORM_INF).

• Recorte ajustable para reducir el efecto de valores atípicos o píxeles ruidosos.

• Opción de usar una imagen separada para las estadísticas de normalización, permitiendo normalización consistente entre varias imágenes o flujos de cámara.

📝 Instrucciones de uso

1. Conecte la imagen a normalizar al conector Reference.

2. Opcional: conecte una imagen estable o una muestra de fondo a Second Image para usar sus estadísticas.

3. Seleccione el Morph Type adecuado a su objetivo:

   • Use NORM_MINMAX para fijar rangos explícitos de visualización.

   • Use NORM_INF si desea acotar por valores máximos.

4. Ajuste Pixel Range para definir los valores mínimo/máximo de salida.

5. Ajuste Clip Intensity para limitar la influencia de valores atípicos antes de la normalización.

6. Pase el Image Any resultante a bloques de visualización o procesamiento posteriores.

💡 Consejos y trucos

• Si sus imágenes son muy grandes, agregue Image Resizer antes de este bloque para acelerar las vistas previas.

• Use Denoising o Blur antes de la normalización para reducir el recorte causado por ruido y obtener estadísticas más estables.

• Para ajustar el contraste guiado por el histograma, pruebe Auto Contrast o Contrast Optimization después de la normalización para refinar la apariencia visual.

• Para inspeccionar resultados visualmente, conecte la salida a Show Image o guarde ejemplos con Image Logger / Image Write.

• Al preparar imágenes para tareas de detección, normalice de forma consistente entre fotogramas suministrando una imagen representativa a Second Image (por ejemplo, una muestra de fondo) para que detecciones posteriores como Find Object o Object Detection sean menos sensibles a cambios de iluminación.

🛠️ Resolución de problemas

• Si la salida se ve deslavada o demasiado recortada, reduzca Clip Intensity o amplíe Pixel Range.

• Si la normalización es inconsistente entre fotogramas, proporcione una imagen estable a Second Image para usar la misma referencia estadística cada ejecución.

• Si no aparece ninguna imagen, verifique que una imagen válida esté conectada a Reference y previsualice con Show Image.