* indicates that this field will be described in more detail at the bottom of this document (Much of the text at the bottom will be common to several ini file reference pages).
For more information on how to use INI files in Imatest IT, we recommend the Imatest INI File Reference
For Imatest IT, most of these entries don’t need to be entered. Many don’t affect Imatest IT results: they control interactive figure displays or figure output formats (figures are often not used in Imatest IT).
| Background | Meaning |
| Yellow | Yellow background: Important to Imatest IT. Parameter and Description are in boldface. [IT] |
| Cyan | Cyan background: Figure settings. (Figures are used infrequently for IT.) [f] |
| Gray | Gray background: For interactive operation. No effect on IT. |
| Clear | Clear background: Results details (units, scaling, etc.) for CSV and JSON output, or not yet categorized. May affect IT results. |
| Notes: Parameters of special interest to IT users are indicated by [IT] and displayed in Boldface. Some entries have extra values (unused; there to make it easy to add more settings). | ||||
| Parameter | Section | Type | Description | Default value(s) |
| acutanceType | sqf | int | Acutance CPIQ [1], Standard SQF [2] | 1 |
| agc16bit | imatest | int | AGC (auto-lighten) dark 16-bit files | 1 |
| anlz_rough | sfr | int | Analyze edge roughness (slight slowdown) | 0 |
| anlz_sqf | sfr | int | Perform Acutance/SQF analysis | 0 |
| aper | sfr | str | Aperture: may be used for ISO sensitivity | |
| areanorm | sfr | int | Normalization for MTF area calculation for secondary readouts 1,2: 1 = unnorml; 2 = normalize to maximum. | 2 2 |
| bayeraw | sfr | int | Bayer RGB format (monochrome-only): 0-5 for [standard monochrome, R, Gr, B, Gb, demosaic] [IT] | 0 |
| brawShift | dcraw | int | Bayer RAW bit shift | 1 |
| CA | sfr | str | Plot Lateral Chromatic Aberration (color images-only)[f] | Max |
| camera | sfr | str | (camera type from EXIF data) | |
| chcontrast | sfr | int | chcontrast(1) is index of chart contrast for calculating gamma when chcontrast(3)=1: | 7 10 0 |
| 1-12 for contrast ratio = [Off 80 50 40 25 20 10 5 4 2 1.414 1.2 1.1]* [IT] | ||||
| closefigs | sfr | int | Close figures after save if 1. May prevent excessive figure buildup, which shows Imatest down.[IT] | 0 |
| continue_on_error | api | int | Continue batch-processing if exception [IT] | 0 |
| CPIQPreset | sqf | int | Height & distance presets for Acutance calculation: [1] None, | 1 |
| [2] Small Print (10 cm height, 25cm dist, 600 DPI), [3] Large Print (40cm height, 75cm dist, 600DPI), [4] Computer Monitor at 100% (60cm distance, 100PPI), [5] 4.5″ Cell Phone (5.5cm height, 25cm dist, 330PPI), [6] 30″ 4k UHDTV (37.5cm height, 50cm dist, 146 PPI) |
||||
| csvbase_header | sfr | int | 1 or 2 line CSV database header | 2 |
| cyclesper | sfr | str | Plot Edge & MTF | Max |
| cyclesper_value | sfr | int | Index of display unit: 1-13 for | 1 |
| C/P, C/mm, C/in, LW/PH, LP/PH C/mrad, C/deg, C/Objmm, C/Objin, LW/CH, LP/CH, LW/N_PX, LP/N_PX. See https://www.imatest.com/docs/sharpness/#units [IT] | ||||
| debug | api | int | 0 | |
| deconvFile | sfr | str | Deconvolution (chart compensation) file | *.csv |
| deconvFolder | imatest | str | Deconvolution (chart comp.) folder: no filesep at end | C:imatestGUIProducts TrunkdependsRTDepends |
| deconvParam | sfr | dec | Deconvolution (chart compensation) settings | 0 0 0 0 0 0 0 0 0 0 0 0 |
| demoz | dcraw | int | Demosaicing algorithm | 1 1 0 |
| derivCorr | imatest | int | LSF derivative correction ISO 12233:2014(D.1) Strongly recommended (may remove) | 1 |
| disable_figs | api | int | No figures in IT [IT] | 0 |
| displayType | sqf | int | Screen [1], Print [2], Ideal [3] | 1 |
| edgecrop | sfr | int | Index of edge display for Edge/MTF plot: 1=default; 2=entire edge; 3={-4,6} pizels; 4={-10,15}; 5={-15,20}; 6-Half edge; 7=Quarter edge [f] | 1 |
| edgerough | sfr | str | Plot Edge roughness [f] | Min |
| emph2 | sfr | int | Emphasize (make bold) secondary readout in Edge/MTF plot [f] | 0 |
| exiftool | imatest | int | EXIF read selection. https://www.imatest.com/docs/imatest_instructions/#exif | 1 1 |
| exiftool(1) = 0 (no EXIF), 1 or 2 (use Phil Harvey’s ExifTool), 3 (Matlab built-in). | ||||
| expandplt | imatest | str | Expand fixed-module figures [f] | 1 |
| expert | sfr | int | Expert (1) vs. basic mode (0) for parameters window [int] | 1 |
| fig_display_mode | api | int | Figure generation mode for IT | 0 |
| figsave | sfr | int | Type of figure to save: 1 for png; 2 for fig [f] | 1 |
| filecomb | sfr | int | Combine files if >1 (for signal averaging) | 0 |
| foclth | sfr | str | (focal length from EXIF data. Use for cycles/angle) | |
| folder | sfr | str | Folder for Open image file dialogue box [int] | C:imatestGUIProducts Trunksource |
| gamma | sfr | str | gamma for linearization {IT] | 0.5 |
| getfileopt | imatest | int | 1 for standard file read dialog; 2 for uipickfiles, which supports batches. [int] | 1 |
| globfold | imatest | str | Use a global folder for reading images, rather than a folder for each module.[int] | Min |
| globsave | imatest | str | Use a global folder for saving results, rather than a folder for each module.[int] | Min |
| heightOrPct | sqf | int | If true [1] image heights are calculated using percentage magnification | 0 |
| ini_file_date | imatest | str | Set to run date in some modules. Informational. UNUSED? | |
| instarun | imatest | int | New cropping indicator [int] | 0 |
| iso | sfr | str | (ISO speed settingfrom EXIF data) | |
| isostd | sfr | str | ISO 12233 standard calculation. Min or Max. | Min |
| keepExt | imatest | int | Keep file extension (jpg, png, …) when saving results | 0 |
| lambdadiff | sfr | dec | Wavelength(um) for diffraction-ltd MTF (aper must be set) [f] | 0.555 |
| lastfiles | sfr | str | Last file list [int] | |
| lens | sfr | str | (lens type from EXIF data) | |
| lenschart | sfr | str | Lens-to-chart distance cm for focal lth calc. | |
| lensOnly | sqf | int | If true [1] viewing display type must be ideal [3] | 0 |
| lum_coeffs | imatest | dec | Luminance (Y-channel) coefficients & index [IT] | 0.2125 0.7154 0.0721 2 |
| lwlpd | sfr | int | 1 to display LW/PH, 2 for LP/PH | 1 |
| magnification | sfr | dec | Magnification (for C/Obj mm). Ignore if 0 or for most units. | 0 |
| maxDist | sqf | dec | Maximum viewing distance (cm) | 150 |
| maxHeight | sqf | dec | Max height (cm) for Fixed distance Acutance sweep | 100 |
| maxPct | sqf | dec | Maximum percent magnification of the image | 200 |
| minDist | sqf | dec | Minimum viewing distance (cm) | 50 |
| minHeight | sqf | dec | Min height (cm) for Fixed distance Acutance sweep | 5 |
| minPct | sqf | dec | Minimum percent magnification of the image | 25 |
| mod_apod | sfr | int | “Mod Apod” MTF noise reduction. Recommended. https://www.imatest.com/docs/sharpness/#noisered | 1 |
| multidisp | sfr | int | Multi-ROI view options [f]: which of boxes 1-4 to display: 1=all; 2=[2-4]; 3=[2,3]; 4=[3,4], … | 1 |
| multistyle | sfr | int | Multi-ROI results selection: which variables to display. | 1 |
| https://www.imatest.com/docs/rescharts_edge_results-3/#multiroi [f] | ||||
| multitype | sfr | str | Multi-ROI plot type (1D, 2D, etc.)[f] | 3 |
| n1090 | sfr | int | R1090 rise distance index: 1-5 for 10-90, 10-80, 10-70, 20-80, 20-70 | 1 |
| nht_save | sfr | int | Height in pixels of last image | 0 |
| noisehist | sfr | str | Plot noise histogram [f] | Min |
| nonuniformCorr | sfr | int | Slanted-edge nonuniformity correction | 0 |
| noplot | api | int | Suppress all plots in IT [IT] | 0 |
| normalizeValues | sqf | int | If true [1] normalize MTF values for acutance calculations, otherwise choose false [0] | 0 |
| nowait | imatest | int | Suppress waitbar if set [IT] | 0 |
| nwid_save | sfr | int | Width in pixels of last image | 0 |
| ois_enable | sfr | int | Optical Image Stabilization enable | 0 0 |
| other | sfr | str | System description (manually-entered) displayed in EXIF area [f] | |
| passFail | api | str | Pass/fail file name | |
| ph | sfr | str | Picture height in pixels [IT] | |
| ph16505 | sfr | int | Picture Height for ISO 16505 | 0 |
| pixelsper | sfr | str | Index (1-3) for sensor spacing units: pixels/inch, px/mm, or um/pixel | |
| pixunits_value | sfr | int | Sensor pixel spacing or pitch in pixelsper units. | 3 |
| Example: for 4 um/pixel, use pixelsper = 3; pixunits_value = 4. | ||||
| plotmax | sfr | int | Index of maximum plot frequency for Edge/MTF plot: | 1 |
| 1-6 for [2, 1, 0.5, 0.2, 0.1, 0.05]*Nyquist frequency[f] | ||||
| plotType | sqf | int | Sqf or Acutance Standard Plot [1], JND [2] [f] | 1 |
| pltaf | sfr | str | AAA Auto Focus AF Plot | Min |
| pltsharp | sfr | int | Display oversharpening if 2 | 2 |
| pop_edge | sfr | int | Edge plot type for Edge/MTF plot: [f] | 1 |
| 1-5 for Edge profile (norml, linearized), LSF, Edge (not lin), Edge (lin, UNnorml), … | ||||
| preset | sfr | int | ??? [f] | 1 |
| pw | sfr | str | Picture width in pixels [IT] | |
| pxPerCm | sqf | dec | Pixel per cm resolution of the image | 100 |
| radius | sfr | dec | Radius for standardized sharpening (not normally needed) | 2 |
| rdnum | sfr | str | Secondary readout 1 MTF@ rdnum [IT] | 0.3 |
| rdnum2 | sfr | str | Secondary readout 2 MTF@ rdnum2 [IT] | 0.2 |
| rdnum3 | sfr | str | Secondary readout 3 MTF@ rdnum3 | 0.2 |
| rdpct | sfr | str | Secondary readout 1 nn (%) for MTFnn or MTFnnP [IT] | 30 |
| rdpct2 | sfr | str | Secondary readout 2 nn (%) for MTFnn or MTFnnP [IT] | 20 |
| rdpct3 | sfr | str | Secondary readout 3 nn (%) for MTFnn or MTFnnP | 20 |
| rdtype | sfr | str | Secondary readout 1 name: “MTF”, “MTF__P”, “MTF Area”, or “MTF @” [IT] See https://www.imatest.com/docs/imatest-ini-reference/#secondary | MTF |
| rdtype2 | sfr | str | Secondary readout 2 name: “MTF”, “MTF__P”, “MTF Area”, or “MTF @” [IT] | (none) |
| rdtype3 | sfr | str | Secondary readout 3 name: “MTF”, “MTF__P”, “MTF Area”, or “MTF @” | (none) |
| rdunit | sfr | int | Secondary readout 1 frequency unit index (1-3 for C/P, C/mm, C/in) [IT] | 1 |
| rdunit2 | sfr | int | Secondary readout 2 frequency unit index (1-3 for C/P, C/mm, C/in) [IT] | 1 |
| rdunit3 | sfr | int | Secondary readout 3 frequency unit index (1-3 for C/P, C/mm, C/in) | 1 |
| readexif | imatest | int | Read EXIF data from image file | 1 |
| readoutDist | sqf | dec | Readout distance OR fixed viewing distance (cm) | 100 |
| readoutHeight | sqf | dec | Readout height (OR) OR fixed height of the image (cm) | 75 |
| readoutPct | sqf | dec | Readout percent magnification OR fixed percent magnification | 100 |
| resultsave | sfr | int | Save results in subfolder Results of image file folder | 1 |
| RGBY_value | sfr | int | Index of channel to analyze (4 is Y)[IT] | 4 |
| rmcn | dcraw | int | Index of location of Red pixel in Bayer raw: 0-4 for unknown, R1C1, R1C2, R2C1, R2C2 | 0 |
| roi_mult | sfr | int | ROI: (nroi,4) array: [x(ul) y(ul) x(lr) y(lr)]. | 1 1 1 1 |
| For non-rescharts SFR. Example for 2 ROIs: roi_mult = [ 217 111 232 133; 234 110 250 131;] [IT] | ||||
| roifilter | sfr | int | ROI detection filtering | 0 |
| save_answer | sfr | str | Save results for this module (Yes or No) [int] | Yes |
| save_dir | sfr | str | Folder for saving results [int] | C:imatestGUIProducts TrunksourceResults |
| save_file_list | sfr | int | List of files to save (specific to module) Some extras. Elements:1=Edge/MTF plot; 3=CA plot; 6=CSV; 8=Acutance; 9=Noise histogram; 10-Edge roughness plot; 11=JSON; 12=HTML; 13=PDF | 1 0 1 1 1 0 0 0 0 0 0 0 0 0 0 |
| save_roi_list | sfr | int | List of ROIs to save (multiple ROIs) [int] | 1 1 1 1 |
| saveCSV | sfr | int | Save CSV file | -99 |
| savedel | api | int | Always close figures after saving them [IT] | 0 |
| saveHTML | sfr | int | Save HTML report | 0 |
| saveJSON | sfr | int | Save JSON file | -99 |
| savePDF | sfr | int | Save PDF report | 0 |
| sfrrefine | sfr | int | Refine ROI next SFR run | 0 |
| SFRsuffix | sfr | int | Suffix for saving plots & summary CSV file | 1 |
| shannon | sfr | str | Plot Shannon capacity if ‘Max’ [f] | Min |
| shutter | sfr | str | Shutter speed: may be used for ISO sensitivity | |
| speedup | sfr | int | Speed up calculations (no histograms or Shannon capacity). Recommended. [IT] | 1 |
| SQF | sqf | str | Calculate Acutance or SQF | Min |
| SQFmult | sfr | str | Plot multi-ROI Acutance or SQF. [f] | Min |
| viewSettings | sqf | dec | [1] Fixed Viewing Distance, Varying Height | 1 |
| (requires minDist, maxDist, readoutDist, pxPerCm AND readoutHeight OR readoutPct) | ||||
| winlarge | imatest | int | Enlarge interactive windows [int] | 0 |
| zweights | sfr | dec | Zone weights: ctr, mid, corner. Can be 0-1. [.5 .5 .5] might be better for machine vision. | 1 0.75 0.5 |
| Parameter | Section | Type | Description | Default value(s) |
Details
Secondary readouts are displayed in several MTF plots and in CSV and JSON output of sharpness modules. They are also used for pass/fail criteria.
The Secondary readout window (shown on the right) controls the secondary readout display in MTF plots. The primary readout is MTF50 (the half-contrast spatial frequency). Three secondary readouts are available with several options. The first defaults to MTF30 (the spatial frequency where MTF is 30%). The third is used only for SFRplus Lens-style MTF plots.
- The upper radio button (MTF) for each readout selects MTFnn, the spatial frequency where MTF is nn% of its low frequency value.
nn is rdpct, rdpct2, or rdpct3 in the ini file. - The second radio button selects MTFnnP, the spatial frequency where MTF is nn% of its peak value: useful with strongly oversharpened edges.
- The third radio button (MTF @ ) selects MTF @ f units, where f is a spatial frequency in units of Cycles/pixel, LP/mm, or LP/in. If you select this button, the pixel spacing should be specified in the Cycles per… line in the Plot section of the input dialog box, shown above. A reminder message is displayed if the pixel spacing has been omitted.
- The fourth radio button (MTF Area) selects the area under the MTF curve (below the Nyquist frequency). When it is normalized to the peak MTF it tracks MTF50 for low to moderate sharpening, but, unlike MTF50, it remains constant for oversharpened images. Described in Slanted-Edge MTF measurement consistency.
- In INI files,
- rdtype, rdtype2, and rdtype3 are ‘MTF’, ‘MTF__P’, ‘MTF Area’, or MTF @’: the type of display, indicated by the radio buttons.
- rdnum, rdnum2, and rdnum3 are frequencies f for MTF @ f plot units (e.g., MTF@0.2 C/P)
- rdpct, rdpct2, and rdpct3 are nn (%) for their respective MTFnn or MTFnnP readouts.
- rdunit, rdunit2, and rdunit3 are the indices for the plot units: 1 for Cycles/Pixel; 2 for Cycles/mm; 3 for Cycles/in.