GLUES Code.hg
Status: Beta
Brought to you by:
platipodium
README file for the Global Land Use and technological Evolution Simulator (GLUES) = Installation = Glues is set up for building on many platforms. To facilitate cross-platform compatibility, the GNU autotools are used. == Quick install == From the .tgz distribution archive, run the file ./configure, then make > ./configure && make You should (but you can) not install GLUES in your system, rather use the provided example scripts run*.sh do execute glues. == More detailed installation == 1. If you downloaded the developer's version via mercurial CVS, you don't have a ./configure script. You can create this with the ./bootstrap shell script. > ./bootstrap > libtoolize 2. Run ./configure, you can find generic help on configure options in the file INSTALL. > ./configure 3. If there are WARNING messages at the end of ./configure, please see below, otherwise, continue to building 4. Run make (preferably gnu make) to build the glues system, you should end up with an executable glues in the directory src. == Warnings and errors during installation == 1. WARNING: no configuration information is in src/sisi There is no ./configure in the subdirectory sisi; this is only needed if you don't have the sisi library installed elsewhere on your system, i.e., if you need a new build of sisi Go to src/sisi and issue ./bootstrap, if you get errors, run autoreconf -fvi, then ./bootstrap again > (cd src/sisi; ./bootstrap || autoreconf -fvi && ./boostrap) Rund ./configure and make, and put the libraries into the lib directory > (cd src/sisi; ./configure && gmake ) > (cp src/sisi/lib/.libs/libSiSi* src/sisi/lib/) 2. Doxygen not found but required to build documentation There is no doxygen on this system, and the documentation will not be build. This doesn't prevent you from running GLUES. If you need the API documentation, install doxygen, and run configure again. 3. Cannot find -lSiSi You might have to copy the libSiSi.* files to src/sisi/lib (see above 1.) 4. Makefile.in not created: please upgrade your version of libtool == What do do if you don't get sisi to build or run == 1. Download the sisi package from the sourceforge site https://sourceforge.net/projects/glues/files/sisi/SiSi2.2.tgz/download 2. Unpack the .tgz file and change to sisi directory 3. run {{{ gmake lib }}} to make the sisi library 4. copy lib/libsisi.* to your systems library directory, ranlib libsisi.* and make an alias of this library under the name libSiSi.* and under the name libSiSi2.0.* 5. copy include to your systems include directory 6. Go back to your glues distribution 7. Create an empty Makefil in src/sisi > echo 'all:' > src/sisi/Makefile 6. ./configure --with-sisi=<directory where you copied sisi lib and include> in glues directory