# Tools

 Add images Applies weights to two images, adds the weighted images together and outputs the result. Add noise Adds simulated white noise to the input image. Analyze blob geometry Calculates geometric properties for labeled objects. Analyze blob statistics Calulates histograms of blobs in a gray scale image. Analyze histogram Calculates statistical features from a histogram. Balance colors Corrects RGB color balance according to the given scaling factors. Begin branch Passes input parameters to alternative branches depending on the branch input. Begin iterate A starting point for a part of a processing graph that needs to be repeated multiple times with different parameters. Bin pixels Combines adjacent pixels to produce a lower-resolution and less noisy output image. Binarize Transforms any gray-level or color image to a binary image using a static gray-level threshold. Binarize adaptively Transforms any gray-level or color image to a binary image using one of the selected adaptive thresholding algorithms. Binarize with limits Transforms any gray-level image to a binary image. Binary morphology Applies morphological operations to binary images. Calibrate camera Calculates intrinsic calibration parameters (principal point, focal length and radial distortion) of a matrix camera. Calibrate line-scan camera Calculates intrinsic calibration parameters for a line-scan camera. Calibrate manually Calculates scaling factors between pixels and world units. Caliper A compound tool that contains a Profile tool which is connected to a MeasureGapWidths tool. Color distance Transforms input image into a gray-level image. Color ratio Given a reference color and a color sample, calculates scaling factors suitable for color balancing. Combine color channels Combines separated color channels to a color image. Compress image Compresses the pixel buffer of an image. Convert colors Converts encoded images to RGB or grayscale. Correct gamma Compresses or expands gray or RGB levels using a non-linear power-law function. Count Increases a counter and produces a reset signal every time the counter reaches a user-defined maximum value. Crop image Quickly extracts a rectangular portion of an image. Data Input Reads data from a supported data source and pushes it to analysis. Detect blobs Detects blobs in an image using 4- or 8-connectivity. Detect boundaries Detects boundaries of connected objects in images and outputs them as a matrix that contains the coordinates of vertices that form a polygon. Detect boundary shape A compound that combines boundary detection and the shape context to an easy-to-use key point detector. Detect circles Detects circles in point sets. Detect corners Detects corners in images. Detect edges Detects prominent edges in images. Detect lines Detects line segments. Detect motion Accumulates a model of a static background of a scene with moving objects. Detect shapes Detects shapes by matching a boundary curve to a known geometric shape or a user-defined shape. Draw edges Detects prominent edges in images. End branch Merges alternative processing pipelines. End iterate Collects results produced by an iterated part of a processing graph to a matrix or a table. Equalize histogram Equalizes a histogram by making the gray level distribution as uniform as possible. File system watcher A data source that outputs the path to a file or directory each time a change is detected. Filter key points Discards points whose coordinates don't fall inside a rectangular region of interest in world coordinates. Find barcode Finds locations of barcodes in the specified region-of-interest of the input image. Find matrix code Finds location of a matrix code in the specified region-of-interest in the input image. Find QR keypoints Finds location of a QR code and returns 13 key points of the code. Find threshold Automatically finds a suitable threshold value for binarizing a gray-level image based on its histogram. Flip image Flips an image horizontally and/or vertically. Frame to angles Converts the rotation matrix of a coordinate frame into Tait–Bryan angles. Gate Passes input parameters to outputs if and only if the enabled input is true. Gray level profile Computes the gray-level profile of any rectangular region. Height profile Calculates the height profile of a surface that is illuminated with stripe of light. Histogram Calculates the grayscale histogram of an image. Homography Calculates a coordinate frame which maps one set of coordinates into another. Huemap Sets the chromacity of a pixel in the output image according to the intensity the corresponding pixel in the input image. Image corners The tool projects the corners of the image to the XY plane of the world coordinate system. Image source Sends image frames received from a camera. Image to tensor Takes in an image and outputs a dense tensor in a predefined format. Invert colors Inverts the intensity of each color channel. JavaScript Runs user-defined JavaScript code in the processing pipeline. Join images Joins two or more images to a single, bigger image. Linear Filter Applies a linear filter to images. Map gray levels Maps pixels in the input image to new values in output image according to a lookup table. Mask image Applies a binary mask to the input image. Match contours Matches arbitrary boundary shapes using boundary shape detection and rigid 2D matching. Match key points A superclass for tools that match objects based on key point coordinates and their associated feature descriptors. Match rigid 2D object Matches key points with the RANSAC algorithm using a geometric model that allows a proper rigid transformation and scaling in two dimensions. Matching compound A compound tool that contains a key point detector and a matcher. Matrix to tensor Converts a matrix to a tensor. Measure gap widths Measures gap widths using a gray-level profile. Median Filter Applies a median filter to input images. Monochromatize image Changes the colors of an image so that it only contains tones of a single color. Normalize mean gray level Normalizes an image so that its local average is approximately constant everywhere. Output external data Writes data to a data link device. Pixel coordinates to world Projects pixel coordinates to world coordinates. Position camera Calculates the position of a matrix camera with respect to the world coordinate system. Position line-scan camera Calculates the position of a line-scan camera with respect to the world coordinate system. Postprocess boundary A specialized tool used by boundary shape detection to subsample and join boundaries for shape context calculation. Process YOLO results Converts the output tensor of a YOLO deep learning model to generally usable data types. Profile to image Generates an image out of any number of one-dimensional signals such as height or gray-level profiles. Project to virtual view Creates a new view of the world as if looked through a virtual window. Prune matches Removes matches which have overlapping bounding boxes or too low confidence. Quantize non-uniformly Given a list of limits in ascending order, finds the smallest limit that is not smaller than the input value and outputs its zero-based index. Read barcode Reads value of a barcode either along a line specified by start and end points, or from a bounding box specified by frame and size. Read digital input A tool that reads data from a digital I/O device and pushes it to processing. Read matrix code Reads various formats of matrix codes (2D barcodes). Region corners Calculates the corners of regions defined by frames and sizes. Replace coordinate frame Replaces the coordinate frame of the input image with a new coordinate frame without modifying pixels. Reshape tensor Creates a new tensor that points to the same data as the input tensor, but has a different layout. Rotate image Rotates an image about its principal point. Run ONNX model Runs a machine learning model stored in the ONNX format. Sample colors Calculates average of color channels in the given region of interest. Save image Writes images into files. Scale image Scales an image. Separate color channels Separates a color image to components, each represented by a gray-level image. Serialize inputs Takes in a configurable number of asynchronous input events and outputs them using the first-in-first-out principle. Set intensity range Scales or clamps the gray levels or color channels of an image into a given range. Shape context Calculates the shape context descriptor for a set of points that describe the shape of an object. Simplify polyline Reduces the number of vertices in a polyline or polygon. Sort rows Sorts matrices and tables according to a key. Subtract images Subtracts a reference image from another image and outputs the difference. Synchronize inputs Receives data from multiple asynchronous sources and outputs the received objects in synchronization with the trigger input. Tensor to classification Given a tensor representing classification results, outputs the indices of accepted classes and the corresponding tensor values. Tensor to image Converts a tensor to an image. Tensor to matrix Converts a tensor to a matrix. Timer Produces time stamps. Transform coordinates Transforms point coordinates to/from a coordinate frame. Translate and rotate frame Translates and rotates a coordinate frame or a point to a new location and orientation. World coordinates to pixels Projects world coordinates to pixel coordinates. Write digital output Changes the status of digital output lines and writes values to hardware registers.