Skip to main content

Release Notes

LIS Public Release 7.1

Land Information System (LIS) Public Release 7.1r (r5986)

This is the initial release of the public version of LIS 7.1.
  • Includes Noah 3.6
  • Includes NoahMP 3.6
  • Includes CABLE 1.4b
  • Includes flood irrigation
  • Includes drip irrigation
  • Supports VIIRS Daily GVF data
  • Supports TRMM 3B42 V7 real time precipitation
  • Supports Gaussian T1534 GFS met forcing data
  • Supports MERRA-2 met forcing data
  • Supports downscaling precipitation (PRISM) (NLDAS-2 only)
Release Date

LIS Public Release 7.0

Land Information System (LIS) Public Release 7.0rp3 (r5747:5936)

This patch release includes updates r5747:5936.

These updates consist of:

  • Merge branches/untested/p70-r5412-merra2 into 7/public7.0

    I merged r5807:5813 from branches/untested/p70-r5412-merra2 to 7/public7.0.

    These updates consist of:

    • Update MERRA2 reader

      Add Yuqiong Liu's and Eric Kemp's MERRA2 updates. These updates:

      • Read the swgdn and lwgab fields from the rad files.
      • Adjust the times when LIS switches streams.
    • Update the MERRA2 testcase

    • Document the MERRA2 run-time options

  • Merge 7/development into 7/public7.0

    I merged/cherry-picked r5484 from 7/development to 7/public7.0.

    These updates consist of:

    • relaxed the error checking on corrupted files so that the code wouldn't abort, rather revert to a previous day's file
  • Merge branches/untested/p70-r5412-merra2 into 7/public7.0

    I merged r5804:5806 from branches/untested/p70-r5412-merra2 to 7/public7.0.

    These updates consist of:

    • Add support to read MERRA2 metforcing data

    • Correct index to shortwave down (merra-land reader)

      The check to determine whether swd has valid data used the index to lwd. The code to temporally interpolate swd did use the correct index.

  • VIC bug fix for running VIC in subdomain without land grids.

  • Correct an error message for reading restart file.

  • Update RELEASE_NOTES.txt for LIS public release 7.0rp2

Land Information System (LIS) Public Release 7.0rp2 (r5459:5746)

This patch release includes updates r5459:5746.

These updates consist of:

  • Merge 7/development into 7/public7.0

    I merged/cherry-picked r5740 from 7/development to 7/public7.0.

    These updates consist of:

    • Do not reset %zm and %zh for processes with 0 tiles.
  • Do not reset noah33_struc%zm and noah33_struc%zh for processes with 0 tiles.

  • Function added to count VIC state variables, including ones for VIC lake model.

  • Please update LIS-7 public version for the latest updates for VIC 4.1.2.l.

    Binary restart writing/reading now is supported by LIS-VIC (4.1.2.l). Please add

    VIC412 restart file format: "binary" #or "netcdf"
    

    to your lis.config file. With binary data format, LIS-VIC is much faster when writing/reading restart file.

  • Add Kristi Arsenault's CMAP updates

    These update include adding a new grid change update (~2012) and correcting the timing of when to change grids.

  • Update ldt.config file for internal testcases

  • Minor correction to get_cmap.F90 - Files were being skipped when certain output time interval selected (e.g., at or greater than cmap timestep of 6hr). Now every 6-hr file is read in when a model run time step is 6-hr or greater (e.g., daily).

  • Update RELEASE_NOTES.txt for LIS 7 public release patch rp1

Land Information System (LIS) Public Release 7.0rp1 (r5257:5458)

This patch release includes updates r5257:5458.

