CoreML 모듈 (coreml)

소프트웨어 버전 1.3.8 이상에서 사용할 수 있습니다.
CoreML 모듈은 기기에서 머신 러닝 추론을 수행하는 데 사용합니다. Vision 기반 시각 추론기 외에도 다음 기능을 지원합니다.

• 범용 모델 request / session
• MLMultiArray 생성, 변환 및 연산
• 이미지와 텐서 간 변환
• 유형별 처리를 지원하는 텍스트 토크나이저
• detection / OBB / mask / keypoint / tracker 등의 범용 후처리 도구

SentencePiece는 온디바이스 추론에 맞춘 경량 호환 구현을 사용하며 .vocab과 .model 두 입력 형식을 지원합니다. require("onnxruntime")를 호출한 뒤에는 MLMultiArray와 ORT tensor 사이의 네이티브 복사 변환 인터페이스도 추가됩니다.

플랫폼 지원

CoreML 모듈은 전반적으로 **iOS 11+**를 기반으로 하지만, 인터페이스마다 필요한 최소 시스템 버전은 다릅니다.

• new_model_request / session, MLMultiArray 관련 인터페이스, 이미지 텐서화, tokenizer, 대부분의 기하 / 후처리 도구: iOS 11+
• compile_model, new_vision_request, predict_batch() / run_batch(), compute_units 생성 및 조회: iOS 12+
• 범용 model request에서 image_object를 image feature 입력으로 사용: iOS 13+
• class_labels(): iOS 14+
• compute_units = "cpu_and_neural_engine": iOS 16+

---

• 기기에서 CoreML 모델 컴파일
• CoreML 시각 추론기 생성
• ! CoreML 시각 추론기로 이미지 추론
• 범용 CoreML 추론기 생성
• CoreML 범용 추론기 객체 메서드
• ML 다차원 배열 모듈
• 텍스트 토크나이저 모듈
• ONNX Runtime 모듈 (onnxruntime)

추가 설명

• coreml.session(...)은 coreml.new_model_request(...)의 별칭입니다.
• coreml.tensor(...)는 coreml.new_multi_array(...)의 별칭입니다.
• coreml.tensor_from_table(...)은 coreml.multi_array_from_table(...)의 별칭입니다.
• coreml.image_to_multi_array(...)는 계속 사용할 수 있지만, 현재는 coreml.tensor_from_image(...)의 호환 별칭입니다.
• coreml.multi_array_from_quad(...)는 coreml.tensor_from_quad(...)의 별칭입니다.
• coreml.multi_array_from_quads(...)는 coreml.tensor_from_quads(...)의 별칭입니다.
• coreml.project_masks(...)는 coreml.proto_masks(...)의 별칭입니다.