Cancel
Showing results for 
Search instead for 
Did you mean: 

Compare Runs in LMS Test.Lab

Siemens Experimenter Siemens Experimenter
Siemens Experimenter

(view in My Videos)

 

Compare Runs

 

Want to compare data from different runs quickly in LMS Test.Lab?

 

Want to calculate the average, standard deviation, or envelope of these runs?

 

It is all possible using the Run Data Averaging and Comparison Organizer in LMS Test.Lab!

 

The Run Data Averaging and Comparison Organizer (hereby referred to as Compare Runs) add-in in LMS Test.Lab is an excellent way to average and compare runs both online in the Measure workbook and off-line in the Compare Runs workbook.

 

Getting Started

 

Begin by going to Tools / Add-ins…

 

Figure 1: Go to Tools/Add-ins…Figure 1: Go to Tools/Add-ins…

Select “Run Data Averaging & Comparison Organizer”.

 

Figure 2: The “Add-ins” window.Figure 2: The “Add-ins” window.

The add-in includes both online and offline functionality.

 

In either case, five averaging functions are added.

 

Figure 3: Definitions of the five functions.Figure 3: Definitions of the five functions.

This article is composed of two sections. The first section will cover the online functionality of Compare Runs. The second section will cover the offline functionality of Compare Runs.

 

SECTION 1: ONLINE RUN COMPARISON

 

After activating the Compare Runs add-in five averaging functions are added to the Measure workbook.

 

Figure 4: The Measure workbook before and after the Compare Runs add-in is activated.Figure 4: The Measure workbook before and after the Compare Runs add-in is activated.

Compare Runs will also add information into the Data Explorer. Any 2D function that can be averaged will appear under the Compare Runs folder.

 

Figure 5: Explore the Compare Runs folder in Data Explorer to see what functions you can compare across runs.Figure 5: Explore the Compare Runs folder in Data Explorer to see what functions you can compare across runs.

Online Run Comparison Example

 

For this example, three runs were acquired.

 

Each run consisted of a single tone.

  • Run 1 was a tone of 1000Hz.
  • Run 2 was a tone of 1500Hz.
  • Run 3 was a tone of 2000Hz.

Each run was acquired using a stationary acquisition consisting of 13 averages over 3 seconds.

 

1. To begin, drop data into the display from the Compare Runs folder. In this case, a stationary autopower acquisition was done. So, there is an “AutoPower Mic” selection available. Drag from the LEFT pane into the display.

 

Figure 6: Any 2D functions will be available under the Compare Runs folder.Figure 6: Any 2D functions will be available under the Compare Runs folder.

 

2. Next, select which averaging functions to display in the Measure workbook. For this example, the average function is displayed. Users can display any combination of the Compare Runs functions by toggling on or off the function buttons on the upper right of the plot display area.

 

Figure 7: Five functions are available with the Compare Runs add-in.Figure 7: Five functions are available with the Compare Runs add-in.

 

3. Under the “More…” button, there are three online averaging display options. For this example, “All runs” is selected.

 

Figure 8: Select which runs to display under the “More…” button.Figure 8: Select which runs to display under the “More…” button.

A. “No run display” will not display any of the runs as they populate. The averaging functions selected will

 

B. “Last run only” will display only the most recently acquired run in addition to the averaging functions selected.

 

C. “All runs” will display all acquired runs in addition to the averaging functions selected.

 

 

4. The result after Run 1 (a tone at 1000Hz) is shown below. Run 1 is displayed in red. The average of all runs is displayed in black. In this case, the two curves are the same, so they overlap completely.

 

Figure 9: The first run and average of all runs are displayed. After only one run these values are the same.Figure 9: The first run and average of all runs are displayed. After only one run these values are the same.

5. The result after Run 2 (a tone at 1500Hz) is shown below. Run 1 remains displayed in red because the online averaging run display mode is set to “All runs”. As each run is acquired, the run will populate and remain as the additional runs are acquired. Run 2 is displayed in purple. The average of the two runs is displayed in black.

 

Figure 10: The display mode is set to “All runs”; the runs populate over one another and remain in the display.Figure 10: The display mode is set to “All runs”; the runs populate over one another and remain in the display.

6. The third and final run is then acquired (a tone at 2000Hz). Run 3 is displayed in green. The original two runs remain in the display and the average function updates to include the third run.

 

Figure 11: The runs continue to populate in the display and the average function updates appropriately.Figure 11: The runs continue to populate in the display and the average function updates appropriately.

7. When finished acquiring data, go to the “Compare Runs” workbook. Here is where you will save the averaging functions across your runs. 1) Select which averaging functions you would like to be save by toggling the function buttons. 2) Press “Save…”

 

Figure 12: The Compare Runs workbook.Figure 12: The Compare Runs workbook.

