Zivid Presets（预设参数）

Part of the Zivid SDK is the presets, a set of pre-tuned settings. These presets are aimed to simplify tuning of the camera parameters and are an alternative to 捕获助手. While Capture Assistant tries to optimize exposure settings for any scene depending on a time budget, presets are specifically tuned for the following categories:

• Consumer Goods（消费品）

• Parcels（包裹）

• Manufacturing（制造业）

• Inspection（检测）

在每个类别中，您可以找到各种不同的预设值。这些是由场景复杂性、工作距离或其中对象的典型材料属性类型区别而来的。不同的相机型号根据它们的常见应用也有不同的预设值。

预设值与SDK版本相对应。这意味着如果您升级或回退了SDK版本，预设值中的参数可能会发生变化。因此，如果您想在您的应用中使用预设值，建议调用预设值后保存为.yaml文件，并使用API的加载函数加载它。

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)

您将在页面底部找到所有预设值的下载链接。

警告

预设值与SDK版本相对应，在不同的SDK版本之间可能有所变更。

您可以在下方找到有关类别的预设情况、示例场景和基准测试结果的更多信息。建议您在应用中尝试不同的预设值，以找到最适合您的预设参数。

Consumer Goods（消费品）

可用的预设值：

• Fast（快速）

• Quality（质量）

适用于：

• Zivid Two M70

• Zivid Two L100

• Zivid One+ M

• Zivid One+ L

Consumer goods（消费品设置）旨在涵盖了您将在履行中心的 Piece Picking 或"物品拣选"应用中找到的所有物品。这通常包括数以千计的各种形状和大小的不同对象 (SKU)。捕获时间通常在400-800毫秒之间，拥有足够的数据点通常比拥有较少但精确的数据点更重要。有关设置指南、最佳相机安装方式和捕获策略的更多信息，请参阅我们深入详尽的 单品拣选教程 。

消费品设置分为Fast setting（快速设置）和Quality setting（质量设置）。质量设置具有更宽广的动态范围，可为各种对象提供良好的数据，包括明亮和反光的对象以及深色的盒子。快速设置具有较小的动态范围，但提供了明显更快的捕获速度。以下是每个子类别的示例。

Typical Consumer Goods Fast scene	Typical Consumer Goods Quality scene

以毫秒为单位的预期中位数 (±stddev)

消费品预设值	Zivid One+			Zivid Two
	Intel UHD 750	Intel UHD G1	NVIDIA 3070	Intel UHD 750	Intel UHD G1	NVIDIA 3070
	High-end [1]	Low-end [2]	High-end [3]	High-end [1]	Low-end [2]	High-end [3]
Z2 M70 Fast	NA	NA	NA	556 (±9) ms	947 (±379) ms	280 (±4) ms
Z2 L100 Fast	NA	NA	NA	558 (±9) ms	949 (±394) ms	281 (±5) ms
Z1+ M Fast	586 (±2) ms	903 (±4) ms	342 (±1) ms	NA	NA	NA
Z1+ L Fast	586 (±2) ms	901 (±4) ms	342 (±1) ms	NA	NA	NA
Z2 M70 Quality	NA	NA	NA	695 (±4) ms	1089 (±408) ms	431 (±3) ms
Z2 L100 Quality	NA	NA	NA	694 (±4) ms	1087 (±419) ms	433 (±5) ms
Z1+ M Quality	1053 (±3) ms	1533 (±14) ms	656 (±2) ms	NA	NA	NA
Z1+ L Quality	1064 (±5) ms	1538 (±15) ms	664 (±1) ms	NA	NA	NA

[1] (1,2)

搭载了GPU：Intel UHD Graphics 750 (ID:0x4C8A) 和 CPU：11th Gen Intel(R) Core(TM) i9-11900K @ 3.50GHz, 10GbE 的高端机器

[2] (1,2)

搭载了GPU：Intel UHD Graphics G1 (ID:0x8A56) 和 CPU：Intel(R) Core(TM) i3-1005G1 CPU @ 1.20GHz, 1GbE 的低端机器

[3] (1,2)

搭载了GPU：NVIDIA GeForce RTX 3070 和 CPU：11th Gen Intel(R) Core(TM) i9-11900K @ 3.50GHz, 10GbE 的高端机器

Parcels（包裹）

可用的预设值：

• Matte（哑光的）

• Reflective（反光的）

适用于：

• Zivid Two M70

• Zivid Two L100

Parcels（包裹设置）旨在涵盖物流中心的所有类型的物体，例如箱子、塑料袋和包裹。捕获时间通常在200-300毫秒之间，拥有良好的数据覆盖率比精确的数据更重要。

包裹设置分为哑光和反光两种。哑光预设值适用于动态范围有限的场景，例如纸板箱、纸箱和信封。反光预设值适用于更具挑战性的场景，包括塑料袋和深色的箱子。以下是两个预设值的示例。

Typical Parcels Matte scene	Typical Parcels Reflective scene

以毫秒为单位的预期中位数 (±stddev)

