Installing IDyOM¶

Prerequisites¶

• Steel Bank Common Lisp [SBCL]
• Quicklisp is a library manager for Common Lisp. Just download quicklisp.lisp
• An SQL database. I would recommend SQLite

Many people find Emacs with Slime useful for Common Lisp development. Package management systems can simplify the installation of these prerequisites, e.g. Fink or Macports for OS X.

See the CLSQL 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, CLSQL, CL-PPCRE, PS-Graph, Midi

Install Quicklisp¶

To install Quicklisp to a directory DIR, you need to load quicklisp.lisp in Lisp:

(load "quicklisp.lisp")
(quicklisp-quickstart:install :path "DIR/quicklisp/")
(ql:add-to-init-file)

Download IDyOM¶

Download the following Lisp libraries, and unzip them into DIR/quicklisp/local-projects/

• MIPS
• AMuSE
• amuse-viewpoints
• mtp-admin
• ppm-star
• idyom

The local-projects directory should now contain six subdirectories, one for each library.

Set *idyom-root*¶

IDyOM requires the global variable *idyom-root* be set to a suitable working directory, where it can cache results etc. One way to do this is to include the following in your the .sbclrc file, located in your home directory, and then restart SBCL:

(setq *idyom-root* "PATH/TO/WORKING/DIR/")

IDyOM will use this directory to store caches (*idyom-root*/data/cache/), models (data/cache/) and resampling sets (data/resampling/). Create these directories.

Install IDyOM¶

You can now use Quicklisp to install IDyOM:

(ql:quickload "idyom")

This will also install the third-party Lisp libraries IDyOM depends on. The first time it loads, you may get an error which brings up the debugger. Press 2 [ACCEPT] and the installation should complete.

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 DIR:

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

Alternatively, to connect to an existing local MySQL database:

(clsql:connect '("localhost" "example-database" "username" "password") :if-exists :old :database-type :mysql)

See the CLSQL documentation for more on connect and supported databases.

Finally, for a new database:

(mtp-admin:initialise-database)

You may now proceed to the tutorial.

Problems loading foreign libraries¶

Depending on how your system is configured, clsql:connect may give a "Couldn't load foreign libraries" error. In this case, you
need to tell CLSQL where it can find these libraries, e.g.

(clsql:push-library-path "/usr/local/mysql/lib/")

The exact path will depend on your system. Note that, for some database installations these libraries may not have been installed, and you should consult the database documentation.

Create a startup script [optional]¶

Every time you start IDyOM, you will need to connect to the database. You may find it easier to combine all the startup commands in a single script, e.g.

(ql:quickload "idyom")
(clsql:push-library-path "/usr/local/mysql/lib/")
(defun connect-example ()
  (clsql:connect '("DIR/example.db") :if-exists :old :database-type :sqlite3))
(connect-example)