These updates consist of:

  • Update public testcases

  • LaTeX fixes for in-line documentation

  • Correct when LIS writes output when coupled with WRF

  • Merge 7/development into 7/public7.0

    I merged r5193:5400 from 7/development to 7/public7.0.

    These updates consist of:

    • cleanups in the RTM implementations changed the sprinkler irrigation to use Noah's soil layers (removed the hardcoded layers)

    • Update domain definition in GrADS descriptor files for GLDAS testcase

    • changing assumed arrays to allocatables

    • Convert a locally declared array to allocatable

    • Merge 7/development_svk into 7/development

      I merged r5362:5389 from 7/development_svk to 7/development.

      These updates consist of:

      • gfortran fixes, changed array definitions to allocatables instead of pointer, changed assumed arrays to allocatables

      • removed the commented sections put in for debugging

      • configure template for gfortran

      • changed assumed shape arrays to allocatable, compiling fixes for gfortran

      • A few models turned off for debugging, compiler warning for irrigation modules fixed

      • Aliasing fixes related to MPI_calls

    • Revert commit r5378

      This was a bad merge.

    • Correct calls to LIS_writeHeader_restart and LIS_closeHeader_restart

    • cleanups related to

      1. gfortran support
      2. changing assumed shape arrays to allocatables
    • One small fix and several cleanups.

      In core/LIS_historyMod.F90, added "trim" to the unit strings in the call to write binary output. This fix makes the ASCII stats file look better and consistent with the other output formats (netCDF, etc.).

      In core/LIS_histDataMod.F90, removed some comments only related to the AFWA GRIB file outputs, as they no longer describe the current code.

      In arch/Config.pl, added an trailing space to the print statements querying the netCDF shuffle and deflate filters, and the deflate level.

      In make/Makefile, corrected a typo for SAC-HTET in a comment line.

    • inadvertently took out some trim statements

    • Add reset_princeton routine from Bailing Li

    • Minor fix to logunit statement (will print for any forcing chosen, not just NLDAS-2).

    • small tweaks towards performance improvements

    • Correct computation of accumulative soil moisture

    • Made minor updates to the sprinkler irrigation scheme code, which include a check for whether the write irrigation output switch is turned on; increased flexibility of allowing for other crop maps and crop classification schemes; and updated diagnostic log information depending on land cover classification chosen.

    • bug fixes related to AFWA test case and bug fixes to the history writer

    • Added new LIS diagnostic log statements with which to catch when certain spatial downscaling options are accidentally selected when trying to run on the NLDAS domain with NLDAS forcing.

    • Updated landcover type check in the irrigation sprinkler version.

  • Updates have been made to OHD SAC-HTET for reading daily maximun and minimum temperature (TMXMN) data. Before the updates, all TMXMN data were organized as many datasets in one NetCDF file. For a long term simulation, the NetCDF Fortran reader is slow because the number of datasets is large. Now the TMXMN data are organized day by day. One NetCDF file corresponds to one day, including a dataset of daily maximum temperature and a dataset of daily miminum temperature. After the updates, LIS is significantly faster than before when using the OHD RDHM forcing dataset.

  • Updates have been made to improve LIS performance on reading daily maximum and minimum temperature for SAC-HTET when using OHD RDHM forcing data.

  • Correct quarterly albedo

    This fix corrects when the quarters transition, and it adjusts the temporal weights applied to the quarterly albedo data.

  • Merge NU-WRF updates into 7/public7.0

    I manually merged commits r2329:2341 from the v7_lis7merge branch of the NU-WRF repository on progress, svn/nu-wrf/code/branches/features/v7_lis7merge, into LIS' 7/public7.0 branch.

    These updates consist of:

    • Clean up LIS code to remove debugging statements
    • updates related to NUWRF testing and debugging - includes the MPI aliasing fixes
    • put the trims back - inadvertently taken out
    • turning off the inc_water_pts use
    • part of the fixes to the crash
    • potential fix for the WRF-LIS crashes
    • bug fix to the history writer and minor cleanups
  • Remove old options from Princeton readcrd routine

  • Add Lambert projection parameters into GRIB1 output files

  • Update GRIB parameter id values in Noah 3.3 MODEL_OUTPUT_LIST.TBL for testing

  • Honor the default setting for "Enable AFWA-specific grib configuration settings? (1-yes, 0-no, default=0): " in the Config.pl script

  • Remove debugging print statement

  • Update LIS-WRF coupling mode

    LIS now accepts WRF's time as is, and the order in which LIS writes output and restarts now matches WRF's order.

    A new routine was added to ensure that LIS writes the final output and restart files when WRF ends the simulation.

  • Add relsmc to LIS to WRF export list for Noah 2.7.1

  • Add relsmc to LIS to WRF export list for Noah 3.2

  • Add relsmc to LIS to WRF export list for Noah 3.3

  • Set several undefined variables used in noah33_setwrfexport

    These variables are used by the noah33_setwrfexport to set the LIS-to-WRF export state. They were not properly defined in noah33_main.

    noah%soilm
    noah%qs
    noah%qsb
    noah%qsm
    noah%rootmoist
  • Set several undefined variables used in noah32_setwrfexport

    These variables are used by the noah32_setwrfexport to set the LIS-to-WRF export state. They were not properly defined in noah32_main.

    noah%soilm
    noah%qs
    noah%qsb
    noah%qsm
    noah%rootmoist
  • Update internal testcases

    Specify GTOPO30_LIS in the param_attribs.txt file.

  • Update VIC 4.1.1 testcase

  • Update VIC 4.1.1 so it compiles alongside VIC 4.1.2

  • Modifications have been made to VIC 4.1.2.l to enhance nesting support.

