Entrena a un transformador en Cloud TPU (TF 2.x)

En este instructivo, se muestra cómo entrenar un modelo ResNet de Keras en Cloud TPU con tf.distribute.TPUStrategy.

Si no estás familiarizado con Cloud TPU, te recomendamos que consultes la quickstart de tu framework para aprender a crear una TPU y una VM de Compute Engine.

Objetivos

Crear un bucket de Cloud Storage para almacenar el resultado de tu modelo y tu conjunto de datos
Preparar un conjunto de datos imagenet falso que sea similar al conjunto de datos ImageNet
Ejecutar el trabajo de entrenamiento
Verificar los resultados de salida

Costos

En este documento, usarás los siguientes componentes facturables de Google Cloud:

Compute Engine
Cloud TPU
Cloud Storage

Para generar una estimación de costos en función del uso previsto, usa la calculadora de precios. Es posible que los usuarios nuevos de Google Cloud califiquen para obtener una prueba gratuita.

Antes de comenzar

Antes de comenzar este instructivo, verifica que tu proyecto de Google Cloud esté configurado correctamente.

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.

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

Ir al selector de proyectos

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

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

Ir al selector de proyectos

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

En esta explicación, se usan componentes facturables de Google Cloud. Consulta la página de precios de Cloud TPU para calcular los costos. Asegúrate de limpiar los recursos que crees cuando hayas terminado de usarlos para evitar cargos innecesarios.

Entrenamiento de Cloud TPU con dispositivo único

En esta sección, se proporciona información para configurar el bucket de Cloud Storage, la VM y los recursos de Cloud TPU para el entrenamiento de un solo dispositivo.

Abre una ventana de Cloud Shell.

Abra Cloud Shell
Crea una variable para el ID de tu proyecto.
```
$ export PROJECT_ID=project-id
```
Configura Google Cloud CLI para usar el proyecto en el que deseas crear Cloud TPU.
```
$ gcloud config set project ${PROJECT_ID}
```
La primera vez que ejecutes este comando en una VM de Cloud Shell nueva, se mostrará la página Authorize Cloud Shell. Haz clic en Authorize en la parte inferior de la página para permitir que gcloud realice llamadas a la API con tus credenciales.
Crea una cuenta de servicio para el proyecto de Cloud TPU.

Las cuentas de servicio permiten que el servicio de Cloud TPU acceda a otros servicios de Google Cloud.
```
$ gcloud beta services identity create --service tpu.googleapis.com --project $PROJECT_ID
```
El comando muestra una cuenta de servicio de Cloud TPU con el siguiente formato:
```
service-PROJECT_NUMBER@cloud-tpu.iam.gserviceaccount.com
```
Crea un bucket de Cloud Storage con el siguiente comando:
```
$ gsutil mb -p ${PROJECT_ID} -c standard -l europe-west4 gs://bucket-name
```
Este bucket de Cloud Storage almacena los datos que usas para entrenar tu modelo y los resultados del entrenamiento. Con el comando de gcloud que se usa en este instructivo a fin de configurar la TPU, también se configuran los permisos predeterminados para la cuenta de servicio de Cloud TPU que configuraste en el paso anterior. Si quieres contar con permisos más detallados, revisa los permisos de nivel de acceso.
Prepara tu conjunto de datos o usa fake_imagenet

ImageNet es una base de datos de imágenes. Las imágenes de la base de datos están organizadas en forma jerárquica, y cada nodo está representado por cientos y miles de imágenes.

En este instructivo, se usa una versión de demostración del conjunto de datos completo de ImageNet, denominado fake_imagenet. Esta versión de demostración permite probar el instructivo, a la vez que se reducen los requisitos de almacenamiento y tiempo que se suelen asociar con la ejecución de un modelo en el conjunto de datos completo de ImageNet.

