phy-4660/chaos/CFJChaos/ReadMe.txt

CHAOS FOR JAVA - APPLICATION VERSION.

The software is free for non commercial use without explicit permission 
from the author. Before downloading or using it it you must read and agree
to the licence agreement. All other rights reserved.

Copyright <20>1999-2003 Brian Davies.

IMPORTANT NOTICE:

Application Version 1.2.2 has no expiry date, but you should visit the website

http://sunsite.anu.edu.au/education/chaos

for information on later versions.

FEATURES:

Features of Application Version, beyond those of the Applet Version
documented in my book "Exploring Chaos: theory and experiment", are 
briefly summarised as:

1. After startup there is a window which has menus and buttons. In the 
MacOS9 version the window may be hidden using the close box (which does 
not actually close it), in other versions it may be minimized once some
other window(s) are open, since all windows carry menus (for the MacOS X
version, menus are at the top of the screen and always present).

2. Documents may be saved and then re-opened. You will be prompted 
automatically about saving. Note that no computational or graphical 
information is saved, only the parameter and window settings necessary 
for exact reconstruction.

3. Pictures/Graphs may be saved in the following cross platform formats:

   (i) GIF - the compression algorithm is subject to patent and you assume
       responsibility for any use you make of the output. This format may 
       be omitted from future versions.

   (ii) JPEG - the compression is not lossless but the quality setting is 
       high, so the files will be quite large. In most circumstances this 
       will not be the appropriate format to use.

   (iii) PNG - this format was introduced (in part) to circumvent the use 
       of patented algorithms. There is increasing support for PNG format 
       in Browsers and Word Processors. The files will be small - probably
       smaller than the GIF output.
       
4. Printing is possible, using the rudimentary printing features of Java 1.1.
Because of these limitations, printing is not particularly good.  Device and
resolution independence are supported in Java 1.2 (aka Java 2) and I expect
to move to this when time permits.

5. Preferences may be saved and re-loaded, ie, all choices available via 
the Preferences menu. You will be prompted automatically about saving if 
needed. Note that preferences are application wide, ie, fonts apply to all
windows, colours to all windows of that type, ie, Bifurcation Diagrams 
have distinct colour settings from Fourier Analysis, and so on.

BUG REPORTS:

Bug reports may be sent to

Brian.Davies@anu.edu.au

but it is essential to quote all the information in the startup panel, ie

   (i) the platform and operating system - displayed top left,
   (ii) the virtual machine information - displayed top right,
   (iii) the Chaos for Java version - displayed bottom.

VERSION HISTORY:

   Version 1.0 - June 30, 1999. Original version released for use with book.

   Version 1.0.1 - August 2, 1999. Resolves an incompatibility with 
     Internet Explorer 5 for Windows.

   Version 1.0.2 - September 22, 1999. Minor bug fixes.

   Version 1.0.3 - October 1, 1999. Minor changes to allow application 
     versions.

   Version 1.0.4 - November 1, 1999. Enhancement (animation) of "Graphical
     Analysis".

   Version 1.0.5 - January 7, 2000. Minor bug fixes.

   Version 1.1 - January 28, 2000. First application version.

   Version 1.1 - March 1, 2000. Common applet/application version.

   Version 1.1.1 - May 5, 2000. Save as png (portable network graphics) 
     format. 8th order Runge-Kutta integration of ODEs. Enhancements 
     of application version user interface.

   Version 1.1.2 - November 1, 2000. Minor bug fixes. Enhancements of user 
     interface and application preferences. Iterate(1d) has animation and 
     includes 2d maps. Return maps include 1d maps. Saved files not all 
     compatible with previous versions. 

   Version 1.1.3 - April 24, 2001.
     (i)  Major enhancement of Iterate(2d) to allow investigation of fixed 
     points of two dimensional maps and compositions. The zero-curves of 
     x - f(x,y) and y - g(x,y) may be viewed in the x-y plane, accurate positions 
     and eigenvalues of fixed points may also be obtained. 
     (ii)  ODEs: the two-well oscillator [f(x) = x(1-x^2)] and Duffing oscillator 
     [f(x) = -x(1+x^2)] are included. 
     (iii)  File format: version 1.1.3 will read and convert files saved from 
     version 1.1.2 but the new file format is incompatible with earlier ones. 
     (iv)  Minor bug fixes and user interface enhancements. 

   Version 1.1.4 - October 22, 2001. 
     (i)  Minor bug fixes and enhancements. 
     (ii)  Version 1.1.4 will read and convert files saved from versions 1.1.2 
     and 1.1.3 but the new file format is incompatible with earlier ones.

   Version 1.1.5 - June 1, 2002.
     (i)  Minor bug fixes. 
     (ii)  Some features not documented in "Exploring Chaos: Theory and Experiment" 
     temporarily removed.

   Version 1.2 - June 2, 2003. 
     (i)  Complete refactorisation of all code.
     (ii)  Numerous interface improvements.
     (iii)  Choice of display modes.
     (iv)  Dual orbits for Poincar<61> sections.
     (v)  Fixed points and stability analysis for compositions of two-dimensional
     maps and Poincar<61> sections.
     (vi)  Graphical visualisation of bifurcations of two-dimensional maps and
     Poincar<61> sections.
     (vii)  Basins of attraction for Poincar<61> sections.
     (viii)  Bifurcation diagrams of stable and unstable orbits for two-dimensional maps.
     (ix)  Better estimates of accuracy of fixed points of two-dimensional systems.
     (x)  Variational equations used for Lyapunov exponents of Poincar<61> sections.

   Version 1.2.1 - Septembeer 30, 2003. 
     (i)  Minor big fixes.
     (ii)  Improved algorithm for one-dimensional bifurcation diagrams (periodic orbits).
     (iii)  MacOSX version has "aqua" appearance and Java 2 printing.

   Version 1.2.2 - November 30, 2003. 
     (i)  Java 2 printing for all platforms.
     (ii)  Improvements to the graphical user interface.
     (iii)  Minor bug fixes.

ACKNOWLEDGEMENTS

Development of this software has been assisted by support from the 
Australian Apple University Consortium, 

http://auc.uow.edu.au/

an international cooperative program between Apple Computer and Australian
Universities. One of its aims is to develop educational software for the 
Macintosh environment.

The Gif Encoder is Copyright (1996) by Jef Poskanzer (jef@acme.com).

The Jpeg Encoder is Copyright (1998) by James R. Weeks and BioElectroMech 
(James@obrador.com).

The Png Encoder is Copyright (2000) by J. David Eisenberg 
(david@catcode.com) (GNU Lesser General Public License).

         -----------------------------------------------------------------------