View a markdown version of this page

Model management - DeepRacer on AWS

Model management

Note

This section is available to both admins and race facilitators. In the console, these pages live under the Model Management group in the navigation pane.

Admins and race facilitators can optimize models for physical cars and push optimized models to cars. They can also download physical car models and view upload status. Perform these tasks from the Model Management group in the navigation pane. For more information about who can perform each task, see Permissions matrix. Racers import their own physical models from the Your models page. For more information, see Import and export models.

Find and optimize a model

You optimize a virtual model for a physical car before you push it to that car. Optimization is non-blocking: a failed optimization never blocks virtual racing.

The following image shows the Models page, where you filter models by username and optimize a selected model for a car.

Models page listing models with optimization status and optimize action
  1. In the navigation pane, under Model Management, choose Models.

  2. Filter the list by Username to find a racer’s model.

  3. Select one model that has a READY status.

  4. Choose Optimize for car.

On the Models page, the status shows as Not optimized, then In progress, then Optimized when it completes, or Failed if it does not. A failed optimization does not affect virtual racing, and you can run the optimization again.

Push a model to a car

You push one or more optimized models to a physical car over a wireless connection. The car must first be activated through Device Management.

The following image shows the upload-to-car progress view, with per-model status and a progress bar.

Upload to car progress view with per-model status and progress bar
  1. In the navigation pane, under Model Management, choose Models.

  2. Select one or more optimized models. To push several models at once, select multiple models.

  3. Choose Upload model to car.

  4. For Event, choose an event.

  5. Select an online car.

  6. (Optional) To remove existing models from the car before the upload, select Clear car models first?.

  7. Choose Upload model to car to start the upload.

Note

The solution automatically delivers the correct model format for your car. It supports three physical car types: an unmodified AWS DeepRacer car, an AWS DeepRacer running a custom operating system, and a Raspberry Pi-based custom car.

Download a physical car model

You can download any user’s model in physical car format from the Models page.

  1. In the navigation pane, under Model Management, choose Models.

  2. Filter the list by Username to find a racer’s model.

  3. Choose Download next to the model to download it in physical car format.

Note

Physical models are exported in .tar.gz format. If you are using Windows, you will need to install 7-Zip or another program that is capable of extracting this type of file.

View upload status

You can review the history of your uploads to cars on the Upload Status page, which has the page header Uploads to car status.

The following image shows the Upload Status page, listing past uploads to cars and their status.

Upload Status page listing past uploads to cars and their status
  1. In the navigation pane, under Model Management, choose Upload Status.

  2. Review the status of each upload to a car.