Documentation – Current v23.2

Imatest IT: Op Modes

Op Modes

The opMode parameter for Imatest IT module functions tells Imatest how to interpret the arguments passed in the varargin parameter, and what type of analysis is to be performed. The code values are passed in as string (i.e., “-5”, “-17”, etc.).

Code Name Behavior
-5 or -7 Separate Analysis

One or more input files is read in. The full path name of the first file is passed in as the inputFile. Multiple files can be analyzed separately if they are included in the varargin parameter. These are analyzed independently of one another, and will have their result files written separately. Only the first file (inputFile) will have its JSON output returned to your application, the others must be read in from the result files.

-6 or -8 Temporal Noise Analysis

Two input files are read in for measuring temporal noise. The first image is passed as inputFile, and the second image is added the varargin parameter for measuring temporal noise (Only available in the Colorcheck, Color/Tone Auto, and Stepchart modules).

-9 or -10 Signal Average Analysis

One or more input files is read in and analyzed. The first image is passed as inputFile, and the others are added to the varargin parameter. The inputFile path may contain a wildcard character (*). If multiple files are passed in, they are combined for analysis (rather than analyzed separately) to improve the Signal-to-Noise Ratio (SNR).

-15 or -17 Direct Read Mode

The input image is passed directly from the calling program as a byte array in the varargin parameter, along with a JSON string containing metadata about how to interpret the image data. An empty string (“”) is passed as the inputFile parameter. See the article Imatest IT: Direct Read Mode more information.

Populating the varargin Parameter

For codes -7, -8, -10, and -17, the first item in this array will be the full path to your INI file. For code -15, the first item will be the raw image data array, and the second will be the JSON metadata string describing the image (See Imatest IT: Direct Read Mode). For code -17, the first item is the INI file path, and the second and third items are the image data and JSON string, respectively. For all other modes, the array contains paths to image files to be analyzed.