Core MLモデル
AI・機械学習MLMODELはAppleのCore MLモデルに使われます。画像や表データ等の入力、出力、モデル種類の定義を持ちます。モデルを確認することと予測を実行することは別で、coremltoolsの予測APIはmacOSのCore MLフレームワークを利用します。
- 主な用途
- Core MLモデルの定義・保存
- 中身の種類
- バイナリデータ
目次・よくある質問・根拠資料を見る
内容の最終確認： · 編集：Kai
開き方・操作手順
使っている環境や目的の項目を開いて、手順を確認してください。
操作名・対応状況はアプリ・OS・版によって異なります。変更する前に原本を残してください。
開けないとき：症状から確認
- 予測APIが使えない：macOSのCore ML実行環境と対応条件を確認します。
- 入力エラー：画像・配列の型、形状、前処理を確認します。
- 結果が異なる：画像の尺度、ラベル、正規化や出力の解釈を照合します。
- ML Programを単一MLMODELで保存できない：重みを分ける構造ではMLPACKAGEが必要です。
- Linuxでpredictが使えない：仕様確認とmacOSのCore ML実行は利用条件が異なります。
- 画像を渡して型エラー：ImageTypeか配列か、入力名・shape・色順を照合します。
元モデル → 対応するCore ML形式へ変換
- 元モデルの種類、対象OS、必要な入出力を確認します。
- 対応するcoremltools等で変換し、元モデルと実例の予測を比較します。
- 変換時の最小OS、入力型、数値精度を記録し、同じ入力で変換前後と実機の出力を比較します。
全Core MLモデルを任意の別形式へ逆変換できるわけではありません。ML Programは外部重みを持つためMLPACKAGEが必要です。
単一ファイルとモデル型の関係
Core MLのモデル型によって保存形態が違います。ML Programは重みを分けるため、単一MLMODELではなくモデルパッケージを使います。
仕様が読めることと対象端末で実行できることは別です。Xcodeやツール、OSの対応条件を確認します。
この手順の根拠：Apple · Model Prediction — Core ML Tools / Apple · Convert Models to ML Programs
予測結果が違うときの確認
画像のリサイズ、色順、正規化、入力名、出力ラベルを元モデルと照合します。変換時の数値精度も記録します。
CPU・GPU・Neural Engineの指定はモデルと環境の対応によります。出力の許容差と実機の性能を確認して選びます。
この手順の根拠：Apple · Model Prediction — Core ML Tools / Apple · Convert Models to ML Programs
関連形式との違い
| 形式 | 主な役割 | 確認する点 |
|---|---|---|
| MLMODEL | Core ML単一モデル保存 | モデル型と対象OS |
| MLPACKAGE | 部品を含むモデル包装 | 内部構成を維持 |
| MLMODELC | コンパイル済みCore ML成果物 | 元の配布形式とは別 |
取り扱いと安全性
信頼できるモデルと正規のツールを使い、未知の同梱スクリプトを実行しません。学習データや業務情報を公開の変換サービスへ送らず、モデルの利用・再配布条件を確認します。
よくある質問
Windowsで予測できる？
coremltoolsの予測APIはmacOSのCore MLを使います。
入力画像なら何でもよい？
型・サイズ・前処理の指定を確認します。
MLPACKAGEと改名で交換できる？
保存構造とモデル種類が異なるため改名では変換できません。
MLMODELをMP4へ変換できる？
画像や動画そのものではなくモデルです。推論に使うアプリと入力が必要です。
Macで動けば全iPhoneで使える？
モデル型・最小OS・演算条件を確認し、対象機器で検証します。
形式の基本情報：正式名称・MIME type・管理団体
- 名称
- Core ML model
- 管理・仕様
- Apple
- MIME type
- 作成元・配信元の指定による。拡張子だけでMIME typeは確定できません。
公式・一次情報
- 公式資料Model Prediction — Core ML Tools
モデルの確認と予測実行の環境の資料です。
Apple · リンク確認： - 公式資料Convert Models to ML Programs
ML Programの重みとMLPACKAGEの関係を説明します。
Apple · リンク確認：