Skip to main content

LIS Banner Image

Release Notes

LISF Public Release 7.3.1

Source code

LISF_public_release_7.3.1

This release includes commits 7bf6ab9e27937eeb4d41c70fb9949a9c17b98450 through 0b747e6e63c443ee2f1ab4b2ee4a3e8d81c3f89b on branch support/lisf-public-7.3.

Download: LISF_public_release_7.3.1
 

Documentation

LDT Users' Guide: pdf
LIS Users' Guide: pdf
LVT Users' Guide: pdf

 

Release Notes

LDT

  • Update LDT documentation to reflect all run modes

LIS

  • Call LIS_lsm_DAmapTileSpaceToObsSpace instead of LIS_mapTileSpaceToObsSpace

    The routine LIS_mapTileSpaceToObsSpace was broken into LIS_surfaceModel_DAmapTileSpaceToObsSpace, LIS_lsm_DAmapTileSpaceToObsSpace, and LIS_routing_DAmapTileSpaceToObsSpace.

    The code in jules5x_map_snodep.F90 and jules5x_map_usafsi.F90 was calling the old routine, which leads to a compile-time error.

  • Correct typo of HYMAP2 option in lis.config.adoc
  • Refine JULES-5.0 snow DA checks against attrib file maximums

    This commit refines JULES-5.0 snow DA checks as recommended by @yyoon, @yhkwon81, and @emkemp on the comments to this pull request.

    Instead of hard-coding a value above which snow DA is not performed, the maximum values in the attribs file are used.

    Also, consistency checks between the SWE and snow depth after snow DA against the maximums are performed, using the snow density.

    The recommended JULES-5.0 SWE and snow depth maximums are lowered to their previous values, and now are consistent with the numbers used by Noah-3.9 and Noah-MP-4.0.1 LSMs.

    (cherry picked from commit b2f7a10)

  • Change JULES-5.0 snow DA state variable quality control

    This pull request includes changes to code that quality controls JULES-5.0 state variables for snow DA for the SNODEP and USAFSI products. These changes include:

    Turn off snow DA when snow depths are very high

    Use snow density from the JULES-5.0 state variable

    Check snow density against JULES-prescribed maximum/minimum

    Only check SWE and snow depth maximum when doing an update

    Increase the recommended SWE and snow depth maximum values

    in the attributes file

    (cherry picked from commit b97424e)

  • Fix HYMAP2 2-way coupling in parallel mode

    HYMAP2 2-way coupling was not working properly when run in parallel. This fix adds dummy subroutines to the land-surface models which allow the 2-way coupling options to work properly. A more robust fix might be added in the future.

    Resolves: #605

LVT

  • Commented out LVT_statsEntry fields in LVT_stats object.

    Newer versions of GFORTRAN will hang and often fail in lvt/core/LVT_statsDataMod.F90, due to an acknowledged compiler bug. This avoids the compiler bug by commenting out all LVT_statsEntry fields in the LVT_stats object.

    It turns out that these fields are not actually used by LVT -- the LVT_statsEntry objects used instead are separately created and organized as a linked ist. Commenting out these fields does not change the runtime behavior of LVT, and allows compilation with GFORTRAN.

  • Added restart capability for PSS, PODY, and PODN.
  • Fixed bug in writing RMSE STDEV counts to output.
  • Fix LVT Max and Min metric time series output

    This pull request fixes time series output for the Max (maximum) and Min (minimum) metrics from LVT.

    The MEAN metrics code was cleaned-up as well, but the output for this metric will not change at all.

    A testcase is coming soon.

    Resolves: #705

  • Correct SAC SWE units

ALL

  • Support compiling LISF without HDF-EOS2

    Several data assimilation obs readers require HDF-EOS2 support, but they were checking for HDF4. Thus if you disabled HDF-EOS2 at configure-time with

    "Use HDFEOS? (1-yes, 0-no, default=1): 0"

    then these routines would fail to compile.

