Bare soil evaporation separated over irrigated and non-irrigated soil -old as from stable pre Maggie's meta data changes #139

CONTRIBUTORS.md

@@ -5,3 +5,7 @@
 | yaswant         | Yaswant Pradhan  | Met Office  | 2026-06-30 |
 | doucla          | Douglas Clark    | UKCEH       | 2026-07-03 |
 | james-bruten-mo | James Bruten     | Met Office  | 2026-07-09 |
+| maggiehendry    | Maggie Hendry    | Met Office  | 2026-08-21 |
+| DanCopsey       | Dan Copsey       | Met Office  | 2026-08-24 |
+| Pierre-siddall  | Pierre Siddall   | Met Office  | 2026-08-26 |
+| nicgedney       | Nic Gedney       | Met Office  | 2026-09-01 |

doc/source/namelists/jules_irrig.nml.rst

@@ -50,7 +50,7 @@ This namelist specifies the different options available for setting up the irrig
    1. Not available yet. In a future release this will replace :nml:mem:`l_irrig_dmd`.
    2. Apply irrigation to irrigated surface types C3_irrig and/or C4_irrig. This option requires :nml:mem:`JULES_IRRIG::l_irrig_dmd` = FALSE and :nml:mem:`JULES_PFTPARM::irrig_pft_io` = 0 or 1.
 
-  When :nml:mem:`JULES_IRRIG::l_irrig_dmd` = TRUE, :nml:mem:`JULES_IRRIG::irrig_option` is not available.
+   When :nml:mem:`JULES_IRRIG::l_irrig_dmd` = TRUE, :nml:mem:`JULES_IRRIG::irrig_option` is not available.
 
 .. nml:member:: l_irrig_limit
 
@@ -148,6 +148,24 @@ This namelist specifies the different options available for setting up the irrig
    :nml:mem:`nstep_irrig` = NINT(frequency of irrigation update (in sec)) / :nml:mem:`JULES_TIME::timestep_len`
 
 
+.. nml:member:: l_soil_evap_irrig_separate
+
+   :type: logical
+   :default: F
+
+   Switch controlling whether the bare soil evaporation from the irrigated and non-irrigated part of the grid-box (or soil tile) is controlled by the mean soil moisture or the separate irrigated and non-irrigated soil moisture columns.
+
+   TRUE
+       Bare soil evaporation is explicitly calculated from the irrigated and non-irrigated soil moisture columns.
+
+       Only available when :nml:mem:`l_irrig_dmd` = TRUE
+   FALSE
+      No effect.
+
+   This must be set to FALSE if :nml:mem:`irrig_option` = No irrigation (0) or Surface tile-based irrigation (2).
+
+
+
 .. _References_irrig:
 
 ``JULES_IRRIG`` references

rose-meta/jules-shared/jules-irrig/HEAD/rose-meta.conf

