テクニカルティップス IDS NXT HALCON Loader HALCON 画像処理から IDS NXT ビジョンアプリへの数ステップ HALCON で開発した画像処理を IDS NXT ビジョンアプリでプログラミングすることなく 直接ビジョンアプリベースの IDS カメラで実行できます 時間が

Transcription

1 IDS NXT HALCON Loader HALCON 画像処理から IDS NXT ビジョンアプリへの数ステップ HALCON で開発した画像処理を IDS NXT ビジョンアプリでプログラミングすることなく 直接ビジョンアプリベースの IDS カメラで実行できます 時間がかかる C++ でのビジョンアプリ開発はもう不要です IDS NXT HALCON Loader が実現しました これで画像処理開発に必要なすべてが揃います このでは HDevelop で適切な HALCON ライブラリを数ステップで作成し IDS NXT Cockpit を介して IDS NXT vegas にアップロードし C++ コードを作成することなく実行する方法を紹介します シンプルな画像処理サンプル example_code2d.hdpl は 取得した画像データから Data Matrix コードを検索して ビジョンアプリの結果画像でマークします さらに コードのコンテンツはテキストとして出力されます IDS が開発した IDS NXT Framework を使うと ビジョンアプリベースカメラで実行するビジョンアプリを 何にも邪魔されずにカスタム開発できます 個々のビジョンアプリの開発および実行では IDS NXT Vision App Development Kit を利用でき 必要なのは C++ の知識だけです それも 新たに開発された IDS NXT HALCON Loader でこれまでより作業はずっと簡単になります すでにプリインストールされた HALCON で画像処理を実行するだけの場合 この汎用アプリを使うと ビジョンアプリを C++ で作成する手間が省けます HDevelop で作成された HALCON 画像処理を実行し さらに定義された入出力パラメーターを REST インターフェースから提供します また IDS NXT HALCON Loader ビジョンアプリではこれらのパラメーターが IDS NXT Cockpit に表示されるので 画像処理の設定とチェックに便利です IDS NXT HALCON Loader 1-11

2 図 1 HALCON ライブラリの直接実行 前提条件 ここで説明する手順および IDS NXT の概念の理解を深めるための準備として マニュアル IDS NXT - ビジョンアプリ開発 と IDS NXT ビデオチュートリアルをお勧めします を確認するには 以下が必要です IDS NXT vegas ( ファームウェアバージョン 1.3) Windows PC (IDS NXT vegas へのネットワーク接続 ) o ライセンスされた HALCON 13 開発環境 o IDS NXT Cockpit ( ファームウェアバージョン 1.2.4) IDS NXT HALCON Loader IDS NXT HALCON Loader 2-11

3 IDS NXT Cockpit から IDS NXT HALCON Loader を IDS NXT vegas にインストールして有効にします ビジョンアプリのインストール方法は マニュアル IDS NXT - Operation の Vision App Manager の章に記載されています 図 2 IDS NXT HALCON Loader を VApp Manager で起動 ビジョンアプリが正常に起動されると IDS NXT HALCON Loader 設定ダイアログが IDS NXT Cockpit 設定パネルに表示されます 互換性のある HALCON ライブラリをアップロードします 開発方法は 以降で説明します IDS NXT ビジョンアプリのインストールとインストール解除は 管理者ユーザーのみが実行できます HALCON の開発 IDS NXT HALCON Loader は IDS NXT ファミリーのビジョンアプリベースカメラで HDevelop プロシージャライブラリ (HDPL) と IDS NXT Framework 間の接続を確立します これにより 制御パラメーターと画像処理結果をカメラの REST インターフェースと IDS NXT Cockpit で利用できるようになります このようにして 画像処理をビジョンアプリとまったく同じように 直接操作できます HALCON ライブラリと IDS NXT HALCON Loader との互換性を確保するため 特殊な名前の HALCON プロシージャが必要で この入出力パラメーター ( プロシージャインターフェース ) が正確に定義されます ( セマンティックタイプ ) 定義されると IDS NXT HALCON Loader は自動的に適切な設定または結果変数を選択でき これが REST インターフェースから提供されます IDS NXT HALCON Loader 3-11

