【HALCON】copy_metrology_model 関数について - メトロロジーモデルのコピー処理

HALCONのcopy_metrology_model関数は、メトロロジーモデルを複製し、新しいモデルとしてコピーするためのツールです。この関数を使用することで、元のメトロロジーモデル内の選択された計測オブジェクトを新しいモデルにコピーし、同じデータ構造を持つ別のモデルを生成できます。この操作により、計測プロジェクトの異なるバージョン管理やバックアップが容易になります。

copy_metrology_model関数の概要

copy_metrology_model関数は、入力メトロロジーモデルから選択されたオブジェクトを新しいモデルにコピーします。元のモデルは保持され、コピーされた新しいモデルは独立した計測処理に利用可能です。既存のメトロロジーモデルが使用されていても、変更を加えずに新しい計測モデルを試すことができます。

関数のシグネチャ

void copy_metrology_model(HTuple : MetrologyHandle, HTuple* : NewMetrologyHandle, HTuple : Index);

• MetrologyHandle
  元のメトロロジーモデルのハンドル。
• NewMetrologyHandle
  コピーされた新しいメトロロジーモデルのハンドル。
• Index
  コピーする計測オブジェクトのインデックス。

使用例

以下は、HALCONのcopy_metrology_model関数を使用して、メトロロジーモデルをコピーする具体例です。

HTuple MetrologyHandle, NewMetrologyHandle;

// メトロロジーモデルの読み込み
read_metrology_model("example_model.mdl", &MetrologyHandle);

// メトロロジーモデルのコピー
copy_metrology_model(MetrologyHandle, &NewMetrologyHandle, "all");

// 新しいモデルを使用した計測処理
apply_metrology_model(NewMetrologyHandle, Image);

このコードでは、元のメトロロジーモデルを読み込み、それを新しいモデルにコピーしています。その後、新しいモデルを用いて計測を行っています。

応用例

copy_metrology_model関数は、以下のような応用で使用されています。

• バージョン管理
  元のメトロロジーモデルを保護しつつ、新しいバージョンのモデルで実験やテストを行う際に使用されます。

• プロジェクトのバックアップ
  計測プロジェクトの異なる段階でのモデルを保存し、バックアップとして保管します。

• 異なる設定での比較
  計測の設定やパラメータを変えた複数のモデルを作成し、それらを比較して最適な設定を見つけることができます。

まとめ

HALCONのcopy_metrology_model関数は、メトロロジーモデルを効率的にコピーして新しいモデルを作成するための便利なツールです。この関数を使用することで、異なる計測プロジェクトのバージョン管理やバックアップが容易になり、メトロロジーモデルの操作性が向上します。