チュートリアルのアセットとモデルアーカイブ

ほとんどのチュートリアルユーザーは、--model <path>と--image <path>のみを使用します。このページは、ソースツリーでの実行、テスト、および再現可能なデバッグセッションで使用する場合に、モデルアーカイブとサンプルアセットの場所を制御したい場合に役立ちます。

この情報は、初心者向けのチュートリアルから除外してください。有用ですが、最初のステップではありません。

モデルアーカイブの優先設定

リポジトリローカルのテストやヘルパースクリプトで、コマンドをすべて変更することなくモデルアーカイブのパスが必要な場合に、以下の環境変数を使用してください。

変数	の使用
`SIMA_RESNET50_TAR`	ResNet-50のチュートリアルとテストに対するモデルごとの上書き設定。
`SIMA_MODEL_TAR`	モデルを基盤とするテストやサンプルで使用される、共有のフォールバックモデルアーカイブ。
`SIMA_YOLO_TAR`	スクリプトが対応している場合、YOLOスタイルの検出に関するチュートリアルやテストにおいて、モデルごとに設定を上書きできます。

チュートリアルのコマンドは、引き続き明示的なフラグを受け付けます。単一の実行の場合は、--model <path> を使用することを推奨します。複数のコマンドで同じアーティファクトを共有する必要がある場合は、環境変数を使用してください。

sdk-or-devkit$export SIMA_RESNET50_TAR=/path/to/resnet_50.tar.gzsdk-or-devkit$export SIMA_YOLO_TAR=/path/to/yolo_v8s.tar.gz

リポジトリ固有のテストやサンプルは、通常、以下の場所を調べます。 tmp/ リポジトリのルートディレクトリに配置します。一般的なパスは次のとおりです。

インストールされたチュートリアルは、代わりに「extras」フォルダから実行できます。その場合、モデルと画像のパスがすでに/tmpの下にない場合は、明示的に指定してください。

Neat は、モデルアーカイブを実行する前に、それらを展開します。これらの変数は主に、デバッグ中に検査およびクリーンアップを制御するために使用されます。

変数	効果
`SIMA_MPK_EXTRACT_ROOT=<dir>`	は、抽出されたモデルデータの基本ディレクトリを設定します。
`SIMA_MPK_CLEANUP_EXTRACTED=0`	プロセス終了後も、プロセス固有の`proc_*`抽出ルートを保持し、後で検査できるようにします。他のプロセスは、これを自動的に検出したり再利用したりすることはありません。
`SIMA_MPK_EXTRACT_GC_STALE_PROC=0`	起動時に、古い `proc_*` ディレクトリのクリーンアップを無効にします。

生成された設定ファイルを調べたり、異なる実行間で抽出されたアーティファクトを比較する必要がある場合にこれらを使用します。通常の使用やチュートリアルを行う場合は、デフォルト設定のままにしておいてください。

一部のソースツリーテストでは、COCOのサンプル画像を使用し、画像が存在しない場合はダウンロードします。環境でローカルミラーが必要な場合は、URLを上書きしてください。

sdk-or-devkit$export SIMA_COCO_URL=https://example.com/path/to/coco_sample.jpg

1つのチュートリアル実行では、--image <path> を使用してください。テストスイートまたはCIジョブで、制御された場所からデータを取得する必要がある場合は、SIMA_COCO_URL を使用してください。

チュートリアルでSKIP: missing ...と表示された場合、またはモデルを開けなかった場合は：

メッセージに表示されているパスを確認してください。
アセットをチュートリアルフラグとともに明示的に渡してください。
source-treeのテストを実行する場合は、対応する環境変数を設定してください。
アセットがModel Zooからダウンロードされたものであることを確認し、ダウンロードしたファイル名を確認してください。チュートリアルの指示に従い、実際の.tar.gzファイルを参照するように設定してください。

通常の使用時には、モデルアーカイブを手動で展開しないでください。Neatは、コンパイルされたアーカイブのパスを期待し、自身で展開処理を行います。