Imatest ini 参数介绍

ini配置文件内容对于Imatest Master来说不是很重要,因为Master拥有独立的GUI界面,只需要通过手动勾选或填写某些参数即可完成分析;但对于Imatest IT来说,ini配置文件就是IT的基础,完整的分析方法、输出结果全不取决于ini配置。ini配置文件可由Master进行一次完整分析后导出(如何获取Imatest IT所需各模块ini配置文件 – 知识库:图像质量与色彩技术资料 (colorspace.com.cn),如果熟悉ini的组成参数与对应内容含义,也可自行编写ini文件应用于Imatest IT。

一、ini文件结构

INI文件是文本文件,其结构如下
●小节标题放在括号内([…])
●数据行的形式是name = value,例如,nwid_save = 2601
●注释行以分号开始
Value值可以是一个数,一个数组,或一个字符。
[section]
name1 = value1
name2 = value2
;注释行

[next_section]
例如
dispwelcome = 1表示在Imatest启动时显示欢迎界面。
edfile是图像编辑器的路径,用于显示交互式模块(Rescharts等)中的保存内容。

路径规则
为了符合Imatest 4.2 INI文件的更新,所有的反斜线/都被双反斜线代替。
[imatest]
dispwelcome = 1
exiftool = 2
expandplt = Min
fontsize = 10
readexif = 1
shrink_largef = 1
edfile = C:\\Program Files\\…
[sfr]
filecomb = 0
folder = C:\\Imatest\\…
save_dir = C:\\Imatest\\…

二、[api] :影响Imatest IT的参数

[api]是在Imatest Master中设置的,从Imatest主窗口点击设置->IT设置,打开Imatest IT设置窗口。请注意,API是Imatest IT的原名。设置影响Imatest IT/EXE和IT/DLL。

Imatest IT设置窗口

参数内容:

参数设置窗口典型值[默认值]描述
nomsg不显示进度条…… “0 or 1 [0]1:禁用所有的warning信息
savedel保存后总是关闭图片0 or 1 [0]1:在保存图片后总是关闭图片显示
sfrrefine在SFR中自动优化ROI…0 or 1 [0]1:SFR模块的自动区域优化
disable_figs禁止所有图片0 or 1 [0]1:禁用所有图片
continue_on_error如果遇到错误,继续运行批处理(仅适用于IT)0 or 1 [0]1:在遇到error时继续运行批处理
passFailPass/fail ini 文件Pass/Fail criteria的完整路径文件内容(ini格式)参考:https://www.imatest.com/docs/it-passfail/
fig_display_mode图片显示模式下拉菜单1, 2, 3 [1]选择1显示所有图片,2创建隐藏图片,或3禁用所有图片

三、[dcraw]:使用LibRaw解Raw图分析

LibRaw窗口是LibRaw程序的GUI前端。它用于转换原始文件(CR2、NEF、ARW等),并进行最小的信号处理(即没有锐化或降噪)。LibRaw通过命令行操作,参考dcraw manpage。注:该模块已被废弃,但为了向后兼容,部分名称被保留下来。

参数设置窗口典型值[默认值]描述
bayercols(单色图像设置窗口中的像素颜色映射弹出菜单)1-5 [1]Bayer原始图像中像素和颜色之间的映射。1:未知;2-5。R1C1, R2C2, R2C1, R2C2中的红色。
bdep-4对应于位深的命令行字符串。”:8位;’-4’:16位线性; ‘ -6 ‘:16位。见manpage。
brawShift(单色图像设置窗口中的位移弹出菜单)1-6 [1] (index)位移:1为自动;2-6:分别为0、2、4、6、8位。
colorspace输出色彩空间索引0-5 [1]与色彩空间相对应的索引(0-5):manpage中描述的-o选项
csps– (来自色彩空间)‘ -o 1 ‘与色彩空间相对应的保存的字符串。’-o -n’如果选择了去马赛克;’-D’或’-D 6’则不去
dcgamma输出伽玛下拉菜单1-5 [2]索引:1=默认(BT.709(-g 2.222 4.5));2=1.0(线性);3=1.8(Apple等);4=2.2;5=sRGB(接近2.2)
delfile删除已保存的文件(复选框)[0] 0 or 1如果选中,在读取分析后删除保存的文件
folder读取LibRaw的最后一次文件夹的名称
imgpath图片路径
lastfiles最后一次分析图片路径
libraw程序(下拉菜单)1-3 [3](已被删除,因为dcraw已不再使用)
nwb白平衡1-3 [1]Index: 1 = cemera; 2 = “gray world”; 3 = none
ppm保存为PPM…复选框0 or 1 [0]0 = save file as TIFF; 1 = save file as PPM.
preset预设(单选按钮)41 = Color 24-bit sRGB; 2 = Color 48-bit Adobe; 3 = Bayer 48-bit linear; 4 = Manual settings (Enable all)
qual质量(质量是指指数-1)0-4 [0]qual-1 = n在qual > 0的情况下被转换为命令行字符串’-q n’。 qual = 0的情况下默认为空白字符串。 见插值选项的手册
rawconv去马赛克1-3 [1]去马赛克指数。1 = 正常RAW转换;2 = 8位无马赛克;3 = 16位无马赛克
rawraw(设置在Read Raw)‘raw’ or other如果是’raw’,则用libraw处理扩展名为.raw的文件。否则用ReadRaw处理
rmcn0-4Bayer(未镶嵌)图像中红色像素的位置。0=未知,1:红色在R1C1,2:红色在R1C2,等等
save‘ ‘ [blank]‘ ‘
wb— (from nwb)[‘ -w ‘]与nwb(白平衡指数)对应的字符串。1 = ‘-w’(相机);2 = ‘-a’(平均);3 = “(无)。参见手册
whitelvl自动白电平(复选框)0 (off) or 1 [1]自动白电平,如果是1的话
whitenorm通过(指数)对(白电平)进行归一化处理1-7 [2]根据whitenorm,规范化为{1.0,1.01,1.05,1.10,1.25,1.50,2.0}

三、[rdraw]读取Raw数据

当读入二进制raw图像文件时,[rdraw]会影响所有Imatest模块(直接或从存储文件)。设置是基于文件扩展名的(下面用黑体字显示)。由于最多可以保存16个文件扩展名,大多数变量有16个条目,用*16表示。对于这些设置,第n个值是相互对应的。

参数特征值描述
bitshift1-10 (index *16)位移的索引:1=自动;2-10=0,-2,-4,-6,-8,2,4,6,8。用作GUI索引;不用于实际位移计算。例子:使用bitshift = 9来移位6位的值。(当10比特的精度存储在16比特中时,已经使用了这个值)
bitshift_num-8 to 8 (-99 for auto) (*16)实际要移位的位数(-99表示自动)。用于实际的位移
decompandFile[file name] or _nul_用于反编译文件的文件名(完整路径名)。如果没有,则为_nul_。在RAW文件–反编译中有描述
demoz1 or 2 (*16)1:使用Matlab的简单算法对图像进行解马赛克处理算法 2:将图像保持为Bayer原始格式
endian1 or 2 (*16)Endian(字节顺序)设置索引(不适用于uint8(一个字节)输入)。用作GUI的索引
endian_strieee_le or ieee_be (*16)Endian(字节顺序)字符串。用于打开文件进行读取。见http://en.wikipedia.org/wiki/Endianness
extensionraw, rw1, … (*16)文件的扩展名(最多 4 个字符),指定文件的解码方式。最多可存储16个扩展名。一个参数(bitshift_num、height等)的第n个值对应于第n个扩展名。由于RAW通常用于各种格式,因此通常建议将扩展名改为更容易识别的名字
heightnumber (pixels)图像的高度,单位是像素
inpix_size1, 2, or 3 (*16)输入像素大小:1为uint8(8-位),2为uint16(16-位),3为uint32
nexten1-8 (index *16)GUI中显示的扩展
nskipinteger [0] (*16)文件开头要跳过的字节数
nskipendinteger [0] (*16)文件末尾要跳过的字节数
nunpackinteger在文件末尾要跳过的字节数(未使用)将来可能用于解包位
offset0以像素为单位的偏移量:从像素水平上减去。我们见过一些传感器的偏移量为64-bit
outpix_size1 or 2 (*16)输出像素大小:1为uint8(8-位)或2为uint16(16-位)
precisionstring格式为uintm=>uintn的字符串,其中m和n为8或16
rawraw (in [draw]raw or other如果设置为 “raw”,文件扩展名 “raw”(一种不常见的Leica格式)将被LibRaw处理。我们建议将其设置为另一个字符串,如 “CR2”
rmcn1-4 (index *16)Bayer RAW图像中红色像素的位置。1 = R1C1的红色;2 = R1C2的红色;3 = R2C1的红色;4 = R2C2的红色。这些对应于Matlab去马赛克程序中的’rggb’、’grbg’、’gbrg’和’bggr’
rotateimg1-8 (index *16)旋转转换后的图像:1-4 = 0°, 90°, 180°, 270° CCW(无镜像);5-8 = 0°, 90°, 180°, 270° CCW(有镜像)
savefmt1-7 (index)转换后的RAW文件的保存格式和条件。1 = 无(从不保存);2 = PNG(总是保存);3 = JPEG(总是保存);4 = PNG(仅转换/测试);5 = JPEG(仅转换/测试),6 = TIFF(总是保存);7 = TIFF(仅转换/测试)。1、4、5、7可以用在不需要保存转换后的文件的地方(如IT)
testfolderfolder name最后一个用于读取RAW的文件夹
transpose1 [1] (*16)对行和列进行移位。在实践中,总是对[1]
whitebal1-3 (index) (*16)白平衡。1=无;2=简单的灰色世界–变暗;2=简单的灰色世界–变亮
whitelvl1,2 (*16)白色水平。1 = 无变化;2 = 自动:99%的饱和度
widthnumber (pixels) (*16)图像的宽度,单位是像素

四、在大多数模块中都使用的参数—次要读数

用于清晰度模块。[sfr], [sfrplus], [logf], [logfc], [random], [star], [wedge]。

次要读数界面(如右图所示)控制MTF图中的次要读数显示。主要读数是MTF50(50%对比度的空间频率)。三个次要读数都有几个选项,第一个默认为MTF30(MTF为30%的空间频率)。第三种仅用于SFRplus镜头式MTF图

1.每个读数的上方选项(MTF)表示MTFnn,即MTF为其低频值的nn%的空间频率。

2.第二个选项表示MTFnnP,即MTF为其峰值的n%的空间频率:主要针对过度锐化的斜边。

3.第三个选项(MTF @ )表示 MTF @ f 单位,其中 f 是空间频率,单位为 Cycles/pixel、LP/mm 或 LP/in。如果你选择LP/mm或LP/in,像素间距应在输入对话框的Plot部分的Cycles per…行中指定。如果省略了像素间距,将提示一个warning信息。

4.第四个选项(MTF Area)表示MTF曲线下的面积(低于奈奎斯特频率)。当它被归一化为峰值 MTF 时,它会跟踪 MTF50 以进行低到中等锐化,但与 MTF50 不同,它对于过度锐化的图像保持不变。在斜边MTF测量的一致性中进行了描述。

参数典型值[默认值]描述备注
areanorm[2 2]MTF面积图的归一化主要和次要读数的MTF区域图的类型。1:未归一化,2:归一化(一般首选;当没有频域过冲时与MTF50相似
rdtypeMTF
MTF_P
MTF@
MTF Area
(none)
第一个次要读数名称
rdtype2同上第二个次要读数名称
rdtype3同上;通常为 (none)第三个次要读数名称仅用于镜头式MTF图
rdpct10-80 [30]第一读数百分比MTFnn 或 MTFnnP 的百分比 nn 同上示例:对于 rdtype = MTF__P, rdpct = 20, rdunit = 4, 次要读数1 为 MTF20 (C/P)
rdpct2第二读数百分比同上
rdpct3第三读数百分比同上
rdnum数值第一个读数的MTF@数值这个数字取决于rdunit中的单位(如下)。例如:对于rdtype = MTF @, rdnum = .25, rdunit = C/P。 次要读数将是MTF @ .25 C/P
rdnum2第二个读数的MTF@数值同上
rdnum3第三个读数的MTF@数值同上
rdunit1 for C/P
2 for LP/mm
3 for LP/in
4 for LW/LW/PH
(见备注)
第一个读数的单位与rdunit对应的值:{‘C/P’; ‘LP/mm’; ‘LP/in’; ‘LW/PH’; ‘LP/PH’; ‘C/rad’; ‘C/deg’; ‘C/Obj mm’; ‘C/Obj in’}
rdunit2同上第二个读数的单位同上
rdunit3同上第三个读数的单位同上

五、其它参数

参数设置窗口典型值[默认]描述
bayeraw— (由单色图像设置窗口中的几个设置)0-5 [0]如果>0,单色文件包含Bayer RAW数据。1-4,表示要分析的主要颜色(R、Gr、B、Gb)。5表示Demosaic
closefigs由保存界面中的保存后关闭数字复选框设置0 or 1 [0]1推荐用于IT(保存后关闭窗口)
figsave在保存图片为PNG或FIG窗口的下拉菜单中设置1 or 2 [1 recommended]要保存的图的类型(PNG或FIG)。不建议保存FIG文件,因为需要更多的存储空间
filecomb当选择多个文件进行分析时设置0 or 1 [0]0:批量读取和分析文件,1:合并文件(信号-平均)
folder在读取图像文件时设置(路径)最后输入图像的文件夹
nchan通道弹出菜单1-4要分析的通道:1-4: R、G、B、Y(亮度)
nht_save在图像读取过程中设置2448 …最近图像的高度,以像素为单位。可能有多个
nwid_save在图像读取过程中设置3264 …最近的图像的宽度,以像素为单位。可能有多个
plot_image在设置窗口的图像读图过程中设置复选框1 0 0 0 0 0
roi在区域选择时设置(主要在微调窗口)1 1 3264 2448 (typical)以像素为单位的ROI区域(裁剪)。 [x1 y1 x2 y2] 4 组,每组对应 nht_save 和 nwid_save 中的一个数值
save_answer保存界面-主要答案(未使用)Yes, No保存的设置没有使用
save_dir在保存界面中设置(文件夹名称)用于保存结果的最后一个文件夹
saveCSV保存界面0 or 1 [-99 =忽略]保存CSV结果。覆盖save_file_list.
saveJSON保存界面0 or 1 [-99 =忽略]保存JSON结果。覆盖save_file_list
saveXML保存界面0 or 1 [-99 =忽略]保存XML结果。覆盖save_file_list
save_file_list保存界面[1 1 1 0 0 0 0 0 0 0]如果元素设置为1,要保存的结果列表:不同的模块中细节不同
speedup加速复选框0 or 1 [1]如果设置为1,则跳过几个计算,以加快操作速度。不同模块有所不同

Was this helpful?

3 / 0

http://xzh.i3geek.com
发表回复 0