.. _isaac_unit_converter:

===============================
USD Unit Converter Utility
===============================


.. _isaac_unit_converter_about:

About
=================

The :ref:`isaac_unit_converter` Extension is used to convert the base units of :ref:`isaac_sim_glossary_usd` assets.
The extension scans through physics properties and scales them accordingly.
The extension can be used to update all referenced stages or make the unit conversion changes on the selected stage only.


To access this Extension, go to the top menu bar and click `Isaac Utils > USD Unit Converter`.

.. _isaac_unit_converter_user_interface:

User Interface
=================

.. figure:: /content/images/isaac_unit_converter_ui.png
    :align: center
    :alt: Unit Converter UI

Configuration Options
^^^^^^^^^^^^^^^^^^^^^^

* **Update Files/folders**: If selected, Updates selected files or all files on folder, otherwise updates currently open stage.
* **Update All Referenced Stages**: If selected Updates all USD files that are referenced by this asset, otherwise makes changes only on the selected stage
* **New Meters per Unit**: New stage unit scale from meters.
* **Process Stage(s)**: Click the button to make the changes. Stages will be automatically saved. Changes can be undone by using former scaling factor and pressing Process Again


.. _isaac_unit_converter_tutorials:

Tutorials & Examples
======================================

The following example demonstrates how to toggle the stage units between meters and millimeters:

.. figure:: /content/images/isaac_unit_converter_demo.gif
    :align: center
    :alt: Unit Converter Demonstation