burger_war

ロボットで戦車対戦をするゲームです。大砲で撃つ代わりに、カメラでターゲットのARマーカーを読み取ります。

インストール

burger_warには実機とシミュレータがあります。

1. ros (kinetic) のインストール

rosのインストールが終わっている人は2.このリポジトリをクローン まで飛ばしてください。

参考 ROS公式サイトhttp://wiki.ros.org/ja/kinetic/Installation/Ubuntu 上記サイトと同じ手順です。 ros インストール

sudo sh -c 'echo "deb http://packages.ros.org/ros/ubuntu $(lsb_release -sc) main" > /etc/apt/sources.list.d/ros-latest.list'
sudo apt-key adv --keyserver 'hkp://ha.pool.sks-keyservers.net:80' --recv-key C1CF6E31E6BADE8868B172B4F42ED6FBAB17C654
sudo apt-get update
sudo apt-get install ros-kinetic-desktop-full

環境設定

sudo rosdep init
rosdep update
echo "source /opt/ros/kinetic/setup.bash" >> ~/.bashrc
source ~/.bashrc

ワークスペース作成

参考http://wiki.ros.org/ja/catkin/Tutorials/create_a_workspace

mkdir -p ~/catkin_ws/src
cd ~/catkin_ws/src
catkin_init_workspace
cd ~/catkin_ws/
catkin_make
echo "source ~/catkin_ws/devel/setup.bash" >> ~/.bashrc
source ~/.bashrc

2. このリポジトリをクローン

gitをインストールします。

sudo apt-get install git

turtlr_war リポジトリをクローンします。先程作ったワークスペースのsrc/の下においてください。

cd ~/catkin_ws/src
git clone https://github.com/OneNightROBOCON/burger_war

このリポジトリのフィールド用のGAZEBOモデルにPATHを通す

export GAZEBO_MODEL_PATH=$HOME/catkin_ws/src/burger_war/burger_war/models/

シェルごとに毎回実行するのは面倒なので上記は~/.bashrcに書いておくと便利です｡

3. 依存ライブラリのインストール

pip : pythonのパッケージ管理ツール
requests : HTTP lib
flask : HTTP server 審判サーバーで使用
turtlebot3
aruco

# pip のインストール 
sudo apt-get install python-pip
#　requests flask のインストール
sudo pip install requests flask
# turtlebot3 ロボットモデルのインストール
sudo apt-get install ros-kinetic-turtlebot3 ros-kinetic-turtlebot3-msgs ros-kinetic-turtlebot3-simulations
# aruco (ARマーカー読み取りライブラリ）
sudo apt-get install ros-kinetic-aruco-ros

5. make

cd ~/catkin_ws
catkin_make

インストールは以上です。

サンプルの実行

シミュレータ

シミュレータ､ロボット(turtle_bot),審判サーバー､観戦画面のすべてを一発で起動する。大会で使用するスクリプト。最初にburger_warのフォルダまで移動します。

cd ~/catkin_ws/src/burger_war

初回のみ、以下のコマンドでGazeboを起動し、モデルデータ等を読み込んでおくとよいです。
(初回はGazeboの起動がおそいので)

gazebo

次にシミュレーションを起動

bash scripts/sim_with_judge.sh

フィールドとロボットが立ち上がったら別のターミナルで下記ロボット動作スクリプトを実行

bash scripts/start.sh

↑このようなフィールドが現れロボットが2台出現します。審判画面も表示されます。

審判サーバーを立ち上げずにシミュレータとロボットのみ立ち上げる場合

roslaunch burger_war　setup_sim.launch

フィールドとロボットが立ち上がったら別のターミナルで下記ロボット動作スクリプトを実行

bash scripts/start.sh

審判サーバー以外は上記と同じです。

実機

センサなどが立ち上がりロボットを動かす準備 burger_war setup.launch 引数

side: (default: 'b') ロボットが赤サイドか青サイドか表す引数。赤サイドと青サイドによって戦略やパラメータを切り替えるためなどに使用する。赤サイドなら r 青サイドなら b
robot_name: (default: '' ) ロボットのネームスペースを分けるときに使用する。　赤サイドならred_bot, 青サイドならblue_bot
ip: (default:'http://localhost:5000') 審判サーバーのアドレス。

roslaunch burger_war setup.launch ip:=http://127.0.0.1:5000 side:=r

審判サーバーを使わない走行テストのみの場合は引数は省略可

roslaunch burger_war setup.launch

別のターミナルでロボットを動かすノードを起動 burger_war your_burger.launch

引数

side: (default: 'b') ロボットが赤サイドか青サイドか表す引数。赤サイドと青サイドによって戦略やパラメータを切り替えるためなどに使用する。赤サイドなら r 青サイドなら b
robot_name: (default: "" ) ロボットのネームスペースを分けるときに使用する。　赤サイドならred_bot, 青サイドならblue_bot

