Differences between revisions 60 and 92 (spanning 32 versions)

Tutorial xx: Connectivity Graphs

Authors: Yaqi Li, Helen Lin

This tutorial will guide the user through the usage of all the features available in the connectvity visualization tool. This tool displays functional connectivity data in the form of a 'graph' suited for human understanding. For a theoretical background on functional connectivity, please refer to

Contents

Loading Connectivity Graphs
Connectivity graph structure
Camera View
Filtering Options
Colormap
Display Options
Region Links
Node and region selection through the popup menu
Node and region selection with mouse clicks
Link selection
Keyboard shortcuts
Saving the figure as image
Summary of features

Loading Connectivity Graphs

We will begin this tutorial by loading a connectivity graph. Please go through the following steps:

1. Drag the selected raw file into the process block. Ensure the "Process Sources" is selected on the left-hand side.

2. In the pipeline editor select "Connectivity", and choose the type of connectivity you would like to load. In this tutorial, we will begin with a Correlation N x N graph.

3. Next, ensure that the scout function is applied Before. You may also choose a desired atlas. To do so, ensure that the "Use scouts" option at the top left is selected. The atlases can be found in the drop down menu shown on the top right. For this tutorial, choose "Mindboogle".

4. Once loaded, you should see the graph being listed under the raw file. Right-click on the graph and select "". The graph should appear on your screen shortly.

The steps in the following sections will guide you through the display options available in this tool.

Connectivity graph structure

In this visualization tool, the connectivity scores from the connectivity matrix are shown as links drawn between regions of interest. As shown in the previous figure, these regions of interests are displayed as nodes are labeled along the circumference of the graph. They are grouped in their respective lobes (such as "Frontal", "Cerebral", etc. shown in the figure above) and hemispheres (i.e., left and right hemisphere). Connections are represented by coloured lines. Connectivity scores are represent through a colormap, which you can see in the colorbar on the bottom right of the figure.

The graph used throughout this tutorial is built with the Mindboogle brain atlas, which generates the labeled nodes shown in the previous figure above. Note that the lobe and node structure will vary according to the atlas selected by the user.

Camera View

The mouse wheel can be used to zoom-in and zoom-out on the figure. Dragging the mouse while maintaining a left click also allows you to move the figure on your screen. The following steps will guide you through these options.

1. Move your mouse wheel to zoom-in and zoom-out. Below is an example of the figure being zoomed out.

2. Now, press SHIFT and left click anywhere on the figure. Move the mouse while maintaining the mouse click and the SHIFT key pressed to drag the figure around. This camera feature allows you to focus on one area of interest in the figure.

Filtering Options

The following options are available in the display panel:

Intensity Threshold
Distance Filtering
Direction (for directional graphs only)
Anatomy

1. You have the option to adjust the minimum intensity threshold, which is the minimum connectivity score that will be displayed on your graph. Move this slider to the left. You should see more connectivity links appear.

2. Similarly, you may also adjust the distance filtering slider. This related to the minimum physical distance between two nodes of interest.

3. For directional graphs, users have the option to display only Inward ("In"), Outward ("Out") or bidirectional ("Bi") links by clicking on the desired option. When the "In" or the "Out" option is selected, you will only see one arrowhead for each link, indicating the directionality of the associated connectivity score.

Now, select "Bi". You should see two arrowheads appear on each link. Links are labeled as "bidirectional" when both links between a pair of nodes are displayed.

NOTE: Note that this option is not available for non-directional graphs. Arrowheads also do not appear in non-directional graphs. Below is an example of a non-directional coherence graph.

4. The Anatomy option allows you to display only links between 2 different hemispheres or between 2 different lobes. Select the "Between Lobes" option.

5. Spectral graphs, such as this one, have a frequency slider above the display panel. In such gaphs, connectivity scores are computed at each frequency point. Move this slider, and notice the graph being reloaded with new connections.

Colormap

Connectivity scores are represent through a colormap, as you can see in the colorbar on the bottom right of the figure.

1. Right-click on the graph. A popup-menu with options will appear.

2. Click on the "Colormap" option. This allows you to select a desired colormap, and to adjust other features, such as contrast and brightness from the options shown in the figure below.

3. In the figure, left-click on the colorbar and move your mouse up and down while keeping the mouse click. This is identical to adjusting the "brightness" directly through the popup menu.

4. Now, drag your mouse horizontally while keeping the mouse click on the colorbar. This allows you to adjust the contrast, which can also be adjusted through the popup menu.

5. The "Restore defaults" option in the popup menu allows you to revert to the default options.

Display Options

The graphical appearance of the graph can be adjusted according to the user's preferences.

1. In the popup menu, select "Display options".

2. Lobe labels are displayed with their full names by default. However, you have the option to display them in their abbreviated forms. Try toggling this option.

3. Scout labels and region labels can be hidden if the corresponding option is toggled.

4. Finally, the "Show labels for selection only" allows you to display labels only for the nodes that have been selected. Node selection is explain in the section xxx.

5. The size of the nodes and labels can be adjusted with the "" slider. This can be particularly useful when labels may be overlapping with some atlases.

6. Similarly, the size of the links displayed can be adjusted via the corresponding slider.

7. The "Links transp" slider allows you to adjust the transparency of the links displayed. Links are opaque when it is set to 0%, and fully transparent when it is set to 100%.

8. The "White background" option allows you to change the background color from black to white, and vice-versa. It can be particularly useful when saving a copy of the figure. The figure below shows an example with a white background and enlarged links.

9. Display options can be reset to their default values by selecting "Reset display options".

Region Links

In Brainstorm, connectivity links between lobes (i.e., region links) can also be displayed. Region Max links represent the largest connectivity scores computed to or from nodes belonging to a particular lobe, while Region Mean links represent the average connectivity score of all nodes belonging to a particular lobe of interest.

1. In the popup menu, select the "Display region max" option. You should see connectivity links drawn between lobe nodes, as shown in the following figure.

The same display options apply to region links.

2. Next, select "Choose region function" in the popup menu and select "Mean". If no links appear on the graph, reduce the intensity threshold.

This option allows you to toggle between region max, region mean, and measure links.

Node and region selection through the popup menu

This tool provides users with the option to display only links belonging to a particular set of nodes of interest.

1. In the popup menu, click on "Select next region". You should see all nodes belonging to one particular lobe being selected, while all other nodes become unselected. When a region of interest is selected, only nodes belonging to it appear as filled markers, while other nodes will be displayed with a 'x' marker and have their labels greyed out. The region being selected depend on the atlas selected. An example is shown below. Here, the right hemisphere is selected.

2. Click on "Select next region" again. You should see another region being selected. Continue doing so a few more times - the program will keep iterating through the different hemispheres, lobes and then the measure nodes.

3. Click on "Select previous region". The program will iterate through the regions in the opposite order.

4. Now, click on "Select all" in the popup menu. You should see all nodes being selectd, and all links being displayed.

Node and region selection with mouse clicks

Users also have the possibility to select specific nodes, lobes or hemispheres of interest through mouse clicks so as to only display links related to them. Again, when a region of interest is selected, only nodes belonging to it appear as filled markers, while other nodes will be displayed with a 'x' marker and have their labels greyed out.

1. Left click on a lobe of interest, or its associated label. For example, the figure below shows that appears when the temporal lobe on the right is selected.

2. Left click on the same lobe again to unselect it.

3. Now, left click on a hemisphere of your choice. You may click on either the node marker or on its associated label.

4. Lastly, left click on a node (or its label) along the circumference of the graph. You should only see links associated with this node. Do not unselect that node.

5. Now, click on another node of your choice while pressing SHIFT on your keyboard. Pressing SHIFT allows you to select multiple regions of interest. You should therefore observe multiple nodes being selected. If you do not have the SHIFT key pressed, the previously selected node will automatically become unselected when another one is selected.

The figure below shows an example with a lobe and 2 other nodes being selected at the same time.

Link selection

Connectivity links of interest can also be selected temporarily. When selected, the link size is increased, and the labels associated with the two nodes being connected become bold and enlarged. This occurs while the user maintains a left mouse click on the link, or on an arrowhead in the case of directional graphs. Elements return to their original sizes when the mouse click is released. This user-interactive feature allows you to easily visualize and gain key information regarding connections of interest.

1. In the graph, left click on one link and maintain the mouse click. An example is shown in the figure below.

Here, we see that the link between the left entorhinal node and the right isthmuscingulate node has been selected.

2. Release your mouse click. Elements now return to their original size.

3. Now, maintain a mouse click on an arrowhead. Its associated link should be selected.

Keyboard shortcuts

Options appearing in the popup menu can also be toggled or selected with various keyboard shortcuts indicated to their right. The SHIFT key must be pressed on the keyboard. For example, pressing SHIFT + "H" on your keyboard allows you to hide region nodes and pressing SHFT + "M" allows you to display the region links.

Experiment with these keyboard shortcuts.

Saving the figure as image

In the popup menu, click on the "Snapshot" option. This feature allows you to save the figure as an image locally, and to reuse it later. When clicking on the "Save as image" option, you may select a specific location on your local device.

Summary of features

You have now reviewed all feature of this visualization tool.

The following table summarizes all the user-interactive features available in this tool. * Features highlighted in blue are also accessible in the popup menu.

Table 1. Summary of features.

-  ⇤ ← Revision 60 as of 2021-04-03 20:59:27 → 
  Size: 11319
  Editor: ?Yaqi Li
  Comment:
+   ← Revision 92 as of 2021-04-08 23:43:25 → ⇥
  Size: 13442
  Editor: ?Yaqi Li
  Comment:
-Deletions are marked like this.
+Additions are marked like this.
 Line 1:
-last edit: Apr. 3, 2021 by Yaqi
-Line 4:
+Line 2:
+''Authors: Yaqi Li, Helen Lin''

<<BR>>

This tutorial will guide the user through the usage of all the features available in the connectvity visualization tool. This tool displays functional connectivity data in the form of a 'graph' suited for human understanding. For a theoretical background on functional connectivity, please refer to <<GoTo>>.

