Useful batches - Revision history

Jaehyun: Minor updates to the style of some text and images

2025-12-01T09:32:58Z

Minor updates to the style of some text and images

Harald at 16:23, 28 November 2025

2025-11-28T16:23:58Z

Harald at 15:50, 28 November 2025

2025-11-28T15:50:09Z

Harald at 07:23, 31 July 2025

2025-07-31T07:23:51Z

Harald at 07:22, 31 July 2025

2025-07-31T07:22:54Z

Harald at 08:11, 30 July 2025

2025-07-30T08:11:30Z

Harald at 14:32, 28 July 2025

2025-07-28T14:32:19Z

Harald at 14:29, 28 July 2025

2025-07-28T14:29:42Z

Harald at 14:18, 28 July 2025

2025-07-28T14:18:23Z

Harald: Created page with "This page lists a number of useful batches that you can try yourself. ==ECG correction== ===Batch name=== ECGCorrection.bbat ===What does it do?=== This batch is used for cor..."

2025-07-28T13:34:36Z

Created page with "This page lists a number of useful batches that you can try yourself. ==ECG correction== ===Batch name=== ECGCorrection.bbat ===What does it do?=== This batch is used for cor..."

New page

This page lists a number of useful batches that you can try yourself.
==ECG correction==
===Batch name===
ECGCorrection.bbat

===What does it do?===
This batch is used for correcting ECG artifacts. It is particularly useful for MEG data. It should be called before creating an MEG source montage.

===How to use it===
Load a data set that contains an ECG channel, or a clear manifestation of the ECG artifact. Make sure that the channel label of this channel is visible at the left (if not, adjust the montage, or change displayed channel types using the buttons at the top right, until you can see it).
Run the batch. The batch will ask you to set a cursor on the peak of the signal, and mark the channel if possible. It will then mark a number of occurrences and use tag #2 to collect the average ECG signal. This will then be used as an artifact topography for an adaptive artifact correction with minimum distortion of signal of interest.

==Create an MEG source montage==
===Batch name===
CreateMEGSourceMtg.bbat
CreateGRDSourceMtg.bbat

===What does it do?===
This batch is used for creating an MEG source montage, taking an existing artifact correction for ECG artifacts into account. The batch creates a magnetometer-based [gradiometer-based] source montage with 29 montage channels. Each channel has two orientations. Thus, a maximum of 58 source waveforms will be displayed. The waveforms depict the signal originating from the brain region underlying the head position indicated by the channel label (e.g. F3L will be a brain region underneath the location of the F3 channel from the 10-10 nomenclature).

===How to use it===
It is recommended to first run ECGCorrection.bbat, or create an ECG artifact topography manually. Then run the batch.
The batch CreateMEGSourceMtg creates a 29-channel source montage based on magnetometers or axial gradiometers. In case that planar gradiometers should be used, please use the batch CreateGRDSourceMtg.bbat.
After finalization, the number of source waveforms displayed can be adjusted using the button “Opt” – either use Regional Source oriented, or Regional Source all.

==Moving dipole fit==
===Batch name===
MovingDipole11Dips_Minus20ToPeak.bbat
Additional file: TenDipBlue.bsa

===What does it do?===
This batch is intended to be used on epileptic spike averages. It performs a single dipole fit for each time point between 20 ms before the spike peak to the peak, in 2 ms steps. It displays the result in the 3D MRI view of the subject.

===How to use it===
As a pre-requisite, the associated solution file “TenDipBlue.bsa” needs to be copied to the folder “C:\Users\Public\Documents\BESA\Research_7_1\Scripts\ColorSchemes”.
An averaged segment containing an epileptic spike should be loaded. It is assumed that the spike maximum lies at the zero latency point of the segment (indicated by a dotted line in the review display).
Before running the batch, check the filter settings: For epileptic spikes, we recommend setting a low cutoff of 3 Hz forward filter with 6dB, and a high cutoff of 35 Hz zero-phase with 24 dB.
Run the batch and follow the instructions when prompted. The result is automatically saved in a solution file (file basename followed by “_MovDip_minus20_to_peak.bsa”).

