From 03f396ca14d7ba40ddceaa711319bf852542ccad Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?M=2E=20Fatih=20C=C4=B1r=C4=B1t?= Date: Wed, 24 Apr 2024 20:28:51 +0300 Subject: [PATCH 01/18] chore: release v1.0.0-beta MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: M. Fatih Cırıt --- ProjectSettings/ProjectSettings.asset | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/ProjectSettings/ProjectSettings.asset b/ProjectSettings/ProjectSettings.asset index ab90c14ab..ed85477fd 100644 --- a/ProjectSettings/ProjectSettings.asset +++ b/ProjectSettings/ProjectSettings.asset @@ -12,8 +12,8 @@ PlayerSettings: targetDevice: 2 useOnDemandResources: 0 accelerometerFrequency: 60 - companyName: TIERIV - productName: AWSIM + companyName: AWF + productName: AWSIM Labs defaultCursor: {fileID: 0} cursorHotspot: {x: 0, y: 0} m_SplashScreenBackgroundColor: {r: 0, g: 0, b: 0, a: 1} @@ -141,7 +141,7 @@ PlayerSettings: loadStoreDebugModeEnabled: 0 visionOSBundleVersion: 1.0 tvOSBundleVersion: 1.0 - bundleVersion: 1.2.0 + bundleVersion: 1.0.0-beta preloadedAssets: [] metroInputSource: 0 wsaTransparentSwapchain: 0 @@ -163,7 +163,7 @@ PlayerSettings: androidSupportedAspectRatio: 1 androidMaxAspectRatio: 2.1 applicationIdentifier: - Standalone: com.TIERIV.AWSIM + Standalone: com.AWF.AWSIM-Labs buildNumber: Standalone: 0 VisionOS: 0 From b4e74ad26a5a7c3e5aaa768b6b0a2066b03429a8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?M=2E=20Fatih=20C=C4=B1r=C4=B1t?= Date: Wed, 24 Apr 2024 20:57:38 +0300 Subject: [PATCH 02/18] update the documentation MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: M. Fatih Cırıt --- docs/GettingStarted/QuickStartDemo/index.md | 145 ++++++++++++-------- 1 file changed, 87 insertions(+), 58 deletions(-) diff --git a/docs/GettingStarted/QuickStartDemo/index.md b/docs/GettingStarted/QuickStartDemo/index.md index 26d300a9e..f65f042d2 100644 --- a/docs/GettingStarted/QuickStartDemo/index.md +++ b/docs/GettingStarted/QuickStartDemo/index.md @@ -9,50 +9,89 @@ The instruction assumes using the Ubuntu OS. The simulation provided in the AWSIM demo is configured as follows: -|AWSIM Demo Settings|| -|:--|:--| -|Vehicle|Lexus RX 450h| -|Environment|Japan Tokyo Nishishinjuku| -|Sensors|Gnss * 1
IMU * 1
LiDAR * 1
Traffic camera * 1| -|Traffic|Randomized traffic| -|ROS2|humble| +| AWSIM Demo Settings | | +|:--------------------|:-------------------------------------------| +| Vehicle | Lexus RX 450h | +| Environment | Japan Tokyo Nishishinjuku | +| Sensors | GNSS, IMU, 3 x VLP16, Traffic Light Camera | +| Traffic | Randomized traffic | +| ROS2 | humble | ### PC specs Please make sure that your machine meets the following requirements in order to run the simulation correctly: -|Required PC Specs|| -|:--|:--| -|OS|Ubuntu 22.04| -|CPU|6cores and 12thread or higher| -|GPU|RTX2080Ti or higher| -|Nvidia Driver (Windows)|>=472.50| -|Nvidia Driver (Ubuntu 22)|>=515.43.04| +| Required PC Specs | | +|:--------------------------|:--------------------------------| +| OS | Ubuntu 22.04 | +| CPU | 6 cores and 12 thread or higher | +| GPU | RTX 2080Ti or higher | +| Nvidia Driver (Ubuntu 22) | >=515.43.04 | -### Localhost settings +### DDS configuration -The simulation is based on the appropriate network setting, which allows for trouble-free communication of the AWSIM simulation with the Autoware software. -To apply required localhost settings please add the following lines to `~/.bashrc` file: +In order to run AWSIM Labs with the best performance and without hogging the network, please follow the steps below. + +Add the following lines to `~/.bashrc` file: ``` bash if [ ! -e /tmp/cycloneDDS_configured ]; then sudo sysctl -w net.core.rmem_max=2147483647 + sudo sysctl -w net.ipv4.ipfrag_time=3 + sudo sysctl -w net.ipv4.ipfrag_high_thresh=134217728 # (128 MB) sudo ip link set lo multicast on touch /tmp/cycloneDDS_configured fi ``` -and these lines to `~/.profile` **or in either of files:** `~/.bash_profile` *or* `~/.bash_login`: +Every time you restart this machine, and open a new terminal, the above commands will be executed. + +Until you restart the machine, they will not be executed again. + +#### CycloneDDS configuration + +Save the following as `cyclonedds.xml` in your home directory `~`: +```xml + + + + + + + + default + 65500B + + + + + 500kB + + + + + +``` + +Make sure the following lines are added to the `~/.bashrc` file: ``` bash -export ROS_LOCALHOST_ONLY=1 export RMW_IMPLEMENTATION=rmw_cyclonedds_cpp +export CYCLONEDDS_URI=/home/your_username/cyclonedds.xml ``` +Replace `your_username` with your actual username. + +!!! note + You should use the absolute path to the `cyclonedds.xml` file. + !!! warning A system restart is required for these changes to work. +!!! warning + **DO NOT** set `export ROS_LOCALHOST_ONLY=1`. CycloneDDS configuration will be enough. + ## Start the demo ### Running the AWSIM demo @@ -68,12 +107,10 @@ To run the simulator, please follow the steps below. 2. Install the recommended version of the driver. ``` sudo ubuntu-drivers autoinstall + + # or install a specific version (following was tested) + sudo apt install nvidia-driver-550 ``` - - !!! warning - - Currently, there are cases where the Nvidia driver version is too high, resulting in Segmentation fault. In that case, please lower the Nvidia driver version (525 is recommended.) - 3. Reboot your machine to make the installed driver detected by the system. ``` sudo reboot @@ -81,27 +118,18 @@ To run the simulator, please follow the steps below. 4. Open terminal and check if `nvidia-smi` command is available and outputs summary similar to the one presented below. ``` $ nvidia-smi - Fri Oct 14 01:41:05 2022 - +-----------------------------------------------------------------------------+ - | NVIDIA-SMI 515.65.01 Driver Version: 515.65.01 CUDA Version: 11.7 | - |-------------------------------+----------------------+----------------------+ - | GPU Name Persistence-M| Bus-Id Disp.A | Volatile Uncorr. ECC | - | Fan Temp Perf Pwr:Usage/Cap| Memory-Usage | GPU-Util Compute M. | - | | | MIG M. | - |===============================+======================+======================| - | 0 NVIDIA GeForce ... Off | 00000000:01:00.0 On | N/A | - | 37% 31C P8 30W / 250W | 188MiB / 11264MiB | 3% Default | - | | | N/A | - +-------------------------------+----------------------+----------------------+ - - +-----------------------------------------------------------------------------+ - | Processes: | - | GPU GI CI PID Type Process name GPU Memory | - | ID ID Usage | - |=============================================================================| - | 0 N/A N/A 1151 G /usr/lib/xorg/Xorg 133MiB | - | 0 N/A N/A 1470 G /usr/bin/gnome-shell 45MiB | - +-----------------------------------------------------------------------------+ + +-----------------------------------------------------------------------------------------+ + | NVIDIA-SMI 550.54.15 Driver Version: 550.54.15 CUDA Version: 12.4 | + |-----------------------------------------+------------------------+----------------------+ + | GPU Name Persistence-M | Bus-Id Disp.A | Volatile Uncorr. ECC | + | Fan Temp Perf Pwr:Usage/Cap | Memory-Usage | GPU-Util Compute M. | + | | | MIG M. | + |=========================================+========================+======================| + | 0 NVIDIA GeForce RTX 3080 Off | 00000000:2D:00.0 On | N/A | + | 30% 40C P8 35W / 320W | 5299MiB / 10240MiB | 7% Default | + | | | N/A | + +-----------------------------------------+------------------------+----------------------+ + ... ``` 2. Install Vulkan Graphics Library (Skip if already installed). @@ -116,27 +144,26 @@ To run the simulator, please follow the steps below. 3. Download and Run AWSIM Demo binary. - 1. Download `AWSIM_v1.2.0.zip`. - We don't have a release yet. Please follow the Setup Guide to build the AWSIM binary. + 1. Download `AWSIM_Labs_v1.0.0-beta.zip`. [Download AWSIM Demo for ubuntu](){.md-button .md-button--primary} 2. Unzip the downloaded file. - 3. Make the `AWSIM_v1.2.0.x86_64` file executable. + 3. Make the file executable. - Right click the `AWSIM_v1.2.0.x86_64` file and check the `Execute` checkbox + Right click the `awsim_labs.x86_64` file and check the `Execute` checkbox ![](Image_1.png) or execute the command below. ``` - chmod +x /AWSIM_v1.2.0.x86_64 + chmod +x /awsim_labs.x86_64 ``` - 4. Launch `AWSIM_v1.2.0.x86_64`. + 4. Launch `awsim_labs.x86_64`. ``` - .//AWSIM_v1.2.0.x86_64 + .//awsim_labs.x86_64 ``` !!! warning @@ -158,9 +185,9 @@ In order to configure and run the Autoware software with the AWSIM demo, please: git clone https://github.com/autowarefoundation/autoware.git cd autoware ``` -3. Switch branch to `awsim-stable`. *NOTE: The latest `main` branch is for [ROS 2 humble](https://docs.ros.org/en/rolling/Releases/Release-Humble-Hawksbill.html).* +3. Switch branch to `main`. ``` -git checkout awsim-stable +git checkout main ``` 4. Configure the environment. (Skip if Autoware environment has been configured before) ``` @@ -173,14 +200,13 @@ vcs import src < autoware.repos ``` 6. Install dependent ROS packages. ``` - source /opt/ros/humble/setup.bash rosdep update rosdep install -y --from-paths src --ignore-src --rosdistro $ROS_DISTRO ``` 7. Build the workspace. ``` -colcon build --symlink-install --cmake-args -DCMAKE_BUILD_TYPE=Release -DCMAKE_CXX_FLAGS="-w" +colcon build --symlink-install --cmake-args -DCMAKE_BUILD_TYPE=RelWithDebInfo -DCMAKE_EXPORT_COMPILE_COMMANDS=1 ``` 8. Launch Autoware. @@ -189,7 +215,10 @@ colcon build --symlink-install --cmake-args -DCMAKE_BUILD_TYPE=Release -DCMAKE_C `` must be changed arbitrarily. When specifying the path the `~` operator cannot be used - please specify absolute full path. ``` source install/setup.bash -ros2 launch autoware_launch e2e_simulator.launch.xml vehicle_model:=sample_vehicle sensor_model:=awsim_sensor_kit map_path:= +ros2 launch autoware_launch e2e_simulator.launch.xml vehicle_model:=sample_vehicle sensor_model:=awsim_labs_sensor_kit map_path:= + +# Example: +ros2 launch autoware_launch e2e_simulator.launch.xml vehicle_model:=sample_vehicle sensor_model:=awsim_labs_sensor_kit map_path:=/home/your_username/autoware_map/nishishinjuku_autoware_map ``` ![](Image_2.png) @@ -212,7 +241,7 @@ The generated path can be seen on the image below. 5. Enable self-driving. -To make the vehicle start navigating please engage it's operation using the command below. +To make the vehicle start navigating please engage its operation using the command below. ``` cd autoware From 25c4502e1fe8a1c85c713bd0b80889b04e1dd237 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?M=2E=20Fatih=20C=C4=B1r=C4=B1t?= Date: Wed, 24 Apr 2024 21:03:20 +0300 Subject: [PATCH 03/18] make the release independent from version MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: M. Fatih Cırıt --- docs/GettingStarted/QuickStartDemo/index.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/GettingStarted/QuickStartDemo/index.md b/docs/GettingStarted/QuickStartDemo/index.md index f65f042d2..e1abbd166 100644 --- a/docs/GettingStarted/QuickStartDemo/index.md +++ b/docs/GettingStarted/QuickStartDemo/index.md @@ -144,8 +144,7 @@ To run the simulator, please follow the steps below. 3. Download and Run AWSIM Demo binary. - 1. Download `AWSIM_Labs_v1.0.0-beta.zip`. - [Download AWSIM Demo for ubuntu](){.md-button .md-button--primary} + 1. Download the latest release from the [AWSIM Labs GitHub Release Page](https://github.com/autowarefoundation/AWSIM/releases){.md-button .md-button--primary} 2. Unzip the downloaded file. From 3fae6e175e10278a931650f486402edc32025021 Mon Sep 17 00:00:00 2001 From: "pre-commit-ci-lite[bot]" <117423508+pre-commit-ci-lite[bot]@users.noreply.github.com> Date: Wed, 24 Apr 2024 18:05:50 +0000 Subject: [PATCH 04/18] [pre-commit.ci lite] apply automatic fixes --- docs/GettingStarted/QuickStartDemo/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/GettingStarted/QuickStartDemo/index.md b/docs/GettingStarted/QuickStartDemo/index.md index e1abbd166..62573b494 100644 --- a/docs/GettingStarted/QuickStartDemo/index.md +++ b/docs/GettingStarted/QuickStartDemo/index.md @@ -107,7 +107,7 @@ To run the simulator, please follow the steps below. 2. Install the recommended version of the driver. ``` sudo ubuntu-drivers autoinstall - + # or install a specific version (following was tested) sudo apt install nvidia-driver-550 ``` From e921a2049e1d6d62118a7a10fb65abd7227e3268 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?M=2E=20Fatih=20C=C4=B1r=C4=B1t?= Date: Wed, 24 Apr 2024 21:12:03 +0300 Subject: [PATCH 05/18] remove the image from top, fix version MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: M. Fatih Cırıt --- docs/GettingStarted/QuickStartDemo/index.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/docs/GettingStarted/QuickStartDemo/index.md b/docs/GettingStarted/QuickStartDemo/index.md index 62573b494..aab1e501d 100644 --- a/docs/GettingStarted/QuickStartDemo/index.md +++ b/docs/GettingStarted/QuickStartDemo/index.md @@ -3,8 +3,6 @@ Below you can find instructions on how to setup the self-driving demo of AWSIM simulation controlled by Autoware. The instruction assumes using the Ubuntu OS. -![](Image_top.png) - ### Demo configuration The simulation provided in the AWSIM demo is configured as follows: @@ -26,7 +24,7 @@ Please make sure that your machine meets the following requirements in order to | OS | Ubuntu 22.04 | | CPU | 6 cores and 12 thread or higher | | GPU | RTX 2080Ti or higher | -| Nvidia Driver (Ubuntu 22) | >=515.43.04 | +| Nvidia Driver (Ubuntu 22) | >=545 | ### DDS configuration From 920d2c79493cbf59da78e72a41df71e179eec670 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?M=2E=20Fatih=20C=C4=B1r=C4=B1t?= Date: Wed, 24 Apr 2024 21:17:41 +0300 Subject: [PATCH 06/18] make it a button MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: M. Fatih Cırıt --- docs/GettingStarted/QuickStartDemo/index.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/GettingStarted/QuickStartDemo/index.md b/docs/GettingStarted/QuickStartDemo/index.md index aab1e501d..d8391d0fe 100644 --- a/docs/GettingStarted/QuickStartDemo/index.md +++ b/docs/GettingStarted/QuickStartDemo/index.md @@ -142,7 +142,8 @@ To run the simulator, please follow the steps below. 3. Download and Run AWSIM Demo binary. - 1. Download the latest release from the [AWSIM Labs GitHub Release Page](https://github.com/autowarefoundation/AWSIM/releases){.md-button .md-button--primary} + 1. Download the latest release from the AWSIM Labs GitHub Release Page. + [AWSIM Labs GitHub Release Page](https://github.com/autowarefoundation/AWSIM/releases){.md-button .md-button--primary} 2. Unzip the downloaded file. From f36690efd5d9e2d16e9eb590c5097ebe52b8028e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?M=2E=20Fatih=20C=C4=B1r=C4=B1t?= Date: Wed, 24 Apr 2024 21:21:58 +0300 Subject: [PATCH 07/18] fix warning MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: M. Fatih Cırıt --- docs/GettingStarted/QuickStartDemo/index.md | 22 +++++++++------------ 1 file changed, 9 insertions(+), 13 deletions(-) diff --git a/docs/GettingStarted/QuickStartDemo/index.md b/docs/GettingStarted/QuickStartDemo/index.md index d8391d0fe..1fe723546 100644 --- a/docs/GettingStarted/QuickStartDemo/index.md +++ b/docs/GettingStarted/QuickStartDemo/index.md @@ -159,16 +159,14 @@ To run the simulator, please follow the steps below. chmod +x /awsim_labs.x86_64 ``` - 4. Launch `awsim_labs.x86_64`. - ``` - .//awsim_labs.x86_64 - ``` - - !!! warning + 4. Launch `awsim_labs.x86_64`. + ``` + .//awsim_labs.x86_64 + ``` - It may take some time for the application to start the so please wait until image similar to the one presented below is visible in your application window. + It may take some time for the application to start the so please wait until image similar to the one presented below is visible in your application window. - ![](Image_0.png) + ![](Image_0.png) ### Launching Autoware @@ -207,13 +205,11 @@ rosdep install -y --from-paths src --ignore-src --rosdistro $ROS_DISTRO colcon build --symlink-install --cmake-args -DCMAKE_BUILD_TYPE=RelWithDebInfo -DCMAKE_EXPORT_COMPILE_COMMANDS=1 ``` 8. Launch Autoware. - - !!! warning - - `` must be changed arbitrarily. When specifying the path the `~` operator cannot be used - please specify absolute full path. ``` source install/setup.bash -ros2 launch autoware_launch e2e_simulator.launch.xml vehicle_model:=sample_vehicle sensor_model:=awsim_labs_sensor_kit map_path:= +ros2 launch autoware_launch e2e_simulator.launch.xml vehicle_model:=sample_vehicle sensor_model:=awsim_labs_sensor_kit map_path:= + +# Use the absolute path for the map folder, don't use the ~ operator. # Example: ros2 launch autoware_launch e2e_simulator.launch.xml vehicle_model:=sample_vehicle sensor_model:=awsim_labs_sensor_kit map_path:=/home/your_username/autoware_map/nishishinjuku_autoware_map From 74a68f1d04e6838f8fda64e79eb1e0f125739bbd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?M=2E=20Fatih=20C=C4=B1r=C4=B1t?= Date: Wed, 24 Apr 2024 21:23:36 +0300 Subject: [PATCH 08/18] fix whitespace MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: M. Fatih Cırıt --- docs/GettingStarted/QuickStartDemo/index.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/GettingStarted/QuickStartDemo/index.md b/docs/GettingStarted/QuickStartDemo/index.md index 1fe723546..40fbd88f1 100644 --- a/docs/GettingStarted/QuickStartDemo/index.md +++ b/docs/GettingStarted/QuickStartDemo/index.md @@ -159,14 +159,14 @@ To run the simulator, please follow the steps below. chmod +x /awsim_labs.x86_64 ``` - 4. Launch `awsim_labs.x86_64`. - ``` - .//awsim_labs.x86_64 - ``` + 4. Launch `awsim_labs.x86_64`. + ``` + .//awsim_labs.x86_64 + ``` - It may take some time for the application to start the so please wait until image similar to the one presented below is visible in your application window. + It may take some time for the application to start the so please wait until image similar to the one presented below is visible in your application window. - ![](Image_0.png) + ![](Image_0.png) ### Launching Autoware From 289d05e4e5200e3cfda539a120cb2913727beded Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?M=2E=20Fatih=20C=C4=B1r=C4=B1t?= Date: Wed, 24 Apr 2024 21:57:03 +0300 Subject: [PATCH 09/18] fix sticky MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: M. Fatih Cırıt --- mkdocs.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/mkdocs.yml b/mkdocs.yml index 44489fab7..fbc8f1a17 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -8,12 +8,12 @@ theme: name: material features: - navigation.expand - - navigation.indexes - navigation.instant - navigation.sections - navigation.tabs.sticky - navigation.top - navigation.footer + - navigation.path - content.tabs.link icon: logo: fontawesome/solid/car From ebe7dbc482c46cfcacb83c9cd6e4dbb8db4d7248 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?M=2E=20Fatih=20C=C4=B1r=C4=B1t?= Date: Wed, 24 Apr 2024 22:27:41 +0300 Subject: [PATCH 10/18] fix indent MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: M. Fatih Cırıt --- docs/GettingStarted/QuickStartDemo/index.md | 6 ++++-- mkdocs.yml | 2 +- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/docs/GettingStarted/QuickStartDemo/index.md b/docs/GettingStarted/QuickStartDemo/index.md index 40fbd88f1..6b5fa554f 100644 --- a/docs/GettingStarted/QuickStartDemo/index.md +++ b/docs/GettingStarted/QuickStartDemo/index.md @@ -97,6 +97,7 @@ Replace `your_username` with your actual username. To run the simulator, please follow the steps below. 1. Install Nvidia GPU driver (Skip if already installed). + 1. Add Nvidia driver to apt repository ``` sudo add-apt-repository ppa:graphics-drivers/ppa @@ -131,6 +132,7 @@ To run the simulator, please follow the steps below. ``` 2. Install Vulkan Graphics Library (Skip if already installed). + 1. Update the environment. ``` sudo apt update @@ -143,6 +145,7 @@ To run the simulator, please follow the steps below. 3. Download and Run AWSIM Demo binary. 1. Download the latest release from the AWSIM Labs GitHub Release Page. + [AWSIM Labs GitHub Release Page](https://github.com/autowarefoundation/AWSIM/releases){.md-button .md-button--primary} 2. Unzip the downloaded file. @@ -173,7 +176,6 @@ To run the simulator, please follow the steps below. In order to configure and run the Autoware software with the AWSIM demo, please: 1. Download `map files (pcd, osm)` and unzip them. - [Download Map files (pcd, osm)](https://drive.google.com/drive/folders/15D5s2m3A7_wtCPio8ewRy0wL_xQtmqss){.md-button .md-button--primary} 2. Clone [Autoware](https://github.com/autowarefoundation/autoware) and move to the directory. @@ -216,7 +218,7 @@ ros2 launch autoware_launch e2e_simulator.launch.xml vehicle_model:=sample_vehic ``` ![](Image_2.png) -## Let's run the self-Driving simulation +## Let's run the self driving simulation 1. Launch AWSIM and Autoware according to the steps described earlier in this document. ![](Image_top.png) diff --git a/mkdocs.yml b/mkdocs.yml index fbc8f1a17..60f974401 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -71,7 +71,7 @@ markdown_extensions: - md_in_html - mdx_math - mdx_truly_sane_lists: - nested_indent: 2 + nested_indent: 4 - plantuml_markdown: server: http://www.plantuml.com/plantuml format: svg From 38627b45694e50901813d94e3e646fe3b31f32dd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?M=2E=20Fatih=20C=C4=B1r=C4=B1t?= Date: Wed, 24 Apr 2024 22:30:13 +0300 Subject: [PATCH 11/18] releases MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: M. Fatih Cırıt --- docs/GettingStarted/QuickStartDemo/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/GettingStarted/QuickStartDemo/index.md b/docs/GettingStarted/QuickStartDemo/index.md index 6b5fa554f..8e8f70830 100644 --- a/docs/GettingStarted/QuickStartDemo/index.md +++ b/docs/GettingStarted/QuickStartDemo/index.md @@ -144,9 +144,9 @@ To run the simulator, please follow the steps below. 3. Download and Run AWSIM Demo binary. - 1. Download the latest release from the AWSIM Labs GitHub Release Page. + 1. Download the latest release from: - [AWSIM Labs GitHub Release Page](https://github.com/autowarefoundation/AWSIM/releases){.md-button .md-button--primary} + [AWSIM Labs GitHub Releases Page](https://github.com/autowarefoundation/AWSIM/releases){.md-button .md-button--primary} 2. Unzip the downloaded file. From 071c92107382fbcba90145e18bce75cf03161fd9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?M=2E=20Fatih=20C=C4=B1r=C4=B1t?= Date: Wed, 24 Apr 2024 22:38:12 +0300 Subject: [PATCH 12/18] fix unity setup page MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: M. Fatih Cırıt --- .../GettingStarted/SetupUnityProject/index.md | 31 ++++--------------- 1 file changed, 6 insertions(+), 25 deletions(-) diff --git a/docs/GettingStarted/SetupUnityProject/index.md b/docs/GettingStarted/SetupUnityProject/index.md index f3df8c032..10711eddf 100644 --- a/docs/GettingStarted/SetupUnityProject/index.md +++ b/docs/GettingStarted/SetupUnityProject/index.md @@ -16,26 +16,7 @@ This page is a tutorial for setting up a AWSIM Unity project. 2. Prepare a desktop PC with Ubuntu 22.04 installed. 2. Install [Nvidia drivers and Vulkan Graphics API](../QuickStartDemo/#running-the-awsim-simulation-demo). 3. Install [git](https://git-scm.com/). - 4. Set the ROS 2 middleware and the localhost only mode in `~/.profile` (or, in `~/.bash_profile` or `~/bash_login` if either of those exists) file: - ``` bash - export ROS_LOCALHOST_ONLY=1 - export RMW_IMPLEMENTATION=rmw_cyclonedds_cpp - ``` - - !!! warning - A system restart is required for these changes to work. - - 4. Set the system optimizations by adding this code to the very bottom of your `~/.bashrc` file: - ``` bash - if [ ! -e /tmp/cycloneDDS_configured ]; then - sudo sysctl -w net.core.rmem_max=2147483647 - sudo ip link set lo multicast on - touch /tmp/cycloneDDS_configured - fi - ``` - - !!! info - As a result, each time you run the terminal (`bash` prompt), your OS will be configured for the best ROS 2 performance. Make sure you open your terminal at least one before running any instance of AWSIM (or Editor running the AWSIM). + 4. Follow [the DDS configuration guide](../QuickStartDemo/index.md#dds-configuration). === "Windows" 1. Make sure your machine meets the [required hardware specifications](../QuickStartDemo/#pc-specs). @@ -66,13 +47,13 @@ AWSIM comes with a *standalone* flavor of [`Ros2ForUnity`](../../Components/ROS2 !!! info - AWSIM's Unity version is currently **2021.1.7f1** + AWSIM's Unity version is currently **2022.3.21f1** Follow the steps below to install Unity on your machine: 1. Install UnityHub to manage Unity projects. Please go to [Unity download page](https://unity3d.com/get-unity/download) and download latest `UnityHub.AppImage`. ![](image_1.png) -2. Install Unity 2021.1.7f1 via UnityHub. +2. Install Unity 2022.3.21f1 via UnityHub. - Open new terminal, navigate to directory where `UnityHub.AppImage` is download and execute the following command: ``` ./UnityHub.AppImage @@ -86,7 +67,7 @@ Follow the steps below to install Unity on your machine: === "Ubuntu 22" - *NOTE: If the installation process has not started after clicking the green button (image above), please copy the hyperlink (by rightclicking the button and selecting `Copy link address`) and add it as a argument for Unity Hub app. An example command: ``` - ./UnityHub.AppImage unityhub://2021.1.7f1/d91830b65d9b + ./UnityHub.AppImage unityhub://2022.3.21f1/d91830b65d9b ``` - After successful installation the version will be available under the `Installs` tab in Unity Hub. @@ -133,7 +114,7 @@ To open the Unity AWSIM project in Unity Editor: 2. If your Unity Editor is in default location, run the project using the editor command. ``` - ~/Unity/Hub/Editor/2021.1.7f1/Editor/Unity -projectPath . + ~/Unity/Hub/Editor/2022.3.21f1/Editor/Unity -projectPath . ``` !!! info @@ -156,7 +137,7 @@ To properly run and use AWSIM project in Unity it is required to download map pa [Download Map Package](https://drive.google.com/drive/folders/1Q6PolpCIwiVRdPNMjSBAQ5t2TcCoY-KZ){.md-button .md-button--primary} -2. In Unity Editor, from the menu bar at the top, select `Assets -> Import Package -> Custom Package...` and navigate the `Nishishinjuku_urp.unitypackage` file. +2. In Unity Editor, from the menu bar at the top, select `Assets -> Import Package -> Custom Package...` and navigate the `Nishishinjuku_URP.unitypackage` file. ![](image_10.png) ![](image_11.png) 3. `Nishishinjuku` package has been successfully imported under `Assets/AWSIM/Externals/`directory. From ab962775f107479616c3d91401737cde9410adf6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?M=2E=20Fatih=20C=C4=B1r=C4=B1t?= Date: Wed, 24 Apr 2024 22:53:19 +0300 Subject: [PATCH 13/18] update feature comparison MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: M. Fatih Cırıt --- README.md | 13 +++++++++++++ docs/index.md | 17 ++++++++++------- 2 files changed, 23 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 4b7a442c9..7f8794ce8 100644 --- a/README.md +++ b/README.md @@ -18,6 +18,19 @@ This is a fork of [TIER IV's AWSIM](https://github.com/tier4/AWSIM). - Multiple scene and vehicle setup - Interactable simulation and UI +### Comparison to the main AWSIM + +| Features | **AWSIM** 1.2.1 | **AWSIM Labs** 1.0.0-beta | +|---------------------------------------|------------------|---------------------------| +| Rendering Pipeline | HDRP | URP | +| Unity Version | Unity 2021.1.7f1 | Unity LTS 2022.3.21f1 | +| Resource usage | Heavy | Light | +| Can reset vehicle position on runtime | ❌ | ✅ | +| Multiple scene and vehicle setup | ❌ | ✅ | +| CI for build | ❌ | ✅ | +| CI for documentation generation | ❌ | ✅ | +| Multi-lidars are enabled by default | ❌ | ✅ | + ## Tutorial First, try the tutorial! diff --git a/docs/index.md b/docs/index.md index 7978b4504..11b75f7b9 100644 --- a/docs/index.md +++ b/docs/index.md @@ -20,13 +20,16 @@ This is a fork of [TIER IV's AWSIM](https://github.com/tier4/AWSIM). ### Feature differences from the main AWSIM -| AWSIM | AWSIM Labs | -|--------------------------------------------|----------------------------------| -| Using HDRP | Using URP | -| Using Unity 2021.1.7f1 | Using Unity LTS 2022.3.21f1 | -| Limited interaction with simulation and UI | Interactable simulation and UI | -| Uses more resources | Uses less resources | -| - | Multiple scene and vehicle setup | +| Features | **AWSIM** 1.2.1 | **AWSIM Labs** 1.0.0-beta | +|---------------------------------------|------------------|---------------------------| +| Rendering Pipeline | HDRP | URP | +| Unity Version | Unity 2021.1.7f1 | Unity LTS 2022.3.21f1 | +| Resource usage | Heavy | Light | +| Can reset vehicle position on runtime | ❌ | ✅ | +| Multiple scene and vehicle setup | ❌ | ✅ | +| CI for build | ❌ | ✅ | +| CI for documentation generation | ❌ | ✅ | +| Multi-lidars are enabled by default | ❌ | ✅ | ## Try the simulation demo yourself! We don't have a release yet. Please build it from the source. From 4025e70e9f028fc1e4a7ce200b1756f021ad394c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?M=2E=20Fatih=20C=C4=B1r=C4=B1t?= Date: Wed, 24 Apr 2024 22:56:07 +0300 Subject: [PATCH 14/18] fix order MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: M. Fatih Cırıt --- README.md | 20 ++++++++++---------- docs/index.md | 20 ++++++++++---------- 2 files changed, 20 insertions(+), 20 deletions(-) diff --git a/README.md b/README.md index 7f8794ce8..05513bc64 100644 --- a/README.md +++ b/README.md @@ -20,16 +20,16 @@ This is a fork of [TIER IV's AWSIM](https://github.com/tier4/AWSIM). ### Comparison to the main AWSIM -| Features | **AWSIM** 1.2.1 | **AWSIM Labs** 1.0.0-beta | -|---------------------------------------|------------------|---------------------------| -| Rendering Pipeline | HDRP | URP | -| Unity Version | Unity 2021.1.7f1 | Unity LTS 2022.3.21f1 | -| Resource usage | Heavy | Light | -| Can reset vehicle position on runtime | ❌ | ✅ | -| Multiple scene and vehicle setup | ❌ | ✅ | -| CI for build | ❌ | ✅ | -| CI for documentation generation | ❌ | ✅ | -| Multi-lidars are enabled by default | ❌ | ✅ | +| Features | **AWSIM** 1.2.1 | **AWSIM Labs** 1.0.0-beta | +|-------------------------------------------|------------------|---------------------------| +| Rendering Pipeline | HDRP | URP | +| Unity Version | Unity 2021.1.7f1 | Unity LTS 2022.3.21f1 | +| Resource usage | Heavy | Light | +| Can reset vehicle position on runtime | ❌ | ✅ | +| Multiple scene and vehicle setup | ❌ | ✅ | +| Multi-lidars are enabled by default | ❌ | ✅ | +| CI for build | ❌ | ✅ | +| CI for documentation generation within PR | ❌ | ✅ | ## Tutorial diff --git a/docs/index.md b/docs/index.md index 11b75f7b9..869eb2cdd 100644 --- a/docs/index.md +++ b/docs/index.md @@ -20,16 +20,16 @@ This is a fork of [TIER IV's AWSIM](https://github.com/tier4/AWSIM). ### Feature differences from the main AWSIM -| Features | **AWSIM** 1.2.1 | **AWSIM Labs** 1.0.0-beta | -|---------------------------------------|------------------|---------------------------| -| Rendering Pipeline | HDRP | URP | -| Unity Version | Unity 2021.1.7f1 | Unity LTS 2022.3.21f1 | -| Resource usage | Heavy | Light | -| Can reset vehicle position on runtime | ❌ | ✅ | -| Multiple scene and vehicle setup | ❌ | ✅ | -| CI for build | ❌ | ✅ | -| CI for documentation generation | ❌ | ✅ | -| Multi-lidars are enabled by default | ❌ | ✅ | +| Features | **AWSIM** 1.2.1 | **AWSIM Labs** 1.0.0-beta | +|-------------------------------------------|------------------|---------------------------| +| Rendering Pipeline | HDRP | URP | +| Unity Version | Unity 2021.1.7f1 | Unity LTS 2022.3.21f1 | +| Resource usage | Heavy | Light | +| Can reset vehicle position on runtime | ❌ | ✅ | +| Multiple scene and vehicle setup | ❌ | ✅ | +| Multi-lidars are enabled by default | ❌ | ✅ | +| CI for build | ❌ | ✅ | +| CI for documentation generation within PR | ❌ | ✅ | ## Try the simulation demo yourself! We don't have a release yet. Please build it from the source. From ef55bb8abc69e8784aa9302f6afedfd40f73c125 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?M=2E=20Fatih=20C=C4=B1r=C4=B1t?= Date: Wed, 24 Apr 2024 22:57:50 +0300 Subject: [PATCH 15/18] fix tables MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: M. Fatih Cırıt --- README.md | 20 ++++++++++---------- docs/index.md | 20 ++++++++++---------- 2 files changed, 20 insertions(+), 20 deletions(-) diff --git a/README.md b/README.md index 05513bc64..d4d5e33a1 100644 --- a/README.md +++ b/README.md @@ -20,16 +20,16 @@ This is a fork of [TIER IV's AWSIM](https://github.com/tier4/AWSIM). ### Comparison to the main AWSIM -| Features | **AWSIM** 1.2.1 | **AWSIM Labs** 1.0.0-beta | -|-------------------------------------------|------------------|---------------------------| -| Rendering Pipeline | HDRP | URP | -| Unity Version | Unity 2021.1.7f1 | Unity LTS 2022.3.21f1 | -| Resource usage | Heavy | Light | -| Can reset vehicle position on runtime | ❌ | ✅ | -| Multiple scene and vehicle setup | ❌ | ✅ | -| Multi-lidars are enabled by default | ❌ | ✅ | -| CI for build | ❌ | ✅ | -| CI for documentation generation within PR | ❌ | ✅ | +| Features | AWSIM 1.2.1 | AWSIM Labs 1.0.0-beta | +|-------------------------------------------|------------------|-----------------------| +| Rendering Pipeline | HDRP | URP | +| Unity Version | Unity 2021.1.7f1 | Unity LTS 2022.3.21f1 | +| Resource usage | Heavy | Light | +| Can reset vehicle position on runtime | ❌ | ✅ | +| Multiple scene and vehicle setup | ❌ | ✅ | +| Multi-lidars are enabled by default | ❌ | ✅ | +| CI for build | ❌ | ✅ | +| CI for documentation generation within PR | ❌ | ✅ | ## Tutorial diff --git a/docs/index.md b/docs/index.md index 869eb2cdd..eb281ca9e 100644 --- a/docs/index.md +++ b/docs/index.md @@ -20,16 +20,16 @@ This is a fork of [TIER IV's AWSIM](https://github.com/tier4/AWSIM). ### Feature differences from the main AWSIM -| Features | **AWSIM** 1.2.1 | **AWSIM Labs** 1.0.0-beta | -|-------------------------------------------|------------------|---------------------------| -| Rendering Pipeline | HDRP | URP | -| Unity Version | Unity 2021.1.7f1 | Unity LTS 2022.3.21f1 | -| Resource usage | Heavy | Light | -| Can reset vehicle position on runtime | ❌ | ✅ | -| Multiple scene and vehicle setup | ❌ | ✅ | -| Multi-lidars are enabled by default | ❌ | ✅ | -| CI for build | ❌ | ✅ | -| CI for documentation generation within PR | ❌ | ✅ | +| Features | AWSIM 1.2.1 | AWSIM Labs 1.0.0-beta | +|-------------------------------------------|------------------|-----------------------| +| Rendering Pipeline | HDRP | URP | +| Unity Version | Unity 2021.1.7f1 | Unity LTS 2022.3.21f1 | +| Resource usage | Heavy | Light | +| Can reset vehicle position on runtime | ❌ | ✅ | +| Multiple scene and vehicle setup | ❌ | ✅ | +| Multi-lidars are enabled by default | ❌ | ✅ | +| CI for build | ❌ | ✅ | +| CI for documentation generation within PR | ❌ | ✅ | ## Try the simulation demo yourself! We don't have a release yet. Please build it from the source. From e96edbfe632a1f4b1e4707542af92695e2362037 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?M=2E=20Fatih=20C=C4=B1r=C4=B1t?= Date: Wed, 24 Apr 2024 22:59:14 +0300 Subject: [PATCH 16/18] fix titles MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: M. Fatih Cırıt --- README.md | 2 +- docs/index.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index d4d5e33a1..579b6d3d6 100644 --- a/README.md +++ b/README.md @@ -18,7 +18,7 @@ This is a fork of [TIER IV's AWSIM](https://github.com/tier4/AWSIM). - Multiple scene and vehicle setup - Interactable simulation and UI -### Comparison to the main AWSIM +### Feature differences from the TIER IV/AWSIM | Features | AWSIM 1.2.1 | AWSIM Labs 1.0.0-beta | |-------------------------------------------|------------------|-----------------------| diff --git a/docs/index.md b/docs/index.md index eb281ca9e..6aa29032e 100644 --- a/docs/index.md +++ b/docs/index.md @@ -18,7 +18,7 @@ This is a fork of [TIER IV's AWSIM](https://github.com/tier4/AWSIM). - Made with [Unity](https://unity.com/) -### Feature differences from the main AWSIM +### Feature differences from the TIER IV/AWSIM | Features | AWSIM 1.2.1 | AWSIM Labs 1.0.0-beta | |-------------------------------------------|------------------|-----------------------| From 46faf47b522c7f1012bd3bb9a8958c601ee3d8dc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?M=2E=20Fatih=20C=C4=B1r=C4=B1t?= Date: Wed, 24 Apr 2024 23:00:44 +0300 Subject: [PATCH 17/18] multiline MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: M. Fatih Cırıt --- docs/GettingStarted/QuickStartDemo/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/GettingStarted/QuickStartDemo/index.md b/docs/GettingStarted/QuickStartDemo/index.md index 8e8f70830..abc3408de 100644 --- a/docs/GettingStarted/QuickStartDemo/index.md +++ b/docs/GettingStarted/QuickStartDemo/index.md @@ -11,7 +11,7 @@ The simulation provided in the AWSIM demo is configured as follows: |:--------------------|:-------------------------------------------| | Vehicle | Lexus RX 450h | | Environment | Japan Tokyo Nishishinjuku | -| Sensors | GNSS, IMU, 3 x VLP16, Traffic Light Camera | +| Sensors | GNSS
IMU
3 x VLP16
Traffic Light Camera | | Traffic | Randomized traffic | | ROS2 | humble | From b612288e0a1c5912e0a9d8f5fb4f9ac09eaccf98 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?M=2E=20Fatih=20C=C4=B1r=C4=B1t?= Date: Wed, 24 Apr 2024 23:02:05 +0300 Subject: [PATCH 18/18] specs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: M. Fatih Cırıt --- docs/GettingStarted/QuickStartDemo/index.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/GettingStarted/QuickStartDemo/index.md b/docs/GettingStarted/QuickStartDemo/index.md index abc3408de..64fdb65d3 100644 --- a/docs/GettingStarted/QuickStartDemo/index.md +++ b/docs/GettingStarted/QuickStartDemo/index.md @@ -19,12 +19,12 @@ The simulation provided in the AWSIM demo is configured as follows: Please make sure that your machine meets the following requirements in order to run the simulation correctly: -| Required PC Specs | | -|:--------------------------|:--------------------------------| -| OS | Ubuntu 22.04 | -| CPU | 6 cores and 12 thread or higher | -| GPU | RTX 2080Ti or higher | -| Nvidia Driver (Ubuntu 22) | >=545 | +| Required PC Specs | | +|:--------------------------|:-------------------| +| OS | Ubuntu 22.04 | +| CPU | 6c12t or higher | +| GPU | RTX 2080 or higher | +| Nvidia Driver (Ubuntu 22) | >=545 | ### DDS configuration