Installation

DICE was originally designed to run on Linux, which means it will probably also run on OSX without too much trouble. If you are planning to run it on Windows, modifications will be necessary.

Note

DICE does not hardcode in a given version of Python. Whatever python interpreter is first in your PATH will be the one that gets used.

We reccommend using a virtualenv to make things easy if you do not have permissions to modify the system’s python installation or if you want a way to segment the environment necessary for DICE.

Prerequisites

The following modules should be installed in your python installation:

  • pyner
  • beautifulsoup4
  • lxml

Install Steps

First, grab a copy of DICE from the DICE Downloads page and install like so:

$ curl -O http://stick.ischool.umd.edu/files/dice-0.1.0.tar.gz
$ tar xzvf dice-0.1.tar.gz

Next, you can use firstrun.sh in the root directory to set up auxilary tools used by DICE. This will create a tools directory:

$ ./firstrun.sh

Setting up a virtualenv

A virtualenv allows you to partition off an environment containing modules specifically needed to run DICE. You can blow it away later and start from scratch if need be. As of this writing, the most current version is virtualenv 1.9.1. Please check here to find the lastest version. Follow the steps below to get started:

cd ~/Downloads    # pick a location to save to temporarily
curl -O https://pypi.python.org/packages/source/v/virtualenv/virtualenv-1.9.1.tar.gz
tar xvfz virtualenv-1.9.1.tar.gz
cd virtualenv-1.9.1
python virtualenv.py ~/dice-env
cd .. && rm virtualenv-1.9.1.tar.gz && rm -rf virtualenv-1.9.1

So now he have a virtualenv available to use. However, it’s not what will be used if we still type python in a shell.:

$ which python
/usr/bin/python
$ source ~/dice-env/bin/activate
(dice-env) $ which python
/Users/liam/dice-env/bin/python

Now, whenever you type python, you will be using our virtualenv python. To use the system-default version of python again, either use an absolute path to it (e.g. /usr/bin/python) or deactivate the virtualenv:

(dice-env) $ deactivate
$ which python
/usr/bin/python