NinaWie / OpenNFT

OpenNFT is an integrated software package designed for neurofeedback training.

OpenNFT

OpenNFT is an integrated software package designed for neurofeedback training. It constitutes the core technical framework for developments in this exciting new field of neuroimaging. OpenNFT is based on best practices of Python and Matlab software and incorporates, but is not limited to, the functionality of the SPM and Psychtoolbox software suits. An integrated Python/Matlab framework is specifically selected to address the needs of neurofeedback developers and users with different background, which allows for flexibility in developments and implementations without compromising for speed and functionality. More specifically, the OpenNFT’s GUI, synchronization module, and multi-processing core are implemented in Python, whilst computational modules for neurofeedback are implemented in Matlab.

Refer to www.OpenNFT.org and to our Neuroimage manuscript "OpenNFT: An open-source Python/Matlab framework for real-time fMRI neurofeedback training based on activity, connectivity and multivariate pattern analysis" for further description. Direct link to OpenNFT manual. Note, we are still tuning our pre-release version. Please check the updates regularly.

Installation (based on the OpenNFT manual)

Prerequisites

• MATLAB (x64) >= R2016b
  • Image Processing Toolbox
  • Statistics and Machine Learning Toolbox
• Python (x64) >= 3.5, <= 3.6, for example Miniconda3
• Git: for installing SPM, Psychtoolbox, OpenNFT

Install MATLAB Toolboxes

• SPM12
• Psychtoolbox 3
• JSONlab

Install OpenNFT in virtual environment

Install with conda and Python 3.5:

• $ conda create -n OpenNFT_venv python=3.5 pip setuptools
• $ conda activate OpenNFT_venv
• (OpenNFT_venv)$ python -m pip install -U pip setuptools
• (optional for numpy+MKL) (OpenNFT_venv)$ pip install http://www.silx.org/pub/wheelhouse/numpy-1.13.1+mkl-cp35-cp35m-win_amd64.whl
• (OpenNFT_venv)$ pip install git+https://github.com/OpenNFT/OpenNFT.git --install-option "--matlab-root=<MATLABROOT>"

Install without conda using your existing Python (>=3.5, <3.7):

• $ python -m venv OpenNFT_venv
• (Linux/macos) $ source OpenNFT_venv/bin/acivate
• (Windows) $ OpenNFT_venv\Scripts\acivate.bat
• (OpenNFT_venv)$ python -m pip install -U pip setuptools
• (OpenNFT_venv)$ pip install git+https://github.com/OpenNFT/OpenNFT.git --install-option "--matlab-root=<MATLABROOT>"

Also if you do not set install option --matlab-root we try to find Matlab automatically. You can check installation result using -v (verbose) option:

(OpenNFT_venv)$ pip install git+https://github.com/OpenNFT/OpenNFT.git -v

NOTE: If you do not have write access in MATLABROOT the installer will try to install "Matlab Engine for Python" with Administrator/root privileges (It elevates privileges via UAC/sudo).

Also you can install OpenNFT from your working directory (OpenNFT project root directory):

(OpenNFT_venv)$ pip install /path/to/OpenNFT/root/dir/

or:

(OpenNFT_venv)$ cd /path/to/OpenNFT/root/dir/
(OpenNFT_venv)$ pip install .

Also you can use option -e/--editable for installing in editable mode (mode for development):

(OpenNFT_venv)$ pip install -e .
(OpenNFT_venv)$ pip list
Package               Version    Location
--------------------- ---------- -----------------------------
...
matlabengineforpython R2016b
...
numpy                 1.16.2+mkl
OpenNFT               1.0.0rc0   c:\workspace\projects\opennft
...

Running OpenNFT application

Just run the following command:

(OpenNFT_venv)$ opennft

or with console window:

(OpenNFT_venv)$ opennft_console

Demo dataset

https://github.com/OpenNFT/OpenNFT_Demo/releases

N.B.:

Use the updated Setup and Protocol files provided with OpenNFT - https://github.com/OpenNFT/OpenNFT/tree/master/opennft/configs