Presets

Part of the Zivid SDK is the presets, a set of pre-tuned settings. We have two types of presets:

  • 3D presets

  • 2D presets

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

Presets are coupled with an SDK version. This means that if you upgrade or downgrade the SDK, the parameters in a preset may change. Therefore, if you want to use a preset in an application, it is recommended to save the .yml file and load it using the load function from the API.

Go to source

source

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

source

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

source

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

Warning

Presets are coupled with SDK versions and will change between SDK versions.

Below, you can find more information about general assumptions for a category, download links to the presets, an example scene and benchmarking results. It’s recommended to try out different presets within an application to find the preset best suited for you.

3D Presets

The presets are designed to simplify the tuning of camera parameters and in most cases eliminate the need for manual adjustments. They are specifically tuned for the following categories:

  • Consumer Goods

  • Parcels

  • Manufacturing

  • Inspection

Within each category, you will find various presets. These are separated by scene complexity, working distance or by the typical type of material property of objects within that. Different cameras have different presets based on what they are commonly used for.

Consumer Goods

Consumer goods cover all items you will find in a Piece Picking or Item Picking application in a fulfillment center. This usually includes thousands of different objects (SKUs) in a wide range of shapes and sizes. Capture time often lies between 400-1000 ms assuming a high-end hardware set-up. It is assumed that having enough data points is often more important than having fewer but precise ones. For more information about settings guidance, optimal camera mounting, and capture strategies, see our in-depth Piece Picking Tutorial.

Consumer goods are divided into Fast and Quality. Quality preset has a wide dynamic range and provides good data for a large variety of objects including transparent, dark, and bright, reflective objects. Fast preset provides significantly faster captures, but with reduced object surface coverage in comparison to Quality.

Consumer goods are divided into Fast and Quality. Quality preset has a wide dynamic range and provides good data for a large variety of objects including bright and reflective objects and dark boxes. Fast preset has less dynamic range, but provides significantly faster captures.

Below are examples of each subcategory.

fig_fast_scene

fig_quality_scene

Typical Consumer Goods Fast scene

Typical Consumer Goods Quality scene
Preset benchmarks

Parcels

Parcels aim to cover all types of objects in logistics centers, such as boxes, plastic bags, and packages. Capture time usually lies between 200-400 ms assuming a high-end hardware set-up. It is assumed that it is more important to have good data coverage than precise data.

Parcels are divided into Fast and Quality. Fast preset is for scenes with limited dynamic range, such as cardboard boxes, cartons, and envelopes, and provides fast captures. Quality preset is for more challenging scenes, including plastic bags and dark, reflective parcels.

Parcels are divided into Matte and Reflective. Matte preset is for scenes with limited dynamic range, such as cardboard boxes, cartons and envelopes. Reflective preset is for more challenging scenes, including plastic bags and dark boxes.

Below are examples of scenes that the presets cover.

fig_matte_scene

fig_reflective_scene

Typical Parcels Fast / Matte scene

Typical Parcels Quality / Reflective scene
Preset benchmarks

Manufacturing

Manufacturing presets cover all types of objects commonly found in industrial Bin Picking or Machine tending. This can be anything from plastic and rubber parts to shiny metallic cylinders, with notable variations in size, color, and material. Typical for these applications is that the bin often contains only one type of part. Capture time is generally between 400-1500 ms assuming a high-end hardware set-up. It is assumed that it is more important with less, but accurate, data than the opposite.

Manufacturing is divided into four subcategories: Diffuse, Semi-Specular, Specular, and Small Features. Diffuse is for relatively simple scenes without reflection or high dynamic range. Semi-specular is for scenes with some reflections and hence requires higher dynamic range. Specular is for scenes where you have shiny and reflective parts and therefore need a lot of dynamic range. Small Features is for scenes with reflective parts that have small and detailed features such as a thread of M5 bolt. The expected capture time for the Small Features preset is 1900-2200 ms.

Manufacturing is divided into three subcategories: Diffuse, Semi-Specular, and Specular. Diffuse is for relatively simple scenes without reflection or high dynamic range. Semi-Specular is for scenes with some reflections and hence requires higher dynamic range. Specular is for scenes where you have shiny and reflective parts and therefore need a lot of dynamic range.

Below are examples of scenes that the presets cover.

fig_diffuse_scene

fig_semi_specular_scene

fig_specular_scene

Typical Manufacturing Diffuse scene

Typical Manufacturing Semi-Specular scene

Typical Manufacturing Specular scene

The point cloud shows an example of a typical Manufacturing Small Features scene.

Preset benchmarks

Inspection

Inspection presets cover typical objects in industrial Maintenance Inspection. This can be anything from inspection welding applications to wheels and 3D printed parts. Capture time is generally between 1000-3000 ms assuming a high-end hardware set-up. What is important is that the point cloud data contains as little noise as possible.

Inspection is divided into Default and Small Features. Default preset is for scenes with reflective parts that need a high dynamic range. Small Features preset is for scenes with reflective parts with small and detailed features such as components on a PCB board.

Inspection is divided into Close and Far. This refers to working distances, where close is ~350 mm and far is ~600 mm.

Below are examples of scenes that the presets cover.

fig_far_scene

fig_close_scene

Typical Inspection Default / Far scene

Typical Inspection Small Features / Close scene
Preset benchmarks

2D Presets

High Resolution

The High Resolution presets prioritizes image detail and resolution. Choose this preset if you are willing to sacrifice capture speed to achieve excellent results. It is designed with the following principles:

  • Full resolution

  • Low gain

Low Resolution

The Low Resolution preset balances quality and speed, offering a quicker capture while maintaining a moderate level of detail. This preset is designed with:

  • Moderate acquisition time

  • Lower resolution for faster processing

Below are examples of a 2D capture taken with Zivid 2+ MR130 using High Resolution Color, Low Resolution Color, and Low Resolution Grayscale 2D presets.

High Resolution Color

high_res_color

Low Resolution Color

low_res_color

Low Resolution Grayscale

low_res_grayscale

Version History

SDK

Changes

2.14

2D Presets are added for all cameras and 3D presets for 2+ MR60, MR130, and LR110 camera.

2.10

3D Presets for Zivid 2+ camera family are added and 3D presets for all cameras, adapted for ambient light (grid) frequency.

2.9

3D Presets are added.