プリセット

Zivid SDK にはプリセットが含まれており、これはあらかじめ調整された設定のセットです。プリセットには2種類あります。

  • 3D プリセット

  • 2D プリセット

3D プリセットには 2D および 3D キャプチャ設定が含まれており、すべてのキャプチャ機能で使用できます。2D プリセットは 2D 設定のみで構成されており、2D キャプチャでのみ使用できます。

プリセットは SDK のバージョンと連動しています。つまり、SDK をアップグレードまたはダウングレードすると、プリセットのパラメーターが変更される可能性があります。そのため、アプリケーションでプリセットを使用する場合は、.yml ファイルを保存し、API のロード関数を使用して読み込むことをお勧めします。

ソースへ移動

source

const auto settingsFile = "Settings.yml";
std::cout << "Loading settings from file: " << settingsFile << std::endl;
const auto settingsFromFile = Zivid::Settings(settingsFile);
ソースへ移動

source

var settingsFile = "Settings.yml";
Console.WriteLine("Loading settings from file: " + settingsFile);
var settingsFromFile = new Zivid.NET.Settings(settingsFile);
ソースへ移動

source

settings_file = "Settings.yml"
print(f"Loading settings from file: {settings_file}")
settings_from_file = zivid.Settings.load(settings_file)

警告

プリセットは SDK のバージョンと連動しており、SDK のバージョン間で変更されます。

以下に、カテゴリごとの一般的な前提条件、プリセットのダウンロードリンク、サンプルシーン、ベンチマーク結果などの詳細情報を示します。アプリケーション内でさまざまなプリセットを試して、最適なプリセットを見つけることをお勧めします。

3D プリセット

プリセットは、カメラのパラメーター調整を簡素化し、ほとんどの場合、手動調整の必要性をなくすように設計されています。これらは特に以下のカテゴリ向けに調整されています。

  • 消費財

  • 小包

  • 製造業

  • 検査

各カテゴリ内にさまざまなプリセットがあります。これらは、シーンの複雑さ、作動距離、またはその中のオブジェクトの典型的な材質特性によって区別されます。カメラごとに、一般的な用途に基づいて異なるプリセットがあります。

消費財

消費財には、フルフィルメントセンターの Piece Picking またはアイテムピッキングアプリケーションで使用されるすべてのアイテムが含まれます。これには通常、さまざまな形状とサイズの数千もの異なるオブジェクト(SKU)が含まれます。高性能なハードウェア構成を想定すると、キャプチャ時間は400〜1000ミリ秒程度になります。データポイントが少なくても精度が高いものよりも、十分なデータポイントを取得することの方が重要であると考えられます。設定ガイダンス、最適なカメラの取り付け方法、キャプチャ戦略の詳細については、詳細なドキュメント Piece Picking Tutorial を参照してください。

消費財は FastQuality の2種類に分けられます。Quality プリセットは広いダイナミックレンジを持ち、透明な物体、暗い物体、明るい物体、反射する物体など、さまざまな被写体に対して良好なデータを提供します。Fast プリセットはキャプチャ速度が大幅に向上しますが、Quality プリセットと比較して被写体の表面カバレッジが低下します。

消費財は FastQuality の2種類に分けられます。Quality プリセットは広いダイナミックレンジを持ち、明るい物体や反射する物体、暗い箱など、さまざまな被写体に対して良好なデータを提供します。Fast プリセットはダイナミックレンジが狭くなりますが、キャプチャ速度が大幅に向上します。

以下に、各サブカテゴリの例を示します。

消費財 Fast プリセットの典型的なシーン 消費財 Fast プリセットの典型的なシーン
消費財 Quality プリセットの典型的なシーン 消費財 Quality プリセットの典型的なシーン
プリセットのベンチマーク

小包

Parcels は、物流センター内の箱、ビニール袋、小包など、あらゆる種類の物品を網羅することを目的としています。高性能なハードウェア構成を前提とした場合、キャプチャ時間は通常200〜400ミリ秒です。データの精度よりも、データのカバレッジが高いことがより重要であると考えられています。

小包プリセットは、難易度の高いシーンのキャプチャ能力と高速取得を組み合わせています。ビニール袋や暗く反射する小包といった難しいシーンはもちろん、段ボール箱、カートン、封筒など、ダイナミックレンジが限られたシーンにも対応できます。

小包プリセットは FastQuality に分けられます。Fast プリセットは、段ボール箱、カートン、封筒など、ダイナミックレンジが限られたシーン向けで、高速キャプチャが可能です。Quality プリセットは、ビニール袋や暗くて反射する小包など、より難しいシーン向けです。

小包プリセットは MatteReflective に分けられます。Matte プリセットは、段ボール箱、カートン、封筒など、ダイナミックレンジが限られたシーン向けです。Reflective プリセットは、ビニール袋や暗い箱など、より複雑なシーン向けです。

以下は、プリセットがカバーするシーンの例です。

小包 Fast / Matte プリセットの典型的なシーン 小包 Fast / Matte プリセットの典型的なシーン
小包 Quality / Reflective プリセットの典型的なシーン 小包 Quality / Reflective プリセットの典型的なシーン
プリセットのベンチマーク

製造業

製造プリセットは、工業用 Bin PickingMachine tending で一般的に見られるあらゆる種類のオブジェクトに対応しています。これには、プラスチックやゴム部品から光沢のある金属製の円筒まで、サイズ、色、材質に顕著な違いがあるあらゆるものが含まれます。これらのアプリケーションでは、ビンには通常1種類の部品のみが入っています。高性能なハードウェア構成を想定した場合、キャプチャ時間は通常400〜1500ミリ秒です。データ量が少なくても正確なデータの方が、そうでない場合よりも重要であると考えられます。

