プリセット

The Zivid SDK ships presets, sets of pre-tuned settings for common application categories, so you do not have to tune capture settings manually. There are two types of presets:

3D presets: contain the 2D and 3D capture settings and can be used with all capture functions.
2D presets: consist of the 2D settings only and can only be used for 2D captures.

Presets are coupled with an SDK version, so the parameters in a preset may change if you upgrade or downgrade the SDK. If you want to use a preset in an application, save the .yml file and load it using the load function from the API, rather than depending on the preset staying the same across SDK versions.

C++

const auto settingsFile = "Settings.yml";
std::cout << "Loading settings from file: " << settingsFile << std::endl;
const auto settingsFromFile = Zivid::Settings(settingsFile);

C#

var settingsFile = "Settings.yml";
Console.WriteLine("Loading settings from file: " + settingsFile);
var settingsFromFile = new Zivid.NET.Settings(settingsFile);

Python

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

Each preset category below lists its general assumptions, download links to the presets, an example scene, and benchmarking results. Try out different presets within your application to find the preset best suited for you.

3D プリセット

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

Consumer Goods
Parcels
Manufacturing
Inspection
Depalletization

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

消費財

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

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

小包

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

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

製造業

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

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

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

検査

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

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

デパレタイゼーション

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

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 プリセットが追加されました。