@@ -0,0 +1,115 @@
+[namelist:jules_irrig]
+compulsory=true
+description=Configuration of irrigation demand code
+ns=namelist/JULES Science Settings/jules_irrig
+sort-key=21
+title=Irrigation options
+url=https://metoffice.github.io/jules/latest/namelists/jules_irrig.nml.html#namelist-JULES_IRRIG
+
+[namelist:jules_irrig=frac_irrig_all_tiles]
+compulsory=true
+description=Irrigate all tiles
+           =NOT AVAILABLE TO UM
+fail-if=namelist:jules_irrig=set_irrfrac_on_irrtiles == '.true.' and this == '.true.'; # cannot set both frac_irrig_all_tiles and set_irrfrac_on_irrtiles to TRUE
+sort-key=f
+trigger=namelist:jules_irrig=nirrtile: .false.;
+       = namelist:jules_irrig=irrigtiles: .false.;
+type=logical
+url=https://metoffice.github.io/jules/latest/namelists/jules_irrig.nml.html#JULES_IRRIG::frac_irrig_all_tiles
+
+[namelist:jules_irrig=irr_crop]
+compulsory=true
+description=Switch for how the irrigation model determines when to irrigate.
+           =0 is the only option available in the UM
+sort-key=c
+url=https://metoffice.github.io/jules/latest/namelists/jules_irrig.nml.html#JULES_IRRIG::irr_crop
+values=0,1,2
+
+[namelist:jules_irrig=irrig_option]
+compulsory=true
+description=Options for applying irrigation
+           =0: No irrigation
+           =1: In a future release this will replace l_irrig_dmd (NOT AVAILABLE YET)
+           =2: Apply irrigation to available irrigated surface types
+fail-if=this == 2 and namelist:jules_soil=l_tile_soil == '.true.'; # Tile-based irrigation is not available with soil tiling.
+sort-key=b
+trigger=namelist:jules_pftparm=irrig_pft_io: 2;
+       =namelist:jules_surface_types=c3_irrig: 2;
+       =namelist:jules_surface_types=c4_irrig: 2;
+url=https://metoffice.github.io/jules/latest/namelists/jules_irrig.nml.html#JULES_IRRIG::irrig_option
+value-titles=No Irrigation, Tile based irrigation
+values=0,2
+
+[namelist:jules_irrig=irrigtiles]
+compulsory=true
+description=indices of tiles to be irrigated
+fail-if=len(this) != namelist:jules_irrig=nirrtile
+length=:
+range=1:
+sort-key=e
+type=integer
+url=https://metoffice.github.io/jules/latest/namelists/jules_irrig.nml.html#JULES_IRRIG::irrigtiles
+
+[namelist:jules_irrig=l_irrig_dmd]
+compulsory=true
+description=Use fraction-based irrigation demand code
+fail-if=namelist:jules_soil=l_holdwater == '.true.' and this == '.true.'; # Irrigation can't be used with l_holdwater = TRUE
+       =namelist:jules_water_resources=l_water_irrigation == '.true.' and this == '.false.'; # Irrigation in water resources code requires l_irrig_dmd = TRUE
+sort-key=a
+trigger=namelist:jules_irrig=irr_crop: .true.;
+       =namelist:jules_irrig=l_irrig_limit: .true.;
+       =namelist:jules_irrig=frac_irrig_all_tiles: .true.;
+       =namelist:jules_irrig=set_irrfrac_on_irrtiles: .true.;
+       =namelist:jules_irrig=nstep_irrig: .true.;
+       =namelist:jules_irrig_props: .true.;
+       =namelist:jules_irrig=irrig_option: .false.;
+type=logical
+url=https://metoffice.github.io/jules/latest/namelists/jules_irrig.nml.html#JULES_IRRIG::l_irrig_dmd
+
+[namelist:jules_irrig=l_irrig_limit]
+compulsory=true
+description=Limit irrigation supply
+           =NOT AVAILABLE TO UM
+fail-if=namelist:jules_rivers=l_rivers == '.false.' and this == '.true.'; # l_rivers must TRUE if l_irrig_limit = TRUE
+       =namelist:jules_rivers=i_river_vn != 3 and this == '.true.'; # i_river_vn must be 3 (trip) if l_irrig_limit = TRUE
+       =namelist:jules_hydrology=l_top == '.false.' and this == '.true.'; # l_top must TRUE if l_irrig_limit = TRUE
+       =namelist:jules_water_resources=l_water_irrigation == '.true.' and this == '.true.'; # l_irrig_limit must be F if l_water_irrigation=T
+       =this == '.true.' and namelist:jules_model_environment=l_jules_parent == 1; # Irrigation limitation is not tested in the UM yet.
+sort-key=b
+type=logical
+url=https://metoffice.github.io/jules/latest/namelists/jules_irrig.nml.html#JULES_IRRIG::l_irrig_limit
+
+[namelist:jules_irrig=nirrtile]
+compulsory=true
+description=Number of tile to be irrigated
+range=0:
+sort-key=d
+type=integer
+url=https://metoffice.github.io/jules/latest/namelists/jules_irrig.nml.html#JULES_IRRIG::nirrtile
+
+[namelist:jules_irrig=nstep_irrig]
+compulsory=true
+description=Number of model timesteps per irrigation update step
+range=1:
+sort-key=h
+type=integer
+url=https://metoffice.github.io/jules/latest/namelists/jules_irrig.nml.html#JULES_IRRIG::nstep_irrig
+
+[namelist:jules_irrig=set_irrfrac_on_irrtiles]
+compulsory=true
+description=Irrigate only irrigated tiles
+           =NOT AVAILABLE TO UM
+fail-if=namelist:jules_irrig=frac_irrig_all_tiles == '.true.' and this == '.true.'; # cannot set both frac_irrig_all_tiles and set_irrfrac_on_irrtiles to TRUE
+sort-key=g
+type=logical
+url=https://metoffice.github.io/jules/latest/namelists/jules_irrig.nml.html#JULES_IRRIG::set_irrfrac_on_irrtiles
+
+[namelist:jules_irrig=l_soil_evap_irrig_separate]
+compulsory=true
+description=logical to decide whether bare soil evaporation is 
+           =calculated over the grid-box mean (false) or 
+	   =explicitly irrigated and non-irrigated fractions (true)
+fail-if=this == '.true.' and namelist:jules_irrig=l_irrig_dmd == '.false.'
+sort-key=h
+type=logical
+url=https://metoffice.github.io/jules/latest/namelists/jules_irrig.nml.html#JULES_IRRIG::l_soil_evap_irrig_separate

rose-meta/jules-shared/jules-vegetation/HEAD/rose-meta.conf

@@ -11,11 +11,15 @@ compulsory=true
 description=Vegetation canopy radiation model
 !enumeration=true
 sort-key=Panel-I13
+trigger=namelist:jules_vegetation=ilayers: 4,5,6;
+       =namelist:jules_pftparm=knl_io: 6;
 url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::can_rad_mod
 value-titles=1: Single canopy layer,
             =4: Multi-layer two stream approach,
             =5: Multi-layer with Sunfleck penetration and sunlit and shaded leaves,
             =6: Multi-layer with exponential decline in leaf N
+values=1,4,5,6
+widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget
 
 [namelist:jules_vegetation=l_bvoc_emis]
 compulsory=true
@@ -81,6 +85,8 @@ compulsory=true
 description=Logical switch for setting explicit vegetation roughness lengths
 !kind=default
 sort-key=Panel-I05
+trigger=namelist:jules_pftparm=dz0v_dh_io: .false.;
+       =namelist:jules_pftparm=z0v_io: .true.;
 type=logical
 url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::l_spec_veg_z0