<<TableOfContents(2,2)>>
-Line 5:
+Line 11:
+We will begin this tutorial by loading a connectivity graph. Please go through the following steps:

<<BR>>
-Line 9:
+Line 19:
+<<BR>>
-Line 13:
+Line 25:
-. Next, ensure that the '''scout function is applied Before.''' You may also choose a desired atlas. For this tutorial, choose Mindboogle.
+<<BR>>

3. Next, ensure that the '''scout function is applied Before.''' You may also choose a desired '''atlas'''. To do so, ensure that the "Use scouts" option at the top left is selected. The atlases can be found in the drop down menu shown on the top right. For this tutorial, choose "Mindboogle".
-Line 17:
+Line 31:
+<<BR>>
-Line 21:
+Line 37:
-. The steps in the following sections will guide you through the display options available in this tool.
+<<BR>>

The steps in the following sections will guide you through the display options available in this tool.

<<BR>>
-Line 24:
+Line 44:
-As shown in the previous figure, nodes are labeled along the circumference of the graph. Connections are represented by coloured lines. Connectivity scores are represent through a colormap, which you can see in the colorbar on the bottom right of the figure.
+In this visualization tool, the connectivity scores from the connectivity matrix are shown as links drawn between regions of interest. As shown in the previous figure, these regions of interests are displayed as nodes are labeled along the circumference of the graph. They are grouped in their respective lobes (such as "Frontal", "Cerebral", etc. shown in the figure above) and hemispheres (i.e., left and right hemisphere). Connections are represented by coloured lines. Connectivity scores are represent through a colormap, which you can see in the colorbar on the bottom right of the figure.

<<BR>>

The graph used throughout this tutorial is built with the Mindboogle brain atlas, which generates the labeled nodes shown in the previous figure above. Note that the lobe and node structure will vary according to the atlas selected by the user.

<<BR>>
-Line 29:
+Line 55:
+<<BR>>
-Line 33:
+Line 61:
+<<BR>>
-Line 34:
+Line 64:
+<<BR>>
-Line 45:
+Line 77:
+<<BR>>
-Line 49:
+Line 83:
+<<BR>>
-Line 51:
+Line 87:
+<<BR>>
-Line 53:
+Line 91:
+<<BR>>
-Line 57:
+Line 97:
+<<BR>>
-Line 59:
+Line 101:
+<<BR>>
-Line 61:
+Line 105:
+<<BR>>
-Line 65:
+Line 111:
+<<BR>>
-Line 68:
+Line 116:
+<<BR>>
-Line 72:
+Line 122:
+<<BR>>
-Line 76:
+Line 128:
+<<BR>>
-Line 80:
+Line 134:
+<<BR>>
-Line 84:
+Line 140:
+<<BR>>
-Line 87:
+Line 145:
+<<BR>>
-Line 91:
+Line 151:
+<<BR>>
-Line 95:
+Line 157:
+<<BR>>
-Line 111:
+Line 175:
+<<BR>>
-Line 112:
+Line 178:
+<<BR>>
-Line 116:
+Line 184:
+<<BR>>
-Line 122:
+Line 192:
+<<BR>>
-Line 127:
+Line 199:
+<<BR>>
-Line 131:
+Line 205:
+<<BR>>
-Line 133:
+Line 209:
-. Click on "Select next region" again. You should see another region being selected. Continue doing so a few more times - the program will keep iterating through the different loves
+<<BR>>

2. Click on "Select next region" again. You should see another region being selected. Continue doing so a few more times - the program will keep iterating through the different hemispheres, lobes and then the measure nodes.

{{attachment:next_region_first.PNG}}

<<BR>>
-Line 141:
+Line 221:
+<<BR>>
-Line 146:
+Line 226:
+<<BR>>
-Line 150:
+Line 232:
+<<BR>>
-Line 158:
+Line 242:
+<<BR>>
-Line 161:
+Line 247:
+<<BR>>
-Line 165:
+Line 253:
+<<BR>>
-Line 171:
+Line 261:
+<<BR>>
-Line 175:
+Line 267:
+<<BR>>
-Line 176:
+Line 270:
-Options appearing in the popup menu can also be toggled or selected with various keyboard shortcuts indicated to their right. For example, pressing "'''H'''" on your keyboard allows you to hide region nodes and pressing "'''M'''" on your keyboard allows you to display region links.
+Options appearing in the popup menu can also be toggled or selected with various keyboard shortcuts indicated to their right. The '''SHIFT''' key must be pressed on the keyboard. For example, pressing SHIFT + "'''H'''" on your keyboard allows you to hide region nodes and pressing SHFT + "'''M'''" allows you to display the region links.
-Line 180:
+Line 274:
+<<BR>>
-Line 181:
+Line 277:
+<<BR>>
-Line 184:
+Line 282:
+== Summary of features ==
You have now reviewed all feature of this visualization tool.

The following table summarizes all the user-interactive features available in this tool. * Features highlighted in blue are also accessible in the popup menu.

<<BR>>

''Table 1. Summary of features. ''

{{attachment:summary_features_table_word_new.PNG}}

Software

Users

Development