El conjunto de datos fake_imagenet se encuentra en esta ubicación de Cloud Storage:
```
gs://cloud-tpu-test-datasets/fake_imagenet
```
El conjunto de datos fake_imagenet solo es útil para comprender cómo usar una Cloud TPU y validar el rendimiento de extremo a extremo. Los números de exactitud y el modelo guardado no serán significativos.

Si deseas usar el conjunto de datos de ImageNet completo, consulta Descarga, preprocesa y sube el conjunto de datos de ImageNet.

Precaución: Para este instructivo, asegúrate de no establecer la variable de entorno STORAGE_BUCKET en la ruta del conjunto de datos fake_imagenet. Puedes leer desde gs://cloud-tpu-test-datasets, pero no puedes escribir allí. Como resultado, no puedes utilizar esa ruta para escribir registros de entrenamiento. Asegúrate de que la variable de entorno STORAGE_BUCKET esté configurada para tu propio bucket de Cloud Storage.
Inicia los recursos de TPU con el comando de gcloud. El comando que uses depende de si usas VM de TPU o nodos TPU. Para obtener más información sobre la arquitectura de las dos VM, consulta Arquitectura del sistema.

Nota: En el entrenamiento de muestra que se presenta a continuación, se usa la biblioteca de modelos de TF-Vision para visión artificial. Consulta el archivo README para obtener más información sobre la biblioteca de modelado de TF-Vision.
VM de TPU
```
$ gcloud compute tpus tpu-vm create resnet-tutorial \
--zone=us-central2-b \
--accelerator-type=v4-8 \
--version=tpu-vm-tf-2.16.1-pjrt
```
Descripciones de las marcas de comandos

zone

La zona en la que planeas crear tu Cloud TPU.

accelerator-type

El tipo de acelerador especifica la versión y el tamaño de la Cloud TPU que quieres crear. Si quieres obtener más información sobre los tipos de aceleradores compatibles con cada versión de TPU, consulta Versiones de TPU.

version

La versión de software de Cloud TPU.
Nodo TPU
```
gcloud compute tpus execution-groups create \
--project=${PROJECT_ID} \
--zoneus-central2-b \
--name=resnet-tutorial \
--disk-size=300 \
--machine-type=n1-standard-16 \
--accelerator-type=v3-8 \
--tf-version=2.12.0
```
Descripciones de las marcas de comandos

project

El ID del proyecto de Google Cloud

zone

La zona en la que planeas crear tu Cloud TPU.

name

Es el nombre de la Cloud TPU que se creará.

disk-size

El tamaño del disco duro en GB de la VM que creó el comando gcloud.

machine-type

El tipo de máquina de la VM de Compute Engine que se creará.

accelerator-type

El tipo de Cloud TPU que se creará.

tf-version

La versión gcloud de TensorFlow se instala en la VM.
Para obtener más información sobre el comando de gcloud, consulta la Referencia de gcloud.

Nota: La primera vez que ejecutas gcloud compute tpus execution-groups en un proyecto, se necesitan alrededor de 5 minutos para realizar las tareas de inicio, como la propagación de llaves SSH y la activación de la API.
Si no accediste de forma automática a la instancia de Compute Engine, ejecuta el siguiente comando de ssh para acceder. Cuando accedas a la VM, el indicador de shell cambiará de username@projectname a username@vm-name:
VM de TPU
```
$ gcloud compute tpus tpu-vm ssh resnet-tutorial --zone=us-central2-b
```
Nodo TPU
```
$ gcloud compute ssh resnet-tutorial --zone=us-central2-b
```
Punto clave: A partir de este punto, el prefijo (vm)$ significa que debes ejecutar el comando en la instancia de VM de Compute Engine.

Mientras sigues estas instrucciones, ejecuta cada comando que empiece con (vm)$ en la ventana de sesión de tu VM.

Configura la variable de nombre de Cloud TPU.

VM de TPU

(vm)$ export TPU_NAME=local

Nodo TPU

(vm)$ export TPU_NAME=resnet-tutorial

