Axelera AIのエクスポートとデプロイ#
UltralyticsはAxelera AIと提携し、Edge AIデバイス上で高性能かつエネルギー効率の高い推論を実現します。Voyager SDKを使用して、Ultralytics YOLOモデルをMetis® AIPUに直接エクスポートおよびデプロイします。
Axelera AIは、独自の情報フローアーキテクチャとインメモリコンピューティングを使用して、低消費電力で最大856 TOPSを実現し、エッジでのコンピュータビジョン向けに専用のハードウェアアクセラレーションを提供します。
適切なハードウェアの選択#
Axelera AIは、さまざまなデプロイ要件に対応するため、多様なフォームファクタを提供しています。以下のチャートは、Ultralytics YOLOデプロイメントに最適なハードウェアを特定するのに役立ちます。
graph TD
A[Start: Select Deployment Target]:::start --> B{Device Type?}:::decide
B -->|Edge Server / Workstation| C{Throughput Needs?}:::decide
B -->|Embedded / Robotics| D{Space Constraints?}:::decide
B -->|Standalone / R&D| E[Dev Kits & Systems]:::proc
C -->|Max Density <br> 30+ Streams| F[**Metis PCIe x4**<br>856 TOPS]:::out
C -->|Standard PC <br> Low Profile| G[**Metis PCIe x1**<br>214 TOPS]:::out
D -->|Drones & Handhelds| H[**Metis M.2**<br>2280 M-Key]:::out
D -->|High Performance Embedded| I[**Metis M.2 MAX**<br>Extended Thermal]:::out
E -->|ARM-based All-in-One| J[**Metis Compute Board**<br>RK3588 + AIPU]:::out
E -->|Prototyping| K[**Arduino Portenta x8**<br>Integration Kit]:::out
click F "https://store.axelera.ai/"
click G "https://store.axelera.ai/"
click H "https://store.axelera.ai/"
click J "https://store.axelera.ai/"
classDef start fill:#4CAF50,color:#fff
classDef proc fill:#2196F3,color:#fff
classDef decide fill:#FF9800,color:#fff
classDef out fill:#9C27B0,color:#fffハードウェアポートフォリオ#
Axeleraハードウェアのラインナップは、高いFPS-per-watt効率でUltralytics YOLO26および従来バージョンを実行できるように最適化されています。
アクセラレータカード#
これらのカードにより、既存のホストデバイスでのAIアクセラレーションが可能になり、ブラウンフィールド環境へのデプロイが容易になります。
| 製品 | フォームファクタ | 計算能力 | パフォーマンス (INT8) | 対象アプリケーション |
|---|---|---|---|---|
| Metis PCIe x4 | PCIe Gen3 x16 | 4x Metis AIPU | 856 TOPS | 高密度ビデオ分析、スマートシティ |
| Metis PCIe x1 | PCIe Gen3 x1 | 1x Metis AIPU | 214 TOPS | 産業用PC、リテール向けキュー管理 |
| Metis M.2 | M.2 2280 M-Key | 1x Metis AIPU | 214 TOPS | ドローン、ロボティクス、ポータブル医療機器 |
| Metis M.2 MAX | M.2 2280 | 1x Metis AIPU | 214 TOPS | 高度な熱管理を必要とする環境 |
統合システム#
ターンキーソリューションのために、Axeleraはメーカーと提携し、Metis AIPU向けに事前検証済みのシステムを提供しています。
- Metis Compute Board: Metis AIPUとRockchip RK3588 ARM CPUを組み合わせたスタンドアロンのエッジデバイス。
- ワークステーション: Dell (Precision 3460XE) および Lenovo (ThinkStation P360 Ultra) のエンタープライズタワー。
- 産業用PC: 製造業の自動化向けに設計されたAdvantechおよびAetinaの高耐久システム。
サポートされているタスク#
深度推定はサポートされていません。深度ヘッドがMetis AIPUコンパイラでロワーできない演算子を出力するためです。Ultralytics exportによるYOLO26セグメンテーションもサポートされていませんが、後述のようにVoyager SDKを使用してデプロイすることは可能です。
YOLO26セグメンテーションは、Ultralyticsの export コマンドではまだサポートされていません。YOLO26-segを必要とするユーザーは、ユーザースペースの回避策を提供する deploy.py を使用して、Voyager SDK経由でデプロイできます。ネイティブコンパイラのサポートは、今後のリリースで追加される予定です。
インストール#
Axeleraフォーマットへのエクスポートには以下が必要です:
- OS: Linuxのみ (Ubuntu 22.04/24.04を推奨)
- ハードウェア: Axelera AIアクセラレータ(Metisデバイス)
- Python: バージョン 3.10、3.11、3.12、および 3.13
- システム依存関係:
sudo apt install libgl1(OpenCVに必要で、pipからは含まれません)
Ultralyticsのインストール#
pip install ultralytics詳細な手順については、Ultralytics インストールガイドを参照してください。問題が発生した場合は、一般的な問題ガイドを参照してください。
Axeleraドライバのインストール#
-
Axeleraリポジトリキーを追加します:
sudo sh -c "curl -fsSL https://software.axelera.ai/artifactory/api/security/keypair/axelera/public | gpg --dearmor -o /etc/apt/keyrings/axelera.gpg" -
aptにリポジトリを追加します:
使用しているOSに合わせて、以下の適切なスニペットを選択してください。
# Ubuntu 22.04 sudo sh -c "echo 'deb [signed-by=/etc/apt/keyrings/axelera.gpg] https://software.axelera.ai/artifactory/axelera-apt-source ubuntu22 main' > /etc/apt/sources.list.d/axelera.list"# Ubuntu 24.04 sudo sh -c "echo 'deb [signed-by=/etc/apt/keyrings/axelera.gpg] https://software.axelera.ai/artifactory/axelera-apt-source ubuntu24 main' > /etc/apt/sources.list.d/axelera.list" -
SDKをインストールし、ドライバをロードします:
sudo apt update sudo apt install -y metis-dkms=1.5.5 sudo modprobe metis
カーネルドライバはPython SDKパッケージとは別にインストールされるため、SDKをアップグレードした(例:1.6から1.7へ)後は、一致するドライババージョンをインストールする必要があります。ドライバのバージョンが一致していないと、デバイスが使用できなくなります。axdeviceは必要なバージョンを報告し、デバイスのオープンに失敗します。
[libaxldev.c:285] Found kernel driver version 1.4.16, but at least version 1.4.18 is required. Please update the kernel driver
ERROR: AXR_ERROR_CONNECTION_ERROR: Failed to open device metis-0:4:0SDKに一致するドライババージョンをインストールします。ステップ3:Metisカーネルドライバのインストールを参照してください。Ubuntu上で以前のSDKをすでに実行している場合は、ドライバを更新してカーネルモジュールをリロードします(再起動は不要です):
sudo apt update
sudo apt install -y metis-dkms=1.5.5
sudo rmmod metis
sudo modprobe metisその後、axdeviceを再度実行して、デバイスが検出されていることを確認します。
Axeleraモデルを指定した最初のyolo export format=axeleraまたはyolo predictの実行時に、Axelera SDKパッケージが自動的にダウンロードおよびインストールされます。接続速度によっては数分かかる場合があり、ダウンロード中の進捗状況は表示されません。事前に手動でインストールするには:
pip install axelera-devkit==1.7.0 --extra-index-url https://software.axelera.ai/artifactory/api/pypi/axelera-pypi/simple
pip install axelera-rt==1.7.0 --extra-index-url https://software.axelera.ai/artifactory/api/pypi/axelera-pypi/simpleYOLOモデルのAxeleraへのエクスポート#
Axeleraフォーマットは、エクスポート (Export)、予測 (Predict)、および検証 (Validate)モードをサポートしています。推論と検証はAxelera Metis AIPUハードウェア上で実行されます。モデルをエクスポートした後、エクスポートされたモデルをロードして推論を実行するか、精度を検証します。
from ultralytics import YOLO
# Load a YOLO26 model
model = YOLO("yolo26n.pt")
# Export the model to Axelera format
model.export(format="axelera") # creates 'yolo26n_axelera_model'from ultralytics import YOLO
# Load the exported Axelera model
model = YOLO("yolo26n_axelera_model")
# Run inference
results = model("https://ultralytics.com/images/bus.jpg")from ultralytics import YOLO
# Load the exported Axelera model
model = YOLO("yolo26n_axelera_model")
# Validate accuracy on the COCO8 dataset
metrics = model.val(data="coco8.yaml")Axeleraコンパイラにはnumpy<2が必要です。環境にnumpy>=2がある場合、最初のyolo exportによって自動的にダウングレードされますが、モジュールの状態が古いためエクスポートは失敗します。同じエクスポートコマンドをもう一度実行するだけで、2回目の実行で成功します。
エクスポートの引数#
| 引数 | タイプ | デフォルト | 説明 |
|---|---|---|---|
format | str | 'axelera' | Axelera Metis AIPUハードウェアのターゲットフォーマット。 |
imgsz | int または tuple | 640 | モデル入力の画像サイズ。 |
batch | int | 1 | エクスポートモデルのバッチ推論サイズ、またはpredictモードでエクスポートされたモデルが同時に処理する画像の最大数を指定します。 |
quantize | int または str | 8/auto | 量子化精度。Axelera AIPUには8(INT8)が必要であり、自動的に有効になります。非推奨となったhalf/int8フラグを置き換えます。INT8量子化を参照してください。 |
data | str | 'coco128.yaml' | 量子化キャリブレーション用のデータセット設定。 |
fraction | float | 1.0 | キャリブレーションに使用するデータセットの割合(100〜400枚の画像を推奨)。 |
device | str | None | エクスポートデバイス:GPU(device=0)またはCPU(device=cpu)。 |
すべてのおよびエクスポートオプションについては、エクスポートモードのドキュメントを参照してください。
出力構造#
yolo26n_axelera_model/
├── yolo26n.axm # Axelera model file
├── compiler_config_final.toml # Compiler configuration used for the build
└── metadata.yaml # Model metadata (classes, image size, etc.)Axelera AIベンチマーク#
Metis AIPUは、エネルギー消費を最小限に抑えながらスループットを最大化します。
| モデル | Metis PCIe FPS (フレーム毎秒) | Metis M.2 FPS (フレーム毎秒) |
|---|---|---|
| YOLOv8n | 847 | 771 |
| YOLO11n | 746 | 574 |
| YOLO26n | 648.6 | 484.9 |
ベンチマークはAxelera AIのデータに基づいています。実際のFPSはモデルサイズ、バッチ処理、入力解像度によって異なります。
実際のアプリケーション#
Axeleraハードウェア上のUltralytics YOLOは、高度なエッジコンピューティングソリューションを実現します:
- スマートリテール: 店舗最適化のためのリアルタイムオブジェクトカウントおよびヒートマップ分析。
- 産業安全: 製造環境における低遅延のPPE検出。
- ドローン分析: 農業や捜索救助活動のために、UAV上で高速な物体検出を実行します。
- 交通システム: エッジベースのナンバープレート認識および速度推定。
推奨されるワークフロー#
- Ultralytics トレーニングモードを使用してモデルを**トレーニング (Train)**する
model.export(format="axelera")を使用してAxeleraフォーマットに**エクスポート (Export)**するyolo valを使用して精度を**検証 (Validate)**し、量子化による損失が最小限であることを確認する- 定性的な検証のために
yolo predictを使用して**予測 (Predict)**を実行する - PyTorchへの依存なしで高性能なエンドツーエンドのパイプラインにデプロイします。
axelera-rtを使用した構成可能なPythonパイプラインについては、YOLO on Voyager SDK examplesを参照してください。
デバイス健全性チェック#
Axeleraデバイスが正常に機能しているか確認してください:
# if axdevice cannot be found, please run at least one inference (see above) to ensure the required packages are installed
axdevice詳細な診断については、AxDeviceドキュメントを参照してください。
最大パフォーマンス#
この統合では互換性のためにシングルコア構成を使用しています。最大のスループットを必要とする本番環境向けに、Axelera Voyager SDKでは以下が提供されています:
- マルチコア活用(クアッドコア Metis AIPU)
- ストリーミング推論パイプライン
- 高解像度カメラ向けタイルベース推論
FPSのベンチマークについてはモデルズーを参照するか、本番サポートについてAxeleraにお問い合わせください。
既知の課題#
- M.2の電力制限: 大規模または超大規模なモデルの場合、電源供給の制約によりM.2アクセラレータで実行時エラーが発生する可能性があります。
サポートについては、Axeleraコミュニティにアクセスしてください。
よくある質問 (FAQ)#
AxeleraでサポートされているYOLOのバージョンは何ですか?#
Voyager SDKは、YOLOv8、YOLO11、およびYOLO26モデルのエクスポートをサポートしています。モデルごとのタスクの可用性については、サポートされているタスクを参照してください。
独自にトレーニングしたモデルをデプロイできますか?#
はい。Ultralytics トレーニングモードを使用してトレーニングされたモデルであれば、サポートされているレイヤーと演算子を使用している限り、Axeleraフォーマットにエクスポートできます。
INT8量子化は精度にどのような影響を与えますか?#
AxeleraのVoyager SDKは、混合精度AIPUアーキテクチャ向けにモデルを自動的に量子化します。ほとんどのオブジェクト検出タスクにおいて、パフォーマンスの向上(高FPS、低電力)は、mAPへのごくわずかな影響を大幅に上回ります。量子化には、モデルのサイズに応じて数秒から数時間かかります。エクスポート後にyolo valを実行して精度を確認してください。
キャリブレーション画像は何枚使用すべきですか?#
100枚から400枚の使用を推奨します。400枚を超えても追加の利点はなく、量子化時間が増加するだけです。100枚、200枚、400枚で試行し、最適なバランスを見つけてください。
Voyager SDKはどこで入手できますか?#
SDK、ドライバ、およびコンパイラツールは、Axeleraデベロッパーポータルから入手できます。