Documentation – Previous v2021.1

Uniformity INI Reference

Uniformity ini file reference

Uniformity is included in IT EXE and DLL, hence users may sometimes need to examine or edit the INI file used to control IT versions.

Many of the settings in the [uniformity] section are set by the Uniformity Settings window. A few are set by responses to other windows or user actions. Uniformity shares the same ini file section ([uniformity]) with Uniformity Interactive. Settings that affect only Uniformity Interactive (and hence not the IT versions) will be highlighted in pink.


Uniformity settings window

INI file settings that affect several modules are described in Imatest INI Reference.

Notes
(-IT) Not used in Imatest IT
(gr) Affects graphics (figures). May not be of interest for Imatest IT, where graphics is often suppressed.
(index) Setting is equal to the index of the popup menu. You’ll need to open the Settings window to see these: Never used for important IT settings.
(index-1) Setting is equal to the index of the popup menu – 1 (0 – (index-1)). Keeps backwards compatibility for some settings that were originally 0 (off) or 1 (on), but had options added.

Table of [uniformity] settings

Parameter Settings
window
Typical values
[default]
Description Notes
addconts Summary plot (Blemish plot
(spot emphasis) shown above
1-4 [4] (index) Main Blemish results plot (gr)
addhist Summary plot options (Add results at bottom…) shown above 1-3 [1] (index-1) Add contours to local noise plot.
(gr)
autoreload (-IT)
bayeraw — (Set by several buttons in the Monochrome image settings window) 0-5 [0] If > 0, monochrome files contains Bayer RAW data. 1-4, indicates primary color to analyze (R, Gr, B, Gb). 5 indicates Demosaic.
blemlim1 (unused) 3 4 4 4 4 4 4
blemlim2 (unused) 3 4 4 10 20 25
brawShift — (Set by the Bit shift popup menu in the Monochrome image settings window) 1-6 [1] (index) Bit shift: 1 for auto; 2-6: 0,2,4,6,8 bits, respectively.
closefigs Set by the Close figures after save checkbox in the Save window. 0 or 1 [0] 1 recommended for IT (closes windows after save).
crop_borders (NOT RECOMMENDED) Extra cropping beyond the coarse & find adjustments. Set in the Crop pixels near borders section (lower-left). 0 0 0 0 0 First value turns extra cropping off/on (0/1). 2-5 are for L R T B in pixels. (NOT RECOMMENDED)
deadp Dead pixels popup menu (lower-left) 1-3 [1] (formerly Min, Max)
If 2 or 3, same as hotpx.
1 = No dead or dark pixels
2 = Display dead pixels (o): Abs. pxl threshold
3 = Display dark pixels (o): Rel. % threshold
deadthr Dead pixels slider [4 8] Thresholds for detecting dead pixels: absolute value in pixels and relative % below neighbors for deadp = 2, 3.
extrasmooth
figsave Set in Save figures as PNG or FIG dropdown menu in Save window 1 or 2 [1 recommended] Type of figure to save (PNG or FIG). FIG files not recommended because they require much more storage. (gr)
filecomb Set when multiple files are selected for analysis 0 or 1 [0] 0: Read and analyze files as a batch, 1: Combine files (signal-average) (-IT)
filtype Popup menus to the right of Lowpass & Highpass [2 1] Highpass and lowpass filter rolloffs:
1: Exponential (e^(-x)),
2: Gaussian (e^(-x^2)),
3: Exponential-3 (e^(-x^3))
folder Set during image file read (Path name) Folder for last input image (-IT)
gamma (Settings area) [0.5] Used to linearize image prior to filtering.
hdchan Channel popup menu below Hot/Dead pixels menus 1-3 [1] Channel(s) for detecting Hot/Dead pixels: 1 = any; 2 = selected; 3 = all.
hotpx Hot pixels popup menu (lower-left) 1-3 [1] (formerly Min, Max)
If 2 or 3, same as deadp.
1 = No hot or light pixels
2 = Display hot pixels (o): Abs. pxl threshold
3 = Display light pixels (o): Rel. % threshold
hotthr Hot pixels slider [251 8] Thresholds for detecting hot pixels: absolute value in pixels and relative % above neighbors for hotpx = 2, 3.
hpf_set Highpass slider or text box [0.02] Highpass cutoff in normalized units.
lineplot Line blemish plot checkbox 0 or 1 [0] Line blemish plot (-gr)
lpf_set Lowpass slider or text box [0.005] Lowpass cutoff in normalized units.
nchan Channel popup menu 1-4 Channel to analyze: 1-4: R, G, B, Y (Luminance)
nht_save Set during image read 2448 … Height in pixels of recent image(s). There may be several.
nwid_save Set during image read 3264 … Width in pixels of most recent image(s). There may be several.
plot_image Plot checkboxes in Settings window 1 0 0 0 0 0
prevdisp Preview display popup menu, under the Preview image [1] (index) Display type for the Preview in the Blemish settings window (-IT)
roi Set during region selection (primarily in the fine adjust window) 1 1 3264 2448 (typical) Region of interest (crop) in pixels. [x1 y1 x2 y2] Groups of 4, each group corresponding to a number in nht_save and nwid_save.
save_answer Save window— main answer (unused) Yes, No
Saved setting not used. (-IT)
save_dir Set in Save window (Folder name) Last folder used to save results (-IT)
saveCSV Save window 0 or 1 [-99 = ignore] Save CSV results. Overrides save_file_list.
saveJSON Save window 0 or 1 [-99 = ignore] Save JSON results. Overrides save_file_list.
saveXML Save window 0 or 1 [-99 = ignore] Save XML results. Overrides save_file_list.
save_file_list Save window [1 1 1 0 0 0 0 0 0 0] List of results to save if element is set to 1:
1: Orig. image, 2: Image LPF, HPF, 3: Image HPF, 4: Image HPF, exag. noise, 5: Blemish summary, 6: Blemish line image, 7: CSV, 8: XML, 9: Blemish count image, 10: JSON
sideloc Location popup window 1-7 [1] Distance from outer ROI boundary to image border (% of image height) 1-7: 0% (border), 1%,
2%, 5%, 10%, 15%, 20%
sidereg Corners & sides popup menu 1-7 [2] (index) (Same as uniformity) Size of corner and side regions for Relative Illumination analysis. 1: 10×10 pixels, 2: 32×32 pixels, 3: 1% (min. 10), 4: 2% (min. 10), 5: 5%, 6: 10%, 7: 64×64 pxls.
speedup Speedup (checkbox in Settings area) 0 if set to 1, skip several calculations related to relative illumination to speed up operation.

Sample data

[uniformity]
addconts = 1
addhist = Min
autoreload = 1
bayer_shade = 1              1              1
bayeraw = 0
closefigs = 0
colorspace = 1
contopt = 1
contour = 2
contscale = 1
crop_borders = 0             10             10             10             15
deadp = 3
deadthr = 24             48
detail = 1
displaytype = 2
extrasmooth = 1
figsave = 1
filecomb = 0
folder = C:ImatestDataUniformity
fontsize = 10
gamma = 0.5
gridplot = 1              1
hdchan = 2
hist = Min
hotpx = 3
hotthr = 231             38
lastfiles = “UTEST001.rw3”
lightfallcrop = 2
manscale = 0              1              2              1             -4              0              2              1
nchan = 4
nht_save = 808           2336           2304           3448           1944            800            750           2448            113
normalize = 0
nwid_save = 1296           3504           3072           4592           2592           1280           1000           3264            114
pseudo = 2
resultsave = 1
roi = 21             21           1276            788              1              1           3504           2336              1              1           3072           2304              1              1           4592           3448              1              1           2592           1944              1              1           1280            800              1              1           1000            750              1              1           3264           2448             37             39             81             75
saveCSV = 1
saveJSON = 1
saveXML = 1
save_answer = No
save_dir = C:ImatestDataUniformityResults
save_file_list = 1  1  1  0  1  1  0  0  1  0  1  0
save_list = 1              0              0              0              0              0              0              0              0
scalemax = 1
shading = 3              1              1
shunits = 1
sideloc = 1
sidereg = 2
speedup = 1
xs = Min
xsnorm = 1
zoom = 2