[Documentation] [TitleIndex] [WordIndex

ROS Command-line tools

一般的なユーザツール

以下のツールは$ROS_ROOTで上位レベルのmakeが呼び出された時にビルドされます。これらのツールは$ROS_ROOT/binにインストールされ、その過程でPATH変数に追加されます。もし追加されていなければ、インストールガイドをご覧下さい。

rosbag

rosbag はROS bag files上で様々な操作を行うことのできるコマンドラインツールです。再生や記録、実証を行うことができます。

rosbash

rosbash はコマンドではなく、コマンドとその機能の集合です。使用するためには、rosbashのファイルに以下のソースを追加する必要がありますが、インストールガイドに従ってインストールを行えば、bashrcファイルに自動的に追加されます。

source $ROS_ROOT/tools/rosbash/rosbash

rosbashはroscdrosed を含み、加えてroscd, rosed, rosmake, rosrunにTabによる補完機能の提供をします。

roscd

roscdrosbash のうちの一つです. このコマンドにより、パスを知らなくてもパッケージやスタック、または共通の場所に移動することができます。

使用法:

roscd locationname[/subdir]

例:

roscd roscpp/include

引数を指定せずにroscdを使用した場合、$ROS_ROOTに移動します. パッケージやスタック、いくつかの共通の場所の他、ログやテスト結果にも直接移動することができます。

上級者向けですが、$ROS_LOCATIONSの環境変数を変更することで、自分の指定したキーワードでroscdを使用することができるようになります。具体的には、以下のようにroscdのパスに指定したいキーワードと場所をセットにしてコロンで区切ったリストを$ROS_LOCATIONSに追加します。

export $ROS_LOCATIONS="rospkg=/path/to/rospkg:stairpkg=/path/to/stairpkg"

ROS-0.8以前では、パッケージのキーワードを用いて$ROS_PACKAGE_PATHに記載されている中の最初のディレクトリに移動することができました。この機能は以下のような文を追加することで実現できます。

export $ROS_LOCATIONS="pkg=$ROS_PACKAGE_PATH"

rosclean

New in C Turtle

ROSによって作成されたファイルシステム(例:ログファイル)のリソースを削除します。詳しくはroscleanをご覧下さい。

roscore

roscoreはROSのコアとなるStack (Master, Parameter Server, rosout, etc...)を実行します.

rosdep

rosdepにあるように、依存しているシステムをインストールします。

使用法:

rosdep install PACKAGE_NAME

rosed

rosedrosbash の一つです. このコマンドを使えば、ファイルのパスを調べなくても、パッケージ名とその中のファイル名を指定することで直接ファイルを編集することができます。

使用法:

rosed packagename filename

例:

rosed roscpp ros.h

もしパッケージの中に同じ名前のファイルが複数ある場合、メニューによって編集したいファイルを選択することができます。

rosed$EDITOR の環境変数に設定されたエディターにより開かれます。デフォルトではvimによって開かれます。

roscreate-pkg

roscreate-pkg コマンドでは Manifest, CMakeLists, Doxygen やROSのパッケージに必要なファイルを新しく作成します。これはroscreate packageの一部です。

roscreate-stack

roscreate-stack コマンドでは Stack Manifest, CMakeLists やROSのスタックを作成するのに必要なファイルを新たに作成します。これはroscreate packageの一部です

rosrun

rosrun コマンドは任意のパッケージの中の実行可能なファイルを実行します。このときそのファイルがある場所にcdやroscdを使って移動する必要はありません。

使用法:

rosrun package executable

例:

rosrun roscpp_tutorials talker

roslaunch

roslaunch XML形式の設定ファイルに記載されているノードを開始します。また、リモートマシンでの実行もサポートしています。より詳細に知りたいときはroslaunch pageをご覧下さい。

roslocate

ROS 1.4では使用されていません: 現在はrosinstall の一部の機能となっています

roslocate コマンドはROS パッケージが保存されているレポジトリ(例えば、roslocate svn tf)を探し出します。これにより簡単にパッケージ中のソースをチェックアウトできます。svn co `roslocate svn tf` 詳しくはroslocate pageをご覧下さい。

rosmake

rosmakeをご覧下さい。

rosmsg

rosmsgMessage のデータ構造を表示します。詳しくは rosmsg pageをご覧下さい。

rosnode

rosnode 実行中のノード情報を表示します。また、ノード間の接続を確認することもできます。詳しくは[rosnode|rosnode page]]をご覧下さい。

rospack

rospack をご覧下さい.

rosparam

rosparam はYAML形式でコードされたテキストによってコマンドラインからサーバー側の変数に値をセットしたり、取得したりすることができます。

rossrv

rossrv はService srv のデータ構造を表示します。詳しくは rossrv page をご覧下さい。

rosservice

rosservice は実行中の Services の情報を表示します。また、トピックに送られたメッセージを表示することもできます。詳しくはrosservice pageをご覧下さい。

rosstack

rosstack をご覧下さい.

rostopic

rostopic は実行中の Topics の情報を表示します。また、トピックに送られたメッセージを表示することもできます。詳しくは rostopic pageをご覧下さい。

rosversion

New in Diamondback

ROS stackのバージョンを表示します.

描画ツール

ROSに含まれる描画ツールは使用する前にgraphvizやPython GTKといった依存関係を追加する必要があります。 これらの依存関係はbash <(rosdep satisfy PACKAGE_NAME)を使用することによって素早くインストールすることができます。

rxbag

rxbag はROS bag files中にあるデータを見ることのできる描画ツールです。

rxdeps

rxdeps はROSの依存関係の記された PDFを作成します。

rxgraph

rxgraph はROSのノードとトピックの相互関係を示したグラフを表示します。詳しくはrosgraphをご覧下さい。

rxplot

rxplot はROS トピックで使用されたデータをプロットします。詳しくは rxtools をご覧下さい。

あまり使用されないツール

以下のツールは内部向けのツールとして使われ、エンドユーザが使うことはほとんどありません。

gendeps

roslib をご覧下さい。

/Review


2024-03-23 12:39