Color/Tone sdr-36 ini file reference

INI file settings for Color/Tone sdr-36

For more information on how to use INI files in Imatest IT, we recommend the Imatest INI File Reference. See also Saved settings - Imatest.ini and INI files for use with Imatest IT

For Imatest IT, most of the entries in the table 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). Some have extra value to facilitate future expansion. To extract an INI control file for Imatest IT from the default Imatest Master INI file (imatest-v2.ini), we recommend the procedure described in Extracting an INI file from imatest-v2.ini for Imatest IT.

In Imatest 5.2+, Color/Tone Auto has been renamed Color/Tone Auto, but 'multitest' will still be used in the ini file. Run Color/Tone Auto with the chart to be used for IT prior to extracting the ini file from imatest-v2.ini (which contains everything from Master runs).

This document was created by running Color/Tone Auto sdr-36 in Imatest 5.2.0. ALPHA on 06-Jun-2019 22:12:40.

BackgroundMeaning
YellowYellow background: Important to Imatest IT. Parameter and Description are in boldface. [IT]
CyanCyan background: Figure settings. (Figures are used infrequently for IT.) [f]
GrayGray background: For interactive operation. No effect on IT.
ClearClear background: Results details (units, scaling, etc.) for CSV and JSON output,
or not yet categorized. May affect IT results.
INI file settings for Color/Tone Auto (multitest) sdr-36
ParameterSectionTypeDescriptionDefault value(s)
acquireimatestintAcquire 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
altchartColor/Tone AutogamutintIndex of grayscale chart for Color/Tone Auto. Distinguish from Color/Tone Interactive.NaN
altchartypegamutintLast grayscale chart type1
aperture_savegamutstr  
aperture_savesdr-36str  
auto_expressimatestintExpress mode for Auto ROI detection. [int]0
autoreloadgamutintContinuous reload1
autoroisdr-36intAuto region selection for this section1
autoroi_allimatestintAuto ROI detection for all supported modules.2
axis3dgamutintD plot axis setting4
axtightgamutintExpand axis for 3D L*a*b* plot. 0 or 1. [f]0
bayerawsdr-36intBayer RGB format (monochrome-only): 0-5 for [standard monochrome, R, Gr, B, Gb, demosaic] [IT]0
bk3dgamutdec3D background0.3
bkvectgamutdecVectorscope background. 0-1 [f]0.2
brawShiftdcrawintBayer RAW bit shift index: 1 for auto; 2-6 for 0, 2, 3, 6, 81
bwplotgamutintBW plot type [f]1
calcNoisegamutintDon't use. (???)1 0 0 30 20 0 50 20 0 1 1 0 0
calcNoisesdr-36intVisual noise calculations. Only element (1) used in 5.2+.1 0 0 30 20 0 50 20 0 1 1 0 0
cdpParamsgamutdecCDP (Contrast Detection Probability) Params (have some extra)1 0 0 0 0 0 0 0 0 0
CDPstatsgamutint 0 0
chartClassgamutintColor/Tone Interactive (Color/Tone Setup) Chart class: 1 = color, 2 = multi-row gray, 3 = linear gray1
chartClassMultites-
t
gamutintColor/Tone Auto (Color/Tone Auto) Chart class: 1 = color, 2 = multi-row gray, 3 = linear gray1
chartColor/Tone AutogamutintIndex of color chart for Color/Tone Auto. Distinguish from Color/Tone Interactive.NaN
chartviewgamutint 3
chartypegamutintFor handles.chartype. Pre-5.21
chromultgamutdecChroma multiplier for reference (for increasing/reducing chroma)1
closefigssdr-36intClose figures after save if 1. Minimize figure buildup, which slows operation.[IT]0
color_mx_gammagamutdecColor matrix input gamma0.5
color_mx_weightsgamutdechandles.color_mx_weights0
color_mx_wt_filegamutstrhandles.color_mx_wt_file 
colorspacesdr-36strColor space (determined by ncolor- doesn't need to be entered)sRGB
defaultrefgamutintDefault reference media for SFRplus or eSFR ISO1
demozdcrawintDemosaicing algorithm for dcraw1 1 0
dfzgamutint 10
difpltgamutintColor difference (Delta) plot1
disable_figsapiintNo figures in IT (~interactive>0).0
displayNumsgamutintShow patch numbers in split & pseudocolor displays [f].0
displayrightsdr-36intDisplay thumbnails & EXIF data on right of Color/Tone Auto plots [f]1
dispnoisegamutintNoise display.1
dispnoise2gamutint 1
dispvectgamutintVectorscope reference display. [f]2
distortsdr-36decDistortion for region fine selection: (-) for barrel. Up to 20 values for files from newest to oldest, identified by roi.0
dngDirectimatestintAdobe DNG file handling. Set in Options II.1 0 0
dpxrgbimatestintR-B reversal for DPX files0
exiftoolimatestintEXIF read selection. /26.1/imatest_instructions#exif1 1
 exiftool(1) = 0 (no EXIF), 1 or 2 (use Phil Harvey's ExifTool), 3 (Matlab built-in).
expandpltimatestintExpand fixed-module figures. 0=none; 1=1.25x; 2=1.5x. [f]0
fig_display_modeapiintHow figures should be generated in IT (c.f. FigureDisplayMode.m)0
figsavesdr-36intType of figure to save: 1 for png; 2 for fig [f]1
filecombgamutint 1
filecombsdr-36intCombine files if >=1 (for signal averaging) [int]0
fillfsdr-36decLinear fill factor for region selection. Up to 20 values for files from newest to oldest, identified by roi.0.7
foldersdr-36strFolder for Open image file dialogue box [int]C:\imatest\GUIProducts\ Trunk\source\
fontsizegamutint 10
getfileoptimatestintGet file dialog box option1
globfoldimateststrUse a global folder for reading images, rather than a folder for each module.[int]Min
globsaveimateststrUse a global folder for saving results, rather than a folder for each module.[int]Min
grayscgamutdec 0.4
hslightgamutdecHSL lightness. Floating point [f]0
hslplotgamutintHSL plot type3
iccfoldergamutstrICC profile folderC:\Windows\System32\ Spool\Drivers\Color\
imatestgamutstrLocation of image editor for saving screens [int]Enter image editor pathname here.
instarunimatestintNew cropping indicator [int]0
IT8regiongamutint 1
keepExtimatestintKeep file extension (jpg, png, ...) when saving results0
lastdensgamutdecLast density0.1 0.2 0.31 0.43 0.56 0.7 0.87 1.05 1.27 1.53 1.86 2.3
lastfilesdr-36str (none)
lastfilessdr-36str  
lastfullsdr-36str C:\imatest\GUIProducts\ Trunk\source\
lasttypesdr-36str --
lightgamutint 1
lum_coeffsimatestdecLuminance (Y-channel) coefficients & index [IT]0.2125 0.7154 0.0721 2
luxincgamutstrIncident lux for ISO sensitivity/Exposure Index} 
mirrorsdr-36int0 = not mirrored; 1 = mirror image0
multitest_namegamutstrColor/Tone Auto button name (changes...)Color/Tone Auto
mx_lingamutintColor matrix linearization. Start with color sp gamma.1
mx_mxngamutintColor matrix size2
mx_optgamutintColor matrix optimization Start with Delta-E 94.3
mx_weightgamutintColor matrix weighting scheme: 1 equal; 2 L*.1
mxngamutintGeneral mxn grid size4 6
ncircgamutintIndex of number of squares in circle pattern5
ncolorsdr-36intIndex of color space: 1=sRGB; 2=Adobe RGB; ...1
nColormapimatestintColor map for pseudocolor plots. 1-6. Set in Options II. [f]1
nht_savesdr-36intPrevious ROI height: used for "Repeat ROI?" [int]0
noiseCPIQvisnoiseintCPIQ 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)
noisedist1visnoisedec1st Visual noise viewing distance cm40
noisedist2visnoisedec2nd Visual noise viewing distance cm, empty if none 
noisedist3visnoisedec3rd Visual noise viewing distance cm, empty if none 
noiseheight1visnoisedec1st Visual noise viewing height cm25
noiseheight2visnoisedec2nd Visual noise viewing height cm1 
noiseheight3visnoisedec3rd Visual noise viewing height cm 
noisenonuniformimatestintIndex of noise nonuniformity. 1=new calc.; 2=no corr. (simple sigma)1
noiseNormgamutintNoise normalization & x-axis settings.1 1 0
noisepct1visnoisedec1st Visual noise % magnification, empty when height provided 
noisepct2visnoisedec2nd Vis noise % magn 
noisepct3visnoisedec3rd Vis noise % magn (optional). In Master, midway between 1 & 2 
noiseplotvisnoiseintVisual noise plot: 1 = sigma(L*u*v* or L*a*b*) and Vis noise1
  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
