Documentation – Current v23.2

eSFR ISO INI file reference

Current Documentation
View previous documentation
View legacy documentation
All documentation versions

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.

 

INI file settings for esfriso
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)
acquire imatest int Acquire image from instrument if specode==’dataq’. 0-10+. 0
  0=File; 1=Epiphan; 2=Omnivision; 43=Toshiba; 4=STM; 5=Graphin; 6=OnSemi DevWare; 7=Android; 8=Operator Console; 9=IP; 10=Sony
acutanceType sqf int Acutance CPIQ [1], Standard SQF [2] 1
agc16bit imatest int AGC (auto-lighten) dark 16-bit files 1
angle3D esfriso dec Azimuth & angle for 3D plots. -12 50
anlz_rough esfriso int Analyze edge roughness (slight slowdown) 0
anlz_sqf esfriso int Perform Acutance/SQF analysis 0
aper esfriso str Aperture: may be used for ISO sensitivity  
areanorm esfriso int Normalization for MTF area calculation for secondary readouts 1,2: 1 = unnorml; 2 = normalize to maximum. 2 2
bayeraw esfriso int Bayer RGB format (monochrome-only): 0-5 for [standard monochrome, R, Gr, B, Gb, demosaic] [IT] 0
bkgnd3d esfriso dec 3D background [f] 0.9
brawShift dcraw int Bayer RAW bit shift index: 1 for auto; 2-6 for 0, 2, 3, 6, 8 1
CA esfriso str Plot Lateral Chromatic Aberration (color images-only)[f] Max
calcNoise esfriso int Only calcNoise(1) is used in Imatest 5.2+ 1 0 0 30 20 0 50 20 0 1 1 0 0
   
chartht esfriso str Bar-bar chart height (SFRplus), reg mark spacing (SFRplus), or square height (Checkerboard) in cm for Field of View in cm and focal lth measurement  
chcontrast esfriso 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 esfriso int Close figures after save if 1. May prevent excessive figure buildup, which shows Imatest down.[IT] 0
colorchart esfriso int Analyze color chart 1
colorspace esfriso str Color space (determined by ncolor- not used?) sRGB
continue_on_error api int   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)
crop_borders esfriso int Border crop 0 0 0 0 0
csvbase_header esfriso int 1 or 2 line CSV database header 2
csvs esfriso int Save CSV files for individual ROIs if 1. 3
cyclesper_value esfriso 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]
dbase_plots esfriso int Database plots 0
debug api int   0
deconvFile esfriso str Deconvolution (chart compensation) file *.csv
deconvFolder imatest str Deconvolution (chart comp.) folder: no filesep at end C:\imatest\GUIProducts\ Trunk\depends\RTDepends
deconvParam esfriso dec Deconvolution (chart compensation) settings 0 0 0 0 0 0 0 0 0 0 0 0
defaultref esfriso int Default reference media for SFRplus or eSFR ISO. 1=nominal; 2=matte; 3=semigloss 1
demoz dcraw int Demosaicing algorithm for dcraw 1 1 0
derivCorr imatest int LSF derivative correction ISO 12233:2014(D.1) Strongly recommended (may remove) 1
disable_figs api int   0
disp3d esfriso int 3D display [f] 1
displayType sqf int Screen [1], Print [2], Ideal [3] 1
dispnoise esfriso int Noise display 1
distort_options esfriso int Distortion options 2 1 1
distort_params esfriso dec Predistorted chart correction parameters 0 0
distortionType imatest int TV Distortion type index: 1 fo SMIA, 2 for ISO. 1
edgecrop esfriso 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
edgeIDfile esfriso str EdgeID file  
edgeMTF esfriso str Display edge/MTF.[f] Min
edgerough esfriso str Plot Edge roughness [f] Min
emph2 esfriso int Emphasize (make bold) secondary readout in Edge/MTF plot [f] 0
esfrnoise esfriso int Noise plot eg} 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 esfriso int Expert (1) vs. basic mode (0) for parameters window [int] 1
fig_display_mode api int   0
figsave esfriso int Type of figure to save: 1 for png; 2 for fig [f] 1
filecomb esfriso int Combine files if >1 (for signal averaging) 0
foclth esfriso str (focal length from EXIF data. Use for cycles/angle)  
folder esfriso str Folder for Open image file dialogue box [int] C:\imatest\GUIProducts\ Trunk\source\
fovcalc esfriso int FoV extrapolation calculation 4
gamma esfriso 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
gray_ref esfriso int Grayscale stepchart reference value 1
grayrefolder esfriso str Last Grayscale stepchart reference file  
heightOrPct sqf int If true [1] image heights are calculated using percentage magnification 0
imageo esfriso str Plot Image and Geometry [f] Min
ini_file_date imatest str Set to run date in some modules. Informational. UNUSED?  
ini_version imatest int Doesn’t seem to be used for much. Deprecate? UNUSED?  
invert3d esfriso int 3D invert plot [f] 0
iso esfriso str (ISO speed settingfrom EXIF data)  
isostd esfriso str ISO 12233 standard calculation. Min or Max. Min
keepExt imatest int Keep file extension (jpg, png, …) when saving results 0
labcolor esfriso int L*a*b* color error plot [f] 0
lambdadiff esfriso dec Wavelength(um) for diffraction-ltd MTF (aper must be set) [f] 0.555
lastfiles esfriso str Last file list [int]  
Lastgrayrefile esfriso str Last Grayscale stepchart reference file  
Lastlabel esfriso str Last label in color reference box Last file: (none)
lenschart esfriso str Lens-to-chart distance cm for focal lth calc.  
lensmtf esfriso int Lens MTF plot 0
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
luxinc esfriso str Incident lux for ISO sensitivity/Exposure Index}  
lwlpd esfriso int 1 to display LW/PH, 2 for LP/PH 1
macadam esfriso int MacAdam or Delta-C ellipses 0 0 0
magnification esfriso 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
mirror esfriso int Mirror image 0
mod_apod esfriso int “Mod Apod” MTF noise reduction. Recommended. https://www.imatest.com/docs/sharpness/#noisered 1
Moire esfriso int Moire type. 1-9. 1=R-B; 2=R-B/mean(R,B) Smooth if <0 -1
multidisp esfriso 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 esfriso int Multi-ROI results selection: which variables to display. 1
  https://www.imatest.com/docs/rescharts_edge_results-3/#multiroi [f]
