A module that formerly worked has stopped working

A module that formerly worked but now crashes can often be fixed by removing the section for the module in imatest-v2.ini, (or in imatest.ini, multicharts.ini or rescharts.ini prior to Imatest 4.2), as appropriate. Imatest 4.1+ may open an error reporting window when a crash occurs. We recommend sending us the error report before applying the fix.

Note 1:  Reinstalling Imatest rarely solves this type of problem.

Note 2:  rescharts.ini and multicharts.ini were eliminated in Imatest 4.2+. All settings are stored in imatest-v2.ini, which can be opened for editing from the Imatest, Rescharts, or Multicharts windows. imatest-v2.ini is compatible with non-Latin characters (Asian languages). Changes are described in INI file format changes in 4.2.

Note 3:  To help us prevent similar errors in the future, please send the error report. In most cases an Error reporting window will appear. Follow the instructions, making sure to include your correct email and a brief description of what you were doing. If the Error reporting window fails to appear you can click File, Copy current session, then paste the session into an email to support@imatest.com. If you’ve closed and restarted Imatest since encountering the error, you can click File, Copy last session.

Click INI File Settings in the Imatest, Rescharts, or Multicharts window. (In Imatest 4.2+ It makes no difference because all settings are stored in imatest-v2.ini.) Then select INI File Editor.

Prior to Imatest 4.2, click INI File Settings in the

  • Rescharts window if the problem occurred in a Rescharts module (SFRplus Setup, eSFR ISO Setup, Star Chart, Random/Dead Leaves, etc.),
  • Multicharts window if the problem occurred in Multicharts, or
  • Imatest main window for all other cases.

Then select INI FILE Editor  (Edit/reset module(s) in the Settings dropdown menu prior to Imatest 3.9).

This opens the INI File Editor window, shown below.

The INI File Editor is a powerful tool for editing ini (settings) files.
You can often fix a broken (but formerly working) module by selecting the section
corresponding to the module, then clicking Delete section.

Select a section to view, edit, or delete from the Section dropdown menu (near the top). Section names usually correspond to module names. Errors can often be fixed by removing an entire section (this restores the default values) or by editing a single line (if you know what you’re doing).

Some section names don’t fit the pattern. We are keeping these (for now) for backwards compatibility. We apologize for the confusion.

  • Stepchart module:
    [q13] is used for the Stepchart module, which originally supported only linear grayscale stepcharts, such as the Kodak Q-13 and Q-14. Note that [stepchart] is used for grayscale stepcharts in Multitestnot for Stepchart.
  • Multicharts and Multitest modules
    [gamut] is used for settings common to all (or most) Multicharts/Multitest charts. There are also sections for individual test chart analyses whose name corresponds to the chart name (generally abbreviated). Here are the lists of names (taken from the code).
    For (mostly) color charts:  {‘cc24’; ‘it8’; ‘special’; ‘qpcard’; ‘ccsg’; ‘stepchart’; ‘special’; ‘cdm28’; ‘sfrp20’; ‘utt’; ‘spydercheckr’; ‘hale’; ‘te226’; ‘mxn’; ‘cdm-dc48’; ‘colorgauge’; ‘rezchecker’; ‘cmp’; ‘esfriso’; ‘iso-16505’}
    For multi-row Grayscale charts:  {‘iso-14524’; ‘qa-61’; ‘qa-62’; ‘iso-15739’; ‘ite’; ‘oecf-20’; ‘sqcirc’; ‘eia’; ‘qa-79’; ‘mxn’; ‘sdr-36’; ‘sq-20’; ‘contrast-res’; ‘te269’}

To fix a problem by resetting a section, Select the section, then press Delete section.

To fix a problem by editing a line, Select the section that contains the line, select the line in the large window, make the change in the line edit window just above the large window, then press Enter.

When you are ready to save the changes press Save, which is grayed out until changes are made. If you with to cancel your changes, press either Reload ini file or Close.

Example: Checkerboard stops working. Press the INI File dropdown menu, then select INI FIle Editor. Select the [colorcheck] section, then press Delete section, Save, Close.

Other solutions

Sometimes the problem is in the image file itself. Matlab has difficulty reading files with bad header data. Look at the command window to see if there are warnings about problems reading the file. You can often fix such problems by “laundering” the file by reading it into an image viewer/editor such as Irfanview (an excellent free program), then saving it with a similar name.

Read More

How to store and retrieve region selections

Imatest can store Regions of Interest (ROIs) for most modules that use manual region selection.

Regions of Interest can be stored in small named ini files that only contain region information, and can be retrieved whenever needed.

This can be done for most modules that use manual region selection (even when automatic selection is an option). These modules include

SFR, Colorcheck, Dot Pattern, Distortion, Multicharts, Multitest, Random/Dead Leaves, Log Frequency-Contrast, Star, and Wedge, and Rescharts (with the four preceding modules)

Stepchart (with a restriction: method 1 (below) should not be used)

[Omitted: Blemish Detect, Uniformity, which usually use the entire image. Automatically detected Rescharts modules like SFRplus and eSFR ISO ]

Saving the region selection

The ROI can be saved by one of the following methods.

1. The Save ROI settings… button in the settings window

When you open a module, select a Region of Interest, then press Yes (not Express mode), a settings window opens that that contains a Save ROI settings… button, typically located somewhere in the Settings section. Its location is not consistent: it can be different for different modules. This method is not recommended for Stepchart*. Examples:

Save ROI settings… button for Random/Dead Leaves and SFR modules

2. The Save ROI settings… button in the Save results window that typically appears when a run is complete.

3. From the Imatest, Multicharts, or Rescharts windows:

INI File Settings –> Save ROI Settings can save settings from the most recently run module (if you didn’t save it in the Settings window).

*The Stepchart Settings window differs from other modules in that it lets you select the grayscale chart type. The Fine ROI adjustment window opens after the Settings window, so it is never a good idea to save the ROI from the Stepchart Settings window. You can set it afterwards with methods 2 or 3 (described above). This is one of several reasons that Multicharts and Multitest (which can analyze color as well as grayscale charts and display more noise detail) are recommended.


Selecting Save ROI settings… opens a window that lets you select the file for saving the ROI settings.

Save ROI settings window

The Optional Navigation Area assists with navigation: It affects the initial folder that appears when you click Save ROI Settings. The ROI settings INI file contents list box displays the ROI file contents, described in the gray box below. When you press Save ROI settings you can navigate to the desired folder and specify the file name.

All modules except for SFR and Wedge store image width (nwid_save), height (nht_save), and Regions of Interest (roi) for up to 20 recently-run images (where images are distinguished by their height and width). The most recent image size is first. Each image has a single width and height and either 4 or 8 numbers describing the ROI. SFR and Wedge store multiple regions for a single image.

4 ROI numbers, sufficient for describing rectangles, are used in SFR, Wedge, Dot Pattern, Distortion, Uniformity, and Blemish Detect. Each set of four numbers consists of [UL(x) UL(y), LR(x), LR(y)], where UL = Upper-Left and LR = Lower-Right (location in pixels relative to the upper-left corner of the image).

8 ROI numbers, sufficient for describing four-sided polygons (quadrilaterals), which generally contain inner rectangles, are used in all other modules. Each set of eight numbers consists of [UL(x) UL(y), LR(x), LR(y), UR(x), UR(y), LL(x), LL(y)].

Retrieving the region selection

Because the region selection window opens first for most modules (before the Settings window) you need to load the ROI before running the module. This can be done from the Imatest, Multicharts, or Rescharts windows by clicking

INI File Settings –> Load (merge) ROI Settings

This opens the following window that lets you select a previously-saved INI file. It will be merged into the main INI file (imatest-v2.ini, unless otherwise specified).

Load ROI settings window

The upper box (OPTIONAL NAVIGATION AREA) assists with navigation by helping to locate the initial location for reading the ROI Settings file. It is completely optional and may be ignored.

Loading the region requires three steps.

  1. Press 1. Read ROI Settings file.  You can specify the actual file location to load in the Open dialog box.
  2. Examine the contents of the ROI settings file, which are displayed when the file is loaded.
  3. Press 3. Load (Merge ROI Settings). If this operation is successful a message will be displayed to the right of the button.
Read More

Can Imatest IT run multiple instances in Parallel?


Can multiple Imatest IT tests be run at the same time in order to speed up the processing time of tests that are performed in parallel?


Imatest IT is a single-threaded application, but with a special mode of running that comes with Imatest IT Parallel, you can obtain up to a 3x speed increase by running multiple instances in parallel.

Se also:

Imatest IT Parallel (IT-P) Documentation

Imatest IT in multi-threaded and multi-process environments

Read More

OS X Update leads to License “Already in Use”

When updating to a newer version of OSX, the licensing daemon may need to be reinstalled.

This can be done by:

  1. Accessing the Imatest file downloaded, and rerunning “License Manager Installer.pkg”
  2. Run an offline deactivation, and then reactivate.

If you continue having problems, please contact us at support@imatest.com with the issue, and include the offending license number.

Read More

Invalid MEX File rjpg8c.mexw32

Some users have been getting the following error:

Invalid MEX-file ‘C:\Program Files\MATLAB\R2013a\mcr\toolbox\matlab\imagesci\private\rjpg8c.mexw32′

Error in readjpg

If you are getting the error, updating to the latest release should solve the issue. If you are out of support and cannot run the latest version, we highly recommend renewing, however you can manually fix the issue.

Navigate to the Imatest installation folder (C:\Program Files\Imatest\v4.0\Master if you are using Master 4.0, replace with the version you are running) and right click on the run_imatest.bat file and select “Edit”. This should open the file in a text editor. Once you’ve done that, replace it with the following text, save and then retry Imatest.

@cd “C:\Program Files\Imatest\v4.0\Master”


@path=C:\Program Files\MATLAB\MATLAB Compiler Runtime\v81\bin\win32;%path%


@title Imatest DOS window

@echo Loading Imatest…

@imatest.exe -1 %1

If you continue experiencing issues, please email us at support@imatest.com.


Read More

Troubleshooting errors with video files

The video file formats that are compatible with Imatest vary based on operating system and installed codecs. For a list of video file formats compatible with Imatest, please see the image file formats and acquisition devices documentation page.

If you are working on Windows and using a video file that is listed as compatible with Imatest and see the following error:

Reference to non-existent field ‘hVideo’.

Then you may not have the appropriate codecs installed. Installing K-Lite Codec Pack Basic may resolve this issue.

If, after installing the appropriate codecs, you see the following error:

Error using VideoReader.read
Expected index to be a vector.

You need to update to Imatest 4.1.3 or later.

For further questions regarding video files, please contact support@imatest.com.

Read More

Selecting a Chart: SFRplus and eSFR ISO

SFRplus and eSFR ISO share many similar features and can be used to perform many similar image quality analyses. However, some of their features differ, and understanding which features differ will help you select the most appropriate test chart to analyze your imaging systems. This video outlines key differences between SFRplus and eSFR ISO.


Read More

Gamutvision Installation & Activation Issues

Problems Installing


An error message such as this is shown on install:



1. Download Imatest-lib.exe into the same folder as the Gamutvision installer
2. Re-run the installer Gamutvision-1.3.7.exe

Problems Activating


Activation of Gamutvision succeeds, stating “Thank you for registering Gamutvision”.

Upon re-starting the software it is no longer in the activated state.


1. The first time you start Gamutvision to activate the software, right click on the icon and select run as administrator.
2. After you activate as administrator, you should successfully be able to close, re-open then run Gamutvision under your ordinary user account.


Read More

Problem Starting Imatest after Installation

Symptoms of the problem:

After installation, upon attempting to start Imatest, nothing happens.  

Running using diagnostic mode, or from a command window may show an error similar to this:

Previously accessible file “C:\Program Files\Imatest\Master\imatest_mcr\imatest\
startup.m” is now inaccessible.
Error:Error in mclFreeStackTrace.

Sources of the problem:

  • Inability for Imatest to write to the program files folder, such as: C:\Program Files (x86)\Imatest\v4.0\Master\imatest_mcr\
  • Anti virus can block Imatest and it’s installer from writing files to the above location.  ESET is a particular brand of anti-virus that has been known to cause this.
  • Systems that have Java disabled by their administrative group policies

Potential Solutions:

  • Disabling Anti-virus during Installation or during the first run
  • Running Imatest as Administrator
  • Correcting the administrative policy blocking Java, or moving to a system without that policy

Solution for Imatest IT:

  • Delete the C:\Users\%USERNAME%\AppData\Local\Temp\%USERNAME%\mcrCache8.1 folder then re-run the test
Read More

Imatest Ultimate: Activating Imatest IT along with Imatest Master

An Imatest license code can be configured to work for one or more Imatest product (Master, IS and IT).  Typically IT is activated on automated test equipment, while Master and IS are activated on an imaging engineers workstation.

If you intend to use two products on the same machine, such as Master+IT, or IS+IT, then you will need a single license code that combines these products together.

Imatest Ultimate combines both IT and Master into a single license. You can upgrade your license to ultimate for less than the cost of purchasing a separate IT license.

To combine an Imatest Master and Imatest IT code together into an Imatest Ultimate license code, Please contact licenses@imatest.com with the two license codes that you intend to use on the same workstation. You will need to de-activate the licenses, and they should have similar support expiration dates, or the earlier date will be used.  We will inform you when the combined code is ready to be activated.

Read More

Debugging Imatest IT

Debugging a console-based application

Much of the diagnostic information produced by the Imatest library is output to STDOUT and STDERR streams.  In 4.0 and beyond, this occurs in a  by adding the following INI setting:


If you want to capture this output by your tester program and to save it to a log file, run your program like this:

testerprogram.exe > outputlog.txt 2>&1
Inspect the outputlog.txt should reveal details about what went wrong.  If you have any questions, send this file to support@imatest.com we should be able to determine the cause of the failure.  Also bundle your Imatest INI file, any JSON outputs that were produced, and if the failure is caused by a specific image please send us that image. 

Debugging a GUI-based application

In your calls to Imatest IT should be placed inside a try block ,with the catch block receiving a mwException object. can you then add a call to the print_stack_trace() member function of the mwException class. This will print the Matlab stack trace to cerr.  Note that there is only a print_stack_trace() for non-const mwException objects.   Example:
try {
     acquire_image(2, im_orig, vstr, source_id, vararginParam);
catch (mwException& e) {
     cout << “Run Error!” << endl;
     cerr << e.what() << endl;
GUI programs block the STDOUT and STDERR streams for the libraries you are calling. If cerr is not being output by your application, then the stream output must be captured. As part of our Operator Console Project, we have set up means of capturing these streams.  
See the following files for how to capture the streams:
Read More

Service file is not current version or does not have sufficient privileges

After upgrading to a new version of Imatest, the following error dialog may be encountered:

Service file is not current version.




  1. Download this file (Service_Installer_node735.exe)
  2. Run the Service_Installer_node735.exe and complete the installation
  3. Re-run Imatest and the problem should be resolved


Read More

Originally licensed on different computer

This can happen when a hardware change such as:

  • motherboard, network card, or hard disk drive change
  • when a virtual machine image is restored
  • On a mac, switching between native boot camp version of windows, to accessing the boot camp partition through a virtual machine software such as VMware Fusion or Parallels

If you experience this error, please contact support@imatest.com with your software license number, and we can manually reset your activation.

To prevent this error from happening in the future, you should deactivate Imatest prior to making the hardware or VM change, then re-activate the software.

Read More

Unknown Error on Software Activation

Unknown error is caused by blocked access to the computer operating system or network connection.

This may be due to a computer policy on the network that blocks ability for our Licensing service to properly function, or a Internet connection that is blocked or redirected 

  • On the first run of the software when a Trial License activation is attempted
  • On activation or deactivation of the software license.

This can also occur when your system has an inactive Netbios, which our licensing requires to generate an ID for the machine activated.

Possible Resolutions

If All Else Fails

Read More

Imatest 4.0 Release

Imatest is proud to announce the official release of its new 4.0 image quality testing software. The Imatest 4.0 upgrade includes a number of refinements including enhanced automation capabilities and a more robust image quality testing experience. Improvements are found across all three of Imatest’s core products: Master, IS (Image Sensor) and IT (Industrial Testing). Below is an in-depth and complete list of all Imatest 4.0 enhancements. (more…)

Read More

Updating License Activation Information

When your software license data is updated on our servers, your software will need to be re-activated in order to get that updated license information to your computer.

If you are having problems running the latest version of Imatest 4.0, and you have purchased after November 1 2013, then you will need to deactivate and reactivate the software to update your license information.

Deactivation Instructions:  Online or Offline

Activation Instructions:  Online or Offline

After you have completed the above deactivation and reactivation steps, you can restart the software and your updated license information should then be properly read.

See Also:

Read More

Shanghai 上海 Presentations & Training 演示与培训

请参阅 这个当前事件. Please see this current event.

Shanghai-the bund




We will return to Shanghai China for two free presentations of Imatest’s image quality testing software.  These will be held on July 21 and 22, 2014.

We are also offering a training class later in the week on July 24 and 25.

At the end of September 2014 we will be visiting Beijing.

Read More

Beijing Training Course and Seminars

Imatest in Beijing

Imatest representatives will visit Beijing the week of September 22nd to offer free Information Seminars and a paid 2-day Training Course to professionals using or considering Imatest software to improve their image quality testing processes.

2-day Training Course

The training course on September 24 & 25 offers attendees insight on the full capabilities of Imatest software in both research & development and manufacturing environments. It will be held at the at the Park Plaza Beijing Science Park Hotel. Training starts at 9am and will end at 5 to 6pm depending on questions. Look for signs in the hotel lobby to direct you to the conference room.

View the detailed training schedule here.

Sign up online or contact a reseller in your area.

Free Information Seminars

If you are interested in finding out more about how Imatest software can improve your image quality testing, we encourage you to come to one of the two free Information Seminars before the 2-day Training Course:

Please register here if you are interested in attending. 

Read More

Training Class in San Jose

Register online to join us on Sept 11 – 12 2014 for our two-day training course.

Following this class, the next San Jose training class will be on February 23 – 24,   2015

Read More

2014 Image Sensors Americas

Image Sensors Americas provides attendees with the chance to meet with leading suppliers of image sensors and related digital imaging technology. Attending delegates will be come from across the full range of end use applications in both consumer and industrial market.

IS Americas 2014 will maintain the high standard of content, with internationally renowned expert speakers you have come to expect from the European conferences by delivering a program that will cover the most pressing supply chain issues, analysis of the latest technical innovations, and insight from the combined experience and expertise of the speakers and audience.

Imatest is a Sponsor Exhibitor.

Read More