SimVT REPORTER Templates

As well as using SimVT to perform the correlation interactively in T/HIS, SimVT can be used in REPORTER to automatically generate reports of the channel correlations for the supported protocols. The v21.1 bundle includes the following SimVT REPORTER templates:

Template Name	$TEMPLATE_FILE (for Batch command)
Euro NCAP Virtual Far Side 2024 VC1 (ISO Scores)	EuroNCAP_Virtual_Far_Side_2024_VC1_ISO_Scores.ort
C-NCAP Far Side Protocol 2024 Working Conditions 1-6 SimVT	CNCAP_Far_Side_Protocol_2024_WorkingConditions1to6_SimVT.ort
C-NCAP Far Side Protocol 2024 Working Conditions 7-8 SimVT	CNCAP_Far_Side_Protocol_2024_WorkingConditions7to8_SimVT.ort
C-NCAP Far Side Protocol 2024 Virtual Assessment Certificate (WSID Driver, WSID Passenger)	CNCAP_Far_Side_Protocol_2024_VirtualAssessmentCertificate_WSID_Driver_WSID_Passenger.ort
C-NCAP Far Side Protocol 2024 Virtual Assessment Certificate (WSID Driver, ES-2re Passenger)	CNCAP_Far_Side_Protocol_2024_VirtualAssessmentCertificate_WSID_Driver_ES2re_Passenger.ort

All the templates work in the same way and they can be run both interactively and in batch mode.

If the template is successfully generated it will show a report summarising the the sensor scores for all the mandatory and monitored channels as well as the correlation graphs for each channel so that you can inspect any channels which perform poorly. Additionally, a SimVT settings file (REPORTER_settings.simvt) is created which can be loaded in to the SimVT workflow tool to interrogate the results interactively.

Note: If you intend to use the template with Ansys LS-DYNA results then you should already have defined the occupant and structures user data required for your model in PRIMER (see Automotive Assessments PRIMER for details).

Running the template interactively

In REPORTER, click the Automotive tab and then filter by SimVT (under Workflows) to locate the template you wish to run. Double-click on the template thumbnail to open it (alternatively click on it to select it then click on OK).

T/HIS will launch straight away and an input window will appear:

For convenience, and flexibility, there are three approaches to populating the REPORTER Inputs window:

Using a SimVT settings file
Using a SimVT settings file but overriding one or more of the "Simulation", "Test" and "Output Directory" inputs
Selecting the "Simulation", "Test" and "Output Directory" inputs without using a SimVT settings file

There are a number of advantages to using a SimVT file. For example, the inputs are populated automatically which can save you time trying to locate the relevant "Simulation" and "Test" data files. Additionally, channel matching rules and corrective operations can be defined in the settings file which unlocks more advanced capabilities of SimVT. However, it is still possible to use the templates without the need to create a SimVT settings file.

1. Using a SimVT settings file

This option is the simplest option if you already have created a SimVT settings file (*.simvt) which references the simulation and test data sources that you want to generate a report for.

Use the file explorer icon on the first row to select the desired SimVT settings file.
If the SimVT settings file is valid it will automatically populate the "Simulation", "Test" and "Output directory" path rows. If it is not valid or any of the paths are red then follow the steps below to override blank/invalid inputs.
Click Run to generate the report.

2. Using a SimVT settings file but overriding one or more of the "Simulation", "Test" and "Output Directory" inputs

When selecting a valid SimVT settings file the "Simulation", "Test" and "Output directory" path rows will automatically be populated. However, you may wish to repurpose an existing SimVT settings file for a different source of simulation and/or test data. This is similar tomapping to new data when loading a SimVT settings file when running SimVT in T/HIS interactively. For example, you may have a SimVT settings file which defines the channel matching rules and corrective operations to correlate LS_DYNA_SIM_1.d3thdt vs. ISO_MME_TEST.chn, but you want to correlate LS_DYNA_SIM_2.d3thdt vs. ISO_MME_TEST.chn so you could load the SimVT settings file in (which would populate the "Simulation" row with LS_DYNA_SIM_1.d3thdt and the "Test" row with ISO_MME_TEST.chn) then you can change the "Simulation" path to LS_DYNA_SIM_2.d3thdt so that it will be used instead.

Use the file explorer icon on the first row to select the desired SimVT settings file.
If the SimVT settings file is valid it will automatically populate the "Simulation", "Test" and "Output directory" path rows.
Use the file selectors at the end of each row which you want to override the path for (or type or paste the path in to the textbox)
Click Run to generate the report.

3. Selecting the "Simulation", "Test" and "Output Directory" inputs without using a SimVT settings file

This option is useful if you do not have a valid SimVT settings file but you still want to be able to generate the REPORT.

Use the "Simulation" file selector to select the simulation data source (e.g. files ending with d3thdt, .thf, binout0000, .csv, .mme, .chn, .mmi, .iso)
Use the "Test" file selector to select the test data source (e.g. files ending with d3thdt, .thf, binout0000, .csv, .mme, .chn, .mmi, .iso)
Use the "Output directory" file selector to choose the directory where the results will be saved.
Click Run to generate the report.

Note that a SimVT settings file (REPORTER_settings.simvt) is created in the "Output directory" which can be used to regenerate the report as well as loading it in to the SimVT workflow tool to interrogate the results interactively. You can then define any channel matching rules and corrective operations in T/HIS before saving a new SimVT settings file which can be used to regenerating the report.

