diff --git a/user_guide/doc/source/namelists/jules_hydrology.nml.rst b/user_guide/doc/source/namelists/jules_hydrology.nml.rst index eed5d79..0bc9ba8 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,19 @@ 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. 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. + + .. 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 064b8d1..2036b99 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 ------------------------------------- diff --git a/user_guide/doc/source/namelists/oasis_rivers.nml.rst b/user_guide/doc/source/namelists/oasis_rivers.nml.rst index 591d091..bb4201a 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