---
title: Adjusting stability criteria
description: The stability criterion allows for the ideal calibration of the system to your measurement process. It can be used to determine how long the cargo must remain still before a valid measurement can be taken.
---

[Skip to content](https://docs.metrilus.com/en/adjusting-stability-criteria#main-content)

- [English](https://docs.metrilus.com/en/adjusting-stability-criteria)
- [Deutsch](https://docs.metrilus.com/de/stabilitätskriterien-anpassen)

English

Show submenu for translations

[![metrixfreight\_transp\_0525](https://docs.metrilus.com/hubfs/metrixfreight_transp_0525.svg)](https://docs.metrilus.com/)

Open main navigation

Close main navigation

- - [English](https://docs.metrilus.com/en/adjusting-stability-criteria)
    - [Deutsch](https://docs.metrilus.com/de/stabilitätskriterien-anpassen)

  English
  
  Show submenu for translations
- [metrilus.com](https://metrilus.com/)

[metrilus.com](https://metrilus.com/)

 How can we help you?

- There are no suggestions because the search field is empty.

1. [MetriXFreight Documentation](https://docs.metrilus.com/en)
2. [Ongoing operation](https://docs.metrilus.com/en/ongoing-operation)

August 22, 2023

# Adjusting stability criteria

## The stability criterion allows for the ideal calibration of the system to your measurement process. It can be used to determine how long the cargo must remain still before a valid measurement can be taken.

Attention: This article is applicable only to MetriX version 1.x.x.

To check the "Framerate" of your system, press the F12 key while MetriX is running. This will display how often the entire scene is analyzed with the current configuration. You can find this number in the upper left corner of the color image. Keep in mind that this number may vary depending on the content of the scene. Having many objects, such as pallets, boxes, etc., increases the system's processing load and may reduce the framerate.

Make a note of the average framerate.

Next, close MetriXFreight by pressing ALT-F4 or using the Windows Taskbar.

 

Before making any changes, it is recommended to first backup the current configuration. To do this, create a copy of this file.

```
C:\ProgramData\Metrilus GmbH\MetriX Freight Dimensioning\configuration.xml
```

and give the copy an appropriate name, such as

```
configuration_2023-01-01-stability.xml
```

 

Open the configuration.xml file in a text editor.

Search for the line that contains the following information (numeric values may vary).

```
<m:CuboidStabilityDetectorParameters m:frameCount="12" m:maximumError="0.03" m:outlierTolerance="5" />
```

 

The 'frameCount' attribute represents the minimum number of consecutive successful measurements needed to provide a stable measurement (indicated by a green overlay). While the system collects valid measurements, only a red overlay is displayed. Adjust the parameter according to your requirements. Use the previously noted framerate to estimate which value may be suitable for you.

- A higher frame count decreases the system's responsiveness, but it also reduces the likelihood of measurement errors, such as when dealing with slow-moving forklifts.
- A lower frameCount value increases the system's responsiveness. This means there is a higher chance of measurement errors, for example, when a pallet is still being placed and is still partially on the forklift's forks. However, the system also responds faster, allowing for a higher overall throughput when used carefully.

Save the configuration and restart MetriX again. Your changes will take effect immediately.

- [Product overview](https://docs.metrilus.com/en/product-overview#main-content)

    - [MetriXFreight Products](https://docs.metrilus.com/en/product-overview#metrixfreight-products)
    - [Hardware Add-ons](https://docs.metrilus.com/en/product-overview#hardware-add-ons)
    - [Documents](https://docs.metrilus.com/en/product-overview#documents)
- [Installation L-Series](https://docs.metrilus.com/en/installation-l-series#main-content)

    - [Installation Preparation](https://docs.metrilus.com/en/installation-l-series#installation-preparation)
    - [Installation](https://docs.metrilus.com/en/installation-l-series#installation)
- [Installation S-Series](https://docs.metrilus.com/en/installation-s-series)
- [3rd Party Hardware](https://docs.metrilus.com/en/3rd-party-hardware#main-content)

    - [Barcode Scanner](https://docs.metrilus.com/en/3rd-party-hardware#barcode-scanner)
    - [Scales](https://docs.metrilus.com/en/3rd-party-hardware#scales)
- [Troubleshooting](https://docs.metrilus.com/en/troubleshooting)
- [Operational integration](https://docs.metrilus.com/en/operational-integration#main-content)

    - [IT Integration](https://docs.metrilus.com/en/operational-integration#it-integration)
    - [Workflow](https://docs.metrilus.com/en/operational-integration#workflow)
- [Ongoing operation](https://docs.metrilus.com/en/ongoing-operation#main-content)

    - [Calibration](https://docs.metrilus.com/en/ongoing-operation#calibration)
- [Best practice](https://docs.metrilus.com/en/best-practice)

[![metrilus\_white\_0525](https://docs.metrilus.com/hs-fs/hubfs/metrilus_white_0525.png?width=102&height=30&name=metrilus_white_0525.png "metrilus_white_0525")](https://metrilus.com)

 

<https://www.linkedin.com/showcase/metrixfreight/> <https://youtube.com/metrilus>

Copyright © 2025 | metrilus GmbH | [Impressum](https://metrilus.com/de/impressum)