This page is under construction.

LIS is the Land Information System developed by NASA GSFC. There are 2 versions of LIS currently maintained by the CMS team: LIS offline and LIS coupled to WRF known as NU-WRF. This page is about the LIS offline software. See the NU-WRF page for the coupled version.

Getting the code

LIS is under license and is only available to persons which are part of the ARCCSS institutions and partners. As such it is kept under private repositories under BitBucket. Also the code is only maintained to be used on NCI machine. As such to get the code you will need a BitBucket account (free) and preferably access to the NCI machine. To get access to the BitBucket repositories please contact climate_help stating which institution you are part of.

Code organisation

LIS actually consists of 3 different tool packages:
  • LDT - LIS Data Toolkit, a pre-processing toolkit to process input data into LIS format. User's guide.
  • LIS - the model itself. User's guide.
  • LVT - LIS Verification Toolkit, a post-processing toolkit that enables to run standard statistics and calculations on the outputs. User's guide.
Each package is stored under its own repository. You will probably need at least LDT and LIS to run a LIS simulation.

Configure and compilation

Note: HDF compatibility on NCI machine has not been tested yet.

Each package comes with its own configure and compilation mechanism that is explained in details in the User's guides.
Because of requirements from the software and compiler compatibility between modules here are the current restrictions to configure the codes on NCI:
  • You need to use the intel compiler version
  • You need to use ESMF version 6.3.0rp1-intel
  • You need to use netcdf version 4.3.0 or higher
For convenience, the files run_configure and run_compile were added to the packages. run_configure defines a default configuration, you might want to check as a lot of options exist (e.g. use HDF4 and/or 5, netcdf version to use, etc.) so you might need to modify or add some variable definitions before running the configuration. run_configure should be run interactively.

For run_compile, simply review the PBS options before submitting to the queue.

Running the code

To run LIS one needs to create a run directory, preferably outside LIS code as it will be used to run LIS, LDT and maybe LVT. LIS comes with various test cases in LIS/testcases. Each test case comes with a README file to explain how to run it. For the moment, only the public/GLDAS testcase has been run on NCI machine. Also note that currently there is no test case to run with CABLE.

In this version of LIS, one needs to run LDT first to create the LIS input file from the fixed input files. LDT will interpolate the input files to the grid used in your LIS simulation. Note that LDT does not come with an efficient regridding tool so if the input files are at a much higher resolution than the LIS grid then you need to regrid your input files first with the exception of the vegetation types map. A regridding library is available on BitBucket as well, this will regrid all the default input files that are currently maintained by the Centre. If you have a modified or an additional file, you can either modify a current regridding program or add your own. Please contact climate_help to know more.

Note that LDT does not have parallel capabilities currently and must be run on 1 processor only.

Status of CABLE within LIS

CABLE v.2.3.4 is currently available within LIS v7.1. Only a first initial testcase was run.
Here are the common options for CABLE that have not been tested or enabled yet:
  • Carbon diagnostics (not implemented)
  • Tiled diagnostics (not implemented)
  • a few other diagnostics (not implemented)