Skip to content

Commit

Permalink
docs: add AWSIM integration page (#487)
Browse files Browse the repository at this point in the history
init commit

Signed-off-by: ismetatabay <[email protected]>
  • Loading branch information
ismetatabay authored Dec 1, 2023
1 parent 5fe0b08 commit 4bcb74b
Show file tree
Hide file tree
Showing 5 changed files with 66 additions and 0 deletions.
1 change: 1 addition & 0 deletions docs/how-to-guides/integrating-autoware/.pages
Original file line number Diff line number Diff line change
Expand Up @@ -6,3 +6,4 @@ nav:
- 4. Creating maps: creating-maps
- 5. Launch Autoware: launch-autoware
- 6. Tuning parameters and performance: tuning-parameters-and-performance
- 7. AWSIM Integration: awsim-integration
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
65 changes: 65 additions & 0 deletions docs/how-to-guides/integrating-autoware/awsim-integration/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
# How to integrate your vehicle in AWSIM environment

## Overview

[AWSIM](https://github.com/tier4/AWSIM) is an open-source simulator designed by TIER IV for
training and evaluating autonomous driving systems.
It provides a realistic virtual environment for simulating various real-world scenarios, enabling
users to test and refine their autonomous systems before deployment on actual vehicles.

## Setup Unity Project

To add your environment and vehicle to the AWSIM simulation,
you need to set up the [Unity](https://unity.com/) environment on your computer.
Please follow the steps on the [`Setup Unity Project`](https://tier4.github.io/AWSIM/GettingStarted/SetupUnityProject/)
documentation page
to set up the Unity environment on your computer.

<figure markdown>
![setup-unity-project](images/awsim-unity-project.png){ align=center }
<figcaption>
AWSIM Unity Setup
</figcaption>
</figure>

## New Vehicle Integration

To incorporate your vehicle into the AWSIM environment,
you'll need a 3D model file (.dae, .fbx) of your vehicle.
Please refer to the steps on the [`Add New Vehicle
documentation page`](https://tier4.github.io/AWSIM/Components/Vehicle/AddNewVehicle/AddAVehicle/) to add your own vehicle to the AWSIM
project environment. During these steps, you'll configure
your sensor URDF design on your vehicle.
Our tutorial vehicle is shown in the AWSIM environment in the following image.

<figure markdown>
![tutorial-vehicle-awsim-integration](images/tutorial-vehicle-awsim-integration.png){ align=center }
<figcaption>
Tutorial vehicle in AWSIM Unity Environment
</figcaption>
</figure>

## Environment Integration

Creating custom 3D environments for AWSIM is feasible,
but it's recommended to adhere to the .fbx file format.
Materials and textures should be stored in separate directories
for seamless integration with Unity. This format facilitates material
importation and replacement during import.
Please refer to the steps on the
[`Add Environment documentation page`](https://tier4.github.io/AWSIM/Components/Environment/AddNewEnvironment/AddEnvironment/)
to add your custom environment to the AWSIM project environment.

<figure markdown>
![tutorial-vehicle-awsim-environment](images/tutorial-vehicle-environment.png){ align=center }
<figcaption>
Tutorial vehicle AWSIM Unity Environment
</figcaption>
</figure>

## Others

Additionally, you can incorporate traffic and NPCs,
generate point cloud maps using lanelet2 maps, and
perform other tasks by following the relevant
documentation steps provided in the [`AWSIM documentation`](https://tier4.github.io/AWSIM/).

0 comments on commit 4bcb74b

Please sign in to comment.