Python API

Pythonは、汎用プログラミングで広く使用されている高水準プログラミング言語です。Pythonは、より高速に作業し、システムをより効果的に統合できるプログラミング言語です。Pythonの構文を使用すると、プログラマーは他の言語と比較して概念を少ないコード行で表現できるため、親しみやすく学習しやすくなります。

前のセクションでは、Pythonなどのロボットプログラミングに広く使用されているプログラミング言語でRoboDK APIを使用する利点を説明しています。

Pythonはデフォルトで自動的にインストールされ、RoboDKと統合されます。デフォルト設定(Pythonの場所とPythonエディター)を変更するには、ツール➔オプション➔その他を選択します。

RoboDK API - 画像 1

Python用RoboDK APIは、次のモジュールに分かれています。

●robodkパッケージは、Python APIの配布されるエントリーポイントです。すべてのサブパッケージとモジュールの共通の親です。robolinkサブモジュール(robolink.py)は、RoboDKとPythonの間のインターフェースです。RoboDKプロジェクトツリー内のオブジェクトは、Robolinkオブジェクトを使用して取得でき、Itemオブジェクトによって表されます。Robolink.Itemクラスに応じて、そのアイテムに対してさまざまな操作を実行できます。

●roboappsサブモジュール (roboapps.py) は、RoboDK Apps ツールボックスです。Apps に関する詳細はこちらをご覧ください:AppLoader。

●robomathサブモジュール(robomath.py)は、Python用のロボティクス・ツールボックスであり、さまざまなロボットメーカーのロボットに対してポーズ変換を処理し、オイラー角を取得することができます。すべてのポストプロセッサーは、このモジュールに依存しています。

●robodialogsサブモジュール (robodialogs.py) は、ダイアログ用のツールボックスです。例えば、ファイルの開く/保存ダイアログやメッセージプロンプトなどが含まれます。

●robomathサブモジュール(robomath.py)は、Python 用のロボティクス・ツールボックスであり、さまざまなロボットメーカーのロボットに対してポーズ変換を処理し、オイラー角度を取得することができます。すべてのポストプロセッサはこのモジュールに依存しています。

●robomathサブモジュール(robomath.py)は、ポーズ変換での操作を可能にし、さまざまなロボットベンダーのオイラー角を取得できるPython用のロボットツールボックスです。すべてのポストプロセッサーは、このモジュールに依存しています。robodialogsサブモジュール(robodialogs.py)は、ダイアログのツールボックスです。例えば、ファイルを開く/保存するダイアログ、メッセージプロンプトなどです。robofileioサブモジュール(robofileio.py)は、ファイル操作のツールボックスです。ファイルプロパティ、CSV、FTPなど。roboappsサブモジュール(roboapps.py)は、RoboDKアプリのツールボックスです。アプリの詳細はこちら:AppLoader。

PythonモジュールはC:/RoboDK/Python/フォルダーにあります。RoboDKでPythonプログラムとポストプロセッサーを実行すると、このフォルダーはデフォルトで自動的に含まれます(PYTHONPATHとして使用されます)。

次のセクションでは、シミュレーション、オフラインプログラミング、およびオンラインプログラミング用の簡単なプログラムをそれぞれ作成する方法を示します。その他の例は、RoboDK用のPython APIページで確認できます。また、RoboDKライブラリには、デフォルトのライブラリ(C:/RoboDK/Library/)にあるScripts and MacrosフォルダーにサンプルPythonスクリプトが付属しています。

Pythonシミュレーション

この例では、URロボットを使用して新しいプロジェクトを作成し、ロボットで六角形の動きをシミュレートする方法を示します。

1.「ファイル」➔RoboDK API - 画像 2 「開く」を選択

2.ファイル➔開くを選択します

3.UR10ロボットを開く

4.Select File➔RoboDK API - 画像 3 Open

5.ファイル➔開くを選択します

6.Paint_gun.toolファイルを開きます。

7.C:/RoboDK/Library/Macros/ からサンプルPythonプログラムSampleOfflineProgramming.py を開きます。

8.「SampleOfflineProgramming」項目を右クリックし、「Pythonスクリプトの編集」を選択します。次の画像のようにプログラムが表示されます。RoboDK API - 画像 4

9.SampleOfflineProgrammingアイテムをダブルクリックしてシミュレーションを実行します。ロボットはロボットの現在の位置の周りに六角形を描く必要があり、TCPのトレースは黄色で表示されます。   
または、プログラムを右クリックして、RoboDK API - 画像 6Pythonスクリプトを実行。

