10. Templates

Templates help turn data into information and automate the process of extracting information from raw simulations or experimental files. They are used in post processing to extract, transform and store all the required responses from a simulation or physical test automatically after the job is solved. Templates can extract from multiple parallel simulations and scale to thousands of simulations at the same time. Basically, they are a group of responses and transformations saved by users to reuse later for other simulations or physical tests.

With Templates, you can utilize machine data processing over manual data processing.

Manual Vs Machine Data Processing


What Will Be Covered

  • Creating and adding to a Template
  • Applying a template before a job or test is processed
  • Applying a template after a job or test is processed
  • Managing Templates

10.1. Creating a Template

You can create templates from the responses of your simulations or physical tests. You can also create a template from a file.

Create or Update From Simulation or Physical Test Responses

Go to your Simulations section or Physical Tests section to get started. From there, choose a simulation or physical test and click on its name to open it in another tab or window. We’ll be using a simulation but these same actions can be taken on a physical test.

Figure 1: Where to Access Simulations and Physical Tests


Go to your responses section at the top. Select all the required responses by clicking on the check marks on top left corner of its box.

To make a new template, click on ‘Create New Template’ under the ‘Selected’ drop-down menu.

Figure 2: Create New Template from Simulations Responses


In the create template window, give your new template a name and description, and then click “OK” to finish.

Figure 3: Create New Template


To populate an existing template, click on ‘Add to Existing Template’ under the ‘Selected’ drop-down menu.

Figure 4: Add to Existing Template from Simulation Responses


In the next window, choose which templates to populate by clicking on the select button next to its name in the Available column or choosing ‘Select All’ at the bottom. The selected templates will appear on the right column. Click “OK” to finish.

Figure 5: Add to Existing Template


Create or Upload from New Template Window

Go to your Templates section and click on the ‘New Template’ on the upper right corner to get started.

Figure 6: Create New Template


You can sift through your responses here in the first section and choose which ones to create a new template.

Figure 7: Create New Template From Responses


Click on the library section to create a template from the master list.

Figure 8: Create New Template From Library


You can also create a template from a local file in the last section. Click to add or drag-and-drop files from your machine to upload as a template.

Figure 9: Create New Template From File



10.2. Applying a Template

Templates can be applied in the configuration settings before submitting a job or test. They can also be applied after a job has been submitted or a test has been uploaded.

Condition a Template for Simulations

Conditions allow us to tell the HPC to apply a template automatically to a solving simulation. We indicate a directive for the HPC to look for in the simulation that will link it to the template.

Go to your Templates page to get started. Open the template you would like to set for your future simulation.

Figure 1: Open Template


Click over to the “Conditions” tab. Fill out the New Condition form based on your future simulation(s). The following image shows choosing “Object Name” that starts with ”occ” for Simulations that start with the name “Occ”. Click on “create” to officially add the condition to the template. You can add more or delete conditions if needed.

Adding a Condition



NEW as of January 5, 2022, there are now more options in template match_type for creating conditions.

Figure 2: Template Match_Type Options


Apply a Template With a New Physical Test

Go to your Physical Tests page to get started. Start a new Physical Test, add the Physical Test file and choose a template in the drop-down menu as shown in the picture below. Click process to finish, as usual. The Template will be applied to the Physical Test as it processes and uploads.

Figure 3: Apply a Template with New Test


Extracting Responses

Start by going to your Simulations page or Physical Tests page and open a Simulation or Physical Test. Go to the Responses tab and click on the “Extract Response” blue button at the top left.

Figure 4: Apply a Template Through Extract Responses Window


Choose the “Response Template” section at the top of the side panel and pick a template in the drop-down. Click on “Process” to finish the extraction.

Figure 5: Apply a Template Through Extract Responses Window


New responses should appear now on the response tab.

You can apply multiple templates to a simulation or physical test this way.

Learn how to compare responses in Simlytiks by checking out the Physical Tests section on Comparing Responses.


10.3. Managing Templates

Go to your Templates main page to review, organize or edit your templates. Right click on a template to perform actions on it like exporting it as a JSON or editing it. Click on a template to open it up into another tab.

Figure 1: Manage and Open Template


