1 Introduction

This document describes the AnT-demos, which show some of the features
of the AnT 4.669 software package.

2 System requirements

For starting the demos please make sure, that the AnT 4.669 software
package is installed on your system. If the AnT 4.669 software package
is not installed, please install it according to the installation
instructions in the README.core file available at the download
section. The demos require the visualization tool gnuplot (version
3.7), which is available on most UNIX platforms. In order to build the
shared object of the demo systems required by the AnT computation
engine, you need the GNU Make utility and the GNU C++ compiler
(version 2.95.3 or higher). Please make also sure, that your PATH
environment variable contains the path to the AnT executable.
Otherwise the Makefiles for building the shared objects of the demos
can't find the header file AnT.hpp required during compilation of the
demo systems. The GNU Make utility will be also used for starting the
demos.

3 How to start the demos

By unpacking the tar-archive, the directory AnT-demos will be
created. This directory contains this README and two subdirectories,
namely systems and scripts. Please go into the subdirectory
systems. Here, you will find further subdirectories (like logistic,
roessler, pll, etc.), containing demos for several dynamical
systems. Please choose a dynamical system (for instance, logistic) and
go into the corresponding subdirectory.  Here you will find a Makefile
and a C++ source file 'systemname'.cpp (for instanve logistic.cpp)
containing the implementation of the dynamical system. Concerning the
implementation, please see the Reference Manual, Part II. Now you have
to call the Make utility typing make or gmake depending on your UNIX
platform. This invokes the build process, and an object file
'systemname'.o together with the shared object file 'systemname'.so
will be created (for instance, logistic.o and logistic.so). The shared
object contains the system function and serves as a plugin to the AnT
computation engine so that the engine can deal with the corresponding
dynamical system.

After the system function is compiled and linked, you can go into the
subdirectories containing the demos (like demo01, demo02, etc.). Here
you can start the corresponding demo by calling the Make utility
again. This will start the AnT computation engine using the
corresponding system function library from the parent directory (for
instance, ../logistic.so) and the initialization file from the current
directory (say, ./logistic.ant). Subsequently, gnuplot will be started
with the script file demo.plt in order to visualize the data files
produced by the AnT computation engine. The resulting diagrams will be
shown on the screen and additionally saved in two formats: .png
(Portable Network Graphics) and .ps (Postscript). You will find these
files in the subdirectories (./ps and ./png).

Finally, you can remove the generated files by calling the GNU Make
utility with the clean target typing make clean or gmake clean. Note,
that the diagrams will be removed also. The same instruction called in
the parent directory will remove the the object file and the shared
object file containing the system function.

Only the demos in the demo03 directories of the lorenz63 and roessler
system behave different, because they automatically invoke the OpenGL
based visualization module of the AnT 4.669 software package. Here
three windows of the AnT 4.669 visualization pop up. You may click on
the Start button in the main window to start the visualization.

If you have any questions or comments please feel free to contact us
at

                     mail@AnT4669.de