NI DIAdem Tutorial

Overview

NI DIAdem is a comprehensive software application designed to import, organize, and both visually and numerically analyze measurement data.   It is a complete solution for the management of Big Data.

DIAdem DataPlugin technology allows you to directly import raw data files from over 200 data acquisition / data logger file formats.   Additionally, it allows you to create a custom DataPlugin to import text/CSV based files via a simple to use Wizard.   An advanced DIAdem user may also create a new DataPlugin to read any binary file format where the structure of the file is known.  

Measurement data sizes can get large, and consist of many individual files.   In some data acquisition scenarios, you may have data recorded by different data acquisition devices and/or data loggers during the same session, or between current and earlier activities.   The best way to manage this Big Data is to import it, convert it to a consistent data model, and then save it to a binary file.  

NI provides an open format binary file that provides superior performance and flexibility for the storage of measurement data.   Converting raw measurement data files to the NI TDM/TDMS file format, and then analyzing data in that format with DIAdem, will significantly reduce the time to read files, analyze them, and then save the results.   (see Excel for Big Data and Database vs. File for more information).  

DIAdem Vs. Excel & Other Apps

It is fairly easy to import CSV and other text based data formats into spreadsheet applications such as Excel.   Each parsed data can be assigned a column in the spreadsheet, and you can then perform calculations on the data in all rows within a column.   This works well for small files, but quickly becomes a burden with more than 100,000 rows, and impossible at more than 1,048,576 rows of data.   Reading 1 million rows in Excel takes minutes, but reading it with a DIAdem DataPlugin will only take 7 seconds.   Saving the data to a binary (TDM/TDMS) file and then reading it again will only take 0.04 seconds with DIAdem.  

Most DIAdem DataPlugins have been optimized to read raw data as fast as possible.   And few other time series data analysis applications support anything near the number of raw data formats DIAdem supports.   If you are truly dealing with Big Data, and you need to be able to analyze data from a wide range of data acquisition systems and data loggers, consider carefully the import capabilities and performance of your data analysis system.  

DIAdem Graphical User Interface

The DIAdem graphical user interface (GUI) is organized by task.   The Navigator panel allows you to import raw data, connect to an indexing service such as DataFinder, and to search for data.   The Data Portal provides a means to interact with imported data that has been loaded into memory.   The View panel has tools to enable you to visually analyze and interact with data loaded into the Data Portal.   The Analysis panel provides hundreds of engineering and scientific analysis functions for the manipulation, calculation, and analysis of data.   The Report panel has a powerful user interface that quickly generates custom visualizations of the analyzed data, and supports exporting report pages to common external document formats.   The Script panel allows you to automate repetitive tasks.  

The DIAem panels are highlighted in red in the image below.   When you select a panel, the user interface area (highlighted in blue) changes, presenting new menu choices, group bars (and their function groups), and toolbars that are relevent to the panel (task) chosen.

DIAdem Settings

The global settings for DIAdem are accessible by accessing the menu option 'Settings', 'DIAdem Settings...' from any panel.   This will launch a dialog 'DIAdem Settings' with the options organized within a 'General' group, and then by 'Panels'.   Any changes to the settings will not persist to the next launch of DIAdem unless you save them.  

DIAdem settings may be saved by accessing the menu 'Settings', 'Save As...'.   A 'Save DIAdem Settings As' dialog will appear and it will be set by default to the folder location where DIAdem expects to find the settings file with the '.DDD' file extension.   The default DIAdem settings file is named 'Desktop.DDD'.   Any alternative settings you wish to save should be saved in this folder, under a different filename.  

Loading a .DDD settings file after DIAdem has been loaded will cause DIAdem to restart.   You may also launch DIAdem with a particular settings (.DDD) file.   By specifying a startup script in the 'DIAdem Settings' dialog under 'General', 'Start script', and saving those settings to a unique settings '.DDD' file, you can cause DIAdem to automatically launch a custom script.   To do this, make a copy of the Windows menu icon, then edit the icon and modify the 'Target:' option to include the custom desktop filename with the lower case letter 'd' as the prefix followed by the desktop settings filename without the filename extension.   For example, to launch a custom desktop file named 'CustomDesktop.DDD', the command line would be modified to add 'dCustomDesktop' as: "C:\Program Files\National Instruments\DIAdem 2021\DIAdem.exe" /dCustomDesktop   Note that the double quotes " are required for the path because it has spaces in it.  

What You Learned

• DIAdem is a Big Data management software application that excels in the ingestion, analysis, and visualization of 2D and 3D measurement data.  
• You can import Big Data from nearly any file format, and then store it to an efficient, open file format.
• The graphical user interface is organized by task (import, search, visualize, analyze, report, automate), and the user interface changes based on the panel selected.  
• The global settings can be saved and loaded, and also configured to run a custom script when DIAdem is launched.  

Data Portal

The NAVIGATOR is used to find data of interest and load it into memory.   The Data Portal provides a GUI that allows you to visualize and interact with the file data loaded into memory.  

Loading Data Into The Data Portal

The basics of loading data into memory / the Data Portal were covered in the NAVIGATOR section under Loading Data Into Memory.   In addition to loading a complete data file into memory, the DIAdem NAVIGATOR can also load only portions of the data such as specific channel groups, channels, or a range of values, values based on a number of intervals or inteval width (Data Reduction).   The loaded data can also be appended to data currently loaded in the Data Portal.   These capabilities are powerful tools that can solve difficult data management issues.  

The best practice is to load data from the NAVIGATOR search results, after you have performed a search.   Right click on a search result, and choose the 'Load Data' option from the pop up menu.  

The NI TDM Data Model

The TDM data model consists of three levels of hierarchy for the organization of measurement data.   The top level is the file / root level, and below that is the channel group(s), and a channel group can contain one or more channels.   The highly efficient binary TDM/TDMS file format is based on the NI TDM Model.   Details on the NI TDM Data Model can be found here.  

The Data Portal GUI

At the top of the Data Portal is a toolbar shown in the image below.   From this toolbar, you may clear out the Data Portal (memory), save the contents in memory to a file, filter what is shown in the Data Portal, sort the Data Portal contents, and refresh the Data Portal.  

Data Structures & Channel Types

A 2D data structure consists of an x-channel and y-channel(s) with the same number of values in the X and Y channels.   The most common configuration is one x-channel, and one or more y-channels within the same channel group.   It is also possible to have pairs of X and Y channels within the same channel group.   Y channels are frequently 'numeric' with floating point values.   X channels may be numeric with floating point values (representing seconds, ms, etc.), or they contain date/time values.   Waveform channels contain both the X and Y parts within the same channel. (waveform to numeric channel conversion example)  