==Dipole cluster fit==
===Batch name===
ClusterDipoleFit.bbat

===What does it do?===
For a number of segments of single events, the batch performs a dipole fit in each segment, and displays the result as a cluster in the 3D MRI view of the subject.

===How to use it===
As a prerequisite, you will need a segmented file that contains segments of single events of equal size. In order to get this, you can use the menu “File / Export”, then select “Epochs around triggers”, then press the button “Triggers” where you can define which trigger(s) to use (you can also use conditions that you defined in the ERP module).

The interval can be adjusted with the “Interval” button. The batch will expect at least 100 ms before and more than 100 ms after the event time point.
Run the export, and re-load the exported file.
Before running the batch, check the filter settings: For epileptic spikes, we recommend setting a low cutoff of 3 Hz forward filter with 6dB, and a high cutoff of 35 Hz zero-phase with 24 dB.
Now, start the batch. You will be asked to supply the latency at which the fit should be performed. Then, all segments will be processed (up to a maximum of 50 segments).

@@ Line 8: / Line 8: @@
 ==Download the batch files==
-Download and unzip the following files into your folder C:\Users\Public\Documents\BESA\Research_7_1\Scripts\Batch\ (you may need to replace ''C:\Users\Public\Documents\'' with the equivalent Public Documents folder on your computer).
+Download and unzip the following files into your folder ''C:\Users\Public\Documents\BESA\Research_7_1\Scripts\Batch\'' (you may need to replace ''C:\Users\Public\Documents\'' with the equivalent Public Documents folder on your computer).
-Then move the file ''TenDipBlue.bsa'' to the folder C:\Users\Public\Documents\BESA\Research_7_1\Scripts\ColorSchemes\ (you may need to replace ''C:\Users\Public\Documents\'' with the equivalent Public Documents folder on your computer).
+Then move the file ''TenDipBlue.bsa'' to the folder ''C:\Users\Public\Documents\BESA\Research_7_1\Scripts\ColorSchemes\'' (you may need to replace ''C:\Users\Public\Documents\'' with the equivalent Public Documents folder on your computer).
 [https://github.com/BESA-GmbH/BESA-Research-Batches/releases/latest/download/BesaResearch_Batches.zip Download batches]
@@ Line 44: / Line 44: @@
 ==Moving dipole fit==
 ===Batch name===
-MovingDipole11Dips_Minus20ToPeak.bbat
+''MovingDipole11Dips_Minus20ToPeak.bbat''
-Additional file: TenDipBlue.bsa
+Additional file: ''TenDipBlue.bsa''
 ===What does it do?===
@@ Line 52: / Line 52: @@
 ===How to use it===
-As a pre-requisite, the associated solution file “TenDipBlue.bsa” needs to be copied to the folder “C:\Users\Public\Documents\BESA\Research_7_1\Scripts\ColorSchemes”.
+As a pre-requisite, the associated solution file ''TenDipBlue.bsa'' needs to be copied to the folder ''C:\Users\Public\Documents\BESA\Research_7_1\Scripts\ColorSchemes''.
 An averaged segment containing an epileptic spike should be loaded. It is assumed that the spike maximum lies at the zero latency point of the segment (indicated by a dotted line in the review display).
@@ Line 58: / Line 58: @@
 Before running the batch, check the filter settings: For epileptic spikes, we recommend setting a low cutoff of 3 Hz forward filter with 6dB, and a high cutoff of 35 Hz zero-phase with 24 dB.
-Run the batch and follow the instructions when prompted. The result is automatically saved in a solution file (file basename followed by “_MovDip_minus20_to_peak.bsa”).
+Run the batch and follow the instructions when prompted. The result is automatically saved in a solution file (file basename followed by ''_MovDip_minus20_to_peak.bsa'').
 ==Dipole cluster fit==
 ===Batch name===
-ClusterDipoleFit.bbat
+''ClusterDipoleFit.bbat''
 ===What does it do?===
@@ Line 71: / Line 71: @@
 The interval can be adjusted with the “Interval” button. The batch will expect at least 100 ms before and more than 100 ms after the event time point.
 [[File:ExportMask.png]]
@@ Line 82: / Line 83: @@
 ==Create discrete solution from source image==
 ===Batch name===
-CreateSourcesFromImageEEG.bbat
+''CreateSourcesFromImageEEG.bbat''
 CreateSourcesFromImageMEG.bbat
 ===What does it do?===
@@ Line 92: / Line 94: @@
 The batch should then be called directly from the BESA Source Analysis window, using the menu Fit / Run Batch.
 It will ask for the number of maxima in the image, which you can read from the title bar of the 3D window. Then it will create the solution and ensure that orientations are fitted correctly.
 [[File:2025_11_Sesame1.png]]
-[[File:2025_11_Sesame2.png]]
+<div><ul>
 [[Category:Batches]]

@@ Line 92: / Line 92: @@
 The batch should then be called directly from the BESA Source Analysis window, using the menu Fit / Run Batch.
 It will ask for the number of maxima in the image, which you can read from the title bar of the 3D window. Then it will create the solution and ensure that orientations are fitted correctly.
+[[File:2025_11_Sesame1.png]]
 [[Category:Batches]]

← Older revision		Revision as of 15:50, 28 November 2025
Line 80:		Line 80:
	Now, start the batch. You will be asked to supply the latency at which the fit should be performed. Then, all segments will be processed (up to a maximum of 50 segments).		Now, start the batch. You will be asked to supply the latency at which the fit should be performed. Then, all segments will be processed (up to a maximum of 50 segments).

		+	==Create discrete solution from source image==
		+	===Batch name===
		+	CreateSourcesFromImageEEG.bbat
		+	CreateSourcesFromImageMEG.bbat
		+
		+	===What does it do?===
		+	After a source image has been computed, this batch (with EEG in the name for an EEG image, or with MEG in the name for an MEG image) will create a new discrete solution, add the sources from the maxima of the source image, and fit their orientation within the current fit interval.
		+
		+	===How to use it===
		+	As a prerequisite, you will need to compute a source image in the Source Analysis window.
		+	The batch should then be called directly from the BESA Source Analysis window, using the menu Fit / Run Batch.
		+	It will ask for the number of maxima in the image, which you can read from the title bar of the 3D window. Then it will create the solution and ensure that orientations are fitted correctly.
		+

	[[Category:Batches]]		[[Category:Batches]]

@@ Line 10: / Line 10: @@
 Download and unzip the following files into your folder C:\Users\Public\Documents\BESA\Research_7_1\Scripts\Batch\ (you may need to replace ''C:\Users\Public\Documents\'' with the equivalent Public Documents folder on your computer).
-Then move the file TenDipBlue.bsa to the folder C:\Users\Public\Documents\BESA\Research_7_1\Scripts\ColorSchemes\ (you may need to replace ''C:\Users\Public\Documents\'' with the equivalent Public Documents folder on your computer).
+Then move the file ''TenDipBlue.bsa'' to the folder C:\Users\Public\Documents\BESA\Research_7_1\Scripts\ColorSchemes\ (you may need to replace ''C:\Users\Public\Documents\'' with the equivalent Public Documents folder on your computer).
 [https://github.com/BESA-GmbH/BESA-Research-Batches/releases/latest/download/BesaResearch_Batches.zip Download batches]

@@ Line 67: / Line 67: @@
 Before running the batch, check the filter settings: For epileptic spikes, we recommend setting a low cutoff of 3 Hz forward filter with 6dB, and a high cutoff of 35 Hz zero-phase with 24 dB.
 Now, start the batch. You will be asked to supply the latency at which the fit should be performed. Then, all segments will be processed (up to a maximum of 50 segments).
@@ Line 72: / Line 73: @@
 ==Download the batch files==
 Download and unzip the following files into your folder C:\Users\Public\Documents\BESA\Research_7_1\Scripts\Batch. Then move the file TenDipBlue.bsa to the folder C:\Users\Public\Documents\BESA\Research_7_1\Scripts\ColorSchemes
-[[File:Batches.zip]]
+[[File:Batches_BR71.zip]]
 [[Category:Batches]]

@@ Line 6: / Line 6: @@
 This page lists a number of useful batches that you can try yourself.
 ==ECG correction==
 ===Batch name===
@@ Line 71: / Line 80: @@
 Now, start the batch. You will be asked to supply the latency at which the fit should be performed. Then, all segments will be processed (up to a maximum of 50 segments).
 [[Category:Batches]]

@@ Line 2: / Line 2: @@
 ==ECG correction==
 ===Batch name===
-ECGCorrection.bbat
+''ECGCorrection.bbat''
 ===What does it do?===
@@ Line 13: / Line 13: @@
 ==Create an MEG source montage==
 ===Batch name===
-CreateMEGSourceMtg.bbat
+''CreateMEGSourceMtg.bbat''
-CreateGRDSourceMtg.bbat
+''CreateGRDSourceMtg.bbat''
 ===What does it do?===
 This batch is used for creating an MEG source montage, taking an existing artifact correction for ECG artifacts into account. The batch creates a magnetometer-based [gradiometer-based] source montage with 29 montage channels. Each channel has two orientations. Thus, a maximum of 58 source waveforms will be displayed. The waveforms depict the signal originating from the brain region underlying the head position indicated by the channel label (e.g. F3L will be a brain region underneath the location of the F3 channel from the 10-10 nomenclature).
 ===How to use it===
-It is recommended to first run ECGCorrection.bbat, or create an ECG artifact topography manually. Then run the batch.
+It is recommended to first run ''ECGCorrection.bbat'', or create an ECG artifact topography manually. Then run the batch.
-The batch CreateMEGSourceMtg creates a 29-channel source montage based on magnetometers or axial gradiometers. In case that planar gradiometers should be used, please use the batch CreateGRDSourceMtg.bbat.
+The batch ''CreateMEGSourceMtg'' creates a 29-channel source montage based on magnetometers or axial gradiometers. In case that planar gradiometers should be used, please use the batch ''CreateGRDSourceMtg.bbat''.
 After finalization, the number of source waveforms displayed can be adjusted using the button “Opt” – either use Regional Source oriented, or Regional Source all.
@@ Line 28: / Line 30: @@
 ===Batch name===
 MovingDipole11Dips_Minus20ToPeak.bbat
 Additional file: TenDipBlue.bsa
@@ Line 35: / Line 38: @@
 ===How to use it===
 As a pre-requisite, the associated solution file “TenDipBlue.bsa” needs to be copied to the folder “C:\Users\Public\Documents\BESA\Research_7_1\Scripts\ColorSchemes”.
 An averaged segment containing an epileptic spike should be loaded. It is assumed that the spike maximum lies at the zero latency point of the segment (indicated by a dotted line in the review display).
 Before running the batch, check the filter settings: For epileptic spikes, we recommend setting a low cutoff of 3 Hz forward filter with 6dB, and a high cutoff of 35 Hz zero-phase with 24 dB.
 Run the batch and follow the instructions when prompted. The result is automatically saved in a solution file (file basename followed by “_MovDip_minus20_to_peak.bsa”).
@@ Line 47: / Line 53: @@
 ===How to use it===
-As a prerequisite, you will need a segmented file that contains segments of single events of equal size. In order to get this, you can use the menu “File / Export”, then select “Epochs around triggers”, then press the button “Triggers” where you can define which trigger(s) to use (you can also use conditions that you defined in the ERP module).
+As a prerequisite, you will need a segmented file that contains segments of single events of equal size. In order to get this, you can use the menu “''File / Export''”, then select “''Epochs around triggers''”, then press the button “''Triggers''” where you can define which trigger(s) to use (you can also use conditions that you defined in the ERP module).
 The interval can be adjusted with the “Interval” button. The batch will expect at least 100 ms before and more than 100 ms after the event time point.
@@ Line 53: / Line 59: @@
 Run the export, and re-load the exported file.
 Before running the batch, check the filter settings: For epileptic spikes, we recommend setting a low cutoff of 3 Hz forward filter with 6dB, and a high cutoff of 35 Hz zero-phase with 24 dB.
 Now, start the batch. You will be asked to supply the latency at which the fit should be performed. Then, all segments will be processed (up to a maximum of 50 segments).