Installation¶

There are a few ways to install data2bids. For those looking to simply run the software you should install a compiled version. Currently, the software comes pre-compiled for Windows 10 systems.

Windows¶

For 64-bit Windows, compiled version can be found in this google drive folder. Make sure to download the latest version, the zipped folders contain the date of compiling.

Compile from source¶

For users wanting to compile the source code, you can obtain the code from the GitHub repository.

Python Setup¶

First you will need to install Python, depending on what operating system you are using there are different approaches.

Windows¶

You will need to download the windows python installer.
Underneath the heading at the top that says Python Releases for Windows, click on the link for the Latest Python 3 Release - Python 3.x.x
Scroll to the bottom and select either Windows x86-64 executable installer for 64-bit or Windows x86 executable installer for 32-bit
Install by double-clicking on the downloaded file.

Mac¶

Install Homebrew by opening a Terminal window and pasting the following line.

/usr/bin/ruby -e $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)

Homebrew asks you to enter your password so it can finalize the installation. Enter your user account password and hit enter
Once Homebrew has finished installing, return to your terminal and run the following command:
```
brew install python3
```

Linux¶

Open a terminal window and run the following commands:

sudo apt-get install python3.6
sudo apt install python3-pip

Compiling¶

Make a directory on your computer to store the source code:
```
mkdir /Documents/software
```

Clone a copy of the data2bids repository to your system:

cd /Documents/software
git clone https://github.com/greydongilmore/data2bids.git

Install the Python dependencies by opening a terminal, changing to the project directory and running:
```
cd /data2bids
python3 -m pip install -r requirements.txt
```
Once you have installed the dependencies, you can run the program from the Terminal (from within the data2bids directory):
```
python3 main.py
```
To compile data2bids for your platform, you can run the following:
```
python3 setup.py build_exe
```

Other Useful Software¶

EDFBrowser¶

EDFBrowser (developed by Teunis van Beelen) is a free, open-source, viewer/toolbox for EEG/IEEG data. It is a great tool to use when attempting to organize your input directory for data2bids.

Windows¶

For 64-bit windows download this file.

For 32-bit Windows download this file.

Mac¶

You can download the latests .dmg file from this website.

Linux¶

To install on Linux, you must first have the dependencies installed (g++, Qt5):

sudo apt-get update
sudo apt-get install g++ make git qtbase5-dev-tools qtbase5-dev qt5-default

Then enter the following commands to download and install:

git clone https://gitlab.com/Teuniz/EDFbrowser.git
cd EDFbrowser
qmake
make -j4
sudo make install
edfbrowser