Skip to content

Calibrating a System

Goals

  • Upload a dataset, Plex, and object space file for your system.
  • Start a calibration through TVCal and receive a calibrated system Plex.

Introduction

Calibration at Tangram Vision is all about the Plex. An initial user-provided system Plex gives us a rough idea of what kind of system TVCal should expect. From there, TVCal can refine and output a Plex that truly represents the current state of the system.

Completed plex

This means that we'll need a few things to tell it what to do:

  1. A compatible calibration data set.
  2. A Plex JSON describing your system.
  3. An object space JSON describing your object space.

Starting a System Calibration

First, navigate to the System Detail page of the system that you would like to calibrate.

Scroll down to the "Calibration" table at the bottom. Click the button "Start a new Calibration" to be taken to the new calibration configuration page.

Uploading Calibration Data

This is where we select the data that we'll use to run TVCal.

Pick Dataset

If you have previously uploaded a dataset belonging to this system, you can select that dataset for calibration using the dropdown list. Otherwise, click the upload box to select a compressed file with your new dataset. You can also drag-and-drop the file onto the dataset upload box.

Dataset Compatibility

Make sure that your dataset is compatible with TVCal by following the data creation tutorial here. Otherwise, your calibration may fail.

Pick Plex

If you have previously uploaded a Plex to represent this system, you can select that Plex for calibration using the dropdown list. Note that the latest Plex for your system will be populated here by default. Otherwise, click the upload box to select a Plex file for calibration initialization. You can also drag-and-drop the file onto the Plex upload box.

Note that the User Hub will validate your Plex JSON on upload. Plexes that do not follow the Plex JSON schema will be rejected.

Pick Object Space

If you have previously uploaded an object space file, you can select that file for calibration using the dropdown list. Otherwise, click the upload box to select an object space file for calibration initialization. You can also drag-and-drop the file onto the object space upload box.

Note that the User Hub will validate your object space JSON on upload. Object space JSON that do not follow the object space JSON schema will not be accepted.

Choose the Right Object Space

Make sure that the object space you choose is actually visible in your dataset. Read the documentation on calibration dataset capture to learm more.

Calibrate

Once you are satisfied with your inputs, click "Calibrate!". TVCal will take your data and start processing. Depending on how many components there are in your system's Plex, you could get results near instantly. For highly complex arrays, processing might take a few minutes.

Results

Once TVCal is done calibrating, it will send an email with the completed calibration parameters to the user who initiated the calibration. If the calibration was successful, the new calibrated Plex that was output by TVCal will be added to the Plex history for the system. You can then download or visualize that newly calibrated Plex on the System Detail page and explore all adjusted components and constraints.

Sadly, there are times when a calibration doesn't work out. You'll be able to see why in the Calibration table on the System Detail page. Whatever the case, the Tangram Vision Platform will give you a straightforward reason, as well as recommendations on how to avoid a calibration failure in the future.