Entrena RetinaNet en Cloud TPU

En este documento se describe una implementación del modelo de detección de objetos RetinaNet. El código está disponible en GitHub.

En las siguientes instrucciones, se supone que ya estás familiarizado con la ejecución de un modelo en Cloud TPU. Si eres nuevo en Cloud TPU, puedes consultar la guía de inicio rápido para obtener una introducción básica.

Si planeas entrenar en una porción de pod de TPU, revisa la página sobre el entrenamiento en pods de TPU para comprender los cambios de parámetros necesarios cuando trabajas con porciones de pod.

Objetivos

Crear un bucket de Cloud Storage para almacenar el resultado de tu modelo y tu conjunto de datos
Preparar el conjunto de datos de COCO
Configurar una VM de Compute Engine y un nodo de Cloud TPU para entrenamiento y evaluación
Ejecutar el entrenamiento y la evaluación en un solo Cloud TPU o un pod de Cloud TPU

Costos

En este instructivo, se usan componentes facturables de Google Cloud, que incluyen los siguientes:

Compute Engine
Cloud TPU
Cloud Storage

Usa la calculadora de precios para generar una estimación de los costos según el uso previsto. Los usuarios nuevos de Google Cloud pueden ser elegibles para obtener una prueba gratuita.

Antes de comenzar

En esta sección, se proporciona información sobre cómo configurar el bucket de Cloud Storage y una VM de Compute Engine.

Abre una ventana de Cloud Shell.

Abrir Cloud Shell
Crea una variable para el ID de tu proyecto.
```
export PROJECT_ID=project-id
```
Configura la herramienta de línea de comandos gcloud 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 GCP 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 con el siguiente comando:
Nota: En el siguiente comando, reemplaza bucket-name por el nombre que deseas asignar a tu depósito.
```
gsutil mb -p ${PROJECT_ID} -c standard -l europe-west4 -b on gs://bucket-name
```
Este bucket de Cloud Storage almacena los datos que usas para entrenar tu modelo y los resultados del entrenamiento. La herramienta gcloud compute tpus execution-groups que se usa en este instructivo configura los permisos predeterminados para la cuenta de servicio de Cloud TPU. 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 máquina virtual (VM) y tu nodo TPU. Las VM y los nodos TPU se encuentran en zonas específicas, que son subdivisiones dentro de una región.
Inicia una VM de Compute Engine y Cloud TPU con el comando gcloud.

Nota: En este instructivo, se usa TensorFlow 1.15.5, que se basa en la imagen de Debian 10 y se establece de forma predeterminada en Python 3.6. Las versiones anteriores de TensorFlow 1.15.x se basaban en Debian 9 y se configuraban de forma predeterminada en Python 3.5.
```
$ gcloud compute tpus execution-groups create \
 --vm-only \
 --name=retinanet-tutorial \
 --zone=europe-west4-a \
 --disk-size=300 \
 --machine-type=n1-standard-8 \
 --tf-version=1.15.5
```
Descripciones de las marcas de comandos

vm-only

Crea solo una VM. De forma predeterminada, el comando gcloud compute tpus execution-groups crea una VM y una Cloud TPU.

name
El nombre de la Cloud TPU para crear.
zone
Es la zona en la que deseas crear la Cloud TPU.
disk-size
El tamaño del disco duro en GB de la VM creada con el comando gcloud compute tpus execution-groups.
machine-type
El tipo de máquina de la VM de Compute Engine que se creará.
tf-version
La versión de Tensorflow gcloud compute tpus execution-groups se instala en la VM.

Para obtener más información sobre el comando gcloud, consulta la referencia de gcloud.
Aparece la configuración que especificaste. Ingresa y para aprobar o n para cancelar.
Nota La primera vez que ejecutas gcloud compute tpus execution-groups en un proyecto, tarda unos 5 minutos en realizar las tareas de inicio, como la propagación de llaves SSH y la activación de la API.
Cuando el comando gcloud compute tpus execution-groups termine de ejecutarse, verifica que el indicador de shell haya cambiado de username@projectname a username@vm-name. Este cambio indica que accediste a tu VM de Compute Engine.
Nota :Si no estás conectado a la instancia de Compute Engine, puedes conectarte mediante la ejecución del comando siguiente:
```
gcloud compute ssh retinanet-tutorial --zone=europe-west4-a
```
Mientras sigues estas instrucciones, ejecuta cada comando que comience con (vm)$ en tu instancia de Compute Engine.

