create_connection#

Omniverse.create_connection(omniverse_path: str, include_camera: bool = False, normalize_geometry: bool = False, temporal: bool = False, live: bool = True, debug_filename: str = '', time_scale: float = 1.0, line_width: float = 0.0, options: dict = {}) None#

Ensure that an EnSight dsg -> omniverse server is running

Connect the current EnSight session to an Omniverse server. This is done by launching a new service that makes a dynamic scene graph connection to the EnSight session and pushes updates to the Omniverse server. The initial EnSight scene will be pushed after the connection is established.

Parameters:
omniverse_pathstr

The directory name where the USD files should be saved. For example: “C:/Users/test/OV/usdfiles”

include_camerabool

If True, apply the EnSight camera to the Omniverse scene. This option should be used if the target viewer is in AR/VR mode. Defaults to False.

normalize_geometrybool

Omniverse units are in meters. If the source dataset is not in the correct unit system or is just too large/small, this option will remap the geometry to a unit cube. Defaults to False.

temporalbool

If True, save all timesteps.

livebool

If True, one can call ‘update()’ to send updated geometry to Omniverse. If False, the Omniverse connection will push a single update and then disconnect. Defaults to True.

time_scalefloat

Multiply all EnSight time values by this factor before exporting to Omniverse. The default is 1.0.

debug_filenamestr

If the name of a file is provided, it will be used to save logging information on the connection between EnSight and Omniverse. This option is no longer supported, but the API remains for backwards compatibility.

line_widthfloat

If set, line objects will be represented as “tubes” of the size specified by this factor. The default is 0.0 and causes lines not to be exported.

optionsdict

Allows for a fallback for the grpc host/port and the security token.