LUE tutorial

Branch	Status
main
develop

Use cases

We have added relatively simple use-cases here, to illustrate what LUE can be used for. They are very simple, which is on purpose of course. LUE hides much of the complicated stuff to perform very large models on large amounts of hardware.

BTW, we accept pull-requests for additional use-cases, so please do contribute yours if you have any.

Current list:

• Universal Soil Loss Equation (USLE)
• Conway's Game of Life
• Merge raster
  • Run a non-LUE numerical simulation model concurrently for multiple areas, and aggregate the results in a single LUE dataset.

Quick start

To be able to run one or more use-cases, the following steps must be performed first:

• Install a Conda client, like Miniforge.

• Clone the tutorial repository:

  git clone https://github.com/computationalgeography/lue_tutorial.git
  cd lue_tutorial

• Create and activate a Conda environment with the required Python packages:

  conda env create --file=environment/configuration/conda_environment.yml
  conda activate lue_tutorial

In case you want / need to use the latest development version of LUE, checkout the develop branch before creating the Conda environment. That branch contains a slightly different conda_environment.yml and possibly updates to the use-case Python code.