Installation¶
Requirements¶
phys2bids
requires python 3.6 or above, as well as the modules:
numpy >=1.9.3, !=*rc*
matplotlib >=3.1.1, !=3.3.0rc1
PyYAML >=5.1, !=*rc*
Depending on the processed files, it might require the manual installation of extra modules. At the moment, those modules are:
bioread
, for AcqKnowledge (.acq
) files.
Linux and mac installation¶
Install with pip
¶
Note
The following instructions are provided assuming that python 3 is not your default version of python.
If it is, you might need to use pip
instead of pip3
, although some OSs do adopt pip3
anyway.
If you want to check, type python --version
in a terminal.
Install phys2bids
alone¶
Pypi has the latest stable release of phys2bids
as a package. Since we use auto
to publish the latest features as soon as they are ready, it will really be the latest release. Just run:
pip3 install phys2bids
Install extra modules¶
If you are planning to use file formats other than plain txt
, you need to install extra modules to have the right interface.
Extra modules installation can be done with the syntax:
pip3 install phys2bids[<extra>]
Where <extra>
is one of the following:
acq
: if you plan to use native AcqKnowledge files (.acq
extension)
interfaces
: for all the interfaces above.
For instance, if you plan to install phys2bids
and use all of the interfaces, run:
pip3 install phys2bids[interfaces]
Note
If you “missed” or skipped this trick when you installed phys2bids
the first time, don’t worry!
You can do it any time - this will update phys2bids
and install all extra modules you want.
Install without pip
¶
Download the latest package release from github and uncompress it.
Alternatively, if you have git
installed, use the command:
git clone https://github.com/physiopy/phys2bids.git
Open a terminal in the phys2bids
folder and execute the command:
python3 setup.py
You might still need to install extra dependencies listed at the beginning of the page.
Note
If python 3 is already your default, you might use python
rather than python3
Check your installation!¶
Type the command:
phys2bids -v
If your output is: phys2bids 2.2.2
or similar, phys2bids
is ready to be used.
Windows installation¶
First of all let’s check you have python installed. Open a windows power shell window in admin mode and type:
python --version
In case you don’t have it, either install it from here or type the command:
python
It will redirect you to the windows store python install (in the creation of this tutorial the newest version of python was 3.8).
Warning
phys2bids
supports Python 3.6 and later versions. We can’t guarantee it will work if you use python 2.
Once python is installed, you can follow the instructions to install phys2bids
reported above
Note
Remember to open a terminal in admin mode to install libraries!