From 2cd03a4805ccaa81da11d360d5f6642bc1ef084f Mon Sep 17 00:00:00 2001 From: Kazushi Kurasawa Date: Tue, 7 Oct 2025 17:38:59 +0900 Subject: [PATCH 01/13] =?UTF-8?q?=E3=83=88=E3=83=83=E3=83=97=E3=81=AEREADM?= =?UTF-8?q?E.md=E3=82=92=E6=95=B4=E5=82=99?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 74 ++++++++++++++++++++++++++++++++++--------------------- 1 file changed, 46 insertions(+), 28 deletions(-) diff --git a/README.md b/README.md index 4bbce954..6b12be1e 100644 --- a/README.md +++ b/README.md @@ -4,34 +4,27 @@ [![industrial_ci](https://github.com/rt-net/sciurus17_ros/actions/workflows/industrial_ci.yml/badge.svg?branch=ros2)](https://github.com/rt-net/sciurus17_ros/actions/workflows/industrial_ci.yml) -ROS 2 package suite of Sciurus17. +ROS 2でSciurusS17を動作させるパッケージです。 -![sciurus17_gazebo](https://rt-net.github.io/images/sciurus17/sciurus17_gazebo2.png "sciurus17_gazebo") +![sciurus17\_gazebo](https://rt-net.github.io/images/sciurus17/sciurus17_gazebo2.png "sciurus17_gazebo") ## Table of Contents - [sciurus17\_ros](#sciurus17_ros) - [Table of Contents](#table-of-contents) - [Supported ROS 2 distributions](#supported-ros-2-distributions) - - [ROS 1](#ros-1) - [Requirements](#requirements) - [Installation](#installation) - - [Build from source](#build-from-source) - - [Device setup](#device-setup) - [Quick Start](#quick-start) - [Packages](#packages) + - [How ot Use Examples](#how-to-use-examples) - [License](#license) - - [開発について](#開発について) + - [Contributing](#contributing) ## Supported ROS 2 distributions -- [Humble](https://github.com/rt-net/sciurus17_ros/tree/humble) -- [Jazzy](https://github.com/rt-net/sciurus17_ros/tree/jazzy) - -### ROS 1 - -- [Melodic](https://github.com/rt-net/sciurus17_ros/tree/master) -- [Noetic](https://github.com/rt-net/sciurus17_ros/tree/master) +- [Humble Hawksbill](https://github.com/rt-net/sciurus17_ros/tree/humble) +- [Jazzy Jalisco](https://github.com/rt-net/sciurus17_ros/tree/jazzy) ## Requirements @@ -40,12 +33,12 @@ ROS 2 package suite of Sciurus17. - [ウェブショップ](https://www.rt-shop.jp/index.php?main_page=product_info&products_id=3895) - Linux OS - Ubuntu 24.04 -- ROS +- ROS 2 - [Jazzy Jalisco](https://docs.ros.org/en/jazzy/Installation.html) ## Installation -### Build from source +### Source Build ```sh # Download packages @@ -64,25 +57,26 @@ colcon build --symlink-install source ~/ros2_ws/install/setup.bash ``` -### Device setup +## Quick Start + +### Device Setup -次の方法で`sciurus17_control`が実機と通信するために用いるUSBシリアル変換デバイス名を固定します。 +以下のコマンドで`sciurus17_control`が実機と通信するために用いるUSBシリアル変換デバイス名を固定します。 +実行後に再起動しSciurus17を接続すると`/dev/sciurus17spine`が作成されるようになります。 ```sh ros2 run sciurus17_tools create_udev_rules ``` -実行後に再起動しSciurus17を接続すると`/dev/sciurus17spine`が作成されるようになります。 +### Run -## Quick Start +次に、以下のコマンドを実行すると、Sciurus17がグリッパ開閉動作をします。 ```sh # Connect Sciurus17 to PC, then source ~/ros2_ws/install/setup.bash ros2 launch sciurus17_examples demo.launch.py -``` -```sh # Terminal 2 source ~/ros2_ws/install/setup.bash ros2 launch sciurus17_examples example.launch.py example:='gripper_control' @@ -90,8 +84,6 @@ ros2 launch sciurus17_examples example.launch.py example:='gripper_control' # Press [Ctrl-c] to terminate. ``` -詳細は[sciurus17_examples](./sciurus17_examples/README.md)を参照してください。 - ## Packages - sciurus17_control @@ -116,22 +108,48 @@ ros2 launch sciurus17_examples example.launch.py example:='gripper_control' - [README](https://github.com/rt-net/sciurus17_description/blob/ros2/README.md) - Sciurus17のモデルデータ（xacro）を定義するパッケージです +## How to Use Examples + +サンプルプログラムは、C++とPythonの両方を用意しています。詳しくは、以下のリンクをご覧ください。 + +### C++ + +- [sciurus17_examples](./sciurus17_examples/README.md) + - Examples + - gripper_control + - neck_control + - waist_control + - pick_and_place_right_arm_waist + - pick_and_place_left_arm + - head_camera_tracking + - chest_camera_tracking + - point_cloud_detection + +### Python + +- [crane_x7_examples_py](./crane_x7_examples_py/README.md) + - Examples + - gripper_control + - neck_control + - waist_control + - pick_and_place_right_arm_waist + - pick_and_place_left_arm + ## License (C) 2018 RT Corporation \ -各ファイルはライセンスがファイル中に明記されている場合、そのライセンスに従います。 -特に明記されていない場合は、Apache License, Version 2.0に基づき公開されています。 +各ファイルにライセンスが明記されている場合、そのライセンスに従います。 +特に明記がない場合は、Apache License, Version 2.0に基づいて公開されています。 ライセンスの全文は[LICENSE](./LICENSE)または[https://www.apache.org/licenses/LICENSE-2.0](https://www.apache.org/licenses/LICENSE-2.0)から確認できます。 本パッケージが依存する[sciurus17_description](https://github.com/rt-net/sciurus17_description/tree/ros2)には株式会社アールティの非商用ライセンスが適用されています。 詳細は[sciurus17_description/LICENSE](https://github.com/rt-net/sciurus17_description/blob/ros2/LICENSE)を参照してください。 -## 開発について +## Contributing - 本ソフトウェアはオープンソースですが、開発はオープンではありません。 - 本ソフトウェアは基本的にオープンソースソフトウェアとして「AS IS」（現状有姿のまま）で提供しています。 - 本ソフトウェアに関する無償サポートはありません。 -- バグの修正や誤字脱字の修正に関するリクエストは常に受け付けていますが、 -それ以外の機能追加等のリクエストについては社内のガイドラインを優先します。 +- バグの修正や誤字脱字の修正に関するリクエストは常に受け付けていますが、それ以外の機能追加等のリクエストについては社内のガイドラインを優先します。 詳しくは[コントリビューションガイドライン](./CONTRIBUTING.md)に従ってください。 From babb814038871ffa2164126ebe9a340813b2a5a2 Mon Sep 17 00:00:00 2001 From: Kazushi Kurasawa Date: Tue, 7 Oct 2025 18:17:40 +0900 Subject: [PATCH 02/13] =?UTF-8?q?=E3=83=87=E3=83=90=E3=82=A4=E3=82=B9?= =?UTF-8?q?=E3=81=AE=E3=82=BB=E3=83=83=E3=83=88=E3=82=A2=E3=83=83=E3=83=97?= =?UTF-8?q?=E3=81=AE=E8=A7=A3=E8=AA=AC=E9=A0=86=E3=82=92=E5=A4=89=E6=9B=B4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 6b12be1e..0c991093 100644 --- a/README.md +++ b/README.md @@ -62,15 +62,16 @@ source ~/ros2_ws/install/setup.bash ### Device Setup 以下のコマンドで`sciurus17_control`が実機と通信するために用いるUSBシリアル変換デバイス名を固定します。 -実行後に再起動しSciurus17を接続すると`/dev/sciurus17spine`が作成されるようになります。 ```sh ros2 run sciurus17_tools create_udev_rules ``` +実行後に再起動しSciurus17を接続すると`/dev/sciurus17spine`が作成されるようになります。 + ### Run -次に、以下のコマンドを実行すると、Sciurus17がグリッパ開閉動作をします。 +以下のコマンドを実行すると、Sciurus17がグリッパ開閉動作をします。 ```sh # Connect Sciurus17 to PC, then From bb71fdd5cdf7789a5dbd1f1239598bdd04d9fd8f Mon Sep 17 00:00:00 2001 From: Kazushi Kurasawa Date: Tue, 7 Oct 2025 18:18:03 +0900 Subject: [PATCH 03/13] =?UTF-8?q?=E3=83=88=E3=83=83=E3=83=97=E3=81=AEREADM?= =?UTF-8?q?E.en.md=E3=82=92=E6=95=B4=E5=82=99?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.en.md | 96 ++++++++++++++++++++++++++++++++++------------------ 1 file changed, 64 insertions(+), 32 deletions(-) diff --git a/README.en.md b/README.en.md index cb3b6bdd..a0eb2cb7 100644 --- a/README.en.md +++ b/README.en.md @@ -4,47 +4,41 @@ [![industrial_ci](https://github.com/rt-net/sciurus17_ros/actions/workflows/industrial_ci.yml/badge.svg?branch=ros2)](https://github.com/rt-net/sciurus17_ros/actions/workflows/industrial_ci.yml) -ROS 2 package suite of Sciurus17. +This is a ROS 2 package suite for the Sciurus17. -![sciurus17_gazebo](https://rt-net.github.io/images/sciurus17/sciurus17_gazebo2.png "sciurus17_gazebo") +![sciurus17\_gazebo](https://rt-net.github.io/images/sciurus17/sciurus17_gazebo2.png "sciurus17_gazebo") ## Table of Contents - [sciurus17\_ros](#sciurus17_ros) - [Table of Contents](#table-of-contents) - [Supported ROS 2 distributions](#supported-ros-2-distributions) - - [ROS 1](#ros-1) - [Requirements](#requirements) - [Installation](#installation) - - [Build from source](#build-from-source) - - [Device setup](#device-setup) - [Quick Start](#quick-start) - [Packages](#packages) + - [How ot Use Examples](#how-to-use-examples) - [License](#license) + - [Contributing](#contributing) ## Supported ROS 2 distributions -- [Humble](https://github.com/rt-net/sciurus17_ros/tree/humble) -- [Jazzy](https://github.com/rt-net/sciurus17_ros/tree/jazzy) - -### ROS 1 - -- [Melodic](https://github.com/rt-net/sciurus17_ros/tree/master) -- [Noetic](https://github.com/rt-net/sciurus17_ros/tree/master) +- [Humble Hawksbill](https://github.com/rt-net/sciurus17_ros/tree/humble) +- [Jazzy Jalisco](https://github.com/rt-net/sciurus17_ros/tree/jazzy) ## Requirements - Sciurus17 - [Product page](https://www.rt-net.jp/products/sciurus17) - - [Web Shop](https://www.rt-shop.jp/index.php?main_page=product_info&products_id=3895&language=en) + - [Web shop](https://www.rt-shop.jp/index.php?main_page=product_info&products_id=3895) - Linux OS - Ubuntu 24.04 -- ROS +- ROS 2 - [Jazzy Jalisco](https://docs.ros.org/en/jazzy/Installation.html) ## Installation -### Build from source +### Source Build ```sh # Download packages @@ -55,6 +49,7 @@ git clone -b $ROS_DISTRO https://github.com/rt-net/sciurus17_description.git # Install dependencies rosdep install -r -y -i --from-paths . +sudo apt install libpcl-dev # Build & Install cd ~/ros2_ws @@ -62,9 +57,11 @@ colcon build --symlink-install source ~/ros2_ws/install/setup.bash ``` -### Device setup +## Quick Start + +### Device Setup -Apply udev rules with the following commands to enable communication between `sciurus17_control` and Sciurus17. +Sample programs are available in both C++ and Python. See the links below for details. ```sh ros2 run sciurus17_tools create_udev_rules @@ -73,15 +70,15 @@ ros2 run sciurus17_tools create_udev_rules Reboot the PC after running the script to update the udev rules. After rebooting, the new device `/dev/sciurus17spine` will be created. -## Quick Start +### Run + +The following command makes Sciurus17 open and close its gripper. ```sh # Connect Sciurus17 to PC, then source ~/ros2_ws/install/setup.bash ros2 launch sciurus17_examples demo.launch.py -``` -```sh # Terminal 2 source ~/ros2_ws/install/setup.bash ros2 launch sciurus17_examples example.launch.py example:='gripper_control' @@ -89,28 +86,56 @@ ros2 launch sciurus17_examples example.launch.py example:='gripper_control' # Press [Ctrl-c] to terminate. ``` -Please refer to [./sciurus17_examples/README.md](./sciurus17_examples/README.md). - ## Packages - sciurus17_control - [README](./sciurus17_control/README.md) - - This package includes a hardware driver for Sciurus17. + - Sciurus17の制御を行うパッケージです - sciurus17_examples - [README](./sciurus17_examples/README.md) - - This package includes example codes for Sciurus17. + - Sciurus17のサンプルコード集です +- sciurus17_examples_py + - [README](./sciurus17_examples_py/README.md) + - Sciurus17のPythonサンプルコード集です - sciurus17_gazebo - - This package includes Gazebo simulation environments for Sciurus17. + - Sciurus17のGazeboシミュレーションパッケージです - sciurus17_moveit_config - - This package includes configuration files for `moveit2`. + - Sciurus17の`moveit2`設定ファイルです - sciurus17_tools - - This package includes option tools for Sciurus17. + - Sciurus17を活用するためのオプションツールをまとめたパッケージです - sciurus17_vision - - This package includes launch files for camera nodes. - - [chest_camera_info.yaml](./sciurus17_vision/config/chest_camera_info.yaml) is the chest camera calibration parameter. -- sciurus17_description (external package) - - [README](https://github.com/rt-net/sciurus17_description/blob/ros2/README.en.md) - - This package includes a model data (xacro) of Sciurus17. + - カメラのlaunchファイルや画像認識を行うノードを定義するパッケージです + - 胸部カメラのキャリブレーションパラメータファイルは[chest_camera_info.yaml](./sciurus17_vision/config/chest_camera_info.yaml)です +- sciurus17_description (外部パッケージ) + - [README](https://github.com/rt-net/sciurus17_description/blob/ros2/README.md) + - Sciurus17のモデルデータ（xacro）を定義するパッケージです + +## How to Use Examples + +サンプルプログラムは、C++とPythonの両方を用意しています。詳しくは、以下のリンクをご覧ください。 + +### C++ + +- [sciurus17_examples](./sciurus17_examples/README.md) + - Examples + - gripper_control + - neck_control + - waist_control + - pick_and_place_right_arm_waist + - pick_and_place_left_arm + - head_camera_tracking + - chest_camera_tracking + - point_cloud_detection + +### Python + +- [crane_x7_examples_py](./crane_x7_examples_py/README.md) + - Examples + - gripper_control + - neck_control + - waist_control + - pick_and_place_right_arm_waist + - pick_and_place_left_arm ## License @@ -121,3 +146,10 @@ Unless attributed otherwise, everything in this repository is under the Apache L The sciurus17_ros depends on [sciurus17_description](https://github.com/rt-net/sciurus17_description) package. The RT Corporation's [NON-COMMERCIAL LICENSE](https://github.com/rt-net/sciurus17_description/blob/main/LICENSE) applies to the package. + +## Contributing + +- This software is open source, but its development is not open. +- This software is essentially provided as open source software on an “AS IS” (in its current state) basis. +- No free support is available for this software. +- Requests for bug fixes and corrections of typographical errors are always accepted; however, requests for additional features will be subject to our internal guidelines. For further details, please refer to the [Contribution Guidelines](https://github.com/rt-net/.github/blob/master/CONTRIBUTING.md). From 9d164957a8d27a1254903dda8ddead7e8499ee88 Mon Sep 17 00:00:00 2001 From: Kazushi Kurasawa Date: Thu, 9 Oct 2025 13:53:58 +0900 Subject: [PATCH 04/13] =?UTF-8?q?sciurus17=5Fcontrol=E3=81=AEREADME?= =?UTF-8?q?=E3=82=92=E4=BF=AE=E6=AD=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- sciurus17_control/README.md | 39 +++++++++++++++++++++++++------------ 1 file changed, 27 insertions(+), 12 deletions(-) diff --git a/sciurus17_control/README.md b/sciurus17_control/README.md index 13fd9dae..99a3414b 100644 --- a/sciurus17_control/README.md +++ b/sciurus17_control/README.md @@ -3,7 +3,22 @@ このパッケージは[ros2_control](https://github.com/ros-controls/ros2_control) をベースにした、Sciurus17 のコントローラパッケージです。 -## ros2_control関連ファイル +## Table of Contents + +- [sciurus17\_control](#sciurus17_control) +- [Setup](#setup) + - [USB Port Configuration](#usb-port-configuration) +- [How to Launch Nodes](#how-to-launch-nodes) +- [Controller Manager Parameters](#controller-manager-parameters) + - [Control Cycle](#control-cycle) + - [Controllers](#controllers) +- [sciurus17\_hardware Parameters](#sciurus17_hardware-parameters) + - [USB Port](#usb-port) + - [Baudrate](#baudrate) + - [Communication Timeout](#communication-timeout) + - [Configuration File Paths for RT Manipulator C++ Library](#configuration-file-paths-for-rt-manipulator-c-library) + +## ros2_control Files - `sciurus17_control::Sciurus17Hardware (sciurus17_hardware)` - 本パッケージがエクスポートする[Hardware Components](https://control.ros.org/master/doc/getting_started/getting_started.html#hardware-components)です @@ -14,12 +29,12 @@ - [config/sciurus17_controllers.yaml](./config/sciurus17_controllers.yaml) - Controller Managerのパラメータファイルです -## 実機のセットアップ +## Setup `sciurus17_hardware`がSciurus17実機と通信するために、 PCとSciurus17の設定が必要です。 -### USB通信ポートの設定 +### USB Port Configuration 次の方法で`sciurus17_control`が実機と通信するために用いるUSBシリアル変換デバイス名を固定します。 @@ -29,7 +44,7 @@ ros2 run sciurus17_tools create_udev_rules 実行後に再起動しSciurus17を接続すると`/dev/sciurus17spine`が作成されるようになります。 -## ノードの起動 +## How to Launch Nodes `sciurus17_control.launch.py`を実行すると、`Controller Manager`ノードが起動し、 以下のコントローラが読み込まれます。 @@ -49,7 +64,7 @@ ros2 run sciurus17_tools create_udev_rules ros2 topic echo /joint_states ``` -## Controller Managerのパラメータ +## Controller Manager Parameters `Controller Manager`のパラメータは [config/sciurus17_controllers.yaml](./config/sciurus17_controllers.yaml) @@ -66,11 +81,11 @@ controller_manager: type: position_controllers/GripperActionController ``` -### 制御周期 +### Control Cycle `update_rate`は制御周期を設定します。 -### コントローラ +### Controllers Sciurus17の各関節を制御するコントローラの設定ができます。コントローラの名称と役割の対応は以下のとおりです。 @@ -87,7 +102,7 @@ Sciurus17の各関節を制御するコントローラの設定ができます - waist_yaw_controller - 腰制御用コントローラ -## sciurus17_hardwareのパラメータ +## sciurus17_hardware Parameters `sciurus17_hardware`のパラメータは `sciurus17_description/urdf/sciurus17.urdf.xacro` @@ -100,17 +115,17 @@ Sciurus17の各関節を制御するコントローラの設定ができます ``` -### USB通信ポート +### USB Port `port_name`はSciurus17との通信に使用するUSB通信ポートを設定します。 -### ボーレート +### Baudrate `baudrate`はSciurus17に搭載したDynamixelとの通信ボーレートを設定します。 デフォルト値には`3000000` (3 Mbps)を設定しています。 -### 通信タイムアウト +### Communication Timeout `timeout_seconds`は通信タイムアウト時間（秒）を設定します。 @@ -118,7 +133,7 @@ Sciurus17の各関節を制御するコントローラの設定ができます read/write動作を停止します。 USBケーブルや電源ケーブルが抜けた場合等に有効です。 -### RTマニピュレータC++ライブラリ用の設定ファイルパス +### Configuration File Paths for RT Manipulator C++ Library `sciurus17_hardware`は、Sciurus17と通信するために [RTマニピュレータC++ライブラリ](https://github.com/rt-net/rt_manipulators_cpp) From a51bf66ca73342589504102ea15a18e66ac5a041 Mon Sep 17 00:00:00 2001 From: Kazushi Kurasawa Date: Thu, 9 Oct 2025 14:10:06 +0900 Subject: [PATCH 05/13] =?UTF-8?q?sciurus17\=5Fexamples=E3=81=AE=E3=83=89?= =?UTF-8?q?=E3=82=AD=E3=83=A5=E3=83=A1=E3=83=B3=E3=83=88=E4=BF=AE=E6=AD=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- sciurus17_examples/README.md | 95 +++++++++++++++++------------------- 1 file changed, 46 insertions(+), 49 deletions(-) diff --git a/sciurus17_examples/README.md b/sciurus17_examples/README.md index e585da49..5cfd83d6 100644 --- a/sciurus17_examples/README.md +++ b/sciurus17_examples/README.md @@ -3,16 +3,11 @@ このパッケージはSciurus17 ROS 2パッケージのサンプルコード集です。 - [sciurus17\_examples](#sciurus17_examples) - - [準備（実機を使う場合）](#準備実機を使う場合) - - [1. Sciurus17本体をPCに接続する](#1-sciurus17本体をpcに接続する) - - [2. USB通信ポートの接続を確認する](#2-usb通信ポートの接続を確認する) - - [3. move\_groupとcontrollerを起動する](#3-move_groupとcontrollerを起動する) - - [準備 (Gazeboを使う場合)](#準備-gazeboを使う場合) - - [1. move\_groupとGazeboを起動する](#1-move_groupとgazeboを起動する) - - [準備（Mock Componentsを使う場合）](#準備mock-componentsを使う場合) - - [1. move\_groupとcontrollerを起動する](#1-move_groupとcontrollerを起動する) - - [サンプルプログラムを実行する](#サンプルプログラムを実行する) - - [Gazeboでサンプルプログラムを実行する場合](#gazeboでサンプルプログラムを実行する場合) + - [Setup](#setup) + - [Using Sciurus17](#using-sciurus17) + - [Using Gazebo](#using-gazebo) + - [Using Mock Components](#using-mock-components) + - [How to Run](#how-to-run) - [Examples](#examples) - [gripper\_control](#gripper_control) - [neck\_control](#neck_control) @@ -23,55 +18,54 @@ - [chest\_camera\_tracking](#chest_camera_tracking) - [point\_cloud\_detection](#point_cloud_detection) -## 準備（実機を使う場合） +## Setup + +### Using Sciurus17 + +#### 1. Sciurus17本体をPCに接続する -### 1. Sciurus17本体をPCに接続する Sciurus17本体をPCに接続します。 接続方法は製品マニュアルを参照してください。 -**※Sciurus17本体が接触しないように、十分なスペースを確保してください。** +> [!NOTE] +> Sciurus17本体が接触しないように、十分なスペースを確保してください。 -### 2. USB通信ポートの接続を確認する +#### 2. USB通信ポートの接続を確認する -USB通信ポートの設定については`sciurus17_control`の -[README](../sciurus17_control/README.md) -を参照してください。 +USB通信ポートの設定については`sciurus17_control`の[README](../sciurus17_control/README.md)を参照してください。 -**正しく設定できていない場合、Sciurus17が動作しないので注意してください** +> [!NOTE] +> 正しく設定できていない場合、Sciurus17が動作しないので注意してください。 -### 3. move_groupとcontrollerを起動する +#### 3. move_groupとcontrollerを起動する -次のコマンドでmove_group (`sciurus17_moveit_config`)と -controller (`sciurus17_control`)を起動します。 +次のコマンドでmove_group (`sciurus17_moveit_config`)とcontroller (`sciurus17_control`)を起動します。 ```sh ros2 launch sciurus17_examples demo.launch.py ``` -## 準備 (Gazeboを使う場合) +### Using Gazebo -### 1. move_groupとGazeboを起動する +#### 1. move_groupとGazeboを起動する -次のコマンドでmove_group (`sciurus17_moveit_config`)と -Gazeboを起動します。 +次のコマンドでmove_group (`sciurus17_moveit_config`)とGazeboを起動します。 ```sh ros2 launch sciurus17_gazebo sciurus17_with_table.launch.py ``` -頭部カメラや胸部カメラのシミュレーションを行わない場合は、 -`use_head_camera`、`use_chest_camera`オプションを`false`に設定します。 +頭部カメラや胸部カメラのシミュレーションを行わない場合は、`use_head_camera`、`use_chest_camera`オプションを`false`に設定します。 ```sh ros2 launch sciurus17_gazebo sciurus17_with_table.launch.py use_head_camera:=false use_chest_camera:=false ``` -## 準備（Mock Componentsを使う場合） +### Using Mock Components -### 1. move_groupとcontrollerを起動する +#### 1. move_groupとcontrollerを起動する -次のコマンドでmove_group (`sciurus17_moveit_config`)と -controller (`sciurus17_control`)を起動します。 +次のコマンドでmove_group (`sciurus17_moveit_config`)とcontroller (`sciurus17_control`)を起動します。 ```sh ros2 launch sciurus17_examples demo.launch.py use_mock_components:=true @@ -79,7 +73,7 @@ ros2 launch sciurus17_examples demo.launch.py use_mock_components:=true Mock Componentsではカメラを使ったサンプルを実行することはできません。 -## サンプルプログラムを実行する +## How to Run 準備ができたらサンプルプログラムを実行します。 例えばグリッパを開閉するサンプルは次のコマンドで実行できます。 @@ -90,13 +84,13 @@ ros2 launch sciurus17_examples example.launch.py example:='gripper_control' 終了するときは`Ctrl+c`を入力します。 -### Gazeboでサンプルプログラムを実行する場合 - -Gazeboでサンプルプログラムを実行する場合は`use_sim_time`オプションを付けます。 -```sh -ros2 launch sciurus17_examples example.launch.py example:='gripper_control' use_sim_time:='true' -``` +> [!NOTE] +> Gazeboでサンプルプログラムを実行する場合は`use_sim_time`オプションを付けます。 +> +> ```sh +> ros2 launch sciurus17_examples example.launch.py example:='gripper_control' use_sim_time:='true' +> ``` ## Examples @@ -191,15 +185,16 @@ ros2 launch sciurus17_examples example.launch.py example:='pick_and_place_left_a 頭部カメラ映像を用いてオレンジ色の物体を追従するコード例です。 -Gazeboで実行する場合は動作環境によってうまく追従しない場合があります。 -カメラ解像度やサンプルコード内の追従速度ゲインを調整してください。 - 次のコマンドを実行します。 ```sh ros2 launch sciurus17_examples head_camera_tracking.launch.py ``` +> [!NOTE] +> Gazeboで実行する場合は動作環境によってうまく追従しない場合があります。 +> カメラ解像度やサンプルコード内の追従速度ゲインを調整してください。 + [back to example list](#examples) --- @@ -208,15 +203,16 @@ ros2 launch sciurus17_examples head_camera_tracking.launch.py 胸部カメラ映像を用いてオレンジ色の物体を追従するコード例です。 -Gazeboで実行する場合は動作環境によってうまく追従しない場合があります。 -カメラ解像度やサンプルコード内の追従速度ゲインを調整してください。 - 次のコマンドを実行します。 ```sh ros2 launch sciurus17_examples chest_camera_tracking.launch.py ``` +> [!NOTE] +> Gazeboで実行する場合は動作環境によってうまく追従しない場合があります。 +> カメラ解像度やサンプルコード内の追従速度ゲインを調整してください。 + [back to example list](#examples) --- @@ -225,12 +221,13 @@ ros2 launch sciurus17_examples chest_camera_tracking.launch.py 点群から物体を検出して掴むコード例です。 -検出された物体位置はtfのフレームとして配信されます。 -tfの`frame_id`は検出された順に`target_0`、`target_1`、`target_2`…に設定されます。 -掴む対象はSciurus17前方の0.3 mの範囲にある`target_0`に設定されています。 -物体検出には[Point Cloud Library](https://pointclouds.org/)を使用しています。 +- 検出された物体位置はtfのフレームとして配信されます。 +- tfの`frame_id`は検出された順に`target_0`、`target_1`、`target_2`…に設定されます。 +- 掴む対象はSciurus17前方の0.3 mの範囲にある`target_0`に設定されています。 +- 物体検出には[Point Cloud Library](https://pointclouds.org/)を使用しています。 + +次のコマンドを実行します。 -次のコマンドを実行します ```sh ros2 launch sciurus17_examples camera_example.launch.py example:='point_cloud_detection' ``` From 96e019b6a1a7d6ad454b470aeb6154da22481823 Mon Sep 17 00:00:00 2001 From: Kazushi Kurasawa Date: Thu, 9 Oct 2025 14:15:01 +0900 Subject: [PATCH 06/13] =?UTF-8?q?sciurus17=5Fexamples=5Fpy=E3=81=AEREADME?= =?UTF-8?q?=E4=BF=AE=E6=AD=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- sciurus17_examples_py/README.md | 47 ++++++++++++++++++--------------- 1 file changed, 25 insertions(+), 22 deletions(-) diff --git a/sciurus17_examples_py/README.md b/sciurus17_examples_py/README.md index 78f2f77c..aa0a3d54 100644 --- a/sciurus17_examples_py/README.md +++ b/sciurus17_examples_py/README.md @@ -2,10 +2,12 @@ このパッケージはSciurus17 ROS 2パッケージのPythonサンプルコード集です。 +## Table of Contents + - [sciurus17\_examples](#sciurus17_examples) - - [起動方法](#起動方法) - - [サンプルプログラムを実行する](#サンプルプログラムを実行する) - - [Gazeboでサンプルプログラムを実行する場合](#gazeboでサンプルプログラムを実行する場合) + - [Table of Contents](#table-of-contents) + - [Setup](#setup) + - [How to Run](#how-to-run) - [Examples](#examples) - [gripper\_control](#gripper_control) - [neck\_control](#neck_control) @@ -13,10 +15,11 @@ - [pick\_and\_place\_right\_arm\_waist](#pick_and_place_right_arm_waist) - [pick\_and\_place\_left\_arm](#pick_and_place_left_arm) -## 起動方法 +## Setup + Sciurus17の起動方法は[sciurus17_examplesのREADME](../sciurus17_examples/README.md)を参照してください。 -## サンプルプログラムを実行する +## How to Run 準備ができたらサンプルプログラムを実行します。 例えばグリッパを開閉するサンプルは次のコマンドで実行できます。 @@ -27,13 +30,12 @@ ros2 launch sciurus17_examples_py example.launch.py example:='gripper_control' 終了するときは`Ctrl+c`を入力します。 -### Gazeboでサンプルプログラムを実行する場合 - -Gazeboでサンプルプログラムを実行する場合は`use_sim_time`オプションを付けます。 - -```sh -ros2 launch sciurus17_examples_py example.launch.py example:='gripper_control' use_sim_time:='true' -``` +> [!NOTE] +> Gazeboでサンプルプログラムを実行する場合は`use_sim_time`オプションを付けます。 +> +> ```sh +> ros2 launch sciurus17_examples_py example.launch.py example:='gripper_control' use_sim_time:='true' +> ``` ## Examples @@ -45,11 +47,12 @@ ros2 launch sciurus17_examples_py example.launch.py example:='gripper_control' u - [pick\_and\_place\_right\_arm\_waist](#pick_and_place_right_arm_waist) - [pick\_and\_place\_left\_arm](#pick_and_place_left_arm) -実行できるサンプルの一覧は、`example.launch.py`にオプション`-s`を付けて実行することで表示できます。 - -```sh -ros2 launch sciurus17_examples_py example.launch.py -s -``` +>[!NOTE] +> 実行できるサンプルの一覧は、`example.launch.py`にオプション`-s`を付けて実行することで表示できます。 +> +> ```sh +> ros2 launch sciurus17_examples_py example.launch.py -s +> ``` ### gripper_control @@ -61,7 +64,7 @@ ros2 launch sciurus17_examples_py example.launch.py -s ros2 launch sciurus17_examples_py example.launch.py example:='gripper_control' ``` -[back to example list](#examples) +[Back to example list](#examples) --- @@ -75,7 +78,7 @@ ros2 launch sciurus17_examples_py example.launch.py example:='gripper_control' ros2 launch sciurus17_examples_py example.launch.py example:='neck_control' ``` -[back to example list](#examples) +[Back to example list](#examples) --- @@ -89,7 +92,7 @@ ros2 launch sciurus17_examples_py example.launch.py example:='neck_control' ros2 launch sciurus17_examples_py example.launch.py example:='waist_control' ``` -[back to example list](#examples) +[Back to example list](#examples) --- @@ -103,7 +106,7 @@ ros2 launch sciurus17_examples_py example.launch.py example:='waist_control' ros2 launch sciurus17_examples_py example.launch.py example:='pick_and_place_right_arm_waist' ``` -[back to example list](#examples) +[Back to example list](#examples) --- @@ -117,6 +120,6 @@ ros2 launch sciurus17_examples_py example.launch.py example:='pick_and_place_rig ros2 launch sciurus17_examples_py example.launch.py example:='pick_and_place_left_arm' ``` -[back to example list](#examples) +[Back to example list](#examples) --- From cf5fa55bcf616136caafd33ceb1d483d6127354f Mon Sep 17 00:00:00 2001 From: Kazushi Kurasawa Date: Thu, 9 Oct 2025 14:16:48 +0900 Subject: [PATCH 07/13] =?UTF-8?q?Back=20to=E3=81=AE=E5=85=88=E9=A0=AD?= =?UTF-8?q?=E3=82=92=E5=A4=A7=E6=96=87=E5=AD=97=E3=81=AB=E5=A4=89=E6=9B=B4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- sciurus17_control/README.md | 2 +- sciurus17_examples/README.md | 16 ++++++++-------- 2 files changed, 9 insertions(+), 9 deletions(-) diff --git a/sciurus17_control/README.md b/sciurus17_control/README.md index 99a3414b..fc0e27f6 100644 --- a/sciurus17_control/README.md +++ b/sciurus17_control/README.md @@ -145,4 +145,4 @@ USBケーブルや電源ケーブルが抜けた場合等に有効です。 --- -[back to top](#sciurus17_control) +[Back to top](#sciurus17_control) diff --git a/sciurus17_examples/README.md b/sciurus17_examples/README.md index 5cfd83d6..11090319 100644 --- a/sciurus17_examples/README.md +++ b/sciurus17_examples/README.md @@ -121,7 +121,7 @@ ros2 launch sciurus17_examples example.launch.py -s ros2 launch sciurus17_examples example.launch.py example:='gripper_control' ``` -[back to example list](#examples) +[Back to example list](#examples) --- @@ -135,7 +135,7 @@ ros2 launch sciurus17_examples example.launch.py example:='gripper_control' ros2 launch sciurus17_examples example.launch.py example:='neck_control' ``` -[back to example list](#examples) +[Back to example list](#examples) --- @@ -149,7 +149,7 @@ ros2 launch sciurus17_examples example.launch.py example:='neck_control' ros2 launch sciurus17_examples example.launch.py example:='waist_control' ``` -[back to example list](#examples) +[Back to example list](#examples) --- @@ -163,7 +163,7 @@ ros2 launch sciurus17_examples example.launch.py example:='waist_control' ros2 launch sciurus17_examples example.launch.py example:='pick_and_place_right_arm_waist' ``` -[back to example list](#examples) +[Back to example list](#examples) --- @@ -177,7 +177,7 @@ ros2 launch sciurus17_examples example.launch.py example:='pick_and_place_right_ ros2 launch sciurus17_examples example.launch.py example:='pick_and_place_left_arm' ``` -[back to example list](#examples) +[Back to example list](#examples) --- @@ -195,7 +195,7 @@ ros2 launch sciurus17_examples head_camera_tracking.launch.py > Gazeboで実行する場合は動作環境によってうまく追従しない場合があります。 > カメラ解像度やサンプルコード内の追従速度ゲインを調整してください。 -[back to example list](#examples) +[Back to example list](#examples) --- @@ -213,7 +213,7 @@ ros2 launch sciurus17_examples chest_camera_tracking.launch.py > Gazeboで実行する場合は動作環境によってうまく追従しない場合があります。 > カメラ解像度やサンプルコード内の追従速度ゲインを調整してください。 -[back to example list](#examples) +[Back to example list](#examples) --- @@ -232,6 +232,6 @@ ros2 launch sciurus17_examples chest_camera_tracking.launch.py ros2 launch sciurus17_examples camera_example.launch.py example:='point_cloud_detection' ``` -[back to example list](#examples) +[Back to example list](#examples) --- From 84d2385950e708f9680288cb77b12ea8f3c657f2 Mon Sep 17 00:00:00 2001 From: Kazushi Kurasawa Date: Thu, 9 Oct 2025 14:27:34 +0900 Subject: [PATCH 08/13] =?UTF-8?q?sciurus17=5Fexamples=5Fpy=E3=81=AE?= =?UTF-8?q?=E3=83=AA=E3=83=B3=E3=82=AF=E5=85=88=E3=82=92=E4=BF=AE=E6=AD=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.en.md | 4 ++-- README.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/README.en.md b/README.en.md index a0eb2cb7..e3b77887 100644 --- a/README.en.md +++ b/README.en.md @@ -116,7 +116,7 @@ ros2 launch sciurus17_examples example.launch.py example:='gripper_control' ### C++ -- [sciurus17_examples](./sciurus17_examples/README.md) +- [sciurus17\_examples](./sciurus17_examples/README.md) - Examples - gripper_control - neck_control @@ -129,7 +129,7 @@ ros2 launch sciurus17_examples example.launch.py example:='gripper_control' ### Python -- [crane_x7_examples_py](./crane_x7_examples_py/README.md) +- [sciurus17\_examples\_py](./sciurus17_examples_py/README.md) - Examples - gripper_control - neck_control diff --git a/README.md b/README.md index 0c991093..d6d27519 100644 --- a/README.md +++ b/README.md @@ -115,7 +115,7 @@ ros2 launch sciurus17_examples example.launch.py example:='gripper_control' ### C++ -- [sciurus17_examples](./sciurus17_examples/README.md) +- [sciurus17\_examples](./sciurus17_examples/README.md) - Examples - gripper_control - neck_control @@ -128,7 +128,7 @@ ros2 launch sciurus17_examples example.launch.py example:='gripper_control' ### Python -- [crane_x7_examples_py](./crane_x7_examples_py/README.md) +- [sciurus17\_examples\_py](./sciurus17_examples_py/README.md) - Examples - gripper_control - neck_control From 8a7cceb6a01692b669bbf305a1065207aa961031 Mon Sep 17 00:00:00 2001 From: Kazushi Kurasawa Date: Mon, 27 Oct 2025 16:05:55 +0900 Subject: [PATCH 09/13] =?UTF-8?q?C++=E3=81=AEexamples=E3=81=AE=E3=82=AA?= =?UTF-8?q?=E3=83=97=E3=82=B7=E3=83=A7=E3=83=B3=E8=AA=AC=E6=98=8E=E3=82=92?= =?UTF-8?q?NOTE=E3=81=A7=E5=9B=B2=E3=81=BF=E3=81=BE=E3=81=97=E3=81=9F?= =?UTF-8?q?=E3=80=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- sciurus17_examples/README.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/sciurus17_examples/README.md b/sciurus17_examples/README.md index 11090319..7955bbbc 100644 --- a/sciurus17_examples/README.md +++ b/sciurus17_examples/README.md @@ -55,11 +55,12 @@ ros2 launch sciurus17_examples demo.launch.py ros2 launch sciurus17_gazebo sciurus17_with_table.launch.py ``` -頭部カメラや胸部カメラのシミュレーションを行わない場合は、`use_head_camera`、`use_chest_camera`オプションを`false`に設定します。 - -```sh -ros2 launch sciurus17_gazebo sciurus17_with_table.launch.py use_head_camera:=false use_chest_camera:=false -``` +> [!NOTE] +> 頭部カメラや胸部カメラのシミュレーションを行わない場合は、`use_head_camera`、`use_chest_camera`オプションを`false`に設定します。 +> +> ```sh +> ros2 launch sciurus17_gazebo sciurus17_with_table.launch.py use_head_camera:=false use_chest_camera:=false +> ``` ### Using Mock Components From 83086e937f9a6b24fd0006e049e7fa20be2ef308 Mon Sep 17 00:00:00 2001 From: Kazushi Kurasawa Date: Mon, 27 Oct 2025 16:37:09 +0900 Subject: [PATCH 10/13] =?UTF-8?q?README.en.md=E5=86=85=E3=81=A7=E6=97=A5?= =?UTF-8?q?=E6=9C=AC=E8=AA=9E=E3=81=AB=E3=81=AA=E3=81=A3=E3=81=A6=E3=81=84?= =?UTF-8?q?=E3=81=9F=E7=AE=87=E6=89=80=E3=82=92=E8=8B=B1=E8=AA=9E=E3=81=AB?= =?UTF-8?q?=E5=A4=89=E6=9B=B4=E3=81=97=E3=80=81USB=E3=81=AB=E9=96=A2?= =?UTF-8?q?=E3=81=99=E3=82=8B=E8=A8=98=E8=BF=B0=E3=82=92=E8=BF=BD=E5=8A=A0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.en.md | 23 ++++++++++++----------- README.md | 3 ++- 2 files changed, 14 insertions(+), 12 deletions(-) diff --git a/README.en.md b/README.en.md index e3b77887..8b514c76 100644 --- a/README.en.md +++ b/README.en.md @@ -90,29 +90,30 @@ ros2 launch sciurus17_examples example.launch.py example:='gripper_control' - sciurus17_control - [README](./sciurus17_control/README.md) - - Sciurus17の制御を行うパッケージです + - This package provides a hardware driver for Sciurus17. + - The procedure for configuring the USB communication port is described in the README. - sciurus17_examples - [README](./sciurus17_examples/README.md) - - Sciurus17のサンプルコード集です + - This package provides C++ examples for Sciurus17. - sciurus17_examples_py - [README](./sciurus17_examples_py/README.md) - - Sciurus17のPythonサンプルコード集です + - This package provides Python examples for Sciurus17. - sciurus17_gazebo - - Sciurus17のGazeboシミュレーションパッケージです + - This package provides Gazebo simulation environments for Sciurus17. - sciurus17_moveit_config - - Sciurus17の`moveit2`設定ファイルです + - This package provides configuration files for `MoveIt2`. - sciurus17_tools - - Sciurus17を活用するためのオプションツールをまとめたパッケージです + - This package provides optional tools for Sciurus17. - sciurus17_vision - - カメラのlaunchファイルや画像認識を行うノードを定義するパッケージです - - 胸部カメラのキャリブレーションパラメータファイルは[chest_camera_info.yaml](./sciurus17_vision/config/chest_camera_info.yaml)です -- sciurus17_description (外部パッケージ) + - This package provides launch files for camera nodes. + - [chest_camera_info.yaml](./sciurus17_vision/config/chest_camera_info.yaml) containes the chest camera calibration parameter. +- sciurus17_description (external package) - [README](https://github.com/rt-net/sciurus17_description/blob/ros2/README.md) - - Sciurus17のモデルデータ（xacro）を定義するパッケージです + - This package provides the model data (xacro) of Sciurus17. ## How to Use Examples -サンプルプログラムは、C++とPythonの両方を用意しています。詳しくは、以下のリンクをご覧ください。 +Sample programs are available in both C++ and Python. See the links below for details. ### C++ diff --git a/README.md b/README.md index d6d27519..187e2918 100644 --- a/README.md +++ b/README.md @@ -90,6 +90,7 @@ ros2 launch sciurus17_examples example.launch.py example:='gripper_control' - sciurus17_control - [README](./sciurus17_control/README.md) - Sciurus17の制御を行うパッケージです + - USB通信ポートの設定方法をREAMDEに記載しています - sciurus17_examples - [README](./sciurus17_examples/README.md) - Sciurus17のサンプルコード集です @@ -107,7 +108,7 @@ ros2 launch sciurus17_examples example.launch.py example:='gripper_control' - 胸部カメラのキャリブレーションパラメータファイルは[chest_camera_info.yaml](./sciurus17_vision/config/chest_camera_info.yaml)です - sciurus17_description (外部パッケージ) - [README](https://github.com/rt-net/sciurus17_description/blob/ros2/README.md) - - Sciurus17のモデルデータ（xacro）を定義するパッケージです + - Sciurus17のモデルデータ（xacroファイル）を定義するパッケージです ## How to Use Examples From 2ddbb63a1eb9a4245697edcd4113951e6c416d64 Mon Sep 17 00:00:00 2001 From: Kazushi Kurasawa Date: Tue, 28 Oct 2025 10:26:02 +0900 Subject: [PATCH 11/13] =?UTF-8?q?"MoveIt2"=E3=81=AE=E8=A1=A8=E8=A8=98?= =?UTF-8?q?=E3=82=92"MoveIt=202"=E3=81=AB=E4=BF=AE=E6=AD=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.en.md | 2 +- README.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/README.en.md b/README.en.md index 8b514c76..8a382891 100644 --- a/README.en.md +++ b/README.en.md @@ -101,7 +101,7 @@ ros2 launch sciurus17_examples example.launch.py example:='gripper_control' - sciurus17_gazebo - This package provides Gazebo simulation environments for Sciurus17. - sciurus17_moveit_config - - This package provides configuration files for `MoveIt2`. + - This package provides configuration files for `MoveIt 2`. - sciurus17_tools - This package provides optional tools for Sciurus17. - sciurus17_vision diff --git a/README.md b/README.md index 187e2918..04aed419 100644 --- a/README.md +++ b/README.md @@ -100,7 +100,7 @@ ros2 launch sciurus17_examples example.launch.py example:='gripper_control' - sciurus17_gazebo - Sciurus17のGazeboシミュレーションパッケージです - sciurus17_moveit_config - - Sciurus17の`moveit2`設定ファイルです + - Sciurus17の`MoveIt 2`設定ファイルです - sciurus17_tools - Sciurus17を活用するためのオプションツールをまとめたパッケージです - sciurus17_vision @@ -108,7 +108,7 @@ ros2 launch sciurus17_examples example.launch.py example:='gripper_control' - 胸部カメラのキャリブレーションパラメータファイルは[chest_camera_info.yaml](./sciurus17_vision/config/chest_camera_info.yaml)です - sciurus17_description (外部パッケージ) - [README](https://github.com/rt-net/sciurus17_description/blob/ros2/README.md) - - Sciurus17のモデルデータ（xacroファイル）を定義するパッケージです + - Sciurus17のモデルデータ（xacro）を定義するパッケージです ## How to Use Examples From 21f41961a4a3d5b78cb87cbde0f058e9f988f873 Mon Sep 17 00:00:00 2001 From: Kazushi Kurasawa Date: Thu, 30 Oct 2025 11:29:03 +0900 Subject: [PATCH 12/13] =?UTF-8?q?=E3=83=AA=E3=83=9D=E3=82=B8=E3=83=88?= =?UTF-8?q?=E3=83=AA=E3=83=88=E3=83=83=E3=83=97=E3=81=AEREADME=E3=81=AE?= =?UTF-8?q?=E3=82=B5=E3=83=B3=E3=83=97=E3=83=AB=E3=81=AE=E5=88=97=E6=8C=99?= =?UTF-8?q?=E3=82=92=E5=89=8A=E9=99=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.en.md | 26 ++++---------------------- README.md | 26 ++++---------------------- 2 files changed, 8 insertions(+), 44 deletions(-) diff --git a/README.en.md b/README.en.md index 8a382891..ad48edcd 100644 --- a/README.en.md +++ b/README.en.md @@ -115,28 +115,10 @@ ros2 launch sciurus17_examples example.launch.py example:='gripper_control' Sample programs are available in both C++ and Python. See the links below for details. -### C++ - -- [sciurus17\_examples](./sciurus17_examples/README.md) - - Examples - - gripper_control - - neck_control - - waist_control - - pick_and_place_right_arm_waist - - pick_and_place_left_arm - - head_camera_tracking - - chest_camera_tracking - - point_cloud_detection - -### Python - -- [sciurus17\_examples\_py](./sciurus17_examples_py/README.md) - - Examples - - gripper_control - - neck_control - - waist_control - - pick_and_place_right_arm_waist - - pick_and_place_left_arm +- C++ + - [sciurus17\_examples](./sciurus17_examples/README.md) +- Python + - [sciurus17\_examples\_py](./sciurus17_examples_py/README.md) ## License diff --git a/README.md b/README.md index 04aed419..e6a7d8ea 100644 --- a/README.md +++ b/README.md @@ -114,28 +114,10 @@ ros2 launch sciurus17_examples example.launch.py example:='gripper_control' サンプルプログラムは、C++とPythonの両方を用意しています。詳しくは、以下のリンクをご覧ください。 -### C++ - -- [sciurus17\_examples](./sciurus17_examples/README.md) - - Examples - - gripper_control - - neck_control - - waist_control - - pick_and_place_right_arm_waist - - pick_and_place_left_arm - - head_camera_tracking - - chest_camera_tracking - - point_cloud_detection - -### Python - -- [sciurus17\_examples\_py](./sciurus17_examples_py/README.md) - - Examples - - gripper_control - - neck_control - - waist_control - - pick_and_place_right_arm_waist - - pick_and_place_left_arm +- C++ + - [sciurus17\_examples](./sciurus17_examples/README.md) +- Python + - [sciurus17\_examples\_py](./sciurus17_examples_py/README.md) ## License From e4662d5a5e890687a678cc693c95f640d79842c5 Mon Sep 17 00:00:00 2001 From: Kazushi Kurasawa Date: Thu, 30 Oct 2025 11:32:03 +0900 Subject: [PATCH 13/13] =?UTF-8?q?CONTRIBUTING.md=E3=82=92=E5=89=8A?= =?UTF-8?q?=E9=99=A4=E3=81=97=E3=80=81=E3=83=AA=E3=83=B3=E3=82=AF=E5=85=88?= =?UTF-8?q?=E3=82=92rt-net/.github=E3=81=AB=E5=A4=89=E6=9B=B4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- CONTRIBUTING.md | 26 -------------------------- README.en.md | 2 +- README.md | 2 +- 3 files changed, 2 insertions(+), 28 deletions(-) delete mode 100644 CONTRIBUTING.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md deleted file mode 100644 index b234fdcf..00000000 --- a/CONTRIBUTING.md +++ /dev/null @@ -1,26 +0,0 @@ -# Contribution Guide - -本リポジトリへのコントリビュート方法について記載しています。 - -## Issues - -リポジトリの品質向上にご協力頂きありがとうございます。 - -Issueの作成を簡単にするテンプレートを用意しているので活用してください。 - -## Pull Requests - -Pull Requestの作成ありがとうございます。 -提出したPull Request（PR）には次のルールが適用されます。 - -- PRの内容には本リポジトリのライセンス（[LICENSE](./LICENSE)と[README.md](./README.md)に記載されています）が適用されます -- PRは`rt-net`のメンバーによるレビューを経てからマージされます - - すべてのPRがマージされるわけではなく、希望に添えない場合もありますのでご容赦ください -- リポジトリにテストが設定されている場合はできるだけテストを通してください - - 何かしらの理由（テストに間違いがある場合など）でテストを通さずPRを出す場合はその旨をPRに記載してください -- マージする際にはPR内の全コミットが1つのコミットに`squash`されます - - [コミットをスカッシュしてマージする | GitHub Docs](https://docs.github.com/ja/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/about-pull-request-merges#squash-and-merge-your-commits) -- 1つのPRでリクエストする変更はできるだけシンプルにしてください - - 異なる内容の変更を含む場合はPRを分割してください - - 例えば、複数の機能追加したり、機能追加とリファクタリングを同時にする場合はそれぞれ別々のPRとしてください - - squashマージしても履歴を辿りやすくするためです \ No newline at end of file diff --git a/README.en.md b/README.en.md index ad48edcd..59b6795f 100644 --- a/README.en.md +++ b/README.en.md @@ -135,4 +135,4 @@ The RT Corporation's [NON-COMMERCIAL LICENSE](https://github.com/rt-net/sciurus1 - This software is open source, but its development is not open. - This software is essentially provided as open source software on an “AS IS” (in its current state) basis. - No free support is available for this software. -- Requests for bug fixes and corrections of typographical errors are always accepted; however, requests for additional features will be subject to our internal guidelines. For further details, please refer to the [Contribution Guidelines](https://github.com/rt-net/.github/blob/master/CONTRIBUTING.md). +- Requests for bug fixes and corrections of typographical errors are always accepted; however, requests for additional features will be subject to our internal guidelines. For further details, please refer to the [Contribution Guidelines](https://github.com/rt-net/.github/blob/master/CONTRIBUTING.md#contribution-guide-en). diff --git a/README.md b/README.md index e6a7d8ea..d491c4f0 100644 --- a/README.md +++ b/README.md @@ -136,4 +136,4 @@ ros2 launch sciurus17_examples example.launch.py example:='gripper_control' - 本ソフトウェアは基本的にオープンソースソフトウェアとして「AS IS」（現状有姿のまま）で提供しています。 - 本ソフトウェアに関する無償サポートはありません。 - バグの修正や誤字脱字の修正に関するリクエストは常に受け付けていますが、それ以外の機能追加等のリクエストについては社内のガイドラインを優先します。 -詳しくは[コントリビューションガイドライン](./CONTRIBUTING.md)に従ってください。 +詳しくは[コントリビューションガイドライン](https://github.com/rt-net/.github/blob/master/CONTRIBUTING.md#contribution-guide-ja)に従ってください。