Saltar al contenido principal

DOCUMENTACIÓN CON IA

¿Qué desea saber?

Configuración de Metadatos

Nota sobre OV10i

El OV10i solo admite 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 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 usar metadatos: Seguimiento de producción, identificación de piezas, registros de control de calidad, información de lotes, identificación de operadores 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 de IA (clasificación o segmentación) configurado
  • Comprensión de los datos que desea rastrear a partir de los resultados de 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 lotes de producción
  • Puede ser buscada en la biblioteca para 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, "John_Smith")
  • Información de turnos (por ejemplo, "A_Shift")
  • Números de lote (por ejemplo, "Batch_2025_001")
nota

Los metadatos solo se pueden guardar cuando se completa una inspección. Los metadatos deben ser parte del flujo que comienza desde "All Block Outputs" después de que la cámara captura y procesa 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 Configurar IO o seleccione Bloque IO en el menú de migas de pan para ingresar al editor de Node-RED

1.2 Verificar la Interfaz de Node-RED​

Punto de control: Debería ver el editor de flujo 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 datos de la cámara después de que se activa y procesa una inspección.

El nodo "All Block Outputs":

  • Contiene resultados de inspección de todos los bloques de IA
  • Incluye información de captura de imágenes
  • Proporciona los datos necesarios para la creación de metadatos
  • Es la fuente que alimenta tanto los metadatos como las decisiones de aprobación/rechazo

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 (Crear Metadatos) → Capturar Metadatos
  2. Ruta de Decisión: All Block Outputs → Function (Lógica) → Aprobación/Rechazo Final
nota

Tanto los metadatos como las decisiones de aprobación/rechazo deben ramificarse desde el nodo "All Block Outputs".

Paso 3: Agregar Nodo de Captura de Metadatos​

3.1 Localizar el Nodo de Metadatos​

  1. Encuentre el nodo "Capturar Metadatos" en el panel izquierdo (sección de Resumen)
  2. Arrastre el nodo "Capturar Metadatos" al lienzo del flujo
  3. Colóquelo en su flujo después del disparador pero antes de la captura de imágenes

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 requerido para que el flujo funcione correctamente. Cada 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 estar formateados como un objeto con:

  • Claves de cadena - Los nombres de los campos deben ser texto
  • Valores de cadena o número - 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 Todos los Salidas de Bloque​

El nodo "All Block Outputs" proporciona datos de inspección ricos. Aquí se explica 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 Metadatos y Flujos de Pass/Fail​

6.1 Estructura de Flujo Requerida​

Cada flujo debe tener ambos caminos desde "All Block Outputs":

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

6.2 Conectar el Camino 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 Aprobación/Rechazo​

  1. Conecte la salida de "Todas las Salidas del Bloque" a una función lógica de aprobación/rechazo
  2. Conecte la salida de la función lógica a la entrada de "Aprobación/Rechazo Final"
  3. El nodo "Aprobación/Rechazo Final" es obligatorio - cada flujo debe terminar aquí

6.4 Ejemplo de Función Lógica de Aprobación/Rechazo​

// 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 "Desplegar" (esquina superior derecha)
  2. Active una inspección utilizando su método de activación configurado (manual, entrada digital o PLC)
  3. Verifique que:
    • Se capturó una imagen
    • Los metadatos aparecen con la imagen
    • Se tomó una decisión de aprobación/rechazo
    • El flujo se completó con éxito

7.2 Verificar Flujo Completo​

Verifique que ambas rutas funcionen:

Ruta de Metadatos:

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

Ruta de Aprobación/Rechazo:

  • Verifique que los resultados de la inspección muestren el estado de aprobación/rechazo
  • Verifique que el nodo "Aprobación/Rechazo Final" se procesó correctamente
  • Confirme que las salidas conectadas (PLC, indicadores) respondan adecuadamente

7.3 Probar Diferentes Fuentes de Activación​

Verifique que los metadatos funcionen con su activación específica:

Para Activaciones Manuales:

  • Utilice el botón de activación del software
  • Verifique que los metadatos aparezcan con cada captura manual

Para Activaciones de Entrada Digital:

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

Para Activaciones de PLC:

  • Envíe la señal de activación desde el PLC
  • Verifique que los metadatos incluyan 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​

ProblemaSíntomasSolución
Metadatos no aparecenSin datos en la BibliotecaVerifique que el nodo de metadatos esté en el flujo principal del Bloque de E/S
Metadatos con imagen incorrectaLos datos aparecen con capturas incorrectasVerifique el tiempo - los metadatos deben estar antes de la captura de la imagen
Activación no funcionaNo se capturaron imágenesVerifique la configuración de activación del Bloque de E/S
Campos de metadatos faltantesFaltan algunos datosVerifique el formato de carga del nodo de función
Error de tipo de dato incorrectoEl nodo muestra estado de errorAsegúrese de que los valores sean solo cadenas o números

9.2 Flujo de Metadatos de Depuración​

Agregue nodos de depuración para solucionar problemas:

  1. Agregue un nodo de depuración después del disparador para verificar que funcione
  2. Agregue un nodo de depuración después de la función de metadatos para verificar la carga útil
  3. Agregue un nodo de depuración después de Capturar Metadatos para confirmar el procesamiento
  4. Revise el panel de depuración en busca de mensajes de error

Paso 10: Mejores Prácticas​

10.1 Diseño del Flujo​

Diseñe flujos de metadatos eficientes:

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

10.2 Nomenclatura de Campos de Metadatos​

Utilice nombres de campos consistentes y claros:

  • Use guiones bajos en lugar de espacios ("part_number" no "part number")
  • Sea descriptivo pero conciso ("operator" no "op")
  • Use minúsculas para 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 datos de uso frecuente 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 activada

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

✅ Almacenar información buscable en la biblioteca de la cámara

✅ Mostrar datos relevantes en el HMI para los operadores

✅ Soportar la trazabilidad para los requisitos de fabricación

Mantenimiento Continuo​

Revisiones Regulares del Sistema​

  • Verifique que los metadatos aparezcan con las capturas activadas
  • Revise si hay datos faltantes en las ejecuciones de producción
  • Monitoree el rendimiento del flujo con altas tasas de activación
  • Actualice los campos de metadatos a medida que cambien los requisitos

Gestión del Flujo​

  • Revise la sincronización de 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 el funcionamiento basado en disparadores

Próximos 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 adecuado del disparador 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 el monitoreo de producción utilizando análisis de metadatos

🔗 Vea También​