Skip to main content

Getting Started With the Synthetic Environments Dataset

This section will cover everything you need to know to get up and running using Aria Synthetic Environments (ASE) visualizers and data loaders. ASE tooling contains:

  • The install instructions specific to ASE
  • A quick tutorial which runs through a couple of Jupyter notebook for loading and visualizing sample data.

If you have problems using Jupyter examples, please upgrade python3 to the latest version.

Quickstart Tutorial - Python

Step 0 : Check system requirements and download codebase

Ensure your system is supported and then download projectaria_tools codebase from the github

Step 1 : Install Python

Ensure python3 is installed on the system (check with python3 --version)

Step 2 : Create a virtual environment

rm -rf $HOME/projectaria_tools_python_env

python3 -m venv $HOME/projectaria_tools_python_env

source $HOME/projectaria_tools_python_env/bin/activate

Step 3 : Install projectaria_tools from PyPI

python3 -m pip install --upgrade pip

python3 -m pip install projectaria-tools'[all]'

The ASE Python tooling for projection of 3D points to RGB images is included in the projectaria_tools package, so no further steps are needed. The following packages used in this tutorial are standard Python packages that are also included in project_aria_tools build:

  • plotly
  • numpy
  • scipy
  • pandas
  • matplotlib
  • requests
  • tqdm
  • jupyter

Step 4 : Download sample data

  1. Navigate to the ASE page on the Project Aria Website and follow the instructions to download the download-urls file. This same download-urls file can be used for any dataset download until the link expires
  2. Setup ASE local folder and move download-urls file:
mkdir -p $HOME/Documents/projectaria_sandbox/projectaria_tools_ase_data

mv $HOME/Downloads/aria_synthetic_environments_dataset_download_urls.json $HOME/Documents/projectaria_sandbox/projectaria_tools_ase_data/
  1. Download sample dataset using the download tool:
cd $HOME/Documents/projectaria_sandbox/projectaria_tools

python3 projects/AriaSyntheticEnvironment/aria_synthetic_environments_downloader.py --set train --scene-ids 0-10 --cdn-file $HOME/Documents/projectaria_sandbox/projectaria_tools_ase_data/aria_synthetic_environments_dataset_download_urls.json --output-dir $HOME/Documents/projectaria_sandbox/projectaria_tools_ase_data --unzip True

Step 5 : Run the visualization notebooks

jupyter notebook projects/AriaSyntheticEnvironment/tutorial/ase_tutorial_notebook.ipynb

Troubleshooting

Go to Data Utilities Troubleshooting if you experience issues implementing this guide.