<pre style="color: red">
Warning: You should know what you are doing and be familiar with the Neuromag system!
</pre>

== Setup mne_rt_server ==
The following steps are to be performed on the Neuromag PC.
=== Qt 5 ===

<source lang=cpp>
./configure -no-xcb -no-eglfs -no-directfb -no-linuxfb -no-kms -no-glib -no-gui -no-widgets -no-opengl -no-openssl -opensource -nomake examples -prefix /home/neuromag/RT_MNE_CPP/Qt/Qt5.3.0
make
</source>

It's likely that following error occurs:
Futex Error (RHEL 5.1 with gcc 4.1.2 compiler)

You can fix this error by replacing following line in src/corelib/thread/qmutex_linux.cpp

<source lang=cpp>
# include <linux/futex.h>
</source>

with

<source lang=cpp>
# define FUTEX_WAIT 0
# define FUTEX_WAKE 1
</source>

You can ignore further Qt5 build errors. Since only qmake and the most important libraries are needed.
Finish the installation with:

<source lang=cpp>
make install
</source>

=== MNE-CPP ===
==== Download MNE-CPP ====

Edit _mne-cpp.pri_ by commenting _withGui_ out:

<source lang=cpp>
#MNECPP_CONFIG += withGui
</source>

run:

<source lang=cpp>
qmake -r
make
</source>

==== Edit .bashrc ====
After you compiled mne-cpp succesfully edit your .bashrc to make the shared libraries globally available:

<source lang=cpp>
#
# Qt
#
export QT_HOME=/home/neuromag/RT_MNE_CPP/Qt/Qt5.3.0
if [[ $QT_HOME && ${QT_HOME-_} ]]; then
PATH=$PATH:$QT_HOME/bin
if [[ $LD_LIBRARY_PATH && ${LD_LIBRARY_PATH-_} ]]; then
LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$QT_HOME/lib
else
export LD_LIBRARY_PATH=$QT_HOME/lib
fi
fi

#
# MNE-CPP
#
export MNE_CPP=/home/neuromag/RT_MNE_CPP/Git_Repos/mne-cpp
if [[ $MNE_CPP && ${MNE_CPP-_} ]]; then
PATH=$PATH:$MNE_CPP/bin
if [[ $LD_LIBRARY_PATH && ${LD_LIBRARY_PATH-_} ]]; then
LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$MNE_CPP/lib
else
export LD_LIBRARY_PATH=$MNE_CPP/lib
fi
fi
</source>

==== Firewall Configuration ====
Open port 4217 & 4218 and add allowed clients by editing /etc/sysconfig/iptables. Insert the following:

<source lang=cpp>
-A RH-Firewall-1-INPUT -m state --state NEW -m tcp -p tcp --dport 4217 -j ACCEPT
-A RH-Firewall-1-INPUT -m state --state NEW -m tcp -p tcp --dport 4218 -j ACCEPT
-A RH-Firewall-1-INPUT -s ip.of.your.client -m tcp -p tcp --dport 4217 -j ACCEPT
-A RH-Firewall-1-INPUT -s ip.of.your.client -m tcp -p tcp --dport 4218 -j ACCEPT
</source>

== Connect the Neuromag System with MNE Scan ==
The following steps are to be performed both on the Neuromag and Client PC.

=== Step by Step Guide ===
#Setup Neuromag PC:
## Open console, type <source lang=cpp>mne_rt_server</source> and hit enter (use this console to wathc the mne_rt_server work and receive commands from the client)
## Open second console, type <source lang=cpp>telnet <ip.of.megacq> collector</source> (use this console to restart and change variables of the MEG system).
### When asked for password type in "pass <your password>" and hit enter.
### Type in <source lang=cpp>STAT</source> to view the current status of the MEG machine. This should give you a message saying that the collectors are setup. If not get help to set the collectors up.
### Type in <source lang=cpp>VARS</source> and note down the values of maxBuflen and sFreq (these values get overwritten by MNE Scan). This is IMPORTANT!
## Find out IP adress of the Neuromag PC (this is NOT the IP shown by the mne_rt_server in the console window) and note it down somewhere.
## Check if ports 4217 and 4218 are open and if the client is allowed to connect. If not see the Firewall Configuration steps above.
# Setup MNE-CPP PC:
## Try to ping the Neuromag PC from the MNE-CPP PC
### Open cmd console
### Type in <source lang=cpp>ping <Neuromag PC IP address></source> (this is the IP address you noted down above).
## If pinging was successful start MNE Scan and drag the Neuomag plugin onto the plugin stage.
## Change to the Connection tab. There you should find the connected satuts. If not you made something wrong!

== Hints ==
=== Use Cases ===
* MNE Scan crashed:
*:# Close down MNE Scan
*:# Switch to the Neuromag PC
*:# Hit Ctrl+C in the mne_rt_server console
*:# Restart the mne_rt_server by typing <source lang=cpp>mne_rt_server</source>
*:# Type <source lang=cpp>STOP</source> into the Collector console to stop the measurement system
*:# You are all set and ready for antoher try!
* Change the blocksizes of the incoming data:
*:* Changing the block size is only possible by recompiling the mne_rt_server with a different initialized value in /connectors/neuromag/neuromag.cpp

=== The collectors ===
You can use telnet to monitor the interaction of _mne_rt_server_ with the neuromag machine:
Therefore connect to the collectors running on the real-time computers:

<source lang=cpp>
telnet megacq collector
</source>

or

<source lang=cpp>
telnet ip.of.megacq 11122
</source>

Authorize your self:

<source lang=cpp>
PASS ***
</source>

