From 4aabf969d4aa5dc37052ea4c9b1bfb302fec1640 Mon Sep 17 00:00:00 2001 From: Dan Copsey Date: Wed, 10 Sep 2025 12:47:36 +0100 Subject: [PATCH 1/2] Add new switches --- .../doc/source/namelists/jules_hydrology.nml.rst | 13 +++++++++++++ user_guide/doc/source/namelists/model_grid.nml.rst | 14 +++++++++++++- 2 files changed, 26 insertions(+), 1 deletion(-) diff --git a/user_guide/doc/source/namelists/jules_hydrology.nml.rst b/user_guide/doc/source/namelists/jules_hydrology.nml.rst index eed5d792..d208350c 100644 --- a/user_guide/doc/source/namelists/jules_hydrology.nml.rst +++ b/user_guide/doc/source/namelists/jules_hydrology.nml.rst @@ -87,6 +87,7 @@ This file sets the hydrology options. It contains one namelist called :nml:lst:` .. note:: Setting :nml:mem:`JULES_HYDROLOGY::l_top` = FALSE and :nml:mem:`JULES_HYDROLOGY::l_pdm` = FALSE selects a more basic runoff production scheme. In this scheme, surface runoff comes only from infiltration excess runoff (no saturation excess runoff), and subsurface runoff comes only from free drainage from the deepest soil layer (no lateral flow from mid-layers), as described in Essery et al. (2001, HCTN 30). + .. nml:member:: l_limit_gsoil :type: logical @@ -99,6 +100,18 @@ This file sets the hydrology options. It contains one namelist called :nml:lst:` Allow the soil conductance to increase as the top layer soil moisture goes above the critical soil moisture, as in Best et al. (2011) equation 7. +.. nml:member:: l_inland + + :type: logical + :default: F + + TRUE + Some rivers end at inland basin flow points. This inland basin flow is used to increase soil moisture at these locations. + + FALSE + No inland basin flow. + + .. nml:group:: Only used if :nml:mem:`JULES_HYDROLOGY::l_top` = TRUE .. nml:member:: zw_max diff --git a/user_guide/doc/source/namelists/model_grid.nml.rst b/user_guide/doc/source/namelists/model_grid.nml.rst index 064b8d10..2036b994 100644 --- a/user_guide/doc/source/namelists/model_grid.nml.rst +++ b/user_guide/doc/source/namelists/model_grid.nml.rst @@ -383,7 +383,7 @@ Examples of how to specify the model domain using through this namelist are prov .. nml:namelist:: JULES_LAND_FRAC -Land fraction is the fraction of each gridbox that is land. Currently, JULES considers any gridbox with land fraction > 0 to be 100% land, and all others to be 100% sea (or sea-ice). Land fraction data can be used to select only land points from the full input grid (see below). +Land fraction is the fraction of each gridbox that is land. By default, JULES considers any gridbox with land fraction > 0 to be 100% land, and all others to be 100% sea (or sea-ice). To keep land fractions as fractions then set l_use_land_fraction to True. Land fraction data can be used to select only land points from the full input grid (see below). .. warning:: When the input grid consists of a single location (1D and :nml:mem:`JULES_INPUT_GRID::npoints` = 1 or 2D and :nml:mem:`JULES_INPUT_GRID::nx` = :nml:mem:`JULES_INPUT_GRID::ny` = 1), that single location is assumed to be 100% land. @@ -412,6 +412,18 @@ For any input grid with more than a single location, the following are used: In the file, the variable must have no levels dimensions and no time dimension. +.. nml:member:: l_use_land_fraction + + :type: logical + :default: F + + TRUE + Supply land fractions (as fractions) to both the main grid and the rivers grid (if grids are compatible). This is needed for water conservation when using inland basin flow (l_inland = True). + + FALSE + Land fractions are not used and the land fraction field is set to either 1.0 (any land) or 0.0. + + ``JULES_MODEL_GRID`` namelist members ------------------------------------- From f3239aec94473bf6e8242a2b8f8716c56893e822 Mon Sep 17 00:00:00 2001 From: Dan Copsey Date: Wed, 10 Sep 2025 16:26:49 +0100 Subject: [PATCH 2/2] Add send_fields info and links --- user_guide/doc/source/namelists/jules_hydrology.nml.rst | 3 ++- user_guide/doc/source/namelists/oasis_rivers.nml.rst | 8 ++++++-- 2 files changed, 8 insertions(+), 3 deletions(-) diff --git a/user_guide/doc/source/namelists/jules_hydrology.nml.rst b/user_guide/doc/source/namelists/jules_hydrology.nml.rst index d208350c..0bc9ba8a 100644 --- a/user_guide/doc/source/namelists/jules_hydrology.nml.rst +++ b/user_guide/doc/source/namelists/jules_hydrology.nml.rst @@ -106,7 +106,8 @@ This file sets the hydrology options. It contains one namelist called :nml:lst:` :default: F TRUE - Some rivers end at inland basin flow points. This inland basin flow is used to increase soil moisture at these locations. + Some rivers end at inland basin flow points. This inland basin flow is used to increase soil moisture at these locations. For this to work JULES rivers_standalone needs + to be run as a separate executable and the inland basin flow needs to be passed into this land surface component via OASIS using :nml:mem:`OASIS_RIVERS::send_fields`. FALSE No inland basin flow. diff --git a/user_guide/doc/source/namelists/oasis_rivers.nml.rst b/user_guide/doc/source/namelists/oasis_rivers.nml.rst index 591d0912..bb4201a1 100644 --- a/user_guide/doc/source/namelists/oasis_rivers.nml.rst +++ b/user_guide/doc/source/namelists/oasis_rivers.nml.rst @@ -40,12 +40,16 @@ This file contains a single namelists called :nml:lst:`OASIS_RIVERS`, which indi .. nml:member:: send_fields :type: character(:) - :permitted: 'outflow_per_river' + :permitted: 'outflow_per_river','inland_outflow' :default: '' List of fields to be sent via coupling from the river executable to other models. Names are case sensitive. -.. note:: The only field that can be sent via coupling is the total river runoff (`outflow_per_river`). +.. note:: The fields that can be sent via coupling are: + + 1. The total river runoff (`outflow_per_river`) which is sent to the ocean. + + 2. The inland basin flow (`inland_outflow`) which is sent to the land surface hydrology scheme. Turn on :nml:mem:`JULES_HYDROLOGY::l_inland` (in the land surface side of the coupler) to pass this inland basin flow into soil moisture. .. nml:member:: receive_fields