OS X Installation instructions¶

The following steps have been tested on a clean install of Mavericks 10.9.4.

All others must fend for themselves to install matplotlib, scipy and their third-party dependencies.

This part only needs to be done once

• Install anaconda

• Install Xcode (this can take an hour)

• Open Xcode and agree to terms and services (it is very important to read them thoroughly)

• Install homebrew

  ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)"

• Install freetype:

  brew install freetype

• Install heavy packages (this can take an hour or more)

conda install pip numpy scipy cython matplotlib nose six scikit-learn ipython networkx pandas tornado statsmodels setuptools pytest pyzmq jinja2 pyyaml`

• Create a virtual environment conda create -n flotilla_env pip numpy scipy cython matplotlib nose six scikit-learn ipython networkx pandas tornado statsmodels setuptools pytest pyzmq jinja2 pyyaml`

• Switch to virtual environment

  source activate flotilla_env

• Install flotilla and its dependencies (this can take a few minutes):

  pip install git+https://github.com/YeoLab/flotilla.git

• Create a scratch space for your work

  mkdir ~/flotilla_scratch

• Make a place to store flotilla projects

  mkdir ~/flotilla_projects

• Go back to the real world

  source deactivate

• switch to virtual environment

  source activate flotilla_env

• start an ipython notebook:

  ipython notebook --notebook-dir=~/flotilla_scratch

• create a new notebook by clicking New Notebook

• rename your notebook from “Untitled” to something more informative by clicking the title panel.

Docker Instructions¶

Docker is the preferred method to obtain the most up-to-date version of flotilla. Every change we make to the source code triggers a new build of a virtual machine that contains flotilla and all its dependencies.

Here are instructions to get an active docker image. These instructions have not been tested on Windows or Linux.

Note: On Mac OS X and Windows you will need to start docker through the “boot2docker” application before you can use docker.

1. Install docker ( ≥ version 1.3) according to the instructions appropriate for your system.

2. Then start flotilla on the command line (OS X Terminal application):

   curl https://raw.githubusercontent.com/YeoLab/flotilla/master/docker/start_docker.py | python