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

Tutorial loading physics plugin #115

Merged
merged 8 commits into from
Oct 22, 2020

Conversation

anindex
Copy link
Contributor

@anindex anindex commented Oct 3, 2020

Signed-off-by: anindex [email protected]

@anindex anindex requested a review from mxgrey as a code owner October 3, 2020 12:29
@chapulina chapulina requested a review from claireyywang October 6, 2020 19:32
@chapulina chapulina added the documentation Improvements or additions to documentation label Oct 6, 2020
Copy link
Contributor

@claireyywang claireyywang left a comment

Choose a reason for hiding this comment

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

LGTM in genera with some minor commentsl!

be used in our code. After the `std` C++ libraries are the `Loader.hh` and
`PluginPtr.hh`, which provides main functionalities for loading physics plugins
and plugin pointers. Next includes from \ref ignition::physics are the tools for
retrieving "Features" and "Entities" from physics plugins.
Copy link
Contributor

Choose a reason for hiding this comment

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

Provide definitions for Features and Entities, FeaureLists, linking to content in this section https://github.com/ignitionrobotics/ign-physics/blame/main/tutorials/03_physics_plugins.md#L16


Assuming the correct path, our loader will instantiate all plugins that are
available in the path using @ref ignition::plugin::Loader::Instantiate member function. Then for each instantiated plugin, it will request an engine
using @ref ignition::physics::RequestEngine3d<Features>::From function.
Copy link
Contributor

Choose a reason for hiding this comment

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

worth explaining/linking to the definition of FeaturePolicy https://github.com/ignitionrobotics/ign-physics/blame/main/tutorials/03_physics_plugins.md#L36 here, since features can be 2d or 3d or any custom dimensions

}
```

### Example setup CMakeLists.txt file for Dome release
Copy link
Contributor

Choose a reason for hiding this comment

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

We could add a link to CMake tutorials https://cmake.org/cmake/help/latest/guide/tutorial/index.html to provide extra clarity and resource

tutorials/05_plugin_loading.md Show resolved Hide resolved

### Load existing plugins

For example, if you have the Ignition Physics plugin for DART compiled, find
Copy link
Contributor

Choose a reason for hiding this comment

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

DART can point to either the repo or a documentation related to the physics engine just so user can have more context

### Load existing plugins

For example, if you have the Ignition Physics plugin for DART compiled, find
where it is installed with (you may need sudo right):
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
where it is installed with (you may need sudo right):
where it is installed with (you may need administrative rights: `sudo` on Linux platform):

engine name: dartsim-6.10.0
```

At the time of writing, Ignition Physics is shipped with `DART` and `TPE`
Copy link
Contributor

Choose a reason for hiding this comment

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

again, links to each physics engine repo/documentation

Copy link
Contributor

@claireyywang claireyywang left a comment

Choose a reason for hiding this comment

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

LGTM!

@claireyywang claireyywang merged commit b75b055 into gazebosim:main Oct 22, 2020
claireyywang added a commit that referenced this pull request Jan 7, 2021
* Initial draft for loading plugin tutorial

Signed-off-by: anindex <[email protected]>

* Resolve comments

Signed-off-by: anindex <[email protected]>

Co-authored-by: anindex <[email protected]>
Co-authored-by: Louise Poubel <[email protected]>
Co-authored-by: Claire Wang <[email protected]>
claireyywang added a commit that referenced this pull request Jan 7, 2021
* Initial draft for loading plugin tutorial

Signed-off-by: anindex <[email protected]>

* Resolve comments

Signed-off-by: anindex <[email protected]>

Co-authored-by: anindex <[email protected]>
Co-authored-by: Louise Poubel <[email protected]>
Co-authored-by: Claire Wang <[email protected]>
chapulina added a commit that referenced this pull request Jan 21, 2021
* Initial draft for loading plugin tutorial

Signed-off-by: anindex <[email protected]>

* Resolve comments

Signed-off-by: anindex <[email protected]>

Co-authored-by: anindex <[email protected]>
Co-authored-by: Louise Poubel <[email protected]>
Co-authored-by: Claire Wang <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants