nVIZ Ergonomics Plugin Version 2020.1

Documentation for other Versions


Autodesk VRED provides two paths for maintaining plugins. Please identify the directory where you want to keep the nVIZ Ergonomics Plugin. The paths are displayed in the VRED terminal window after launching VRED:

Download and execute the nVIZ Ergonomics Plugin installer. After the installer has completed, you need to copy the two following files to your VRED plugins directory:

License File and Config File

The plugin supports the import of ergonomics data from an Excel file. The definition of which data to read from the Excel file is defined in the config file. nVIZ will provide you with a custom Excel file parser and with a config file to meet the specific ergonomics process in your organization. Please contact nVIZ to receive your license file and config file.

The license and config files need to be copied to the directory:

After installation, the nVIZ Ergonomics Plugin can be launched from the context menu like any other VRED module – right mouse click on the Main Tool Bar or on the Quick Access Bar:

Ergonomics Review Preparation

Scene Graph Nodes

For the full functionality of the Ergonomics Plugin to be available for both the HTC and the ART tracking systems, also in combination with the nVIZ Motion Plugin for driving simulation, we require a special scene graph structure at the top level nodes as depicted below:

The naming of the nodes is arbitrary but they must be correctly referenced in the vehicle rig tab (see below “Vehicle Rig”) and the nodes need to be correctly referenced in the VRPN Tracking module (see below “Tracking System ART”) . Also, the structure, i.e., the parent-child relations and the order are mandatory.

Tracking System HTC

The Ergonomics Plugin supports both the tracking system from HTC (OpenVR) for ergonomics reviews with the HTC Vive as well as the tracking system from ART for ergonomics reviews in a CAVE.

Ergonomics reviews with the HTC Vive require an extra HTC tracker to be positioned in the z-coordinate of the seat reference point. The “Reset HMD Pose” function (see “Ergonomics Review” below) will position the driver’s view in the scene at the x, y coordinates of the seat reference point and the z coordinate calculated from the vertical distance between the HMD and the tracker. The orientation will be aligned to the longitudinal vehicle axis.

Tracking System ART

Ergonomics reviews with the ART tracking system in a CAVE rely on the tracking of the seating buck by a VRED cart node. The imported ergonomics data needs to include the correct offsets for the seating buck targets.

The VRED scene graph nodes (see “Scene Graph Nodes” above) need to be correctly referenced to ART sensors in the VRPN Tracking module as depicted below. The “ViewPoint” node needs to be attached to the same sensor as the “Glasses” and the “SeatBuck” node needs to be attached to the same sensor as the “SeatReferencePoint”.

Ergonomics Review

Ergonomics Project

All the settings defined in an Ergonomics review can be saved to a project file and reloaded from there. The file format is *.egb

Ergonomics Data Import

The starting point for an ergonomics review is the import of the ergonomics data stored in an Excel file. Typically this data includes the seat references points of multiple vehicles as well as seating buck dimensions, view point coordinates, seat and steering wheel adjustment ranges etc.

The results of the data import is displayed in a Windows terminal window. Additionally the results are written to a log file in the same directory as the imported Excel file:

After successful data import, the combo boxes and the list fields on the different tabs of the plugin will be filled in.

The color of the “Check Active Vehicle” button indicates the completeness and consistency of the imported data per selected vehicle.

Tracking System

Make sure that you have selected the correct tracking system.

The tracking data is recorded from the sensors and will be shown in the LCD displays if the “Display Listener” is checked.

Seating Position and View Point Simulation

The Ergonomics Plugin simulates different seating positions in the virtual scene based on the imported seat reference point coordinates as well as different view points based on the view point coordinates.

Seat, Steering, etc. Adjustments

The Ergonomics Plugin simulates the adjustment of the vehicle items relevant for ergonomics (seat, steering column and mirrors) within the defined ranges and based on the defined pivot points (see below “Adjustment Items”).

Ergonomics Data

Seat Reference Points

The imported seat reference points per vehicle are listed in the list field.

View Points

The imported view points (95th percentile male, 5th percentile female etc.) per vehicle are listed in the list field.

Vehicle Position

The imported vehicle positions per vehicle are listed in the list field.

Vehicle Rig

The imported vehicle rig per vehicle is listed in the list field. At import of the Excel file with the ergonomics data, the plugin will check for vehicle rig files <name>.txt in the directory:

If a text file with a name identical to the vehicle name from the Excel sheet is found, the rig file will be imported for that vehicle. Otherwise, the default vehicle rig file will be imported from the directory:

After import, the plugin will search for the node paths specified in the rig file and indicated found or missing node paths in color.

Adjustment Items

The adjustment item ranges and pivots are listed in the two list fields.