diff --git a/404.html b/404.html index 6bf20c6..fdd8499 100644 --- a/404.html +++ b/404.html @@ -278,7 +278,7 @@ - LICENCE + LICENSE @@ -433,6 +433,27 @@ +
  • + + + + + Set up URDF for Sensors + + + + +
  • + + + + + + + + + +
  • @@ -594,6 +615,27 @@ +
  • + + + + + URDFへのセンサ情報の記述方法 + + + + +
  • + + + + + + + + + +
  • diff --git a/Demos/demo_for_arm_robot/index.html b/Demos/demo_for_arm_robot/index.html index 3929bef..d7c8b92 100644 --- a/Demos/demo_for_arm_robot/index.html +++ b/Demos/demo_for_arm_robot/index.html @@ -287,7 +287,7 @@ - LICENCE + LICENSE @@ -454,6 +454,27 @@ +
  • + + + + + Set up URDF for Sensors + + + + +
  • + + + + + + + + + +
  • @@ -615,6 +636,27 @@ +
  • + + + + + URDFへのセンサ情報の記述方法 + + + + +
  • + + + + + + + + + +
  • diff --git a/Demos/demo_for_mobile_robot/index.html b/Demos/demo_for_mobile_robot/index.html index 936ae46..7da8c43 100644 --- a/Demos/demo_for_mobile_robot/index.html +++ b/Demos/demo_for_mobile_robot/index.html @@ -287,7 +287,7 @@ - LICENCE + LICENSE @@ -454,6 +454,27 @@ +
  • + + + + + Set up URDF for Sensors + + + + +
  • + + + + + + + + + +
  • @@ -615,6 +636,27 @@ +
  • + + + + + URDFへのセンサ情報の記述方法 + + + + +
  • + + + + + + + + + +
  • diff --git a/LICENSE/index.html b/LICENSE/index.html index 1ad8b4f..6de7c54 100644 --- a/LICENSE/index.html +++ b/LICENSE/index.html @@ -20,7 +20,7 @@ - LICENCE - ROS 2 utilities for Isaac Sim + LICENSE - ROS 2 utilities for Isaac Sim @@ -72,7 +72,7 @@
    - + Skip to content @@ -108,7 +108,7 @@
    - LICENCE + LICENSE
    @@ -296,7 +296,7 @@ - LICENCE + LICENSE @@ -452,6 +452,27 @@ +
  • + + + + + Set up URDF for Sensors + + + + +
  • + + + + + + + + + +
  • @@ -613,6 +634,27 @@ +
  • + + + + + URDFへのセンサ情報の記述方法 + + + + +
  • + + + + + + + + + +
  • @@ -761,7 +803,7 @@ -

    LICENCE

    +

    LICENSE

    MIT License
     
     Copyright (c) 2024 Masaaki Hijikata
    diff --git a/Tutorials/setup_urdf_for_ros2_control/index.html b/Tutorials/setup_urdf_for_ros2_control/index.html
    index 81b8ea6..5f0ccb6 100644
    --- a/Tutorials/setup_urdf_for_ros2_control/index.html
    +++ b/Tutorials/setup_urdf_for_ros2_control/index.html
    @@ -12,7 +12,7 @@
             
           
           
    -        
    +        
           
           
           
    @@ -287,7 +287,7 @@
             
       
       
    -    LICENCE
    +    LICENSE
       
       
     
    @@ -502,6 +502,27 @@
       
       
       
    +    
  • + + + + + Set up URDF for Sensors + + + + +
  • + + + + + + + + + +
  • @@ -663,6 +684,27 @@ +
  • + + + + + URDFへのセンサ情報の記述方法 + + + + +
  • + + + + + + + + + +
  • diff --git a/Tutorials/setup_urdf_for_sensors/index.html b/Tutorials/setup_urdf_for_sensors/index.html new file mode 100644 index 0000000..9f0ad4e --- /dev/null +++ b/Tutorials/setup_urdf_for_sensors/index.html @@ -0,0 +1,1016 @@ + + + + + + + + + + + + + + + + + + + + + + + Set up URDF for Sensors - ROS 2 utilities for Isaac Sim + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + + + + Skip to content + + +
    +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + + +
    +
    +
    + + + +
    + +
    + + + +
    +
    + + + + +

    Set up URDF for Sensors

    +

    This document shows how to describe the information of a sensor running on Isaac Sim in the robot's URDF.

    +

    In Gazebo Classic, it was possible to generate sensors in the simulation by writing sensor information in the gazebo tag of the URDF. +In this repository, the same functionality is achieved by describing sensor information in isaac tags. +Below we show how to describe sensor information for LiDAR, cameras and depth cameras.

    +

    Description of LiDAR information

    +

    The following is an example of LiDAR information.

    +
    <sensor name="lidar_link" type="lidar">
    +  <topic>scan</topic>
    +  <sensor_dimension_num>3</sensor_dimension_num> <!-- 2 or 3 -->
    +  <config>Example_Rotary</config>
    +  <!-- Config Example
    +  <config>Example_Rotary</config>
    +  <config>slamtec/RPLIDAR_S2E</config>
    +  <config>hokuyo/UST-30LX</config>
    +  -->
    +</sensor>
    +
    +

    As shown in the example above, the basic description is the same as for the gazebo tag, but you can see that the setting values have changed. +sensor_dimension_num is the dimension of the point cloud to be acquired, and can be set to 2D or 3D. +config can be a LiDAR configuration file. +The LiDAR configuration file is located in "exts/omni.isaac.sensor/data/lidar_configs" in "exts/omni.isaac.sensor/data/lidar_configs" in the Isaac Sim reference directory ("~/.local/share/ov/pkg/isaac_sim-2023.1.1/" for native or "/isaac-sim" for Docker). +Please add configuration files as needed.

    +

    Description of Camera information

    +

    The following is an example of camera information.

    +
    <sensor name="camera_link" type="camera">
    +  <topic>image_raw</topic>
    +  <horizontal_fov_rad>1.3962634</horizontal_fov_rad>
    +  <horizontal_focal_length>30</horizontal_focal_length> <!-- optical parameter -->
    +  <vertical_focal_length>30</vertical_focal_length> <!-- optical parameter -->
    +  <focus_distance>400</focus_distance> <!-- distance for clear image -->
    +  <projection>perspective</projection> <!-- perspective or orthgonal -->
    +  <image>
    +     <width>600</width>
    +     <height>600</height>
    +  </image>
    +  <clip>
    +    <near>0.02</near>
    +    <far>300</far>
    +  </clip>
    +  <update_rate>10.0</update_rate>
    +</sensor>
    +
    +

    Description of Depth Camera information

    +

    The following is an example of depth camera information.

    +
    <sensor name="depth_camera_link" type="depth_camera">
    +  <topic>image_raw</topic>
    +  <horizontal_fov_rad>1.3962634</horizontal_fov_rad>
    +  <horizontal_focal_length>30</horizontal_focal_length> <!-- optical parameter -->
    +  <vertical_focal_length>30</vertical_focal_length> <!-- optical parameter -->
    +  <focus_distance>400</focus_distance> <!-- distance for clear image -->
    +  <projection>perspective</projection> <!-- perspective or orthgonal -->
    +  <image>
    +    <width>320</width>
    +    <height>240</height>
    +  </image>
    +  <clip>
    +    <near>0.1</near>
    +    <far>100</far>
    +  </clip>
    +  <update_rate>10</update_rate>
    +</sensor>
    +
    + + + + + + + + + + + + + +
    +
    + + + +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + + + \ No newline at end of file diff --git a/Tutorials/tutorial/index.html b/Tutorials/tutorial/index.html index 5b26e38..4fb6012 100644 --- a/Tutorials/tutorial/index.html +++ b/Tutorials/tutorial/index.html @@ -9,7 +9,7 @@ - + @@ -287,7 +287,7 @@ - LICENCE + LICENSE @@ -442,6 +442,27 @@ + + +
  • + + + + + Set up URDF for Sensors + + + + +
  • + + + + + + + + @@ -615,6 +636,27 @@ +
  • + + + + + URDFへのセンサ情報の記述方法 + + + + +
  • + + + + + + + + + +
  • @@ -769,7 +811,7 @@

    Tutorials

    Set up URDF for ros2_control

  • -

    Set up URDF for Sensors

    +

    Set up URDF for Sensors

  • How to Use Simulator Launcher

    diff --git a/docs/LICENSE.md b/docs/LICENSE.md index 7ccc89a..a075355 100644 --- a/docs/LICENSE.md +++ b/docs/LICENSE.md @@ -1,4 +1,4 @@ -# LICENCE +# LICENSE ``` MIT License diff --git a/docs/Tutorials/setup_urdf_for_sensors.md b/docs/Tutorials/setup_urdf_for_sensors.md new file mode 100644 index 0000000..2a0ff1d --- /dev/null +++ b/docs/Tutorials/setup_urdf_for_sensors.md @@ -0,0 +1,78 @@ +# Set up URDF for Sensors + +This document shows how to describe the information of a sensor running on Isaac Sim in the robot's URDF. + +In Gazebo Classic, it was possible to generate sensors in the simulation by writing sensor information in the gazebo tag of the URDF. +In this repository, the same functionality is achieved by describing sensor information in isaac tags. +Below we show how to describe sensor information for LiDAR, cameras and depth cameras. + +## Description of LiDAR information + +The following is an example of LiDAR information. + +```xml + + scan + 3 + Example_Rotary + + +``` + +As shown in the example above, the basic description is the same as for the gazebo tag, but you can see that the setting values have changed. +sensor_dimension_num is the dimension of the point cloud to be acquired, and can be set to 2D or 3D. +config can be a LiDAR configuration file. +The LiDAR configuration file is located in "exts/omni.isaac.sensor/data/lidar_configs" in "exts/omni.isaac.sensor/data/lidar_configs" in the Isaac Sim reference directory ("~/.local/share/ov/pkg/isaac_sim-2023.1.1/" for native or "/isaac-sim" for Docker). +Please add configuration files as needed. + +## Description of Camera information + +The following is an example of camera information. + +```xml + + image_raw + 1.3962634 + 30 + 30 + 400 + perspective + + 600 + 600 + + + 0.02 + 300 + + 10.0 + +``` + +## Description of Depth Camera information + +The following is an example of depth camera information. + +```xml + + image_raw + 1.3962634 + 30 + 30 + 400 + perspective + + 320 + 240 + + + 0.1 + 100 + + 10 + +``` \ No newline at end of file diff --git a/docs/Tutorials/tutorial.md b/docs/Tutorials/tutorial.md index 1c607e0..b1e94fb 100644 --- a/docs/Tutorials/tutorial.md +++ b/docs/Tutorials/tutorial.md @@ -2,7 +2,7 @@ - [Set up URDF for ros2_control](./setup_urdf_for_ros2_control.md) -- Set up URDF for Sensors +- [Set up URDF for Sensors](./setup_urdf_for_sensors.md) - How to Use Simulator Launcher diff --git "a/docs/ja/\343\203\201\343\203\245\343\203\274\343\203\210\343\203\252\343\202\242\343\203\253/setup_urdf_for_sensors.md" "b/docs/ja/\343\203\201\343\203\245\343\203\274\343\203\210\343\203\252\343\202\242\343\203\253/setup_urdf_for_sensors.md" new file mode 100644 index 0000000..1aaa248 --- /dev/null +++ "b/docs/ja/\343\203\201\343\203\245\343\203\274\343\203\210\343\203\252\343\202\242\343\203\253/setup_urdf_for_sensors.md" @@ -0,0 +1,76 @@ +# URDFへのセンサ情報の記述方法 + +このドキュメントではIsaac Sim上で動作するセンサの情報をロボットのURDFに記述する方法を示します。 + +Gazebo ClassicではURDFのgazeboタグにセンサ情報を記載することで、シミュレーション上にセンサを生成することが出来ていました。 +そこで、このリポジトリではisaacタグにセンサ情報を記載することで、同様の機能を実現しています。 +以下では、LiDAR、カメラおよびデプスカメラのセンサ情報の記述方法について示します。 + +## LiDAR情報の記述 + +以下にLiDAR情報の例を示します。 + +```xml + + scan + 3 + Example_Rotary + + +``` + +上記の例にあるように、基本的な記述方法はgazeboタグの際と同じですが、設定値が変わっていることがわかります。 +sensor_dimension_numは取得する点群の次元で、2次元または3次元が設定できます。 +configには、LiDARの設定ファイルを指定できます。 +LiDARの設定ファイルは、Isaac Simの基準ディレクトリ(ネイティブなら"~/.local/share/ov/pkg/isaac-sim_2023.1.1/"、Dockerなら"/isaac-sim")内の"exts/omni.isaac.sensor/data/lidar_configs"にあります。 +必要の応じて設定ファイルを追加して対応してください。 + +## カメラ情報の記述 + +以下にカメラ情報の例を示します。 + +```xml + + image_raw + 1.3962634 + 30 + 30 + 400 + perspective + + 600 + 600 + + + 0.02 + 300 + + 10.0 + +``` + +## デプスカメラ情報の記述 + +```xml + + image_raw + 1.3962634 + 30 + 30 + 400 + perspective + + 320 + 240 + + + 0.1 + 100 + + 10 + +``` \ No newline at end of file diff --git "a/docs/ja/\343\203\201\343\203\245\343\203\274\343\203\210\343\203\252\343\202\242\343\203\253/tutorial.md" "b/docs/ja/\343\203\201\343\203\245\343\203\274\343\203\210\343\203\252\343\202\242\343\203\253/tutorial.md" index 179d0d4..aa1fb34 100644 --- "a/docs/ja/\343\203\201\343\203\245\343\203\274\343\203\210\343\203\252\343\202\242\343\203\253/tutorial.md" +++ "b/docs/ja/\343\203\201\343\203\245\343\203\274\343\203\210\343\203\252\343\202\242\343\203\253/tutorial.md" @@ -1,8 +1,8 @@ # チュートリアル -- URDFへのros2_cotnrolタグの記述方法 +- [URDFへのros2_cotnrolタグの記述方法](./setup_urdf_for_ros2_control.md) -- URDFへのセンサ情報の記述方法 +- [URDFへのセンサ情報の記述方法](./setup_urdf_for_sensors.md) - シミュレーションランチャーの使い方 diff --git a/index.html b/index.html index 890b1c2..835441f 100644 --- a/index.html +++ b/index.html @@ -370,7 +370,7 @@ - LICENCE + LICENSE @@ -525,6 +525,27 @@ +
  • + + + + + Set up URDF for Sensors + + + + +
  • + + + + + + + + + +
  • @@ -686,6 +707,27 @@ +
  • + + + + + URDFへのセンサ情報の記述方法 + + + + +
  • + + + + + + + + + +
  • diff --git a/ja/LICENSE/index.html b/ja/LICENSE/index.html index 5de66ea..396fb4f 100644 --- a/ja/LICENSE/index.html +++ b/ja/LICENSE/index.html @@ -287,7 +287,7 @@ - LICENCE + LICENSE @@ -442,6 +442,27 @@ +
  • + + + + + Set up URDF for Sensors + + + + +
  • + + + + + + + + + +
  • @@ -615,6 +636,27 @@ +
  • + + + + + URDFへのセンサ情報の記述方法 + + + + +
  • + + + + + + + + + +
  • diff --git a/ja/index.html b/ja/index.html index 520bbaf..3959bea 100644 --- a/ja/index.html +++ b/ja/index.html @@ -287,7 +287,7 @@ - LICENCE + LICENSE @@ -442,6 +442,27 @@ +
  • + + + + + Set up URDF for Sensors + + + + +
  • + + + + + + + + + +
  • @@ -690,6 +711,27 @@ +
  • + + + + + URDFへのセンサ情報の記述方法 + + + + +
  • + + + + + + + + + +
  • diff --git "a/ja/\343\203\201\343\203\245\343\203\274\343\203\210\343\203\252\343\202\242\343\203\253/setup_urdf_for_ros2_control/index.html" "b/ja/\343\203\201\343\203\245\343\203\274\343\203\210\343\203\252\343\202\242\343\203\253/setup_urdf_for_ros2_control/index.html" index 3799c62..4361e15 100644 --- "a/ja/\343\203\201\343\203\245\343\203\274\343\203\210\343\203\252\343\202\242\343\203\253/setup_urdf_for_ros2_control/index.html" +++ "b/ja/\343\203\201\343\203\245\343\203\274\343\203\210\343\203\252\343\202\242\343\203\253/setup_urdf_for_ros2_control/index.html" @@ -12,7 +12,7 @@ - + @@ -287,7 +287,7 @@ - LICENCE + LICENSE @@ -442,6 +442,27 @@ +
  • + + + + + Set up URDF for Sensors + + + + +
  • + + + + + + + + + +
  • @@ -665,6 +686,27 @@ +
  • + + + + + URDFへのセンサ情報の記述方法 + + + + +
  • + + + + + + + + + +
  • diff --git "a/ja/\343\203\201\343\203\245\343\203\274\343\203\210\343\203\252\343\202\242\343\203\253/setup_urdf_for_sensors/index.html" "b/ja/\343\203\201\343\203\245\343\203\274\343\203\210\343\203\252\343\202\242\343\203\253/setup_urdf_for_sensors/index.html" new file mode 100644 index 0000000..00aeafb --- /dev/null +++ "b/ja/\343\203\201\343\203\245\343\203\274\343\203\210\343\203\252\343\202\242\343\203\253/setup_urdf_for_sensors/index.html" @@ -0,0 +1,1017 @@ + + + + + + + + + + + + + + + + + + + + + + + URDFへのセンサ情報の記述方法 - ROS 2 utilities for Isaac Sim + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + + + + Skip to content + + +
    +
    + +
    + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    + + + + +

    URDFへのセンサ情報の記述方法

    +

    このドキュメントではIsaac Sim上で動作するセンサの情報をロボットのURDFに記述する方法を示します。

    +

    Gazebo ClassicではURDFのgazeboタグにセンサ情報を記載することで、シミュレーション上にセンサを生成することが出来ていました。 +そこで、このリポジトリではisaacタグにセンサ情報を記載することで、同様の機能を実現しています。 +以下では、LiDAR、カメラおよびデプスカメラのセンサ情報の記述方法について示します。

    +

    LiDAR情報の記述

    +

    以下にLiDAR情報の例を示します。

    +
    <sensor name="lidar_link" type="lidar">
    +  <topic>scan</topic>
    +  <sensor_dimension_num>3</sensor_dimension_num> <!-- 2 or 3 -->
    +  <config>Example_Rotary</config>
    +  <!-- Config Example
    +  <config>Example_Rotary</config>
    +  <config>slamtec/RPLIDAR_S2E</config>
    +  <config>hokuyo/UST-30LX</config>
    +  -->
    +</sensor>
    +
    +

    上記の例にあるように、基本的な記述方法はgazeboタグの際と同じですが、設定値が変わっていることがわかります。 +sensor_dimension_numは取得する点群の次元で、2次元または3次元が設定できます。 +configには、LiDARの設定ファイルを指定できます。 +LiDARの設定ファイルは、Isaac Simの基準ディレクトリ(ネイティブなら"~/.local/share/ov/pkg/isaac-sim_2023.1.1/"、Dockerなら"/isaac-sim")内の"exts/omni.isaac.sensor/data/lidar_configs"にあります。 +必要の応じて設定ファイルを追加して対応してください。

    +

    カメラ情報の記述

    +

    以下にカメラ情報の例を示します。

    +
    <sensor name="camera_link" type="camera">
    +  <topic>image_raw</topic>
    +  <horizontal_fov_rad>1.3962634</horizontal_fov_rad>
    +  <horizontal_focal_length>30</horizontal_focal_length> <!-- optical parameter -->
    +  <vertical_focal_length>30</vertical_focal_length> <!-- optical parameter -->
    +  <focus_distance>400</focus_distance> <!-- distance for clear image -->
    +  <projection>perspective</projection> <!-- perspective or orthgonal -->
    +  <image>
    +     <width>600</width>
    +     <height>600</height>
    +  </image>
    +  <clip>
    +    <near>0.02</near>
    +    <far>300</far>
    +  </clip>
    +  <update_rate>10.0</update_rate>
    +</sensor>
    +
    +

    デプスカメラ情報の記述

    +
    <sensor name="depth_camera_link" type="depth_camera">
    +  <topic>image_raw</topic>
    +  <horizontal_fov_rad>1.3962634</horizontal_fov_rad>
    +  <horizontal_focal_length>30</horizontal_focal_length> <!-- optical parameter -->
    +  <vertical_focal_length>30</vertical_focal_length> <!-- optical parameter -->
    +  <focus_distance>400</focus_distance> <!-- distance for clear image -->
    +  <projection>perspective</projection> <!-- perspective or orthgonal -->
    +  <image>
    +    <width>320</width>
    +    <height>240</height>
    +  </image>
    +  <clip>
    +    <near>0.1</near>
    +    <far>100</far>
    +  </clip>
    +  <update_rate>10</update_rate>
    +</sensor>
    +
    + + + + + + + + + + + + + +
    +
    + + + +
    + +
    + + + +
    +
    +
    +
    + + + + + + + + + + \ No newline at end of file diff --git "a/ja/\343\203\201\343\203\245\343\203\274\343\203\210\343\203\252\343\202\242\343\203\253/tutorial/index.html" "b/ja/\343\203\201\343\203\245\343\203\274\343\203\210\343\203\252\343\202\242\343\203\253/tutorial/index.html" index 3ffab2b..df949eb 100644 --- "a/ja/\343\203\201\343\203\245\343\203\274\343\203\210\343\203\252\343\202\242\343\203\253/tutorial/index.html" +++ "b/ja/\343\203\201\343\203\245\343\203\274\343\203\210\343\203\252\343\202\242\343\203\253/tutorial/index.html" @@ -9,7 +9,7 @@ - + @@ -287,7 +287,7 @@ - LICENCE + LICENSE @@ -442,6 +442,27 @@ +
  • + + + + + Set up URDF for Sensors + + + + +
  • + + + + + + + + + +
  • @@ -605,6 +626,27 @@ + + +
  • + + + + + URDFへのセンサ情報の記述方法 + + + + +
  • + + + + + + + + @@ -768,10 +810,10 @@

    チュートリアル