既存の .xosc を開いて再生する

drawtonomy は OpenSCENARIO 1.x .xosc ファイルを読み込み、WebAssembly にコンパイルされた esmini でブラウザ内で実行します。インポートされたシナリオは読み取り専用ではなく、アクト、イベント、アクション、トリガーはスクラッチから作成する場合と同じエディタに配置されます。

.xosc + .xodr ペアをインポートし、インポートされたフェーズとイベントを検査して、シナリオを実行します。

両方のファイルが必要です

.xosc はアクターが何をするかを記述します。ただし道路は含まれません。それは RoadNetwork 要素で OpenDRIVE .xodr を参照しています。その道路がなければ、エンティティを配置する場所がないため、drawtonomy はインポート前に道路ファイルを要求します。

開始前に両方のファイルを用意してください。.xosc が esmini リポジトリから来た場合、マッチする .xodr は resources/xodr/ ディレクトリの resources/xosc/ の隣にあります。

シナリオを開く 3 つの方法

ドラッグ・ドロップ

ファイルマネージャーで .xosc と .xodr を両方選択し、キャンバスに一緒にドロップします。これが最短経路です。drawtonomy は 1 ステップで自動的にペアを作成してインポートします。道路が読み込まれ、アクターが配置され、ロジックカードが埋まり、すべて追加のプロンプトなしに完了します。

ペアリングは .xosc が RoadNetwork 要素で指定した道路にキーを基づいています。ドロップした .xodr が参照されたものでない場合、または .xosc だけをドロップした場合、drawtonomy はペアを完成させることができず、OPENDRIVE MAP REFERENCED バナーにフォールバックして、正しい道路ファイルを指定できます。

インポートメニュー

ハンバーガーメニュー → Import… を選択し、.xosc を選択します。

ファイルダイアログは 1 つのファイルだけを受け入れるため、drawtonomy は画面上部にバナーを表示します。

OPENDRIVE MAP REFERENCED cut-in.xosc → ../xodr/e6mini.xodr

Open .xodr をクリックして、道路ファイルを選択します。バナーには × もあります。それをクリックするとインポートが終了して何もロードされないため、キャンセルする意図がない限り Open .xodr を使用してください。

GitHub リンクから

アプリ URL に ?open= と GitHub ファイル URL を追加します。

https://drawtonomy.com/?open=https://github.com/esmini/esmini/blob/master/resources/xosc/cut-in.xosc

そのリンクはライブです。試してみてください。 drawtonomy で esmini cut-in シナリオを開く →

drawtonomy は .xosc を取得し、RoadNetwork 参照を読み、同じリポジトリの同じコミットまたはブランチから .xodr を引き出します。また、シナリオが参照する Catalogs ディレクトリを列挙し、見つけたカタログファイルをロードします。これが、カタログが自動的に解決される唯一のルートです。

受け入れるもの、受け入れないもの。


受け入れるホスト	`github.com` ファイル blob リンク、および `raw.githubusercontent.com`
拒否	その他のホストおよび `tree/` ディレクトリリンク
リポジトリ	公開である必要があります — フェッチは認証されていません
レート制限	カタログ一覧は認証されていない GitHub API を使用し、1 時間あたり 60 リクエストでキャップされています
絶対パス	Windows パス (`C:\…`) を指す `RoadNetwork` は解決できません。代わりに `.xodr` を要求されます

これにより、1 つのリンクはレビュアーと共有可能な実行可能なシナリオに十分です。ダウンロード、インストール不要です。

編集したシナリオを共有する

?open= ルートは GitHub から読み取るため、編集したシナリオを共有するには、ファイルを GitHub が提供できる場所に置きます。

drawtonomy で、Export → OpenSCENARIO (.xosc)… を開き、INCLUDE を .xosc + .xodr に設定して道路がシナリオと一緒に移動するようにします。(エクスポートが書く相対 RoadNetwork パスを保持します。)
両方のファイルを パブリック GitHub リポジトリにコミットしてプッシュします。
.xosc ファイルの GitHub blob URL (ファイルのページから github.com/…/blob/… リンク) をコピーし、https://drawtonomy.com/?open= に追加します。