赤サイドの場合

roslaunch burger_war your_burger.launch side:=r

青サイドの場合

roslaunch burger_war your_burger.launch side:=b

サンプルについて補足

your_burger.launchの引数robot_name sideについてその経緯を補足する。シミュレーターでは1つのGAZEBOシミュレーター内で2台のロボット動かしている。しかしGAZEBOサーバーとROSMASTERは1:1に対応していて1つのGAZEBOサーバーに2つ以上のROSMASTERを接続することができなかった。(方法知っている人いたら教えて下さい。)そのため、1つのROSMASTERで、別々のネームスペースを使って2台のロボットを動かしている。赤サイドのロボットをred_bot, 青サイドのロボットをblue_botとしている。これらネームスペースはやり取りされるトピック及び、座標系を表すTFにも反映する必要がある。ロボットのネームスペースはrobot_nameという名前の引数でlaunchファイルに渡される。

実機の場合は上記のような制約はないためネームスペースは使用しない。robot_name:=''というようにネームスペースを表す引数は空で実行される。

sideは審判サーバーに対して、どちらサイドのロボットか宣言するため、および、赤サイドと青サイドによって戦略やパラメータを変更する用途を想定したパラメータである。以前はyour_burger.launchの引数にsideはなく、robot_nameがred_botかblue_botかによって自分のサイドを判断するようにしていたが、このあたりの引数の役割を整理した結果robot_name sideに分割をした。赤サイドと青サイドによって戦略やパラメータを変更する用途にはsideを使うようにしてもらいたい。実機での動作の場合robot_nameは空で実行されるためである。

審判サーバー

審判サーバーはjudge/以下にありますそちらのREADMEを参照ください

ファイル構成

各ディレクトリの役割と、特に参加者に重要なファイルについての説明

下記のようなディレクトリ構成になっています。

burger_war
├── burger_war
│   ├── CMakeLists.txt
│   ├── launch  launchファイルの置き場
│   │   ├── sim_robot_run.launch  シミュレータ上で２台のロボットを動かすlaunchファイル
│   │   └─ setup_sim.launch  Gazeboシミュレータ上でフィールドの生成ロボットを起動、初期化するlaunchファイル
│   │
│   ├── models   GAZEBOシミュレーター用のモデルファイル
│   ├── package.xml
│   ├── scripts    pythonで書かれたROSノード
│   └── world     GAZEBO用の環境ファイル
│       ├── gen.sh          burger_field.world.emから burger_field.worldを作成するスクリプト
│       ├── burger_field.world  最新のworldファイル
│       └── burger_field.world.em  worldファイルのマクロ表記版､こっちを編集する
|
├── judge   審判サーバー
│   ├── judgeServer.py  審判サーバー本体
│   ├── log   ログがここにたまる
│   ├── marker_set  マーカーの配置設定ファイル置き場
│   ├── picture  観戦画面用画像素材
│   ├── README.md  
│   ├── test_scripts   初期化などのスクリプト
│   └── visualizeWindow.py  観戦画面表示プログラム
|
├── README.md   これ
├── rulebook.md  ルールブック
└── scripts      一発起動スクリプト
    ├─── sim_with_judge.sh   シミュレーターとロボットと審判サーバーの立ち上げ初期化をすべて行う
    └──  start.sh             赤サイド、青サイドのロボットを動作させるノードを立ち上げるスクリプト

↑ディレクトリと特に重要なファイルのみ説明しています。

推奨動作環境

Ubuntu 16.04
Ros kinetic 2018年からkineticで開発しています｡

Turtlebot3のスペック

http://emanual.robotis.com/docs/en/platform/turtlebot3/specifications/

その他

https://github.com/gogo5nta さんに一括でインストールするスクリプトを作成いただいたので本リポジトリにも置いています。ご活用ください。

// ROS(kinetic)を一括インストール
$ chdmod 777 ./scripts/install_ros_kinetic.sh
$ ./scripts/install_ros_kinetic.sh

// Robocon2019に必要な物を一括インストール
$ chdmod 777 ./scripts/add_robocon2019.sh
$ ./scripts/add_robocon2019.sh

Name		Name	Last commit message	Last commit date
Latest commit History 256 Commits
burger_navigation		burger_navigation
burger_war		burger_war
doc		doc
judge		judge
scripts		scripts
.gitattributes		.gitattributes
.gitignore		.gitignore
QA.md		QA.md
README.md		README.md
rulebook.md		rulebook.md

ttyama/burger_war

Folders and files

Latest commit

History

Repository files navigation

burger_war

目次

インストール

1. ros (kinetic) のインストール

2. このリポジトリをクローン

3. 依存ライブラリのインストール

5. make

サンプルの実行

シミュレータ

実機

サンプルについて補足

審判サーバー

ファイル構成

推奨動作環境

Turtlebot3のスペック

その他

About

Resources

Stars

Watchers

Forks

Languages