콘텐츠로 이동

핸들 생성

추론 핸들과 결과 핸들을 생성합니다.

Classes

Type Name
struct SaigeHandleConfig
추론 핸들 설정 사항이 담긴 구조체입니다. GPU 메모리 및 추론 시간에 영향을 미칠 수 있는 항목들입니다.

Public Types

Type Name
typedef void * SaigeInferenceHandle
추론에 필요한 정보를 다루고 추론을 수행하는 데 사용되는 매개체입니다.
typedef void * SaigeInferenceResult
추론 결과를 다루는 데 사용되는 매개체입니다.

Public Attributes

Type Name
int kProjectTypeCLS = = 0
Classification 프로젝트를 나타내는 상수입니다.
int kProjectTypeDET = = 1
Detection 프로젝트를 나타내는 상수입니다.
int kProjectTypeSEG = = 2
Segmentation 프로젝트를 나타내는 상수입니다.
int kProjectTypeIAD = = 3
Anomaly Detection 프로젝트를 나타내는 상수입니다.
int kProjectTypeOCR = = 4
OCR 프로젝트를 나타내는 상수입니다.
int kProjectTypeIEN = = 5
IEN 프로젝트를 나타내는 상수입니다.

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
(CLS, DET, SEG, IAD) 배치 사이즈를 설정하는 플래그입니다. 배치 추론 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 프로젝트를 나타내는 상수입니다.

int kProjectTypeCLS;

kProjectTypeDET

Detection 프로젝트를 나타내는 상수입니다.

int kProjectTypeDET;

kProjectTypeSEG

Segmentation 프로젝트를 나타내는 상수입니다.

int kProjectTypeSEG;

kProjectTypeIAD

Anomaly Detection 프로젝트를 나타내는 상수입니다.

int kProjectTypeIAD;

kProjectTypeOCR

OCR 프로젝트를 나타내는 상수입니다.

int kProjectTypeOCR;

kProjectTypeIEN

IEN 프로젝트를 나타내는 상수입니다.

int kProjectTypeIEN;

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

(CLS, DET, SEG, IAD) 배치 사이즈를 설정하는 플래그입니다. 배치 추론 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