Skip to content

Commit

Permalink
docs: add README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
KazuyaOguma18 committed Feb 16, 2025
1 parent c2a9c96 commit 45bb9cd
Show file tree
Hide file tree
Showing 3 changed files with 76 additions and 2 deletions.
4 changes: 2 additions & 2 deletions .github/workflows/deploy-docs.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ jobs:

- name: Get self package paths
id: get-self-package-paths
uses: Closer-Robotics/closer-github-actions/get-self-package-paths@v1
uses: autowarefoundation/autoware-github-actions/get-self-package-paths@v1

build:
runs-on: ubuntu-24.04
Expand All @@ -29,7 +29,7 @@ jobs:
uses: actions/checkout@v4

- name: Build docs
uses: Closer-Robotics/closer-github-actions/build-docs@v1
uses: autowarefoundation/autoware-github-actions/build-docs@v1
with:
target-package-paths: ${{ needs.get-paths.outputs.self-package-paths }}

Expand Down
74 changes: 74 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,74 @@
# mofpy_ros2

<div style="margin: 0 auto" >
<img src="docs/logo.png" alt="Logo of mofpy" />
</div>

## What is mofpy

mofpyは,ジョイパッドの入力から汎用的にアクションを実行できるROS 2ノードです.

ROS1版は,[こちら](https://github.com/naoki-mizuno/mofpy/tree/master)にあり,これをベースにROS 2用に開発したものがこちらのリポジトリになります.

<!-- ここにMofpyの動作イメージ図を入れる -->

## Continue Integration Status

[![CI (Jazzy)](https://github.com/KazuyaOguma18/mofpy_ros2/actions/workflows/build-and-test.yaml/badge.svg?branch=main)](https://github.com/KazuyaOguma18/mofpy_ros2/actions/workflows/build-and-test.yaml?query=branch%3Amain)

## Getting Started

### Installation

ROS 2のインストールが完了していることを前提とします.
ROS 2インストール手順は[こちら](https://docs.ros.org/en/jazzy/Installation.html)を参照してください.

```bash
git clone https://github.com/KazuyaOguma18/mofpy_ros2.git
cd mofpy_ros2
sudo apt install just python3-rosdep
just deps
just build
```

### Usage

```bash
source install/setup.bash
ros2 launch mofpy_demo mofpy_demo.launch.py
```

## Packages

### mofpy

mofpyのROS 2ノードが含まれています.
実装はすべてこのパッケージ内に記述されています.

### mofpy_demo

mofpyのデモ用のパッケージです.
launchファイルや設定ファイルが含まれています.

### moveit_py_configs_utils

moveit_setup_assistantで生成されたMoveItの設定ファイルをMoveItPyで読み込むためのユーティリティパッケージです.
[moveit_configs_utils](https://github.com/moveit/moveit2/tree/main/moveit_configs_utils)を一部改変したものです.

## Supported Joypads

- [x] DualShock (PS4)
- [] DualSense (PS5) comming soon ...

## Supported Actions

[mofpy/mofpy/action](https://github.com/KazuyaOguma18/mofpy_ros2/tree/main/mofpy/mofpy/action) にこれらの実装があります

| Action | Description |
| ------------------- | -------------------------------------- |
| moveit_named_target | MoveItの名前付きターゲットを実行します |
| moveit_servo_joint | MoveIt ServoのFKを実行します |
| moveit_servo_twist | MoveIt ServoのIKを実行します |
| publish | 任意のトピックにメッセージを送信します |
| shared_list | 配列型の共有変数を操作します |
| shared_value | スカラー型の共有変数を操作します |
Binary file added docs/logo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 45bb9cd

Please sign in to comment.