Cuando el comando gcloud inicia una máquina virtual (VM) de Compute Engine, ubica de forma automática los archivos del modelo RetinaNet de la rama de TensorFlow en el directorio /usr/share/tpu/models/official/detection/.
Usa el comando export para configurar estas variables de entorno.

Nota: En los siguientes comandos, reemplaza bucket-name por el nombre de tu bucket.
```
(vm)$ export STORAGE_BUCKET=gs://bucket-name
```
```
(vm)$ export TPU_NAME=retinanet-tutorial
(vm)$ export DATA_DIR=${STORAGE_BUCKET}/coco
```

Instala paquetes adicionales

La aplicación de entrenamiento RetinaNet requiere varios paquetes adicionales. Instálalos ahora:

(vm)$ sudo apt-get install -y python3-tk

(vm)$ pip3 install --user Cython matplotlib opencv-python-headless pyyaml Pillow

(vm)$ pip3 install --user 'git+https://github.com/cocodataset/cocoapi#egg=pycocotools&subdirectory=PythonAPI'

(vm)$ pip3 install --user -U gast==0.2.2

Prepara el conjunto de datos de COCO

Ejecuta la secuencia de comandos download_and_preprocess_coco.sh para convertir el conjunto de datos COCO en un conjunto de TFRecords (*.tfrecord), que son compatibles con la aplicación de entrenamiento.
```
(vm)$ sudo bash /usr/share/tpu/tools/datasets/download_and_preprocess_coco.sh ./data/dir/coco
```
Esto instala las bibliotecas necesarias y ejecuta la secuencia de comandos de procesamiento previo. Como resultado, se muestra una serie de archivos *.tfrecord en tu directorio de datos local.
Note:La secuencia de comandos de conversión y descarga de COCO tarda alrededor de 1 hora en completarse.
Después de convertir los datos en TFRecords, cópialos desde almacenamiento local a tu depósito de Cloud Storage con el comando gsutil. También debes copiar los archivos de anotaciones. Estos archivos ayudan a validar el rendimiento del modelo:
```
(vm)$ gsutil -m cp ./data/dir/coco/*.tfrecord ${DATA_DIR}
```
```
(vm)$ gsutil cp ./data/dir/coco/raw-data/annotations/*.json ${DATA_DIR}
```

Establece el entorno de entrenamiento

Ejecuta el siguiente comando para crear tu Cloud TPU.
```
(vm)$ gcloud compute tpus execution-groups create \
 --tpu-only \
 --name=retinanet-tutorial \
 --zone=europe-west4-a \
 --tf-version=1.15.5
```
Descripciones de las marcas de comandos

tpu-only

Crea la Cloud TPU sin crear una VM. De forma predeterminada, el comando gcloud compute tpus execution-groups crea una VM y una Cloud TPU.

name
El nombre de la Cloud TPU para crear.
zone
Es la zona en la que deseas crear la Cloud TPU.
tf-version
La versión de Tensorflow gcloud compute tpus execution-groups se instala en la VM.
Aparece la configuración que especificaste. Ingresa y para aprobar o n para cancelar.

Verás el siguiente mensaje: Operation success; not ssh-ing to Compute Engine VM due to --tpu-only flag. Como ya completaste la propagación de Llaves SSH, puedes ignorar este mensaje.
Actualiza los valores de keepalive de la conexión de VM.

En este instructivo, se requiere una conexión de larga duración a la instancia de Compute Engine. Para asegurarte de que no estés desconectado de la instancia, ejecuta el siguiente comando:
```
(vm)$ sudo /sbin/sysctl \
  -w net.ipv4.tcp_keepalive_time=120 \
  net.ipv4.tcp_keepalive_intvl=120 \
  net.ipv4.tcp_keepalive_probes=5
```
Ya estás listo para ejecutar el modelo en los datos de COCO ya procesados. Primero, agrega la carpeta /models de nivel superior a la ruta de Python con el siguiente comando:
```
(vm)$ export PYTHONPATH=${PYTHONPATH}:/usr/share/tpu/models
```