Check the status by typing (They should be setup but not measuring. If this is not the case run a simple dummy project using the neuromag acqusition software, afterwards they will be setup.):

<source lang=cpp>
STAT
</source>

Check the values of the variables by typing:

<source lang=cpp>
VARS
</source>

Save the variables in a text file and make sure that they are the same after you have finished (your colleagues will appreciate this)

You can change variable names by typing

<source lang=cpp>
VARA ``<var> = <value>``
</source>

Switch on the monitoring to follow all interactions with the real-time computers:

<source lang=cpp>
MONI ON
</source>

You can start the acqusition manually with:

<source lang=cpp>
MEAS
</source>

And stopping it again with:

<source lang=cpp>
STOP
</source>

All available commands you'll find by typing:

<source lang=cpp>
HELP
</source>

You can leave the collectors by typing:

<source lang=cpp>
QUIT
</source>

=== Neuromag Acqusition ===

It's recommended to start the Neuromag Acquisition program. The software will be remotely controlled by MNE Scan since the collectors mirror the instructions received. You can use the Neuromag data display to check your MNE Scan measurements.

2017-09-19T14:20:55Z

LorenzE:

* Highly modular and easily extendable
* Cross platform capable: Windwos, Linux, Mac, handheld devices & embedded systems
* Purely written in C++
* MNE-CPP is set up as a two layer structure:
*:# Library layer:
*:#:* Backbone of the MNE-CPP framework
*:#:* Different libraries providing core features & functionalities
*:# Application layer:
*:#:* User interaction of the MNE-CPP framework
*:#:* Full scale GUI applications with rich user experience
*:#:* Command line applications
*:#:* Simple examples for an easy start
*:#:* SUnit tests: Safeguarding correctness of results
* Dependencies:
*:# Keep dependencies to a minimum
*:# Qt for Graphical User Interface integration
*:# Light-weight template library Eigen for linear algebra
*:# Future proof: Qt/Eigen are highly & activley maintained
*:# Avoid SOUP (Software Of Unknown Pedigree)

[[File:MNE-CPP_design_less_color.png|400px]]

2017-09-04T00:19:14Z

LorenzE:

Compile the MNE-CPP source code

2017-09-04T00:18:14Z

LorenzE:

# If you are working on an operating system on a "non-western" system, i.e. Japan, you might encounter problems with unicode interpretation. Please do the following: Go to Control Panel -> Language and Region -> Management tab -> Language Settings for non-Unicode Programs -> Set to English (U.S.) -> Reboot your system.
# If you compile under Linux please make sure that you add Qt's library path to your LD_LIBRARY_PATH.
# Go to your cloned repository folder and run the ''mne-cpp/mne-cpp.pro'' file with the QtCreator.
# In QtCreator select the ''Release'' mode in the lower left corner.
# In the Qt Creator's ''Projects'' window, right mouse click on the top level mne-cpp tree item and select ''Run qmake''. Wait until progress bar in lower right corner turns green.
# Right mouse click again and then hit ''Build'' (this step may take some time). Wait until progress bar in lower right corner turns green.
# After the build process is finished, go to the ''mne-cpp/bin'' folder. All applications and libraries should have been created throughout the build process.

Get Qt

2017-04-06T17:00:50Z

LorenzE:

This page will show how to dowload and install the latest Qt version.

# Download the current Qt version:
## Go to the Qt download section [http://download.qt.io/official_releases/qt/ here]. Qt5.8 or higher is needed in order to have full Qt3D support. Note for Windows users: Make sure NOT to download the WinRt version.
## Select the appropriate version based on your compiler and development platform.
##:* For example if you are using the Microsoft Visual Studio 2013 Compiler on a Windows 32bit system, select the "''Qt 5.8 for Windows 32-bit (VS 2013, 840 MB)''" version.
# Install the Qt version with the minimum of the following features (uncheck all other boxes):
#:* Qt/Qt 5.8/Pre-compiled Qt (i.e. ''Qt 5.8/msvc2013 32-bit'')
#:* Qt/Qt 5.8/QtCharts
#:* Qt/Qt 5.8/QtGamepad
#:* Qt/Tools/QtCreator
# You now have the latest Qt version installed on your local machine. If you want to start Qt based applications drectly from your file navigator (i.e. Windwos Explorer or Linux Nautilus), you will need to add the Qt bin folder to the environment variable. If you plan only to start the applications directly from within the QtCreator you do not need to perform the following steps:
#:* Windows:
#:*:# Right-click Computer and click Properties.
#:*:# Click Advanced System Settings link in the left column.
#:*:# In the System Properties window and click the ''Environment Variables'' button.
#:*:# Add to the PATH variable ''C:\Qt\Qt5.8\5.8\msvc2013\bin'' (the qt bin path may differ depending on your Qt installation).
#:* Linux:
#:*:# Add Qt bin and lib directory to the environment variables (the qt paths may differ depending on your Qt installation)
#:*:#: <source lang="cpp">export PATH=$PATH:~/Qt/Qt5.8/bin </source>
#:*:#: <source lang="cpp">export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:~/Qt/Qt5.8/lib </source>
# In case you work on a windows machine and do not have a compiler set up:
#:* Download Microsoft Visual C++ Build tools [http://landinghub.visualstudio.com/visual-cpp-build-tools here]
# In case you do not have the Windows 8.1 SDK installed:
#:* Go to the [https://dev.windows.com/de-de/downloads/windows-8-1-sdk Windows SDK download website]
#:* Download and install the Windows 8.1 SDK (during the installation, make sure to also select the ''Debugging Tools for Windows'' box).
#:* Open the QtCreator and select the debugger under ''Tools/Options/Build & Run/Kits/[your Kit name goes here]/Debugger''.