-
Notifications
You must be signed in to change notification settings - Fork 27
Installing
For basic installation instructions see: Installing Eelbrain
The following line will generate an environment with the latest version:
$ conda create -n eelbrain -c conda-forge eelbrain
To install a specific version, modify the last eelbrain
in the line above to, for example, eelbrain=0.29
.
To install other useful libraries at the same time:
$ conda create -n eelbrain -c conda-forge eelbrain jupyterlab seaborn
To use this environment, activate it with
$ conda activate eelbrain
(eelbrain) $
The leading (eelbrain)
in the second prompt indicates that the environment is now active.
The Anaconda Navigator comes with the Anaconda Python distribution and provides a GUI for managing environments.
-
On the left, click
Environments
-
At the top, click
Channels
(this has to be done only once)-
Click
Add
-
Type
conda-forge
and hit enter -
Click
Update channels
-
-
At the bottom left, click
Create
-
Give the environment a name (e.g.
eelbrain
) -
Below select the latest Python
3.x
version for which Eelbrain is available -
Click
Create
-
-
Now, select the drop-down menu at the top that currently says
installed
and selectNot installed
-
You might have to click
Update index…
to the left -
In the
Search Packages
box typeeelbrain
-
Click the check-box to the left of the package that appears
-
Click
Apply
at the bottom -
When the
Install packages
dialog appears, clickApply
again
In order to use the environment:
-
Select the
Home
tab on the left -
In the top left drop-down menu select the environment
-
Launch the preferred Application (e.g. VS Code)
To update Eelbrain in an existing environment, run
$ conda update -c conda-forge eelbrain
Or for installing a specific version:
$ conda install -c conda-forge eelbrain=0.29
Sometimes pre-release versions are available with new or experimental features (check the version number in the badge at the top of this page). These pre-releases can be installed by including the conda-forge/label/eelbrain_dev
channel. To create a new environment with a specific version, use for example:
$ mamba create -n eelpre -c conda-forge/label/eelbrain_dev "eelbrain = 0.40b1"
Or, install into an existing environment:
$ mamba install -c conda-forge/label/eelbrain_dev "eelbrain = 0.40b1"
Download the environment file and create the eeldev
conda environment:
$ curl -O https://raw.githubusercontent.com/christianbrodbeck/Eelbrain/main/env-dev.yml
$ mamba env create --file=env-dev.yml
Activate the environment:
$ mamba activate eeldev
Install the relevant development branch into the environment. If installing a specific branch, replace "main" with the branch name:
$ pip install https://github.com/christianbrodbeck/Eelbrain/archive/main.zip
NOTE: In order for this to work on macOS, the Xcode Command Line Tools may need to be installed. If they are not, the
pip install
command may fail with a long error message includingfatal error: 'stdio.h' file not found
. In order to install the Command Line Tools, run:$ xcode-select --install
On the Eelbrain GitHub site, create a fork of Eelbrain by clicking the Fork
button. Clone your fork to your local computer (execute this command from the directory in which you want the Eelbrain source folder to be located):
$ git clone https://github.com/<username>/Eelbrain.git
Changing into the new Eelbrain
folder and generate the development environment:
$ cd Eelbrain
$ conda env create --file=env-dev.yml
Activate the environment, then install Eelbrain into it with
$ conda activate eeldev
$ pip install -e .
MacOS only: patch the $ eelbrain
command to use the framework build of Python
$ ./fix-bin
Tests that involve GUIs also need to be run with a framework build; in order to do that, also patch pytest
with
$ ./fix-bin pytest