Link to this sectionUltralytics YOLOを使用したモデルのエクスポート#

Link to this sectionはじめに#

モデルのトレーニングの最終目標は、実世界のアプリケーションにデプロイすることです。Ultralytics YOLO26のエクスポートモードでは、トレーニング済みモデルをさまざまなフォーマットにエクスポートするための多彩なオプションを提供しており、多様なプラットフォームやデバイスへのデプロイを可能にします。この包括的なガイドでは、モデルエクスポートのニュアンスを説明し、最大限の互換性とパフォーマンスを達成する方法を紹介します。

Link to this sectionなぜYOLO26のエクスポートモードを選ぶのか？#

• 汎用性: ONNX、TensorRT、CoreMLなど、複数のフォーマットにエクスポート可能です。
• パフォーマンス: TensorRTで最大5倍のGPU高速化、ONNXまたはOpenVINOで最大3倍のCPU高速化を実現します。
• 互換性: モデルを数多くのハードウェアおよびソフトウェア環境で普遍的にデプロイできるようにします。
• 使いやすさ: シンプルなCLIとPython APIにより、迅速かつ簡単にモデルをエクスポートできます。

Link to this sectionエクスポートモードの主な機能#

注目すべき機能の一部を以下に示します：

• ワンクリックエクスポート: さまざまなフォーマットにエクスポートするためのシンプルなコマンド。
• バッチエクスポート: バッチ推論が可能なモデルのエクスポート。
• 推論の最適化: エクスポートされたモデルは、推論時間の短縮に向けて最適化されます。
• チュートリアルビデオ: スムーズなエクスポート体験のための詳細なガイドとチュートリアル。

Link to this section使用例#

YOLO26nモデルをONNXやTensorRTなどの異なるフォーマットにエクスポートします。エクスポート引数の全リストについては、以下の引数セクションを参照してください。

from ultralytics import YOLO

# Load a model
model = YOLO("yolo26n.pt")  # load an official model
model = YOLO("path/to/best.pt")  # load a custom-trained model

# Export the model
model.export(format="onnx")

Link to this section引数#

この表は、YOLOモデルをさまざまなフォーマットにエクスポートするために利用可能な設定とオプションを詳細に示しています。これらの設定は、エクスポートされたモデルのパフォーマンス、サイズ、およびさまざまなプラットフォームや環境間での互換性を最適化するために不可欠です。適切な設定を行うことで、モデルが最適な効率で目的のアプリケーションにデプロイされる準備が整います。

これらのパラメータを調整することで、デプロイ環境、ハードウェアの制約、パフォーマンス目標といった特定の要件に合わせてエクスポートプロセスをカスタマイズできます。モデルサイズ、速度、精度の最適なバランスを実現するには、適切なフォーマットと設定を選択することが不可欠です。

Link to this sectionエクスポート形式#

利用可能なYOLO26エクスポートフォーマットは以下の表の通りです。format 引数（例：format='onnx' または format='engine'）を使用して任意のフォーマットにエクスポートできます。エクスポートされたモデルに対して直接予測や検証を行うことも可能です（例：yolo predict model=yolo26n.onnx）。エクスポート完了後、モデルの使用例が表示されます。また、ローカルでのセットアップを行わずにUltralytics Platform上のブラウザから直接モデルをエクスポートすることも可能です。

Link to this sectionよくある質問 (FAQ)#

Link to this sectionYOLO26モデルをONNXフォーマットにエクスポートするにはどうすればよいですか？#

Ultralyticsを使用すれば、YOLO26モデルをONNXフォーマットにエクスポートするのは簡単です。PythonとCLIの両方のエクスポート手法を提供しています。

from ultralytics import YOLO

# Load a model
model = YOLO("yolo26n.pt")  # load an official model
model = YOLO("path/to/best.pt")  # load a custom-trained model

# Export the model
model.export(format="onnx")

異なる入力サイズの処理などの高度なオプションを含むプロセスの詳細については、ONNX統合ガイドを参照してください。

Link to this sectionモデルエクスポートにTensorRTを使用する利点は何ですか？#

モデルエクスポートにTensorRTを使用すると、パフォーマンスが大幅に向上します。TensorRTにエクスポートされたYOLO26モデルは、最大5倍のGPU高速化を達成できるため、リアルタイム推論アプリケーションに最適です。

• 汎用性: 特定のハードウェアセットアップに合わせてモデルを最適化します。
• 速度: 高度な最適化を通じて、より高速な推論を実現します。
• 互換性: NVIDIAハードウェアとスムーズに統合します。

TensorRTの統合について詳しくは、TensorRT統合ガイドを参照してください。

Link to this sectionYOLO26モデルをエクスポートする際にINT8量子化を有効にするにはどうすればよいですか？#