Several other channel type exist to handle unique data management needs.   Assignment Channel are numeric or waveform channels that connect specific values or values ranges with text values.   Text Channel holds unicode text values.   Implicit Channel values are generated through a linear specification (rather than individual values).   Calculation Channel values are derived from a formula that typically reference one or more channels and constants.  p Complex Channel consist of real and imaginary values are alternatively stored in a channel.   Video Channel contains reference information to an external video file.  

DIAdem supports both triplet and matrix 3D (x-y-z) data structures.   Tools are included in DIAdem to convert between the two 3D data structure types.   Matrix structures are more commonly accepted for the Report panel 3D charting.   A matrix consists of one numeric x-channel, one numeric y-channel, and multiple numeric z-channels.   One z-channel for each value in the y channel, and the number of values in each z-channel corresponds to the length of the x-channel.   A triplet consists of three data channels of the same length (number of rows/samples), one each x-channel, y-channel, and z-channel.  

What You Learned

• The NAVIGATOR is used to locate files of interest, and then load the data file into memory.  
• The Data Portal allows you to visualize and interact with the contents of the data loaded into memory.
• TDM/TDMS files are organized according to the NI TDM Data Model hierachy, where channels are grouped under channel groups, and channel groups fall under the file/root level.  
• DIAdem supports both 2D and 3D data structures, as well as a wide scope of channel types.  

Analysis

The ANALYSIS panel allows you to perform analysis on the data loaded into the Data Portal (memory).   Dialogs assist you in setting up and performing an extensive scope of standard mathemtical functions for data analysis.   These mathemtical functions are organized into groups that you can browse via the menus, or the group bars.   The DIAdem Calculator allows you to define your own custom formula based functions.   The Calculation Manager will allow you to define a set of calculations to execute where the output from one calculation may be passed as input to the next calculation.  

ANALYSIS Panel GUI

When you activate the ANALYSIS panel by clicking on it, the graphical user interface (GUI) changes, displaying a blank output area in the middle of the application.   The menu structure at the top of the DIAdem application window, and the group bars along the inside left organize the mathematical functions available for data analysis.   The function group names are: Basic Mathematical, Channel Calculations, Curve Fitting, Signal Analysis, Statistical and Classification, 3D Analysis, and Crash Analysis.   Make sure the Data Portal is visible by using the keystrokes 'Alt-F6' if it is not.  

The Calculation Manager is accessed by either clicking on the ANALYSIS 'File' menu and then choosing 'Calculation Manager...', or by clicking on the toolbar icon labeled 'Calculation Manager'.   The calculator is activated by clicking on the ANALYSIS toolbar icon labeled 'Calculator', or from the menu 'Basic', 'Calculator...'.  

Choosing a mathematical function from the menu or the group bar launches a dialog that will typically accept one or more channels for input.  

Find the example file that comes with the DIAdem installation named 'Example.tdm' located in 'C:\PROGRAM FILES\NATIONAL INSTRUMENTS\DIADEM 2021\Libr\Data\Example.tdm'   and load that file into memory (the Data Portal).  

Calculating Descriptive Statistics on a Channel

From the ANALYSIS menu 'Statistics', choose the option 'Descriptive Statistics...'.   In the 'Descriptive Statistics' dialog, under 'Object to be analyzed', click on the button labeled '...' to the right of the 'Channels:' label and input field.   Another dialog will appear named 'Select Channels'.   Use the button labeled 'X' to delete any channels already in the list.   Then expand the channel group named 'Noise data', and then drag and drop the channel 'Noise_2' to the channel list area in the 'Select Channels' dialog.   When done, click 'OK'.  

On the 'Characteristic Values 1' tab, click the 'All Off' button, and then in the 'Mean values' section, enable the checkbox labeled 'Root mean square'.   The calculation will appear immediately in the 'Result data' section.  

Click on the tab labeled 'Result Storage' and make sure the checkbox labeled 'Store results in channels' is not checked.   Calculation of the RMS, as well as all other calculations available from this dialog result in a single numeric value.   The default is to add that result to the channel(s) being analyzed as a new property.   Click the 'Calculate' button, and then the 'Close' button.  

Examine the properties for the channel 'Noise_2' in the Data Portal.   Under 'Custom Properties', you will see the RMS result saved under the property named 'Result~Statistics~MeanValues~SquareMean'.   Note that the tilde '~' character is used here to indicate the property hierarchy.   The results of all ANALYSIS functions in DIAdem are either stored as properties or new channels.  

Note also that in the ANALYSIS window, a sort of log was written, indicating what calculation was performed, on what channel, the DIAdem script function used to perform the calculation ('ChnStatisticsCalc()'), and the numerical result for the root mean square.  

Smoothing A Channel

DIAdem has three smoothing filters to assist with managing signal noise.   From the 'Curve Fitting' menu, you can see them at the top with the labels 'Smooth...', 'Smooth with 4353H filter...', and 'Smooth with Savtizky-Golay Filter...'.   Unfortunately, DIAdem has not intergrated these three filter options that have evolved over time into a single interactive dialog.   You need to try each one manually to find the best result for your needs.   We will explore using each of these filters on the channel 'Noise_2' in the channel group 'Noise data'.  

From the ANALYSIS panel menu 'Curve Fitting', choose the filter option 'Smooth...'.   Drag and drop the 'Noise_2' channel into the channel input area.   Make sure the 'Calculation parameters' are set to the default values of: 'Max smoothing width on one side (no of points):' to 12, 'Select points:' to 'Maximum number', 'Smoothing procedure' is 'Smooth over mean value', and 'Result channel' does not have the checkbox 'Store result in original channel checked.   A plot will be shown in the dialog to give you an idea what impact the filter will have on the data.   Unfortunately, you cannot zoom in and see specific sections of the data, but in this case you can see that the filter is too aggressive.   Try changing the 'Max smoothing width on one side' option, and the other parameters as well.   When finished, click the 'Cancel' button so that no changes are saved.  

From the ANALYSIS menu 'Curve Fitting', choose the filter 'Smooth with 4253H Filter'.   Drag and drop the 'Noise_2' channel to the channel input control.   Notice that this filter is much less aggressive than the 'Smooth' filter.   The spikes in the signal are filtered to some degree, but it is not clear from the preview if the outcome will be acceptable.   Choose the 'Smooth with 4253H-twice-filter' option, make sure the checkbox 'Store result in original channel' is not checked, and then click the 'Calculate' button, observing what happens in the Data Portal, and then click the 'Cancel' button to close the 'Smooth with 4253H Filter' dialog.  

