=======================================
              E&F Chaos
=======================================

E&F Chaos is a software package for simulation of nonlinear 
dynamic models to investigate stability of steady states and 
the presence of periodic orbits and chaos by standard numerical 
simulation techniques such as time series, phase plots, 
bifurcation diagrams, Lyapunov exponent plots, basin boundary plots 
and graphical analysis. The package contains many well-known nonlinear 
models, including applications in economics and finance, and is easy 
to use for non-specialists. New models and extensions or variations 
are easy to implement within the software package without the use of 
a compiler or other software. E&F Chaos is developed to provide quick 
information about local and global dynamics and to aid formulating 
challenging research questions for further mathematical analysis.


=======================================
              GNU GPL licence
=======================================


Copyright (C) 2007 Cars Hommes, Cees Diks

This software was developed at the Center for Nonlinear Dynamics 
and Finance (CeNDEF), Faculty of Economics and Business, 
Universiteit van Amsterdam.

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
is published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

This software includes source code initially developed by Roy
van der Weide and Remco Peters. The current version has been 
developed by Valentyn Panchenko.



=========================================
              STRUCTURE
=========================================


E&f chaos is composed of the following parts:

1. Delphi code files (pas files and dfm files - Delphi forms) which is responsibe for interface and major calculations

2. Model files (in the directory /Models with extension mod) which specify the model
This files consist of two parts: header - specifying variables and parameters and 
lua-code part describing the dynamics of the model. 

3. Lua part (lua.dll and lua.pas) which serves as a computationally efficient 
parser between lua-code in model files and Delphi code.

4. Gnuplot files (in the directory /gnuplot) which create eps files. 

NOTE: You need to install an external software to view eps files.


=========================================
              HOW TO COMPILE E&F CHAOS
=========================================

The current version of the code was compiled using Delphi 4.

The following non-standard Delphi packages and libraries are were used in delphi components:

1. Orpheus 3 - UI toolkif for Delphi.
2. LMD-Tools 4.0 - UI tools.
3. Sgraph 2.4 (http://pod0.chat.ru/prg_staf.htm) - a set of 32 bit Delphi components and classes for 2D plots
4. Lua.pas file - an interface between lua.dll dynamic library and Delphi code.

