Installing DSI2

Note: Download instructions are for Mac OS users only

Dependencies

Here we describe how to install DSI2 on your system. Before DSI2 will work, a number of python packages must be installed. The Enthought’s Canopy is very useful if you work in academia and is highly recommended. Otherwise you will need to install the following packages:

Even if using Canopy, you will need to install the following packages:

First, install MongoDB.

Next, use the “pip install _____” command in your terminal to install these packages. Make sure that you have Xcode (from the app store) and the command line tools installed ahead of time:

Next, you will be using Canopy’s “Package Manager” in the welcome screen as shown below:

_images/welcome_canopy.png

Search for “scikit” and install the top two packages:

_images/canopy_install.png

Below are additional links that can assist you if you run into problems or if you are not using Canopy:

Open your terminal to download the DSI2 source code:

The DSI2 source code can be downloaded from github. Get the source by

$ git clone git@github.com:mattcieslak/DSI2.git
$ cd DSI2-master
# If you have write permission to your python distribution
$ python setup.py install
# otherwise
$ export PYTHONPATH=$PYTHONPATH:`pwd`

Setting up your environment

On a Mac, edit your .profile script to include this line, assuming you installed dsi_studio.app in /Applications.

alias dsi_studio=/Applications/dsi_studio.app/Contents/MacOS/dsi_studio

Starting MongoDB

You will need to start a mongod process if you intend to use the MongoDB backend. If you are running on a single machine and do not want to open your ports to the world remember to pass a --bind_ip argument to mongod. For example

$ mongod --bind_ip 127.0.0.1

Verifying your installation

Download the unit testing data