README

   1 =======================================
   2 1. iDmc -  Dynamical Model Calculator
   3 =======================================
   4
   5 This is iDMC the interactive Dynamical Model Calculator simulates and
   6 performs graphical and numerical analysis of systems of differential
   7 and difference equations.
   8
   9 iDmc is Copyright (C) 2004-2007 Marji Lines and Alfredo Medio.
  10
  11 iDmc was designed and written by Daniele Pizzoni <auouo@tin.it>, and
  12 subsequently modified by A. Grigoriev and A. F. Di Narzo.
  13
  14 iDmc was developed within a research project financed by the Italian
  15 Ministry of Universities, the Universities of Udine and Ca'Foscari of
  16 Venice, the Friuli-Venezia Giulia Region.
  17
  18 This program is free software; you can redistribute it and/or modify
  19 it under the terms of the GNU General Public License version 2 as published by
  20 the Free Software Foundation.
  21
  22 This program is distributed in the hope that it will be useful, but
  23 WITHOUT ANY WARRANTY; without even the implied warranty of
  24 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  25 General Public License for more details.
  26
  27 ============================
  28 2. What's new in this 2.x.x
  29 ============================
  30 In this version there are some new features w.r.t. version 1.9.3.
  31
  32 * Data exporting
  33 - ability to export trajectory, Lyapunov exponents and basins of attraction data
  34 to external files, ready to be opened with the software of your choice
  35
  36 * Basins of attraction
  37 - added a new faster algorithm for basins of attractions
  38 - added full colors customization in basin of attraction plots, with possibility
  39   of saving settings between one session and another
  40
  41 * Random numbers
  42 - added many new random distributions
  43 - added a whole new random number generator with good statistical properties
  44 - added possibility of setting RNG seed for reproducibility of results
  45
  46 * Periodic cycles
  47 - added cycles classification based on stability
  48 - improved input mask
  49
  50 * Error messages
  51 - more detailed syntax and runtime LUA error messages reporting
  52
  53 * Bug fixes
  54 - misc problems in Lyapunov exponent plots with diverging exponents
  55
  56 * Invisible to user
  57 - removed C code from the software. Now iDMC (i.e., GUI and plotting)
  58   is written entirely in Java, while using a separate specialized library,
  59   idmclib, for actual numerical analysis
  60 - upgraded external libraries to more recent versions
  61
  62 Read the NEWS file for a detailed history of changes for subsequent iDMC versions.
  63
  64 ==================================
  65 3. Other software included in iDmc
  66 ==================================
  67
  68 iDmc includes or may include (depending on how you compile it) parts
  69 from different free software packages distributed with GPL-compatible
  70 licenses. You can find copies of the licenses under the directory
  71 doc/licenses. A comprehensive list follows.
  72
  73 idmclib
  74 -------
  75
  76 The iDMC C support library
  77
  78 Copyright (C) 2006-2007 Marji Lines and Alfredo Medio.
  79
  80 http://code.google.com/p/idmclib
  81
  82 GPL v.2 licensed
  83
  84
  85 JFreeChart
  86 ----------
  87
  88 A free Java class library for producing charts.
  89
  90 (C)opyright, 2000-2003, by Object Refinery Limited and Contributors.
  91
  92 http://www.jfree.org/jfreechart/index.html
  93
  94 LGPL licensed
  95
  96
  97 JFreeCommon
  98 -----------
  99
 100 A free general purpose Java class library
 101
 102 (C)opyright, 2000-2003, by Object Refinery Limited and Contributors.
 103
 104 http://www.jfree.org/jcommon/index.html
 105
 106 LGPL licensed
 107
 108
 109 JGoodies Forms
 110 --------------
 111
 112 A framework to layout and implement elegant Swing panels quickly and
 113 consistently.
 114
 115 Copyright (c) 2003 JGoodies Karsten Lentzsch.
 116
 117 www.JGoodies.com/
 118
 119 BSD licensed
 120
 121
 122 Jakarta log4j
 123 -------------
 124
 125 A logging package. With log4j is possible to enable logging at runtime
 126 without modifying the application binary.
 127
 128 Copyright 1999-2003, Apache Software Foundation
 129
 130 Licensed with The Apache Software License, Version 1.1
 131
 132
 133 ===============
 134 4. Availability
 135 ===============
 136
 137 iDMC is distributed in precompiled binary and source form.
 138 Self-installing binaries are distributed for win32 and linux-i386 OS.
 139 Istructions are boundled for compiling iDMC yourself for other
 140 platforms.
 141
 142 ===============
 143 5. Installation
 144 ===============
 145
 146 Execute "java -jar iDmc-xx.xx.xx-install.jar" to run the installer under Windows
 147 and i386 GNU/Linux.
 148 See COMPILING to install from sources.
 149
 150 =================
 151 6. Reporting Bugs
 152 =================
 153
 154 Send mail to idmc-discussion@googlegroups.com to report bugs and/or request help.
 155