Install

Installation

In order to install Obvius you should have the following things installed

• a CommonLisp System e.g. SBCL
• quicklisp
• git

If you want to install Obvius, the best for now is to download this repository and put it in your quicklisp/local-projects folder. I f you have no clue what i am talking about go to the Vanilla Install section.

Vanilla Install

This section assumes you have neither a CommonLisp system nor git and quicklisp installed. The steps in this section have been tested witha fresh install of Ubuntu 18.04.3.

We need to install

1. Common Lisp
2. Git
3. Quicklisp
4. Obvius

Common Lisp

If you are on Ubuntu open up a terminal and type

install sbcl

sudo apt-get install sbcl git

Quicklisp

Quicklisp is a package management systems which automatically downloads packages and their dependencies.

Open firefox (or a browser of your choice) and go to:

https://www.quicklisp.org/beta

Click on the download link for the quicklisp-lisp file

https://beta.quicklisp.org/quicklisp.lisp

and save it in your home directory.

start sbcl form your home directory (or the directory you stored the quicklisp file)

open a terminal and type:

sbcl

in sbcl type

(load "quicklisp.lisp")

install quicklisp via

(quicklisp-quickstart:install)

and finally to load quicklisp every time you start sbcl

(ql:add-to-init-file)

close sbcl by

(quit)

Load Obvius

The first thing we have to do is to download the Obvius source files:

Open up a terminal and go to the quicklisp directory with local projects

cd quicklisp/local-projects/

then copy the following command or type it

git clone https://github.com/thicksteadTHpp/Obvius.git

This will download the Obvius source files to a place where Quicklisp can find it.

Start Obvius

When we load Obvius for the first time from the REPL quicklisp will download all dependencies which will take while. At first opena terminal in your home directory or go to you home directory with:

cd

then start SBCL by

sbcl

I SBCL type the following quicklisp command to load Obvius and its dependencies. The depnedencies will be downloaded from the internet only once and compiled. This may take a while. If the source code changes the dependencies will be automatically renewed.

(ql:quickload "obvius")

You will see a lot of downloads and compiling. After all went well you should see following screen.

Now switch into the Obvius package by typing

(in-package :obv)

and press RETURN.

You should see that the prompt has changed to OBV>. Now load some test images from the obvius source code.

(make-test-images)

The graphics Backend is for now (Jan 2020) only configured to work correctly from SLIME or SLY. But to test it from the terminal type:

(bt:make-thread #'(lambda () (display einstein)))

and press RETURN. After that you should see somthing like that:

If you want to use Obvius you should install Emacs and SLIME or SLY. From here you should walk through the tutorials.