.. _Simulation Data Visualizer Window:

=================================
Simulation Data Visualizer Window
=================================

Understanding how data changes overtime is important to fully analyze data and identify issues. 
By `enabling <https://docs.omniverse.nvidia.com/extensions/latest/ext_core/ext_extension-manager.html#load-an-extension>`_ the :ref:`Omni Physics UI` extension, you get access to the **Simulation Data Visualizer** window, which allows you to visualize the data by plotting graphs of a physics object's properties during simulation. 

The feature is toggled through the viewport eye menu, for example:

.. image:: images/sim_data_vis_wnd_enable.png
    :alt: Simulation Data Visualizer enable window

When enabled, a **Simulation Data Visualizer** window will appear docked in the bottom window group section.

By default, the window targets the currently selected prim or, if multiple prims are selected, the prim most recently added to the selection. However, it is possible to lock the window to a given prim by pressing the **lock** button:

.. image:: images/sim_data_vis_wnd_lock.png
    :alt: Simulation Data Visualizer lock window button

When the window is locked, it will keep targeting the same prim even as the current selection changes.

You can also create new **Simulation Data Visualizer** windows by pressing the **new** button:

.. image:: images/sim_data_vis_wnd_new.png
    :alt: Simulation Data Visualizer new window button

Combined with the ability to lock windows, this enables you to monitor several prims at the same time by having multiple **Simulation Data Visualizer** windows open.

.. note:: When creating a new window, it will automatically set the old window to the *locked* state.

Inspecting and Exporting Data
#############################

The currently active simulators determine what data is available for the target prim, and may depend on whether the simulation is running or not (in the images below, only the PhysX simulator is active and simulation is running)

The individual data entries will appear as either a single floating point value, 3D vector (with magnitude), 3D point, axis-angle rotation, boolean, integer, or a text string. If you hover the entry, a tooltip will show the documentation for it.

For entries with values in the form of floating points, 3D vectors, 3D points, and axis-angle rotations, the data will be visualized in graphs, which can be toggled by clicking the graph button next to the data entry.

.. image:: images/sim_data_vis_wnd_plot.png
    :alt: Simulation Data Visualizer Toggle Components

For the multiple component data types, you may further toggle each of the subcomponents by left-clicking their respective label button:

.. image:: images/sim_data_vis_wnd_filter.png
    :alt: Simulation Data Visualizer Toggle Components

In addition, you may also right-click a component, which will enable the display of that specific component and hide all other.

After the visualizer has plotted data in a graph, you can inspect the values at a specific data point by pressing the left mouse button while hovering it. 

.. image:: images/sim_data_vis_wnd_inspect.png
    :alt: Simulation Data Visualizer Inspect

And finally, if you right click the graph, all the samples for that plot will be copied to the clipboard in comma separated values format (CSV) that allows you to paste it into other database programs.