Release Date

LISF Public Release 7.3.0

Source code

LISF_public_release_7.3.0

This release includes commits through fd5810a6458192138e20357a91ca82c79ed68d10 on branch support/lisf-public-7.3.

Download: LISF_public_release_7.3.0
 

Documentation

LDT Users' Guide: pdf
LIS Users' Guide: pdf
LVT Users' Guide: pdf

 

Release Notes

Release notes

  • Ensure that the USAF processing scripts use Python3
  • Correct typo regarding generating USAFSI filenames

-->

What's new in LDT

  1. Includes new runmodes
    • USAF snow and ice analysis (USAFSI) runmode
    • optimization and uncertainty estimation procecssing runmode
    • LIS Hydro preprocessing runmode
    • climatological restart processing runmode
  2. Supports additional data assimilation observations
    • GLASS LAI observations
    • GRACE QL tws observations
    • Land Parameter Retrieval Model (LPRM) vegetation optical depth observations
    • NASA SMAP vegetation optical depth observations
  3. Supports additional parameters
    • CLM45 parameters
    • glacier parameters
    • JULES 5.0 parameters
    • MERIT1K aspect, slope, and elevation parameters
    • HYMAP flow type, baseflow dwi ratio, and runoff dwi ratio parameters
    • Barlage native max snow albebdo parameter
    • MODIS native PFT landcover data
    • UKMO IGBP PFT landcover data
    • UM ancillary landcover data
    • NLDAS climatological precipitation data
    • UKMO IGBP native PFT landmask data
    • UKMO CAP landmask data
    • ISRIC texture and soil fraction parameter data
  4. Supports GCOMW AMSR2 TB data in artificial neural network processing running mode
  5. Supports ERA5 metforcing data in Metforcing processing running mode

What's new in LIS

  1. Includes new runmodes
    • RTMforward runmode
    • AGRMET ops runmode
    • GCE-coupled runmode
    • landslide optUE runmode
  2. Includes additional surface models
    • NoahMP 3.9.1.1 glacier model
    • template glacier model
    • FLake 1.0 lake model
    • AWRA-L 6.0.0 land model
    • Jules 5.0 land model
    • Noah 3.9 land model
    • NoahMP 4.0.1 model
  3. Includes HYMAP2 router
  4. Includes ESPboot forecasting algorithm
  5. Includes GLS landslide application
  6. Includes TRIGRS landslide application
  7. Includes additional data assimilation algorithms
    • extended Kalman filter algorithm
    • ensrf algorithm
    • particle filter algorithm
  8. Includes additional optimization and uncertainty alogrithms
    • Enumerated Search algorithm
    • Shuffled Complex Evolution - University of Arizona (SCEUA) algorithm
  9. Includes Levenberg-Marquadt (LM) parameter estimation objective function
  10. Supports additional real-time parameters
    • albedo parameters
    • emissivity parameters
    • roughness parameters
  11. Supports additional metforcing datasets
    • AMMA land surface model intercomparision project phase 2 (ALMIPII) metforcing data
    • Australian Water Resource Assessment Landscape (AWRA-L) metforcing data
    • Canadian Precipitation Analysis (CaPA) data
    • FASSTsingle metforcing data
    • downscaled MERRA2 precipitation data over the High Mountain Asia domain from GMU (HiMAT_GMU)
    • Loobos metforcing data
    • arms metforcing data
    • era5 metforcing data
    • gdas3d metforcing data
    • gefs metforcing data
    • mrms metforcing data
    • pptEnsFcst metforcing data
    • usaf metforcing data
  12. Supports additional data assimilation observation datasets
    • simGRACE_JPL observations
    • syntheticSnowTb observations
    • syntheticlst observations
    • syntheticsf observations
    • syntheticsm observations
    • syntheticsnd observations
    • syntheticswe observations
    • syntheticwl observations
    • AMSRE SWE observations
    • AFWA NASA snow algorithm (ANSA) SWE retrievals
    • ASCAT_TUW observations
    • ASO_SWE observations
    • GLASS Albedo observations
    • GLASS LAI observations
    • IMS_sca observations
    • International Satellite Cloud Climatology Project (ISCCP) skin temperature observations
    • MODIS SPoRT LAI observations
    • NASA SMAP vegetation optical depth retrievals
    • SMAP near-real time (NRT) soil moisture observations
    • SMOPS AMSR2 soil moisture observations
    • SMOPS ASCAT soil moisture observations
    • SMOPS SMAP soil moisture observations
    • SMOPS SMOS soil moisture observations
    • SNODEP observations
    • SYN_LBAND_TB observations
    • USAFSI observations
    • WindSat_Cband_sm observations
    • multisynsmobs observations
  13. Supports additional parameter estimation observation datasets
    • Walnut Gulch (WG) PBMR soil moisture observations
    • ARM observations
    • ARSsm observations
    • Ameriflux observations
    • CNRS observations
    • FLUXNET observations
    • Global_LS_data observations
    • ISCCP_Tskin observations
    • ISMNsm observations
    • Macon_LS_data observations
    • SMAP soil moisture observations
    • University of Arizona (UA) swe/snow depth observations
    • USDA ARS soil moisture observations
    • pesynsm1 observations

