NVIDIA Isaac SimのCore APIチュートリアルを進めている際に、スクリプトのホットリロードを行うと特定のディレクトリ（例：general）が消えてしまうという現象に遭遇することがあります。これは初学者にとって非常に混乱しやすい挙動ですが、原因は環境の仕様やリロードの仕組みにあります。本記事では、その原因と対策について整理します。
ホットリロードとは何が起きているのか
Isaac Simのホットリロードは、Pythonスクリプトや拡張機能を再読み込みする機能です。
このとき内部的にはアプリケーションのモジュールが一度アンロードされ、再初期化されます。
その結果、メモリ上に作成されたオブジェクトや一時ディレクトリ構造がリセットされることがあります。
generalディレクトリが消える原因
generalディレクトリが消える主な理由は「実体ファイルではなく動的生成領域」である可能性です。
Isaac Simではチュートリアル用に仮想的な構造を作ることがあり、ホットリロード時に再生成されない場合があります。
また、拡張機能の再読み込み時に初期化処理が再実行され、ディレクトリ構造がリセットされることもあります。
拡張機能（Extension）の再初期化の影響
Isaac SimではExtension単位でPythonコードが管理されており、ホットリロード時に完全に再ロードされます。
その際、setupやinit処理で作成されたディレクトリや状態は初期状態に戻ります。
結果として「前回作られたgeneralが消えたように見える」現象が発生します。
ファイルパスとワークスペースの違い
チュートリアルで扱うgeneralディレクトリは、実際のプロジェクトディレクトリではなくワークスペース依存のパスである場合があります。
相対パスで参照している場合、ホットリロード後にカレントディレクトリが変わることで見えなくなることがあります。
絶対パスを使うことでこの問題を回避できるケースがあります。
対策方法の基本方針
この問題を回避するには「状態を永続化する設計」にすることが重要です。
例えばディレクトリ作成処理を毎回実行する、または初期化関数内で再構築する方法があります。
また、ログやパスをprintして現在のワークスペースを確認することも有効です。
チュートリアル環境特有の注意点
Core APIチュートリアルは学習用に簡略化されているため、実運用環境とは挙動が異なる場合があります。
特にホットリロードは開発効率を上げるための機能であり、状態保持には向いていません。
そのため「消える」のではなく「再生成されていない」と考えるのが正確です。
まとめ
generalディレクトリがホットリロードで消えるように見える原因は、モジュールの再初期化やワークスペース依存のパス構造にあります。
実際には削除ではなく再生成されていない、または参照パスが変わっているケースが多いです。
対策としては絶対パスの使用や初期化処理の見直しが有効です。
コメント