OpenWalnutHelp.html 6.42 KB
Newer Older
Alexander Wiebel's avatar
Alexander Wiebel committed
1
<html>
2
<body bgcolor="#fff">
3
<h1>OpenWalnut Help <img src="icons/logoIcon.png"/></h1>
Alexander Wiebel's avatar
Alexander Wiebel committed
4 5 6
<h2>Contents</h2>
<ol>
<li><a href="#Introduction">Introduction</a></li>
7
<li><a href="#MainWindow">Main Window</a></li>
Alexander Wiebel's avatar
Alexander Wiebel committed
8 9
<li><a href="#Navigation">Navigation</a></li>
<li><a href="#Keyboard">Keyboard Shortcuts</a></li>
10
<li><a href="#Toolbar">Toolbar</a></li>
Alexander Wiebel's avatar
Alexander Wiebel committed
11
<li><a href="#ROIs">Regions of Interest</a></li>
Alexander Wiebel's avatar
Alexander Wiebel committed
12 13 14
<li><a href="#Config">Customizing OpenWalnut</a></li>
</ol>

15

Alexander Wiebel's avatar
Alexander Wiebel committed
16
<h2><a name="Introduction" />Introduction</h2>
Alexander Wiebel's avatar
Alexander Wiebel committed
17
The intention of this help document is to give a short overview of how to use the current version 
Alexander Wiebel's avatar
Alexander Wiebel committed
18 19 20
of OpenWalnut. Although it is not at all comprehensive, 
it provides a description of the most commonly used features and GUI elements. 
As described <a href="#Config">below</a>, the appearance of the GUI is customizable. This help document 
Alexander Wiebel's avatar
Alexander Wiebel committed
21 22
assumes the standard configuration. Additionally, some described features may not be available 
in every instance of OpenWalnut because they belong to special modules.
Alexander Wiebel's avatar
Alexander Wiebel committed
23

24 25 26 27
<h2><a name="MainWindow" />Main Window</h2>
By now this section only shows a snapshot of the main window of OpenWalnut. In
the future this illustration will be annotated to explain the names and the use of
all components of the main window.
28
<img src="images/mainWindow.png"/>
29

Alexander Wiebel's avatar
Alexander Wiebel committed
30
<h2><a name="Navigation" />Navigation</h2>
31 32 33 34 35
<h3>Navigation in Main View</h3>
<table>
<tr><td><b><i>Mouse Button&nbsp;&nbsp;</i></b></td><td><b><i>Action</i></b></td></tr>
<tr><td>Left</td><td>Rotate</td></tr>
<tr><td>Middle</td><td>Pan</td></tr>
Alexander Wiebel's avatar
Alexander Wiebel committed
36 37
<tr><td>Right</td><td>Pick, move <a href="#ROIs">ROI</a> box, or move slice</td></tr>
<tr><td>Right + [Shift]</td><td>Resize <a href="#ROIs">ROI</a> box</td></tr>
38 39 40 41
<tr><td>Wheel</td><td>Zoom</td></tr>
<tr><td><b><i>Key</i></b></td><td><b><i>Action</i></b></td></tr>
<tr><td>+</td><td>Zoom in</td></tr>
<tr><td>-</td><td>Zoom out</td></tr>
Alexander Wiebel's avatar
Alexander Wiebel committed
42
<tr><td>[Space]</td><td>Reset view</td></tr>
43 44 45 46 47 48 49 50 51 52 53
</table>
<h3>Navigation in EEG View</h3>
<table>
<tr><td><b><i>Mouse Button</i></b></td><td><b><i>Action</i></b></td></tr>
<tr><td>Left</td><td>Mark event position</td></tr>
<tr><td>Middle</td><td>Pan</td></tr>
<tr><td>Right</td><td>Zoom in time</td></tr>
<tr><td>Wheel</td><td>Scale voltage</td></tr>
<tr><td>Wheel + Right</td><td>Change spacing between graphs</td></tr>
<tr><td>Wheel + Left</td><td>Change sensitivity of the coloring of the head surface</td></tr>
</table>
Alexander Wiebel's avatar
Alexander Wiebel committed
54 55 56


<h2><a name="Keyboard" />Keyboard Shortcuts</h2>
57 58 59
<h3>Program-wide Keyboard Shortcuts</h3>
<table>
<tr><td><b><i>Key</i></b></td><td><b><i>Action</i></b></td></tr>
60 61 62
<tr><td>[Ctrl] + q</td><td>Quit</td></tr>
<tr><td>[Esc]</td><td>Resets main view</td></tr>
<tr><td>[F1]</td><td>Opens help window</td></tr>
Alexander Wiebel's avatar
Alexander Wiebel committed
63 64 65 66
</table>
<h3>ROI tree</h3>
<table>
<tr><td><b><i>Key</i></b></td><td><b><i>Action</i></b></td></tr>
Alexander Wiebel's avatar
Alexander Wiebel committed
67
<tr><td>[Delete]</td><td>Removes <a href="#ROIs">ROI</a></td></tr>
Alexander Wiebel's avatar
Alexander Wiebel committed
68 69 70 71 72 73 74
</table>
<h3>Module tree</h3>
<table>
<tr><td><b><i>Key</i></b></td><td><b><i>Action</i></b></td></tr>
<tr><td>[Backspace]</td><td>Removes module</td></tr>
</table>

75 76 77 78 79 80
<h2><a name="Toolbar" />Toolbar</h2>
<table>
<tr><td><b>Icon</b></td><td><b>Name</b></td><td><b>Description</b></td></tr>

<tr><td><img src="icons/fileopen.png" width="20"></td><td>Load
    Data</td><td>Loads data given in various formats like fibers (.fib), NIfTI
Alexander Wiebel's avatar
Alexander Wiebel committed
81 82 83
    images (.nii, .nii.gz) or EEG data (.cnt). Not all supported file formats
    are available through this button and the dialog behind it. For some file
    formats there are special modules for reading and/or writing them.</td></tr>
84 85 86 87 88 89
<tr><td><img src="icons/projOpen.png" width="20"></td><td>Load a project from
    file</td><td>Opens a project file (.owp), and instantiates modules, sets their
    connections and orients the scene accordingly.</td></tr>
<tr><td><img src="icons/disc.png" width="20"></td><td>Save current project to
    file</td><td>Saves the current state (modules, connections, orientation of
    the scene) of OpenWalnut to a project file (.owp).</td></tr>
90
<tr><td><img src="icons/camera.png" width="20"></td><td>Reset main view</td><td>Rotates
Alexander Wiebel's avatar
Alexander Wiebel committed
91
    and scales the scene in the central 3D view to show the same orientation as
92 93
    after program startup but zoomed to show all contents of the
    scene.</td></tr>
Alexander Wiebel's avatar
Alexander Wiebel committed
94
<tr><td><img src="icons/box.png" width="20"></td><td>Create new
95
    ROI box</td><td>Adds a new ROI box to the 3D scene and the ROI browser. See also: <a href="#ROIs">ROIs</a>.</td></tr>
Alexander Wiebel's avatar
Alexander Wiebel committed
96 97 98
<tr><td><img src="icons/QuestionMarks.xpm" width="20"></td><td>Missing
    module?</td><td>This opens the dialog that allows to customize the list of
    modules that are allowed to appear in the <i>Compatible Modules</i> toolbar.</td></tr>
99 100
</table>

Alexander Wiebel's avatar
Alexander Wiebel committed
101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120
<h2><a name="ROIs" />Regions of Interest</h2>
A ROI (<b>r</b>egion <b>o</b>f <b>i</b>nterest) is usually used to specify a
certain area (2D) or volume (3D) that can then be accessed by
modules. Different modules will use ROIs for different purposes. The most
important purpose of ROI boxes in OpenWalnut is the selection of fibers in
conjuction with fiber display modules. It will be described in a separate
section below.

The ROIs can be moved around by dragging them with the right mouse
button. Their size can be changed by dragging one of their faces with the right
mouse button while the [Shift] key is pressed.

<h3>ROIs for selecting fibers</h3>
For the special task of selecting fiber bundles from larger sets of fibers ROIs can be
combined in the ROI tree widget. All ROIs in the same branch of the tree are
combined using a Boolean "and" operation. The result will be a bundle
consisting only of fibers that pass through all boxes in the branch. The branches themselves are combined
using a Boolean "or" operation. This means that the bundles selected by the
different branches will be visible/selected at the same time.

Alexander Wiebel's avatar
Alexander Wiebel committed
121
<h2><a name="Config" />Customizing OpenWalnut</h2>
122 123 124 125 126 127 128 129 130 131 132 133 134
OpenWalnut allows you to configure several features. Most of these options are
only useful to advanced users. Have a look into the <i>View</i>, <i>Camera</i> and <i>Settings</i>
menus for what you can adapt. If you would like to configure which modules are
allowed to be shown in the toolbar click on the <tt>Missing Module?</tt> button
with the three question marks. The appearing dialog will provide enough information
and the possibility to customize which modules may appear. This can be useful
to maintain a not too crowded toolbar.
<br />
<br />
<font color="#aaa">
<small><b>For more information on OpenWalnut
  visit <a href="http://www.openwalnut.org">www.openwalnut.org</a>.</b></small>
</font>
Alexander Wiebel's avatar
Alexander Wiebel committed
135
</body>
136
</html>