SaigeInferenceOption¶
#include <SaigeVisionAPI.h>
包含推理选项的结构体。
See also: SaigeGetInferenceOption, SaigeSetInferenceOption
Public Attributes¶
| Type | Name |
|---|---|
| bool | calcTime (Common) 决定是否显示推理API执行的详细时间。 |
| int | batchSize (Common) 每次推理执行处理的图像数量。 只能在创建推理句柄时通过 SaigeHandleConfig设置。 |
| const char * | oversizedImageHandling (SEG, IEN) 指定如何处理大于 SaigeHandleConfig中设置的检查大小的图像。 分割支持SAIGE_DO_NOT_INSPECT、SAIGE_RESIZE_TO_FIT和SAIGE_CROP_INTO_TILES选项。 图像增强支持SAIGE_DO_NOT_ENHANCE和SAIGE_CROP_INTO_TILES选项。 |
| int | inspectionSizeWidth (SEG, OCR, IEN) 用于推理的图像宽度。 只能在创建推理句柄时通过 SaigeHandleConfig设置。 |
| int | inspectionSizeHeight (SEG, OCR, IEN) 用于推理的图像高度。 只能在创建推理句柄时通过 SaigeHandleConfig设置。 |
| float[ ] | additionalScores (CLS) 每个类别的附加分数值。 设置在 n索引处的值会为第n类授予额外分数。 |
| bool | calcClassActivationMap (CLS) 如果在推理过程中将其设置为 true，则会计算类激活图。 |
| int[ ] | maxNumOfDetectedObjects (DET) 要检索的检测到的对象的最大数量。 如果检测到的对象数量超过此值，则分数较低的对象将被排除在最终结果之外。 |
| bool | calcScoremap (SEG) 如果在推理过程中将其设置为 true，则计算分数图。 |
| bool | calcObject (SEG, IAD) 如果在推理过程中将其设置为 true，则计算分段对象。 |
| bool | calcObjectAreaAndApplyThreshold (SEG, IAD) 如果设置为 true，则计算分段对象的面积。 面积小于对象面积阈值的分段对象将被排除在最终结果之外。 |
| bool | calcObjectScoreAndApplyThreshold (SEG, IAD) 如果设置为 true，则计算分段对象的分数。 分数低于对象分数阈值的分段对象将被排除在最终结果之外。 |
| int[ ] | objectBoundaryThresholdPerClass (SEG) 每个类别的对象边界阈值。 索引 n的值越大，类n的掩码和分段对象的边界越窄。 |
| int[ ] | objectAreaThresholdPerClass (SEG, DET) 每个类别的对象面积阈值。 作为类别 n检测到的对象，其面积小于该值将被排除在最终结果之外。 |
| double[ ] | objectScoreThresholdPerClass (SEG, DET) 每个类别的对象分数阈值。 作为类别 n检测到的对象，其分数低于该值将被排除在最终结果之外。 |
| bool | calcMask (SEG, IAD) 如果在推理过程中将其设置为 true，则计算与原始图像大小相同的掩码。 |
| bool | calcHeatmap (IAD) 如果在推理过程中将其设置为 true，则计算与原始图像大小相同的热图。 |
| double | anomalyScoreThreshold (IAD) 如果代表整个图像的异常分数大于该值，则该图像被视为异常图像。 否则，视为正常图像。训练过程中找到的最佳值设置为默认值。 |
| double | heatmapColorRangeMin (IAD) 计算热图时，所有分数小于该值的像素都会被裁剪。 训练过程中找到的最佳值设置为默认值。 |
| double | heatmapColorRangeMax (IAD) 计算热图时，所有分数大于该值的像素都会被裁剪。 训练过程中找到的最佳值设置为默认值。 |
| double | objectBoundaryThreshold (IAD) 此值越大，掩模和分段对象的边界越窄。 |
| int | objectAreaThreshold (IAD) 检测到的分段对象的面积小于该值时，将被排除在最终结果之外。 |
| double | objectScoreThreshold (IAD) 检测到的分段对象的分数低于该值时，将被排除在最终结果之外。 |
| double | polygonScoreThreshold (OCR) 检测到的文本区域的多边形分数低于该值时，将被排除在最终结果之外。 |
| int | textSizeRangeMin (OCR) 检测到的文本区域的有效大小下限。 小于此值的文本区域将被排除在最终结果之外。 |
| int | textSizeRangeMax (OCR) 检测到的文本区域的有效大小上限。 大于此值的文本区域将被排除在最终结果之外。 |
| int | maxNumOfTextObjects (OCR) 一次可以检测到的文本对象的最大数量。 值为0或更低表示没有限制。 |
| double | textScoreThreshold (OCR) 如果识别到的文本对象的文本分数低于该值，则将其排除在最终结果之外。 |
| SaigeTextFormatting | textFormatting (OCR) 指定要识别的文本格式的选项。 |
Public Attributes Documentation¶
calcTime¶
(Common) 决定是否显示推理API执行的详细时间。
bool calcTime;
- 设置为
true时，可以查看图像读取、深度学习推理和后处理所花费的时间。 - 设置为
false时，仅显示推理API执行的总时间。 - 在图像增强功能中，不单独测量后处理时间。
Warning
将其设置为true可能会减慢整体推理时间。 建议在实际检查时将其设置为false。
See also: SaigeGetInferenceResultInspectionTime, SAIGE_SET_CALC_TIME
batchSize¶
(Common) 每次推理执行处理的图像数量。 只能在创建推理句柄时通过SaigeHandleConfig设置。
int batchSize;
See also: SaigeHandleConfig.batchSize
oversizedImageHandling¶
(SEG, IEN) 指定如何处理大于SaigeHandleConfig中设置的检查大小的图像。 分割支持SAIGE_DO_NOT_INSPECT、SAIGE_RESIZE_TO_FIT和SAIGE_CROP_INTO_TILES选项。 图像增强支持SAIGE_DO_NOT_ENHANCE和SAIGE_CROP_INTO_TILES选项。
const char * oversizedImageHandling;
| 选项 | 描述 |
|---|---|
| SAIGE_DO_NOT_INSPECT | 不执行推理并引发错误。 |
| SAIGE_DO_NOT_ENHANCE | 不执行推理并引发错误。 |
| SAIGE_RESIZE_TO_FIT | 调整图像大小，保持宽高比，使其不超过检查大小，然后执行推理。 |
| SAIGE_CROP_INTO_TILES | 根据检查大小将图像裁剪成补丁，对每个补丁执行推理并合并结果。 |
See also: SaigeHandleConfig.inspectionSizeWidth, SaigeHandleConfig.inspectionSizeHeight
inspectionSizeWidth¶
(SEG, OCR, IEN) 用于推理的图像宽度。 只能在创建推理句柄时通过SaigeHandleConfig设置。
int inspectionSizeWidth;
See also: SaigeHandleConfig.inspectionSizeWidth
inspectionSizeHeight¶
(SEG, OCR, IEN) 用于推理的图像高度。 只能在创建推理句柄时通过SaigeHandleConfig设置。
int inspectionSizeHeight;
See also: SaigeHandleConfig.inspectionSizeHeight
additionalScores¶
(CLS) 每个类别的附加分数值。 设置在n索引处的值会为第n类授予额外分数。
float[] additionalScores;
每个附加分数值必须是介于0和100之间的浮点数。
See also: SaigeGetInferenceResultScore
calcClassActivationMap¶
(CLS) 如果在推理过程中将其设置为true，则会计算类激活图。
bool calcClassActivationMap;
Warning
将其设置为true将减慢整体推理时间，并禁用推理优化。 建议在实际检查中将其设置为false。
See also: SaigeGetInferenceResultClassActivationMap
maxNumOfDetectedObjects¶
(DET) 要检索的检测到的对象的最大数量。 如果检测到的对象数量超过此值，则分数较低的对象将被排除在最终结果之外。
int[] maxNumOfDetectedObjects;
See also: SAIGE_SET_MAX_NUM_OF_DETECTED_OBJECTS
calcScoremap¶
(SEG) 如果在推理过程中将其设置为true，则计算分数图。
bool calcScoremap;
See also: SaigeGetInferenceResultScoremapSEG, SAIGE_SET_CALC_SCOREMAP
calcObject¶
(SEG, IAD) 如果在推理过程中将其设置为true，则计算分段对象。
bool calcObject;
See also: SaigeSegmentedObject, SAIGE_SET_CALC_OBJECT
calcObjectAreaAndApplyThreshold¶
(SEG, IAD) 如果设置为true，则计算分段对象的面积。 面积小于对象面积阈值的分段对象将被排除在最终结果之外。
bool calcObjectAreaAndApplyThreshold;
See also: SaigeSegmentedObject::area, SAIGE_SET_CALC_OBJECT_AREA_AND_APPLY_THRESHOLD
calcObjectScoreAndApplyThreshold¶
(SEG, IAD) 如果设置为true，则计算分段对象的分数。 分数低于对象分数阈值的分段对象将被排除在最终结果之外。
bool calcObjectScoreAndApplyThreshold;
See also: SaigeSegmentedObject::score, SAIGE_SET_CALC_OBJECT_SCORE_AND_APPLY_THRESHOLD
objectBoundaryThresholdPerClass¶
(SEG) 每个类别的对象边界阈值。 索引n的值越大，类n的掩码和分段对象的边界越窄。
int[] objectBoundaryThresholdPerClass;
- 索引
0的值对应于OK类，没有效果，无法设置。 - 仅在
calcObject设置为true时有效。
See also: SaigeSegmentedObject, SaigeDrawSegmentedObjects, SAIGE_SET_OBJECT_BOUNDARY_THRESHOLD
objectAreaThresholdPerClass¶
(SEG, DET) 每个类别的对象面积阈值。 作为类别n检测到的对象，其面积小于该值将被排除在最终结果之外。
int[] objectAreaThresholdPerClass;
- 适用于SEG中的分段对象和DET中的检测对象。
- 索引
0的值对应于OK类，没有效果，无法设置。 - 仅在SEG中
calcObject设置为true时有效。
See also: SAIGE_SET_OBJECT_AREA_THRESHOLD
objectScoreThresholdPerClass¶
(SEG, DET) 每个类别的对象分数阈值。 作为类别n检测到的对象，其分数低于该值将被排除在最终结果之外。
double[] objectScoreThresholdPerClass;
- 适用于SEG中的分段对象和DET中的检测对象。
- 分段对象的分数范围为0~255，检测对象的分数范围为0~100。
- 索引
0的值对应于OK类，没有效果，无法设置。 - 仅在SEG中
calcObject设置为true时有效。
See also: SAIGE_SET_OBJECT_SCORE_THRESHOLD
calcMask¶
(SEG, IAD) 如果在推理过程中将其设置为true，则计算与原始图像大小相同的掩码。
bool calcMask;
See also: SaigeGetInferenceResultMask, SAIGE_SET_CALC_MASK
calcHeatmap¶
(IAD) 如果在推理过程中将其设置为true，则计算与原始图像大小相同的热图。
bool calcHeatmap;
See also: SaigeGetInferenceResultHeatmap, SAIGE_SET_CALC_HEATMAP
anomalyScoreThreshold¶
(IAD) 如果代表整个图像的异常分数大于该值，则该图像被视为异常图像。 否则，视为正常图像。训练过程中找到的最佳值设置为默认值。
double anomalyScoreThreshold;
See also: SaigeGetInferenceResultAnomalyScores, SAIGE_SET_ANOMALY_SCORE_THRESHOLD
heatmapColorRangeMin¶
(IAD) 计算热图时，所有分数小于该值的像素都会被裁剪。 训练过程中找到的最佳值设置为默认值。
double heatmapColorRangeMin;
See also: SaigeGetInferenceResultHeatmap, SaigeDrawHeatmap, SAIGE_SET_HEATMAP_COLOR_RANGE
heatmapColorRangeMax¶
(IAD) 计算热图时，所有分数大于该值的像素都会被裁剪。 训练过程中找到的最佳值设置为默认值。
double heatmapColorRangeMax;
See also: SaigeGetInferenceResultHeatmap, SaigeDrawHeatmap, SAIGE_SET_HEATMAP_COLOR_RANGE
objectBoundaryThreshold¶
(IAD) 此值越大，掩模和分段对象的边界越窄。
double objectBoundaryThreshold;
- 在计算掩模时，分数超过此阈值的像素设置为1，低于此阈值的像素设置为0。
- 仅在
calcObject设置为true时有效。
See also: SaigeSegmentedObject, SaigeDrawSegmentedObjects, SAIGE_SET_OBJECT_BOUNDARY_THRESHOLD
objectAreaThreshold¶
(IAD) 检测到的分段对象的面积小于该值时，将被排除在最终结果之外。
int objectAreaThreshold;
- 仅在
calcObject设置为true时有效。
See also: SaigeSegmentedObject::area, SaigeGetInferenceResultSegmentedObjects, SAIGE_SET_OBJECT_AREA_THRESHOLD
objectScoreThreshold¶
(IAD) 检测到的分段对象的分数低于该值时，将被排除在最终结果之外。
double objectScoreThreshold;
- 仅在
calcObject设置为true时有效。
See also: SaigeSegmentedObject::score, SaigeGetInferenceResultSegmentedObjects, SAIGE_SET_OBJECT_SCORE_THRESHOLD
polygonScoreThreshold¶
(OCR) 检测到的文本区域的多边形分数低于该值时，将被排除在最终结果之外。
double polygonScoreThreshold;
See also: SaigeTextObject
textSizeRangeMin¶
(OCR) 检测到的文本区域的有效大小下限。 小于此值的文本区域将被排除在最终结果之外。
int textSizeRangeMin;
See also: SaigeTextObject
textSizeRangeMax¶
(OCR) 检测到的文本区域的有效大小上限。 大于此值的文本区域将被排除在最终结果之外。
int textSizeRangeMax;
See also: SaigeTextObject
maxNumOfTextObjects¶
(OCR) 一次可以检测到的文本对象的最大数量。 值为0或更低表示没有限制。
int maxNumOfTextObjects;
See also: SaigeTextObject
textScoreThreshold¶
(OCR) 如果识别到的文本对象的文本分数低于该值，则将其排除在最终结果之外。
double textScoreThreshold;
See also: SaigeTextObject
textFormatting¶
(OCR) 指定要识别的文本格式的选项。
SaigeTextFormatting textFormatting;
See also: SaigeTextFormatting