FAQ

Requirements

Run the setup program (file name starts with Installer_ and ends with the version number, for example Installer_LumiScanTrainingFramework_v2_1_0_0.exe) and confirm the prompt for administrator rights; they are required for the default location under C:\Program Files. The setup program contains its own Python environment, so a separate Python or Anaconda installation is not required. English and German are available as installation languages.

LumiScan Training Installation

Only needed if a Hailo TPU is used. Keep this order: the Hailo PlugIn checks its prerequisites one after another and stops at the first missing one, so a different order may require additional installation attempts.

Installing Podman, Installing the Hailo PlugIn

At least 24 GB of system memory (DRAM), because the model conversion runs in a virtual machine configured with 18 GB of memory, and hardware that supports Hyper-V. Hyper-V does not need to be enabled beforehand; the Hailo PlugIn installer offers to enable it. Hyper-V is not available on Windows Home editions, so the Hailo PlugIn cannot be used there.

Requirements, Installing Podman

It is recommended to decline the request with Cancel. Model conversion runs entirely on the local computer and also works if network access is declined.

Installing the Hailo PlugIn

Use forward slashes (/) instead of backslashes (\) in paths, for example C:/Users/user_name/Desktop/recordings/raw. For a parameter that supports an empty value, write null exactly like this, without quotation marks or capital letters (for example "networkBase": null to train without an existing network).

JSON Parameters Description

LumiScan VGR and AI Object Matching

JSON Parameters Description

Exported ONNX models and other training results are stored in exportDirectory; if no path is specified, in the directory of the training data (trainingData). Start Testing stores its results in the export folder, and Start Inference saves the predictions in the predictions folder within the export directory.

JSON Parameters Description, User Interface

User Interface

The calibration images must have the same resolution as the training images; otherwise the model can be unusable. Record them under real production conditions (same camera, optics, working distance and objects) and include representative lighting conditions. Store them in a single folder; supported formats include .png, .jpg, .jpeg, .bmp and .tiff.

Model Conversion: ONNX to Hailo

After Conversion finished successfully., the output folder contains <name>.hef (model for the Hailo TPU), <name>.har (intermediate archive), <name>_hailo.onnx (ONNX model adapted for Hailo) and convert_parameters.json (conversion parameters), where <name> is the name of the ONNX file. By default, the output folder is the folder containing the ONNX file.

Model Conversion Parameters

On the server, open App Settings, keep Start backend locally enabled, set Backend bind address to the computer’s network IP address or 0.0.0.0 (all interfaces) (not localhost (127.0.0.1)), enable Autostart backend as a service, click Save and restart. Clients either open http://<server-ip>:8420 in a web browser, or disable Start backend locally in their own installation and enter the server under Remote backend address.

Setting Up a Shared Backend Server, Connecting from a Client Computer

LumiScan Training needs CodeMeter 9.00 or later. Bought from HD Vision Systems, the licence is on the LumiScan Key and is an annual subscription. Bought in the ctrlX Store for Windows 11, it uses ctrlX WORKS together with the LumiScan Key. One LumiScan Key is needed per device that runs the software at the same time; keys can be exchanged between devices.

Requirements, Licensing FAQ

See the site-wide LumiScan FAQ. Contact customer support at customer.success@hdvisionsystems.com or +49 6221 6721905. For licences, write to licenses@hdvisionsystems.com.