noiseppcmvisnoisedecpixels per cm resolution of the image39.7
nomsgapiint 0
nonualgorithmgamutintNonuniform corr algorithm.1
nonucorrgamutintTurn on nonuniformity correction if 1.0
nonufilegamutstrNonuniform corr file. 
nonugamcolspgamutintUse color space gamma if 1.0
nonugammagamutdecEstimated gamma for nonuniformity correction for Color/Tone, Colorcheck, Stepchart.0.5
nonulevelgamutintNonuniform corr level setting.1
nonusavegamutintSave corrected file.1
nwid_savesdr-36intPrevious ROI width: used for "Repeat ROI?" [int]0
offsetgamutint 0
OpenGLimatestintOpenGL setting: software, hardware1
passFailapistrPass/fail file name [IT] 
plot3Dtypegamutdec3D image plot type & limits. Extra entries [f]2 -150 0 0 0
plotimagegamutintImage plot type: 1-26: Original, single channel, saturated, lightened, etc. [f]1
plotlistsdr-36intColor/Tone Auto plot list: set in multitest_setup0 0 0 0 0 0 0 0 0 0 0 0
pltresgamutintPlot resolution used in 3D L*a*b* plot1
progmgamutstrModule For handles.chartype==3 % Module_saveST-52
readexifimatestintRead EXIF data from image file1
ref_valuesdr-36intChart reference value index1
Refilesdr-36strReference file 
resultsavesdr-36intSave results in subfolder Results of image file folder1
rmcndcrawintIndex of location of Red pixel in Bayer raw: 0-4 for unknown, R1C1, R1C2, R2C1, R2C20
roisdr-36intSaved ROI1 1 1 1 1 1 1 1
rowsumgamutintColor matrix constraint: none, rows or columns sum to 1.1
run_matrixsdr-36intRun color matrix in generic_module0
satlvlgamutintSaturation level index: 1-3 for [.98 .98*235/255 .98*max(rgb_Yplot)]1
save_answersdr-36str Yes
save_dirgamutstrdirectory for saving plotsC:\imatest\GUIProducts\ Trunk\sourceResults\
save_dirsdr-36strFolder for saving results [int]C:\imatest\GUIProducts\ Trunk\source\Results\
save_file_listsdr-36int 1 1 1 1 1 0 0 0 0 0 0 0 0 0 0
saveCSVsdr-36intSave CSV file-99
savedelapiintAlways close figures after saving them [IT]0
saveHTMLsdr-36intSave HTML report0
saveJSONsdr-36intSave JSON file-99
savePDFsdr-36intSave PDF report0
second_2d_plotsdr-36intSecond 2D plot2
shutter_savegamutstr  
shutter_savesdr-36str  
stepatchstepchartintNumber of patches for Linear grayscale stepcharts20
stepplot2gamutintLower stepchart plot1
thumbDisplaygamutintThumbnail display type: 2 for image crop. [f]3
toneabovegamutintAdd Tone plot above Noise plot. [f]1
transparencygamutdecTransparency for 3D L*a*b* plot0
vectcolsgamutintVectorscope colorimetry. [f]1
versiongamutstrImatest version for compatibility (changed in 5.2).0.0
visnoisecalcvisnoiseintVisual noise calculation options: 1 = No visual noise calculation;2 = Calculate ISO 15739 visual noise; 3 = Calculate CPIQ Visual Noise; 4 = Calculate both ISO, CPIQ Visual Noise.;1
winlargeimatestintEnlarge interactive windows [int]0
wiregamutintwire frame color1
xaxistypegamutintIndex of Noise x-axis units. 1-5: Log exp, Lux, dB, Log exp, F-stops [f]1
xy_illumgamutdec 0 0
xy_lastgamutdec 0.38 0.38
xybdrygamutint 1
xycolorgamutint 1
xyzmatrixgamutintCalculate xyY matrix if 2; rgb if 1. xyY may be better (?)2
ParameterSectionTypeDescriptionDefault value(s)