추론 옵션¶
모델에 담긴 추론 옵션 기본값을 확인하거나 추론 옵션을 새롭게 설정합니다.
Classes¶
| Type | Name |
|---|---|
| struct | SaigeTextFormatting (OCR) 인식하고자 하는 글자의 포맷을 지정하는 옵션입니다. 글자 수에 관계 없이 인식하고자 하는 글자집합을 설정하는 방식과, 글자의 위치별로 인식하고자 하는 글자집합을 설정하는 두 가지 방식이 있습니다. |
| struct | SaigeInferenceOption 추론 옵션이 담긴 구조체입니다. |
Public Functions¶
| Type | Name |
|---|---|
| int | SaigeSetInferenceOption (SaigeInferenceHandle handle, SaigeInferenceOption * option, const unsigned int flags) 추론 옵션값을 추론 핸들에 설정합니다. |
| int | SaigeGetInferenceOption (SaigeInferenceHandle handle, SaigeInferenceOption * option) 추론 핸들로부터 추론 옵션값을 받아 옵니다. |
Macros¶
| Type | Name |
|---|---|
| define | SAIGE_WRITE_ON_MODEL_FILE 0x01 (Common) SaigeSetInferenceOption 으로 추론 옵션값을 설정할 때, 이 플래그를 함께 사용하면 해당 옵션값들이 모델 파일에도 저장됩니다. |
| define | SAIGE_SET_CALC_TIME 0x2 (Common) calcTime 옵션을 설정하는 플래그입니다. |
| define | SAIGE_SET_OVERSIZED_IMAGE_HANDLING 0x4 (SEG, OCR, IEN) oversizedImageHandling 옵션을 설정하는 플래그입니다. |
| define | SAIGE_SET_ADDITIONAL_SCORES 0x8 (CLS) additionalScores 옵션을 설정하는 플래그입니다. |
| define | SAIGE_SET_CALC_CLASS_ACTIVATION_MAP 0x10 (CLS) calcClassActivationMap 옵션을 설정하는 플래그입니다. |
| define | SAIGE_SET_MAX_NUM_OF_DETECTED_OBJECTS 0x20 (DET, ROD) maxNumOfDetectedObjects 옵션을 설정하는 플래그입니다. |
| define | SAIGE_SET_CALC_SCOREMAP 0x40 (SEG) calcScoremap 옵션을 설정하는 플래그입니다. |
| define | SAIGE_SET_CALC_OBJECT 0x80 (SEG, IAD) calcObject 옵션을 설정하는 플래그입니다. |
| define | SAIGE_SET_CALC_OBJECT_AREA_AND_APPLY_THRESHOLD 0x100 (SEG, IAD) calcObjectAreaAndApplyThreshold 옵션을 설정하는 플래그입니다. |
| define | SAIGE_SET_CALC_OBJECT_SCORE_AND_APPLY_THRESHOLD 0x200 (SEG, IAD) calcObjectScoreAndApplyThreshold 옵션을 설정하는 플래그입니다. |
| define | SAIGE_SET_OBJECT_BOUNDARY_THRESHOLD 0x400 (SEG, IAD) SEG에서는 objectBoundaryThresholdPerClass 옵션을, IAD에서는 objectBoundaryThreshold 옵션을 설정하는 플래그입니다. |
| define | SAIGE_SET_OBJECT_AREA_THRESHOLD 0x800 (SEG, DET, IAD) SEG, DET에서는 objectAreaThresholdPerClass 옵션을, IAD에서는 objectAreaThreshold 옵션을 설정하는 플래그입니다. |
| define | SAIGE_SET_OBJECT_SCORE_THRESHOLD 0x1000 (SEG, DET, IAD, ROD) SEG, DET에서는 objectScoreThresholdPerClass 옵션을, IAD, ROD에서는 objectScoreThreshold 옵션을 설정하는 플래그입니다. |
| define | SAIGE_SET_CALC_MASK 0x2000 (SEG, IAD) calcMask 옵션을 설정하는 플래그입니다. |
| define | SAIGE_SET_CALC_HEATMAP 0x4000 (IAD) calcHeatmap 옵션을 설정하는 플래그입니다. |
| define | SAIGE_SET_ANOMALY_SCORE_THRESHOLD 0x8000 (IAD) anomalyScoreThreshold 옵션을 설정하는 플래그입니다. |
| define | SAIGE_SET_HEATMAP_COLOR_RANGE 0x10000 (IAD) heatmapColorRangeMin, heatmapColorRangeMax 옵션을 설정하는 플래그입니다. |
| define | SAIGE_SET_POLYGON_SCORE_THRESHOLD 0x20000 (OCR) polygonScoreThreshold 옵션을 설정하는 플래그입니다. |
| define | SAIGE_SET_TEXT_SIZE_RANGE 0x40000 (OCR) textSizeRangeMin, textSizeRangeMax 옵션을 설정하는 플래그입니다. |
| define | SAIGE_SET_NUM_OF_TEXT_OBJECTS 0x80000 (OCR) maxNumOfTextObjects 옵션을 설정하는 플래그입니다. |
| define | SAIGE_SET_TEXT_SCORE_THRESHOLD 0x100000 (OCR) textScoreThreshold 옵션을 설정하는 플래그입니다. |
| define | SAIGE_SET_TEXT_FORMATTING 0x200000 (OCR) textFormatting 옵션을 설정하는 플래그입니다. |
| define | SAIGE_DO_NOT_INSPECT "do_not_inspect" (SEG) oversizedImageHandling 옵션 중 하나로, 이 값으로 설정 시 추론을 수행하지 않고 에러를 일으킵니다. |
| define | SAIGE_DO_NOT_ENHANCE "do_not_enhance" (IEN) oversizedImageHandling 옵션 중 하나로, 이 값으로 설정 시 추론을 수행하지 않고 에러를 일으킵니다. |
| define | SAIGE_RESIZE_TO_FIT "resize_to_fit" (SEG) oversizedImageHandling 옵션 중 하나로, 이 값으로 설정 시 이미지의 가로-세로 비율을 유지하면서 inspection size 보다는 크지 않게 이미지를 리사이즈하여 추론을 수행합니다. |
| define | SAIGE_CROP_INTO_TILES "crop_into_tiles" (SEG, IEN) oversizedImageHandling 옵션 중 하나로, 이 값으로 설정 시 inspection size로 이미지를 크롭하여 패치마다 추론을 수행한 뒤 패치별 결과를 합쳐 내보냅니다. |
Public Functions Documentation¶
SaigeSetInferenceOption¶
추론 옵션값을 추론 핸들에 설정합니다.
int SaigeSetInferenceOption (
SaigeInferenceHandle handle,
SaigeInferenceOption * option,
const unsigned int flags
)
Parameters:
handle사용할 추론 핸들입니다.option설정하고자 하는 옵션값이 담긴 구조체입니다.flags새롭게 설정하고자 하는 옵션 항목들입니다.
Returns:
errorCode 정상 작동 시 0을 리턴하고, 에러 발생 시 에러코드를 리턴합니다.
See also: SaigeInferenceOption
SaigeGetInferenceOption¶
추론 핸들로부터 추론 옵션값을 받아 옵니다.
int SaigeGetInferenceOption (
SaigeInferenceHandle handle,
SaigeInferenceOption * option
)
Parameters:
handle옵션값을 가져올 추론 핸들입니다.option[out] 옵션값을 담을 구조체입니다.
Returns:
errorCode 정상 작동 시 0을 리턴하고, 에러 발생 시 에러코드를 리턴합니다.
See also: SaigeInferenceOption
Macro Definition Documentation¶
SAIGE_WRITE_ON_MODEL_FILE¶
(Common) SaigeSetInferenceOption 으로 추론 옵션값을 설정할 때, 이 플래그를 함께 사용하면 해당 옵션값들이 모델 파일에도 저장됩니다.
#define SAIGE_WRITE_ON_MODEL_FILE 0x01
SAIGE_SET_CALC_TIME¶
(Common) calcTime 옵션을 설정하는 플래그입니다.
#define SAIGE_SET_CALC_TIME 0x2
See also: SaigeInferenceOption::calcTime
SAIGE_SET_OVERSIZED_IMAGE_HANDLING¶
(SEG, OCR, IEN) oversizedImageHandling 옵션을 설정하는 플래그입니다.
#define SAIGE_SET_OVERSIZED_IMAGE_HANDLING 0x4
See also: SaigeInferenceOption::oversizedImageHandling
SAIGE_SET_ADDITIONAL_SCORES¶
(CLS) additionalScores 옵션을 설정하는 플래그입니다.
#define SAIGE_SET_ADDITIONAL_SCORES 0x8
See also: SaigeInferenceOption::additionalScores
SAIGE_SET_CALC_CLASS_ACTIVATION_MAP¶
(CLS) calcClassActivationMap 옵션을 설정하는 플래그입니다.
#define SAIGE_SET_CALC_CLASS_ACTIVATION_MAP 0x10
See also: SaigeInferenceOption::calcClassActivationMap
SAIGE_SET_MAX_NUM_OF_DETECTED_OBJECTS¶
(DET, ROD) maxNumOfDetectedObjects 옵션을 설정하는 플래그입니다.
#define SAIGE_SET_MAX_NUM_OF_DETECTED_OBJECTS 0x20
SAIGE_SET_CALC_SCOREMAP¶
(SEG) calcScoremap 옵션을 설정하는 플래그입니다.
#define SAIGE_SET_CALC_SCOREMAP 0x40
See also: SaigeInferenceOption::calcScoremap
SAIGE_SET_CALC_OBJECT¶
(SEG, IAD) calcObject 옵션을 설정하는 플래그입니다.
#define SAIGE_SET_CALC_OBJECT 0x80
See also: SaigeInferenceOption::calcObject
SAIGE_SET_CALC_OBJECT_AREA_AND_APPLY_THRESHOLD¶
(SEG, IAD) calcObjectAreaAndApplyThreshold 옵션을 설정하는 플래그입니다.
#define SAIGE_SET_CALC_OBJECT_AREA_AND_APPLY_THRESHOLD 0x100
See also: SaigeInferenceOption::calcObjectAreaAndApplyThreshold
SAIGE_SET_CALC_OBJECT_SCORE_AND_APPLY_THRESHOLD¶
(SEG, IAD) calcObjectScoreAndApplyThreshold 옵션을 설정하는 플래그입니다.
#define SAIGE_SET_CALC_OBJECT_SCORE_AND_APPLY_THRESHOLD 0x200
See also: SaigeInferenceOption::calcObjectScoreAndApplyThreshold
SAIGE_SET_OBJECT_BOUNDARY_THRESHOLD¶
(SEG, IAD) SEG에서는 objectBoundaryThresholdPerClass 옵션을, IAD에서는 objectBoundaryThreshold 옵션을 설정하는 플래그입니다.
#define SAIGE_SET_OBJECT_BOUNDARY_THRESHOLD 0x400
See also: SaigeInferenceOption::objectBoundaryThresholdPerClass, SaigeInferenceOption::objectBoundaryThreshold
SAIGE_SET_OBJECT_AREA_THRESHOLD¶
(SEG, DET, IAD) SEG, DET에서는 objectAreaThresholdPerClass 옵션을, IAD에서는 objectAreaThreshold 옵션을 설정하는 플래그입니다.
#define SAIGE_SET_OBJECT_AREA_THRESHOLD 0x800
See also: SaigeInferenceOption::objectAreaThresholdPerClass, SaigeInferenceOption::objectAreaThreshold
SAIGE_SET_OBJECT_SCORE_THRESHOLD¶
(SEG, DET, IAD, ROD) SEG, DET에서는 objectScoreThresholdPerClass 옵션을, IAD, ROD에서는 objectScoreThreshold 옵션을 설정하는 플래그입니다.
#define SAIGE_SET_OBJECT_SCORE_THRESHOLD 0x1000
See also: SaigeInferenceOption::objectScoreThresholdPerClass, SaigeInferenceOption::objectScoreThreshold
SAIGE_SET_CALC_MASK¶
(SEG, IAD) calcMask 옵션을 설정하는 플래그입니다.
#define SAIGE_SET_CALC_MASK 0x2000
See also: SaigeInferenceOption::calcMask
SAIGE_SET_CALC_HEATMAP¶
(IAD) calcHeatmap 옵션을 설정하는 플래그입니다.
#define SAIGE_SET_CALC_HEATMAP 0x4000
See also: SaigeInferenceOption::calcHeatmap
SAIGE_SET_ANOMALY_SCORE_THRESHOLD¶
(IAD) anomalyScoreThreshold 옵션을 설정하는 플래그입니다.
#define SAIGE_SET_ANOMALY_SCORE_THRESHOLD 0x8000
See also: SaigeInferenceOption::anomalyScoreThreshold
SAIGE_SET_HEATMAP_COLOR_RANGE¶
(IAD) heatmapColorRangeMin, heatmapColorRangeMax 옵션을 설정하는 플래그입니다.
#define SAIGE_SET_HEATMAP_COLOR_RANGE 0x10000
See also: SaigeInferenceOption::heatmapColorRangeMin, SaigeInferenceOption::heatmapColorRangeMax
SAIGE_SET_POLYGON_SCORE_THRESHOLD¶
(OCR) polygonScoreThreshold 옵션을 설정하는 플래그입니다.
#define SAIGE_SET_POLYGON_SCORE_THRESHOLD 0x20000
See also: SaigeInferenceOption::polygonScoreThreshold
SAIGE_SET_TEXT_SIZE_RANGE¶
(OCR) textSizeRangeMin, textSizeRangeMax 옵션을 설정하는 플래그입니다.
#define SAIGE_SET_TEXT_SIZE_RANGE 0x40000
See also: SaigeInferenceOption::textSizeRangeMin, SaigeInferenceOption::textSizeRangeMax
SAIGE_SET_NUM_OF_TEXT_OBJECTS¶
(OCR) maxNumOfTextObjects 옵션을 설정하는 플래그입니다.
#define SAIGE_SET_NUM_OF_TEXT_OBJECTS 0x80000
See also: SaigeInferenceOption::maxNumOfTextObjects
SAIGE_SET_TEXT_SCORE_THRESHOLD¶
(OCR) textScoreThreshold 옵션을 설정하는 플래그입니다.
#define SAIGE_SET_TEXT_SCORE_THRESHOLD 0x100000
See also: SaigeInferenceOption::textScoreThreshold
SAIGE_SET_TEXT_FORMATTING¶
(OCR) textFormatting 옵션을 설정하는 플래그입니다.
#define SAIGE_SET_TEXT_FORMATTING 0x200000
SAIGE_DO_NOT_INSPECT¶
(SEG) oversizedImageHandling 옵션 중 하나로, 이 값으로 설정 시 추론을 수행하지 않고 에러를 일으킵니다.
#define SAIGE_DO_NOT_INSPECT "do_not_inspect"
See also: SaigeInferenceOption::oversizedImageHandling
SAIGE_DO_NOT_ENHANCE¶
(IEN) oversizedImageHandling 옵션 중 하나로, 이 값으로 설정 시 추론을 수행하지 않고 에러를 일으킵니다.
#define SAIGE_DO_NOT_ENHANCE "do_not_enhance"
See also: SaigeInferenceOption::oversizedImageHandling
SAIGE_RESIZE_TO_FIT¶
(SEG) oversizedImageHandling 옵션 중 하나로, 이 값으로 설정 시 이미지의 가로-세로 비율을 유지하면서 inspection size 보다는 크지 않게 이미지를 리사이즈하여 추론을 수행합니다.
#define SAIGE_RESIZE_TO_FIT "resize_to_fit"
See also: SaigeInferenceOption::oversizedImageHandling
SAIGE_CROP_INTO_TILES¶
(SEG, IEN) oversizedImageHandling 옵션 중 하나로, 이 값으로 설정 시 inspection size로 이미지를 크롭하여 패치마다 추론을 수행한 뒤 패치별 결과를 합쳐 내보냅니다.
#define SAIGE_CROP_INTO_TILES "crop_into_tiles"