Release 0.5

Online Coupled LND-HYD Ensemble

This release reorganizes the repository and introduces in-memory ensemble coupling for weakly coupled Land-Hydro DA.

Repository Renamed

"LIS-Hydro" has been renamed/moved to "NASA-Land-Coupler"

Build Changes

Build system has been updated to CMake for better submodule dependency linking. The following scripts simplify the build process.

./configure.sh # Configures LIS and WRF-Hydro components
./build.sh.    # Builds NASA Land Coupler (NLC.exe) with LIS and WRF-Hydro
./setuprun.sh. # Sets up pre-generated use case

NASA Land Coupler: Mediator

The NASA Land Coupler mediator will scatter a bundled LIS ensemble to multiple instances of WRF-Hydro and gather multiple instances of WRF-Hydro into a bundled LIS ensemble.

medAttributes::
 EnsembleMapping = EMAP_NOENSM # No ensemble remapping
 EnsembleMapping = EMAP_ENSLND # Scatter LND ensemble to HYD instances
 EnsembleMapping = EMAP_ENSHYD # Scatter HYD ensemble to LND instances
::

Release 0.4

Side-by-Side HYD Release

This release introduces the side-by-side hydrology feature. A test case has been added to run two side-by-side hydrology components. This compset is available as sbys_tuolumne_hyd.ens002.ldas. This feature is a is a prerequisite to an online coupled LND-HYD ensemble.

LISHydro: LIS Hydro Driver (ESM)

The LIS-Hydro driver will automatically generate multiple hydrology instances based on the runtime configuration variable set in lishydro.runconfig. PET pairs set in lishydro.runconfig define the PET boundaries for each hydrology instance. PET lists for different instances must not overlap.

pets_hyd: 0 3 4 7 8 11 ... # in this example each instance is given 4 processors
multi_instance_hyd: true   # generate multiple hydrology instances
instance_count_hyd: x      # x is the number of instances

Each hydrology instance is suffixed with an instance identifier.

HYD-01, HYD-02, HYD-03, ..., HYD-16, ..., HYD-x

The multi_instance_hyd attribute is passed down to each hydrology instance.

HYD: WRF-Hydro

WRF-Hydro references the NESII/wrf_hydro_nwm_public repository forked from NCAR/wrf_hydro_nwm_public. WRF-Hydro has been updated to support multiple instances using a call to change working directory in the WRF-Hydro cap. If the multiple instance attribute is set to true then the WRF-Hydro cap will change the working directory to a subdirectory with the same name as the component.

multi_instance_hyd: true

Release 0.3

Coupled LND-MED-HYD Release

This release fixes a bug in the Land Information System (LIS) cap to land surface model (lsm) data and adds the LIS NoahMP coupling feature. A test case has been added to run the NoahMP lsm within LIS. This compset is available as coupled_tuolumne.noahmp.nldas2.

LND: Land Information System (LIS)

LIS references the NESII/LISF repository forked from NASA-LIS/LISF. LIS has been updated to support NoahMP coupling and the cap to lsm data hookup for retrospective runs (file based meteorological forcing files) has been fixed.

The LIS cap and LIS-Hydro mediator components have been updated with improved diagnostics. Setting bit 16 (65536) of the Diagnostic attribute will output component state at every coupled time step.

lndAttributes::
  Diagnostic = 65536
::

The LIS cap now supports an import data dependency during initialization. Setting the import dependency to true initializes all import data to values received by connected components. Setting the import dependency to false initializes all import data to zero.

lndAttributes::
  import_dependency = true | false
::

HYD: WRF-Hydro

WRF-Hydro references the NESII/wrf_hydro_nwm_public repository forked from NCAR/wrf_hydro_nwm_public. WRF-Hydro has been updated to an untagged revision dated April 9th, 2019. This revision includes changes to the overland routing data structure.

MED: LIS-Hydro Physics Mediator

This release includes a basic physics mediator. All land and hydrology fields are exchanged through the mediator using redistribution or bilinear interpolation. Configuration of the mediator is handled in the lishydro.runconfig file.

The LIS cap and LIS-Hydro mediator components have been updated with improved diagnostics. Setting bit 16 (65536) of the Diagnostic attribute will output component state at every coupled time step.

medAttributes::
  Diagnostic = 65536
::

The LIS-Hydro mediator now supports multiple data initialization modes. Setting the data initialization to INIT_MODELS initializes all import data to values received by connected components. Setting the data initialization to INIT_DEFAULTS initializes to the defaults in fields.F90.

medAttributes::
  DataInitialization = INIT_MODELS | INIT_DEFAULTS
::

Release 0.2

Coupled LND-MED-HYD Release

This release includes coupled land, hydrology, and mediator components. The coupled Tuolumne test case was used to validate development. This compset is available as coupled_tuolumne.noah.nldas2.

Configurable field connections are now available allowing field specific remapping and masking settings for each connector. Field connection settings are written into the fields.F90 file in the src/driver directory. This feature has been added in order to mask out the infiltration excess of water points.

LND: Land Information System (LIS)

LIS references the NESII/LISF repository forked from NASA-LIS/LISF at d57a2cea4b3c520d319f085d7140e0edb05a018c, a beta commit for LIS 7.3. The NESII/LISF repository was then updated with the LIS NUOPC Cap.

HYD: WRF-Hydro

WRF-Hydro references the NESII/wrf_hydro_nwm_public repository forked from NCAR/wrf_hydro_nwm_public at v5.0.0 and updated with the WRF-Hydro NUOPC Cap.

MED: LIS-Hydro Physics Mediator

This release includes a basic physics mediator. All land and hydrology fields are exchanged through the mediator using redistribution or bilinear interpolation. Configuration of the mediator remapping is handled in the lishydro.runconfig file.

Release 0.1

Initial implementation of the NUOPC-based system with basic build and run system and two supported compsets: uncoupled LIS and uncoupled WRF-Hydro.