Skip to content

Commit e3ed79a

Browse files
committed
Update links
Signed-off-by: Alberto Tudela <ajtudela@gmail.com>
1 parent 9b3ca78 commit e3ed79a

2 files changed

Lines changed: 25 additions & 11 deletions

File tree

configuration/packages/configuring-following-server.rst

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,13 +5,21 @@ Following Server
55

66
Source code on Github_.
77

8-
.. _Github: https://github.com/open-navigation/opennav_following
8+
.. _Github: https://github.com/ros-navigation/navigation2/nav2_following/opennav_following
99

1010
The Following Server in ``opennav_following`` implements a server for following dynamic objects from a detection topic or specific reference frame.
1111
This server allows the robot to follow and maintain a determined distance from a detected object or specific frame,
1212
using topic-based detection techniques or coordinate frame tracking.
1313
The server is designed to be called by a BT application or autonomy application to follow moving objects.
1414

15+
.. raw:: html
16+
17+
<h1 align="center">
18+
<div style="position: relative; padding-bottom: 0%; overflow: hidden; max-width: 100%; height: auto;">
19+
<iframe width="700" height="450" src="https://www.youtube.com/embed/g-g58J1g9Ww?autoplay=1" frameborder="1" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
20+
</div>
21+
</h1>
22+
1523
Parameters
1624
**********
1725

tutorials/docs/navigation2_dynamic_point_following.rst

Lines changed: 16 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -3,14 +3,19 @@
33
Dynamic Object Following
44
************************
55

6-
Using Following server
6+
Nav2 provides two different approaches for dynamic object following tasks:
7+
8+
1. **Following Server**: A specialized server that handles dynamic object following with built-in recovery mechanisms and smooth control.
9+
2. **ComputePathToPose and FollowPath**: A behavior tree-based approach using traditional navigation components for custom following behaviors.
10+
11+
Using Following Server
712
======================
813

914
- `Following Server Overview`_
1015
- `Following Server Tutorial Steps`_
1116

1217
Following Server Overview
13-
=========================
18+
-------------------------
1419

1520
The Following server is a specialized server in Nav2 designed to handle dynamic object following tasks. It dynamically follows an object while maintaining a defined distance specified by the ``desired_distance`` parameter. The server abstracts away the complexities of tracking and following moving objects, allowing users to focus on higher-level navigation goals.
1621

@@ -25,12 +30,12 @@ The Following server uses the same controller as the Docking server, leveraging
2530

2631

2732
Following Server Tutorial Steps
28-
===============================
33+
-------------------------------
2934

3035
To use the Following server, you need to configure it in your behavior tree. This involves setting up the necessary action nodes and parameters to ensure smooth following behavior. The ``FollowObject`` action node provides two different approaches for object tracking.
3136

3237
Method 1: Using pose_topic
33-
--------------------------
38+
``````````````````````````
3439

3540
The simplest behavior tree for following a dynamic object using a pose topic is as follows:
3641

@@ -48,7 +53,7 @@ In this configuration:
4853
- ``max_duration``: Duration to run the action (0.0 means indefinitely)
4954

5055
Method 2: Using tracked_frame
51-
-----------------------------
56+
`````````````````````````````
5257

5358
Alternatively, you can follow a specific TF frame directly:
5459

@@ -89,6 +94,7 @@ The following video demonstrates the Following Server functionality in a real-wo
8994
</div>
9095
</h1>
9196

97+
----
9298

9399
Using ComputePathToPose and FollowPath
94100
======================================
@@ -105,7 +111,7 @@ Using ComputePathToPose and FollowPath
105111
</h1>
106112

107113
ComputePathToPose Overview
108-
==========================
114+
--------------------------
109115

110116
This tutorial shows how to use Nav2 for a different task other than going from point A to point B. In this case, we will use Nav2 to follow a moving object at a distance indefinitely.
111117

@@ -136,10 +142,10 @@ send the initial pose to the ``NavigateToPose`` action, and update it on a topic
136142
:width: 48%
137143

138144
ComputePathToPose Tutorial Steps
139-
================================
145+
--------------------------------
140146

141147
0- Create the Behavior Tree
142-
---------------------------
148+
````````````````````````````
143149

144150
Let's start from this simple behavior tree. This behavior tree replans a new path at 1 hz and passes that path to the controller to follow:
145151

@@ -219,7 +225,7 @@ Now, you may save this behavior tree and use it in our navigation task.
219225
For reference, this exact behavior tree is `made available <https://github.com/ros-navigation/navigation2/blob/main/nav2_bt_navigator/behavior_trees/follow_point.xml>`_ to you batteries included in the ``nav2_bt_navigator`` package.
220226

221227
1- Setup Rviz clicked point
222-
---------------------------
228+
```````````````````````````
223229

224230
We are going to use RViz instead of a full application so you can test at home without finding a detector to get started. We will use the "clicked point" button on the toolbar to substitute object detections to provide goal updates to Nav2. This button allows you to
225231
publish coordinates in the topic ``/clicked_point``. This point needs to be sent to the behavior tree, using the program ``clicked_point_to_pose``, from `this repo <https://github.com/fmrico/nav2_test_utils>`_. Clone
@@ -230,7 +236,7 @@ this repo in your workspace, build, and type in a terminal.
230236
Optionally, you can remap this topic in your rviz configuration file to ``goal_updates``.
231237

232238
2- Run Dynamic Object Following in Nav2 Simulation
233-
--------------------------------------------------
239+
``````````````````````````````````````````````````
234240

235241
Start Nav2 in one terminal:
236242

0 commit comments

Comments
 (0)