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 Capture Assistant. 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

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.

At the bottom of this page you will also find ambient light adapted presets and presets for Halcon.

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.

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.

Available presets:

Available presets:

Available presets:

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.

Available presets:

Available presets:

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.

Available presets:

Available presets:

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.

Available presets:

Available presets:

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.

Available presets:

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

Available presets:

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

Ambient light adaptations

Ambient light adapted presets can be downloaded below.

Halcon

Halcon does not support loading .yml files, so using the presets does not work out-of-the-box. To use the presets with Halcon, download the JSON file of your desired preset below and load it using the Halcon procedure read_zivid_json_params.

An example of how to load settings and capture can be seen in CaptureWithSettingsFromJSON.

Version History

SDK

Changes

2.10

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

2.9

Presets are added.