包裹预设值	Zivid One+			Zivid Two
	Intel UHD 750	Intel UHD G1	NVIDIA 3070	Intel UHD 750	Intel UHD G1	NVIDIA 3070
	High-end [4]	Low-end [5]	High-end [6]	High-end [4]	Low-end [5]	High-end [6]
Z2 M70 Matte	NA	NA	NA	287 (±2) ms	499 (±360) ms	163 (±2) ms
Z2 L100 Matte	NA	NA	NA	286 (±2) ms	510 (±288) ms	163 (±2) ms
Z2 M70 Reflective	NA	NA	NA	504 (±6) ms	821 (±374) ms	293 (±6) ms
Z2 L100 Reflective	NA	NA	NA	504 (±5) ms	823 (±426) ms	294 (±6) ms

[4] (1,2)

搭载了GPU：Intel UHD Graphics 750 (ID:0x4C8A) 和 CPU：11th Gen Intel(R) Core(TM) i9-11900K @ 3.50GHz, 10GbE 的高端机器

[5] (1,2)

搭载了GPU：Intel UHD Graphics G1 (ID:0x8A56) 和 CPU：Intel(R) Core(TM) i3-1005G1 CPU @ 1.20GHz, 1GbE 的低端机器

[6] (1,2)

搭载了GPU：NVIDIA GeForce RTX 3070 和 CPU：11th Gen Intel(R) Core(TM) i9-11900K @ 3.50GHz, 10GbE 的高端机器

Manufacturing（制造业）

可用的预设值：

• Diffuse（漫反射）

• Semi-specular（半镜面反射）

• Specular（镜面反射）

适用于：

• Zivid Two M70

• Zivid Two L100

• Zivid One+ M

• Zivid One+ L

Manufacturing （制造业预设值）涵盖了工业 Bin Picking 或 Machine tending 中常见的所有类型的对象。这可以是任何东西，从塑料和橡胶零件到闪亮的金属圆柱体，在尺寸、颜色和材料上都有显着差异。这些应用的典型情况是料箱里通常只包含一种类型的零件。捕获时间一般在700-1500毫秒之间，对于这类应用而言，准确的数据更为重要，即使能够获得的有效数据较少。

制造业预设值分为三个子类别：Diffuse（漫反射）、Semi-Specular（半镜面反射）和Specular（镜面反射）。漫反射设置适用于没有反射或不需要高动态范围的相对简单的场景。半镜面反射设置适用于存在一定光反射的场景，因此需要更高的动态范围。镜面反射设置则适用于具有光泽的和反光零件的场景，因此需要非常宽广的动态范围。

以毫秒为单位的预期中位数 (±stddev)

制造业设置	Zivid One+			Zivid Two
	Intel UHD 750	Intel UHD G1	NVIDIA 3070	Intel UHD 750	Intel UHD G1	NVIDIA 3070
	High-end [7]	Low-end [8]	High-end [9]	High-end [7]	Low-end [8]	High-end [9]
Z2 M70 Diffuse	NA	NA	NA	554 (±8) ms	940 (±408) ms	280 (±5) ms
Z2 L100 Diffuse	NA	NA	NA	554 (±8) ms	940 (±366) ms	279 (±4) ms
Z1+ M Diffuse	662 (±3) ms	944 (±3) ms	423 (±2) ms	NA	NA	NA
Z1+ L Diffuse	829 (±6) ms	1107 (±2) ms	587 (±3) ms	NA	NA	NA
Z2 M70 Semi-Specular	NA	NA	NA	998 (±56) ms	1653 (±514) ms	589 (±7) ms
Z2 L100 Semi-Specular	NA	NA	NA	996 (±56) ms	1642 (±472) ms	591 (±9) ms
Z1+ M Semi-Specular	1260 (±12) ms	1724 (±14) ms	865 (±2) ms	NA	NA	NA
Z1+ L Semi-Specular	1261 (±12) ms	1715 (±12) ms	854 (±2) ms	NA	NA	NA
Z2 M70 Specular	NA	NA	NA	1654 (±61) ms	2443 (±608) ms	1141 (±15) ms
Z2 L100 Specular	NA	NA	NA	1657 (±61) ms	2449 (±570) ms	1141 (±15) ms
Z1+ M Specular	1804 (±14) ms	2416 (±14) ms	1335 (±4) ms	NA	NA	NA
Z1+ L Specular	1806 (±14) ms	2417 (±15) ms	1332 (±4) ms	NA	NA	NA

[7] (1,2)

搭载了GPU：Intel UHD Graphics 750 (ID:0x4C8A) 和 CPU：11th Gen Intel(R) Core(TM) i9-11900K @ 3.50GHz, 10GbE 的高端机器

[8] (1,2)

搭载了GPU：Intel UHD Graphics G1 (ID:0x8A56) 和 CPU：Intel(R) Core(TM) i3-1005G1 CPU @ 1.20GHz, 1GbE 的低端机器

[9] (1,2)

搭载了GPU：NVIDIA GeForce RTX 3070 和 CPU：11th Gen Intel(R) Core(TM) i9-11900K @ 3.50GHz, 10GbE 的高端机器