Once the template is open, we can delete or add more responses, as well as perform other actions on the template. Click on the menu in the top right corner to manage and view import aspects of the template. We can export template definitions under this menu.

Figure 2: Manage Template and Export Definitions


NEW as of January 12, 2022, you can create a database directly from a template under these template options.

Figure 3: Create a Database from Template


Configure Sensors

Configure the template under the template options menu. Here, you can manually edit the template or export sensors as a CSV to edit and import back again. For certain templates, we’ll need to make sure they can compute node IDs and Labels correctly. d3VIEW processes them by first looking for the label in the NODOUT, and then searches for the ID if the LABEL is not present. If both ID/LABEL are not found, d3VIEW will fail to extract the necessary data.

Figure 4: Configure Menu


Figure 5: Configure Template


Watch the following video to see how it’s done:

Configure Sensors



Extraction Order

Review your template’s extraction order under the template options menu as well.

Figure 6: Extraction Order Menu

Figure 7: Review Extraction Order


Edit Command Files

To update your templates command files, go to the “View” tab and input/change command values in the form provided.

Figure 8: Update Command File


Watch the following video to see how it’s done:

Template Views



Mapping

Under the Mapping tab in the template, use the table provided to map similar responses between physical tests and simulations, so comparison between the two is smooth.

Figure 9: Template Mapping


Assembly Builder

We can import groups in the form of LS-Prepost/Primer and associate them in templates. Do this under the Part groups tab in your template.

Figure 10: Assembly Builder


Sanitize Template Worker

If you need an efficient way to clean your template when formats may be incorrect, you can use the response template sanitize worker in Workflows. Simply import the template as the input file in the worker configuration and execute.

Figure 11: Sanitize Response Template



10.4. Pedestrian Protection Data Processing and Visualization

In this section, we’ll take a step-by-step look at Pedestrian Protection data processing and visualization using PedPro templates.

What Will Be Covered

  1. Introduction
  2. Setting up Ped Pro template in d3VIEW
  3. Using Ped Pro template
  4. Viewing Comparison in Simlytiks
  5. Reporting and Sharing

What you will need in this tutorial

  1. URL and a valid account for d3VIEW
  2. Pedestrian Protection template from d3VIEW - Pedpro.json
  3. An LS-DYNA Pedpro input file for a single or multiple impact on the hood – Pedpro.k

About Pedestrian Protection Template

Pedestrian template helps to extract head-injury-criteria (HIC) and prepare a score-card and an opportunity chart for a full-sweep of runs. This tutorial will guide you to configure a template to suite your model id/labels, select necessary conditions such that the template can be applied to your simulations, and to view the score card.

Figure 1: Model Set-up and Final Score Cards


Step 1. Setting Up Ped Pro template

For this section, we will use the Templates application and upload a PedPro template file from our local machine and review the following.

  1. Upload Template
  2. Configure IDS/Labels
  3. Specify conditions

Step 1a. Uploading the Ped Pro template

To get started using our Ped Pro Template, we’ll need to upload it onto the platform under the Templates Application. Use the application menu at the top left corner of the webpage and click on the Templates icon to navigate to the page.

Figure 2: Access Templates Page


Once in the Templates app, click on the blue New Template button at the top right corner of the page to start uploading the template.

Figure 3: Create New Template


Once the template creation window pops up, we’ll navigate to the Upload tab (1). Click-to-upload or drag-and-drop the JSON file onto the drop zone indicated by the orange dashed box (2).

Figure 4: Upload Template File


Once uploaded (1), make sure the template is highlighted in blue at the bottom of the window (2), and then press OK (3).

Figure 5: Upload Template File


We should see the upload template at the top of the Templates homepage. (Refresh the page if it’s not visible immediately). Click on the template name to open and review its contents.

Figure 6: Open Template


Step 1b. Ped Pro Responses that will be extracted

Upon opening the template, we’ll see under the Responses Tab all the data outputs that will be extracted from our simulation when applying this template.

Figure 7: Pedestrian Protection Template


Step 1c: Configuring IDs/Labels for head-CG