4 図 3 IDS NXT HALCON Loader が HALCON と IDS NXT Framework 間の接続を確立します HALCON ライブラリの構造 IDS NXT HALCON Loader と通信するには 開始点として HALCON 画像処理に以下の HDPL プロシージャが必要です "init" - ライブラリがロードされると実行されます InputCtrlParams ( 変数 制御パラメーター ) と OutputCtrlParams ( 表示 結果 ) がここで登録されます "finalize" - ライブラリがアンロードされる前に呼び出され init で作成されたすべてのデータ構造をクリーンアップします "train" - HALCON 画像処理をトレーニングできます このプロシージャはオプションです 該当する場合 対応するトレーニングが実行されます "process" - 実際の画像処理の処理関数です プロシージャの作成 タイプ "Library procedure (.hdpl)" の必須プロシージャを HDevelop で作成し 同じライブラリに保存します 各プロシージャに対して 必要な入力または出力パラメーター ( 表示用および制御用 ) とパラメータードキュメント ( セマンティックス ) を指定します IDS NXT HALCON Loader 4-11

5 図 4 パラメータードキュメント ( セマンティックス ) 付きの完全に定義されたプロシージャインターフェースが必須です 重要! 正しい セマンティックタイプ を Parameter Documentation タブ内の HALCON プロシージャの入出力パラメーターに割り当てる必要があります このの画像処理サンプル用に 以下のプロシージャパラメーターを作成します (example_code2d.hdpl) プロシージャパラメータータイプセマンティック init codetype 入力 : 制御用パラメーター string codemodel 出力 : 制御用パラメーター datacode_2d process image 入力 : 表示用パラメーター image searcharea 入力 : 表示用パラメーター region codemodel 入力 : 制御用パラメーター datacode_2d contour 出力 : 表示用パラメーター xld cutout 出力 : 表示用パラメーター image content 出力 : 制御用パラメーター string finalize codemodel 入力 : 制御用パラメーター datacode_2d train image 入力 : 表示用パラメーター image firstarea 入力 : 表示用パラメーター image codemodel 入力 : 制御用パラメーター datacode_2d ( 値 :QR Code ( デフォルト ) Data Matrix ECC 200 IDS NXT HALCON Loader 5-11

6 プロシージャパラメーター タイプ セマンティック content 出力 : 制御用パラメーター string sizemin 出力 : 制御用パラメーター integer sizemax 出力 : 制御用パラメーター integer パラメーターのセマンティックス HALCON パラメーターセマンティックスは特に重要です IDS NXT HALCON Loader によって個々の HALCON プロシージャにどのパラメータータイプが転送またはクエリされるかを定義します HALCON パラメーターのセマンティックスに従って IDS NXT HALCON Loader は REST インターフェースに適切なインタラクションパラメーターを動的に生成します サンプルでは以下のインタラクションパラメーターが生成されます HALCON プロシージャパラメーター IDS NXT インタラクションパラメーター codetype コンボボックスコントロール image image contour マーカー付き画像 content ラベル searcharea 調整可能領域 ( 画像領域 ) IDS NXT HALCON Loader 6-11

7 図 5 インタラクションパラメーターがビジョンアプリのグラフィック要素として表示されます 画像処理 このでは IDS NXT HALCON Loader と HALCON ライブラリ間のプロシージャインターフェースを使用した交換のみを説明します "init" プロシージャ制御パラメーター "codetype" が作成され コードタイプを選択し 2D コードモデル "codemodel" が作成されます これは他のプロシージャの入力パラメーターとしても使用されます さらに トレーニングデータ付きのファイルがロードまたは作成され さらに詳細なコードモデルが生成されます if (FileExistsTraining) read_data_code_2d_model(trainingfilepath, codemodel) [...] else create_data_code_2d_model(codetype, [], [], codemodel) "process" プロシージャでは ユーザーが設定した "searcharea" を使用して まず画像データが狭められます HALCON はこの領域内の 2D コードを ( トレーニングされた ) "codemodel" を使用して検索し 結果を "content" 文字列および画像位置を "contour" 画像内の XLD として転送します "cutout" 画像は cutout コードを表示します IDS NXT HALCON Loader 7-11

8 find_data_code_2d (image, contour, codemodel, [], [], ResultHandles, content) [...] reduce_domain(image, Region, cutout) "train" プロシージャで コードモデルはさらに改善され トレーニングデータがファイルに保存されます find_data_code_2d(imagereduced, contour, codemodel, ['train'], ['all'], ResultHandles, content) [...] write_data_code_2d_model(codemodel, TrainingFilePath) "finalize" プロシージャでは "codemodel" を削除してメモリをクリーンアップします clear_data_code_2d_model(codemodel) HALCON ライブラリのアップロード 作成された HALCON ライブラリを使用できるようになりました IDS NXT HALCON Loader の アップロード ボタン ( ) を使用して 作成した HALCON ライブラリをアップロードします ライブラリが正常にロードされると メッセージが表示されます この場合 IDS NXT HALCON Loader に IDS NXT Cockpit の HALCON ライブラリの入出力パラメーターが表示されます 画像処理をすぐに使用できます HALCON ライブラリは 次回の再起動後も 削除 ボタン ( ) でシステムから削除されるか 別のライブラリのアップロードによって上書きされるまで メモリ内に永続的に残ります 一度にロードしてアクティブにできるのは 1 つのライブラリだけです ただし 画像処理は何度でも変更できます IDS NXT HALCON Loader 8-11

9 ヒント パフォーマンス 汎用ビジョンアプリと HALCON ライブラリの組み合わせでは 速度は最適化されていないため 特化して実装された C++ ビジョンアプリのプログラミングとは比較できません example_code2d.hdpl の速度は 特化したマトリックスコードリーダーのビジョンアプリの約 70% です IDS NXT HALCON Loader には C++ ソースコードを 1 行も書かず カメラプラットフォーム用にクロスコンパイルすることもなく HALCON 画像処理をビジョンアプリベースのカメラで非常にすばやく簡単にテストできるという利点があります 例外処理 HALCON プロシージャの実行中に未処理の例外が発生すると IDS NXT HALCON Loader は再起動し HALCON ライブラリをアンロードします ビジョンアプリのクラッシュを防止するには 発生した各エラーを HALCON プロシージャ内で処理してください (try...catch による例外処理 ) ティップス 再起動を防ぐ IDS NXT HALCON Loader が HALCON 画像処理ライブラリの開発中にクラッシュした場合 ビジョンアプリが何度も自動的に再起動するのを防ぎたいと思うのは自然なことです REST コマンドを使うと 再起動を防止できます その後 アプリの起動を手動で指定できます curl -u <user credentials> -X PUT /vapps/activated/ids_nxt_halcon_loader?temporary=true <device URL> この REST コマンドは 現在のビジョンアプリの実行について 1 回のみ有効です IDS NXT HALCON Loader 9-11

10 ログの表示 ビジョンアプリや画像処理の誤動作を追跡するためなど IDS NXT HALCON Loader の詳細ログを表示するには 以下の URL をブラウザーに入力します IP>/vapps/ids_nxt_halcon_loader/log 図 6 このログは HALCON ライブラリをロードするエラーのないプロセスを示しています IDS NXT HALCON Loader はライブラリで定義されたプロシージャパラメーターを分析し 設定可能な入力や結果など 必要なビジョンアプリのインタラクション要素を作成します ( 黄色のマーカーを参照 ) このアプリケーションログを使うと HALCON 画像処理の実行エラーの特定と修正が容易になります 標準出力ファイルを使用すると HALCON メッセージもこのログに統合できます open_file('standard', 'output', stdout) result := 'NIO' fwrite_string (stdout, result + '\n') IDS NXT HALCON Loader 10-11

11 まとめ IDS NXT HALCON Loader は HALCON ベースの画像処理を IDS NXT vegas などのビジョンアプリベースのカメラですばやく簡単に実行する手段です これにより独自のビジョンアプリの C++ プログラミングにかかる手間が不要になり HALCON ルーチンの作成に集中できます アップロードメカニズムはシンプルなので IDS NXT ビジョンアプリベースのカメラの目的をランタイム中に何度でも変更できます C++ やビジョンアプリプログラミングに精通する必要はありません 組み込み画像処理が とても簡単 になりました IDS NXT ビジョンアプリの概念および使用方法の詳細については IDS NXT ビジョンアプリ開発ガイドをお読みになり IDS NXT ビデオチュートリアルをご覧ください 独自の HALCON マシンビジョンアプリケーションのシンプルでわかりやすいプログラミングの紹介については MVTec の HALCON 製品ページでご確認ください その他のおよびアプリケーションレポートについては IDS の Web サイトをご覧ください IDS NXT ファミリーの新しいビジョンアプリベースの産業用カメラの詳細情報も掲載されています 著者 Heiko Seitz テクニカルライター IDS Imaging Development Systems GmbH Dimbacher Str Obersulm Germany 電話 : 電子メール : marketing@ids-imaging.com Web: IDS Imaging Development Systems GmbH IDS NXT HALCON Loader 11-11