INT8量子化は、特にエッジデバイスにおいてモデルを圧縮し、推論を高速化するための非常に優れた方法です。INT8量子化を有効にする方法は以下の通りです：

from ultralytics import YOLO

model = YOLO("yolo26n.pt")  # Load a model
model.export(format="onnx", int8=True, data="coco8.yaml")

INT8 quantization can be applied to various formats, such as ONNX, TensorRT, OpenVINO, CoreML, and Rockchip RKNN. For optimal quantization results, provide a representative dataset using the data parameter.

Link to this sectionモデルをエクスポートする際、動的な入力サイズが重要なのはなぜですか？#

動的な入力サイズにより、エクスポートされたモデルはさまざまな画像寸法を扱うことができ、柔軟性が向上し、異なるユースケースに対して処理効率が最適化されます。ONNXやTensorRTのようなフォーマットにエクスポートする際、動的な入力サイズを有効にすることで、モデルが異なる入力形状にシームレスに適応できるようになります。

この機能を有効にするには、エクスポート時に dynamic=True フラグを使用します：

from ultralytics import YOLO

model = YOLO("yolo26n.pt")
model.export(format="onnx", dynamic=True)

動的な入力サイズ指定は、ビデオ処理や異なるソースからの画像を扱う場合など、入力寸法が変化する可能性のあるアプリケーションで特に便利です。

Link to this sectionモデルパフォーマンスを最適化するために考慮すべき主要なエクスポート引数は何ですか？#

モデルパフォーマンスを最適化するには、エクスポート引数を理解し、設定することが極めて重要です：

• format: エクスポートされるモデルのターゲットフォーマット（例：onnx、torchscript、tensorflow）。
• imgsz: モデル入力に望ましい画像サイズ（例：640 または (height, width)）。
• half: FP16量子化を有効にし、モデルサイズを縮小して推論を高速化する可能性があります。
• optimize: モバイルや制約のある環境向けの特定の最適化を適用します。
• int8: INT8量子化を有効にします。エッジAIデプロイメントにおいて非常に有益です。

特定のハードウェアプラットフォームへのデプロイメントでは、NVIDIA GPU用のTensorRT、Appleデバイス用のCoreML、またはGoogle Coralデバイス用のEdge TPUといった専用のエクスポートフォーマットの使用を検討してください。

Link to this sectionエクスポートされたYOLOモデルにおいて、出力テンソルは何を表していますか？#

YOLOモデルをONNXやTensorRTなどのフォーマットにエクスポートする場合、出力テンソルの構造はモデルのタスクに依存します。これらの出力を理解することは、カスタムの推論実装にとって重要です。

検出モデル（例：yolo26n.pt）の場合、出力は通常 (batch_size, 4 + num_classes, num_predictions) の形状の単一テンソルとなり、チャンネルはボックスの座標とクラスごとのスコアを表し、num_predictions はエクスポートの入力解像度に依存します（動的になることもあります）。

セグメンテーションモデル（例：yolo26n-seg.pt）の場合、通常2つの出力が得られます。最初のテンソルは (batch_size, 4 + num_classes + mask_dim, num_predictions)（ボックス、クラススコア、およびマスク係数）の形状、2番目のテンソルは (batch_size, mask_dim, proto_h, proto_w) の形状で、インスタンスマスクを生成するために係数と共に使用されるマスクプロトタイプが含まれます。サイズはエクスポートの入力解像度に依存します（動的になることもあります）。

ポーズモデル（例：yolo26n-pose.pt）の場合、出力テンソルは通常 (batch_size, 4 + num_classes + keypoint_dims, num_predictions) の形状であり、keypoint_dims はポーズ仕様（例：キーポイントの数および信頼度が含まれるかどうか）に依存し、num_predictions はエクスポートの入力解像度に依存します（動的になることもあります）。

ONNX推論例の例では、各モデルタイプに対してこれらの出力を処理する方法を示しています。

Link to this sectionWhy is output0 FP32 when exporting with half=True and end2end=True?#

half=True（または int8=True）でエクスポートする場合、モデルサイズを縮小してパフォーマンスを向上させるために、ほとんどのテンソルは低精度に変換されます。しかし、end2end=True が有効な場合、後処理（クラスインデックスを含む）はエクスポートされたグラフに直接組み込まれます。

output0 テンソルにはクラスインデックスが含まれており、これらは内部的に浮動小数点値として表現されています。FP16は、限られた仮数精度のために2048を超える整数値を確実に表現できません。潜在的な精度損失や不正確なクラスIDを回避するため、output0 は意図的にFP32のままにされています。

この動作は想定されるものであり、クラスインデックスの忠実度を保持する必要がある低精度または量子化されたエクスポートにも適用されます。

完全なFP16出力を必要とする場合は、end2end=False でエクスポートし、外部で後処理を実行してください。