Modified: June 18, 2009 Everglades Landscape Model (ELM) THIS README.txt FILE MUST REMAIN ASSOCIATED WITH THE ELM CODE & DATA in an obvious location (i.e., in the ELM_HOME directory) Model Installation For an ELM application, acquire the (single-file) ELMx.y_distribution.tar.gz tarball, where 'x.y' denotes the version.subversion number. ADDITIONALLY, you really should acquire the model documentation report!! If you haven't already, go to the ecolandmod.com web site to download those files, under a GNU General Public License (see below). This gnu-zipped ELMx.y_distribution.tar.gz tarball file contains 9 files: 1) source code archive (filename.tar.gz) and an associated Notes.txt file 2) data archive (filename.tar.gz) and an associated Notes.txt file 3) installer (text) files (ELMinstall.sh, ELMsetenv_bash, ELMsetenv_tcsh) 4) a copy of this README.txt file 5) an archive (filename.tar.gz) of Doxygen-generated code documentation To install the model: 1) Unpack the ELMx.y_distribution.tar.gz tarball (example below) prompt>gunzip ELMx.y_distribution.tar.gz prompt>tar -xvf ELMx.y_distribution.tar 2) Run the ELMinstall script (as below) prompt>./ELMinstall.sh 3) Follow the onscreeen prompts 4) Read the model documentation, esp. the Chapt. 10 User's Guide!!! To understand the model: 1) Read the model documentation 2) Contact the developer(s) if there are gaps in the documentation. To understand the code (mainly for programmers): 1) Read the model documentation 2) After you unpacked the distribution tarball, a tar.gz file containing Doxygen-generated code documentation will be in your $ELM_HOME directory. Unpack that archive, then doubleclick on the ./doxyELM/ELMsrc_document.html symlink to view the hyperlinked code documentation 3) Contact the developer(s) if there are gaps in the documentation. Feedback on the installation process and on the model is always appreciated. Model Origins The ELM was initiated (1993) as an open source project by faculty at University of Maryland's Maryland Institute for Ecological Economics, under a contract with the South Florida Water Management District. It uses the Spatial Modeling Environment (SME) developed by faculty at the University of Maryland. Model Contact The lead developer of the ELM is: H. Carl Fitz, email = carlfitz3@gmail.com EcoLandMod, Inc. Other major code contributors, from early development: SME: Tom Maxwell (now at Science Applications, Inc.) Water management: Alexey Voinov (University of Vermont, alexey.voinov@uvm.edu) The ELM application web site contains contact information for the numerous scientists and engineers who have collaborated on this project. Model Documentation Documentation of the public release of the ELM v2.5 is found at: http://my.sfwmd.gov/elm/ and at: http://ecolandmod.com Current documentation of development releases is found at: http://ecolandmod.com Open Source software This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as 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. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.