What's new in LVT

  1. Includes new runmodes
    • 557post runmode
    • USAFSIpost runmode
  2. Includes additional metrics
    • Anomaly Rank Correlation metric
    • Clayton Skill Score (CSS) metric
    • Conditional Entropy metric
    • Detection Failure Ratio (DFR) metric
    • Event Frequency (EF) metric
    • Forecast Frequency (FF) metric
    • Heidke Skill Score (HSS) metric
    • Information Entropy metric
    • Joint Entropy metric
    • K-means metric
    • Mutual Information metric
    • Peirce Skill Score (PSS) metric
    • Reliability metric
    • Resiliance metric
    • Relative Entropy metric
    • Standard Precipitation Index (SPI) metric
    • Triple collocation metric
    • Tian False Alarm Bias (TFB) metric
    • Tian Hit Bias (THB) metric
    • Tian Miss Bias (TMB) metric
    • Trends metric
    • Vulnerability metric
  3. Supports additional data streams
    • TRMM 3B42V7 data stream
    • Atmospheric Land Exchange Inverse (ALEXI) model Evaporative Stress Index (ESI) data stream
    • APHRODITE (Asian Precipitaton - Highly-Resolved Observational Data Integration Towards Evaluation) daily gridded precipitation data stream
    • NASA Airborne Snow Observatory (ASO) snow water equivalent (SWE) data stream
    • CHIRPSv2 data stream
    • ECMWF forcing data stream
    • ERA5 data stream
    • FLUXCOM data stream
    • FLUXNET2015_NC data stream
    • GDAS forcing data stream
    • GLASS albedo data stream
    • GLASS LAI data stream
    • High Asia Reanalysis (HAR) precipitation data stream
    • Indian Meteorological Department (IMD) unified gauge-based analysis of daily precipitation data stream
    • IMERG data stream
    • JULES2Ddata data stream
    • Land Parameter Retrieval Model (LPRM) vegetation optical depth data stream
    • MERRA2 asm data stream
    • MOD10A1V6 fractional snow cover data stream
    • MODIS SPoRT LAI data stream
    • MODSCAG fractional snow cover data stream
    • OCO-2 Solar Induced Fluorescence (SIF) data stream
    • OzFlux data stream
    • Soil Moisture Active Passive (SMAP) L3 Tb data stream
    • Soil Moisture Active Passive (SMAP) vegetation optical depth data stream
    • Soil Moisture Active Passive (SMAP) vegetation water content data stream
    • University of Arizona (UA) SWE/Snow Depth data stream
    • UCLA SWE reanalysis data stream
    • jasmin data stream
