SimSoup: Installation

SimSoup Version 0.4

Installation From Binary

The SimSoup 0.4 binary has been tested on the following distributions:-

Ubuntu 8.04.1
SUSE 11.0
SUSE 10.3
Fedora 9

Dependencies

To run SimSoup, you first need to have the following installed:-

gsl - The GNU Scientific Library: The actual package name varies from distribution to distribution:-

For Ubuntu 8.04.1 it is libgsl0ldbl. It is installed by default by an installation from the live CD
For OpenSUSE 11.0 it is gsl
For OpenSUSE 10.3 it is gsl
For Fedora 9 it is gsl

GTKMM: A C++ interface to the GTK+ GUI library: The actual package name varies from distribution to distribution:-
- For Ubuntu 8.04.1 it is libgtkmm. It is installed by default by an installation from the live CD
- For OpenSUSE 11.0 it is gtkmm2
- For OpenSUSE 10.3 it is gtkmm2
- For Fedora 9 it is gtkmm24. It is installed by default by an installation from the live CD

Installation

Once you have the necessary packages on your system, installation is as follows:-

Unpack the binary archive to a directory of your choice
From the console, change directory to the directory containing the SimSoup binary:-
```
cd simsoup-0.4-linux-i386
```
You can now run SimSoup.
```
./simsoup
```
Open and run the demonstration scenario file (SimSoup_Demo_Scenario in the Scenario_Input directory)

As an alternative to steps (2) and (3), just double click on the file simsoup from a file manager (eg konqueror) to run the demo scenario.

That's it.

Installation From Source

The SimSoup 0.4 build from source has been tested on the following distributions:-

Ubuntu 8.04.1
SUSE 11.0
SUSE 10.3
Fedora 9
Xandros on the eeePC 701

Dependencies

To install SimSoup from source, you first need to have the following installed

A working C++ compiler (eg g++): If the configure script generates a message like "C++ compiler cannot create executables", it may just be trying to tell you that you don't have a compiler! On SUSE 11.0 the compiler package is:-
- gcc-c++
pkg-config: used to retrieve information about installed libraries in the system
make: Used to control the build based on Makefiles produced by the configure script
gsl: The GNU Scientific Library - Development version. The actual package name varies from distribution to distribution:-
- For Ubuntu 8.04.1 it is libgsl0-dev
- For OpenSUSE 11.0 it is gsl-devel
- For OpenSUSE 10.3 it is gsl-devel
- For Fedora 9 it is gsl-devel
- For Xandros on eeePC 701 it is libgsl0-dev
GTKMM: A C++ interface to the GTK+ GUI library - Development version. The actual package name varies from distribution to distribution:-
- For Ubuntu 8.04.1 it is libgtkmm-2.4-dev
- For OpenSUSE 11.0 it is gtkmm2-devel
- For OpenSUSE 10.3 it is gtkmm2-devel
- For Fedora 9 it is gtkmm24-devel (there are two versions available, if you have the run-time package already installed, then install the corresponding version of the development package)
- For Xandros on eeePC 701 it is libgtkmm-2.4-dev

Installation

Once you have the necessary packages on your system, installation is as usual:-

Unpack the source archive to a directory of your choice
From the console, change directory to the top source directory:-
```
cd simsoup-0.4.src
cd src
```
Run the configure script
```
./configure
```
Now compile and link SimSoup
```
make
```
You can now run SimSoup by typing:-
```
./simsoup
```
Open and run the demonstration scenario file (SimSoup_Demo_Scenario in the Scenario_Input directory)
You can also install the binary (eg to the /usr/local/bin/ directory) with
```
make install
```
You need to get administrator permission with su or sudo to do this.

SimSoup Version 0.3

Installation Of Binary Files

There are two binary distributions for SimSoup 0.3:-

SimSoup-0.3-i386-opensuse-10.0.tar.gz: The binaries in this file have been tested on Open Suse 10.0
SimSoup-0.3-i386-suse-9.1-suse-9.2.tar.gz: The binaries in this file have been tested on SUSE 9.1 (Personal Edition) and SUSE 9.2 (Professional). They use an earlier version of libstdc++ than the Open SUSE 10.0 binaries.

In order to run SimSoup version 0.3, you need a Linux system with X Windows and GTK2. SimSoup runs on both KDE and Gnome, but also runs fine on lighter window managers such as WindowMaker. Although SimSoup has been developed and tested on SUSE, it is likely that if you have any Linux installation that runs Gimp or Firefox then it will be able to run SimSoup.

To install, extract from one of the tar.gz files to a directory of your choice. Then open a terminal in this directory and execute the program by typing ./Run_SimSoup at a bash prompt.

If a missing library is reported, then try the binaries in the other tar.gz file.

That's it!

SimSoup Version 0.2

Installation Of Binary Files

The binaries for SimSoup version 0.2 are in the file SimSoup-0.2-i386-linux.tar.gz.

In order to run SimSoup version 0.2, you need a Linux system with X Windows, GTK1 (otherwise known just as GTK) and gdk-pixbuf installed. SimSoup runs on both KDE and Gnome, but also runs fine on lighter window managers such as WindowMaker.

Extract from the file SimSoup-0.2-i386-linux-tar.gz to a directory of your choice. Then open a terminal in this directory and execute the program by typing ./Run_SimSoup at a bash prompt.

That's it!

Source Files

The source files for SimSoup version 0.2 are in the file SimSoup-0.2-src.tar.gz.

SimSoup uses C++ for the main simulation logic and for management of the user interface. It uses Free Pascal and the Lazarus Component Library (LCL) for the presentation of the user interface.

The development environment for SimSoup includes:-

KDevelop 3.1.0, along with gcc
Lazarus 0.9.8 beta, along with the fpc (Free Pascal) compiler

If you want to compile SimSoup, then I recommend you install the above products

The Linux distribution used for development of SimSoup 0.2 is SUSE 9.2 Professional.

SimSoup Version 0.1 - Prototype

Linux

Your system needs to have X installed. SimSoup runs on both KDE and Gnome, but also runs fine on lighter window managers such as WindowMaker.

Extract from the file SimSoup-0.1-i386-pc-linux-tar.gz to a directory of your choice. Now copy the file libborqt-6.9.0-qt2.3.so to a library directory on your system. On SuSE 8.1 the directory /usr/lib can be used.

If for some reason the above does not work, or you want to try SimSoup without copying the file to a system directory, then you can get started by copying the file libborqt-6.9.0-qt2.3.so to any directory of your choice (eg /home/chris/libs) and then typing the following at a bash prompt

LD_LIBRARY_PATH=/home/chris/libs
export LD_LIBRARY_PATH

You can now run SimSoup. Using the -ns command line option (./SimSoup -ns) will run the program without the startup message.

Windows

Extract from the file SimSoup_01_Windows.zip to a directory of your choice.

You can now run SimSoup.exe.