set_sheet_of_light_param算子详解

set_sheet_of_light_param( : : SheetOfLightModelID, GenParamName, GenParamValue : )
SheetOfLightModelID(input_control状态修改)sheet_of_light_model→(整数)
光板模型的手柄。
GenParamName(input_control)attribute.name→(字符串)
模型参数的名称，该参数应根据单光模型进行调整。
Default value: 'method'
List of values: 'ambiguity_solving', 'calibration', 'calibration_object', 'camera_parameter', 'camera_pose', 'lightplane_pose', 'method', 'min_gray', 'movement_pose', 'num_profiles', 'offset_x', 'offset_y', 'offset_z', 'scale','scale_x', 'scale_y', 'scale_z', 'score_type'
GenParamValue(input_control)attribute.value(也参与)→(字符串、整数/真实)
模型参数的值，该参数需要为光薄板模型进行调整。
默认值:“center_of_gravity”
Default value: 'center_of_gravity'
List of values: 1.0, 1e-2, 1e-3, 1e-6, 'brightest', 'center_of_gravity', 'cm', 'default', 'first', 'intensity', 'last', 'm', 'microns', 'mm', 'none', 'offset_scale', 'um', 'width', 'xyz', 'xz'


算子作用：用于设置或更改单张片光模型的单个参数，以便使模型适应特定的测量任务。除了内部的相机参数“camera_parameters”和以下的pose“camera_pose”、“lightplane_pose”和“movement_pose”之外，所有参数都可以在创建带有create_sheet_of_light_model的光单板模型时进行设置。可以用操作符get_sheet_of_light_param来查询当前的亮片模型的配置。由query_sheet_of_light_params返回一个列表，其中包含可以为sheet- light模型设置的所有参数的名称。


GenParamName：可选参数
‘method’定义文件的位置，值‘default’和‘center_of_gravity’均采用相同的方法，通过计算满足条件的所有像素的灰度值的重心，以亚像素精度逐列确定轮廓的位置
    ‘min_gray’:最低的灰度值考虑到测量的位置(参见“center_of_gravity”)。
“num_profiles”:在光板模型中分配了内存的配置文件的数量。默认情况下，“num_profiles”设置为512。如果超过了这个配置文件的数量，那么在测量期间内存将被自动重新分配。
“ambiguity_solving”:如果轮廓位置的确定不明确，则用于确定应选择哪个候选人的方法。“first”:返回遇到的第一个候选者。这种方法是最快的。“last”:最后一个遇到的候选者被返回。“brightest”:对于每个候选，计算轮廓的亮度，返回亮度最高的候选。亮度的计算依据如下:      其中为像素的灰度值，n为确定轮廓位置所考虑的像素个数。
默认值:“第一次”


“score_type”:方法，用于计算测量轮廓位置的分数。“无”:不计算分数。“width”:对于视差的每个像素，分数值设置为用来确定视差值的像素数。“intensity”:对于视差的每一个像素，通过计算轮廓的局部强度来评估分数值，依据:  其中为像素的灰度值，n为确定轮廓位置所考虑的像素个数。
默认值:“没有”






测量的校准:
'calibration':校正变换应用于视差图像的范围:
“none”:不应用任何校准转换。
“xz”:测量系统(摄像机和放映机)的几何性质的标定变换被考虑在内，但是测量过程中物体的运动没有被考虑进去。
“xyz”:描述测量系统(照相机和放映机)的几何特性的校准转换，以及描述测量过程中物体运动的转换被考虑在内。
“offset_scale”:描述设置的一组简化参数，可以与默认参数一起使用，也可以由六个参数控制。有三个参数描述了各向异性的缩放:“scale_x”描述了一个像素按列方向缩放到新的x轴，“scale_y”描述了两个轮廓之间的线性移动，“scale_z”描述了将测量到的视差缩放到新的z轴。其他三个参数描述结果x、y、z值的参考系的偏移量('offset_x'、'offset_y'、'offset_z')。
默认值:“没有”
“camera_parameter”:
用于测量的摄像机的内部参数。如果校准范围被设置为“xz”或“xyz”，则需要这些参数。
“calibration_object”:
用于校准的校准对象。如果校准使用了校准，则必须将这个参数设置为使用create_sheet_of_light_calib_object创建的校准对象的文件名。
“camera_pose”:
将摄像机坐标系统转换为世界坐标系统的姿态，即，可以将世界坐标系中的点坐标转换为摄像机坐标系的姿态。如果校准范围被设置为“xz”或“xyz”，则需要这个姿势。
注意，世界坐标系是通过设置“camera_pose”定义的。
“lightplane_pose”:
将光面坐标系转换为世界坐标系的姿态，即，可以用来将世界坐标系中的点坐标转换为光面坐标系的姿态。必须选择光面坐标系，使平面z=0与光面重合。如果校准范围被设置为“xz”或“xyz”，则需要这个姿势。
“movement_pose”:
一种姿态，表示物体在两个连续的轮廓图像之间相对于由摄像机和激光器建立的测量系统的运动。这个姿势必须用世界坐标系来表示。如果校准范围被设置为“xyz”，则需要这样做。
“规模”:
有了这个值，您可以缩放三维坐标X, Y和Z，当将校准转换应用到视差图像时。模型参数“比例”必须指定为期望单位/原始单位的比率。原单位由标定物体的坐标决定。如果原始的单位是米(如果你使用标准的校准板)，你可以通过选择“m”、“cm”、“mm”、“微米”或“um”直接将“scale”设置为所需的单位。
建议值:“米”、“厘米”,“毫米”,“微米”,“嗯”,“1.0”,0.01,0.001,1.0 e-6
默认值:1.0
“scale_x”:
这个值定义了3D空间中像素的宽度。设置此值可重置“camera_parameter”或任何设置的值，并根据“offset_scale”校准模型对其进行初始化。
建议值:10.0,1.0,0.01,0.001,1.0e-6
默认值:1.0
“scale_y”:
这个值定义了三维空间中两个剖面之间的线性移动。设置此值将重置“camera_parameter”或任何姿势的任何值集，并根据“offset_scale”校准模型初始化它们。
建议值:100.0、10.0、1.0、0.1、1.0e-6
默认值:10.0
“scale_z”:
这个值定义了3D空间中像素的高度。设置此值将重置“camera_parameter”或任何姿势的任何值集，并根据“offset_scale”校准模型初始化它们。
建议值:10.0、1.0、0.01、0.001、1.0 -6。
默认值:1.0
“offset_x”:
这个值定义了3D结果参考帧的x偏移量。设置此值将重置“camera_parameter”或任何姿势的任何值集，并根据“offset_scale”校准模型初始化它们。建议值:10.0,0.0,0.01,0.001,1.0e-6
默认值:0.0
“offset_y”:
这个值定义了xyz结果的参考系的y偏移量。设置此值将重置“camera_parameter”或任何姿势的任何值集，并根据“offset_scale”校准模型初始化它们。建议值:10.0,0.0,0.01,0.001,1.0e-6