Configuración de Metadatos

Nota OV10i

El OV10i admite únicamente modelos de clasificación. Las funciones de Segmentación mencionadas en esta página están disponibles en las cámaras OV20i y OV80i.

Esta guía le muestra cómo configurar los metadatos para las imágenes de su cámara OV10i. Los metadatos son información personalizada que se almacena con cada imagen capturada, ayudándole a rastrear detalles importantes como números de parte, números de serie o datos de producción.

Cuándo Utilizar Metadatos: Seguimiento de producción, identificación de piezas, registros de control de calidad, información de lotes, identificación del operador o cualquier dato personalizado que necesite asociar con las imágenes de inspección.

Prerrequisitos

• Sistema de cámara OV10i configurado y conectado
• Receta activa configurada con configuración de imagen e inspección
• Al menos un Bloque AI (clasificación o segmentación) configurado
• Comprensión de los datos que desea rastrear a partir de los resultados de la inspección

¿Qué son los Metadatos?

Los metadatos son información adicional que se adjunta a cada imagen capturada. Esta información:

• Se almacena con la imagen en la Biblioteca de la cámara
• Aparece en el HMI para que los operadores la vean
• Ayuda a identificar y rastrear piezas específicas o corridas de producción
• Puede buscarse en la Biblioteca para su análisis

Ejemplos de metadatos útiles:

• Números de parte (por ejemplo, "P12345")
• Números de serie (por ejemplo, "SN987654")
• Nombres de operadores (por ejemplo, "Juan_Pérez")
• Información de turno (por ejemplo, "Turno_A")
• Números de lote (por ejemplo, "Lote_2025_001")

nota

Los metadatos solo pueden guardarse cuando se completa una inspección. Los metadatos deben formar parte del flujo que comienza desde "All Block Outputs" después de que la cámara capture y procese una imagen.

Paso 1: Acceder al Editor de Node-RED

1.1 Navegar al Bloque IO

1. Abra su receta activa en el editor de recetas
2. Haga clic en Configure IO o seleccione IO Block" en el menú de migas de pan para ingresar al editor de Node-RED

1.2 Verificar la Interfaz de Node-RED

Punto de Verificación: Debería ver el editor de flujos de Node-RED con el flujo existente del Bloque IO y la paleta de nodos en el lado izquierdo.

Paso 2: Localizar el Nodo "All Block Outputs"

2.1 Encontrar el Punto de Partida

En su flujo de Node-RED, busque el nodo "All Block Outputs". Este es el punto de partida que recibe los datos de la cámara después de que se activa y procesa una inspección.

El nodo "All Block Outputs":

• Contiene los resultados de inspección de todos los Bloques AI
• Incluye información de captura de imagen
• Proporciona los datos necesarios para la creación de metadatos
• Es la fuente que alimenta tanto los metadatos como las decisiones de aprobado/rechazado

2.2 Comprender la Estructura del Flujo

Su flujo debe seguir este patrón:

Camera Trigger → AI Processing → All Block Outputs → [Your Custom Logic]

Desde "All Block Outputs" necesita dos rutas separadas:

1. Ruta de Metadatos: All Block Outputs → Function (Create Metadata) → Capture Metadata
2. Ruta de Decisión: All Block Outputs → Function (Logic) → Final Pass/Fail

nota

Tanto los metadatos como las decisiones de aprobado/rechazado deben ramificarse desde el nodo "All Block Outputs".

Paso 3: Agregar el Nodo Capture Metadata

3.1 Localizar el Nodo de Metadatos

1. Encuentre el nodo "Capture Metadata" en el panel izquierdo (sección Overview)
2. Arrastre el nodo "Capture Metadata" al lienzo del flujo
3. Posiciónelo en su flujo después del disparador pero antes de la captura de imagen

3.2 Colocación de Nodos en el Flujo

Estructura de flujo correcta:

All Block Outputs → Function (Create Metadata) → Capture Metadata
                  ↓
                  Function (Pass/Fail Logic) → Final Pass/Fail

aviso

El nodo "Final Pass/Fail" es obligatorio para que el flujo funcione correctamente. Todo flujo debe terminar con este nodo.

Paso 4: Configurar Campos de Metadatos

4.1 Configurar Metadatos Básicos

1. Haga doble clic en el nodo Capture Metadata
2. Configure los campos de metadatos que desea rastrear
3. Configure las fuentes de datos para cada campo

4.2 Requisitos de Formato de Metadatos

Importante

Los metadatos deben tener el formato de un objeto con:

• Claves de tipo string - Los nombres de campo deben ser texto
• Valores de tipo string o number - Los datos pueden ser texto o números

Ejemplo de formato correcto:

{
  "part_number": "P12345",
  "serial_number": "SN987654",
  "operator": "John_Smith",
  "shift": "A",
  "quantity": 100,
  "temperature": 23.5
}