製造は DiffuseSpecularSmall Features の3つのサブカテゴリに分かれています。Diffuse は、反射や高ダイナミックレンジのないシーン向けで、暗い反射物体でも優れたカバレッジを提供します。また、穴や鋭角などの特徴も保持しますが、最小の特徴には Small Features の方が適しています。Specular は、光沢があり反射する部分が多く、広いダイナミックレンジが必要なシーン向けです。Small Features は、小さくて詳細な特徴を持つ反射する部分があるシーン向けです。Small Features プリセットの想定キャプチャ時間は1100〜3000ミリ秒です。

製造は DiffuseSemi-SpecularSpecularSmall Features の4つのサブカテゴリに分かれています。Diffuse は、反射がなく、ダイナミックレンジが広くない比較的単純なシーン向けです。Semi-Specular は、多少の反射があり、より高いダイナミックレンジが必要なシーン向けです。Specular は、光沢のある反射部品があり、広いダイナミックレンジが必要なシーン向けです。Small Features は、M5ボルトのねじ山など、小さくて詳細な特徴を持つ反射部品のあるシーン向けです。Small Features プリセットの想定キャプチャ時間は1900〜2200ミリ秒です。

製造は DiffuseSemi-SpecularSpecular の3つのサブカテゴリに分けられます。Diffuse は、反射がなく、ダイナミックレンジも広くない比較的シンプルなシーン向けです。Semi-Specular は、多少の反射があり、より高いダイナミックレンジが必要なシーン向けです。Specular は、光沢のある反射部分があり、広いダイナミックレンジが必要なシーン向けです。

以下は、プリセットがカバーするシーンの例です。

製造 Diffuse プリセットの典型的なシーン 製造 Diffuse プリセットの典型的なシーン
製造 Semi-Specular プリセットの典型的なシーン 製造 Semi-Specular プリセットの典型的なシーン
製造 Specular プリセットの典型的なシーン 製造 Specular プリセットの典型的なシーン

この点群は、製造 Small Features プリセットの典型的なシーンの一例を示しています。

プリセットのベンチマーク

検査

検査プリセットは、産業メンテナンス Inspection における典型的な対象物を網羅しています。これには、溶接検査からホイール、3D プリント部品まで、あらゆるものが含まれます。高性能ハードウェア構成を前提とした場合、キャプチャ時間は通常1000〜3000ミリ秒です。重要なのは、点群データにできるだけノイズが少ないことです。

検査プリセットは DefaultSmall Features に分かれています。Default プリセットは、高いダイナミックレンジが必要な反射部分のあるシーン向けです。Small Features プリセットは、PCB 基板上の部品など、小さくて詳細な特徴を持つ反射部分のあるシーン向けです。

検査プリセットは CloseFar に分けられます。これは作業距離を指し、近距離(Close)は約350mm、遠距離(Far)は約600mmです。

以下は、プリセットがカバーするシーンの例です。

検査 Small Features / Close プリセットの典型的なシーン 検査 Small Features / Close プリセットの典型的なシーン
検査 Default / Far プリセットの典型的なシーン 検査 Default / Far プリセットの典型的なシーン
プリセットのベンチマーク

デパレタイゼーション

デパレタイゼーション プリセットは、産業用デパレタイゼーションでよく扱われる典型的なオブジェクトを網羅しています。これには、シンプルなマットな段ボール箱から、プラスチックで包装されたボトルや缶まで、あらゆるものが含まれます。高性能なハードウェア構成を想定した場合、キャプチャ時間は通常500〜2000ミリ秒です。最も重要なのは、すべてのアイテムの点群カバレッジです。

デパレタイゼーション プリセットは FastQuality の2種類があります。Fast プリセットはキャプチャ速度が大幅に向上し、点群のエッジがより鮮明になりますが、Quality プリセットと比較して表面カバレッジが低下します。Quality プリセットはダイナミックレンジが広く、プラスチックで包装された物体、暗い物体、明るい物体、反射する物体など、さまざまな物体に対して良好なデータを提供します。

デパレタイゼーション Fast プリセットの典型的なシーン デパレタイゼーション Fast プリセットの典型的なシーン
デパレタイゼーション Quality プリセットの典型的なシーン デパレタイゼーション Quality プリセットの典型的なシーン
プリセットのベンチマーク

2D プリセット

高解像度

高解像度プリセットは、画像の詳細度と解像度を最優先します。優れた結果を得るためにキャプチャ速度を多少犠牲にしても構わない場合は、このプリセットを選択してください。このプリセットは、以下の原則に基づいて設計されています。

  • フル解像度

  • 低ゲイン

低解像度

低解像度プリセットは、画質と速度のバランスを取り、適度なディテールを維持しながらより迅速なキャプチャを実現します。このプリセットは、以下の特性を備えています。

  • 適度な取得時間

  • より高速な処理のための低解像度

プリセットのベンチマーク

以下は、Zivid 2+ MR130 を使用して、高解像度カラー、低解像度カラー、および低解像度グレースケールの 2D プリセットで撮影した 2D キャプチャの例です。

高解像度カラー 高解像度カラー
低解像度カラー 低解像度カラー
低解像度グレースケール 低解像度グレースケール

バージョン履歴

SDK

変更点

2.17

Zivid 3 XL250 用のプリセットが追加されました。

2.14

すべてのカメラ用に 2D プリセットが追加され、2+ MR60、MR130、LR110 カメラ用の 3D プリセットが追加されました。

2.10

Zivid 2+ カメラシリーズ用の 3D プリセットが追加され、環境光(グリッド)周波数に合わせて調整されたすべてのカメラ用の 3D プリセットが追加されました。

2.9

3D プリセットが追加されました。