Software Package for the models used in

Eisenack K., Welsch H. & Kropp J. (2006): "A qualitative dynamical 
modelling approach to capital accumulation unregulated fisheries"
Economic Dynamics and Control, (DOI:10.1016/j.jedc.2005.08.004).

NB! The models provided in this package do not need an installation of the 
original QSIM version (cf. the following webpage: http://www.cs.utexas.edu/
users/qr/QR-software.html ). The provided package includes CQ which is a C-language 
implementation of Benjamin Kuipers' QSIM algorithm for qualitative simulation. 
CQ is based on the research tool QSIM, but it is written in C++ in place
of LISP. The C implementation is portable to any system having a C++ compiler 
and standard C libraries. The model syntax is nearly the same than under QSIM.

Table of contents of the CQ model archive
===========================================

readme.txt:	this file
cq-guide2.pdf:	User Guide for CQ
toymodel.run:	source code for the toy model (for explanations in sec. 2)
mainmodel.run:  source code for the qualitative bio-economic model (sec. 4 ff.)
cropper.run:	source code of the Cropper model

add-ons:
*.ps, *.eps, *.pdf: 	postscript/PDF files of the solutions for the certain models obtained 
			by the runs of the three models
*.dot  			Results of mainmodel and toymodel in a script language appropriate 
			for processing with dot (technical)

Further Documentation
=====================

- Code of the models: mainmodel.run, toymodel.run, cropper.run
- Kuipers (1994): Qualitative Reasoning


Guidlines to install CQ
=======================

The executable runs on a Linux platform with gcc version 2.95.3 or
version 3.2.2 (e.g. on SuSe Linux 8.x). To test the version, type
"gcc -v" in the shell. We have currently no Windows version available
(due to licences from third parties).

1. unpack the archive qsim_progs.tgz with
   "gzip -dc qsim_progs.tgz | tar -xvf -"

2. Copy all files from this directory to your working directory.

3. Copy the file 'dot' to a directory for executables, e.g. to /usr/local/bin.

4. If not already done, install ghostview.

[5. If Gostview cannot be invoked by 'gv' from the shell, set an appropriate link in the
directory with executables, e.g.: Go to /usr/local/bin and 
type 'ln -s <location&name of ghostview> gv'. The location of ghostview can be found 
by typing 'whereis <name of ghostview>'.]


Start simulation
===================

type

./cq -I <modelname>

in the shell, e.g. ./cq -I toymodel.run.