Paso 5: Crear Nodo de Función de Metadatos

5.1 Agregar Nodo de Función para la Creación de Metadatos

1. Agregue un nodo "function" entre "All Block Outputs" y el nodo "Capture Metadata"
2. Haga doble clic en el nodo de función para configurarlo
3. Esta función extraerá datos de los resultados de inspección y creará metadatos

5.2 Extraer Datos de All Block Outputs

El nodo "All Block Outputs" proporciona datos de inspección detallados. Aquí se muestra cómo extraerlos:

// Extract data from inspection results
const captureId = msg.payload.capture_id;
const serialNumber = msg.payload.serial_number || "No_Serial";
const inspectionTime = msg.payload.inspection_time || new Date().toISOString();

// Create metadata from inspection data
msg.payload = {
    "capture_id": captureId,
    "serial_number": serialNumber,
    "inspection_time": inspectionTime,
    "operator": global.get("current_operator") || "Unknown"
};
return msg;

5.3 Metadatos Estáticos (Valores Fijos)

Para información que no cambia durante la producción:

// Set static metadata values
msg.payload = {
    "recipe_name": "Bolt_Inspection_v2",
    "line_number": "Line_3",
    "shift": "A_Shift",
    "station": "QC_Station_1"
};
return msg;

5.4 Metadatos Dinámicos (Usando Datos de Inspección)

Para información que proviene de los resultados de inspección:

// Extract inspection data
const captureId = msg.payload.capture_id;
const imageUrl = msg.payload.image_url;
const predictions = msg.payload.classification?.predictions || [];

// Create dynamic metadata
msg.payload = {
    "capture_id": captureId,
    "part_number": "P" + Date.now(),
    "total_rois": predictions.length,
    "timestamp": new Date().toISOString(),
    "batch": global.get("current_batch") || "Default_Batch"
};
return msg;

Paso 6: Conectar los Flujos de Metadatos y Pass/Fail

6.1 Estructura de Flujo Requerida

Cada flujo debe tener ambas rutas desde "All Block Outputs":

All Block Outputs → Function (Create Metadata) → Capture Metadata
                  ↓
                  Function (Pass/Fail Logic) → Final Pass/Fail

6.2 Cablear la Ruta de Metadatos

1. Conecte la salida de "All Block Outputs" a la entrada de su función de metadatos
2. Conecte la salida de la función de metadatos a la entrada de "Capture Metadata"
3. El nodo Capture Metadata puede ser un nodo terminal (no se necesita conexión de salida)

6.3 Cablear la Ruta de aprobado/rechazado

1. Conecte la salida "All Block Outputs" a una función lógica de aprobado/rechazado
2. Conecte la salida de la función lógica a la entrada "Final Pass/Fail"
3. El nodo "Final Pass/Fail" es obligatorio - todo flujo debe terminar aquí

6.4 Ejemplo de Función Lógica de aprobado/rechazado

// Extract inspection result for pass/fail decision
const predictions = msg.payload.classification?.predictions || [];

// Determine if inspection passed (all ROIs passed)
let passed = true;
for (let prediction of predictions) {
    if (!prediction.predicted_class.includes("pass")) {
        passed = false;
        break;
    }
}

// Set the pass/fail result
msg.payload = passed;
return msg;

Paso 7: Probar la Configuración de Metadatos

7.1 Desplegar y Probar

1. Haga clic en el botón "Deploy" (esquina superior derecha)
2. Active una inspección usando su método de activación configurado (manual, entrada digital o PLC)
3. Verifique que:
   • Se haya capturado una imagen
   • Los metadatos aparezcan con la imagen
   • Se haya tomado una decisión de aprobado/rechazado
   • El flujo se haya completado exitosamente

7.2 Verificar el Flujo Completo

Verifique que ambas rutas funcionen:

Ruta de Metadatos:

• Navegue a Biblioteca en la interfaz principal
• Encuentre su imagen de prueba
• Verifique que los metadatos aparezcan en los detalles de la imagen

Ruta de aprobado/rechazado:

• Verifique que los resultados de inspección muestren el estado de aprobado/rechazado
• Verifique que el nodo "Final Pass/Fail" se haya procesado correctamente
• Confirme que cualquier salida conectada (PLCs, indicadores) responda adecuadamente

7.3 Probar Diferentes Fuentes de Activación

Verifique que los metadatos funcionen con su activador específico:

Para Activadores Manuales:

• Use el botón de activación por software
• Verifique que los metadatos aparezcan con cada Captura manual

Para Activadores de Entrada Digital:

• Active el sensor/interruptor externo
• Confirme que los metadatos se capturen con las imágenes activadas

Para Activadores de PLC:

• Envíe la señal de activación desde el PLC
• Verifique que los metadatos incluyan los datos del PLC si corresponde

Paso 8: Configuraciones Avanzadas de Metadatos

8.1 Metadatos de Múltiples Variables Globales

Combine datos de diferentes fuentes almacenadas globalmente:

// Combine data from various global storage
const operatorData = global.get("operator_info") || {};
const productData = global.get("product_info") || {};
const shiftData = global.get("shift_info") || {};

msg.payload = {
    "operator": operatorData.name || "Unknown",
    "operator_id": operatorData.id || "000",
    "product_code": productData.code || "Default",
    "product_version": productData.version || "1.0",
    "shift": shiftData.current || "Day",
    "line_status": "Running",
    "timestamp": new Date().toISOString()
};
return msg;

Paso 9: Solución de Problemas de Metadatos

9.1 Problemas Comunes

Problema	Síntomas	Solución
Los metadatos no aparecen	Sin datos en Biblioteca	Verifique que el nodo de metadatos esté en el flujo principal del Bloque IO
Metadatos con la imagen incorrecta	Los datos aparecen con capturas incorrectas	Revise la temporización - los metadatos deben estar antes de la Captura de imagen
El activador no funciona	No se capturan imágenes	Verifique la configuración del activador del Bloque IO
Campos de metadatos faltantes	Algunos datos faltantes	Revise el formato del payload del nodo de función
Error de tipo de dato incorrecto	El nodo muestra estado de error	Asegúrese de que los valores sean solo strings o números

9.2 Depurar Flujo de Metadatos

Agregue nodos de depuración para solucionar problemas:

1. Agregue un nodo de depuración después del disparador para verificar que el disparador funcione
2. Agregue un nodo de depuración después de la función de metadatos para revisar el payload
3. Agregue un nodo de depuración después de Capture Metadata para confirmar el procesamiento
4. Revise el panel de depuración para ver mensajes de error

Paso 10: Mejores Prácticas

10.1 Diseño del Flujo

Diseñe flujos de metadatos eficientes:

• Mantenga los metadatos al inicio del flujo - Configure los metadatos inmediatamente después del disparador
• Use un solo nodo de metadatos - No duplique nodos de Capture Metadata
• Mantenga la continuidad del flujo - Los metadatos deben ser parte del flujo principal de inspección
• Maneje los datos faltantes - Siempre proporcione valores predeterminados

10.2 Nomenclatura de Campos de Metadatos

Use nombres de campos consistentes y claros:

• Use guiones bajos en lugar de espacios ("part_number" en vez de "part number")
• Sea descriptivo pero conciso ("operator" en vez de "op")
• Use minúsculas para mantener consistencia
• Evite caracteres especiales que puedan causar problemas

10.3 Consideraciones de Rendimiento

Para producción de alto volumen:

• Minimice el tamaño de los metadatos - Incluya solo la información necesaria
• Use tipos de datos eficientes - Números cuando sea posible, cadenas cortas
• Evite procesamiento complejo - Mantenga la creación de metadatos simple y rápida
• Almacene datos globales en caché - Guarde los datos usados frecuentemente en variables globales

¡Éxito! Su Sistema de Metadatos Está Listo

Su configuración de metadatos ahora puede:

✅ Adjuntar información personalizada a cada captura de imagen disparada

✅ Rastrear datos de producción sincronizados con el flujo de inspección

✅ Almacenar información que se puede buscar en la Biblioteca de la cámara

✅ Mostrar datos relevantes en la HMI para los operadores

✅ Soportar trazabilidad para requisitos de manufactura

Mantenimiento Continuo

Verificaciones Regulares del Sistema

• Verifique que los metadatos aparezcan con las capturas disparadas
• Revise si faltan datos en las corridas de producción
• Monitoree el rendimiento del flujo con tasas altas de disparo
• Actualice los campos de metadatos según cambien los requisitos

Gestión del Flujo

• Revise la temporización de los metadatos en producción
• Optimice el rendimiento de los nodos de función
• Actualice la gestión de variables globales
• Capacite a los operadores sobre la operación basada en disparadores

Siguientes Pasos

Después de configurar los metadatos basados en disparadores:

1. Pruebe con todos los tipos de disparadores configurados (manual, digital, PLC)
2. Capacite a los operadores sobre el uso correcto de los disparadores para la captura de metadatos
3. Configure la gestión de variables globales para datos dinámicos
4. Cree plantillas de metadatos para diferentes líneas de productos
5. Implemente monitoreo de producción utilizando análisis de metadatos

🔗 Ver También

• Digital Input Trigger Setup
• Connect to PLC ( Ethernet/IP, PROFINET)
• Node-RED Basics
• Overview Node-RED Custom Blocks
• Library & Image Management
• Triggering Modes (Manual, Digital, Sensor)