Etiqueta imágenes con la API en Console

Etiqueta imágenes con la API en Console

En esta guía de inicio rápido, se te guiará por los siguientes procesos:

• Crear un conjunto de datos de imágenes con cuadros de límite etiquetados
• Entrenar un modelo personalizado con tu conjunto de datos

En esta guía de inicio rápido, debes usar la interfaz de usuario (IU) personalizada para interactuar con la API de AutoML Vision. También puedes completar todos los pasos de esta guía mediante la API de AutoML. Si deseas obtener más instrucciones para usar la IU o la API, consulta las guías prácticas.

Antes de comenzar

Requisito de región: Por el momento, los recursos del proyecto deben estar en la región us-central1 para usar esta API.

Si deseas usar la detección de objetos de Cloud AutoML Vision, primero debes crear un proyecto de Google Cloud (que nunca se haya usado con ningún otro producto de AutoML) y habilitar la detección de objetos de Cloud AutoML Vision para ese proyecto.

1. Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

2. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

   Nota: Si no planeas conservar los recursos que creaste durante este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

   Ir al selector de proyectos

3. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

4. Habilita las API de Cloud AutoML and Storage.

   Habilita las API

5. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

   Nota: Si no planeas conservar los recursos que creaste durante este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

   Ir al selector de proyectos

6. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

7. Habilita las API de Cloud AutoML and Storage.

   Habilita las API

Requisitos de la versión Beta

1. Esta versión Beta requiere que uses us-central1 como la región especificada.

Prepara un conjunto de datos

En esta guía de inicio rápido, usarás un conjunto de datos creado a partir del conjunto de datos de imágenes abiertas V4. Este conjunto de datos de ensaladas público se encuentra en gs://cloud-ml-data/img/openimage/csv/salads_ml_use.csv.

El formato CSV es el siguiente:

TRAINING,gs://cloud-ml-data/img/openimage/3/2520/3916261642_0a504acd60_o.jpg,Salad,0.0,0.0954,,,0.977,0.957,,
VALIDATION,gs://cloud-ml-data/img/openimage/3/2520/3916261642_0a504acd60_o.jpg,Seafood,0.0154,0.1538,,,1.0,0.802,,
TEST,gs://cloud-ml-data/img/openimage/3/2520/3916261642_0a504acd60_o.jpg,Tomato,0.0,0.655,,,0.231,0.839,,

3916261642_0a504acd60_o.jpg

Cada fila corresponde a un objeto ubicado dentro de una imagen mayor, con cada objeto designado de forma específica como datos de prueba, entrenamiento o validación. Las tres líneas que se incluyen aquí indican tres objetos distintos ubicados dentro de la misma imagen disponibles en gs://cloud-ml-data/img/openimage/3/2520/3916261642_0a504acd60_o.jpg. Cada fila tiene una etiqueta diferente: Salad, Seafood o Tomato, además de otras filas con etiquetas Baked goods o Cheese.

Se especifican cuadros de límite para cada imagen con el vértice superior izquierdo y el vértice inferior derecho:

• (0,0) corresponde al vértice superior izquierdo.
• (1,1) corresponde al vértice inferior derecho.

En la primera fila, las coordenadas (x, y) del vértice superior izquierdo del objeto etiquetado Salad son (0.0,0.0954), y las coordenadas del vértice inferior derecho del objeto son (0.977,0.957).

Si deseas obtener información más detallada sobre cómo dar formato al archivo CSV y los requisitos mínimos para crear un conjunto de datos válido, consulta Prepara los datos de entrenamiento.

Crea un conjunto de datos e importa imágenes de entrenamiento

1. Abre la IU de la detección de objetos de Cloud AutoML Vision y selecciona tu proyecto de la lista desplegable en la barra de título.

   La primera vez que abras la IU de la detección de objetos de AutoML Vision, deberás habilitar la API de AutoML si aún no está habilitada.

2. Selecciona Comenzar en la ventana emergente cuando se te solicite.

   

