Global calibrations


In Viper.NET, calibrations can be created globally and referenced and used by a unique name. Via Gefasoft menu -> Functions -> Edit Calibration you get to the overview of calibrations:

Calibration key

On the left side (1) is the overview of all created calibrations, details and parameters on the right side (2). The details differ depending on the calibration type.

New calibration keys can be added or removed via (+) and (-).

New calibration keys


Each calibration in Viper.NET is loaded only once and assigned directly when used in jobs or ToolGroup items. This means that changes to the calibration within the job directly affect the global calibration and thus also all other jobs in which this calibration is used. Exception: For SimpleFixture the values are assigned. Changes within the job therefore do not affect the global calibration.

The following types are currently supported:

  • SimpleFixture

    Calibration key is obsolete: Use of CogFixture recommended!

    Corresponds to the type CogFixture, but here the values are used and no stored calibration.

    The parameters can be edited directly here. Via “Translation” (3) a reference position in the image can be set and via “Scaling” (3) a scaling value can be calculated. These functions serve as a help. However, individual parameters for calibrations should be calculated and set automatically in the program.

  • CogFixture

    For use with a CogFixtureTool, see Cognex VisionPro documentation.

  • CogFixtureNPointToNPoint

    For use with a CogFixtureNPointToNPoint, see Cognex VisionPro documentation.

  • CogCalibNPointToNPoint

    For use with a CogCalibNPointToNPoint, see Cognex VisionPro documentation.

  • CogCalibCheckerboard

    For use with a CogCalibCheckerboard, see Cognex VisionPro documentation.

The actual calibration data is stored in the application folder in the subfolder Data\Calib as .dat files.


Make sure to assign unique file names to the parameters for the calibrations.

Using the global calibrations


To apply a calibration, a suitable tool must first be inserted into the ToolgroupItem flow.

Cognex Calibration Tools Application in algorithm

The new tool must then be linked to the global calibration. In Toolgroup Item Editor under Image sources you will find the area “Calibration Assignment” (1). Here the previously defined global calibration can be assigned to the tool.

Assign calibration key to ToolgroupItem


The assignment of the calibration, i.e. the setting of the values in the calibration tool, takes place each time the job is executed. The following applies:

  • Newly created global calibrations are “empty”. In this case the values or the RunParams from the tool are taken over as global calibration.

  • Otherwise the values or RunParams of the global calibration are assigned to the tool.


After creating and linking a calibration tool, the job must be executed once to set the calibration in the tool. The complete job must be executed and not just the individual tool.


It makes sense to name calibration keys and calibration tools appropriately. If several calibration tools of the same type are used, they must be named uniquely internally, otherwise calibration objects created in VisionPro will be overwritten.



“Calibration ToolgroupItem” for automated calculation of a calibration

A “Calibration ToolgroupItem” is required to calculate a new calibration and to compare it with the global calibration or to overwrite it. Depending on the application, this is carried out once for commissioning or at regular intervals.

When creating a tool group item, “Calibration” must be selected as the type:

Create Calibration ToolgroupItem

Default ToolgroupItems and Calibration ToolgroupItems are displayed in the Job Editor:

Overview Calibration ToolgroupItem

As with a default ToolgroupItem, the corresponding calibration tools must be inserted into the image processing job.

In Toolgroup Item Editor under Extensions (1) the calibration keys can be linked to the VisioPro tools (2). At the same time there is the possibility to create a user dialog(4) which gives the user an insight into the calibration status and expects a confirmation from the user. For this purpose, elements of the Calibration selection (5) can be “dropped” onto the dialog in the middle. With “Accept/Reject” buttons can be added to accept/reject the calibration and thus give feedback to the higher-level controller. If a calibration is to be saved, this must be done with the button “Apply new calibration”. On the right side(6) are further settings for the display of the calibration dialog, such as the text content.


Wenn eine Kalibrierung über das Calibration-ToolgroupItem geprüft bzw. verändert werden soll, muss diese zwingend über Extensions zugewiesen werden und nicht über Assignment of calibrations. Ansonsten werden Änderungen an Kalibrierungen ohne Prüfung übernommen!

Assigning calibration keys and creating a calibration dialog

Activating “Auto-accept if job result is “Pass””(3) prevents the calibration dialog from opening and automatically accepts (no overwriting) the new calibration. Otherwise the calibration dialog opens with the preconfigured display and the calibration result.

Calibration dialog after performing a calibration