Difference between revisions of "Batch Processing"

From BESA® Wiki
Jump to: navigation, search
Line 2: Line 2:
 
|title = Module information
 
|title = Module information
 
|module = BESA Research Basic or higher
 
|module = BESA Research Basic or higher
|version = 5.2 or higher
+
|version = BESA Research 5.2 or higher
 +
 
 
}}
 
}}
  
Line 72: Line 73:
  
 
Of course, many more options are available – check it out! For example, segments can automatically be sent to Source Analysis to perform automated imaging and export these results for further analysis, too.  
 
Of course, many more options are available – check it out! For example, segments can automatically be sent to Source Analysis to perform automated imaging and export these results for further analysis, too.  
More information on how to create batches can be found on our web site in [ftp://www.besa.de/be/besa.de/demonstrations_and_tutorials/BESA%20Research%20Tutorial%203%20-%20Batch%20Scripts%20-%20Multiple%20Subjects+Conditions%20-%20MATLAB%20interface.pdf Tutorial on Batch Scripts] – browse to section B.
 
  
 
[[Category:ERP/ERF]]
 
[[Category:ERP/ERF]]

Revision as of 15:02, 5 May 2021

Module information
Modules BESA Research Basic or higher
Version BESA Research 5.2 or higher

BESA batches allow you to automate nearly all analysis steps in BESA

The batch functionality that you find under the “Process” menu has been around for a while. Over the past few years, the toolkit that is available there has grown to an impressive size, such that with BESA Research 6.0, virtually all analysis steps can be automated, and applied to a list of files. At any point in time, the batch can also be halted to make parameter adjustments, should this be necessary. A complete analysis from pre-filtering, artifact scanning, averaging, source analysis, and export of results for subsequent statistical analysis, can be summarized in few steps. For many recurring tasks, ready-made batches are available already – and batches can also be assigned to function keys for maximum ease of use.

The set of available commands is shown below – sub-divided into

  • general commands which allow e.g. loops, error handling, or pausing the batch for user input
  • commands affecting the main program including ERP management
  • commands for discrete source analysis
  • commands for distributed source analysis
  • time-frequency commands


BatchMenu.jpg


For example, to automate averaging and to prepare data for statistical analysis, using an experimental paradigm for a number of subjects, a batch could have the following elements:

  • Load the paradigm
  • Perform an artifact scan
  • Average the conditions
  • Export the data of each condition for further analysis with BESA Statistics

In batch code, this will look like the following:

BatchExample.png


To add any command, e.g. “Average”, select the command from the list of commands and check the options dialog that appears:

BatchExampleAv.png

Left side: First click the "Add Command" button. Then select a command from the list. Right side: After selecting, a dialog opens where command options can be defined.

Once the batch is complete, it can run over all open files, over a user-defined file list (simply drag files into the list from Explorer), or just over the current file. Note that these batches are produced without entering any line of code by hand – it is all done using the graphical user interface of the Batch dialog.

An example batch for Averaging step by step

The first two commands will load the paradigm file and perform the artifact scan:

Paradigm(%Scripts%\Paradigm\Auditory\AEP_Intensity.PDG)
ArtifactScan(Wait)


BatchArtScan.png

The next command will average over the conditions:

Average(%basename%_av, %Examples%\ERP-Auditory-Intensity\Averages\, NoDefaultName,OverwriteTarget, NoCorrect)
BatchExampleAv2.png


The next commands will loop over the first 5 segments (condition averages) and export them to different ASCII files to be used in further processing in BESA Statistics or other programs:

MAINFileOpen(%Examples%\ERP-Auditory-Intensity\Averages\%basename%_av.fsg)
GENFor(segm, 1, 5, 1, 1)
MAINMarkBlock(WholeSegment,-,%segm%)
MAINExport(%basename%-export%segm%, \, Segment, ASCvec, Original, FiltOff, NoResample, Replace, -, )
GENEndFor()
BatchExampleAv3.png


Of course, many more options are available – check it out! For example, segments can automatically be sent to Source Analysis to perform automated imaging and export these results for further analysis, too.