The head C.G nodal displacement, velocity and, accelerations used to compute the score-card are based on the *DATABASE_HISTORY_NODE id and labels. The default node label and id is ‘Head_CG’ and ‘8000010’ as shown below. Based on the model, the label or the id can be used to suit your model. d3VIEW processes them by first looking for the label in the NODOUT, and if the LABEL is not present, the ID is searched for. If both ID/LABEL are not found, d3VIEW will fail to extract the necessary head-acceleration.

Figure 8: Head C.G Nodal Displacement


In this step, you can choose Configure to customize the NODE ID/LABEL to suite you model. Once this option is clicked, you will be directed to a table that allows you to view and edit your model specific ids/labels. Under the hamburger menu in the opened Template, click on Configure to get started.

Figure 9: Configure Template


Our table will be shown towards the bottom of the newly opened window. We can edit the IDs manually by first clicking Export Sensors File.

Figure 10: Export Sensors File


We’ll go back to our Configure Template window and upload the updated file by choosing the Import Sensors File option. The ID should update on the table. Finish by clicking Apply.

Figure 11: Import Sensors File


Step 1d. Add Template Condition for Simulation application

Let’s go to the Conditions tab in our Template so it can automatically be applied to specified Simulations. Conditions allow us to tell the HPC to apply a template automatically to a solving simulation. We indicate a directive for the HPC to look for in the simulation that will link it to the template. This template has a condition to look for “Ped” in the simulation name. Feel free to edit or add any conditions. To learn how to add a condition navigate to this section.

Figure 12 Example Submit Command: With the above condition, the following simulation named ‘pedpro.k’ will use the Pedpro template since the simulation name contains is ‘ped’: Submit –i pedpro.k –d3pub y


Step 2. Using Ped Pro Template

Once our template has been configured, we can now submit our simulation for comparing our template responses. Check out this section to learn how to submit a simulation.

Once our simulation is solved (click here to see how to preview data while it’s solving), we’ll navigate to the Simulations application page to compare our responses and visualize them in Simlytiks.

Figure 13: Navigate to Simulations


Step 2a. Choose Simulation and Compare

Select the simulations we want to compare (1), then right-click to choose Compare Responses (2).

Figure 14: Choose Simulations and Compare Responses


Step 2b. Choose Simulation and Compare

Select the template that has been applied or needs to be applied to the simulation (1), then click Compare (2).

Figure 15: Choose Template and Compare


Step 3. Viewing Comparison in Simlytiks

Here are some visualizations we’ll see in Simlytiks using the PedPro template.







Step 4. Exporting and Sharing Comparison

Easily export the visualizations as a PowerPoint (1) file in the Export menu. Or, share a public web link of the entire exploration with no data-transfer with anyone by clicking on the blue Share button (2).

Figure 16: Export and Share



10.5. IIHS Small Offset Rigid Barrier Data Processing and Visualization

In this section, we’ll take a step-by-step look at IIHS Small offset rigid barrier data processing and visualization using IIHS SORB templates.

What Will Be Covered

  1. Introduction
  2. Setting up IIHS SORB template in d3VIEW
  3. Using IIHS SORB template
  4. Viewing Comparison in Simlytiks
  5. Reporting and Sharing

What you will need in this tutorial

  1. URL and a valid account for d3VIEW
  2. IIHS Small Offset Rigid Barrier template from d3VIEW
  3. An LS-DYNA IIHS SORB input file

About IIHS Small Offset Rigid Barrier Template

d3VIEW’s IIHS SORB standard template helps to extract the intrusions from all the important structural points according to the IIHS Test protocols and prepare the IIHS intrusion chart. This tutorial will guide you to configure a template to suite your model id/labels, select necessary conditions such that the template can be applied to your simulations, and to view the intrusion chart.

Figure 1: Model Set-up and Final Intrusions Charts


Simulation Post-processing Workflow

The follow image illustrates the workflow in d3VIEW for IIHS small offset rigid barrier data post-processing:

Figure 2: Simulation Post-processing Workflow


To learn how to submit a job, follow this link. To learn how to submit a job with a simulation preview, follow this link.

Step 1. Setting Up IIHS SORB template

For this section, we will use the Templates application and upload a IIHS SORB template file from our local machine and review the following.

  1. Upload Template
  2. Configure IDS/Labels
  3. Specify conditions