Release Date

LDT Public Release 7.2r, LIS Public Release 7.2r, LVT Public Release 7.2r

LIS is now on GitHub! Please see our latest announcement for more details:  LISF on GitHub

 

A new LIS Framework public release is coming soon and will be made publicly available on our LISF GitHub page.

Last public release version was 7.2r, and information for that are found below:

Land surface Data Toolkit (LDT) Public Release 7.2r (r6983:7558)

Land Information System (LIS) Public Release 7.2r (r6996:7551)

Land surface Verification Toolkit (LVT) Public Release 7.2r (r5927:7374)

Version: LDT_public_release_7.2r, LIS_public_release_7.2r, LVT_public_release_7.2r
Release date: 6 May 2017

The Land Information System Framework (LISF) is released under the terms and conditions of the NASA Open Source Agreement (NOSA) Version 1.3. To download and/or use the LISF software you must agree to the LISF NOSA.

Source Code

LDT change log

This is the public release of LDT 7.2.

  • Changed a large static array to a dynamic allocatable one, as memory issues were being found when adding other large parameter datasets.

  • Added minor updates to LDT log errors and comments.

  • Added check for when a 'CONSTANT' landcover is selected but also for when the fill option is set to 'none'. The fill option is used to specify the landcover type.

  • Updated the LDT PRISM precipitation monthly climatology reader and testcase.

  • Future updates will be needed to accommodate the newer PRISM data format (*.bil), which will make future releases.

  • Updated the LDT-based SRTM test case.

  • Updated the Noah v3.3 LSM parameter test case for LDT.

  • Updated the LDT-based USGS landcover reader.

  • Updated the LDT-based HYMAP test case

  • Updated the LDT-based GeoWRSI test case.

  • Updated log comment in ensemble restart routine

  • Updated the "Constant" parameter test case.

  • Updated the MOD44W mask file test case for LDT.

  • Updated the LDT-based CLSM F2.5 test case.

  • Added the Metforce NLDAS-2 processing test case

  • Removed the testcase for RDHM, v3.5.6, since a version of that testcase exists in the LIS public testcases.

  • Removed a couple of additional LDT test cases and added an updated NLDAS2 elevation parameter test case.

  • Updated the LDT ensemble restart upscaling test case.

  • Updated the LDT ensemble restart downscaling test case.

  • Updating and removing some of the built-in (stand-alone) LDT testcase directories.

    New testcase updates to be committed soon.

  • Commented out lines in each supplemental observed precip reader (e.g., CMAP) that calculate the ratio between a convective rainfall field and companion rainfall or total precip field.

    An error was found in each reader that the convective precip field was not getting passed from the 'baseforcing' type dataset readers and resulting in full 0-valued fields, which were overwriting the convective precip of the baseforcing in the output fields.

    So for the upcoming LIS Spring 2017 release, this feature was turned off for now and will be fully implemented in the next release.

  • Fixed subroutine calls related to the "average" upscaling option for the RFE2gdas forcing reader.

    Former lines of code no longer matched the input/output types related requirements.

  • updates to the SMAP data plugin to fix an interpolation issue when using a regional domain

  • Added the updated ECMWF reset routine, as now also found in the LIS dev branch.

  • Added minor updates to the CHIRPS daily reader; and implemented the "corrected" convective precip and snowfall fields to the MERRA2 reader.

  • Fixed an uninitialized variable in the LIS LSM data reader for DAobs

  • Fixed the requirement for the missing_data global flag in the NUWRF mode

  • Made additional corrections / updates to read_gdas routine.

  • Made minor updates to the CHIRPS2 forcing module.

  • Added Eric Kemp's correction to the pds5 array. (from LIS-7 public)

  • Update Param_SRTMtile testcase

  • Made a temporary update to the CHIRPS v2 daily reader, where the user can specify the starting name of the CHIRPS daily "annual" netcdf-formatted files.

    This update has been implemented for now to support reading in either CHIRPS ("S" - station-corrected) or the original "CHIRP" global precipitation forcing dataset.

    Options in the LDT config file can be specified as:

    1. CHIRPS station-corrected dataset: (filenames starting with: "chirps-v2.0" CHIRPS2.0 forcing directory: ../CHIRPSv2/daily_p05/chirps-v2.0
    2. Original CHIRP precipitation: (filenames starting with: "chirp" CHIRPS2.0 forcing directory: ../CHIRP/chirp

  • Added new minor features to the MERRA2 reader in LDT to support 'none' spatial and temporal interpolation options, which allow the user to read in the "native" MERRA-2 files without alteration by LDT.

    Such options are supported within each of the metforcing run mode methods.

  • Updated the GEOS5 forecast reader in the LDT development branch to match what Sujay updated in LIS dev branch.

    This updated GEOS5 code has not been tested yet as forcing ensemble support needs to be fully added into LDT. To be done in near future.

  • Implemented the zterp correction recently implemented by Jim Geiger and Hiroko Beaudoing in the LIS dev code. It incorporates Hiroko's zterp correction used at run-time.

    Please see Trac ticket #113.

    To enable this correction, add this to your LIS run-time configuration file (lis.config):

    Enable new zterp correction (met forcing): .true.

    This option has the default setting of .false.

  • Added minor updates to the MERRA-2 forcing reader. Allowing native fields be read in and be processed through by run-modes, like temporal downscaling and climatology generation.

  • Removed the obsolete "geos" forcing dataset option, as this will no longer be supported in future LDT versions. This forcing option supported older GEOS versions (3 and 4).

  • Added options to use NCEP-LIS slopetype and tbot datasets to RUC LSM.

LIS change log

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

  • Includes the NOAA Rapid Update Cycle (RUC) 3.7.1 land surface model
  • Includes the ensemble streamflow prediction (ESP) conventional forecasting runmode
  • Includes additional parameter and uncertainty estimation support
    • Differential evolution Markov chain (DEMC)
    • Levenberg-Marquardt
    • Random walk Markov chain monte carlo
  • Includes additional radiative transfer model support
    • Tau Omega
  • Data assimilation is performed on the observation grid
  • Supports HYMAP runoff data
  • Supports ANSA snow depth observations
  • Supports GCOMW AMSR2 L3 soil moisture observations
  • Supports GCOMW AMSR2 L3 snow depth observations
  • Supports NASA SMAP soil moisture observations
  • Supports PILDAS soil moisture observations
  • Supports SMMR snow depth observations
  • Supports SMOS L2 soil moisture observations
  • Supports SMOS NESDIS soil moisture observations
  • Supports SSMI snow depth observations
  • Supports AWAP precipitation data
  • Supports LDT generated met forcing climatology data
  • Supports generic ensemble forecast met forcing data
  • Supports GRIB 2 formatted output

LVT change log

This is the public release of LDT 7.2.

  • Changed a large static array to a dynamic allocatable one, as memory issues were being found when adding other large parameter datasets.

  • Added minor updates to LDT log errors and comments.

  • Added check for when a 'CONSTANT' landcover is selected but also for when the fill option is set to 'none'. The fill option is used to specify the landcover type.

  • Updated the LDT PRISM precipitation monthly climatology reader and testcase.

  • Future updates will be needed to accommodate the newer PRISM data format (*.bil), which will make future releases.

  • Updated the LDT-based SRTM test case.

  • Updated the Noah v3.3 LSM parameter test case for LDT.

  • Updated the LDT-based USGS landcover reader.

  • Updated the LDT-based HYMAP test case

  • Updated the LDT-based GeoWRSI test case.

  • Updated log comment in ensemble restart routine

  • Updated the "Constant" parameter test case.

  • Updated the MOD44W mask file test case for LDT.

  • Updated the LDT-based CLSM F2.5 test case.

  • Added the Metforce NLDAS-2 processing test case

  • Removed the testcase for RDHM, v3.5.6, since a version of that testcase exists in the LIS public testcases.

  • Removed a couple of additional LDT test cases and added an updated NLDAS2 elevation parameter test case.

  • Updated the LDT ensemble restart upscaling test case.

  • Updated the LDT ensemble restart downscaling test case.

  • Updating and removing some of the built-in (stand-alone) LDT testcase directories.

    New testcase updates to be committed soon.

  • Commented out lines in each supplemental observed precip reader (e.g., CMAP) that calculate the ratio between a convective rainfall field and companion rainfall or total precip field.

    An error was found in each reader that the convective precip field was not getting passed from the 'baseforcing' type dataset readers and resulting in full 0-valued fields, which were overwriting the convective precip of the baseforcing in the output fields.

    So for the upcoming LIS Spring 2017 release, this feature was turned off for now and will be fully implemented in the next release.

  • Fixed subroutine calls related to the "average" upscaling option for the RFE2gdas forcing reader.

    Former lines of code no longer matched the input/output types related requirements.

  • updates to the SMAP data plugin to fix an interpolation issue when using a regional domain

  • Added the updated ECMWF reset routine, as now also found in the LIS dev branch.

  • Added minor updates to the CHIRPS daily reader; and implemented the "corrected" convective precip and snowfall fields to the MERRA2 reader.

  • Fixed an uninitialized variable in the LIS LSM data reader for DAobs

  • Fixed the requirement for the missing_data global flag in the NUWRF mode

  • Made additional corrections / updates to read_gdas routine.

  • Made minor updates to the CHIRPS2 forcing module.

  • Added Eric Kemp's correction to the pds5 array. (from LIS-7 public)

  • Update Param_SRTMtile testcase

  • Made a temporary update to the CHIRPS v2 daily reader, where the user can specify the starting name of the CHIRPS daily "annual" netcdf-formatted files.

    This update has been implemented for now to support reading in either CHIRPS ("S" - station-corrected) or the original "CHIRP" global precipitation forcing dataset.

    Options in the LDT config file can be specified as:

    1. CHIRPS station-corrected dataset: (filenames starting with: "chirps-v2.0" CHIRPS2.0 forcing directory: ../CHIRPSv2/daily_p05/chirps-v2.0
    2. Original CHIRP precipitation: (filenames starting with: "chirp" CHIRPS2.0 forcing directory: ../CHIRP/chirp

  • Added new minor features to the MERRA2 reader in LDT to support 'none' spatial and temporal interpolation options, which allow the user to read in the "native" MERRA-2 files without alteration by LDT.

    Such options are supported within each of the metforcing run mode methods.

  • Updated the GEOS5 forecast reader in the LDT development branch to match what Sujay updated in LIS dev branch.

    This updated GEOS5 code has not been tested yet as forcing ensemble support needs to be fully added into LDT. To be done in near future.

  • Implemented the zterp correction recently implemented by Jim Geiger and Hiroko Beaudoing in the LIS dev code. It incorporates Hiroko's zterp correction used at run-time.

    Please see Trac ticket #113.

    To enable this correction, add this to your LIS run-time configuration file (lis.config):

    Enable new zterp correction (met forcing): .true.

    This option has the default setting of .false.

  • Added minor updates to the MERRA-2 forcing reader. Allowing native fields be read in and be processed through by run-modes, like temporal downscaling and climatology generation.

  • Removed the obsolete "geos" forcing dataset option, as this will no longer be supported in future LDT versions. This forcing option supported older GEOS versions (3 and 4).

  • Added options to use NCEP-LIS slopetype and tbot datasets to RUC LSM.

Release Date
Jump to Top