10.SampleOfflineProgrammingアイテムを右クリックし、[Pythonスクリプトの編集]を選択します。次の図に示すようなプログラムが表示されます。

SampleOfflineProgrammingマクロは、ロボットの参照座標系を基準にして、ロボットの現在の位置に辺n_sidesと半径Rのポリゴンを描画します。必要に応じて、ポリゴンの寸法を変更してロボットを別の場所に移動し、プログラムを再実行します。

この例は、Webサイトのオフラインプログラミングセクションに表示されているプログラム(ビデオ付き)と似ています。

RoboDK API - 画像 7

Python オフラインプログラミング

前のPythonシミュレーションのセクションで示したとおり、ロボットのシミュレーションに使用したものと同じPythonコードを使用して、Pythonプログラムをオフラインで生成できます。オフラインプログラミングでは、特定のロボットコントローラで実行できるロボットプログラムを生成できます。

1.Pythonプログラムを右クリックするRoboDK API - 画像 8

2.Pythonプログラムを右クリックします。

3.[ロボットプログラムの生成(F6)]を選択します。

この場合、プログラムはシミュレートされませんが、結果を取得するためにすばやく実行されます。これは、ロボットコントローラに固有のロボットプログラムです。

RoboDK API - 画像 9

注意: [ロボットプログラムの生成]オプションは、RDK/Robolink接続のRunModeを自動的にRUNMODE_MAKE_ROBOTPROGに設定します。言い換えると、PythonプログラムがRoboDKのGUIの外部で実行されている場合、シミュレーションする代わりに、プログラムからベンダー固有のプログラムを生成することが可能です。例えば:

RDK = Robolink()

RDK.setRunMode(RUNMODE_MAKE_ROBOTPROG)

Pythonオンラインプログラミング

Pythonプログラムは、ロボットのシミュレーションに使用したものと同じPythonコードを使用して、ロボットで直接実行できます(Pythonシミュレーションセクションを参照)。オンラインプログラミングでは、ロボットドライバーを使用して特定のロボットコントローラーで汎用プログラムを実行できます。

1.Pythonプログラムを右クリックするRoboDK API - 画像 10

2.Pythonプログラムを右クリックします

3.ロボットで実行を選択します

プログラムは、Pythonプログラムが実行されるときにロボット上で実行されます。

RoboDK API - 画像 11

注意:ロボットで実行オプションは、RDK/Robolink接続のRunModeを自動的にRUNMODE_RUN_ROBOTに設定します。つまり、RoboDKのGUIの外でロボットの動作コマンドを実行することが可能です。例えば:

RDK = Robolink()

RDK.setRunMode(RUNMODE_RUN_ROBOT)

注意:APIを介したロボットドライバーの使用に関する詳細については、ロボットドライバーセクションを参照してください。

RoboDKでのPython設定のトラブルシューティング

Pythonをインストールした後にRoboDKをインストールした場合、RoboDKがPythonスクリプトを正しく実行できなかったり、プログラムを生成できなかったりすることがあります。このセクションでは、RoboDKでPythonインタープリタを正しく設定し、問題なくPythonスクリプトを実行するための手順を説明します。

「Tools-Options-PythonでPythonインタープリタのパスを設定してください」または「Pythonスクリプトの実行に失敗しました。Tools-OptionsのPythonタブでPythonインタープリタのパスを設定してください」といったエラーメッセージが表示された場合は、以下の手順に従ってください。

注記:WindowsにRoboDKをインストールすると、通常はPythonもデフォルトでインストールされます。Pythonがインストールされていない場合は、Pythonの公式サイトからダウンロードしてインストールしてください。どのバージョンのPythonでも動作しますが、最新バージョンの使用を推奨します。

すでにPythonがインストールされている場合、Pythonインタープリタのパスを正しく設定するには、以下の手順に従ってください:

1.Windowsのスタートメニューを選択し、pythonと入力します。

2.RoboDKで使用したいPythonのバージョンを右クリックし、ファイルの場所を開くを選択します。

RoboDK API - 画像 12

開いたフォルダーで、この手順を繰り返します:

3.Python 3.7を右クリックし、ファイルの場所を開くを選択します。

RoboDK API - 画像 13

4.パスのタイトルバーに表示されているパス上でコピーを選択します。

RoboDK API - 画像 14

RoboDKの設定にPythonのパスを入力します:

5.RoboDKを開きます。

6.Tools-Optionsを選択します。

7.Pythonタブを選択します。

8.次の画像に示すように、パスに/python.exeを追加してPythonインタープリタボックスに貼り付けます。スラッシュ(/)とバックスラッシュ(\)のどちらを使用しても動作します。

RoboDK API - 画像 15