Difference between revisions of "How to Convert BESA Connectivity results for BESA Statistics"
From BESA® Wiki
(→Prepare data for BESA Statistics) |
(→Note and general remarks) |
||
| (10 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
{{BESAInfobox | {{BESAInfobox | ||
|title = Module information | |title = Module information | ||
| − | |module = BESA Connectivity, BESA Statistics | + | |module = BESA Connectivity, BESA Statistics |
|version = 1.0 or higher (BC), 2.0 or higher (BS) | |version = 1.0 or higher (BC), 2.0 or higher (BS) | ||
}} | }} | ||
== Note and general remarks== | == Note and general remarks== | ||
| − | Connectivity results exported from BESA Connectivity 1.0 (or higher) can be imported in BESA Statistics 2.0 (or higher) to perform statistical permutation testing. To be able to read the connectivity matrices that are exported to disc as ''*.conn'' files, the format and the extension of the data files need to be changed to enable reading them in BESA Statistics. | + | |
| + | Connectivity results exported from BESA Connectivity 1.0 (or higher) can be imported in BESA Statistics 2.0 (or higher) to perform statistical permutation testing. | ||
| + | |||
| + | * In '''BESA Statistics 2.1''' (or higher), exported connectivity results can directly be read - no conversion procedure is necessary. | ||
| + | ** <span style="color: red">Note for '''BESA Statistics 2.1 November 2020'''</span>: When the BESA connectivity file format (*.conn) is used in BESA Statistics, the order of the time-frequency plots (the grid view of connectivity results) in "Set Parameter" and "Perform Statistics" workflow steps is not the same as that of BESA Connectivity. Because the upper and lower diagonal parts of plots are flipped, the meaning of the label in each plot in BESA Statistics should be interpreted as the following example: <span style="color: red">A label "Ch1-Ch2" means "information flow from Ch2 to Ch1"</span>. | ||
| + | * In '''BESA Statistics 2.0''': To be able to read the connectivity matrices that are exported to disc as ''*.conn'' files, the format and the extension of the data files need to be changed to enable reading them in BESA Statistics. | ||
== Export connectivity results in BESA Connectivity == | == Export connectivity results in BESA Connectivity == | ||
| Line 14: | Line 19: | ||
Connectivity matrices are stored to disc as ''*.conn'' files. BESA provides scripts to import these files into Matlab for further analysis. The scripts can be downloaded from the following page on the BESA website: [http://www.besa.de/downloads/matlab/ MATLAB Scripts] | Connectivity matrices are stored to disc as ''*.conn'' files. BESA provides scripts to import these files into Matlab for further analysis. The scripts can be downloaded from the following page on the BESA website: [http://www.besa.de/downloads/matlab/ MATLAB Scripts] | ||
| − | == Prepare data for BESA Statistics == | + | == Prepare data for BESA Statistics 2.0 == |
| + | |||
| + | In order to be able to import connectivity matrices into BESA Statistics 2.0, it is necessary to convert ''*.conn'' files exported from BESA Connectivity to ''*.tfc'' files which can be read by BESA Statistics. The <code>BESA_Connectivity_to_BESA_Statistics.m</code> script will perform the required conversion (download available here: [https://github.com/BESA-GmbH/BESA-MATLAB-Scripts/releases/latest/download/BesaConnectivityScripts.zip BESA Connectivity Scripts]). The connectivity results in BESA Statistics will be displayed in the same ''matrix view'' as in BESA Connectivity without the normalized power-spectra density that is shown on the diagonal on BESA Connectivity. | ||
| − | + | <gallery widths=500px heights=400px mode="nolines"> | |
| + | Image:BESA Statisitics - Read Results from BESA Connectivity.png| BESA Statistics | ||
| + | Image:BESA Connectivity - Export Data for BESA Statistics.png| BESA Connectivity | ||
| + | </gallery> | ||
| + | [[Category:Connectivity]] [[Category:Statistics]] | ||
| − | |||
| − | + | <!--'''Caveat''': Since all channels are compared with all channels, the amount of data rises very quickly. For the version 2.0 of BESA Statistics, it is advised to restrict the number of channels in the source montage to not more than approximately 10-15. | |
| + | This restriction will be lifted with the next version of BESA Statistics. --> | ||
Latest revision as of 15:20, 23 January 2023
| Module information | |
| Modules | BESA Connectivity, BESA Statistics |
| Version | 1.0 or higher (BC), 2.0 or higher (BS) |
Note and general remarks
Connectivity results exported from BESA Connectivity 1.0 (or higher) can be imported in BESA Statistics 2.0 (or higher) to perform statistical permutation testing.
- In BESA Statistics 2.1 (or higher), exported connectivity results can directly be read - no conversion procedure is necessary.
- Note for BESA Statistics 2.1 November 2020: When the BESA connectivity file format (*.conn) is used in BESA Statistics, the order of the time-frequency plots (the grid view of connectivity results) in "Set Parameter" and "Perform Statistics" workflow steps is not the same as that of BESA Connectivity. Because the upper and lower diagonal parts of plots are flipped, the meaning of the label in each plot in BESA Statistics should be interpreted as the following example: A label "Ch1-Ch2" means "information flow from Ch2 to Ch1".
- In BESA Statistics 2.0: To be able to read the connectivity matrices that are exported to disc as *.conn files, the format and the extension of the data files need to be changed to enable reading them in BESA Statistics.
Export connectivity results in BESA Connectivity
For exporting connectivity results in BESA Connectivity, please refer to Export Connectivity Results.
Connectivity matrices are stored to disc as *.conn files. BESA provides scripts to import these files into Matlab for further analysis. The scripts can be downloaded from the following page on the BESA website: MATLAB Scripts
Prepare data for BESA Statistics 2.0
In order to be able to import connectivity matrices into BESA Statistics 2.0, it is necessary to convert *.conn files exported from BESA Connectivity to *.tfc files which can be read by BESA Statistics. The BESA_Connectivity_to_BESA_Statistics.m script will perform the required conversion (download available here: BESA Connectivity Scripts). The connectivity results in BESA Statistics will be displayed in the same matrix view as in BESA Connectivity without the normalized power-spectra density that is shown on the diagonal on BESA Connectivity.
BESA Statistics
BESA Connectivity