そのリンクを開く人は誰もが編集されたシナリオ、その道路、リポジトリが含むカタログを取得します。?open= は同じリポジトリからカタログをロードするため、自動的に解決されます。

インポートが生成するもの

成功したインポート後、drawtonomy は シナリオ モードに自動的に切り替わり、ロジックカードが埋まります。

各 OpenSCENARIO Act は フェーズ になり、名前が保持されます。CutInAndBrakeAct を含むシナリオは、その名前のフェーズを表示します。
各 Event は、それを実行するアクターの下にイベントカードになり、元のイベント名でラベル付けされます。
ストーリーボードの StopTrigger は END CONDITIONS ノードになります。例えば After CutInManeuver ends。

任意のイベントカードをクリックして、イベントエディタを開きます。トリガー、アクション、ダイナミクスプロファイル、優先度はすべてラウンドトリップするため、インポートされた Time gap to actor トリガーは、同じしきい値の Time gap to actor として読み取られます。Maneuver と ManeuverGroup の名前は ADVANCED セクションの下に保持されます。カードには表示されません。

カタログの警告について

公開されたシナリオの多くは <CatalogLocations> を宣言し、外部カタログファイルから車両モデルを取得します。そのようなファイルをインポートするとき、drawtonomy は情報トーストを表示します。

このシナリオは提供されていない外部カタログを参照しています。カタログファイルを .xosc と一緒にドロップするか、アクターが読み込まれない場合があります。

これを エラーではなく情報 として読みます。

.xosc がカタログロケーションを宣言するときはいつでも表示されます。実際に何が欠けているかどうかに関係なく。
標準的な車両カタログエントリは drawtonomy の組み込みモデルにマップされるため、ほとんどの場合、すべてのアクターが正しい形状、色、開始位置で読み込まれ、シナリオが最後まで再生されます。
トーストは数秒後に自動的に消えます。読み直す必要がある場合は、ファイルを再インポートしてください。
カタログは ?open= GitHub ルートを介して自動的に解決されます。

アクターが実際にインポート後に欠けている場合、それは明白に表示されます。影響を受けたエンティティはキャンバスに表示されません。

インポート後のシナリオ編集

インポート後に何でも変更できますが、1 つの詳細が人々を迷わせます。変数パネル (ロジックカードの {x} ボタン) がそれを直接言っています。

ここで値を編集しても、リテラル値でインポート済みのアクションは変わりません (参照はインポート時に解決されます)。

言い換えれば、元の .xosc が $HostVehicle_Speed を使用し、そのパラメータが 27.7 だった場合、インポートされたアクションは参照ではなく 27.7 を保有します。その後、パラメータを変更してもアクションは移動しません。アクション自体を編集してください。

再生と検査

ロジックカード上部のトランスポート行が実行を駆動します。再生と一時停止、開始にリセット、再生速度、フォローカメラ、ゴーストトレイル、および判定バッジ。タイムラインをドラッグするか、任意の時点にシークするをクリックします。完全なセットについては再生を参照してください。

インポートされたシナリオの場合、採用する価値のある 2 つの習慣があります。

再生する前にフォローカメラを設定します。インポートされた道路ネットワークはしばしばキロメートル単位で長く、デフォルトカメラは何も追跡しません。
見守る代わりにシークします。すべてのポーズはシミュレーションから来ているため、カットインの正確なフレームで一時停止することは正確で、推定ではありません。

トラブルシューティング

症状	原因
`.xosc` を選択後、何もロードされない	道路ファイルが提供されていません。再インポートして、バナーで Open .xodr を使用してください。
アクターすべてが重なっている	道路が読み込まれなかったため、すべてのエンティティが原点にフォールバックしました。`.xodr` がシナリオと一致することを確認してください。
アクターが途中で停止して再度動かない	道路の終わりに到達しました。道路を拡張するか、より長い `.xodr` を使用してください。
毎回インポートでカタログトーストが表示される	`<CatalogLocations>` を持つ `.xosc` では予想通りです。上記を参照。
GitHub リンクが拒否される	`github.com` blob リンクと `raw.githubusercontent.com` のみが受け入れられ、リポジトリは公開である必要があります。