Skip to content

Added a documentation of the SimulationInterfaces gem#2652

Merged
ShaunaGordon merged 6 commits intoo3de:developmentfrom
RobotecAI:pantosz/simulation_interfaces
May 1, 2025
Merged

Added a documentation of the SimulationInterfaces gem#2652
ShaunaGordon merged 6 commits intoo3de:developmentfrom
RobotecAI:pantosz/simulation_interfaces

Conversation

@patrykantosz
Copy link
Contributor

@patrykantosz patrykantosz commented Apr 22, 2025

Change summary

This PR adds the description of the O3DE implementation of the simulation_interfaces standard.

@patrykantosz patrykantosz requested a review from a team as a code owner April 22, 2025 12:54
@adamdbrw adamdbrw self-requested a review April 22, 2025 13:07
Copy link
Contributor

@ShaunaGordon ShaunaGordon left a comment

Choose a reason for hiding this comment

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

Just the one minor thing. Looks good otherwise.

jhanca-robotecai and others added 6 commits April 29, 2025 14:24
Signed-off-by: Jan Hanca <jan.hanca@robotec.ai>
Signed-off-by: Jan Hanca <jan.hanca@robotec.ai>
Signed-off-by: Patryk Antosz <patryk.antosz@robotec.ai>
Signed-off-by: Patryk Antosz <patryk.antosz@robotec.ai>
Signed-off-by: Jan Hanca <jan.hanca@robotec.ai>
Signed-off-by: Michał Pełka <michal.pelka@robotec.ai>
@michalpelka michalpelka force-pushed the pantosz/simulation_interfaces branch from c91df90 to b5ce0a8 Compare April 29, 2025 15:20
@michalpelka
Copy link
Contributor

@ShaunaGordon , I've rebased on top of #2651 and force pushed.

@ShaunaGordon ShaunaGordon merged commit 0d71acc into o3de:development May 1, 2025
5 checks passed
@jhanca-robotecai jhanca-robotecai deleted the pantosz/simulation_interfaces branch May 2, 2025 08:45
jhanca-robotecai added a commit to RobotecAI/o3de.org that referenced this pull request May 2, 2025
* Update sample projects and templates
* Update robotics content
* Added a documentation of the SimulationInterfaces gem
* Applied review suggestions
* Code review changes (#4)
* Michal's changes

---------

Signed-off-by: Jan Hanca <jan.hanca@robotec.ai>
Signed-off-by: Patryk Antosz <patryk.antosz@robotec.ai>
Signed-off-by: Michał Pełka <michal.pelka@robotec.ai>
Co-authored-by: Jan Hanca <jan.hanca@robotec.ai>
Co-authored-by: Michał Pełka <michal.pelka@robotec.ai>
Copy link
Contributor

@arturkamieniecki arturkamieniecki left a comment

Choose a reason for hiding this comment

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

Please verify the weight parameters, as in some files the value is 120 and in others 300, 220 etc.

The most promenent comment is about \ as line break. There are more instances of this that are not marked. Please apply all changes of these comments to all other instances of \ used as line break.

Overall the text is clean and reads nicely.

Note: I have not verified if all links in these files point to a correct location.

Comment on lines +18 to +19
| [Vehicle Dynamics](vehicle-dynamics.md) | Drive your robot with skid steering or Ackermann drive models. |
| [Joints Manipulation](joints-manipulation.md) | Control robotic manipulators and joints. |
Copy link
Contributor

Choose a reason for hiding this comment

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

The | characters are unaligned.

1. Some sensors are already implemented in this Gem.
1. They might require specialization (implementation specific for particular models).
2. You might like to consider tradeoffs between performance and realism in each case.
2. You might like to consider trade-offs between performance and realism in each case.
Copy link
Contributor

Choose a reason for hiding this comment

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

Both spellings are correct, but the tradeoffs spelling less common in British English.

- [Georeferencing Gem](georeference.md), a helper Gem enabling simulated robots to use global positioning devices and geo-reference APIs.
- Asset Gems providing sample ROS 2 prefabs (robots) and scene decorations, including:
- [ROS 2 Sample Robots Gem](https://github.com/o3de/o3de-extras/tree/main/Gems/ROS2SampleRobots) providing assets of `ProteusRobot`, `ROSBot XL`, and `Panda Franka` robots.
- [WarehouseAssets](https://github.com/o3de/o3de-extras/tree/main/Gems/WarehouseAssets) and [WarehouseAutomation](https://github.com/o3de/o3de-extras/tree/main/Gems/WarehouseAutomation) Gems providing useful assets for warehouse environments
Copy link
Contributor

Choose a reason for hiding this comment

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

Missing . at end.

Comment on lines +81 to +83
ROS 2 _service_ definition: [GetEntityState.srv](https://github.com/ros-simulation/simulation_interfaces/tree/main/srv/GetSimulatorFeatures.srv) \
SimulatorFeatures definition: [SimulatorFeatures](https://github.com/ros-simulation/simulation_interfaces/tree/main/msg/SimulatorFeatures.msg) \
Default _service_ name: `/get_simulation_features` \
Copy link
Contributor

Choose a reason for hiding this comment

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

On https://www.markdownguide.org/basic-syntax/#line-break-best-practices it says that \ should not be used as a line break. Instead double spaces should be used.

Comment on lines +109 to +111
ROS 2 _service_ definition: [GetSpawnables](https://github.com/ros-simulation/simulation_interfaces/tree/main/srv/GetSpawnables.srv) \
Individual _spawnables_ ROS 2 _message_ definition: [Spawnable.msg](https://github.com/ros-simulation/simulation_interfaces/tree/main/msg/Spawnable.msg) \
Default _service_ name: `/get_spawnables` \
Copy link
Contributor

Choose a reason for hiding this comment

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

On https://www.markdownguide.org/basic-syntax/#line-break-best-practices it says that \ should not be used as a line break. Instead double spaces should be used.

Comment on lines +118 to +119
ROS 2 _service_ definition: [SpawnEntity](https://github.com/ros-simulation/simulation_interfaces/tree/main/srv/SpawnEntity.srv) \
Default _service_ name: `/spawn_entity` \
Copy link
Contributor

Choose a reason for hiding this comment

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

On https://www.markdownguide.org/basic-syntax/#line-break-best-practices it says that \ should not be used as a line break. Instead double spaces should be used.

Comment on lines +130 to +132
ROS 2 _service_ definition: [GetEntities](https://github.com/ros-simulation/simulation_interfaces/tree/main/srv/GetEntities.srv) \
EntityFilters definition: [EntityFilters](https://github.com/ros-simulation/simulation_interfaces/blob/main/msg/EntityFilters.msg) \
Default _service_ name: `/get_entities` \
Copy link
Contributor

Choose a reason for hiding this comment

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

On https://www.markdownguide.org/basic-syntax/#line-break-best-practices it says that \ should not be used as a line break. Instead double spaces should be used.

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.

5 participants