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 have been 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). Sections generally 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).

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.

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

INI file corruption issue – How to reset Imatest INI file

Imatest does not support international characters in file name paths.  Using files with international characters will corrupt the Imatest INI file and lead to an INI file error.

You should only use folders and filenames with latin characters or you will encounter this problem.

Resetting your Imatest INI is the easiest way to solve this problems.  You can do this through the following menu entry:

INI_reset_defaults

 

This will remove the settings that you have made within imatest.

To correct the problems with your INI File you can follow the troubleshooting information information available here

 

Read More