                   EasySDE  -  Version 2.1
                   =======================

EasySDE simplifies the development of height growth / site-index models
based on stochastic differential equations (SDEs).

This is free open source software, distributed under the MIT License:
See the file copyrights.txt.

Latest versions, etc., are at www.unbc.ca/forestry/forestgrowth/sde


Installation in MS Windows:
~~~~~~~~~~~~~~~~~~~~~~~~~~~
This has been tested on Windows XP.
       
1. Installer
   a) Execute, and follow displayed instructions (presumably you have
      already done this).
   b) Check that you have now shortcuts to EasySDE and SitePlot in the
      Desktop, and to these and to documentation in the Start Menu.
   c) See the User Guide.  For this you will need a PDF reader.  The
      free Acrobat Reader can be obtained from
      http://www.adobe.com/products/acrobat/readstep2.html
   d) Run the programs by double-clicking on the shortcuts.
   e) For convenience, you may want to place your data and output files
      in the "Work" subdirectory under "EasySDE".
   f) To uninstall use the "Uninstall" shortcut, or the Windows standard
      procedure through the Control Panel.

2. Manual, from zip file 
   a) Unzip in C:\, using the zip folder names (other directories can
      be used, but then the shortcut properties need to be changed).
   b) Optionally, move the shortcuts EasySDE and SitePlot to the Desktop
      and/or Start Menu.
   c) See the documentation in \EasySDE\Doc\Guide.pdf
   d) Run the programs by double-clicking on the shortcuts.
   e) For convenience, you may want to place your data and output files
      in \EasySDE\Work.
   f) To uninstall, just delete the EasySDE directory and the shortcuts.

There is additional documentation in Advanced.pdf in the EasySDE\Doc\
directory, supplemented by other pdf files. Other software mentioned
there, and sources, are in EasySDE\ and/or in EasySDE\Sources\. A Fortran
compiler is needed for some of the more advanced uses; a suitable one is
available from http://forestgrowth.unbc.ca/sde/g77win.zip (unzip into C:).


Installation in linux:
~~~~~~~~~~~~~~~~~~~~~~~~~~~

   a) If not already available, install tcl/tk, and/or gnuplot (version
      4.0 or higher).
   b) Uncompress EasySDE-*.tgz somewhere, through the GUI or with the
      gunzip command.
   c) Optionally, create menu entries or shortcuts for EasySDE.tcl and
      SitePlot.tcl.  There are suitable icons in SDE.png and Plot.png
   d) See the documentation in EasySDE/Doc/Guide.pdf
   e) Run the programs through the menu, shortcut, by double-clicking on
      the file name, or from the command line.
   f) For convenience, you may want to place your data and output files
      in EasySDE/Work.
   g) To uninstall, just delete the EasySDE directory and any shortcuts.

There is additional documentation in Advanced.pdf in the EasySDE/Doc
directory, supplemented by other pdf files. Other software mentioned
there, and sources, are in EasySDE and/or in EasySDE/Sources.  A Fortran
compiler such as g77, gfortran or f2c is needed for some of the more
advanced uses.


History
~~~~~~~
21/05/03, Version 1.0	First public release.
07/07/03, Version 1.1	Corrected crash when number of plot measurements
			exceeded 20, limit of 99 now works.  Added plot ID
			to /ESDE/ COMMON.  Minor changes to documentation
			(see stem analysis note in 3.1 of the User Guide). 
25/09/09, Version 2.0
    - Fixed: Model 15 (ABLOCALS) was using the wrong derivatives (those from
      Model 13), causing slow progress and/or the convergence tests to fail.
    - Fixed: DataPrep.exe did not properly skip over extra header lines in
      the optional InputPars file as described in Section 2.2 of the Advanced
      and Programmers Manual.
    - Added models for breast-height age in the GUI.  Changed age at breast
      height to 0.5 years (see Guide).  Changed model numbering.
    - Maximum number of globals increased from 6 to 10, to accommodate
      "grouping" applications (see Examples in the Advanced notes).
    - Linux version.
    - Documentation improvements, examples added to the Advanced notes.
    - Clean-up code, avoiding compiler and Fortran Checker warnings.
    - Added reventlow.dat example data set.
28/01/12. Version 2.1
    - Fixed issue with the handling of plot ID's that might have slowed
      down or impede convergence in complex custom models described in
      Section 4.3 of the Advanced and Programmers Notes. The plot ID is
      now included as the first item in the parameter file described in
      Section 3.3 of Appendix B of the Notes.
    - Changed list-directed output statements to formatted output, for
      compatibility with the gfortran compiler (it inserts extra spaces
      between list items), and possibly others.
    - When the extension was not given for save files, the dot was missing
      in the names before the defaults log and rpt.
    - On linux, the compile script appended a spurious CR control character
      to the executable file name. Also, changed to prefer gfortran over g77.

Oscar Garcia, January 2012.
