About ONNX

ONNX provides a standardized file structure to store trained AI and ML pipelines. Although ONNX is mostly used to simply store a fitted model (i.e., to export a model from some training platform), we use it more broadly to create full data processing pipelines and to flexibly merge and combine models. Before reading the docs on custom model creation using ONNX, it is useful to have a general understanding of ONNX.
The ONNX ecosystem is rapidly advancing: more and more model training platform soppurt exports to ONNX (and thus can be used to create models that can be used for edge deployment using the Scailable AI manager). We are active contributors to the ONNX eco-system.

A short ONNX introduction

According to the official ONNX website:
”ONNX is an open format built to represent machine learning models. ONNX defines a common set of operators — the building blocks of machine learning and deep learning models — and a common file format to enable AI developers to use models with a variety of frameworks, tools, runtimes, and compilers.”
Thus, ONNX is an open file format to store (trained) machine learning models/pipelines containing sufficient detail (regarding data types etc.) to move from one platform to another. The specificity of ONNX even allows one to automatically compile the stored operations to lower level languages for embedding on various devices. Effectively, an onnx file will contain all you need to know to reinstantiate a full data processing pipeline when moving from one platform to the other. It contains a full description of the process of turnign the model input (for example an image coming from a camera) into the desired output (for example a count of the number of people in front of the camera).
Conceptually, the ONNX format is easy enough: An onnx file defines a directed acyclic graph in which each edge represents a tensor specifying data of a specific type that is “moving” from one node to the other. The nodes themselves are called operators and they specify operations on their inputs (i.e., the results of their parent nodes in the graph) and submit the result of their operation to their children. ONNX thus specifies a list of operations which jointly allow one to specify virtually any AI/ML operation you might want to carry out (and if not, the set of operators is easily extendable).

A simple example

The Figure below shows an example ONNX graph, rendered using Netron, for rudimentary image processing (see this medium post for details): this graph can be used to detect movements in front of a camera that has an otherwise static background.
The logic of the graph is easy enough to follow:
  • At the top we have the start-node (or named input) that is called xin. It is a in64 tensor of dimensions 300x400x3: Effectively this encodes passing a color image of 300 by 400 pixels with 3 color channels which are each encoded using int64.
  • In the second Sub node, the input image is simply, pixel-by-pixel, subtracted from another image (called B in this graph: this is simply a static image encoding the static background). A full list of ONNX operators can be found here.
  • After the input image and the background have been subtracted, the Abs node is used to compute the absolute value of the difference between the values. This is again done pixel-by-pixel. The result is effectively an image encoding all that is left of the input image after subtracting the static background.
  • Next, the ReduceSum node sums over all pixels to generate a single number that quantifies the difference between the input image and the static background.
  • Finally, a simple Less check is used to see if there is a difference between the input image and the background that is large enough to conclude that something has appeared in front of the camera: the out node is simply a boolean value indicating whether something has appeared in front of the camera.