Land Information System (LIS) Public Release 7.0r (r5256)

This is the initial release of the public version of LIS 7.0.

  • Requires companion Land Data Toolkit (LDT) input data and parameter preprocessor

  • Includes VIC 4.1.2.l

  • Includes RDHM 3.5.6 (SacHTET and Snow17)

  • Includes demand sprinkler irrigation

  • Includes HYMAP routing

  • Includes NLDAS routing

  • Includes radiative transfer model support

  • Includes parameter and uncertainty estimation support

    • Genetic algorithm (GA)
    • Monte Carlo sampling (MCSIM)
    • Differential evolution Markov chain z (DEMCz)
  • Supports ensemble of met forcing sources

  • Supports GEOS 5 forecast met forcing data

  • Supports PALS met forcing data

  • Supports PILDAS met forcing data

  • Supports ECV soil moisture data assimilation

  • Supports GRACE data assimilation

  • Supports PMW snow data assimilation

  • Supports SMOPS soil moisture data assimilation

Release Date

LIS Public Release 6.2

Land Information System (LIS) Public Release 6.2rp1 (r4421:4606)

This patch release includes updates r4421:4606.

These updates consist of:

  • Merge 6/development into 6/public6.2

    I merged r4604:4605 from 6/development to 6/public6.2

    These updates consist of:

    • Update arch/configure.lis.linux_ifc because JasPer library was moved
  • Merge 6/development into 6/public6.2

    I merged r4581:4603 from 6/development to 6/public6.2

    These updates consist of:

    • Update RELEASE_NOTES.txt for LIS 6.1rp7
  • Merge 6/development into 6/public6.2

    I merged r4566:4580 from 6/development to 6/public6.2

    These updates consist of:

    • Merge 6/public6.1 into 6/development

      I merged r4431:4579 from 6/public6.1 to 6/development.

      These updates consist of:

      • ProTeX updates

      • Merge NU-WRF updates into 6/public6.1

        I manually merged commits r1412:1720 from the trunk of the NU-WRF repository on progress, svn/nu-wrf/code/trunk, into LIS' 6/public6.1 branch.

        Please note that even though some of these updates are for gfortran support, gfortran is not yet supported in the public release of LIS 6. These particular updates are included for completeness.

        These updates consist of:

        • Merged in updates from v6_macosx branch through r1716.

          • Replaced several pause statements in LIS code. Pause will cause LIS or WRF/LIS to hang indefinitely if executed in batch mode.
          • Changed several C files and a yacc file to #include stdlib.h instead of malloc.h. (malloc.h is non-standard and doesn't exist on OS X.)
          • Changed LIS and LVT Makefiles to greatly trim number of include paths. OpenMPI mpif90 barfed with the original list, but it turns out most paths are unnecessary.
          • Changed LIS C function mangling for gfortran so only single underscore is appended.
          • Changed LIS lib Makefiles to pass optimization flags for gfortran. Also, changed LIS_ARCH from Darwin_intel to Darwin_gfortran.
          • Tweaked ProTex comments to trim end spaces to appease gfortran.
        • Modified Fortran code to avoid use of system function to create directories.

        • Calls to 'system' fail when LIS is run with SGI MPT. Now uses customized C function that uses the POSIX mkdir function under the hood. C code includes macro to appropriately mangle the name for linking with Fortran.

        • Added new create_subdirs function to create directories.

          This is a replacement for invoking the operating system 'mkdir' command via function system. The system call fails when LIS or WRF/LIS are compiled with SGI MPT. This new C function calls the POSIX mkdir function instead.

          TODO: Handle name suffix conventions across different operating systems.

  • Merge 6/development into 6/public6.2

    I merged r4432:4563 from 6/development to 6/public6.2

    These updates consist of:

    • Add Yuqiong Liu's ANSA SCF DI updates

      The following modifications are made to LIS6.2 to enable assimilation of snow cover fraction data using direct insertion:

      • added the observation plugin for assimilating ANSA SCF

        dataassim/obs/ANSA_SCF

      • modified the following file to allow assimilating SCF uisng either the standard (Rodell & House 2004 JHM) or customized (Liu et al 2013 AWR) direct insertion approaches:

        lsms/noah.3.2/da_snow/noah32_map_snow.F90

      • modified the following file in Noah3.2 to save snow density value for use in assimilation

        lsms/noah.3.2/noah32_module.F90
        lsms/noah.3.2/module_sf_noah32lsm.F90
        lsms/noah.3.2/noah32_main.F90
      • modified the following files in the plugins directory to allow ANSA SCF assimilation for Noah.3.2

        plugins/LIS_pluginIndices.F90
        plugins/LIS_DAobs_pluginMod.F90
        plugins/LIS_lsmda_pluginMod.F90
      • modified the follwoing files to allow reading in parameters for assimilating SCF using direction insertion

        core/LIS_PRIV_rcMod.F90
        core/LIS_readConfig.F90
      • modified Filepath to reflect new ANSA SCF observation plugin

      • remove the observation plugin for assimilating ANSA SCA. The new ANSA SCF is more accurate.

    • Add "#NETCDF, no HDF, GRIBAPI" flags to arch/configure.lis.linux_ifc

    • Correcting the latitude of origin value for NARR forcing.

      The correct values for the NARR grid can be found here: http://www.esrl.noaa.gov/psd/data/narr/format.html

    • Remove debugging code from Noah 3.3 read/write restart routines

    • Update length of file name

    • Add Eric Kemp's deep soil temperature TMN updates to Noah 3.3.

    • Bug fix: correct logic regarding evaluating certain conditional statements

      Fortran (nor C) does not guarantee the order in which expressions in a conditional statement will be executed. In a statement like:

      if ( X .and. Y ) then ...
      

      One does not know whether X will be evaluated first or Y. This will be a problem when Y depends on X. For example,:

      if ( present(X) .and. (X .eqv. .true.) ) then ...
      

      (X .eqv. .true.) may be evaluated first, but if X is not present, then X has no value, resulting in either a crash or undefined behavior.

      This example should be written as:

      if ( present(X) ) then
         if ( X .eqv. .true. ) then ...
      
  • Merge 6/development into 6/public6.2

    I merged r4419:4431 from 6/development to 6/public6.2

    These updates consist of:

    • Bug fix: WRFout reader should read RAINNC+RAINC when RAINC is present, otherwise just RAINNC

    • Add Eric Kemp's deep soil temperature TMN updates to Noah 2.7.1 and Noah 3.1

    • Add check to determine whether LIS_rc%tbot_update_lag was enabled

    • Merge NU-WRF updates into 6/public6.1

      I manually merged commit r1411 from the trunk of the NU-WRF repository on progress, svn/nu-wrf/code/trunk, into LIS' 6/public6.1 branch.

      These updates consist of:

      • Merged in v6_lisplugins branch

      • Bug fix: Moved call to LIS_createTmnUpdate after LIS_domain_init.

        This fixes a bug in coupled WRF-LIS where the TmnUpdate pointer is allocated before the number of tiles is set by LIS. It does not affect uncoupled LIS.

      • Bug fixes to reading dynamic deep soil temperature data from LIS restart file.

      • Added bug fixes to output tempbot for earlier Noah LSM versions when requested.

      • Bug fix. Now allows LIS to write tempbot to history file when requested.

      • Bug fixes to dynamic deep soil temperature option.

      • Added soil temperature adjustment module. Fixes to restart code.

      • Initial implementation of WRF deep soil temperature adjustments in WRF.

        Option #1 adjusts climatological deep soil temperature to model terrain height using standard atmospheric lapse rate (6.5 K / km). Always used in REAL.

        Option #2 parameterizes the deep soil temperature as the weighted average of (a) the annual mean skin temperature from the previous calendar year, and (b) the mean daily skin temperature from the most recent N days of the simulation, where N is set by the user (140 days is recommended). The equation is from Salathe et al, J. Climate, 2008:

        Tbot = alpha*mean_annual_skinT_prev_year +
               (1-alpha)*mean_daily_skinT_prev_N_days
        

        where alpha is 0.6. These values of alpha and N are tuned to published observed values of 30% amplitude damping and 70-day lag from skin temperature (per Salathe paper).

        Time series and sums are saved to update these terms at the end of each day (right term) or at the end of the year (left term). I added code to write and read these fields to/from LIS restart files. Note that if LIS is cold started, the climatological deep soil temperature is initially used for both terms and for the N-sized daily time series.

        NOTES:

        • This code compiles but is not test run yet.
        • Only supports Noah 3.2 LSM.
        • Should support either LIS retrospective or WRF/LIS mode.
      • Cherry-pick r4123 from LIS 6/development branch

      • Bug fix regarding interpolating precip for WRFout forcing reader

        WRF writes precipitation accumlated from the beginning of the simulation. Therefore compute the difference between the bookends to find the accumulated precipitation for the hour.

      • Changed code for setting wrfout file names.

        First version of this code was hardwired for original IFLOODS configuration, where some wrfout files were created 9 or 18 seconds past the hours. This is now changed to remove "special rules" and instead just look for files at the expected standard times (e.g., 60 minutes at top of the hour for WRF).

        Users with time steps that prevent wrfout writes at those exact time should create symbolic links to match the date/time filenames expected by LIS.

      • Modified time steps in LIS LSM options to pick correct domain value.

        Note that time step logic for writing history or restart files is undisturbed.

      • Several bug fixes to address WRF/LIS coupling with nests.

        1. CRITICAL Changed LIS Noah.3.2 LSM to use proper domain timestep rather than the smallest of the timesteps for all domains.

        2. TMN (Deep soil temperature) is now passed from WRF to LIS. Requires following entry to forcing_variables.txt:

          TMN:        1  1  K       # Soil Temperature at Lower Boundary
          

          Further work is needed on this, as the TMN used in a LIS spin-up is not necessarily the same as that provided by REAL.

        3. Minor bug fix to cosz (cosine of zenith angle) calculation input to LIS. Currently cosz is not used, but it is passed to the LIS Noah LSM and presumably will be used in the future.

      • Merge LIS 6.1 updates (r4067:4090) into NU-WRF

        • This brings the version of LIS within NU-WRF up to 6/public6.1 r4090.

        • Change build system to include LIS water points again.

        • Now use landusef and the LIS tiling algorithm to pick dominant land cover.

        • Tweak WPS LANDMASK to reconcile with dominant soil type and land cover.

        • Restored bug fix for writing netCDF output header.

        • Bug fix to read shdmin and shdmax from WPS file.

        • Added routine to fetch MMINLU attribute from WPS file.

        • Restored implementation of WRFout suppforcing plugin.

        • Added WPS shdmax and shdmin plugins. Compiles.

        • Merge LIS 6.1 updates (r3885:4066) into NU-WRF

          This brings the version of LIS within NU-WRF up to 6/public6.1 r4066.

        • Second round of fixes. LIS now runs with WRFout plugin.

        • Added LIS as a separate compile target.

          This code is a bit unsettled -- LIS is built, but I don't know what will happen if both WRF and LIS are requested as targets.

        • Added WRFout plugin to LIS.

  • Update RELEASE_NOTES.txt for LIS 6.2r public release

    Highlight that Cable 1.4b is restricted distribution.

Land Information System (LIS) Public Release 6.2r (r3524:4420)

This is the initial release of the public version of LIS 6.2.

This release includes updates r3524:4420.

  • Includes VIC 4.1.1.
  • Includes CABLE 1.4b --- restricted distribution.
  • Includes Catchment F2.5.
  • Includes Noah 3.3.
  • Includes SiB2.
  • Includes WRSI.
  • Support for North American Mesoscale Forecast System (NAM) "242 AWIPS Grid -- Over Alaska" product.
  • Support for USGS potential evapotranspiration (PET) data (for use in WRSI).
  • Support for Climate Prediction Center's (CPC) Rainfall Estimates version 2 (RFE2) daily precipition (for use in WRSI).
  • Support to apply lapse-rate correction to bottom temperature field (for use in Noah).
Release Date