diff --git a/README.md b/README.md index bb5c412..cd7d129 100644 --- a/README.md +++ b/README.md @@ -42,7 +42,7 @@ InternDataEngine is a synthetic data generation engine for embodied AI, built on > For detailed environment setup (conda, CUDA, PyTorch, curobo), see [install.md](install.md). > -> If migrating from Isaac Sim 4.5.0, see [migerate/migerate.md](migerate/migerate.md) for known issues and fixes. +> If migrating from Isaac Sim 4.5.0, see [migrate/migrate.md](migrate/migrate.md) for known issues and fixes. ## Quick Start @@ -123,14 +123,14 @@ InternDataEngine/ tasks/ # Task definitions example_assets/ # Example USD assets (robots, objects, tables) curobo/ # GPU-accelerated motion planning library - migerate/ # Migration tools and documentation + migrate/ # Migration tools and documentation output/ # Generated data output ``` ## Documentation - [Installation Guide](install.md) -- Environment setup and dependency installation -- [Migration Guide](migerate/migerate.md) -- Isaac Sim 4.5.0 to 5.0.0 migration notes and tools +- [Migration Guide](migrate/migrate.md) -- Isaac Sim 4.5.0 to 5.0.0 migration notes and tools - [Online Documentation](https://internrobotics.github.io/InternDataEngine-Docs/) -- Full API docs, tutorials, and advanced usage ## License and Citation diff --git a/migerate/fix_usd_metadata.py b/migrate/fix_usd_metadata.py similarity index 85% rename from migerate/fix_usd_metadata.py rename to migrate/fix_usd_metadata.py index d41f010..af4855b 100644 --- a/migerate/fix_usd_metadata.py +++ b/migrate/fix_usd_metadata.py @@ -10,19 +10,19 @@ Vertex data stays unchanged (already in correct scale for the scene). Usage: # Scan only (dry run): - python migerate/fix_usd_metadata.py --root workflows/simbox/example_assets --dry-run + python migrate/fix_usd_metadata.py --root workflows/simbox/example_assets --dry-run # Fix all: - python migerate/fix_usd_metadata.py --root workflows/simbox/example_assets + python migrate/fix_usd_metadata.py --root workflows/simbox/example_assets # Fix specific pattern: - python migerate/fix_usd_metadata.py --root workflows/simbox/example_assets --pattern "Aligned_obj.usd" + python migrate/fix_usd_metadata.py --root workflows/simbox/example_assets --pattern "Aligned_obj.usd" # Skip specific directories (e.g. robot models, curobo assets): - python migerate/fix_usd_metadata.py --root . --skip curobo,robot + python migrate/fix_usd_metadata.py --root . --skip curobo,robot # Restore from backups: - python migerate/fix_usd_metadata.py --root workflows/simbox/example_assets --restore + python migrate/fix_usd_metadata.py --root workflows/simbox/example_assets --restore """ import argparse import glob @@ -103,7 +103,7 @@ def fix_usd_files(root: str, pattern: str = "*.usd", target_mpu: float = 1.0, if not dry_run and fixed > 0: print("Backups saved as *.bak.") - print("To restore: python migerate/fix_usd_metadata.py --root --restore") + print("To restore: python migrate/fix_usd_metadata.py --root --restore") return fixed @@ -131,16 +131,16 @@ if __name__ == "__main__": epilog=""" Examples: # Dry run on example assets: - python migerate/fix_usd_metadata.py --root workflows/simbox/example_assets --dry-run + python migrate/fix_usd_metadata.py --root workflows/simbox/example_assets --dry-run # Fix all Aligned_obj.usd in example assets: - python migerate/fix_usd_metadata.py --root workflows/simbox/example_assets --pattern "Aligned_obj.usd" + python migrate/fix_usd_metadata.py --root workflows/simbox/example_assets --pattern "Aligned_obj.usd" # Fix everything except robot/curobo dirs: - python migerate/fix_usd_metadata.py --root . --skip curobo,robot + python migrate/fix_usd_metadata.py --root . --skip curobo,robot # Restore all backups: - python migerate/fix_usd_metadata.py --root workflows/simbox/example_assets --restore + python migrate/fix_usd_metadata.py --root workflows/simbox/example_assets --restore """) parser.add_argument("--root", default="workflows/simbox/example_assets", help="Root directory to scan (default: workflows/simbox/example_assets)") diff --git a/migerate/migerate.md b/migrate/migrate.md similarity index 92% rename from migerate/migerate.md rename to migrate/migrate.md index bcafcae..c58b2d5 100644 --- a/migerate/migerate.md +++ b/migrate/migrate.md @@ -148,7 +148,7 @@ rotation = [0.0, 0.0, random.uniform(r[0], r[1])] ## Tools -Migration tools are located in the `migerate/` directory. +Migration tools are located in the `migrate/` directory. ### scan_usd_metadata.py — Scan USD metadata @@ -158,10 +158,10 @@ Scan all USD files and report their `metersPerUnit` / `upAxis`: conda activate banana500 # Scan entire project -python migerate/scan_usd_metadata.py --root . +python migrate/scan_usd_metadata.py --root . # Scan specific directory -python migerate/scan_usd_metadata.py --root workflows/simbox/example_assets +python migrate/scan_usd_metadata.py --root workflows/simbox/example_assets ``` Exit code: 0 = all OK, 1 = found files with non-standard metadata. @@ -174,19 +174,19 @@ Fix `metersPerUnit` and `upAxis` in USD files, with backup/restore support: conda activate banana500 # Dry run — see what would be fixed, no changes made -python migerate/fix_usd_metadata.py --root . --dry-run --skip curobo,robot +python migrate/fix_usd_metadata.py --root . --dry-run --skip curobo,robot # Fix example assets only (default) -python migerate/fix_usd_metadata.py --root workflows/simbox/example_assets +python migrate/fix_usd_metadata.py --root workflows/simbox/example_assets # Fix all USD in project, skip robot/curobo models -python migerate/fix_usd_metadata.py --root . --skip curobo,robot +python migrate/fix_usd_metadata.py --root . --skip curobo,robot # Fix only Aligned_obj.usd files -python migerate/fix_usd_metadata.py --root . --pattern "Aligned_obj.usd" +python migrate/fix_usd_metadata.py --root . --pattern "Aligned_obj.usd" # Restore from backups (undo all fixes) -python migerate/fix_usd_metadata.py --root workflows/simbox/example_assets --restore +python migrate/fix_usd_metadata.py --root workflows/simbox/example_assets --restore ``` **Important:** Do NOT fix robot USD (curobo, split_aloha) — their metersPerUnit/upAxis are intentionally set for their own coordinate systems. Use `--skip` to exclude them. diff --git a/migerate/migrate_imports.py b/migrate/migrate_imports.py similarity index 98% rename from migerate/migrate_imports.py rename to migrate/migrate_imports.py index d7a0d99..3c8d1a3 100644 --- a/migerate/migrate_imports.py +++ b/migrate/migrate_imports.py @@ -2,8 +2,8 @@ Batch migrate omni.isaac.* imports to use core.compat module. Usage: - python migerate/migrate_imports.py --dry-run # preview changes - python migerate/migrate_imports.py # apply changes + python migrate/migrate_imports.py --dry-run # preview changes + python migrate/migrate_imports.py # apply changes """ import argparse import os diff --git a/migerate/runtime_warnings.md b/migrate/runtime_warnings.md similarity index 100% rename from migerate/runtime_warnings.md rename to migrate/runtime_warnings.md diff --git a/migerate/scan_usd_metadata.py b/migrate/scan_usd_metadata.py similarity index 97% rename from migerate/scan_usd_metadata.py rename to migrate/scan_usd_metadata.py index 8271c19..f641c7e 100644 --- a/migerate/scan_usd_metadata.py +++ b/migrate/scan_usd_metadata.py @@ -2,7 +2,7 @@ Scan all USD files in the project and report their metersPerUnit / upAxis metadata. Usage: - python migerate/scan_usd_metadata.py [--root DIR] + python migrate/scan_usd_metadata.py [--root DIR] Default root: current working directory (project root). """