Para el entrenamiento y la evaluación se requiere TensorFlow 1.13 o una versión posterior.

Entrenamiento de dispositivos de una sola Cloud TPU

Configura las siguientes variables de entorno:

(vm)$ export MODEL_DIR=${STORAGE_BUCKET}/retinanet-model-train
(vm)$ export RESNET_CHECKPOINT=gs://cloud-tpu-checkpoints/retinanet/resnet50-checkpoint-2018-02-07
(vm)$ export TRAIN_FILE_PATTERN=${DATA_DIR}/train-*
(vm)$ export EVAL_FILE_PATTERN=${DATA_DIR}/val-*
(vm)$ export VAL_JSON_FILE=${DATA_DIR}/instances_val2017.json

Ejecuta la secuencia de comandos de entrenamiento:
```
(vm)$ python3 /usr/share/tpu/models/official/detection/main.py \
--use_tpu=True \
--tpu=${TPU_NAME} \
--num_cores=8 \
--model_dir=${MODEL_DIR} \
--mode="train" \
--eval_after_training=True \
--params_override="{ type: retinanet, train: { checkpoint: { path: ${RESNET_CHECKPOINT}, prefix: resnet50/ }, train_file_pattern: ${TRAIN_FILE_PATTERN} }, eval: { val_json_file: ${VAL_JSON_FILE}, eval_file_pattern: ${EVAL_FILE_PATTERN}, eval_samples: 5000 } }"
```
Descripciones de las marcas de comandos

use_tpu

Entrena el modelo en una sola Cloud TPU.

tpu

El nombre de Cloud TPU. Se configura con la variable de entorno TPU_NAME.

num_cores

Es la cantidad de núcleos de Cloud TPU que se usarán durante el entrenamiento.

model_dir

El bucket de Cloud Storage en el que se almacenan los puntos de control y los resúmenes durante el entrenamiento. Puedes usar una carpeta existente para cargar puntos de control generados con anterioridad en una TPU del mismo tamaño y con la misma versión de TensorFlow.

mode

Uno de train, eval, o train_and_eval.

Evaluación de dispositivos de una sola Cloud TPU

En el siguiente procedimiento se usan los datos de evaluación de COCO. Toma alrededor de 10 minutos ejecutar los pasos de evaluación.

Configura las siguientes variables de entorno:
```
(vm)$ export EVAL_SAMPLES=5000
```
Ejecuta la secuencia de comandos de evaluación:
```
  (vm)$ python3 /usr/share/tpu/models/official/detection/main.py \
    --use_tpu=True \
    --tpu=${TPU_NAME} \
    --num_cores=8 \
    --model_dir=${MODEL_DIR} \
    --mode="eval" \
    --params_override="{ type: retinanet, eval: { val_json_file: ${VAL_JSON_FILE}, eval_file_pattern: ${EVAL_FILE_PATTERN}, eval_samples: ${EVAL_SAMPLES} } }"
```
Descripciones de las marcas de comandos

use_tpu

Configúralo en true para entrenar en una Cloud TPU.

tpu

El nombre de la Cloud TPU para ejecutar el entrenamiento o la evaluación.

num_cores

Es la cantidad de núcleos de Cloud TPU que se usarán durante el entrenamiento.

model_dir

El bucket de Cloud Storage en el que se almacenan los puntos de control y los resúmenes durante el entrenamiento. Puedes usar una carpeta existente para cargar puntos de control generados con anterioridad en una TPU del mismo tamaño y con la misma versión de TensorFlow.

mode

Una de train, eval, or train_and_eval.

params_override

Una string JSON que anula los parámetros de secuencia de comandos predeterminados. Para obtener más información sobre los parámetros de secuencia de comandos, consulta /usr/share/models/official/vision/detection/main.py.