Configura las variables de bucket de Cloud Storage

Configura las variables de entorno siguientes y reemplaza bucket-name por el nombre del depósito de Cloud Storage:
```
(vm)$ export STORAGE_BUCKET=gs://bucket-name
```
```
(vm)$ export MODEL_DIR=${STORAGE_BUCKET}/resnet-2x
(vm)$ export DATA_DIR=gs://cloud-tpu-test-datasets/fake_imagenet
```
La aplicación de entrenamiento espera que tus datos de entrenamiento sean accesibles en Cloud Storage. La aplicación de entrenamiento también usa tu bucket de Cloud Storage para almacenar puntos de control durante el entrenamiento.
Cuando creas tu TPU, si estableces el parámetro --version en una versión que termina en -pjrt, configura las siguientes variables de entorno para habilitar el entorno de ejecución de PJRT:
```
  (vm)$ export NEXT_PLUGGABLE_DEVICE_USE_C_API=true
  (vm)$ export TF_PLUGGABLE_DEVICE_LIBRARY_PATH=/lib/libtpu.so
```

Instala los requisitos de TensorFlow.

El comando que uses depende de si usas VM de TPU o nodos TPU.

VM de TPU

(vm)$ pip3 install -r /usr/share/tpu/models/official/requirements.txt

Nodo TPU

(vm)$ pip3 install --user -r /usr/share/models/official/requirements.txt

La secuencia de comandos de entrenamiento de ResNet requiere un paquete adicional. Instálalo ahora:
```
(vm)$ pip3 install --user tensorflow-model-optimization>=0.1.3
```

Ve al directorio en el que se almacena el modelo:

VM de TPU

(vm)$ cd /usr/share/tpu/tensorflow/resnet50_keras

Nodo TPU

(vm)$ cd /usr/share/models

Establece la variable de entorno PYTHONPATH:

VM de TPU

(vm)$ /usr/share/tpu/tensorflow/resnet50_keras"

Nodo TPU

(vm)$ export PYTHONPATH="${PYTHONPATH}:/usr/share/models"

Ejecuta la secuencia de comandos de entrenamiento. Esto usa un conjunto de datos fake_imagenet y entrena ResNet en 100 pasos.

VM de TPU

(vm)$ resnet50.py --tpu=local --data=gs://cloud-tpu-test-datasets/fake_imagenet

Command flag descriptions

