Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Nav2_tasks readme #141

Merged
merged 5 commits into from
Oct 11, 2018
Merged

Nav2_tasks readme #141

merged 5 commits into from
Oct 11, 2018

Conversation

mjeronimo
Copy link

@mjeronimo mjeronimo commented Oct 5, 2018

Currently, there are many empty README.md files across the various directories. These are placeholders that we plan to populate during October as we work towards a functional stack. Each will contain background information for the particular package and a description of its contents. This particular PR is a first cut at the README file for the nav2_tasks directory. I created the diagram using LibreOffice Draw and exported it to a .svg file and checked in both to a doc subdirectory (is this how we want to do it?).

@mjeronimo mjeronimo added this to the October 2018 milestone Oct 5, 2018
@mjeronimo mjeronimo self-assigned this Oct 5, 2018
@mjeronimo mjeronimo requested review from mkhansenbot, bpwilcox, a user and mhpanah October 5, 2018 21:02

The implementation of TaskClient and TaskServer is simplistic as the intention is to rely upon a ROS2 ActionLib (or equivalent) when it is available.

The current implementation uses four topics, one each for **Command**, **Cancel**, **Result**, and **Status** messages. The Command and Result messages are provided by the user of the classes, while the Result and Status messages are internal to the implementation. The Status message communicates whether a task has succeeded, failed, or has been canceled, while the Result message is used to return the result of the command, if successful. To keep things simple, the task library does not implement a feedback mechanism as the ROS1 ActionLib does.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do you mean "The Command and Cancel messages are provided..."? I think you forgot to mention the Cancel topic.

Copy link
Author

@mjeronimo mjeronimo Oct 10, 2018

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, it should have said that "The Command and Result messages are provided by the user of the classes, while the Cancel and Status messages are internal to the implementation." I'm referring to the messages themselves. Perhaps this might be a bit confusing relative to the interface that the client uses (where one can use the client interface to send a command or cancel an active operation). I'll clarify this.


## Overview

The Navigation2 architecture implements a *task hiearchy* where commands are sent to modules which are organized in a hierarchy. Each module implements a task and can utilize sub-tasks, which are themselves modules that implement tasks.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

mispelled "hierarchy"

Copy link

@ghost ghost left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You are about to add back in the .pyc file. Please remove that before merging

@mjeronimo
Copy link
Author

@crdelsey Actually, I'm deleting the pyc file. I noticed that it was currently in master and getting rid of it. It must've snuck in with another commit.

@mjeronimo
Copy link
Author

@bpwilcox Please have a look at the updated text discussing the messages.

@ghost
Copy link

ghost commented Oct 11, 2018

I thought we had just merged a change deleting the pyc file so I thought this must be adding it back. Sorry.

Copy link

@bpwilcox bpwilcox left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me

Copy link
Collaborator

@mkhansenbot mkhansenbot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good 👍

@mjeronimo mjeronimo merged commit c84f2cf into ros-navigation:master Oct 11, 2018
@mjeronimo mjeronimo deleted the first-readme-additions branch October 11, 2018 22:35
ghost pushed a commit to logivations/navigation2 that referenced this pull request Mar 7, 2022
* pushrosnamespace in planner server

* deactivate pushrosnamespace for new launchfiles

Co-authored-by: Andrii Maistruk <andriy.maistruk@logivations.com>
mini-1235 pushed a commit to mini-1235/navigation2 that referenced this pull request Feb 5, 2025
* corrected the BT example to the current one

* fixed xml code block formatting

* completed first portion of custom_bt tutorial

* added NavigateWithReplanning explaination

* added recovery fallback tutorial

* Apply suggestions from Steve's code review

Co-authored-by: Steve Macenski <stevenmacenski@gmail.com>

* Added BT Custom Node Walk Through (ros-navigation#1)

* adding reference to the getting started guide

* fixed xml indentation

* adding images, test to see how it renders

* fixing XML, and BT rendering

* adding overview of custom BT nodes

* added pictures for pipeline sequence

* fixed typos on image, and guide

* added recovery node explaination

* addding round robin explaination

* getting rid of build folder and vscode folder

* Editing, Added Explanation through Recovery subtree (ros-navigation#2)

* Apply suggestions from code review

Co-authored-by: Steve Macenski <stevenmacenski@gmail.com>

* Update Foxy.rst

* Nav through poses2: Adding parameters (ros-navigation#158)

* adding documentation for nav through poses PR

* adding new params for nav through poses

* attempt at moving custom Nav2 BT nodes to it's own section

* attempt to fix the pipe rendering issue

* changing references so that they are navigate to pose with replanning and recovery

* putting new page in a folder in an attempt to get the BT XML page working

* fix page link for config guide, play around to render bullets

* brushing up in response to comments

* fixing link so that they lead directly to the specific nodes

* correcting minor typos and comments

* moving to main behavior tree section

* fixing typo in index so that TOC works

* trying relative path in case that fixes the link to nav2_specific_nodes

* still trying to link to overview/specific_nodes

* ok hopefully this is the final time here, successful link

* fixing images

Co-authored-by: Steve Macenski <stevenmacenski@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants