Struct SaigeInferenceOption

추론 옵션이 담긴 구조체입니다.

Inherited Members

ValueType.Equals(object)

ValueType.GetHashCode()

ValueType.ToString()

object.Equals(object, object)

object.GetType()

object.ReferenceEquals(object, object)

Namespace: SaigeVision.Net.Core.V2

Assembly: SaigeVision.Net.Core.V2.dll

Syntax

public struct SaigeInferenceOption

Fields

additionalScores

(CLS) 클래스별 additional score 값입니다. n번째 인덱스에 설정한 값만큼 n번째 클래스에 추가 score가 부여됩니다. 각 additional score 값은 0 이상 100 이하의 실수로만 설정 가능합니다.

Declaration

public float[] additionalScores

Field Value

Type	Description
float[]

anomalyScoreThreshold

(IAD) 이미지 전체를 대표하는 anomaly score가 이 값보다 크면 비정상 이미지로, 작거나 같으면 정상 이미지로 판정합니다.
학습 시점에 찾은 최적값이 기본값으로 설정됩니다.

Declaration

public double anomalyScoreThreshold

Field Value

Type	Description
double

batchSize

(Common) 추론을 한 번 수행할 때 추론하는 이미지의 개수입니다.
추론 핸들 생성 시에 SaigeHandleConfig를 통해서만 설정할 수 있습니다.

Declaration

public int batchSize

Field Value

Type	Description
int

calcClassActivationMap

(CLS) true로 설정하면 추론 시 class activation map을 계산합니다.

Declaration

public bool calcClassActivationMap

Field Value

Type	Description
bool

calcHeatmap

(IAD) true로 설정하면 추론 시 이미지 원본과 같은 크기의 heatmap을 계산합니다.

Declaration

public bool calcHeatmap

Field Value

Type	Description
bool

calcMask

(IAD, SEG) true로 설정하면 추론 시 이미지 원본과 같은 크기의 mask를 계산합니다.

Declaration

public bool calcMask

Field Value

Type	Description
bool

calcObject

(SEG, IAD) true로 설정하면 추론 시 segmented object를 계산합니다.

Declaration

public bool calcObject

Field Value

Type	Description
bool

calcObjectAreaAndApplyThreshold

(SEG, IAD) true로 설정하면 segmented object의 면적을 계산합니다.
Segmented object의 면적이 object area threshold 보다 작으면 최종 결과에서 제외됩니다.

Declaration

public bool calcObjectAreaAndApplyThreshold

Field Value

Type	Description
bool

calcObjectScoreAndApplyThreshold

(SEG, IAD) true로 설정하면 segmented object의 score를 계산합니다.
Segmented object의 score가 object score threshold 보다 작으면 최종 결과에서 제외됩니다.

Declaration

public bool calcObjectScoreAndApplyThreshold

Field Value

Type	Description
bool

calcScoremap

(SEG) true로 설정하면 추론 시 scoremap을 계산합니다.

Declaration

public bool calcScoremap

Field Value

Type	Description
bool

calcTime

(Common) 추론 API 실행에 소요되는 시간을 세분화하여 출력할지 결정합니다.
true로 설정하면 이미지를 읽는 시간, 순수 딥러닝 추론 시간, 후처리 시간을 각각 확인할 수 있습니다.
false로 설정하면 추론 API 실행에 소요된 총 시간만을 확인할 수 있습니다.
true로 설정하면 전체 추론 시간이 느려질 수 있습니다. 실제 검사 시에는 false로 설정하는 것을 권장합니다.

Declaration

public bool calcTime

Field Value

Type	Description
bool

heatmapColorRangeMax

(IAD) Heatmap을 계산할 때 이 값보다 score가 큰 픽셀은 모두 클리핑됩니다.
학습 시점에 찾은 최적값이 기본값으로 설정됩니다.

Declaration

public double heatmapColorRangeMax

Field Value

Type	Description
double

heatmapColorRangeMin

(IAD) Heatmap을 계산할 때 이 값보다 score가 작은 픽셀은 모두 클리핑됩니다.
학습 시점에 찾은 최적값이 기본값으로 설정됩니다.

Declaration

public double heatmapColorRangeMin

Field Value

Type	Description
double

inspectionSizeHeight

(SEG, OCR, IEN) 추론할 때의 이미지 높이입니다.
추론 핸들 생성 시에 SaigeHandleConfig를 통해서만 설정할 수 있습니다.

Declaration

public int inspectionSizeHeight

Field Value

Type	Description
int

inspectionSizeWidth

(SEG, OCR, IEN) 추론할 때의 이미지 너비입니다.
추론 핸들 생성 시에 SaigeHandleConfig를 통해서만 설정할 수 있습니다.

Declaration

public int inspectionSizeWidth

Field Value

Type	Description
int

maxNumOfDetectedObjects