La secuencia de comandos de evaluación muestra un resultado como el siguiente:
```
Eval result: {
  'AP': 0.3371653,
  'ARl': 0.6749888,
  'ARmax100': 0.4848119,
  'APl': 0.48918217,
  'ARmax10': 0.45885247,
  'APs': 0.14764188,
  'ARm': 0.545395,
  'ARs': 0.24094534,
  'AP75': 0.3606217,
  'AP50': 0.51819533,
  'APm': 0.38223606,
  'ARmax1': 0.29476196
}
```
En este punto, puedes finalizar este instructivo y limpiar tus recursos de GCP o puedes explorar con más detalle cómo ejecutar el modelo en los pods de Cloud TPU.

Escala tu modelo con pods de Cloud TPU

Puedes obtener resultados más rápidos si escalas tu modelo con pods de Cloud TPU. El modelo RetinaNet totalmente compatible puede funcionar con las siguientes porciones de pod:

v2-32
v3-32

Borra el recurso de Cloud TPU que creaste a fin de entrenar el modelo en un solo dispositivo.

(vm)$ gcloud compute tpus execution-groups delete retinanet-tutorial \
  --zone=europe-west4-a \
  --tpu-only

Ejecuta el comando gcloud compute tpus execution-groups con el parámetro accelerator-type para especificar la porción de pod que deseas usar. Por ejemplo, el siguiente comando usa una porción de pod v3-32.
```
(vm)$ gcloud compute tpus execution-groups create --name=retinanet-tutorial \
  --accelerator-type=v3-32  \
  --zone=europe-west4-a \
  --tf-version=1.15.5 \
  --tpu-only
```
Descripciones de las marcas de comandos

name
El nombre de la Cloud TPU para crear.
accelerator-type
El tipo de Cloud TPU que se creará.
zone
Es la zona en la que deseas crear la Cloud TPU.
tf-version
La versión de Tensorflow gcloud se instala en la VM.
tpu-only

Crea una Cloud TPU sola. De forma predeterminada, el comando gcloud crea una VM y una Cloud TPU.

Configura las siguientes variables de entorno:

(vm)$ export MODEL_DIR=${STORAGE_BUCKET}/retinanet-model-pod
(vm)$ export TPU_NAME=retinanet-tutorial

Ejecuta la secuencia de comandos de entrenamiento del pod en un nodo TPU v3-32:
```
(vm)$ python3 /usr/share/tpu/models/official/detection/main.py \
--use_tpu=True \
--tpu=${TPU_NAME} \
--num_cores=32 \
--model_dir=${MODEL_DIR} \
--mode="train" \
--eval_after_training=False \
--params_override="{ type: retinanet, train: { train_batch_size: 1024, total_steps: 2109, learning_rate: { warmup_steps: 820, init_learning_rate: 0.64, learning_rate_levels: [0.064, 0.0064], learning_rate_steps: [1641, 1992] }, checkpoint: { path: ${RESNET_CHECKPOINT}, prefix: resnet50/ }, train_file_pattern: ${TRAIN_FILE_PATTERN} }, resnet: { batch_norm: { batch_norm_momentum: 0.9 }}, fpn: { batch_norm: { batch_norm_momentum: 0.9 }}, retinanet_head: { batch_norm: { batch_norm_momentum: 0.9 }} }"
```
Descripciones de las marcas de comandos

use_tpu

Configúralo en true para entrenar en una Cloud TPU.

tpu

El nombre de Cloud TPU. Si no se especifica cuando se configuran la VM de Compute Engine y Cloud TPU, se utilizará tu nombre de usuario de forma predeterminada.

num_cores

Es la cantidad de núcleos de Cloud TPU que se usarán para el entrenamiento.

model_dir

El bucket de Cloud Storage en el que se almacenan los puntos de control y los resúmenes durante el entrenamiento. Puedes usar una carpeta existente para cargar puntos de control generados con anterioridad en una TPU del mismo tamaño y con la misma versión de TensorFlow.

mode

Uno de train, eval, train_and_eval, o predict.

eval_after_training

Configúralo en true para evaluar el modelo después del entrenamiento.