Step 1a. Uploading the IIHS SORB template

To get started using our IIHS SORB Template, we’ll need to upload it onto the platform under the Templates Application. Use the application menu at the top left corner of the webpage and click on the Templates icon to navigate to the page.

Figure 3: Access Templates Page


Once in the Templates app, click on the blue New Template button at the top right corner of the page to start uploading the template.

Figure 4: Create New Template


Once the template creation window pops up, we’ll navigate to the Upload tab (1). Click-to-upload or drag-and-drop the JSON file onto the drop zone indicated by the orange dashed box (2).

Figure 5: Upload Template File


Once uploaded (1), make sure the template is highlighted in blue at the bottom of the window (2), and then press OK (3).

Figure 6: Upload Template File


We should see the upload template at the top of the Templates homepage. (Refresh the page if it’s not visible immediately). Click on the template name to open and review its contents.

Figure 7: Open Template


Step 1b. IIHS SORB Responses that will be extracted

Upon opening the template, we’ll see under the Responses Tab all the data outputs that will be extracted from our simulation when applying this template.

Figure 8: IIHS SORB Template Responses


Step 1c: Configuring IDs/Labels for Sensors

d3VIEW’s IIHS SORB template extract and plot intrusions of the target locations by using the sensors defined as *DATABASE_HISTORY_NODE_ID in the model. In order to extract all the intrusions, the model must have all the sensors defined at all the appropriate target locations as shown in the screenshot below. d3VIEW will use the label in the NODOUT, and if the label is not present, then it will search for the ID. If both ID/LABEL are not found, then d3VIEW will fail to extract the intrusions.

Figure 9: Sensor Point Locations for Measuring Vehicle Intrusion


In this step, you can choose Configure to customize NODE IDs/LABELs to suite you model. Once this option is clicked, you will be directed to a table that allows you to view and edit your model specific ids/labels. Under the hamburger menu in the opened Template, click on Configure to get started.

Figure 10: Configure Template


Our table will be shown towards the bottom of the newly opened window. We can edit the IDs manually by first clicking Export Sensors File.

Figure 11: Export Sensors File


We’ll go back to our Configure Template window and upload the updated file by choosing the Import Sensors File option. The ID should update on the table. Finish by clicking Apply.

Figure 12: Import Sensors File


Step 1d. Add Template Condition for Simulation application

Let’s go to the Conditions tab in our Template so it can automatically be applied to specified Simulations. Conditions allow us to tell the HPC to apply a template automatically to a solving simulation. We indicate a directive for the HPC to look for in the simulation that will link it to the template. This template has a condition to look for “SORB” in the simulation name. Feel free to edit or add any conditions. To learn how to add a condition navigate to this section.

Figure 13 Example Submit Command: With the above condition, the following simulation named ‘IIHS_SORB.k’ will use the SORB template since the simulation name contains is ‘SORB’


Step 2. Using IIHS SORB Template

Once our template has been configured, we can now submit our simulation for comparing our template responses. Check out this section to learn how to submit a simulation.

Once our simulation is solved (click here to see how to preview data while it’s solving), we’ll navigate to the Simulations application page to compare our responses and visualizer them in Simlytiks.

Figure 12: Navigate to Simulations


Step 2a. Choose Simulation and Compare

Select the simulations we want to compare (1), then right-click to choose Compare Responses (2).

Figure 15: Choose Simulations and Compare Responses


Step 2b. Choose Simulation and Compare

Select the template that has been applied or needs to be applied to the simulation (1), then click Compare (2).

Figure 16: Choose Template and Compare


Step 3. Viewing Comparison in Simlytiks

Here are some visualizations we’ll see in Simlytiks using the IIHS SORB template.








Step 4. Exporting and Sharing Comparison

Easily export the visualizations as a PowerPoint (1) file in the Export menu. Or, share a public web link of the entire exploration with no data-transfer with anyone by clicking on the blue Share button (2).

Figure 17: Export and Share



10.6. Duplicate template

New option is available to add prefix or postfix to Responses while duplicating a template in Templates page.



For additional questions about how to navigate the d3VIEW platform, please feel free to email our team at: support@d3view.com.