Typical Manufacturing Diffuse scene	Typical Manufacturing Semi-specular scene	Typical Manufacturing Specular scene

Inspection（检测）

可用的预设值：

• Close（近距离）

• Far（远距离）

适用于：

• Zivid Two M70

• Zivid One+ S

Inspection（检测预设值）涵盖了工业维护 Inspection 中的典型对象。比如从焊接检查应用到车轮和3D打印零件的任何物体。重要的是点云数据包含尽可能少的噪声。

检测预设值分为Close（近距离）和Far（远距离）两个子类别。这里是指工作距离，近距离约为350毫米，远距离约为600毫米。

Typical Inspection Close scene	Typical Inspection Far scene

以毫秒为单位的预期中位数 (±stddev)

Inspection Settings	Zivid One+			Zivid Two
	Intel UHD 750	Intel UHD G1	NVIDIA 3070	Intel UHD 750	Intel UHD G1	NVIDIA 3070
	High-end [10]	Low-end [11]	High-end [12]	High-end [10]	Low-end [11]	High-end [12]
Z2 M70 Close	NA	NA	NA	617 (±4) ms	920 (±455) ms	352 (±3) ms
Z2 M70 Far	NA	NA	NA	848 (±4) ms	1206 (±587) ms	525 (±3) ms
Z1+ S Close	596 (±3) ms	900 (±2) ms	395 (±3) ms	NA	NA	NA
Z1+ S Far	854 (±4) ms	1178 (±5) ms	585 (±4) ms	NA	NA	NA

[10] (1,2)

搭载了GPU：Intel UHD Graphics 750 (ID:0x4C8A) 和 CPU：11th Gen Intel(R) Core(TM) i9-11900K @ 3.50GHz, 10GbE 的高端机器

[11] (1,2)

搭载了GPU：Intel UHD Graphics G1 (ID:0x8A56) 和 CPU：Intel(R) Core(TM) i3-1005G1 CPU @ 1.20GHz, 1GbE 的低端机器

[12] (1,2)

搭载了GPU：NVIDIA GeForce RTX 3070 和 CPU：11th Gen Intel(R) Core(TM) i9-11900K @ 3.50GHz, 10GbE 的高端机器

下载预设值

您可以在下面下载所有预设值

Consumer Goods（消费品）

• ZividTwo_Settings_Zivid_Two_M70_ConsumerGoodsQuality.yml

• ZividTwo_Settings_Zivid_Two_L100_ConsumerGoodsQuality.yml

• ZividOne+_Settings_Zivid_One_Plus_M_ConsumerGoodsQuality.yml

• ZividOne+_Settings_Zivid_One_Plus_L_ConsumerGoodsQuality.yml

• ZividTwo_Settings_Zivid_Two_M70_ConsumerGoodsFast.yml

• ZividTwo_Settings_Zivid_Two_L100_ConsumerGoodsFast.yml

• ZividOne+_Settings_Zivid_One_Plus_M_ConsumerGoodsFast.yml

• ZividOne+_Settings_Zivid_One_Plus_L_ConsumerGoodsFast.yml

Parcels（包裹）

• ZividTwo_Settings_Zivid_Two_M70_ParcelsReflective.yml

• ZividTwo_Settings_Zivid_Two_L100_ParcelsReflective.yml

• ZividTwo_Settings_Zivid_Two_M70_ParcelsMatte.yml

• ZividTwo_Settings_Zivid_Two_L100_ParcelsMatte.yml

Manufacturing（制造业）

• ZividTwo_Settings_Zivid_Two_M70_ManufacturingDiffuse.yml

• ZividTwo_Settings_Zivid_Two_L100_ManufacturingDiffuse.yml

• ZividOne+_Settings_Zivid_One_Plus_M_ManufacturingDiffuse.yml

• ZividOne+_Settings_Zivid_One_Plus_L_ManufacturingDiffuse.yml

• ZividTwo_Settings_Zivid_Two_M70_ManufacturingSemiSpecular.yml

• ZividTwo_Settings_Zivid_Two_L100_ManufacturingSemiSpecular.yml

• ZividOne+_Settings_Zivid_One_Plus_M_ManufacturingSemiSpecular.yml

• ZividOne+_Settings_Zivid_One_Plus_L_ManufacturingSemiSpecular.yml

• ZividTwo_Settings_Zivid_Two_M70_ManufacturingSpecular.yml

• ZividTwo_Settings_Zivid_Two_L100_ManufacturingSpecular.yml

• ZividOne+_Settings_Zivid_One_Plus_M_ManufacturingSpecular.yml

• ZividOne+_Settings_Zivid_One_Plus_L_ManufacturingSpecular.yml

Inspection（检测）

• ZividTwo_Settings_Zivid_Two_M70_InspectionClose.yml

• ZividOne+_Settings_Zivid_One_Plus_S_InspectionClose.yml

• ZividTwo_Settings_Zivid_Two_M70_InspectionFar.yml

• ZividOne+_Settings_Zivid_One_Plus_S_InspectionFar.yml

版本历史

SDK	变更
2.9	增加了预设值功能