Skip to main content

Unsupported Scene Size

Error code: UNSUPPORTED_SCENE_SIZE

"It looks like the scene in your USD file is either too large or too small. For reference, all of the geometry in the scene needs to be larger than 1 cubic cm and smaller than 100 cubic km. Please also verify that your file is using the correct units."


What This Means

The bounding box of your scene's geometry falls outside the range Miris supports. This is most often caused by incorrect unit settings on export rather than geometry that is genuinely too large or too small.

Supported size range: the scene's bounding box must be larger than a 1×1×1 cm cube and smaller than a 100×100×100 km cube.

Common Causes

Too small:

  • Incorrect unit scale (most common): Miris requires metersPerUnit = 1, meaning 1 USD unit must equal 1 meter. Maya and Houdini both default to centimeters (metersPerUnit = 0.01), so a model exported with default settings will appear 100× smaller than intended — falling below the minimum size threshold. The fix is to rescale the geometry to meters before exporting, not just change the metadata value.
  • The model represents a very small real-world object (e.g., jewelry, small electronic components) and its real-world dimensions genuinely fall below the minimum — if so, check whether your asset is a good fit for Miris
  • The model was exported at an unintended scale, resulting in geometry that is effectively near-zero in size

Too large:

  • The scene contains geometry imported from raw survey, LiDAR, or GIS data that was never scaled down to a human-scale scene
  • The unit scale is inverted — for example, a Blender scene authored in meters was incorrectly exported with metersPerUnit = 0.01, making Miris interpret every meter as 100 meters

How to Fix It

  1. Rescale your geometry to meters in your DCC tool. If your scene is currently in centimeters, scale all geometry up by 100×, or change your DCC's scene unit to meters and re-export. Simply changing the metersPerUnit value in the file without rescaling the geometry will not fix the problem — the numbers describing your geometry need to actually represent meter-scale distances.
  2. Export with metersPerUnit = 1 — confirm this value appears at the top of your exported .usda file in a text editor
  3. Re-upload the corrected asset
DCC export defaults and how to change them

Maya and Houdini default to centimeters; Blender defaults to meters. Here's how to export at meter scale from each:

  • Maya: Set your scene units to Meters before exporting (Windows → Settings/Preferences → Preferences → Settings → Working Units), or scale your geometry by 0.01 in the USD Export options
  • Houdini: In the USD ROP, set Meters Per Unit to 1
  • Blender: Blender's default is already meters — confirm Scene → Unit Scale is set to 1.0 before exporting

Still seeing this error after following the steps above? Contact support with your asset name and a description of what you've tried.