(DET) 검출할 detected object의 최대 개수입니다.

Declaration

public int[] maxNumOfDetectedObjects

Field Value

Type	Description
int[]

maxNumOfTextObjects

(OCR) 한 번에 출력할 수 있는 글자 오브젝트의 최대 검출 개수입니다.
0 이하의 값은 제한 없음을 의미합니다.

Declaration

public int maxNumOfTextObjects

Field Value

Type	Description
int

objectAreaThreshold

(IAD) 검출된 segmented object의 면적이 이 값보다 작으면 최종 결과에서 제외됩니다. calcObject가 true일 때 유효합니다.

Declaration

public int objectAreaThreshold

Field Value

Type	Description
int

objectAreaThresholdPerClass

(SEG, DET) 클래스별 object area threshold 값입니다.
n번째 클래스로 검출된 segmented object의 면적이 n번째 값보다 작으면 최종 결과에서 제외됩니다.

Declaration

public int[] objectAreaThresholdPerClass

Field Value

Type	Description
int[]

objectBoundaryThreshold

(IAD) 이 값이 클수록 mask 및 segmented object의 경계가 좁아집니다. Mask를 계산할 때 이 값보다 score가 더 큰 픽셀은 1로, 더 작은 픽셀은 0으로 계산합니다. calcObject가 true일 때 유효합니다.

Declaration

public double objectBoundaryThreshold

Field Value

Type	Description
double

objectBoundaryThresholdPerClass

(SEG) 클래스별 object boundary threshold 값입니다.
n번째 값이 클수록 n번째 클래스의 mask 및 segmented object의 경계가 좁아집니다.

Declaration

public int[] objectBoundaryThresholdPerClass

Field Value

Type	Description
int[]

objectScoreThreshold

(IAD) 검출된 segmented object의 score가 이 값보다 작으면 최종 결과에서 제외됩니다. calcObject가 true일 때 유효합니다.

Declaration

public double objectScoreThreshold

Field Value

Type	Description
double

objectScoreThresholdPerClass

(SEG, DET) 클래스별 object score threshold 값입니다.
n번째 클래스로 검출된 segmented object의 score가 n번째 값보다 작으면 최종 결과에서 제외됩니다.
0번 인덱스 값은 OK 클래스에 대응하는 값으로 의미가 없으며 설정도 불가능합니다.
calcObject가 true일 때 유효합니다.

Declaration

public double[] objectScoreThresholdPerClass

Field Value

Type	Description
double[]

oversizedImageHandling

(SEG, IEN) SaigeHandleConfig에서 지정한 inspection size보다 큰 이미지를 처리하는 방법입니다.
Segmentation 은 SAIGE_DO_NOT_INSPECT, SAIGE_RESIZE_TO_FIT, SAIGE_CROP_INTO_TILES 세 가지 옵션을 사용할 수 있으며,
Image Enhancement에서는 SAIGE_DO_NOT_ENHANCE, SAIGE_CROP_INTO_TILES 두 가지 옵션을 사용할 수 있습니다.
DO_NOT_INSPECT : 추론을 수행하지 않고 에러를 일으킵니다.
DO_NOT_ENHANCE : 추론을 수행하지 않고 에러를 일으킵니다.
RESIZE_TO_FIT : 이미지의 가로-세로 비율을 유지하면서 inspection size 보다는 크지 않게 이미지를 리사이즈하여 추론을 수행합니다.
CROP_INTO_TILES : Inspection size로 이미지를 크롭하여 패치마다 추론을 수행한 뒤 각 결과를 합쳐 내보냅니다.

Declaration

public IntPtr oversizedImageHandling

Field Value

Type	Description
IntPtr

polygonScoreThreshold

(OCR) 검출된 글자영역인 polygon score 값이 이 값보다 작으면 최종 결과에서 제외됩니다.

Declaration

public double polygonScoreThreshold

Field Value

Type	Description
double

textFormatting

(OCR) 인식하고자 하는 글자의 포맷을 지정하는 옵션입니다.

Declaration

public SaigeTextFormatting textFormatting

Field Value

Type	Description
SaigeTextFormatting

textScoreThreshold

(OCR) 인식된 글자 오브젝트의 text score 값이 이 값보다 작으면 최종 결과에서 제외됩니다.

Declaration

public double textScoreThreshold

Field Value

Type	Description
double

textSizeRangeMax

(OCR) 검출된 글자영역 크기의 유효범위 상한값입니다.
이 값보다 큰 글자는 최종 결과에서 제외됩니다.

Declaration

public int textSizeRangeMax

Field Value

Type	Description
int

textSizeRangeMin

(OCR) 검출된 글자영역 크기의 유효범위 하한값입니다.
이 값보다 작은 글자는 최종 결과에서 제외됩니다.

Declaration

public int textSizeRangeMin

Field Value

Type	Description
int