params_override

Una string JSON que anula los parámetros de secuencia de comandos predeterminados. Para obtener más información sobre los parámetros de secuencia de comandos, consulta /usr/share/models/official/vision/detection/main.py.

El resultado de la secuencia de comandos de entrenamiento debe tener el siguiente texto:

INFO:tensorflow:Loss for final step: 0.96952075.
I1125 21:47:10.729412 140023184553728 estimator.py:371] Loss for final step: 0.96952075.
INFO:tensorflow:training_loop marked as finished
I1125 21:47:10.730288 140023184553728 error_handling.py:101] training_loop marked as finished

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.

En Cloud Shell, usa el siguiente comando para borrar tu VM de Compute Engine y Cloud TPU:

$ gcloud compute tpus execution-groups delete retinanet-tutorial \
  --zone=europe-west4-a

Ejecuta gcloud compute tpus execution-groups list para verificar que los recursos se hayan borrado. La eliminación puede tomar varios minutos. Una respuesta como la que se muestra a continuación indica que tus instancias se borraron de forma correcta.
```
$ gcloud compute tpus execution-groups list \
 --zone=europe-west4-a
```
Deberías ver una lista vacía de TPU como la que se muestra a continuación:
```
   NAME             STATUS
```
Borra tu bucket de Cloud Storage con gsutil como se muestra a continuación. Reemplaza bucket-name por el nombre del bucket de Cloud Storage.
```
$ gsutil rm -r gs://bucket-name
```

¿Qué sigue?

En este instructivo, entrenaste el modelo RetinaNet mediante un conjunto de datos de muestra. Los resultados de esta capacitación (en la mayoría de los casos) no se pueden usar para la inferencia. Para usar un modelo de inferencia, puedes entrenar los datos en un conjunto de datos disponible públicamente o en tu propio conjunto de datos. Los modelos entrenados en Cloud TPU requieren que los conjuntos de datos tengan el 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 en formato TFRecord. Si no usas un modelo de clasificación de imágenes, deberás convertir tú mismo el conjunto de datos en 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 los hiperparámetros del modelo. Puedes encontrar información sobre hiperparámetros comunes para 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 para cada modelo. Para obtener más información sobre el ajuste de hiperparámetros, consulta Descripción general del ajuste de hiperparámetros, Usa el servicio de ajuste de hiperparámetros y Ajusta los hiperparámetros.

Inferencia

Una vez que entrenaste tu modelo, puedes usarlo para la inferencia (también llamada predicción). AI Platform es una solución basada en la nube que sirve para desarrollar, entrenar e implementar modelos de aprendizaje automático. Una vez que se implementa un modelo, puedes usar el servicio de AI Platform Prediction.

Entrena con diferentes tamaños de imagen

Puedes explorar con una red neuronal más grande (por ejemplo, ResNet-101 en lugar de ResNet-50). Una imagen de entrada más grande y una red neuronal más potente producirán un modelo más lento, pero más preciso.

Usa una base diferente

De manera alternativa, puedes explorar con el entrenamiento previo de un modelo ResNet en tu propio conjunto de datos y usarlo como base para tu modelo RetinaNet. Con algo más de trabajo, también puedes intercambiar ResNet por una red troncal alternativa. Por último, si estás interesado en implementar tus propios modelos de detección de objetos, esta red puede ser una buena base para experimentar más.

Entrena RetinaNet en Cloud TPU

Objetivos

Costos

Antes de comenzar

Descripciones de las marcas de comandos

Prepara el conjunto de datos de COCO

Establece el entorno de entrenamiento

Descripciones de las marcas de comandos

Entrenamiento de dispositivos de una sola Cloud TPU

Descripciones de las marcas de comandos

Evaluación de dispositivos de una sola Cloud TPU

Descripciones de las marcas de comandos

Escala tu modelo con pods de Cloud TPU

Descripciones de las marcas de comandos

Descripciones de las marcas de comandos

Limpia

¿Qué sigue?

Ajuste de hiperparámetros

Inferencia

Entrena con diferentes tamaños de imagen

Usa una base diferente