Replicator Troubleshooting#

This page consolidates troubleshooting information for Replicator components in Isaac Sim.

Replicator Rendering Issues#

If there is unwanted noise in simulated depth images, disable anti-aliasing under the Render Settings > Ray Tracing > Anti-Aliasing tab by setting the Algorithm to None.

If randomized materials are not loaded on time for synthetic data generation, the rt_subframes must be set to be at least 2.

The replicator Scatter3D OmniGraph node breaks physics when called on a stage using world. Avoid using these together or use alternative methods for object placement.

Replicator Data Storage Issues#

Using Replicator to write to S3 buckets with the built-in backend in Windows may require setting the credentials in the environment variables instead of the AWS config files. This is because of a possible path parsing error in boto3 on Windows.

When working with large datasets or high-resolution images, you may experience storage bottlenecks. Consider: 1. Using a faster storage device 2. Reducing the image resolution or compression level 3. Using batch processing with smaller batches

Replicator Layers and Randomization#

Using replicator’s rep.new_layer() functionality, which creates a new layer in which to place and randomize assets, may lead to issues in simulation scenarios where these assets are used. In such cases the use of rep.new_layer() can be omitted.

When using multiple randomizers, be aware that they may conflict with each other. Test your randomization settings carefully to ensure they produce the expected results.

Replicator Performance Issues#

For complex scenes with many objects and randomizers, you may experience performance issues. Consider: 1. Reducing the number of objects in the scene 2. Simplifying the randomization parameters 3. Using fewer sensors or lower resolution sensors 4. Running with headless mode for improved performance during data generation

Replicator API Changes#

If you are encountering any issues regarding the dependencies on omni.replicator.character or omni.replicator.agent, the extension is now renamed to isaacsim.replicator.agent. Revise your code accordingly.

Getting Started Scripts Issues#

Common issues and solutions for the Getting Started Scripts:

  1. Data not being captured - Ensure the capture-on-play flag is properly set - Check if the render products are correctly attached to writers - Verify the output directory has write permissions

  2. Rendering artifacts - Try increasing RTSubframes value - Check if materials are fully loaded before capture - Ensure proper lighting setup

  3. Performance issues - Reduce resolution or number of cameras - Use headless mode for faster processing - Optimize scene complexity

  4. Memory issues - Reduce batch size - Clear unused resources with destroy() - Monitor GPU memory usage