-
Notifications
You must be signed in to change notification settings - Fork 145
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
docs: add AWSIM integration page (#487)
init commit Signed-off-by: ismetatabay <[email protected]>
- Loading branch information
1 parent
5fe0b08
commit 4bcb74b
Showing
5 changed files
with
66 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Binary file added
BIN
+1.12 MB
...to-guides/integrating-autoware/awsim-integration/images/awsim-unity-project.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+144 KB
...rating-autoware/awsim-integration/images/tutorial-vehicle-awsim-integration.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+1.5 MB
.../integrating-autoware/awsim-integration/images/tutorial-vehicle-environment.png
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
65
docs/how-to-guides/integrating-autoware/awsim-integration/index.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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/). |