핸들 생성¶
추론 핸들과 결과 핸들을 생성합니다.
Classes¶
| Type | Name |
|---|---|
| struct | SaigeHandleConfig 추론 핸들 설정 사항이 담긴 구조체입니다. GPU 메모리 및 추론 시간에 영향을 미칠 수 있는 항목들입니다. |
Public Types¶
| Type | Name |
|---|---|
| typedef void * | SaigeInferenceHandle 추론에 필요한 정보를 다루고 추론을 수행하는 데 사용되는 매개체입니다. |
| typedef void * | SaigeInferenceResult 추론 결과를 다루는 데 사용되는 매개체입니다. |
Public Attributes¶
| Type | Name |
|---|---|
| constexpr int | kProjectTypeCLS = = 0 Classification 프로젝트를 나타내는 상수입니다. |
| constexpr int | kProjectTypeDET = = 1 Detection 프로젝트를 나타내는 상수입니다. |
| constexpr int | kProjectTypeSEG = = 2 Segmentation 프로젝트를 나타내는 상수입니다. |
| constexpr int | kProjectTypeIAD = = 3 Anomaly Detection 프로젝트를 나타내는 상수입니다. |
| constexpr int | kProjectTypeOCR = = 4 OCR 프로젝트를 나타내는 상수입니다. |
| constexpr int | kProjectTypeIEN = = 5 IEN 프로젝트를 나타내는 상수입니다. |
| constexpr int | kProjectTypeROD = = 6 ROD 프로젝트를 나타내는 상수입니다. |
Public Functions¶
| Type | Name |
|---|---|
| int | SaigeCreateInferenceHandle (SaigeInferenceHandle * handle, const int projectType, const char * modelFilePath, const int deviceIndex, SaigeHandleConfig * config, const unsigned int flags) 추론 핸들을 생성합니다. |
| int | SaigeCreateInferenceResult (SaigeInferenceResult * result) 결과 핸들을 생성합니다. |
Macros¶
| Type | Name |
|---|---|
| define | SAIGE_SET_BATCH_SIZE 0x01 (Common) 배치 사이즈를 설정하는 플래그입니다. 배치 추론 API를 사용하는 경우에 적용됩니다. |
| define | SAIGE_SET_INSPECTION_SIZE 0x02 (SEG, OCR) 추론할 때의 이미지 너비와 높이를 설정하는 플래그입니다. |
| define | SAIGE_OPTIMIZE_HANDLE 0x04 (Common) 추론 핸들에 최적화를 적용하는 플래그입니다. 추론 최적화를 적용하면 추론 시간이 단축되지만, 추론 결과가 약간 달라질 수 있습니다. |
Public Types Documentation¶
SaigeInferenceHandle¶
추론에 필요한 정보를 다루고 추론을 수행하는 데 사용되는 매개체입니다.
void * SaigeInferenceHandle;
See also: SaigeCreateInferenceHandle, SaigeDestroyInferenceHandle
SaigeInferenceResult¶
추론 결과를 다루는 데 사용되는 매개체입니다.
void * SaigeInferenceResult;
Public Attributes Documentation¶
kProjectTypeCLS¶
Classification 프로젝트를 나타내는 상수입니다.
constexpr int kProjectTypeCLS;
kProjectTypeDET¶
Detection 프로젝트를 나타내는 상수입니다.
constexpr int kProjectTypeDET;
kProjectTypeSEG¶
Segmentation 프로젝트를 나타내는 상수입니다.
constexpr int kProjectTypeSEG;
kProjectTypeIAD¶
Anomaly Detection 프로젝트를 나타내는 상수입니다.
constexpr int kProjectTypeIAD;
kProjectTypeOCR¶
OCR 프로젝트를 나타내는 상수입니다.
constexpr int kProjectTypeOCR;
kProjectTypeIEN¶
IEN 프로젝트를 나타내는 상수입니다.
constexpr int kProjectTypeIEN;
kProjectTypeROD¶
ROD 프로젝트를 나타내는 상수입니다.
constexpr int kProjectTypeROD;
Public Functions Documentation¶
SaigeCreateInferenceHandle¶
추론 핸들을 생성합니다.
int SaigeCreateInferenceHandle (
SaigeInferenceHandle * handle,
const int projectType,
const char * modelFilePath,
const int deviceIndex,
SaigeHandleConfig * config,
const unsigned int flags
)
원하는 작업에 맞게 프로젝트 타입과 모델 파일 경로를 올바르게 설정해 주시기 바랍니다. 설정한 프로젝트 타입과 모델 파일이 가진 프로젝트 정보가 일치하지 않을 시 에러가 발생합니다.
Parameters:
handle[out]사용할 추론 핸들입니다.projectType프로젝트 타입을 나타내는 정수 값입니다.modelFilePath모델 파일의 경로입니다.deviceIndex추론에 사용할 장치의 인덱스입니다. GPU를 사용할 경우 GPU의 인덱스(0 이상의 정수), CPU를 사용할 경우 -1을 입력합니다.config추론 핸들 설정 사항이 담긴 구조체입니다.flags설정하고자 하는 항목들입니다.
Returns:
errorCode 정상 작동 시 0을 리턴하고, 에러 발생 시 에러코드를 리턴합니다.
See also: SaigeInferenceHandle, SaigeHandleConfig, SaigeDestroyInferenceResult
SaigeCreateInferenceResult¶
결과 핸들을 생성합니다.
int SaigeCreateInferenceResult (
SaigeInferenceResult * result
)
Parameters:
result[out] 사용할 결과 핸들입니다.
Returns:
errorCode 정상 작동 시 0을 리턴하고, 에러 발생 시 에러코드를 리턴합니다.
See also: SaigeInferenceResult, SaigeDestroyInferenceResult
Macro Definition Documentation¶
SAIGE_SET_BATCH_SIZE¶
(Common) 배치 사이즈를 설정하는 플래그입니다. 배치 추론 API를 사용하는 경우에 적용됩니다.
#define SAIGE_SET_BATCH_SIZE 0x01
SAIGE_SET_INSPECTION_SIZE¶
(SEG, OCR) 추론할 때의 이미지 너비와 높이를 설정하는 플래그입니다.
#define SAIGE_SET_INSPECTION_SIZE 0x02
SAIGE_OPTIMIZE_HANDLE¶
(Common) 추론 핸들에 최적화를 적용하는 플래그입니다. 추론 최적화를 적용하면 추론 시간이 단축되지만, 추론 결과가 약간 달라질 수 있습니다.
#define SAIGE_OPTIMIZE_HANDLE 0x04