본문으로 건너뛰기

CoreML 시각 추론기 생성 (coreml.new_vision_request)

선언​

시각 추론기 객체, 오류 정보 = coreml.new_vision_request(컴파일된 모델 경로)

또는

시각 추론기 객체, 오류 정보 = coreml.new_vision_request({
    compiled_model_path = 컴파일된 모델 경로,
    uses_cpu_only = CPU만 사용할지 여부,
    compute_units = 연산 장치 설정,
    image_crop_and_scale_option = 자르기 및 크기 조절 모드,
})

매개변수​

  • 컴파일된 모델 경로
    문자열형. 현재 이미지 분류와 객체 탐지 두 유형의 모델을 지원합니다.

  • uses_cpu_only
    불리언형 선택 매개변수. 기본적으로 CPU만 사용해 추론할지 여부이며 기본값은 false입니다.

  • compute_units 문자열형 선택 매개변수. **iOS 12+**에서 적용되며 다음 값을 지원합니다.

    • "all"
    • "cpu_only" 또는 "cpu"
    • "cpu_and_gpu" 또는 "gpu"
    • "cpu_and_neural_engine", "ane" 또는 "neural_engine" (iOS 16+)

  • image_crop_and_scale_option
    정수형 선택 매개변수. 시각 추론 시의 자르기 및 크기 조절 모드입니다.

반환값​

  • 시각 추론기 객체
    시각 추론기 객체이며 생성에 실패하면 nil을 반환합니다.

  • 오류 정보
    문자열형. 생성에 성공하면 nil, 실패하면 오류 정보를 반환합니다.

설명​

  • 소프트웨어 버전 1.3.8 이상에서 사용할 수 있습니다.
  • iOS 13 미만 시스템 버전은 지원하지 않습니다.
  • 이 함수는 컴파일된 .mlmodelc 모델을 불러와 이미지 추론용 컨텍스트를 반환합니다.
  • 이미지를 입력으로 사용하는 CoreML 시각 모델에 적합합니다.
  • 모델 입력 자체가 범용 image / MLMultiArray 특성이라면 coreml.new_model_request 사용도 고려할 수 있습니다.
  • 이 객체는 :predict() / :run() 외에도 :results(), :is_done(), :compute_units(), :image_crop_and_scale_option(), :class_labels() 등의 조회 메서드를 지원합니다.

예제​

CoreML 시각 추론기로 이미지 추론을 참고하십시오.