A new channel will be added to the default channel group in the Data Portal.   Move that channel back under the channel group 'Noise data' by selecting the channel 'Smoothed4253H', right click and choose 'Cut' from the pop up window.   Then navigate back up to the 'Noise data' channel group, click on the channel group, and then right click and choose 'Paste'.  

Lets examine the filtered results more closely by using the VIEW panel.   Activate the VIEW panel, and choose the 'File', 'New' option to clear out the worksheet area (don't save anything that was left behind).   Click on the channel 'Noise_2' and then the channel 'Smoothed4253H' and then drag and drop in to the empty VIEW worksheet.   Choose the '2D Axis System' option.   Use the Band Cursor to zoom in to the section between 3.908 and 3.91 seconds.   Note by toggling the checkbox for the green curve (Smoothed4253H), you can see the effect of the filter on the signal.   You would need to decide if this filtering is good.   Note that if you calculate RMS on the filtered channel, you will see that it has changed from 0.128 to 0.120.  

Try the final filter named 'Smooth with Savitzky-Golay Filter'.   Drag and drop the 'Noise_2' filter to the channel input control.   Notice that in the preview area, the a message states the preview has been aborted because the channel has many values (325000 in fact).   Therefore, the only way to see the result is to plot it in the VIEW panel.   Make sure the defaults are set to: 'Smoothing width on one side:' to 12, 'Order of the polynomial:' to 1, and 'Weighting channel' checkbox is unchecked.  ' After confirming that the 'Store result in original channel' is unchecked, click the 'Calculate' button to execute the filtering, and then the 'Close' button to close the dialog. Drag the channel created 'FilteredSignal' back to the channel group 'Noise data'.  

Activate the VIEW panel and then drag and drop the channel 'FilteredSignal' to the 2D chart.   Note that the effect of the 'Savitzky-Golay' filter is significantly different than the '4253H' filter.  

Try the 'Savitzky-Golay' filter again, but this time change the 'Smoothing width on one side:' to 3.   Plot that result in the VIEW panel as done before. You can see that the 'Savitzky-Golay' filter with a value of 3 (channel 'FilteredSignal1') produces a result that is somewhere between the 'Smoothed4253H' result, and the 'Savitzky-Golay' filter value 12 (channel 'FilteredSignal').

Clear out the VIEW sheet by clicking on the VIEW menu options 'File' and 'New' (don't save).   Clear out the Data Portal by clicking on the NAVIGATOR panel and then the menu options 'File' and 'New' (don't save).   Load the 'Example.tdm' file again by choosing 'File' and 'Recent Files'.  

Finding A Channel Event

This tutorial will demonstrate how DIAdem can identify a channel event based on criteria for two channel conditions.   DIAdem has two dialogs to assist with an event search task.   From the ANALYSIS panel, browse the menu option 'Channel Functions', and select either 'Event Search' or 'Event Search (Free Formula)'.   It is the author's opinion that 'Event Search (Free Formula)' is easier to use.  

From the ANALYSIS panel, browse the menu option 'Channel Functions', and select 'Event Search (Free Formula)'.   The dialog 'Event Search (Free Formula) will appear.   Clear out the dialog inputs so they appear as shown below.  

We want to look for the condition where the channel 'Speed' has a value greater than 40 m/s, and the channel torque is greater than 200 Nm.   Under the section 'Channels to be analyzed', click on the first row in the table to the right of the label '1' under the column 'Identifier' and assign the value of 'A'.   To the right of that, drag and drop the channel 'Example/Speed' from the Data Portal into the field labeled 'Channel'.   Click on the '+' icon to add another condition and then repeat the process for the channel 'Torque', but assigning the 'Identifier' of value 'B'.   At the bottom of the dialog, the tab 'Result Storage' and options 'Condition fulfilled' and 'Condition not fulfilled' establish what the result channel output will be.   You want the value to be '1' when fulfilled (true), and '0' when not fulfilled (false).   At the top of the dialog, enter the 'Formula' value of '(A>40) AND (B>200)'.   The dialog should appear as shown below.  

The 'Result data' plot on the bottom right will show graphically when the data will meet the conditions for the 'Selected channel' plotted above.   Click the 'Calculate' button at the bottom of the screen, and then click the 'Close' button.  

DIAdem will create a new channel named 'EventStatus' in the last channel group in the Data Porta.   Drag this channel up to the channel group 'Example' where it belongs.  

Visualizing Event Search Results

This tutorial will use the 'EventStatus' channel created from the prior tutorial event search to visually identify where in the 'Speed' and 'Torque' channels the events occurred.   The visualization will be performed in a VIEW 2D Axis System using 'Background Segments'.  

Click on the VIEW panel to activate it.   Clear out the worksheet by choosing the menu option 'File', 'New'.   Select the 'Time', 'Speed', and 'Torque' channels in the 'Example' channel group and then drag and drop them to the empty VIEW worksheet.   When the pop up menu appears, choose '2D Axis System'.   Access the 2D Axis System toolbar 'Y-Axis' and select the option 'n Systems [linear]'.  

From the VIEW panel menu, choose 'View' and 'Settings' (or double click inside the 2D Axis System area, but not the legend area).   Click on the button 'Background Segments...'.  

Delete any existing segment definitions if they exist.   Click on the '+' button labeled 'New Entry' when you hover your mouse over it.   The 'Add Segment' dialog will appear.   Drag and drop the 'Time' channel from the Data Portal to the 'Add Segment' dialog 'X-channel' channel input control.   Drag and drop the 'EventStatus' channel from the Data Portal to the 'Add Segment' dialog 'Y-channel' channel input control.   Make sure the 'Type:' is set to 'X', the 'Color' is set to grey, and the 'Transparency' is set to '0'.   Click the 'OK' button to close the 'Add Segment' dialog.   Click the 'OK' button to close the 'Color Background Segments' dialog.   Click the 'OK' button to close the '2D Axis System' dialog.  

The 2D chart now displays the 'EventStatus' channel in the background, allowing you to visualize when the where the channel 'Speed' has a value greater than 40 m/s, and the channel torque is greater than 200 Nm.  

Clear the VIEW worksheet by accessing the menu 'File', 'New'.   Clear out the Data Portal by clicking on the NAVIGATOR panel and then the menu options 'File' and 'New' (don't save).   Load the 'Example_data.tdm' file again by choosing 'File' and 'Recent Files'.  

Calculator & Calculation Manager

You can perform custom channel calculations using the 'Calculator' and the 'Calculation Manager'.   The Calculation Manager is recommended over the Calculator several reasons, as will be demonstrated by the examples that follow.  

The tutorial that follows will calculate power from the RPM and Torque channels from the 'Example.tdm' DIAdem sample file.   Find the example file that comes with the DIAdem installation named 'Example.tdm' located in 'C:\PROGRAM FILES\NATIONAL INSTRUMENTS\DIADEM 2021\Libr\Data\Example.tdm'   and load that file into memory (the Data Portal).  

Channel References for Calculator & Calculation Manager

DIAdem uses the format of Ch("group name / channel name") to reference a channel within formulas for both the Calculator and the Calculation Manager.   For example, if you wanted to reference a channel named 'Noise_1' in the channel group named 'Noise data', then the reference would be: Ch("Noise data/Noise_1") .   If the channel "Noise_2" is a unique name to all channels currently in the Data Portal, then you can simplify the reference to just the channel name, e.g. Ch("Noise_1") .   When you are creating a new channel to receive the results of the calculation, make sure to always include the channel group name.  

Both the Calculator and the Calculation manager will create a new channel in an existing default channel group, or a new channel group.   Using 'Ch("NewChnGrp/NewChn") = PI' for example as the formula (exclude the outer single quotes) will result in a new channel group named 'NewChnGrp' and a new channel named 'NewChn' to be created in the Data Portal (assuming neither already exist).   If the channel already exists, it will be overwritten.  

Calculating Power Using Calculator

The general formula to calculate power in kW from Torque in N-m and speed in RPM is:

Power [kW] = 2 * Pi() * (1 min / 60 sec) * (1 kW / 1000 W) * (Speed [rpm]) * (Torque [N-m])

Access the Calculator by clicking on the ANALYSIS panel toolbar labeled 'Calculator', or from the menu 'Basic', 'Calculator...'.   Click in the 'Formula' window, and enter the following formula (excluding the leading and trailing single quotes): 'Ch("Example/Power_kW") = Ch("RPM") * Ch("Torque") * 2 * PI * (1/60) * (1/1000)'  

If you press the enter key on your keyboard after entering / pasting the formula, then the formula will execute.   Otherwise, you can perform the calculation by click the 'Calculate' button.  

After the calculation executes, a new channel named 'Power_kW' will be created in the Data Portal with the result.   Note that no units are assigned to this channel, and it is necessary to enter constants in order to convert the speed from RPM to rotations per second, and the power from watts to kilowatts.   As a convenience, the 'Description' property for the channel is updated with the formula from the Calculator.  

Calculating Power Using Calculation Manager

Click on the channel 'Power_kW' created by the prior exercise and then right click and choose 'Delete' to remove the channel.   Launch the Calculation Manager by either using the menu option 'File', 'Calculation Manager...', or clicking on the calculation manager icon.  

Create a new Calculation Group by clicking on the 'Add Calculation Group' toolbar button.   Name the calculation group 'Power' and click the 'OK' button.  

Click on the dialog toolbar 'Add Calculation'.   The dialog 'Calculation Manager - Add Calculation' will appear.   Two buttons are at the top, 'Calculation' and 'Script'.   Click the 'Calculation' button at the top.   Assign a name to the calculation.   Set the 'Formula:' to : 'Ch("Example/Power_kW") = Ch("RPM") * Ch("Torque")'   Make sure the 'Quantity-based' checkbox is checked, and then to the right of that at 'Result unit:', click on the '...' button and find the 'Quantity' of 'Power' and assign the value of 'kW'.   Click on the 'Script' button at the top of the dialog and observe the VBScript code that is shown to replicate the calculation.   Click the 'OK' button when finished.  

Note that the formula 'Ch("Example/Power_kW") = Ch("RPM") * Ch("Torque")' does not contain any constants for unit conversion.   This is because the 'Quantity-based' checkbox is selected, and a target final unit of 'kW' was assigned.   The conversions required to convert torque in N-m and speed in rotations per minute (rpm) to kilowatts is automatically figured out by DIAdem.   HOWEVER, if the 'Torque' or 'RPM' channel didn't have units, then this option would generate an error, and it would be necessary to input the unit conversions as was done with the Calculator.  

The dialog should be configured as shown in the image below.   Click on the toolbar 'Run' button to execute the calculation.   Observe that the 'Power_kW' channel is created in the Data Portal.  

In order to demonstrate a sequence of calculations, we will add one more calculation that will convert power and speed (rpm) back to torque.   Click the 'Add Calculation' button.   Assign a 'Name:' of 'Torque_Nm'.   Enter the formula: 'Ch("Example/Torque_Nm") = Ch("Power_kW") / Ch("RPM")'   Check the checkbox 'Quantity-based' and set the 'Result unit' to 'N-m' by looking under 'Quantity' = 'Torque' and selecting '[Nm] newton meter'.   Click the 'Run' button at the top right toolbar to see the result.   Click the 'OK' button to close the 'Calculation Manager - Add Calculation' dialog.  

With the 'Calculation Manger' dialog still visible, click the save button on the toolbar and give it the name 'Power_Torque.tca', taking note where the file was saved.   Click the 'OK' button to close the dialog.   In the Data Portal, select the 'Power_kW' and 'Torque_Nm' channels and then click the keyboard key 'Del' to delete those two channels (or right click and choose 'Delete').   Click on the ANALYSIS toolbar button 'Execute Calculations' button.   Select the first row labeled 'Power' (in the 'Calculation' column it shows '--- 2 Calculation(s) ---').   Click on the toolbar button 'Run'.   Observe that both calculations run.   First the 'Power_kW' channel is created, and then it is followed by the 'Torque_Nm' calculation.  

As demonstrated, you can sequence a series of calculations, where one depends on the result of a prior calculation to generate a new output.   This is a powerful no script method of automating calculations.  

What You Learned

• DIAdem has a wide scope of powerful analysis functions.   Dialogs guide you through the use of each of the functions.  
• You can use event search to identify when one or more channels both meet a particular condition, and then visualize the result in the VIEW panel using Background Segments.  
• The Calculation Manger is a tool that allows you to easily chain a sequence of calculations where one calculation result becomes another calculation's input   (script / code writing not required).  

 

More ANALYSIS Tutorials

Offset Correction   |   Differentiate & Integrate   |  Convert To Unit Set   |  Resampling   |  FFT   |  Digital Filters   |  Time-At-Level Histogram   |  Signal Generation   |  Detrend a Signal   |  Create a Signal Mask   | 

SCRIPT

The DIAdem SCRIPT panel allows you to automate repetitive tasks by writing code in either VBScript or Python   All of the functionality you see in each of the DIAdem panels is accessible to a script (and more).   You may also create custom dialogs with the Dialog Editor that contain powerful controls including channel inputs and data visualization.  

SCRIPT GUI

The primary SCRIPT tools are the script editor, the enable/disabl, the recording mode, and the Logfile.   You can write to the Logfile by using the 'LogFileWrite()' subroutine in a script. For example: 'Call LogFileWrite("writing to the Logfile")'.  

Copying Code & Settings From A Dialog

In any dialog other than those from the SCRIPT panel, you can cause DIAdem to write the dialog settings and any function / subroutine calls used by the dialog to the Windows clipboard.   In most cases, the information written will be more detailed than what is recorded using the recording mode.   The key combination is 'Ctrl-Shift-C'.  

Identifying Menu / Group Bar / Toolbar Elements

You can get the identity of any DIAdem menu, group bar, or toolbar by holding the 'Shift-Ctrl' keys while hovering the mouse over the menu/group bar/toolbar.   Use the Bar Manager object to access these items.  

VBScript Language

Use the single quote ' character to insert a comment.   To comment out a block of code, select the code and use 'Ctrl-D'.   To un-comment a block of code, select the code and use 'Shift-Ctrl-D'.  

All variables should be declared using the 'Dim' statement.   Use the keys 'Ctrl-F5' or the SCRIPT toolbar button 'Run Script' to run a script.  

Referencing a channel in DIAdem can be done in several ways.   Most DIAdem functions / subroutines accept a channel reference in the form of a variable object reference e.g. 'Set oChnX = Data.GetChannel("Example/Time")', or a text reference in the form of '"[1]/Time"' or '"Example/Time"' or '"[1]/[1]'" (without the single quotes).   The best method is to configure the object reference, or if using text then use the text '"channel group name/channel name"' format ('"Example/Time"').  

Dim oChnX, oChnY, oChnResult

'Assign the X & Y channels to a channel objects oChnX and oChnY
Set oChnX = Data.GetChannel("Example/Time")
Set oChnY = Data.GetChannel("Example/Speed")

'Define the channel where the result of the analysis will go
'by creating a new channel in the same channel group as oChnY
'with the channel name "Result"
Set oChnResult = oChnY.ChannelGroup.Channels.Add("RMS_of_" & oChnY.Name, DataTypeChnFloat64)

'Calculate the RMS of oChnY
'ChnRMS(XW, Y, ResultChannel, RMSWidth) 
Call ChnRMS(oChnX, oChnY, oChnResult, 10)

Or using text based channel references:

'Calculate the RMS of oChnY
'ChnRMS(XW, Y, ResultChannel, RMSWidth) 
Call ChnRMS("Example/Time", "Example/Speed", "Example/Speed_RMS", 10)

The text based channel references may seem more simple (and they are for a single calculation), BUT they are specific to a particular channels by name.   If you want to use your script on data in the Data Portal with different channel group and channel names, it will be necessary to change every channel group and channel name reference.   It is better and easier in longer scripts to assign those references once as channel objects, and then use those channel objects throughout the remainder of the script.  

Recording Mode

DIAdem's SCRIPT recording mode will record all commands and most variables as you perform a task with any of the non-SCRIPT panels.   Access the recording mode by clicking on it from the SCRIPT toolbar.   You will need to make a choice on how to handle file references.   The 'File reference' option in the dialog of 'Absolute path' is the easiest option for a beginner to understand.   The 'Path variable' option will configure an array for the filenames used throughout the script, but you need to be comfortable with VBScript arrays if you want to use that option.  

When recording DIAdem's dialogs, you can get more information from the dialog settings than just the final function/subroutine call by using the key combination 'Ctrl-Shift-C' before the dialog is closed.   For example, if you turn on recording mode and perform descriptive statistics on a channel, the script window will contain the following code:

Call ChnStatisticsChannelCalc("[1]/Speed", 56, 0, 0, False, False, False, "NameName")

But if you use the key combination Ctrl-Shift-C before closing the dialog, you will get the following code snippet:

'StatsSelection = eStatsMinimum + eStatsMaximum + eStatsArithmeticMean
StatsSelection   = 56
StatsUsePopulationFormula = False
'------------ Result Storage ------------
StatsResultChn   = False
StatsResultChnNames = False
StatsResultChnNameFormat = "NameName"
'------------ Command -------------------
'Set ChnResult = ChnStatisticsChannelCalc("'[1]/Speed'", 56, NOVALUE, NOVALUE, False, False, False, "NameName")
Call ChnStatisticsChannelCalc("[1]/Speed", 56, 0, 0, False, False, False, "NameName")

Everything above the call to ChnStatisticsChannelCalc() in the script shown above is either comments, or assignments to global variable associated with the ChnStatisticsChannelCalc() function (although they are not actually called).   They provide supplemental information.   In particular, the first line of 'StatsSelection = eStatsMinimum + eStatsMaximum + eStatsArithmeticMean' is very useful because you can look at the help for this function, and then easily add additional statistical functions to be calculated.

This tutorial will teach you how to use the SCRIPT Recording Mode to record a series of actions in DIAdem.   Then you will use the 'VBScript Template' provided and adapt that script with the contents from the recording mode script.   For this tutorial, be prepared to find the example file that comes with the DIAdem installation named 'Example.tdm' located in 'C:\PROGRAM FILES\NATIONAL INSTRUMENTS\DIADEM 2021\Libr\Data\Example.tdm'   and load only the 'Time', 'RPM', and 'Torque' channels using the SCRIPT commands:

Call Data.Root.Clear()
Call DataFileLoadSel("C:\PROGRAM FILES\NATIONAL INSTRUMENTS\DIADEM 2021\Libr\Data\Example.tdm","TDM","[1]/[1]|[1]/[3]|[1]/[4]","Load|ChnXYRelation")

Tutorial Using Recording Mode

This tutorial will use the SCRIPT recording mode to calculate the power as a channel from the channels 'RMS' and 'Speed' from the file 'Example.tdm'.   Descriptive statistics will then be calculated on the channel 'Power'.  

Activate the SCRIPT panel.   Load the channels 'Time', 'RPM' and 'Torque' from the DIAdem example file 'Example.tdm' using the script shown below.  

Call Data.Root.Clear()
Call DataFileLoadSel("C:\PROGRAM FILES\NATIONAL INSTRUMENTS\DIADEM 2021\Libr\Data\Example.tdm","TDM","[1]/[1]|[1]/[3]|[1]/[4]","Load|ChnXYRelation")

Clear the SCRIPT workspace by using the menu 'File', 'New Workspace' (don't save anything).   In the SCRIPT panel, click in the recording mode toolbar and set the 'File reference' option to 'Absolute path'.   Click the 'Configure Recording Mode' dialog 'OK' button.  

The recording mode non-modal dialog will appear.

Recall that to calculate power using the Calculation Manger, it was the product of the channels 'RPM' and 'Torque'.   The general formula is: Power [kW] = 2 * Pi() * (1 min / 60 sec) * (1 kW / 1000 W) * (Speed [rpm]) * (Torque [N-m])   Activate the ANALYSIS panel by clicking on it.   From the 'Basic' menu, choose '* Multiply...'.   In the Data Portal, drag and drop the 'RPM' channel into the dialog 'Multiply' channel control labeled '1st channel:'.   Drag and drop the 'Torque' channel from the Data Portal to 'the dialog 'Multiply' channel control labeled 'Other channels:'.   Click the 'Calculate' button, and then the 'Close' button.   Activate the SCRIPT panel, and you will see the following line added to the script by the recording mode:

Set ChnResult = ChnMul("[1]/RPM", "[1]/Torque", "/Multiplied")

Cleaning that up, a better command would be:

Call ChnMul("Example/RPM", "Example/Torque", "Example/Power")

Edit the script as shown above and try running the script (Ctrl-F5).   The revised script will create a channel named 'Power'.   Note that the unit for power is '(1/min)*(Nm)', and we want kW.   The units need to be converted, and the ChMul() function doesn't support quantity-based calculations like other commands such as Calculate() do.   We will fix that by using another ANALYSIS function named 'Scale'.   The recording mode should still be on.   Click on the ANALYSIS panel and then select the menu 'Basic' and 'Scale...'.   In the Data Portal, select the new channel 'Power' and drag and drop it into the 'Scale' dialog channel control labeled 'Channel:'.   The 'Factor' in the dialog multiples the channel values by a constant, and the 'Offset' adds or subtracts and offset from the channel values.   (sort of like Y = mX + b).   We need to multiple all of the values in Power by '3.142 * 2 * (1/60) * (1/1000) = 0.0001047' in order to express the power channel in units of kW.   Enter the constant of '0.37704' into the 'Factor' text box, check the checkbox labeled 'Store result in original channel'.   Click the 'Calculate' button, and then the 'Close' button.  

Activate the SCRIPT panel.   The recording mode has added a new line to the script as shown below.  

Set ChnResult = ChnLinScale("[1]/Power", "/Power", 0.0001047, 0)

A cleaner version of this line of code would be:

'Convert power in (1/min)*(Nm) to kW
Call ChnLinScale("Example/Power", "Example/Power", 0.0001047, 0)

The unit for the channel 'Power' in incorrect.   In the Data Portal, click on the channel 'Power', and then in the channel properties window, find 'Unit', click on the unit value, and a '...' button will appear.   Click on the '...' button to edit the unit for power.  

The warning message shown below should appear.   Click the 'No' button.  

The 'Channel Unit: Symbol Input Tool' dialog will appear.   Click on the drop down box to the right of 'Quantity:' and select 'Power'.   Under the list box 'Units', select '[kW]kilowatt'.   Click the 'Replace' button, and the dialog will close, and the units for the channel 'Power' will be updated to kW.  

Activate the SCRIPT panel and review the script commands added.   No additional commands were added to the script for the unit conversion.   If you had said 'Yes' to the earlier dialog, then you would have had to first define what the unit '(1/min)*(Nm)' means in terms of the unit catalog's base value of watts.   The only way to fix the units for the channel 'Power' using a script is to use the following script:

'Change the channel Power units to kW
Dim oChnY
Set oChnY = Data.GetChannel("Example/Power")
oChnY.UnitSymbol = "kW"

Add the above commands to your recorded script.  

The final step will be to calculate descriptive statistics on the channel 'Power'.   With the recording mode still on, active the 'ANALYSIS' panel.   Choose the ANALYSIS menu 'Statistics', 'Descriptive statistics...'.   In the Data Portal, select the channel 'Power' and then drag and drop it to the 'Descriptive Statistics' dialog, into the channel control to the right of the label 'Channels:'.   Configure the 'Characteristic Values 1' tab to have only the following check boxes checked: 'Root mean square'.   Click on the 'Result Storage' tab and insure the checkbox 'Store results in channels' is not checked.   Now use the key sequence 'Ctrl-Shift-C' to copy the dialog settings to the Windows clipboard.   Click the 'Calculate' button, and then the 'Close' button.  

Activate the SCRIPT panel.   The additional code added to recording mode script should be what is shown below.  

'StatsSelection = eStatsSquareMean
StatsSelection   = 64
StatsUsePopulationFormula = False
'------------ Result Storage ------------
StatsResultChn   = False
StatsResultChnNames = False
StatsResultChnNameFormat = "NameName"
'------------ Command -------------------
'Set ChnResult = ChnStatisticsChannelCalc("'[1]/Power'", 64, NOVALUE, NOVALUE, False, False, False, "NameName")
Call ChnStatisticsChannelCalc("[1]/Power", 64, 0, 0, False, False, False, "NameName")

A clean version of the above code would be what is shown below.   Additionally, the RMS value for channel 'Power' is written to the Logfile, just to show you how you could access that value in a script.  

'Calculate the RMS of the channel Power
Call ChnStatisticsChannelCalc("Example/Power", eStatsSquareMean, 0, 0, False, False, False, "NameName")
Call LogFileWrite("RMS of Power = " & oChnY.Properties("Result~Statistics~MeanValues~SquareMean").Value & " " & oChnY.UnitSymbol)

Your recorded script with the clean changes proposed, should now look what is shown below.   Run this script and observe that a channel 'Power' with the units of 'kW' is created, and it has a maximum value of 128.4 kW.  

Call Data.Root.Clear()
Call DataFileLoadSel("C:\PROGRAM FILES\NATIONAL INSTRUMENTS\DIADEM 2021\Libr\Data\Example.tdm","TDM","[1]/[1]|[1]/[3]|[1]/[4]","Load|ChnXYRelation")

Call ChnMul("[1]/RPM", "[1]/Torque", "/Power")

'Convert power in (1/min)*(Nm) to kW
Call ChnLinScale("Example/Power", "Example/Power", 0.0001047, 0)

'Change the channel Power units to kW
Dim oChnY
Set oChnY = Data.GetChannel("Example/Power")
oChnY.UnitSymbol = "kW"

'Calculate the RMS of the channel Power
Call ChnStatisticsChannelCalc("Example/Power", eStatsSquareMean, 0, 0, False, False, False, "NameName")
Call LogFileWrite("RMS of Power = " & oChnY.Properties("Result~Statistics~MeanValues~SquareMean").Value & " " & oChnY.UnitSymbol)

VBScript Template

The VBScript below may be used as a template for processing a file loaded in the Data Portal, or each file specified by the NAVIGATOR search results.   In either case, the function bProcessDataPortal() is called, input channels are identified, and a DIAdem ANALYSIS function is performed. If the NAVIGATOR search results are being processed, then the file will be saved before the next file from the search results is processed.  

Activate the SCRIPT panel.   From the SCRIPT panel menu, choose 'File', 'New VBS'.   Delete the default script contents by using the keys 'Ctrl-A' to select everything and then clicking the 'Del' key to delete the selection.   Copy the code below to the Windows clipboard (Ctrl-C).   Return to the SCRIPT editor, click in the empty sheet, and either use 'Ctrl-V' to paste the Windows clipboard contents, or the SCRIPT menu 'Edit', 'Paste'.   Access the SCRIPT menu 'File' and 'Save' and save it to the filename 'VBScriptTemplate.VBS'.  

'-------------------------------------------------------------------------------
'-- VBS script file VBScriptTemplate.VBS
'-- Author: Mechatronic Solutions LLC
'-- Comment:  Function bProcessDataPortal() demonstrates how to configure input and output
'             channel assignments, and then execute a DIAdem ANALYSIS function. 
'             If data is loaded into the Data Portal, then bProcessDataPortal() is executed
'             immediately.  If NAVIGATOR search results are found, then each file specified
'             by the search results is loaded, function bProcessDataPortal() is executed,
'             and then the file is saved. 
'
'             YOU MUST EDIT CHANNEL ASSIGNMENTS IN FUNCTION bProcessDataPortal()
'-------------------------------------------------------------------------------
Option Explicit  
Call LogFileDel()

''Uncomment the lines below to load a DIAdem sample file (for demo).
'Call Data.Root.Clear()
'Call Navigator.Display.CurrDataFinder.Browser.Activate()
'Call DataFileLoad("C:\Program Files\National Instruments\DIAdem 2021\Examples\Data\ADOExample.tdm","TDM","Load|ChnXYRelation")


If Not bProcessNavSearchResults() Then Call Err.Raise(65535,,"ERROR:  bProcessNavSearchResults()")


Function bProcessNavSearchResults()
  'Iterate over the NAVIGATOR search results, loading one file at a time, executing
  'bProcessDataPortal(), and then saving the file. 
  'If no NAVIGATOR search results and data exists in the Data Portal, then simply
  'execute bProcessDataPortal(). 
  
  bProcessNavSearchResults = False
  Call LogFileWrite("bProcessNavSearchResults()...")
  
  Dim oSearchResult, oSearchResults, sFilePath
  Dim bCmdNoWarningDisp, bCmdNoMsgDisp

  'The two boolean global variables below supress pop up warnings.  
  'Save the current state to a temporary variable so it may be restored upon exit.
  bCmdNoWarningDisp = CmdNoWarningDisp: bCmdNoMsgDisp = CmdNoMsgDisp
  
  If Data.Root.ChannelGroups.Count > 0 AND Navigator.Display.CurrDataFinder.ResultsList.IsActive = False Then
    If Data.Root.ChannelGroups(1).Channels.Count > 0 Then
      'No NAVIGATOR search results, but the Data Portal has data
      Call LogFileWrite(String(1,vbTab) & "Processing data in the Data Portal ...")
      If Not bProcessDataPortal() Then  
        Call LogFileWrite(String(1,vbTab) & "ERROR processing the Data Portal")
        Exit Function
      End If
      bProcessNavSearchResults = True
      Exit Function
    End If
  End If

  If Navigator.Display.CurrDataProvider.IsKindOf(eDataStore) Then Call Err.Raise(65535,,"ERROR: You are connected to a DataStore, not a DataFinder")
  If Not Navigator.Display.CurrDataFinder.QueryForm.ResultsMode = eResultsModeElements Then Call Err.Raise(65535,,"ERROR: The DataFinder search results are not elements (files), but rather properties")
  If Navigator.Display.CurrDataFinder.ResultsList.ResultsElements.IsIncomplete Then Call Err.Raise(65535,,"WARNING:  Not all of the NAVIGATOR search results are displayed.")
  
  If Navigator.Display.CurrDataFinder.ResultsList.ResultsElements.Count < 1 AND Data.Root.ChannelGroups.Count = 0 Then
    Call Err.Raise(65535,,"ERROR: No NAVIGATOR search results to process, and no data loaded into the Data Portal.")
  Else  'Search results exist
    Call LogFileWrite(String(1,vbTab) & "Processing " & Str(Navigator.Display.CurrDataFinder.ResultsList.ResultsElements.Count) & " search results (files) from the NAVIGATOR search results...")
    Set oSearchResults = Navigator.Display.CurrDataFinder.ResultsList.ResultsElements
    
    For Each oSearchResult In oSearchResults
      
      'Get the path to the file from oSearchResult
      sFilePath = oSearchResult.Properties("folder").Value & "\" & oSearchResult.Properties("filename").Value
      Call LogFileWrite(String(1,vbTab) & "Analyzing file '" & NameSplit(sFilePath,"N") & "." & NameSplit(sFilePath,"E") & "'...")
      
      'Clear the contents of the Data Portal
      Call Data.Root.Clear()
      
      'Load the data file sFilePath into the Data Portal
      Call DataFileLoad(sFilePath, uCase(NameSplit(sFilePath,"E")), "Load|ChnXYRelation")
      
      If Not bProcessDataPortal() Then  
        Call LogFileWrite(String(1,vbTab) & "ERROR processing file '" & NameSplit(sFilePath,"N") & "." & NameSplit(sFilePath,"E") & "'...")
        Exit Function
      End If
      
      'Save the file with any changes from bProcessDataPortal()
      CmdNoWarningDisp = True: CmdNoMsgDisp = True
      Call DataFileSave(sFilePath, uCase(NameSplit(sFilePath,"E")), True)
      'Restore the global variable state
      CmdNoWarningDisp = bCmdNoWarningDisp: CmdNoMsgDisp = bCmdNoMsgDisp
    
    Next  'oSearchResult
    
    'Clean up..
    Call Data.Root.Clear()
    Set oSearchResult = Nothing: Set oSearchResults = Nothing
  End If
  
  bProcessNavSearchResults = True
End Function  'bProcessNavSearchResults()


Function bProcessDataPortal()
  bProcessDataPortal = False
  Call LogFileWrite("bProcessDataPortal()...")
  
  Dim oChnX, oChnY, oChnResult
  
  'Edit the X and Y channel assignments below:
  Set oChnX = Data.GetChannel("Measurement_A/Time")
  Set oChnY = Data.GetChannel("Measurement_A/MeasurementChannel_1")
  
  'Define the channel where the result of the analysis will go
  'by creating a new channel in the same channel group as oChnY
  'with the channel name "Result"
  Set oChnResult = oChnY.ChannelGroup.Channels.Add("Result", DataTypeChnFloat64)
  
  'ChnOffset(Y, ResultChannel, ChnOffsetValue, ChnOffsetMode) 
  Call ChnOffset(oChnY, oChnResult, 0, "min. value offset")
  
  'Update the description property for oChnResult
  Call oChnResult.Properties.Add("description", "ChnOffsetVal() min value offset.  Source: " & oChnY.GetReference(eReferenceNameName))
  
  'Clean up
  Set oChnX = Nothing: Set oChnY = Nothing: Set oChnResult = Nothing
  bProcessDataPortal = True
End Function  'bProcessDataPortal()

To run the demo, un-comment the lines shown below.   Run the script with the keys 'Ctrl-F5' or the SCRIPT toolbar button 'Run Script'.   The script will load a DIAdem example file and then execute the ANALYSIS function 'Offset Corrrection' or 'ChnOffset()' on the channel 'Measurement_A/MeasurementChannel_1'.  

''Uncomment the lines below to load a DIAdem sample file (for demo).
Call Data.Root.Clear()
Call Navigator.Display.CurrDataFinder.Browser.Activate()
Call DataFileLoad("C:\Program Files\National Instruments\DIAdem 2021\Examples\Data\ADOExample.tdm","TDM","Load|ChnXYRelation")

Example Using The Script

In this tutoral, the prior recording mode script generated will be integrated into a copy of the script 'VBScriptTemplate.VBS'.   Save the script 'VBScriptTemplate.VBS' to a new file named 'Power from RPM & Torque.VBS' by choosing the SCRIPT menu 'File', and 'Save As...'   Uncomment the three lines in the beginning that clear the data portal, activate the NAVIGATOR browser, and load a data file.   Replace the DataFileLoad() command with a reference to the 'Example.tdm' file as used in the recording mode tutorial.  

''Uncomment the lines below to load a DIAdem sample file (for demo).
Call Data.Root.Clear()
Call Navigator.Display.CurrDataFinder.Browser.Activate()
Call DataFileLoadSel("C:\PROGRAM FILES\NATIONAL INSTRUMENTS\DIADEM 2021\Libr\Data\Example.tdm","TDM","[1]/[1]|[1]/[3]|[1]/[4]","Load|ChnXYRelation")

If you adjust the script with the additional script content from the recording mode tutoral, and make the other changes as shown below, the script will calculate power from RPM and Torque.  

Function bProcessDataPortal()
  bProcessDataPortal = False
  Call LogFileWrite("bProcessDataPortal()...")
  
  Call ChnMul("Example/RPM", "Example/Torque", "Example/Power")
  
  'Convert power in (1/min)*(Nm) to kW
  Call ChnLinScale("Example/Power", "Example/Power", 0.0001047, 0)
  
  'Change the channel Power units to kW
  Dim oChnY
  Set oChnY = Data.GetChannel("Example/Power")
  oChnY.UnitSymbol = "kW"
  
  'Calculate the RMS of the channel Power
  Call ChnStatisticsChannelCalc("Example/Power", eStatsSquareMean, 0, 0, False, False, False, "NameName")
  Call LogFileWrite("RMS of Power = " & oChnY.Properties("Result~Statistics~MeanValues~SquareMean").Value & " " & oChnY.UnitSymbol)

  'Clean up
  Set oChnY = Nothing
  
	bProcessDataPortal = True
End Function  'bProcessDataPortal()

The function bProcessDataPortal() may also be re-written to use channel object references, as shown below:

Function bProcessDataPortal()
  bProcessDataPortal = False
  Call LogFileWrite("bProcessDataPortal()...")
  
  Dim oChnRpm, oChnTrq, oChnPwr
  
  Set oChnRpm = Data.GetChannel("Example/RPM")
  Set oChnTrq = Data.GetChannel("Example/Torque")
  
  'Create a new channel Power
  Set oChnPwr = oChnRpm.ChannelGroup.Channels.Add("Power", DataTypeChnFloat64)
  
  Call ChnMul(oChnRpm, oChnTrq, oChnPwr)
  
  'Convert power in (1/min)*(Nm) to kW
  Call ChnLinScale(oChnPwr, oChnPwr, 0.0001047, 0)
  
  'Change the channel Power units to kW
  oChnPwr.UnitSymbol = "kW"
  
  'Calculate the RMS of the channel Power
  Call ChnStatisticsChannelCalc(oChnPwr, eStatsSquareMean, 0, 0, False, False, False, "NameName")
  Call LogFileWrite("RMS of Power = " & oChnPwr.Properties("Result~Statistics~MeanValues~SquareMean").Value & " " & oChnPwr.UnitSymbol)

  'Clean up
  Set oChnRpm = Nothing: Set oChnTrq = Nothing: Set oChnPwr = Nothing
  
	bProcessDataPortal = True
End Function  'bProcessDataPortal()

What You Learned

• Nearly all of the DIAdem functionality may be access by a script.
• By using the SCRIPT recording mode, while performing a task in DIAdem, you can acquire what you need to assemble a script that can process other files with different channel content, and with minimal modifications.  
• The script VBScriptTemplate.VBS provided by this tutorial can be used as the base for creating a script that will either process what is in the Data Portal, or the NAVIGATOR search results.