REPORTER Results

All the SimVT REPORTER templates have the same basic format.

The first page contains a summary of the sensor score results and the PASS/FAIL status of the protocol validation criteria. The layout and contents of the summary page vary from template to template.
After the summary page there may be some extra pages for protocol specific content. For example, the "Euro NCAP Virtual Far Side 2024 VC1 (ISO Scores)" template has a page dedicated to the simulation duration and head excursion check
After any extra protocol specific pages, the report contains sensor correlation pages (one for each mandatory and sensor) which contain a table of results and images of the corridor graphs for each channel which makes up the sensor. Note that sensors can be either a single channel (1D) or the weighted combination of 2 or 3 channels (e.g. X, Y and Z components).
At the end of the report, all the results are summarised in a detailed results table. The table may continue over multiple pages if they do not all fit on a single page

Missing Data

If all the channel data required to calculate a given Sensor Score is found, then that Sensor Score will be displayed on the summary table (page 1) and the cell will be coloured to indicate the PASS/FAIL status. Monitored sensors are shown in lighter colours as their status does not impact the overall validation criteria PASS/FAIL status. If channel data required to perform a correlation is missing then the corresponding results will be shown as "Missing". The different cell colours and their corresponding status are shown in the table below.

Cell Colour	Status
	Mandatory sensor failed
	Monitored sensor failed
	Mandatory sensor passed
	Monitored sensor passed
	Missing data to calculate sensor score

If any of the mandatory sensors fail to pass the validation criteria then the overall result will be FAIL. Otherwise the overall result will be a PASS (regardless of the status on monitored sensors) unless any of the mandatory sensors have missing data, in which case the validation criteria result will show "Missing".

Running the template in Batch

The templates can also be run in batch mode, specifying the required information through command line arguments.

If you want to use the simulation and test data specified by the SimVT settings file then you only need to specify the output directory and SimVT settings file file on the command line:

<reporter_exe> -batch -file=<template_file> -varOUTPUT_DIR=<output_directory> -varSIMVT_SETTINGS_FILE=<simvt_settings_file> -exit

[Add the -pdf, -html, -pptx command line arguments to write the report out in the format you want]

Where:

reporter_exe	The full path and filename to the REPORTER executable
template_file	The full path of the template file e.g. $OA_WORKFLOW/templates/simvt/$TEMPLATE_FILENAME Note that $OA_WORKFLOW should be substituted with the full path to your workflows 22.1 directory. Note $OA_WORKFLOW is set using the workflow_definitions_directory preference Note that $TEMPLATE_FILENAME should be substituted with the filename of the template you wish to use. The template names and the corresponding filenames are listed in this table.
output_directory	The directory where the correlation graphs images, results.csv and REPORTER_settings.simvt are written to (it must exist and you must have write permissions).
settings_file	The full path and filename of the SimVT settings file. The SimVT settings file argument is optional, but if it is provided it will be used to configure the channel matching rules, corrective operations and correlation method* used. *Note that the Euro NCAP protocol mandates that the default ISO/TS 18571:2024 protocol is used for correlations.

reporter_exe

The full path and filename to the REPORTER executable

template_file

The full path of the template file e.g.

$OA_WORKFLOW/templates/simvt/$TEMPLATE_FILENAME

Note that $OA_WORKFLOW should be substituted with the full path to your workflows 22.1 directory. Note $OA_WORKFLOW is set using the workflow_definitions_directory preference

Note that $TEMPLATE_FILENAME should be substituted with the filename of the template you wish to use. The template names and the corresponding filenames are listed in this table.

output_directory

The directory where the correlation graphs images, results.csv and REPORTER_settings.simvt are written to (it must exist and you must have write permissions).

settings_file

The full path and filename of the SimVT settings file. The SimVT settings file argument is optional, but if it is provided it will be used to configure the channel matching rules, corrective operations and correlation method* used.

*Note that the Euro NCAP protocol mandates that the default ISO/TS 18571:2024 protocol is used for correlations.

If you want to override the simulation and test data specified by the SimVT settings file then you only need to specify the extra arguments, varSIMULATION_DATA_PATH and varTEST_DATA_PATH respectively:

<reporter_exe> -batch -file=<template_file> -varOUTPUT_DIR=<output_directory> -varSIMVT_SETTINGS_FILE=<simvt_settings_file> -varSIMULATION_DATA_PATH=<simulation_file> -varTEST_DATA_PATH=<test_file> -exit

Where:

simulation_file	The full path and filename of the simulation data source. This is optional if -varSIMVT_SETTINGS_FILE is defined, but it can be used to override the simulation data source specified in the SimVT settings file.
test_file	The full path and filename of the test data source. This is optional if -varSIMVT_SETTINGS_FILE is defined, but it can be used to override the simulation data source specified in the SimVT settings file.

If you do not want to use a SimVT settings file you can remove -varSIMVT_SETTINGS_FILE provided that both varSIMULATION_DATA_PATH and varTEST_DATA_PATH are defined:

<reporter_exe> -batch -file=<template_file> -varOUTPUT_DIR=<output_directory> -varSIMULATION_DATA_PATH=<simulation_file> -varTEST_DATA_PATH=<test_file> -exit

Previous | Next