3. Se te redireccionará a la página de la lista de conjuntos de datos. Para crear un nuevo conjunto de datos, selecciona Conjunto de datos nuevo (New dataset).

   

   Ingresa un nombre único para tu conjunto de datos.

   

4. Ingresa la ubicación de los datos de entrenamiento que deseas importar en la ventana que aparece a continuación.

   En el cuadro de texto Seleccionar un archivo CSV en Cloud Storage (Select a CSV file on Cloud Storage), ingresa la ruta del archivo CSV de muestra (el prefijo gs:// se agrega de forma automática):

   cloud-ml-data/img/openimage/csv/salads_ml_use.csv

   También puedes seleccionar Explorar (Browse) y navegar al archivo CSV en uno de tus depósitos de Google Cloud Storage.

   En esta guía de inicio rápido, se usan datos de muestra almacenados en un bucket público de Google Cloud Storage. Los datos de entrenamiento son imágenes JPG de muestra anotadas con el cuadro de límite y la etiqueta de los objetos que el modelo debe aprender a identificar. Para importar los datos de entrenamiento al conjunto de datos, usa un archivo CSV que se oriente a los archivos de imagen (JPEG, PNG, GIF, BMP o ICO). Consulta Prepara los datos de entrenamiento a fin de obtener información sobre las especificaciones de formato y de imagen.

   
5. Selecciona Importar.

   Tu conjunto de datos mostrará un estado de Running:importing images mientras se importen tus imágenes. Este proceso solo toma unos minutos.

Una vez que los datos de entrenamiento se importaron de forma correcta, en la columna Estado (Status), aparece Success:Creating dataset, y la IU muestra el ID que se generó para el conjunto de datos (que se usa cuando se realizan llamadas a la API de AutoML) y la cantidad de elementos importados.

Si hay algún problema con la importación de las imágenes, verás el estado Warning: Importing images. Selecciona el nombre del conjunto de datos y Detalles para ver los errores de una importación de imagen específica.

Entrene su modelo

Luego de crear tu conjunto de datos y de importar los datos de entrenamiento en el conjunto, puedes entrenar el modelo personalizado.

1. En la página de la lista de Datasets (Conjuntos de datos), haz clic en el nombre del conjunto de datos.

   

2. Selecciona la pestaña Train (Entrenar). Verás todas las etiquetas y su división en conjuntos de entrenamiento, prueba y validación.

   

3. Selecciona Comenzar entrenamiento (Start training) para abrir un panel lateral con opciones de entrenamiento.

   

4. Ingresa un nombre para tu modelo personalizado o acepta el nombre predeterminado. En este panel, también puedes seleccionar la optimización del modelo (para latencia o precisión).

   Selecciona Deploy model to node after training (Implementar el modelo en el nodo después del entrenamiento) para habilitar la implementación automática. De lo contrario, se te solicitará que implementes tu modelo de forma manual después del entrenamiento para que puedas hacer predicciones.

5. Selecciona Start training (Comenzar entrenamiento).

   

El entrenamiento de un modelo puede tardar varias horas en completarse. El tiempo de entrenamiento típico para la muestra es de alrededor de una hora.

Después de que el modelo se entrene con éxito, recibirás un mensaje en la dirección de correo electrónico que usaste para registrarte en el programa.

Evalúa el modelo personalizado

Después de entrenar un modelo, la detección de objetos de Cloud AutoML Vision evalúa la calidad y precisión del modelo nuevo. Para ver las métricas de evaluación de tu modelo, haz lo siguiente:

1. Abre la IU de la detección de objetos de Cloud AutoML Vision y haz clic en la pestaña Modelos (el ícono de bombilla) en la barra de navegación izquierda.

2. Haz clic en el nombre del modelo que deseas evaluar.

3. Si es necesario, haz clic en la pestaña Evaluar justo debajo de la barra de título.

   Si se completó el entrenamiento del modelo, la detección de objetos de Cloud AutoML Vision mostrará sus métricas de evaluación. Proporciona puntuaciones de precisión y recuperación para el modelo completo y cada etiqueta de objeto con diferentes puntuaciones y umbrales de intersección sobre la unión (IoU). Para ver las métricas de una etiqueta de objeto específica, elige la etiqueta de la lista “Filter labels” (Filtrar etiquetas).

   

La precisión y la recuperación miden qué tan bien capta la información el modelo y qué omite. A partir de todos los objetos anotados con una etiqueta específica, la precisión indica cuántos debían asignarse a esa etiqueta. A partir de todos los objetos que deben identificarse como una entidad determinada, la recuperación indica cuántos se asignaron en realidad a esa entidad.

Usa los siguientes datos para evaluar la preparación de tu modelo:

• Las puntuaciones de precisión o recuperación bajas pueden indicar que tu modelo necesita datos de entrenamiento adicionales.
• La precisión y la recuperación perfectas pueden indicar que los datos son demasiado fáciles y que no pueden generalizarse bien.

Usa el modelo personalizado

Una vez que tu modelo se haya entrenado de forma correcta, puedes usarlo para identificar objetos en una imagen con cuadros de límite y etiquetas. Selecciona la pestaña Prueba y uso.

Si no habilitaste la implementación automática, se te pedirá que implementes el modelo para poder hacer predicciones.

Implementa el modelo de forma manual

AutoML Vision requiere que implementes el modelo entrenado antes de que puedas enviarle solicitudes de predicción.

1. En la pestaña Test and Use (Prueba y uso), selecciona la opción Deploy model (Implementar modelo) en el cuadro debajo del nombre del modelo para implementar tu modelo de forma manual.

   Si seleccionas Deploy model (Implementar modelo), se abre la ventana de opciones de implementación del modelo.

2. En la ventana de opciones de implementación del modelo, puedes seleccionar la cantidad de nodos en los que se implementará y ver las consultas por segundo (QPS) de predicción disponibles.
3. Selecciona Deploy (Implementar) para comenzar la implementación del modelo.
4. Recibirás un correo electrónico cuando se complete la implementación del modelo.

Nota: También puedes usar la IU para actualizar el recuento de nodos de un modelo implementado.

Realiza una predicción

Después de implementar tu modelo, indica la ruta de acceso a tu imagen de prueba en la página Test & Use (Probar y usar) (como esta imagen, que está guardada de forma local). La detección de objetos de AutoML Vision analiza la imagen mediante tu modelo y muestra los objetos etiquetados y sus cuadros de límite en la imagen.

Advertencia: El tamaño mínimo del cuadro de límite proporcionado durante la preparación de datos y el entrenamiento es de 8 x 8 píxeles. El rendimiento de la predicción del modelo puede verse afectado si los cuadros previstos tienen un tamaño menor.

Realiza una limpieza

Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta página.

Si ya no necesitas tu conjunto de datos o modelo personalizado, puedes borrarlos.

A fin de evitar cargos innecesarios en Google Cloud Platform, usa GCP Console para borrar tu proyecto si no lo necesitas.

Anula la implementación de tu modelo

Tu modelo generará cargos mientras esté implementado.

1. Selecciona la pestaña Probar y usar, que se encuentra justo debajo de la barra de título.
2. Selecciona Remove deployment (Quitar implementación) en el cuadro que se encuentra debajo del nombre del modelo para abrir la ventana de la opción de anulación de la implementación.

   

3. Selecciona Quitar implementación (Remove deployment) para anular la implementación del modelo.

   

4. Recibirás un correo electrónico cuando se complete la anulación de la implementación del modelo.

Borra tu proyecto (opcional)

A fin de evitar cargos innecesarios en Google Cloud Platform, usa la consola de Google Cloud para borrar tu proyecto si no lo necesitas.

¿Qué sigue?

• Administra los modelos
• Administra conjuntos de datos