multitype esfriso str Multi-ROI plot type (1D, 2D, etc.)[f] 3
multiwedge esfriso int eSFR ISO multi-wedge plot [f] so} 0
n1090 esfriso int R1090 rise distance index: 1-5 for 10-90, 10-80, 10-70, 20-80, 20-70 1
ncolor esfriso int Color space index 1
nColormap imatest int Color map for pseudocolor plots [f] 1
negative esfriso int Negative image (light squares) for SFRplus 0
noiseCPIQ visnoise int CPIQ setting chosen in Visual Noise GUI: 1-6: 1 = None; 1
  2 = Small Print (h=10cm h, d-25cm, 600 DPI), 3 = Large Print (h=40cm, d=75cm, 600 DPI), 4 = Computer Monitor at 100% (d=60cm, 100PPI), 5 = 4.5″ Cell Phone (h=5.5cm, d=25cm, 330 PPI), 6 = 30″ 4k UHDTV (h=37.5cm, d=50cm, 146 PPI)
noisedist1 visnoise dec 1st Visual noise viewing distance cm 40
noisedist2 visnoise dec 2nd Visual noise viewing distance cm, empty if none  
noisedist3 visnoise dec 3rd Visual noise viewing distance cm, empty if none  
noiseheight1 visnoise dec 1st Visual noise viewing height cm 25
noiseheight2 visnoise dec 2nd Visual noise viewing height cm1  
noiseheight3 visnoise dec 3rd Visual noise viewing height cm  
noisehist esfriso str Plot noise histogram [f] Min
noisenonuniform imatest int Index of noise nonuniformity calculation. 1
noiseNorm esfriso int Noise normalization & x-axis settings. 1 1 0
noisepct1 visnoise dec 1st Visual noise % magnification, empty when height provided  
noisepct2 visnoise dec 2nd Vis noise % magn  
noisepct3 visnoise dec 3rd Vis noise % magn (optional). In Master, midway between 1 & 2  
noiseplot visnoise int Visual noise plot: 1 = sigma(L*u*v* or L*a*b*) and Vis noise 1
  2 = sigma(L*)-only; 3 = sigma(U* or a*)-only; 4 = sigma(v( or b*)-only; 5 = vis noise-only; 6 = L* and vis noise
noiseppcm visnoise dec pixels per cm resolution of the image 39.7
nomsg api int   0
nonuniformCorr esfriso int Slanted-edge nonuniformity correction 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
ois_enable esfriso int Optical Image Stabilization enable 0 0
other esfriso str System description (manually-entered) displayed in EXIF area [f]  
p3d esfriso int 3D plot type [f] 1
passFail api str    
pixelsper esfriso str Sensor pixel spacing or pitch in pixelsper units.  
pixunits_value esfriso int Index (1-3) for sensor spacing units: pixels/inch, px/mm, or um/pixel 3
  Example: for 4 um/pixel, use pixelsper = 4; pixunits_value = 3.
plot3d esfriso str 3D plot in sfrplus [f] Min
plotimage esfriso int Image plot type [f] 1
plotmax esfriso 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
pltrad esfriso int Radial (CA) plot parameters 1 1 1
pltsharp esfriso int Display oversharpening if 2 2
pop_edge esfriso int Edge plot type for Edge/MTF plot: [f] 1
  1-5 for Edge profile (norml, linearized), LSF, Edge (not lin), Edge (lin, UNnorml), …
pprofiles esfriso str Plot uniformity profiles Min
profile esfriso int Color uniformity profile type 1
psfPlotOption esfriso int PSF plot option 1
pxPerCm sqf dec Pixel per cm resolution of the image 100
rad_distort esfriso int [0 ,1] Radial distortion plot [f] 0
radius esfriso dec Radius for standardized sharpening (not normally needed) 2
rdnum esfriso str Secondary readout 1 MTF@ rdnum [IT] 0.3
rdnum2 esfriso str Secondary readout 2 MTF@ rdnum2 [IT] 0.2
rdnum3 esfriso str Secondary readout 3 MTF@ rdnum3 0.2
rdpct esfriso str Secondary readout 1 nn (%) for MTFnn or MTFnnP [IT] 30
rdpct2 esfriso str Secondary readout 2 nn (%) for MTFnn or MTFnnP [IT] 20
rdpct3 esfriso str Secondary readout 3 nn (%) for MTFnn or MTFnnP 20
rdtype esfriso 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 esfriso str Secondary readout 2 name: “MTF”, “MTF__P”, “MTF Area”, or “MTF @” [IT] (none)
rdtype3 esfriso str Secondary readout 3 name: “MTF”, “MTF__P”, “MTF Area”, or “MTF @” (none)
rdunit esfriso int Secondary readout 1 frequency unit index (1-3 for C/P, C/mm, C/in) [IT] 1
rdunit2 esfriso int Secondary readout 2 frequency unit index (1-3 for C/P, C/mm, C/in) [IT] 1
rdunit3 esfriso 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
ref_value esfriso int Color reference value 1
regmark_contrast_o-
pt
esfriso int Level of robustness to high scene dynamic range/low SFRreg target contrast. 0
  >0-2: The higher the value, the slower the runtime. so}