tpu: The name of your TPU.
data: Specifies the directory where checkpoints and summaries are stored during model training. If the folder is missing, the program creates one. When using a Cloud TPU, the model_dir must be a Cloud Storage path (gs://...). You can reuse an existing folder to load current checkpoint data and to store additional checkpoints as long as the previous checkpoints were created using TPU of the same size and TensorFlow version.

Nodo TPU

(vm)$ python3 official/vision/train.py \
--tpu=${TPU_NAME} \
--experiment=resnet_imagenet \
--mode=train_and_eval \
--config_file=official/vision/configs/experiments/image_classification/imagenet_resnet50_tpu.yaml \
--model_dir=${MODEL_DIR} \
--params_override="task.train_data.input_path=${DATA_DIR}/train*, task.validation_data.input_path=${DATA_DIR}/validation*,task.train_data.global_batch_size=2048,task.validation_data.global_batch_size=2048,trainer.train_steps=100"

Descripciones de las marcas de comandos

tpu: El nombre de tu TPU.
model_dir: especifica el directorio en el que se almacenan los puntos de control y los resúmenes durante el entrenamiento de modelos. Si no hay una carpeta, el programa crea una. Cuando se usa una Cloud TPU, el model_dir debe ser una ruta de Cloud Storage (gs://...). Puedes reutilizar una carpeta existente para cargar datos de puntos de control actuales y almacenar puntos de control adicionales siempre que los puntos de control anteriores se hayan creado mediante TPU del mismo tamaño y versión de TensorFlow.

Esto entrenará a ResNet en 100 pasos y se completará en un nodo TPU v3-8 en aproximadamente 3 minutos. Al final de los 100 pasos, aparecerá un resultado similar al siguiente:

I0624 17:04:26.974905 140457742666816 controller.py:290]  eval | step:    100 | eval time:   23.3 sec | output:
    {'accuracy': 0.0010141226,
     'top_5_accuracy': 0.0051457332,
     'validation_loss': 8.448798}
 eval | step:    100 | eval time:   23.3 sec | output:
    {'accuracy': 0.0010141226,
     'top_5_accuracy': 0.0051457332,
     'validation_loss': 8.448798}

Ya completaste el ejemplo de entrenamiento con un solo dispositivo. Sigue los pasos que se indican a continuación para borrar los recursos actuales de TPU de dispositivo único.

Desconéctate de la instancia de Compute Engine:
```
(vm)$ exit
```
El mensaje ahora debería mostrar username@projectname, que indica que estás en Cloud Shell.
Borra el recurso TPU.
VM de TPU
```
$ gcloud compute tpus tpu-vm delete resnet-tutorial \
--zone=us-central2-b
```
Descripciones de las marcas de comandos

zone

Es la zona en la que reside tu Cloud TPU.
Nodo TPU
```
$ gcloud compute tpus execution-groups delete resnet-tutorial \
--zone=us-central2-b
```
Descripciones de las marcas de comandos

zone

La zona que contiene la TPU que se borrará.

En este punto, puedes finalizar este instructivo y realizar una limpieza o puedes continuar y explorar la ejecución del modelo en los Pods de Cloud TPU.

Escala tu modelo con pods de Cloud TPU

El entrenamiento de tu modelo en pods de Cloud TPU puede requerir algunos cambios en la secuencia de comandos de entrenamiento. Para obtener más información, consulta Entrenamiento en pods de TPU.

Entrenamiento de Pods de TPU

En esta sección, se proporciona información para configurar un bucket de Cloud Storage y recursos de Cloud TPU para el entrenamiento de Pods.

Abre una ventana de Cloud Shell.

Abra Cloud Shell
Crea una variable para el ID de tu proyecto.
```
export PROJECT_ID=project-id
```
Configura Google Cloud CLI para usar el proyecto en el que deseas crear Cloud TPU.
```
gcloud config set project ${PROJECT_ID}
```
La primera vez que ejecutes este comando en una VM de Cloud Shell nueva, se mostrará la página Authorize Cloud Shell. Haz clic en Authorize en la parte inferior de la página para permitir que gcloud realice llamadas a la API de Google Cloud con tus credenciales.

Crea una cuenta de servicio para el proyecto de Cloud TPU.

gcloud beta services identity create --service tpu.googleapis.com --project $PROJECT_ID

El comando muestra una cuenta de servicio de Cloud TPU con el siguiente formato:

service-PROJECT_NUMBER@cloud-tpu.iam.gserviceaccount.com

Crea un bucket de Cloud Storage mediante el siguiente comando o usa un bucket que hayas creado antes para tu proyecto:
```
gsutil mb -p ${PROJECT_ID} -c standard -l us-central2 gs://bucket-name
```
Este bucket de Cloud Storage almacena los datos que usas para entrenar tu modelo y los resultados del entrenamiento. Con el comando gcloud que se usa en este instructivo, se configuran los permisos predeterminados para la cuenta de servicio de Cloud TPU que configuraste en el paso anterior. Si quieres contar con permisos más detallados, revisa los permisos de nivel de acceso.

La ubicación del bucket debe estar en la misma región que tu VM de TPU.
Prepara tu conjunto de datos o usa fake_imagenet

ImageNet es una base de datos de imágenes. Las imágenes de la base de datos están organizadas en forma jerárquica, y cada nodo está representado por cientos y miles de imágenes.

El entrenamiento de Pods predeterminado accede a una versión de demostración del conjunto de datos completo de ImageNet, denominado fake_imagenet. Esta versión de demostración te permite probar el entrenamiento de Pods, a la vez que reduce los requisitos de almacenamiento y de tiempo asociados, en general, con el entrenamiento de un modelo en el conjunto de datos completo de ImageNet.

El conjunto de datos fake_imagenet solo es útil para comprender cómo usar una Cloud TPU y validar el rendimiento de extremo a extremo. Los números de exactitud y el modelo guardado no serán significativos.

Si deseas usar el conjunto de datos de ImageNet completo, consulta Descarga, preprocesa y sube el conjunto de datos de ImageNet.

Precaución: Asegúrate de no establecer la variable de entorno STORAGE_BUCKET en la ruta del conjunto de datos fake_imagenet. Puedes leer desde gs://cloud-tpu-test-datasets, pero no puedes escribir allí. Como resultado, no puedes utilizar esa ruta para escribir registros de entrenamiento. Asegúrate de que la variable de entorno STORAGE_BUCKET esté configurada para tu propio bucket de Cloud Storage.
Inicia tus recursos de Cloud TPU con el comando de gcloud.

El comando que uses depende de si usas una VM de TPU o un nodo TPU. Para obtener más información sobre la arquitectura de las dos VM, consulta Arquitectura del sistema. Para obtener más información sobre el comando de gcloud, consulta la Referencia de gcloud. En este instructivo, se especifica un Pod v3-32. Para ver otras opciones de pod, consulta las versiones de TPU.
VM de TPU
Nota: Si no hay suficiente capacidad disponible actualmente para crear el pod de TPU, puedes poner tu solicitud en cola con los recursos en cola. Los recursos en cola te permiten recibir capacidad una vez que está disponible. Si quieres solicitar tus recursos de Cloud TPU como recursos en cola, usa el comando gcloud alpha compute tpus queued-resources create en su lugar. Para obtener más información, consulta Cómo administrar recursos en cola.
```
$ gcloud compute tpus tpu-vm create resnet-tutorial \
--zone=us-central2-b \
--accelerator-type=v4-32 \
--version=tpu-vm-tf-2.16.1-pod-pjrt
```
Descripciones de las marcas de comandos

zone

La zona en la que planeas crear tu Cloud TPU.

accelerator-type

El tipo de acelerador especifica la versión y el tamaño de la Cloud TPU que quieres crear. Si quieres obtener más información sobre los tipos de aceleradores compatibles con cada versión de TPU, consulta Versiones de TPU.

version

La versión de software de Cloud TPU.

Nota: La primera vez que ejecutas gcloud en un proyecto, se necesitan alrededor de 5 minutos para realizar las tareas de inicio, como la propagación de la llave SSH y la activación de la API.
Nodo TPU
```
$ gcloud compute tpus execution-groups create \
--zone=us-central2-b \
--name=resnet-tutorial \
--accelerator-type=v3-32 \
--tf-version=2.12.0
```
Descripciones de las marcas de comandos

zone

La zona en la que planeas crear tu Cloud TPU.

name

Es el nombre de la Cloud TPU que se creará.

accelerator-type

El tipo de Cloud TPU que se creará.

tf-version

La versión gcloud de TensorFlow se instala en la VM.
Si no accediste de forma automática a la instancia de Compute Engine, ejecuta el siguiente comando de ssh para acceder. Cuando accedas a la VM, el indicador de shell cambiará de username@projectname a username@vm-instance-name:
VM de TPU
```
$ gcloud compute tpus tpu-vm ssh resnet-tutorial --zone=us-central2-b
```
Nodo TPU
```
$ gcloud compute ssh resnet-tutorial --zone=us-central2-b
```
Punto clave: A partir de este punto, el prefijo (vm)$ significa que debes ejecutar el comando en la instancia de VM de Compute Engine.

Mientras sigues estas instrucciones, ejecuta cada comando que empiece con (vm)$ en la ventana de sesión de tu VM.
Exporta las variables de configuración de Cloud TPU:
```
(vm)$ export ZONE=us-central2-b
(vm)$ export STORAGE_BUCKET=gs://bucket-name
```
```
(vm)$ export TPU_NAME=resnet-tutorial
(vm)$ export DATA_DIR=gs://cloud-tpu-test-datasets/fake_imagenet
(vm)$ export MODEL_DIR=${STORAGE_BUCKET}/resnet-2x-pod
```
La aplicación de entrenamiento espera que tus datos de entrenamiento sean accesibles en Cloud Storage. La aplicación de entrenamiento también usa tu bucket de Cloud Storage para almacenar puntos de control durante el entrenamiento.

La secuencia de comandos de entrenamiento de ResNet requiere un paquete adicional. Instálalo ahora:

VM de TPU

(vm)$ pip3 install --user tensorflow-model-optimization>=0.1.3

Nodo TPU

(vm)$ pip3 install --user tensorflow-model-optimization>=0.1.3

Instala los requisitos de TensorFlow.

El comando que uses depende de si usas VM de TPU o nodos TPU.

VM de TPU

(vm)$ pip3 install -r /usr/share/tpu/models/official/requirements.txt

Nodo TPU

(vm)$ pip3 install --user -r /usr/share/models/official/requirements.txt

Establece la variable de entorno PYTHONPATH:

VM de TPU

(vm)$ export PYTHONPATH="PYTHONPATH=/usr/share/tpu/tensorflow/resnet50_keras"
(vm)$ export TPU_LOAD_LIBRARY=0

Nodo TPU

(vm)$ export PYTHONPATH="${PYTHONPATH}:/usr/share/models"

Ve al directorio en el que se almacena el modelo:

VM de TPU

(vm)$ cd /usr/share/tpu/tensorflow/resnet50_keras

Nodo TPU

(vm)$ cd /usr/share/models

Entrena el modelo.
```
(vm)$ resnet50.py --tpu=${TPU_NAME} --data=gs://cloud-tpu-test-datasets/fake_imagenet
 
```
Descripciones de las marcas de comandos

tpu

El nombre de tu TPU.

data

especifica el directorio en el que se almacenan los puntos de control y los resúmenes durante el entrenamiento de modelos. Si la carpeta no existe, el programa crea una. Cuando se usa una Cloud TPU, el model_dir debe ser una ruta de Cloud Storage (gs://...). Puedes reutilizar una carpeta existente para cargar datos de los puntos de control actuales y almacenar puntos de control adicionales siempre que los puntos de control anteriores se hayan creado mediante Cloud TPU del mismo tamaño y versión de TensorFlow.

En este procedimiento, se entrena el modelo en el conjunto de datos fake_imagenet en 100 pasos de entrenamiento y 13 pasos de evaluación. Este entrenamiento tarda alrededor de 2 minutos en una Cloud TPU v3-32. Cuando se complete el entrenamiento y la evaluación, aparecerán mensajes similares a los siguientes:

{'accuracy': 0.0009716797,
     'learning_rate': 0.10256411,
     'top_5_accuracy': 0.0049560545,
     'training_loss': 8.5587225}
train | step:    100 | steps/sec:    1.2 | output:
    {'accuracy': 0.0009716797,
     'learning_rate': 0.10256411,
     'top_5_accuracy': 0.0049560545,
     'training_loss': 8.5587225}

eval | step:    100 | eval time:   24.8 sec | output:
    {'accuracy': 0.0010141226,
     'top_5_accuracy': 0.004356971,
     'validation_loss': 8.50038}
 eval | step:    100 | eval time:   24.8 sec | output:
    {'accuracy': 0.0010141226,
     'top_5_accuracy': 0.004356971,
     'validation_loss': 8.50038}

Limpia

Para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos usados en este instructivo, borra el proyecto que contiene los recursos o conserva el proyecto y borra los recursos individuales.

Desconéctate de la instancia de Compute Engine, si aún no lo hiciste:
```
(vm)$ exit
```
El mensaje ahora debería mostrar username@projectname, que indica que estás en Cloud Shell.
Borra tus recursos de Cloud TPU y Compute Engine. El comando que uses para borrar tus recursos depende de si usas VM o nodos TPU. Para obtener más información, consulta Arquitectura del sistema.
VM de TPU
```
$ gcloud compute tpus tpu-vm delete resnet-tutorial \
--zone=us-central2-b
```
Nodo TPU
```
$ gcloud compute tpus execution-groups delete resnet-tutorial \
--zone=us-central2-b
```
Ejecuta gcloud compute tpus execution-groups list para verificar que los recursos se hayan borrado. La eliminación puede tardar varios minutos. El resultado del siguiente comando no debe incluir ninguno de los recursos de TPU creados en este instructivo:
VM de TPU
```
$ gcloud compute tpus tpu-vm list --zone=us-central2-b
```
Nodo TPU
```
$ gcloud compute tpus execution-groups list --zone=us-central2-b
```
Ejecuta gsutil como se muestra y reemplaza bucket-name por el nombre del depósito de Cloud Storage que creaste para este instructivo:
```
$ gsutil rm -r gs://bucket-name
```

¿Qué sigue?

Los instructivos de TensorFlow Cloud TPU suelen entrenar el modelo con un conjunto de datos de muestra. Los resultados de este entrenamiento no se pueden usar para inferencias. Si quieres usar un modelo para la inferencia, puedes entrenar los datos en tu propio conjunto de datos o en un conjunto de datos disponible públicamente. Por lo general, los modelos de TensorFlow entrenados con Cloud TPU requieren que los conjuntos de datos estén en formato TFRecord.

Puedes usar la muestra de la herramienta de conversión de conjuntos de datos para convertir un conjunto de datos de clasificación de imágenes al formato TFRecord. Si no usas un modelo de clasificación de imágenes, deberás convertir tu conjunto de datos al formato TFRecord. Para obtener más información, consulta TFRecord y tf.Example.

Ajuste de hiperparámetros

Para mejorar el rendimiento del modelo con tu conjunto de datos, puedes ajustar sus hiperparámetros. Puedes encontrar información sobre los hiperparámetros comunes de todos los modelos compatibles con TPU en GitHub. La información sobre los hiperparámetros específicos del modelo se puede encontrar en el código fuente de cada modelo. Para obtener más información sobre el ajuste de hiperparámetros, consulta Descripción general del ajuste de hiperparámetros y Ajusta hiperparámetros.

Inferencia

Una vez que hayas entrenado tu modelo, puedes usarlo para la inferencia (también llamada predicción). Puedes usar la herramienta de conversión de inferencias de Cloud TPU para preparar y optimizar un modelo de TensorFlow para la inferencia en Cloud TPU v5e. Para obtener más información sobre la inferencia en Cloud TPU v5e, consulta Introducción a la inferencia con Cloud TPU v5e.

Obtén información sobre cómo entrenar y evaluar mediante tus propios datos en lugar de los conjuntos de datos fake_imagenet o ImageNet mediante el instructivo de conversión del conjunto de datos. En el instructivo, se explica cómo usar la secuencia de comandos de ejemplo del convertidor de datos de clasificación de imágenes a fin de convertir un conjunto de datos sin procesar para la clasificación de imágenes en TFRecords que pueden usar los modelos de Tensorflow de Cloud TPU.
Ejecuta un colab de Cloud TPU que muestre cómo ejecutar un modelo de clasificación de imágenes con tus propios datos de imagen.
Explora los otros instructivos de Cloud TPU.
Aprende a usar las herramientas de supervisión de TPU en TensorBoard.
Consulta cómo entrenar ResNet con Cloud TPU y GKE.