Skip to content

Commit 43b2b7d

Browse files
mataylor-nvidiaisaaclab-bot[bot]
authored andcommitted
Document the 15625 scene partition cap for Isaac RTX renderer (#7573)
## Summary - Document that Isaac RTX's `rtx.scenedb.plugin` caps the number of scene partitions at 15625; requesting more environments than that with scene partitioning enabled silently discards additional partitions and causes environments to share tiled camera views. - Add a warning note to the scene partitioning section of the renderers overview doc. - Add a corresponding Known Issues entry under the Renderers section, following the existing animated-curve scene-partition entry's format. ## Type of change - Documentation update ## Release backport - [x] <!-- backport-active-release --> Backport this pull request to the active release branch after it merges into `develop` ## Test plan - [x] `uv run isaaclab -f` passes (docs/rst formatting checks) - [x] Manually reviewed rendered structure/headings match existing doc conventions in both files (cherry picked from commit 5c78cae)
1 parent 913ac53 commit 43b2b7d

2 files changed

Lines changed: 34 additions & 0 deletions

File tree

docs/source/overview/core-concepts/renderers.rst

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -88,6 +88,16 @@ token per instance; markers without that ownership information remain shared.
8888
culled once they deform beyond their initial extent. See
8989
:ref:`known-issues-animated-curve-scene-partition` for the workaround.
9090

91+
.. warning::
92+
93+
The Isaac RTX and OVRTX renderers cap the number of scene partitions at 15625.
94+
Requesting more than 15625 environments with scene partitioning enabled discards
95+
the additional partitions, and ``rtx.scenedb.plugin`` logs ``SceneDbContext : Maximum
96+
number of scene partitions (15625) reached. Additional scene partitions will be
97+
discarded.`` Environments beyond that count then share a partition with another
98+
environment, so their tiled camera views can show another environment's geometry.
99+
See :ref:`known-issues-scene-partition-count-cap` for details.
100+
91101
Architecture Overview
92102
---------------------
93103

docs/source/refs/issues.rst

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -196,6 +196,30 @@ There are two workarounds:
196196
``False`` to opt out of partitioning entirely, at the cost of the per-environment
197197
culling.
198198

199+
.. _known-issues-scene-partition-count-cap:
200+
201+
Scene partitioning is capped at 15625 partitions
202+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
203+
204+
**Affects:** ``renderer=isaacsim_rtx`` with scene partitioning enabled, and ``renderer=ovrtx``.
205+
206+
The underlying ``rtx.scenedb.plugin`` allocates a fixed-size pool of scene partitions and
207+
caps it at 15625, regardless of which renderer requests them. Isaac Lab assigns one scene
208+
partition per environment when
209+
:attr:`~isaaclab_physx.renderers.IsaacRtxRendererCfg.enable_scene_partitioning` is enabled
210+
for the Isaac RTX renderer, and OVRTX always assigns one scene partition per environment, so
211+
runs with more than 15625 environments exceed the pool on either backend. Once the cap is
212+
hit, ``rtx.scenedb.plugin`` logs a warning and discards the remaining partitions:
213+
214+
.. code-block:: text
215+
216+
[Warning] [rtx.scenedb.plugin] SceneDbContext : Maximum number of scene partitions
217+
(15625) reached. Additional scene partitions will be discarded.
218+
219+
Environments beyond the cap are left without their own partition and end up sharing one
220+
with another environment, so their tiled camera views can render another environment's
221+
geometry instead of their own.
222+
199223
Using instanceable assets for markers
200224
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
201225

0 commit comments

Comments
 (0)