Skip to content

[JTC] Update trajectory documentation#714

Merged
bmagyar merged 9 commits intoros-controls:masterfrom
christophfroehlich:jtc/trajectory_docs
Jul 31, 2023
Merged

[JTC] Update trajectory documentation#714
bmagyar merged 9 commits intoros-controls:masterfrom
christophfroehlich:jtc/trajectory_docs

Conversation

@christophfroehlich
Copy link
Copy Markdown
Member

@christophfroehlich christophfroehlich commented Jul 21, 2023

Trajectory Representation

I added several plots to the docs, which should help to understand what is going on here with the different combinations of the given trajectory.

I moved this part as well as the parameters to a subpage, feel free to comment if you have a different suggestion for the doc structure.

For reference: I wrote a Python module using pybind to visualize the outputs of the Trajectory class with matplotlib, see here.

Trajectory Replacement

As of the outcome from #574 I re-added the trajectory replacement section discarded from #566

Bugfixes

Also fixes a broken link ros-controls/control.ros.org#131

Comment on lines +13 to +14
by the controller's setup of command interfaces and PID configuration. There is no sanity check and
missing fields in the sampled trajectory might cause segmentation faults.
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Should we add sanity checks here?

I got a segfault using velocity command interface, interpolation_method=none giving position trajectory only.

@christophfroehlich christophfroehlich changed the title [JTC] Add visualized examples for outputs of Trajectory class [JTC] Update trajectory documentation Jul 25, 2023
@codecov-commenter
Copy link
Copy Markdown

codecov-commenter commented Jul 25, 2023

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 36.53%. Comparing base (e7f9962) to head (b864c19).
Report is 573 commits behind head on master.

Additional details and impacted files
@@            Coverage Diff             @@
##           master     #714      +/-   ##
==========================================
+ Coverage   35.78%   36.53%   +0.75%     
==========================================
  Files         189        7     -182     
  Lines       17570      676   -16894     
  Branches    11592      357   -11235     
==========================================
- Hits         6287      247    -6040     
+ Misses        994      134     -860     
+ Partials    10289      295    -9994     
Flag Coverage Δ
unittests 36.53% <ø> (+0.75%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

see 194 files with indirect coverage changes

@@ -0,0 +1,132 @@
:github_url: https://github.com/ros-controls/ros2_controllers/blob/{REPOS_FILE_BRANCH}/joint_trajectory_controller/doc/parameters.rst

.. _parameters:
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

don't we generate this nwoadays?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

unfortunately not for all controllers, because nested parameters and maps are not supported yet :/

@bmagyar bmagyar merged commit fa72170 into ros-controls:master Jul 31, 2023
@christophfroehlich christophfroehlich deleted the jtc/trajectory_docs branch July 31, 2023 18:48
@christophfroehlich christophfroehlich added the backport-humble Triggers PR backport to ROS 2 humble. label Jul 31, 2023
mergify bot pushed a commit that referenced this pull request Jul 31, 2023
(cherry picked from commit fa72170)

# Conflicts:
#	joint_trajectory_controller/doc/userdoc.rst
christophfroehlich added a commit to christophfroehlich/ros2_controllers that referenced this pull request Aug 8, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backport-humble Triggers PR backport to ROS 2 humble.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants