From a0d3d9e727bb9d070aa8084b5cd5954c7d02ebcb Mon Sep 17 00:00:00 2001 From: Johnson Sun Date: Fri, 1 Nov 2024 12:42:57 +0800 Subject: [PATCH] docs: Add system requirements and minor updates --- README.md | 15 +++++++++++++-- .../isaacsim/scripts/create_vx300s_from_urdf.py | 2 +- docs/aloha-ws/index.md | 9 ++++++++- docs/index.md | 15 +++++++++++++-- 4 files changed, 35 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 2416a5e3..520136d0 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,9 @@ [![tests](https://img.shields.io/github/actions/workflow/status/j3soon/ros2-essentials/test-common.yaml?label=tests)](https://github.com/j3soon/ros2-essentials/actions/workflows/test-common.yaml) [![docs](https://img.shields.io/github/actions/workflow/status/j3soon/ros2-essentials/build-docs.yaml?label=docs)](https://j3soon.github.io/ros2-essentials/) -A repo containing essential ROS2 Humble features for controlling Autonomous Mobile Robots (AMRs). Please setup an Ubuntu environment before using this repo. +A repo containing essential ROS2 Humble features for controlling Autonomous Mobile Robots (AMRs) and robotic arm manipulators. Please setup an Ubuntu environment before using this repo. + +The goal of this repo is to allow seamless robot policy reuse between simulation and reality powered by [Omniverse Isaac Sim](https://docs.omniverse.nvidia.com/isaacsim/latest/index.html) and [Isaac ROS](https://nvidia-isaac-ros.github.io/index.html). In general, the amd64 images support both simulation and real robot control, while the arm64 images only supports real robot control. > Please note that this repo is under rapid development. The code is not guaranteed to be stable, and breaking changes may occur. @@ -20,7 +22,7 @@ cd ros2-essentials Pre-built Docker images for each workspace can be pulled by running `docker compose pull` in the corresponding workspace directory. Pulling these images bypasses the time-consuming build process (for both Docker Compose and Dev Containers). -Click on the following workspaces to navigate to their respective documentation. +The docker image of the template workspace is share by most of the workspace, allowing saving spaces by sharing common packages. Click on the following workspaces to navigate to their respective documentation. | Workspace | amd64 | arm64 | Notes | Maintainer | |-----------|-------|-------|-------|------------| @@ -37,6 +39,15 @@ Click on the following workspaces to navigate to their respective documentation. If you have trouble using a workspace, please [open an issue](https://github.com/j3soon/ros2-essentials/issues) and tag the current maintainers mentioned above. +## System Requirements + +| Use Case | Platform | Hardware | Software | Notes | +|----------|----------|----------|----------|-------| +| Simulation/Deployment | x86_64 | RTX GPU, 500GB+ SSD | Ubuntu 22.04, [NVIDIA Driver](https://ubuntu.com/server/docs/nvidia-drivers-installation), [Docker](https://docs.docker.com/engine/install/ubuntu/), [NVIDIA Container Toolkit](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html) | See [this page](https://docs.omniverse.nvidia.com/isaacsim/latest/installation/requirements.html#system-requirements) for more details. | +| Deployment-Only | Jetson | Jetson Orin, 500GB+ SSD | JetPack 6.0 | See [this page](https://nvidia-isaac-ros.github.io/getting_started/index.html) for more details. + +Some functionalities may still work on lower-spec systems, such as those without GPUs or on operating systems other than Ubuntu 22.04. However, these configurations are not officially supported and may require manual adjustments. Use them with caution. + ## Building Documentation ```sh diff --git a/aloha_ws/isaacsim/scripts/create_vx300s_from_urdf.py b/aloha_ws/isaacsim/scripts/create_vx300s_from_urdf.py index e6066f4e..eb827c23 100644 --- a/aloha_ws/isaacsim/scripts/create_vx300s_from_urdf.py +++ b/aloha_ws/isaacsim/scripts/create_vx300s_from_urdf.py @@ -38,9 +38,9 @@ def create_vx300s_from_urdf(urdf_path, usd_path): # Unfortunately, the first option somehow reports a false-positive error when using OmniGraph. # The false-positive error message doesn't affect the actual functionalities, but may bring potential confusions. # Therefore, we opt to manually switch to using the second option. + # This is also mentioned in the docs: # TODO: Switch back to the first option after this issue is fixed. prim = stage.GetPrimAtPath("/vx300s") - # Note that this somehow cannot be applied through GUI, and must be done through Python articulation = UsdPhysics.ArticulationRootAPI.Apply(prim) physx_articulation = PhysxSchema.PhysxArticulationAPI.Apply(articulation.GetPrim()) physx_articulation.CreateEnabledSelfCollisionsAttr().Set(False) diff --git a/docs/aloha-ws/index.md b/docs/aloha-ws/index.md index 92108efe..03675bd9 100644 --- a/docs/aloha-ws/index.md +++ b/docs/aloha-ws/index.md @@ -15,7 +15,7 @@ cd ~/ros2-essentials/aloha_ws/docker xhost +local:docker docker compose up -# The first build will take a while (~10 mins), please wait patiently. +# The initial build will take a while (~10 mins), please wait patiently. ``` The commands in the following sections assume that you are inside the Docker container: @@ -25,6 +25,13 @@ The commands in the following sections assume that you are inside the Docker con docker exec -it ros2-aloha-ws bash ``` +If the initial build somehow failed, run: + +```sh +rm -r build install +colcon build --symlink-install +``` + ## View Robot Model in RViz ```sh diff --git a/docs/index.md b/docs/index.md index 2416a5e3..520136d0 100644 --- a/docs/index.md +++ b/docs/index.md @@ -3,7 +3,9 @@ [![tests](https://img.shields.io/github/actions/workflow/status/j3soon/ros2-essentials/test-common.yaml?label=tests)](https://github.com/j3soon/ros2-essentials/actions/workflows/test-common.yaml) [![docs](https://img.shields.io/github/actions/workflow/status/j3soon/ros2-essentials/build-docs.yaml?label=docs)](https://j3soon.github.io/ros2-essentials/) -A repo containing essential ROS2 Humble features for controlling Autonomous Mobile Robots (AMRs). Please setup an Ubuntu environment before using this repo. +A repo containing essential ROS2 Humble features for controlling Autonomous Mobile Robots (AMRs) and robotic arm manipulators. Please setup an Ubuntu environment before using this repo. + +The goal of this repo is to allow seamless robot policy reuse between simulation and reality powered by [Omniverse Isaac Sim](https://docs.omniverse.nvidia.com/isaacsim/latest/index.html) and [Isaac ROS](https://nvidia-isaac-ros.github.io/index.html). In general, the amd64 images support both simulation and real robot control, while the arm64 images only supports real robot control. > Please note that this repo is under rapid development. The code is not guaranteed to be stable, and breaking changes may occur. @@ -20,7 +22,7 @@ cd ros2-essentials Pre-built Docker images for each workspace can be pulled by running `docker compose pull` in the corresponding workspace directory. Pulling these images bypasses the time-consuming build process (for both Docker Compose and Dev Containers). -Click on the following workspaces to navigate to their respective documentation. +The docker image of the template workspace is share by most of the workspace, allowing saving spaces by sharing common packages. Click on the following workspaces to navigate to their respective documentation. | Workspace | amd64 | arm64 | Notes | Maintainer | |-----------|-------|-------|-------|------------| @@ -37,6 +39,15 @@ Click on the following workspaces to navigate to their respective documentation. If you have trouble using a workspace, please [open an issue](https://github.com/j3soon/ros2-essentials/issues) and tag the current maintainers mentioned above. +## System Requirements + +| Use Case | Platform | Hardware | Software | Notes | +|----------|----------|----------|----------|-------| +| Simulation/Deployment | x86_64 | RTX GPU, 500GB+ SSD | Ubuntu 22.04, [NVIDIA Driver](https://ubuntu.com/server/docs/nvidia-drivers-installation), [Docker](https://docs.docker.com/engine/install/ubuntu/), [NVIDIA Container Toolkit](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html) | See [this page](https://docs.omniverse.nvidia.com/isaacsim/latest/installation/requirements.html#system-requirements) for more details. | +| Deployment-Only | Jetson | Jetson Orin, 500GB+ SSD | JetPack 6.0 | See [this page](https://nvidia-isaac-ros.github.io/getting_started/index.html) for more details. + +Some functionalities may still work on lower-spec systems, such as those without GPUs or on operating systems other than Ubuntu 22.04. However, these configurations are not officially supported and may require manual adjustments. Use them with caution. + ## Building Documentation ```sh