Analysis Automation Procedure: General Information

Analysis Automation Procedure: General Information

Use Analysis Automation in SystemLink to execute recurring, comparative or parallel analyses with similar data. Analysis Automation can save result data in new TDM files and can export reports as PDF documents or graphics. Select Settings»SystemLink TDM»Analysis Automation Procedure to edit and create analysis automation configurations.

Use the Search Query step to define a search query in order to find the data from a test or on a specific topic. You process this data in the analysis script. An analysis automation task uses this search query for the DataFinder you assigned to the task. First, click Data filter enabled in the Search Query step to show the search input area and the search results list.

Use the Parameter Definition tab to define the parameters for the analysis. You specify the actual analysis in the analysis script. In the parameters, you can specify the settings for a function, such as the window used for an FFT, or the result folder. For each task you can assign different values to these parameters on the web interface of the analysis automation. This way you can execute the same analysis with different parameters. Use the transferred Context object to access the parameters within the analysis script.

Use the Analysis Script step to compile the analysis automation procedure.

In the central script Main.vbsa, you define the actual analysis. If Python is your evaluation environment, the script name is Main.py.

The analysis automation procedure must contain all files, such as layouts or more scripts, which you use in this analysis. The tree view in the lower part of the dialog box displays the files which are already in the analysis automation procedure. Use the respective buttons to import additional files or entire folders into the analysis automation procedure. During this process, the import creates a copy of the specified file and saves it in the analysis automation procedure. This means that you must first export a file from the analysis automation procedure in order to process it, and that you then must add this file to the analysis automation procedure again. In the process DIAdem replaces the previous file from the package.

The analysis script contains the procedures On_Initialize, On_RunAnalysisProcedure, and On_Finalize. Use On_Initialize and On_Finalize to initialize and complete a parallel procedure. Use On_Run_AnalysisProcedure to add user-defined program code with which the analysis automation procedure the elements from the search. The procedure is called several times in a parallel evaluation and only once in a comparative evaluation.

You can use virtually all DIAdem commands in the analysis script. However, you should avoid commands which require an interaction and also commands that control the DIAdem interface, the VIEW panel, Microsoft Office applications, or other applications. In the analysis script, you can record the error and analysis status of the transferred Context object and access the exchange variables. Click Edit in the Analysis Script step to edit the analysis script in the DIAdem script editor.

Save the analysis automation procedure configuration as an ANP file after you defined the analysis in the steps Search Query, Parameter Definition, and Analysis Script. Before loading this file into the web interface of Analysis Automation and executing it there, you should test the analysis with the respective functions in the DIAdem dialog box. To do so, use the Test Analysis Automation Procedure or Debug Analysis Automation Procedure buttons.

Note   DIAdem saves the analysis automation procedure during configuration even if you do not explicitly save it. Therefore, the analysis automation procedure should be editable when you load and display it. To prevent DIAdem from overwriting the original file, you should load and edit a copy of the analysis automation procedure. You can load and edit analysis automation procedures (*.anp) from older DIAdem versions in DIAdem 2019. Analysis automation procedures created or edited in DIAdem 2019 can be used in SystemLink TDM 2019 or later.

Note Microsoft does not support the server-side automation of Microsoft Office applications as client components, for example, with the CreateObject method. Office might become unstable in such an environment and applications may exclude each other. This does not only apply to Microsoft Office applications, but to all automation objects which require a user identification or which are designed for interaction with the desktop. Many applications issue success or error messages which need to be confirmed interactively. This is not possible with the server-side automation.

Related Topics

Buttons

Search Query | Parameter Definition | Analysis Script | Identification

Procedures

Define Data Preparation Procedure for TDMS Files | Define Data Preparation Procedure for XLSX Files | Defining the Configuration of an Analysis Automation Procedure | Definition of a SystemLink TDM Process Chain | Exploring Indexed Data with a Different Hierarchy View