IDyOM Project

h1. Installing IDyOM

h2. Prerequisites

* "Steel Bank Common Lisp [SBCL]":http://www.sbcl.org/platform-table.html

* "Quicklisp":http://www.quicklisp.org/beta/ is a library manager for Common Lisp.  Just download "<code>quicklisp.lisp</code>":http://beta.quicklisp.org/quicklisp.lisp

* An SQL database.  I would recommend  "SQLite":http://www.sqlite.org/ 

Many people find "Emacs":http://www.gnu.org/software/emacs/ with "Slime":http://common-lisp.net/project/slime/ useful for Common Lisp development.  Package management systems can simplify the installation of these prerequisites, e.g. "Fink":http://www.finkproject.org/ or "Macports":http://www.macports.org/ for OS X.

See the "CLSQL Manual":http://clsql.b9.com/manual/ for information on other database systems you can use and how to access them from Common Lisp.  If you prefer not to use Quicklisp, you will need to install the following Lisp libraries: "UFFI":http://uffi.bi.com, "CLSQL":http://clsql.b9.com, "CL-PPCRE":http://www.weitz.de/cl-ppcre/, "PS-Graph":http://www.cliki.net/psgraph, "Midi":http://www.cliki.net/midi

h2. Install Quicklisp

To install Quicklisp to a directory <code>DIR</code>, you need to load "<code>quicklisp.lisp</code>":http://beta.quicklisp.org/quicklisp.lisp in Lisp:

<pre>

(load "quicklisp.lisp")

(quicklisp-quickstart:install :path "DIR/quicklisp/")

(ql:add-to-init-file)

</pre>

h2. Download IDyOM

Download the following zip files and unpack them into <code>DIR/quicklisp/local-projects/</code>

* "MIPS":https://code.soundsoftware.ac.uk/hg/mips/archive/tip.zip

* "AMuSE":https://code.soundsoftware.ac.uk/hg/amuse/archive/tip.zip

* "amuse-viewpoints":https://code.soundsoftware.ac.uk/hg/amuse-viewpoints/archive/tip.zip

* "mtp-admin":https://code.soundsoftware.ac.uk/hg/mtp-admin/archive/tip.zip

* "ppm-star":https://code.soundsoftware.ac.uk/hg/ppm-star/archive/tip.zip

* "idyom":https://code.soundsoftware.ac.uk/hg/idyom/archive/tip.zip

h2. Load IDyOM

You can now use Quicklisp to load IDyOM, and install the external Lisp libraries it depends on:

<pre>

(ql:quickload "idyom")

</pre>

The first time IDyOM is loaded, an error "There is no class named AMUSE-SEGMENTATION:GROUND-TRUTH-SEGMENTER" may bring up the debugger.  Press 2 [ACCEPT] and the installation should complete.

h2. Create a database

IDyOM is now installed, but you will need a database in order to use it.  To create an SQLite database in directory <code>DIR</code>:

<pre>

(clsql:connect '("DIR/example.db") :if-exists :old :database-type :sqlite3)

(mtp-admin:initialise-database)

</pre>

You may now proceed to the [[tutorial]].