Skip to content

Commit

Permalink
added files
Browse files Browse the repository at this point in the history
Signed-off-by: kminoda <koji.m.minoda@gmail.com>
  • Loading branch information
kminoda committed May 30, 2022
1 parent eb218e0 commit 96da0ae
Show file tree
Hide file tree
Showing 3 changed files with 36 additions and 1 deletion.
1 change: 1 addition & 0 deletions docs/how-to-guides/.pages
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
nav:
- index.md
- running-autoware-without-cuda.md
- advanced-usage-of-colcon.md
- how-to-integrate-autoware-with-your-vehicle.md
2 changes: 1 addition & 1 deletion docs/how-to-guides/index.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# How-to guides

- [Running Autoware without CUDA](running-autoware-without-cuda.md)
- [Advanced usage of colcon](advanced-usage-of-colcon.md)
- [Integrate Autoware with your vehicle](how-to-integrate-autoware-with-your-vehicle.md)

Expand Down
34 changes: 34 additions & 0 deletions docs/how-to-guides/running-autoware-without-cuda.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
# Running Autoware without CUDA

Two following algorithms in Autoware Universe depend on a CUDA environment.

- 2D/3D object detection
- traffic light detection

However, it is still possible to run Autoware in the environment without CUDA.
The following subsections briefly explain how to run these algorithms in such an environment.

!!! warning

It is highly recommended to prepare a CUDA environment to achieve better performance.

## Running 2D/3D object detection without CUDA

As for the object detection system in Autoware, the following three packages require the CUDA environment:

- `lidar_centerpoint`
- `lidar_apollo_instance_segmentation`
- `tensorrt_yolo`

Instead of these modules, you can use the `euclidean_cluster` module, which is a 3D object detection algorithm that does not require a CUDA environment (refer to [the readme](https://github.com/autowarefoundation/autoware.universe/tree/main/perception/euclidean_cluster) for detail).

## Running traffic light detection without CUDA

As for the traffic light recognition system in Autoware, there are two package that require the CUDA environment:

- `traffic_light_ssd_fine_detector`
- `traffic_light_classifier`

To run traffic light detection without CUDA, set [`enable_fine_detection` in this file](https://github.com/autowarefoundation/autoware.universe/blob/9445f3a7acd645d12a64507c3d3bfa57e74a3634/launch/tier4_perception_launch/launch/traffic_light_recognition/traffic_light.launch.xml#L3) to `false` so that `traffic_light_ssd_fine_detector` be disabled and the traffic light detection solely be executed by `map_based_traffic_light_detector`.

To run traffic light classification without CUDA, set [`use_gpu` in this file](https://github.com/autowarefoundation/autoware.universe/blob/9445f3a7acd645d12a64507c3d3bfa57e74a3634/perception/traffic_light_classifier/launch/traffic_light_classifier.launch.xml#L7) to `false` so that `traffic_light_classifier` use classification algorithm that does not use CUDA environment or GPU.

0 comments on commit 96da0ae

Please sign in to comment.