Difference between revisions of "Portal:Getting Started"

From MNE-CPP Wiki
Jump to: navigation, search
Line 1: Line 1:
 
This page will show you how to setup the mne-cpp project in order to build and develop your own features with or based on the mne-cpp framework.
 
This page will show you how to setup the mne-cpp project in order to build and develop your own features with or based on the mne-cpp framework.
 +
 +
'''Get the mne-cpp source code:'''
 +
# Git clone mne-cpp from the main repository (mne-tools/mne-cpp) or your forked repository from your own Git Hub account.
  
 
'''Compile the mne-cpp source code:'''
 
'''Compile the mne-cpp source code:'''
 
# Download the current Qt version:
 
# Download the current Qt version:
## Go to the [http://www.qt.io/download-open-source/#section-2 Qt download website]
+
## Go to the [http://www.qt.io/download-open-source/#section-2 Qt download website].
## Select the appropriate version based on the compiler and platform you use. For example if you are using the Microsoft Visual Studio 2013 Compiler on a Windows 32bit system, select the "''Qt 5.5.1 for Windows 32-bit (VS 2013, 823 MB)''" version.
+
## Select the appropriate version based on the compiler and platform you use.  
 +
##:* For example if you are using the Microsoft Visual Studio 2013 Compiler on a Windows 32bit system, select the "''Qt 5.5.1 for Windows 32-bit (VS 2013, 823 MB)''" version.
 
# Install the Qt version with the minimum of the following features:  
 
# Install the Qt version with the minimum of the following features:  
<gallery>
 
Qt_install.png|Caption1
 
</gallery>
 
 
#:* Qt/Qt x.x/Pre-compiled Qt (i.e. ''Qt 5.5/msvc2013 32-bit'')
 
#:* Qt/Qt x.x/Pre-compiled Qt (i.e. ''Qt 5.5/msvc2013 32-bit'')
 
#:* Qt/Qt x.x/Qt3D
 
#:* Qt/Qt x.x/Qt3D
 
#:* Qt/Tools/QtCreator
 
#:* Qt/Tools/QtCreator
# Git clone mne-cpp from the main repository (mne-tools/mne-cpp) or your forked repository from your own Git Hub account.
+
# Go to your cloned repository folder and run the ''mne-cpp/mne-cpp.pro'' file with the QtCreator.  
# Run the mne-cpp.pro file with the QtCreator. Select the Release mode
+
# Select the Release mode in the lower left corner.
# Right mouse click on the top level tree item mne-cpp, then select Run qmake
+
# In the Qt Creator's ''Projects'' window right mouse click on the top level mne-cpp tree item, then select ''Run qmake''.
# Right mouse click again and then hit Build. The build porcess may take some time depending on your computer setup.  
+
# Right mouse click again and then hit ''Build''. The build porcess may take some time.  
# After the build process is finished, check out the mne-cpp/bin folder. All applications and libraries should have been created throughout the build process.
+
# 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.
# In case you do not have a debugger (for windows):
+
# In case you do not have a windows debugger:
 
## Go to the [https://msdn.microsoft.com/de-DE/windows/desktop/bg162891 Windows SDK download website]
 
## Go to the [https://msdn.microsoft.com/de-DE/windows/desktop/bg162891 Windows SDK download website]
## Download and install the SDK (during the installation, select the Debugging Tools for Windows box and clear all the other boxes)
+
## Download and install the SDK (during the installation, select the ''Debugging Tools for Windows'' box and clear all the other boxes).
## Select debugger under Kits in QtCreator
+
## Open the QtCreator and select the debugger under ''Tools/Options/Build & Run/Kits/[your Kit name goes here]/Debugger''.
## The first time you use the debugger, you might see the following message
+
  
 
'''Further reading:'''
 
'''Further reading:'''
  
* Tutorial on how to create your first MNE-CPP application
+
* Tutorial: How to create your first MNE-CPP application.
* Tutorial on how to create your first MNE-X plugin
+
* Tutorial: How to create your first MNE-X plugin.
 +
* Guide: How to contribute your code.

Revision as of 11:38, 4 January 2016

This page will show you how to setup the mne-cpp project in order to build and develop your own features with or based on the mne-cpp framework.

Get the mne-cpp source code:

  1. Git clone mne-cpp from the main repository (mne-tools/mne-cpp) or your forked repository from your own Git Hub account.

Compile the mne-cpp source code:

  1. Download the current Qt version:
    1. Go to the Qt download website.
    2. Select the appropriate version based on the compiler and platform you use.
      • For example if you are using the Microsoft Visual Studio 2013 Compiler on a Windows 32bit system, select the "Qt 5.5.1 for Windows 32-bit (VS 2013, 823 MB)" version.
  2. Install the Qt version with the minimum of the following features:
    • Qt/Qt x.x/Pre-compiled Qt (i.e. Qt 5.5/msvc2013 32-bit)
    • Qt/Qt x.x/Qt3D
    • Qt/Tools/QtCreator
  3. Go to your cloned repository folder and run the mne-cpp/mne-cpp.pro file with the QtCreator.
  4. Select the Release mode in the lower left corner.
  5. In the Qt Creator's Projects window right mouse click on the top level mne-cpp tree item, then select Run qmake.
  6. Right mouse click again and then hit Build. The build porcess may take some time.
  7. 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.
  8. In case you do not have a windows debugger:
    1. Go to the Windows SDK download website
    2. Download and install the SDK (during the installation, select the Debugging Tools for Windows box and clear all the other boxes).
    3. Open the QtCreator and select the debugger under Tools/Options/Build & Run/Kits/[your Kit name goes here]/Debugger.

Further reading:

  • Tutorial: How to create your first MNE-CPP application.
  • Tutorial: How to create your first MNE-X plugin.
  • Guide: How to contribute your code.