regmark_num esfriso int Extra reg marks & how to use them. so} 0
regmark_rotation_o-
pt
esfriso int Level of robustness to SFRreg target rotation. 0-2. The higher the value, the slower the runtime. so} 0
regmark_size esfriso int Minimum, maximum reg mark diameter in pixels so} 0 0
resultsave esfriso int Save results in subfolder Results of image file folder 1
RGBY_value esfriso 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
rmcn dcraw int Index of location of Red pixel in Bayer raw: 0-4 for unknown, R1C1, R1C2, R2C1, R2C2 0
roilth esfriso dec ROI length (slider) 0.85
roiMax esfriso str Max ROI for thru-focus batch.  
roisel esfriso int Index of ROI selection for automatic ROI detection. Depends on modulue. [IT] 4 1
roiwidth esfriso int ROI width 1
roiZones esfriso int ROI zones 70 80 0 0 0 0
satlvl esfriso int Saturation level (for dynamic range calculations) 1
save_dir esfriso str Folder for saving results [int] C:\imatest\GUIProducts\ Trunk\source\Results\
save_file_list esfriso int List of files to save (specific to module). Some extras1=Edge/MTF plot; (Still finding settings) 1 0 1 1 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
saveCSV esfriso int Save CSV file -99
savedel api int   0
saveHTML esfriso int Save HTML report 0
saveJSON esfriso int Save JSON file -99
savePDF esfriso int Save PDF report 0
scale3d esfriso dec Scale for 3D plots [f] -999
select3d esfriso int 3D plot selection (several plots) [f] 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
sfrrefine api int   0
SFRsuffix esfriso int Suffix for saving plots & summary CSV file 1
shift_dependent_ge-
ometry_recalc
esfriso int   1
shutter esfriso str Shutter speed: may be used for ISO sensitivity  
speedup esfriso int Speed up calculations (no histograms or Shannon capacity). Recommended. [IT] 1
splitcolor esfriso int Split color analysis plot [f] 0
SQF sqf str   Min
SQFmult esfriso str Plot multi-ROI Acutance or SQF. [f] Min
sqfopt sqf dec   3 1 2 3 5 0 0 0 0 0 1 2 2 1 1
stepchart esfriso int Analyze step chart 1
stepplot2 esfriso int Stepchart plot– bottom option [f] 1
toneabove esfriso int Tonal plot above noise plot 1
tones esfriso str Plot tonal response from grayscale stepchart Min
vhdisp esfriso int 1-3 for V, H, V+H (combined), V+H (separate fixed figures), Tangential, or Sagittal for Multi-ROI and 3D plots [f] 3
vhor esfriso int Vertical/Horizontal edge selection: 1-3 for V, H, V&H 1
viewSettings sqf dec [1] Fixed Viewing Distance, Varying Height 1
  (requires minDist, maxDist, readoutDist, pxPerCm AND readoutHeight OR readoutPct)
visnoisecalc visnoise int Visual noise calculation options: 1=no visual noise; 2 = ISO 15729; 3=CPIQ; 4=both 1
wedgecalc esfriso int Wedge calculation settings: wedgecalc(1) = 0 for off; 1 for on. 0 1 1 1 1 1
  wedgecalc(5) = 1-5: 4 basic, 4_4 inner, 4+4+8 corners, 1+4_10 corners, 4 inner-only.
wedgedisp esfriso int Wedge (eSFR ISO) Multi ROI display options [f] so} 1
wedgestyle esfriso int Wedge (eSFR ISO) Multi ROI display options [f] so} 1
winlarge imatest int Enlarge interactive windows [int] 0
xaxistype esfriso int Index of Noise x-axis plot units 1
zweights esfriso 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)