チュートリアルのセットアップ

チュートリアルを開始する前に、このセットアップを一度完了させてください。チュートリアルのカテゴリに合った環境を選択してください。Neat LibraryとPCIeバンドルは互換性がないことに注意してください。

1. 環境の選択

チュートリアルのカテゴリ	実行環境	Python環境
モデルと推論、グラフとパイプライン、カメラとストリーミング、GenAI	Modalix DevKit、またはチュートリアルで指定された環境	~/pyneat
PCIeコプロセッシング	Modalix PCIeカードに接続されたホスト	~/pyneatpcie

PCIeチュートリアルは、SDKコンテナ内またはカード上で直接実行するのではなく、ホスト上で実行されます。

2. Neat Libraryチュートリアルのセットアップ

Neat Library がインストールされました。がインストールされていることを確認し、チュートリアルのバンドルを配置したいディレクトリから次のコマンドを実行します。

sdk-or-devkit$sima-cli neat install core -t extrassdk-or-devkit$cd sima-neat-*-Linux-extras

DevKit 上で直接実行される Python のチュートリアルでは、PyNeat を有効にして、インポートが正常に機能することを確認してください。

devkit$source ~/pyneat/bin/activatedevkit$python3 -c "import pyneat; print('pyneat ready')"

3. PCIeチュートリアルの設定

まず、PCIeホストパッケージをインストールし、検証します。 を実行します。 次に、ホストで実行されているUbuntuバージョン用のチュートリアルバンドルをダウンロードします。 バンドルを配置したいディレクトリからコマンドを実行します。

Ubuntu 22.04:

pcie-host$sima-cli neat install core/pciehost/ubuntu22/amd64 -t extraspcie-host$cd sima-pcie-host-*-Linux-amd64-extras

Ubuntu 24.04：

pcie-host$sima-cli neat install core/pciehost/ubuntu24/amd64 -t extraspcie-host$cd sima-pcie-host-*-Linux-amd64-extras

PCIe を確認します。 PyNeat:

pcie-host$source ~/pyneatpcie/bin/activatepcie-host$python3 -c "import pyneatpcie; print('pyneatpcie ready')"

4. モデルアーカイブを準備する

チュートリアルで指定されたモデルをダウンロードするには、Model Zoo を使用します。例：

sdk-devkit-or-pcie-host$sima-cli modelzoo get resnet_50sdk-devkit-or-pcie-host$sima-cli modelzoo get yolo_v8s

Neat Libraryのチュートリアルでは、--modelを受け入れるため、ダウンロードしたアーカイブを直接渡すことができます。PCIeチュートリアルでは、PCIeエクストラディレクトリのルートにある固定ファイル名を使用します。

PCIeチュートリアル	必要なモデルファイル
PCIe経由で最初のモデルを実行	yolo_v8s_mpk.tar.gz
PCIe非同期推論を実行	yolo_v8s_mpk.tar.gz
複数のモデルを実行	resnet_50_mpk.tar.gzとyolo_v8s_mpk.tar.gz

Model Zooの出力名と場所は異なる場合があります。必要に応じて、アーカイブを必要な名前でPCIeエクストラディレクトリのルートにコピーしてください。

pcie-host$cp /absolute/path/to/downloaded-resnet-archive.tar.gz resnet_50_mpk.tar.gzpcie-host$cp /absolute/path/to/downloaded-yolov8s-archive.tar.gz yolo_v8s_mpk.tar.gz

5. パスと期待される出力を確認する

抽出した追加ファイルのルートディレクトリから、チュートリアルのコマンドを実行します。そこに、ビルドヘルパー、事前にビルドされたC++プログラム、およびチュートリアルのソースコードが含まれていることを確認してください。

sdk-or-pcie-host$test -x build.shsdk-or-pcie-host$ls lib/*/tutorials/sdk-or-pcie-host$ls share/*/tutorials/

• 事前に作成されたC++プログラムは、lib/<package>/tutorials/にあります。
• C++とPythonのソースコードは、share/<package>/tutorials/にあります。
• ./build.sh --list-targetsには、再構築できるC++プログラムのリストが記載されています。
• 正常に完了したC++のチュートリアルは、[OK]で終了します。Pythonのチュートリアルは、top1=...、completed=...、またはdetections=...などの簡潔な結果を出力します。

チュートリアルでファイルが見つからないというエラーが表示された場合は、まず現在のディレクトリとモデルファイル名を確認してください。さらに詳しい情報が必要な場合は、トラブルシューティングを参照してください。