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 directory structure

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 
         \- ...