|
5 | 5 | <meta http-equiv="X-UA-Compatible" content="IE=11"/> |
6 | 6 | <meta name="generator" content="Doxygen 1.13.2"/> |
7 | 7 | <meta name="viewport" content="width=device-width, initial-scale=1"/> |
8 | | -<title>EasyNav Costmap Stack: Main Page</title> |
| 8 | +<title>EasyNav Costmap Stack: easynav_octomap_stack</title> |
9 | 9 | <link href="tabs.css" rel="stylesheet" type="text/css"/> |
10 | 10 | <script type="text/javascript" src="jquery.js"></script> |
11 | 11 | <script type="text/javascript" src="dynsections.js"></script> |
|
83 | 83 | </div> |
84 | 84 | </div> |
85 | 85 |
|
86 | | -<div class="header"> |
87 | | - <div class="headertitle"><div class="title">EasyNav Costmap Stack Documentation</div></div> |
| 86 | +<div><div class="header"> |
| 87 | + <div class="headertitle"><div class="title">easynav_octomap_stack </div></div> |
88 | 88 | </div><!--header--> |
89 | 89 | <div class="contents"> |
| 90 | +<div class="textblock"><p><a class="anchor" id="md_README"></a></p> |
| 91 | +<p>This stack is part of the Easy Navigation (EasyNav) project developed by the Intelligent Robotics Lab. It provides a ROS 2 lifecycle node for building and publishing Octomap-based 3D occupancy maps from sensor point cloud data.</p> |
| 92 | +<p>It is composed of the <b>octomap_maps_builder</b> package and the <b>octomap_maps_manager</b> package (currently under construction).</p> |
| 93 | +<p>The <code>OctomapMapsBuilderNode</code> subscribes to sensor point cloud topics, processes and filters the data, and incrementally builds an Octomap representation of the environment. It publishes the resulting maps as ROS messages in both binary and full map formats.</p> |
| 94 | +<h1><a class="anchor" id="autotoc_md1"></a> |
| 95 | +Installation</h1> |
| 96 | +<p>Clone the repository into your ROS 2 workspace: </p><div class="fragment"><div class="line">cd ~/ros2_ws/src</div> |
| 97 | +<div class="line">git clone <repository-url></div> |
| 98 | +<div class="line">cd ..</div> |
| 99 | +<div class="line">rosdep install --from-paths src --ignore-src -r -y</div> |
| 100 | +<div class="line">colcon build --packages-select easynav_octomap_maps_builder</div> |
| 101 | +</div><!-- fragment --><h1><a class="anchor" id="autotoc_md2"></a> |
| 102 | +Usage</h1> |
| 103 | +<p>Source your workspace: </p><div class="fragment"><div class="line">source ~/ros2_ws/install/setup.bash</div> |
| 104 | +</div><!-- fragment --><p> Run the lifecycle node: </p><div class="fragment"><div class="line">ros2 run easynav_octomap_maps_builder octomap_maps_builder_node</div> |
| 105 | +</div><!-- fragment --><h1><a class="anchor" id="autotoc_md3"></a> |
| 106 | +Parameters</h1> |
| 107 | +<table class="markdownTable"> |
| 108 | +<tr class="markdownTableHead"> |
| 109 | +<th class="markdownTableHeadNone">Parameter </th><th class="markdownTableHeadNone">Type </th><th class="markdownTableHeadNone">Default </th><th class="markdownTableHeadNone">Description </th></tr> |
| 110 | +<tr class="markdownTableRowOdd"> |
| 111 | +<td class="markdownTableBodyNone"><code>sensor_topic</code> </td><td class="markdownTableBodyNone">string </td><td class="markdownTableBodyNone"><code>"map"</code> </td><td class="markdownTableBodyNone">Topic name for incoming sensor point clouds. </td></tr> |
| 112 | +<tr class="markdownTableRowEven"> |
| 113 | +<td class="markdownTableBodyNone"><code>downsample_resolution</code> </td><td class="markdownTableBodyNone">double </td><td class="markdownTableBodyNone"><code>1.0</code> </td><td class="markdownTableBodyNone">Downsampling resolution for input point clouds. </td></tr> |
| 114 | +<tr class="markdownTableRowOdd"> |
| 115 | +<td class="markdownTableBodyNone"><code>perception_default_frame</code> </td><td class="markdownTableBodyNone">string </td><td class="markdownTableBodyNone"><code>"map"</code> </td><td class="markdownTableBodyNone">Default target frame for perception fusion. </td></tr> |
| 116 | +<tr class="markdownTableRowEven"> |
| 117 | +<td class="markdownTableBodyNone"><code>sensor_model.max_range</code> </td><td class="markdownTableBodyNone">double </td><td class="markdownTableBodyNone"><code>90.0</code> </td><td class="markdownTableBodyNone">Maximum sensor range for raycasting. </td></tr> |
| 118 | +<tr class="markdownTableRowOdd"> |
| 119 | +<td class="markdownTableBodyNone"><code>resolution</code> </td><td class="markdownTableBodyNone">double </td><td class="markdownTableBodyNone"><code>1.0</code> </td><td class="markdownTableBodyNone">Resolution of the OctoMap octree. </td></tr> |
| 120 | +<tr class="markdownTableRowEven"> |
| 121 | +<td class="markdownTableBodyNone"><code>base_frame_id</code> </td><td class="markdownTableBodyNone">string </td><td class="markdownTableBodyNone"><code>"base_link"</code> </td><td class="markdownTableBodyNone">Robot base frame ID. </td></tr> |
| 122 | +<tr class="markdownTableRowOdd"> |
| 123 | +<td class="markdownTableBodyNone"><code>occupancy_min_z</code> </td><td class="markdownTableBodyNone">double </td><td class="markdownTableBodyNone"><code>0.1</code> </td><td class="markdownTableBodyNone">Minimum z height for occupancy filtering. </td></tr> |
| 124 | +<tr class="markdownTableRowEven"> |
| 125 | +<td class="markdownTableBodyNone"><code>occupancy_max_z</code> </td><td class="markdownTableBodyNone">double </td><td class="markdownTableBodyNone"><code>10.0</code> </td><td class="markdownTableBodyNone">Maximum z height for occupancy filtering. </td></tr> |
| 126 | +<tr class="markdownTableRowOdd"> |
| 127 | +<td class="markdownTableBodyNone"><code>publish_binary_map</code> </td><td class="markdownTableBodyNone">bool </td><td class="markdownTableBodyNone"><code>true</code> </td><td class="markdownTableBodyNone">Enable publishing of binary octomap message. </td></tr> |
| 128 | +<tr class="markdownTableRowEven"> |
| 129 | +<td class="markdownTableBodyNone"><code>publish_full_map</code> </td><td class="markdownTableBodyNone">bool </td><td class="markdownTableBodyNone"><code>true</code> </td><td class="markdownTableBodyNone">Enable publishing of full octomap message. </td></tr> |
| 130 | +<tr class="markdownTableRowOdd"> |
| 131 | +<td class="markdownTableBodyNone"><code>world_frame_id</code> </td><td class="markdownTableBodyNone">string </td><td class="markdownTableBodyNone"><code>"map"</code> </td><td class="markdownTableBodyNone">Global coordinate frame for map integration. </td></tr> |
| 132 | +</table> |
| 133 | +</div></div><!-- PageDoc --> |
90 | 134 | <a href="doxygen_crawl.html"></a> |
91 | 135 | </div><!-- contents --> |
92 | 136 | <!-- start footer part --> |
|
0 commit comments