@@ -6,7 +6,13 @@ This has been developed as a new localization stack for [Autoware](https://githu
6
6
7
7
![ thumbnail] ( docs/yabloc_thumbnail.jpg )
8
8
9
- ## Submodule
9
+ ## Installation
10
+
11
+ ### Prerequisites
12
+
13
+ ** Supporting ` Ubuntu 22.04 ` + ` ROS2 humble ` now.**
14
+
15
+ ### Submodules
10
16
11
17
* [ external/autoware_auto_msgs] ( https://github.com/tier4/autoware_auto_msgs )
12
18
* [ external/autoware_msgs] ( https://github.com/autowarefoundation/autoware_msgs.git )
@@ -16,12 +22,7 @@ This has been developed as a new localization stack for [Autoware](https://githu
16
22
** NOTE:** Currently, this software is assumed to be built in a separate workspace in order not to contaminate the autoware workspace.
17
23
Someday this will be located in the workspace where Autoware blongs. These submodules will be removed at the time.
18
24
19
- ## How to build
20
-
21
- ** Supporting ` Ubuntu 22.04 ` + ` ROS2 humble ` now.
22
- Some branches might support ` ROS2 galactic ` .**
23
-
24
- ** NOTE:** Currently, this software is assumed to be built in a separate workspace in order not to contaminate the Autoware workspace.
25
+ ### How to build
25
26
26
27
``` shell
27
28
mkdir yabloc_ws/src -p
@@ -47,7 +48,7 @@ colcon build --symlink-install --cmake-args -DCMAKE_BUILD_TYPE=Release -DCMAKE_E
47
48
48
49
## Quick Start Demo
49
50
50
- ROSBAG made by AWSIM: [ Google drive link] ( https://drive.google.com/drive/folders/1XVWfkDoz-0fncYC-_I6cmv1gkB6EfJ2Y?usp=share_link )
51
+ rosbag made by AWSIM: [ Google drive link] ( https://drive.google.com/drive/folders/1XVWfkDoz-0fncYC-_I6cmv1gkB6EfJ2Y?usp=share_link )
51
52
52
53
![ how_to_launch_with_rosbag] ( docs/how_to_launch_quick_start_demo.drawio.svg )
53
54
@@ -61,11 +62,9 @@ ros2 bag play awsim_yabloc_rosbag_sample
61
62
62
63
** NOTE:** ` use_sim_time ` is TRUE as default.
63
64
64
- ### Run with standard ROSBAG
65
+ ### Run with rosbag
65
66
66
- Sample data: [ Google drive link] ( https://drive.google.com/drive/folders/1uNxQ2uPFEGbYXUODQMc7GRO5r9c3Fj6o?usp=share_link )
67
-
68
- The link contains * rosbag* and * lanelet2* but * pointcloud* .
67
+ <details ><summary >click to open </summary ><div >
69
68
70
69
![ how_to_launch_with_rosbag] ( docs/how_to_launch_with_rosbag.drawio.svg )
71
70
@@ -80,16 +79,20 @@ ros2 launch autoware_launch logging_simulator.launch.xml \
80
79
planning:=false \
81
80
control:=false \
82
81
rviz:=false \
83
- vehicle_model:=jpntaxi \
84
- sensor_model:=aip_xx1 \
85
- vehicle_id:=5 \
82
+ vehicle_model:=sample_vehicle \
83
+ sensor_model:=sample_sensor_kit \
84
+ vehicle_id:=default \
86
85
map_path:=$HOME /Maps/odaiba
87
86
88
- ros2 bag play sample_odaiba --clock 100
87
+ ros2 bag play your_rosbag --clock 100
89
88
```
90
89
90
+ </div ></details >
91
+
91
92
### Run in real world
92
93
94
+ <details ><summary >click to open </summary ><div >
95
+
93
96
![ how_to_launch_with_rosbag] ( docs/how_to_launch_in_real.drawio.svg )
94
97
95
98
``` shell
@@ -99,7 +102,11 @@ ros2 launch autoware_launch autoware.launch.xml \
99
102
rviz:=false
100
103
```
101
104
102
- ### Run with AWSIM <ins >(UNDER CONSTRACTION)</ins >
105
+ </div ></details >
106
+
107
+ ### Run with [ AWSIM] ( https://github.com/tier4/AWSIM ) <ins >(UNDER CONSTRACTION)</ins >
108
+
109
+ <details ><summary >click to open </summary ><div >
103
110
104
111
** You have to change autoware.universe branch.**
105
112
@@ -109,11 +116,13 @@ ros2 launch pcdless_launch rviz.launch.xml
109
116
ros2 launch autoware_launch e2e_simulator.launch.xml
110
117
```
111
118
112
- ## How to set initialpose
119
+ </div ></details >
120
+
121
+ ## How to set initial pose
113
122
114
123
### 1. When YabLoc works ` standalone:=true ` (default) (without Autoware's pose_initializer)
115
124
116
- 1 . 2D Pose Estimate in Rviz
125
+ 1 . ` 2D Pose Estimate ` in Rviz
117
126
118
127
You can inidcate x, y and yaw manually in rviz.
119
128
@@ -127,11 +136,11 @@ If doppler (`ublox_msgs/msg/navpvt`) is available and the vehicle moves enough f
127
136
128
137
## Architecture
129
138
130
- ![ node_diagram] ( docs/node_diagram.png )
139
+ ![ node_diagram] ( docs/yabloc_architecture.drawio.svg )
131
140
132
- ### Input topics from sesnors
141
+ ### Input topics
133
142
134
- This localizer requires following topics to work.
143
+ from sesnors
135
144
136
145
| topic name | msg type | description |
137
146
| ---- | ---- | -- |
@@ -142,15 +151,16 @@ This localizer requires following topics to work.
142
151
| ` /sensing/gnss/septentrio/poscovgeodetic ` | ` septentrio_gnss_driver_msgs/msg/PosCovGeodetic ` | If you use Septentrio |
143
152
| ` /vehicle/status/velocity_status ` | ` autoware_auto_vehicle_msgs/msg/VelocityReport ` | |
144
153
145
- ### Input topics from autoware
146
-
154
+ from autoware
147
155
| topic name | msg type | description |
148
156
| ---- | ---- | -- |
149
157
| ` /tf_static ` | ` tf2_msgs/msg/TFMessage ` | published from ` sensor_kit ` |
150
158
| ` /map/vector_map ` | ` autoware_auto_mapping_msgs/msg/HADMapBin ` | published from ` /map/lanelet2_map_loader ` |
151
159
152
160
#### about tf_static
153
161
162
+ <details ><summary >click to open</summary ><div >
163
+
154
164
Some nodes requires ` /tf_static ` from ` /base_link ` to the frame_id of ` /sensing/camera/traffic_light/image_raw/compressed ` (e.g. ` /traffic_light_left_camera/camera_optical_link ` ).
155
165
You can verify that the tf_static is correct with the following command.
156
166
@@ -171,7 +181,9 @@ ros2 run tf2_ros static_transform_publisher \
171
181
--yaw -1.570
172
182
```
173
183
174
- ### Output
184
+ </div ></details >
185
+
186
+ ### Output topics
175
187
176
188
| topic name | msg type | description |
177
189
| ---- | ---- | -- |
@@ -184,7 +196,7 @@ ros2 run tf2_ros static_transform_publisher \
184
196
185
197
## Visualization
186
198
187
- ( This project contains original rviz plugins.)
199
+ This project contains original rviz plugins. [ rviz2_overlay_plugins ] ( ./rviz2_plugins/rviz2_overlay_plugins/README.md )
188
200
189
201
![ rviz] ( docs/rviz_description.png )
190
202
0 commit comments