InstallationStructure

LANDIS-II Installation Directory

The structure of the LANDIS-II installation directory is designed to allow:

• multiple versions to be installed side-by-side on a computer.
• multiple versions to share common files (e.g., GDAL).

  LANDIS-II/
     bin/      <-- scripts to run LANDIS-II
     GDAL/     <-- native libraries
     vX/       <-- version X series (X.1, X.2, ..., X.Y)
  

LANDIS-II/bin/

This directory contains the command scripts to run LANDIS-II. It also contains scripts to run the tool for managing LANDIS-II extensions. This is the directory that should be added to the PATH environment variable.

    LANDIS-II/
       bin/
          landis.cmd                 <-- calls landis-ii.cmd
          landis-ii.cmd              <-- see Note 1
          landis-X.Y.cmd             <-- run LANDIS-II version X.Y
          landis-extensions.cmd      <-- see Note 1
          landis-vX-extensions.cmd   <-- run extensions tool for version X series

Note 1: These scripts will use the version specified by the LANDIS_VERSION environment variable if it's set. If the variable is not set, then the scripts will use the highest version that's installed.

LANDIS-II/GDAL/

This directory contains the native (unmanaged) libraries for GDAL.

    LANDIS-II/
       GDAL/
          1.9.1/
             *.dll

This allows different versions of LANDIS-II to share a particular version of GDAL.

LANDIS-II/vX/

This directory contains the version X series (X.1, X.2, ..., X.Y).

    LANDIS-II/
       vX/
          bin/        <-- binary (executable) files for the model and installed extensions
          docs/       <-- user guides for the model and installed extensions
          examples/   <-- example input files for the model and installed extensions

LANDIS-II/vX/bin

This directory is structured so that all the minor versions in the version X series can share extensions. So when a new minor version is installed, the user does not have re-install all the extensions.

    LANDIS-II/
       vX/
          bin/
          |- X.0/
          |- X.1/
          |- ... 
          |- X.Y/                                 <-- model core and its libraries for version X.Y
          |  |- Edu.Wisc.Forest.Flel.Util.dll
          |  |- Landis.Core.dll
          |  |- Landis.SpatialModeling.dll
          |  |- log4net.dll
          |  |- Troschuetz.Random.dll
          |  \- ...
          |
          |- Landis.Console-X.0.exe
          |- Landis.Console-X.0.exe.config
          |- Landis.Console-X.1.exe
          |- Landis.Console-X.1.exe.config
          |- Landis.Console-X.Y.exe               <-- console interface for version X.Y
          |- Landis.Console-X.Y.exe.config        <-- configuration file for console X.Y
          |
          \- extensions/                          <-- extensions and their libraries for version X series
             |- Landis.Extension.HelloWorld.dll
             |- Landis.Library.FooBar.dll 
             \- ...