Metadata.h¶

SAIGE VISION Enterprise의 Operation 기능인 Metadata 데이터 수집 기능에 대한 예제입니다.

SAIGE VISION Enterprise에서는 AI 모델 운영을 위한 기능으로 데이터 수집 기능을 제공합니다. 데이터 수집 기능은 실시간 검사를 수행하는 새로운 데이터를 시스템에 저장하는 기능입니다. 데이터 수집을 위해서 검사 프로그램에서 별도로 전송을 위한 프로그램 변경을 할 필요는 없으며, 시스템 설정에 지정된 조건에 따라서 데이터를 자동으로 수집합니다.

그러나, 데이터셋 기능에서는 각 이미지가 가지는 부가 정보로서 Metadata를 지정하여 운영할 수 있습니다. Runtime SDK에서는 실시간 검사 환경에서 데이터 수집 시 Metadata 값을 미리 입력하여 수집된 데이터의 부가 정보도 자동으로 저장되도록 설정할 수 있습니다.

ExampleClsRuntimeWithMetadata.cpp 예제는 Metadata를 지정하여 데이터를 수집하는 예제입니다.

Metadata의 종류 및 설정 방법¶

Handle Metadata¶

검사 핸들에 미리 지정해두는 Metadata 입니다. 한 번 지정하면 해당 핸들로 검사하는 이미지에 대해 일괄 적용됩니다. 아래 예제에서는 "Manufacturing Line"이라는 항목의 값을 "test"로 설정하여 이후 검사에 계속 적용됩니다.

See also: SaigeSetHandleMetadata

// ExampleClsRuntimeWithMetadata.cpp:200

retval = SaigeSetHandleMetadata(handle, "Manufacturing Line", "test");
if (retval < 0) {
    std::cerr << "SaigeSetHandleMetadata() failed - " << SaigeStrError(retval) << std::endl;
}

Inference Metadata¶

매 검사 직전에 설정하는 Metadata 입니다. 검사할 때 마다 초기화 되기 때문에 매번 지정해주지 않으면 값이 비어있게 됩니다. 여기서는 이미지 경로에서 1이라는 숫자가 있는 경우에만 "Test" 항목을 "test1" 값으로 지정합니다.

See also: SaigeSetInferenceMetadata

// ExampleClsRuntimeWithMetadata.cpp:232

if (img.find("1") > 0) {
   retval = SaigeSetInferenceMetadata(result, "Test", "test1");
} 

Result Metadata¶

매 검사 결과를 해석한 후 설정할 수 있는 Metadata 입니다. 검사 결과를 해석한 후 결과 핸들을 재사용하거나 파괴하기 전에 설정할 수 있습니다. 여기서는 "Result Class"라는 이름의 Metadata 항목의 값을 분류 결과 클래스 값으로 설정해줍니다.

See also: SaigeSetResultMetadata

// ExampleClsRuntimeWithMetadata.cpp:287

retval = SaigeSetResultMetadata(result, "Result Class", modelInfo->classNames[classId]);
if (retval < 0) {
    std::cerr << "SaigeSetResultMetadata() failed - " << SaigeStrError(retval)
              << std::endl;
    SaigeDestroyInferenceHandle(handle);
    SaigeDestroyInferenceResult(result);
    return retval;
}

미리 지정된 Metadata¶

데이터셋에서 사용하는 Metadata 중 시스템에서 미리 지정해놓은 항목이 있습니다.

Product ID: 제품 식별자 입니다. _product_id로 지정합니다.
File Path: 이미지 파일 경로입니다. 파일 전송하지 않고 수집하는 경우 사용하며 _file_path로 지정합니다.

// ExampleClsRuntimeWithMetadata.cpp:238

std::string file_name = img.substr(img.find_last_of("/")+1);
std::string pid = file_name.substr(0, file_name.find_last_of("."));
SaigeSetInferenceMetadata(result, "_product_id",
                          file_name.substr(0, file_name.find(".")).c_str());
std::string file_path = "V:\\image\\runtime_example\\images\\test\\" + file_name;
if (file_name.find("01.png") != std::string::npos) {
   SaigeSetInferenceMetadata(result, "_file_path", file_path.c_str());
}