Skip to content

Fix multi-backend architecture docs#5810

Merged
kellyguo11 merged 1 commit into
isaac-sim:developfrom
AntoineRichard:antoiner/docs-multi-backend-commands
May 27, 2026
Merged

Fix multi-backend architecture docs#5810
kellyguo11 merged 1 commit into
isaac-sim:developfrom
AntoineRichard:antoiner/docs-multi-backend-commands

Conversation

@AntoineRichard

@AntoineRichard AntoineRichard commented May 27, 2026

Copy link
Copy Markdown
Collaborator

Description

Clarifies the Multi-Backend Architecture documentation so the factory overview renders distinct backend implementation names instead of repeated Articulation links. The page now mentions OvPhysX alongside PhysX and Newton where the backend is supported, and the Cartpole examples use root-runnable ./isaaclab.sh train --rl_library rsl_rl ... commands.

No new dependencies are required.

No linked issue.

Type of change

  • Documentation update

Screenshots

Not applicable. This is an RST documentation text update.

Checklist

  • I have read and understood the contribution guidelines
  • I have run the pre-commit checks with ./isaaclab.sh --format
  • I have made corresponding changes to the documentation
  • My changes generate no new warnings (not verified with a full docs build)
  • I have added tests that prove my fix is effective or that my feature works (not added; docs-only change)
  • I have added a changelog fragment under source/<pkg>/changelog.d/ for every touched package (not added; top-level docs-only change)
  • I have added my name to the CONTRIBUTORS.md or my name already exists there

Validation

  • ./isaaclab.sh -f
  • ./isaaclab.sh train --rl_library rsl_rl --task Isaac-Cartpole-Direct-v0 --help
  • ./isaaclab.sh train --rl_library rsl_rl --task Isaac-Cartpole-Direct-v0 --help physics=newton_mjwarp
  • ./isaaclab.sh train --rl_library rsl_rl --task Isaac-Cartpole-Direct-v0 --help physics=ovphysx
  • ./isaaclab.sh -p -c "from isaaclab_ovphysx.physics import OvPhysxManager, OvPhysxCfg; from isaaclab_ovphysx.assets import Articulation, RigidObject; from isaaclab_ovphysx.sensors import ContactSensor; from isaaclab_ovphysx.cloner import ovphysx_replicate"

Clarify backend-specific factory links, add OvPhysX coverage to the architecture overview, and replace incomplete Cartpole training examples with root-runnable commands.
@github-actions github-actions Bot added the documentation Improvements or additions to documentation label May 27, 2026
@greptile-apps

greptile-apps Bot commented May 27, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

This PR updates docs/source/overview/core-concepts/multi_backend_architecture.rst to add OvPhysX as a first-class documented backend alongside PhysX and Newton, and fixes several inaccuracies in the existing examples.

  • OvPhysX is added to the component table, backend-selection code block, preset CartpolePhysicsCfg class, and CLI command examples.
  • The example env class is corrected from ManagerBasedRLEnvCfg (which had no import and doesn't match the Isaac-Cartpole-Direct-v0 task) to DirectRLEnvCfg, previously-missing imports (SimulationCfg, DirectRLEnvCfg) are added, and the CLI examples are updated from the incomplete python train.py form to the runnable ./isaaclab.sh train form with the correct physics= override syntax.

Confidence Score: 5/5

Documentation-only change with no runtime impact; all three backends are covered consistently and the corrected examples are more accurate than what they replace.

Every touched section is internal documentation. The changes are additive (OvPhysX column/examples) or corrective (fixing missing imports, wrong base class, outdated CLI commands). No executable code paths are altered.

No files require special attention.

Important Files Changed

Filename Overview
docs/source/overview/core-concepts/multi_backend_architecture.rst Documentation-only update adding OvPhysX coverage to the component table, backend-selection examples, preset config, and CLI commands; also fixes missing imports and corrects the env base class to DirectRLEnvCfg for the Cartpole-Direct task.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A["User code: Articulation(cfg)"] --> B["FactoryBase.__new__()"]
    B --> C["_get_backend()\nreads SimulationContext.physics_manager\n→ 'physx' | 'newton' | 'ovphysx'"]
    C --> D["_get_module_name()\n isaaclab.assets.articulation\n→ isaaclab_{backend}.assets.articulation"]
    D --> E["importlib.import_module()\nlazy load on first use"]
    E --> F1["isaaclab_physx.assets.Articulation"]
    E --> F2["isaaclab_newton.assets.Articulation"]
    E --> F3["isaaclab_ovphysx.assets.Articulation"]
    F1 --> G["Return backend-specific instance"]
    F2 --> G
    F3 --> G
Loading

Reviews (1): Last reviewed commit: "Fix multi-backend architecture docs" | Re-trigger Greptile

@kellyguo11 kellyguo11 merged commit 901473f into isaac-sim:develop May 27, 2026
37 checks passed
kellyguo11 added a commit that referenced this pull request May 28, 2026
… locomanip quaternion, deformable demo, IK, benchmark scripts (#5816)

# Description

Cherry pick following PRs from develop:

- #5779 
- #5760
- #5791
- #5810 
- #5811
- #5812 
- #5754 
- #5802 
- #5803 
- #5782
- #5804 
- #5744 
- #5775 
- #5784

---------

Signed-off-by: Kelly Guo <kellyg@nvidia.com>
Co-authored-by: John <jaybdub@users.noreply.github.com>
Co-authored-by: myurasov-nv <168484206+myurasov-nv@users.noreply.github.com>
Co-authored-by: Antoine RICHARD <antoiner@nvidia.com>
Co-authored-by: Mike Yan Michelis <46975745+mmichelis@users.noreply.github.com>
Co-authored-by: hujc <jichuanh@nvidia.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants