For functional multiplex data, you will upload a folder containing the functional files for different subjects, and different layers, that belong to the same group. For example, the functional multiplex values could correspond to brain activation signals derived from functional MRI data at different frequencies or time windows. Later, a connectivity matrix will be computed for each layer using correlations in functional values between each pair of brain regions. This tutorial explains how to prepare and work with this kind of data.
Figure 1. GUI for a group of subjects with functional multiplex data Full graphical user interface to upload a group with functional multiplex data in BRAPH 2.
Generation of Example Data ⬆
If you do not have the "Example data FUN_MP XLS" folder inside "functional multiplex", then you can generate it by running the commands in Code 1.
Code 1. Code to generate the example data folder. This code can be used in the MatLab command line to generate the "Example data FUN_MP XLS" folder to the "functional multiplex" pipeline folder.
create_data_FUN_MP_XLS() ① create_data_FUN_MP_TXT() ②① generates the example functional multiplex XLS data folder.
② generates the example functional multiplex TXT data folder.
Open the GUI ⬆
In most analyses, the group GUI is the second step after you have selected a brain atlas. You can open it by typing braph2 in MatLab's terminal, which allows you to select a pipeline containing the steps required to perform your analysis and upload a brain atlas. After these steps have been completed you can upload your group's data directly (Figure 2c-f) after clicking "Load Group".
Figure 2. Upload the data of a group of subjects Steps to upload a group of subjects with functional multiplex data using the GUI and an example dataset: a Open the group GUI. b Import the folder with the functional multiplex files in XLS or TXT format (see below for details on their format). To upload the test functional multiplex data: c-f navigate to the BRAPH 2 folder "pipelines", d "functional multiplex", e "Example data FUN_MP XLS", and f select the folder with functional multiplex values of one group "FUN_MP_Group_1_XLS".
GUI launch from command line You can also open the GUI and upload the brain functional multiplex data using the command line (i.e., without opening an analysis pipeline) by typing the commands in Code 2. In this case, you can upload the data as shown in Figure 2a-f.
Code 2. Code to launch the GUI to upload a group of subjects with functional multiplex data. This code can be used in the MatLab command line to launch the GUI to upload a group of subjects with functional multiplex data without having to open a pipeline.
gr = Group('SUB_CLASS', 'SubjectFUN_MP'); gui = GUIElement('PE', gr); gui.get('DRAW') gui.get('SHOW')
Visualize the Group Data ⬆
After completing the steps described in Figure 2, you can see the data (Figure 3a), and change the Group ID, name, and notes (Figure 3b).
Figure 3. Edit the group metadata a The GUI of the group's functional multiplex data. b The information you see on this GUI that can be changed. In this example, we have edited the ID, name, and notes of the group but can also change the subject's specific information.
Visualize Each Subject's Data ⬆
Finally, you can open each subject's functional multiplex values by selecting the subject, right click, and select "Open selection" (Figure 4a), which shows the functional values from layer 1 (Figure 4b). Here, you can also change the subject's metadata (ID, label, notes), its variables of interest, and the functional multiplex values.
Figure 4. Edit the individual subject data a Each subject's functional multiplex values can be opened by selecting the subject, right click, and select "Open selection" b In this subject GUI, it is possible to view and edit the metadata of the subject (ID, label, notes), its variables of interest (in this case, age and sex), and the functional multiplex values.
Preparation of the Data to Be Imported ⬆
To be able to import functional multiplex data into BRAPH 2, you need to include the functional values of each layer for all subjects in a single file in excel or text format. All functional layers' files should be inside one group folder. Below you can see how this file should look like.
Figure 5. Data preparation The data should be organised in the following format: a The functional values of one layer from each subject belonging to the same group should be included in a single file (for example, "FUN_MP_Group_1_xlsx"). b This file should contain the subject's IDs, label and any relevant notes, followed by the functional values for each brain region belonging to a brain atlas. In this example, the (simulated) values correspond to brain activation signals of 90 brain regions derived from functional MRI.
Adding Covariates ⬆
It is very common to have variables of interest (i.e., covariates and correlates) in an analysis. In BRAPH 2, these variables of interest should be included in a separate excel file placed just outside the group's folder and with the same name as the folder followed by ".vois" (Figure 6a). This file should have a specific format (Figure 6b):
-
Subject IDs (column A). Column A should contain the subject IDs starting from row 3.
-
Variables of interest (column B and subsequent columns). Column B (and subsequent columns) should contain the variables of interest (one per column). In this example we have "Age" and "Sex", as in the example file, as well as the additional "Education". In each column, row 1 should contain the name of the variable of interest, row 2 should contain the categories separated by a return (only for categorical variables of interest, like "Sex" and "Education"), and the subsequent rows the values of the variable of interest for each subject.
Figure 6. Edit the Covariates Information that can be changed in the Covariates file: a The values of the variables of interest (vois). b In case the vois are categorical, you can state which categories they have.