Home

Welcome to the OCML wiki! Here you will find instructions on how to install, run, and use OCML.

If you are new to Git and Github, we recommend that you consult the excellent Github Help page where you will find step by step instructions on how to install Git and create a Github account (though, note that a Github account isn’t necessary for you to clone the OCML Git repository).

CONTENTS

• Installing OCML
• Starting OCML
  • Setting the ontology path

Installing OCML

Assuming you already have Git installed on your machine, open a command console and run the following command:

git clone git://github.com/kmi/ocml.git

That should get you a directory called ‘ocml’, containing the latest version. To keep up to
date, you need to run the following command from inside the ocml directory created by the “git clone” command:

git pull

Starting OCML

The following instructions have been tested with SBCL. In addition to SBCL, OCML also runs under Lispworks and Allegro.

The following instructions assume that ASDF is available. Step 3. below could differ depending on how your LISP implementation relates to ASDF.

1. Start SBCL. E.g. in a command line console, type:

sbcl  

2. Add the path to the directory containing OCML (the directory created by the git clone command that you run for installating OCML), to asdf:*central-registry*. Assuming this directory is /path/to/ocml/, type in SBCL:

(push "/path/to/ocml/" asdf:*central-registry*)

3. Load OCML.

(require :ocml)

Alternatively, if you use a LISP which doesn’t integrate ASDF with require, load OCML as follows:

(asdf:operate ’asdf:load-op :ocml)

3. Initialise OCML.

This may be done in two ways:

3a. Switch to the ocml package:

(in-package :ocml)

and initialise OCML:

(initialize-ocml)

3b. In one go:

(ocml:initialize-ocml)

The result should look like:

Initializing OCML 
; follows a series of comments which you can ignore as long as the last line is:
T

At this point, OCML has started and you can interact at the SBCL prompt.

Setting the ontology path

Also at this point you may want to let the OCML system know the path to the ontology files that you have created or are going to create. After you initialize OCML, by default it expects to find ontology files in the ‘library’ subfolder of your OCML installation — i.e. /path/to/ocml/library/.

If you wish system to also look to another path on your machine then you can add that path to the ocml:*ontology-path* variable as follows:

(push "/my/local/onto/path/" ocml:*ontology-path*)