8. Users can either save just the selected functions or save all the functions. Name the folder then click OK to save.

 

Figure 13: Save the functions.Figure 13: Save the functions.

9. The functions will be saved to the folder in the Navigator workbook. In this case, just the average function was saved. Browse to the data block and display it.

 

Figure 14: Just the average function was saved.Figure 14: Just the average function was saved.

10. If instead save “All functions” was selected, the function tree in the Navigator would look like below.

 

Figure 15: All functions are saved.Figure 15: All functions are saved.

Online run comparison is a great tool to instantly check your run data average!

 

SECTION 2: OFFLINE RUN COMPARISON

 

It is possible to compare runs offline. These runs can come from any project or section.

 

In the offline mode, analysis begins in the Compare Runs tab.

 

Figure 16: Compare Runs tab.Figure 16: Compare Runs tab.

The Compare Runs workbook has four main panes. 

 

Figure 17: Compare Runs workbook.Figure 17: Compare Runs workbook.

  1. Data Source Selection: import run data from the input basket or the active project.
  2. Run Selection: choose which runs to display and which runs to include in the averaging functions.
  3. Function Selection: a matrix of each Point ID and calculated function. From this matrix, choose what will be displayed the display pane.
  4. Display area: data plotted in this area is selected from the function and point matrix (area 3).

Data Source Selection

 

It is possible to import runs via the input basket or from the active project. Use the radio buttons to determine what the data source is.

 

Figure 18: Select to import from the Input Basket or Active project.Figure 18: Select to import from the Input Basket or Active project.

Once the data is imported, the Run Selection and Function Selection areas will populate.

 

Figure 19: The Run Selection and Function Selection areas are populated once the data is imported.Figure 19: The Run Selection and Function Selection areas are populated once the data is imported.

Run Selection

 

In the Run Selection area, there are two columns of checkboxes on the far right (see Figure 20).

  • The display column determines whether or not the run data is displayed in the display area on the right side of the screen (area 4).
  • The averaging column determines whether or not the run data is included in the averaging functions that are calculated.

It is important to note that a function may be included in the average even if it is not displayed. It is wise to inspect which of these boxes are checked before saving your averaged run data.

 

 Figure 20: The Display and Averaging columns determine which runs are displayed and which runs are used to calculate the averaging functions.Figure 20: The Display and Averaging columns determine which runs are displayed and which runs are used to calculate the averaging functions.

Function Selection

 

There are three different ways to display the functions: Point by Point, Function by Function, or User Defined Layout. To choose a display type, click either P,F, OR U in the lower right corner of the Function Selection area.

 

Figure 21: P: Point by Point. F: Function by Function. U: User Defined Layout.Figure 21: P: Point by Point. F: Function by Function. U: User Defined Layout.

  • Point by Point
    • Allows the user to display multiple functions calculated from the same Point ID.
    • Figure 22: Multiple functions are displaying of the same Point ID.Figure 22: Multiple functions are displaying of the same Point ID.
  • Function by Function
    • Allows the user to display one function across multiple Point IDs.
    • Figure 23: Multiple Point IDs are displaying for the same function.Figure 23: Multiple Point IDs are displaying for the same function.
  • User Defined Layout
    • The user defined layout allows the user to choose a custom mix of Point IDs and functions from the available options.
    • Figure 24: A user-defined mix is selected.Figure 24: A user-defined mix is selected.

NOTE:

 

In the user defined layout mode, there is one extra step to be aware of.

 

If a multi-plot display is opened, the number of plots in the display will correspond to the number of buttons that become sensitive to the left of the P, F, and U.

 

Figure 26: The user defined mode. Here the third graph is selected.  The dotted line around the third plot indicates it is the active plot.Figure 26: The user defined mode. Here the third graph is selected. The dotted line around the third plot indicates it is the active plot.

To select which functions to display, toggle the boxes in the upper right corner of the Function Selection area. The functions are defined at the top of the article in Figure 3.

 

Figure 27: The averaging functions are in the top right corner.Figure 27: The averaging functions are in the top right corner.

To control how many points/ functions are displayed, click on “Options…” in the Function Selection area.

 

Adjust the numbers for “Functions per display” and “Points per display”.

 

Figure 28: The Options window in Compare Runs.Figure 28: The Options window in Compare Runs.

Saving Average Run Data

 

Finally, save your data. Choose where to save your data, which functions to save, and what to call your new folder. 

 

Figure 29: The Save window in Compare Runs.Figure 29: The Save window in Compare Runs.

Enjoy the power of the Compare Runs workbook!

 

Questions? Contact us!

 

Related Processing links:

LMS Test.Lab Acquisition Tips:

LMS Test.Lab Display Tips:

Contributors