Installing

Table of Contents

• Install a release version
  • Through a command-line
  • Through Anaconda Navigator
  • Optional extensions
• Update an existing installation
• Install a pre-release version
  • Alpha/Beta releases
  • A branch from GitHub
  • Git repository for development

Install a release version

For basic installation instructions see: Installing Eelbrain

Through a command-line

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.

Through Anaconda Navigator

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 select Not installed

• You might have to click Update index…​ to the left

• In the Search Packages box type eelbrain

• Click the check-box to the left of the package that appears

• Click Apply at the bottom

• When the Install packages dialog appears, click Apply 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)

Optional extensions

• Eelbrain provides functions to interface with R if rpy2 is installed.

• A working LaTeX installation enables exporting tables as pdf.

Update an existing installation

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

Install a pre-release version

Alpha/Beta releases

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"

A branch from GitHub

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 including fatal error: 'stdio.h' file not found. In order to install the Command Line Tools, run:

$ xcode-select --install

Git repository for development

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