diff --git a/rose-meta/jules-lfric/HEAD/rose-meta.conf b/rose-meta/jules-lfric/HEAD/rose-meta.conf index be744372..0923e0b3 100644 --- a/rose-meta/jules-lfric/HEAD/rose-meta.conf +++ b/rose-meta/jules-lfric/HEAD/rose-meta.conf @@ -8,7 +8,8 @@ # # This file is imported by jules-lsm in the LFRic apps repository. # -# Please see jules:wiki:SharingJULESmetadata +# Please see https://github.com/MetOffice/jules/wiki/Sharing-JULES-metadata +############################################################################### import=jules-shared/jules-hydrology/HEAD =jules-shared/jules-nvegparm/HEAD @@ -632,6 +633,7 @@ trigger= type=logical [namelist:jules_vegetation=can_rad_mod] +trigger=namelist:jules_pftparm=knl_io: 'six'; values='one','four','five','six' [namelist:jules_vegetation=l_inferno] diff --git a/rose-meta/jules-shared/jules-deposition-species-specific/HEAD/rose-meta.conf b/rose-meta/jules-shared/jules-deposition-species-specific/HEAD/rose-meta.conf new file mode 100644 index 00000000..f1719b60 --- /dev/null +++ b/rose-meta/jules-shared/jules-deposition-species-specific/HEAD/rose-meta.conf @@ -0,0 +1,87 @@ +[namelist:jules_deposition_species_specific] +compulsory=true +description=Deposition parameters that depend on species +ns=namelist/JULES Science Settings/jules_deposition/jules_deposition_species_specific +title=Deposition Species Specific +url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#namelist-JULES_DEPOSITION_SPECIES + +[namelist:jules_deposition_species_specific=ch4_mml_io] +compulsory=true +description=Factor to convert methane flux to dry dep velocity +range=0: +sort-key=02b +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION_SPECIES::ch4_mml_io + +[namelist:jules_deposition_species_specific=ch4_scaling_io] +compulsory=true +description=Scaling applied to CH4 soil uptake +range=0: +sort-key=02a +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION_SPECIES::ch4_scaling_io + +[namelist:jules_deposition_species_specific=ch4_up_flux_io] +compulsory=true +description=Uptake of methane to different surface types +fail-if=len(this) != (namelist:jules_surface_types=npft)+(namelist:jules_surface_types=nnvg) +length=: +range=0: +sort-key=02c +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION_SPECIES::ch4_up_flux_io + +[namelist:jules_deposition_species_specific=ch4dd_tundra_io] +compulsory=true +description=Coefficients of cubic fit for CH4 loss to tundra +fail-if=any(this == -1073741824.0) ; # Invalid parameter value(s) +length=4 +sort-key=02d +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION_SPECIES::ch4dd_tundra_io + +[namelist:jules_deposition_species_specific=cuticle_o3_io] +compulsory=true +description=Constant in calculation of cuticular resistance for ozone (s m-1) +range=0:1.0e+30 +sort-key=1a +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION_SPECIES::cuticle_o3_io + +[namelist:jules_deposition_species_specific=h2dd_c_io] +compulsory=true +description=Constant in quadratic function for hydrogen deposition +fail-if=len(this) != (namelist:jules_surface_types=npft)+(namelist:jules_surface_types=nnvg) + =any(this == -1073741824.0) ; # Invalid parameter value(s) +length=: +sort-key=03a +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION_SPECIES::h2dd_c_io + +[namelist:jules_deposition_species_specific=h2dd_m_io] +compulsory=true +description=Coefficient of first order term in quadratic function for hydrogen deposition +fail-if=len(this) != (namelist:jules_surface_types=npft)+(namelist:jules_surface_types=nnvg) + =any(this == -1073741824.0) ; # Invalid parameter value(s) +length=: +sort-key=03b +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION_SPECIES::h2dd_m_io + +[namelist:jules_deposition_species_specific=h2dd_q_io] +compulsory=true +description=Coefficient of second order term in quadratic function for hydrogen deposition +fail-if=len(this) != (namelist:jules_surface_types=npft)+(namelist:jules_surface_types=nnvg) + =any(this == -1073741824.0) ; # Invalid parameter value(s) +length=: +sort-key=03c +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION_SPECIES::h2dd_q_io + +[namelist:jules_deposition_species_specific=r_wet_soil_o3_io] +compulsory=true +description=Wet soil surface resistance for ozone (s m-1) +range=0:1.0e+30 +sort-key=01b +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION_SPECIES::r_wet_soil_o3_io diff --git a/rose-meta/jules-shared/jules-deposition-species/HEAD/rose-meta.conf b/rose-meta/jules-shared/jules-deposition-species/HEAD/rose-meta.conf new file mode 100644 index 00000000..73295e33 --- /dev/null +++ b/rose-meta/jules-shared/jules-deposition-species/HEAD/rose-meta.conf @@ -0,0 +1,69 @@ +[namelist:jules_deposition_species] +compulsory=true +description=Deposition parameters that depend on species +duplicate=true +ns=namelist/JULES Science Settings/jules_deposition/jules_deposition_species +title=Deposition Species +url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#namelist-JULES_DEPOSITION_SPECIES + +[namelist:jules_deposition_species=dd_ice_coeff_io] +compulsory=true +description=Coefficients for quadratic dependency of dry deposition to ice +fail-if=any(this == -1073741824.0) ; # Invalid parameter value(s) +length=3 +sort-key=6 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION_SPECIES::dd_ice_coeff_io + +[namelist:jules_deposition_species=dep_species_name_io] +compulsory=true +description=Name of chemical species to be deposited +fail-if=(this == "'unset'") ; # Invalid name for deposited species +sort-key=01 +trigger=namelist:jules_deposition_species=dd_ice_coeff_io: this == "'SO2'" or this == "'HNO3'" or this == "'HONO2'" or this == "'ISON'" or this == "'HCl'" or this == "'HOCl'" or this == "'HBr'" or this == "'HOBr'" ; + =namelist:jules_deposition_species=diffusion_corr_io: this == "'NO2'" or this == "'O3'" or this == "'SO2'" or this == "'NH3'" or this == "'PAN'" or this == "'MPAN'" or this == "'PPAN'" or this == "'ONITU'" ; + =namelist:jules_deposition_species=r_tundra_io: this == "'NO2'" or this == "'O3'" or this == "'CO'" or this == "'H2'" or this == "'PAN'" or this == "'MPAN'" or this == "'PPAN'" or this == "'ONITU'" ; +type=character +url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION_SPECIES::dep_species_name_io + +[namelist:jules_deposition_species=dep_species_rmm_io] +compulsory=true +description=Relative molecular mass (g mol-1), used in calculation of quasi-laminar resistance (Rb) +range=0: +sort-key=02a +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION_SPECIES::dep_species_rmm_io + +[namelist:jules_deposition_species=diffusion_coeff_io] +compulsory=true +description=Diffusion coefficient (m2 s-1), used in calculation of quasi-laminar resistance (Rb) +range=-1,0: +sort-key=02b +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION_SPECIES::diffusion_coeff_io + +[namelist:jules_deposition_species=diffusion_corr_io] +compulsory=true +description=Diffusion correction for stomatal conductance +range=0: +sort-key=04 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION_SPECIES::diffusion_corr_io + +[namelist:jules_deposition_species=r_tundra_io] +compulsory=true +description=Surface resistance used in tundra region (s m-1) +range=0:1.0e+30 +sort-key=05 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION_SPECIES::r_tundra_io + +[namelist:jules_deposition_species=rsurf_std_io] +compulsory=true +description=Standard values of surface resistance (s m-1) +fail-if=len(this) != (namelist:jules_surface_types=npft)+(namelist:jules_surface_types=nnvg) +length=: +range=0:1.0e+30 +sort-key=03 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION_SPECIES::rsurf_std_io diff --git a/rose-meta/jules-shared/jules-deposition/HEAD/rose-meta.conf b/rose-meta/jules-shared/jules-deposition/HEAD/rose-meta.conf new file mode 100644 index 00000000..546169cb --- /dev/null +++ b/rose-meta/jules-shared/jules-deposition/HEAD/rose-meta.conf @@ -0,0 +1,139 @@ +[namelist:jules_deposition] +compulsory=true +description=Configuration of atmospheric deposition +ns=namelist/JULES Science Settings/jules_deposition +title=Deposition +url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#namelist-JULES_DEPOSITION + +[namelist:jules_deposition=dep_h2_soil_scheme] +compulsory=true +description=Scheme for H2 soil deposition +fail-if=( this == 2 and namelist:jules_model_environment=l_jules_parent == 1 ) ; # The Paulot et al. H2 scheme is not yet fully implemented for UM-coupled JULES applications (when JULES deposition called from UKCA): only Conrad & Seiler scheme available, dep_h2_soil_scheme = 1 +sort-key=5f +url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION::dep_h2_soil_scheme +value-titles=Conrad & Seiler H2 deposition scheme,Paulot et al. H2 deposition scheme +values=1,2 + +[namelist:jules_deposition=dry_dep_model] +compulsory=true +description=Dry deposition model +sort-key=2 +trigger=namelist:jules_deposition_species=dd_ice_coeff_io: 2; + =namelist:jules_deposition_species=dep_species_name_io: 1,2; + =namelist:jules_deposition_species=dep_species_rmm_io: 2; + =namelist:jules_deposition_species=diffusion_coeff_io: 2; + =namelist:jules_deposition_species=diffusion_corr_io: 2; + =namelist:jules_deposition_species=r_tundra_io: 2; + =namelist:jules_deposition_species=rsurf_std_io: 2; + =namelist:jules_deposition_species_specific=ch4_mml_io: 2; + =namelist:jules_deposition_species_specific=ch4_scaling_io: 2; + =namelist:jules_deposition_species_specific=ch4_up_flux_io: 2; + =namelist:jules_deposition_species_specific=ch4dd_tundra_io: 2; + =namelist:jules_deposition_species_specific=cuticle_o3_io: 2; + =namelist:jules_deposition_species_specific=h2dd_c_io: 2; + =namelist:jules_deposition_species_specific=h2dd_m_io: 2; + =namelist:jules_deposition_species_specific=h2dd_q_io: 2; + =namelist:jules_deposition_species_specific=r_wet_soil_o3_io: 2; +url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION::dry_dep_model +value-titles=JULES with restricted UKCA deposition,JULES with flexible UKCA deposition +values=1,2 +widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget + +[namelist:jules_deposition=dzl_const] +compulsory=true +description=Constant separation for boundary layer levels (m) +range=0: +sort-key=6 +url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION::dzl_const + +[namelist:jules_deposition=l_deposition] +compulsory=true +description=Switch to enable JULES-based atmospheric dry deposition +fail-if=(this == '.true.' and namelist:jules_surface=l_aggregate == ".true.") ; # Deposition does not work with aggregated tile +sort-key=1 +trigger=namelist:jules_deposition=dep_h2_soil_scheme: .true.; + =namelist:jules_deposition=dry_dep_model: .true.; + =namelist:jules_deposition=dzl_const: .true.; + =namelist:jules_deposition=l_deposition_flux: .true.; + =namelist:jules_deposition=l_deposition_gc_corr: .true.; + =namelist:jules_deposition=l_ukca_ddep_lev1: .true.; + =namelist:jules_deposition=l_ukca_ddepo3_ocean: .true.; + =namelist:jules_deposition=l_ukca_dry_dep_so2wet: .true.; + =namelist:jules_deposition=l_ukca_emsdrvn_ch4: .true.; + =namelist:jules_deposition=ndry_dep_species: .true.; + =namelist:jules_deposition=tundra_s_limit: .true.; + =namelist:jules_deposition_species: .true.; + =namelist:jules_deposition_species_specific: .true.; + =namelist:jules_temp_fixes=l_fix_drydep_so2_water: .true.; + =namelist:jules_temp_fixes=l_fix_improve_drydep: .true.; + =namelist:jules_temp_fixes=l_fix_ukca_h2dd_x: .true.; +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION::l_deposition + +[namelist:jules_deposition=l_deposition_flux] +compulsory=true +description=Switch to enable calculation of deposition fluxes +sort-key=4a +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION::l_deposition_flux + +[namelist:jules_deposition=l_deposition_from_ukca] +compulsory=true +description=Switch to call JULES-based deposition routines from ukca_chemistry_ctl +fail-if=( this == '.false.' and namelist:jules_model_environment=l_jules_parent == 1 ) ; # For UM_JULES applications, only the call to the deposition routines from the UKCA is currently available + =( this == '.true.' and namelist:jules_model_environment=l_jules_parent == 0 ) ; # Deposition switch cannot be true in JULES standalone as JULES-based deposition routines called from UKCA +sort-key=5a +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION::l_deposition_from_ukca + +[namelist:jules_deposition=l_deposition_gc_corr] +compulsory=true +description=Switch to correct stomatal conductance for bare soil evaporation +fail-if=( this == '.true.' and namelist:jules_model_environment=l_jules_parent == 1 ) ; # For UM_JULES applications, stomatal conductance corrected for bare soil evaporation is not available in the UKCA +sort-key=4b +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION::l_deposition_gc_corr + +[namelist:jules_deposition=l_ukca_ddep_lev1] +compulsory=true +description=Apply dry deposition losses only from the lowest level (true) or all levels (false) in the atmospheric boundary layer +sort-key=5b +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION::l_ukca_ddep_lev1 + +[namelist:jules_deposition=l_ukca_ddepo3_ocean] +compulsory=true +description=Use a mechanistic calculation for ocean ozone deposition +fail-if=( this == '.true.' and namelist:jules_model_environment=l_jules_parent == 0 ) ; # Deposition switch not available in JULES standalone as requires >75% open water fraction +sort-key=5c +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION::l_ukca_ddepo3 + +[namelist:jules_deposition=l_ukca_dry_dep_so2wet] +compulsory=true +description=Accounting for surface wetness in the dry deposition for SO2 +fail-if=( this == '.true.' and namelist:jules_model_environment=l_jules_parent == 0 ) ; # Deposition switch not fully implemented in JULES standalone +sort-key=5d +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION::l_ukca_dry_dep_so2wet + +[namelist:jules_deposition=l_ukca_emsdrvn_ch4] +compulsory=true +description=CH4 emission driven UKCA +sort-key=5e +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION::l_ukca_emsdrvn_ch4 + +[namelist:jules_deposition=ndry_dep_species] +compulsory=true +description=Number of species for dry deposition +range=1:200 +sort-key=3 +url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION::ndry_dep_species + +[namelist:jules_deposition=tundra_s_limit] +compulsory=true +description=sine of latitude of southern limit of tundra +range=-1:1 +sort-key=7 +url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION::tundra_s_limit diff --git a/rose-meta/jules-shared/jules-irrig/HEAD/rose-meta.conf b/rose-meta/jules-shared/jules-irrig/HEAD/rose-meta.conf new file mode 100644 index 00000000..79b0375d --- /dev/null +++ b/rose-meta/jules-shared/jules-irrig/HEAD/rose-meta.conf @@ -0,0 +1,105 @@ +[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 diff --git a/rose-meta/jules-shared/jules-overbank/HEAD/rose-meta.conf b/rose-meta/jules-shared/jules-overbank/HEAD/rose-meta.conf new file mode 100644 index 00000000..7531603f --- /dev/null +++ b/rose-meta/jules-shared/jules-overbank/HEAD/rose-meta.conf @@ -0,0 +1,80 @@ +[namelist:jules_overbank] +compulsory=true +ns=namelist/JULES Science Settings/jules_overbank +sort-key=14 +title=River overbank inundation options +url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#namelist-JULES_overbank + +[namelist:jules_overbank=coef_b] +compulsory=true +description=Coefficient in the QBF (=bankfull discharge) allometry. +range=0: +sort-key=f +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_overbank::coef_b + +[namelist:jules_overbank=ent_ratio] +compulsory=true +description=Rosgen entrenchment ratio (= ratio of flood-prone width to bankfull width + = of a channel, where flood-prone width = when the channel depth is + = 2x bankfull depth) +range=0: +sort-key=g +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_overbank::ent_ratio + +[namelist:jules_overbank=exp_c] +compulsory=true +description=Exponent in the QBF (=bankfull discharge) allometry. +range=0: +sort-key=h +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_overbank::exp_c + +[namelist:jules_overbank=overbank_model] +compulsory=true +description=Choice of overbank inundation model +sort-key=a +trigger=namelist:jules_overbank=coef_b: 2; + = namelist:jules_overbank=ent_ratio: 2; + = namelist:jules_overbank=exp_c: 2; + = namelist:jules_overbank=riv_a: 1, 2; + = namelist:jules_overbank=riv_b: 1, 2; + = namelist:jules_overbank=riv_c: 2, 3; + = namelist:jules_overbank=riv_f: 2, 3; +url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_overbank::overbank_model +value-titles=Simple, Simple with Rosgen, Hypsometric integral +values=1,2,3 +widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget + +[namelist:jules_overbank=riv_a] +compulsory=true +description=Coefficient in the allometry for river width +range=0: +sort-key=d +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_overbank::riv_a + +[namelist:jules_overbank=riv_b] +compulsory=true +description=Exponent in the allometry for river width +range=0: +sort-key=e +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_overbank::riv_b + +[namelist:jules_overbank=riv_c] +compulsory=true +description=Coefficient in the allometry for river depth +range=0: +sort-key=b +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_overbank::riv_c + +[namelist:jules_overbank=riv_f] +compulsory=true +description=Exponent in the allometry for river depth +range=0: +sort-key=c +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_overbank::riv_f diff --git a/rose-meta/jules-shared/jules-red/HEAD/rose-meta.conf b/rose-meta/jules-shared/jules-red/HEAD/rose-meta.conf new file mode 100644 index 00000000..fca30749 --- /dev/null +++ b/rose-meta/jules-shared/jules-red/HEAD/rose-meta.conf @@ -0,0 +1,129 @@ +[namelist:jules_red] +compulsory=true +description=All parameters in this section are required to use the Robust Ecosystem Demography + = calculation. + = + =Click on names for more details + = +ns=namelist/JULES Science Settings/jules_red +sort-key=10 +title=RED PFT parameters +url=https://metoffice.github.io/jules/latest/namelists/red_params.nml.html#namelist-JULES_RED + +[namelist:jules_red=alpha_recrt] +compulsory=true +description=The fraction of PFT carbon assimilate devoted to reproduction +fail-if=len(this) != (namelist:jules_surface_types=npft) +length=: +sort-key=PANEL-I02da +type=real +url=https://metoffice.github.io/jules/latest/namelists/red_params.nml.html#JULES_RED::alpha_recrt + +[namelist:jules_red=crwn_area0] +compulsory=true +description=The lowest PFT crown area, value corresponds to the mass0 class (m2) +fail-if=len(this) != (namelist:jules_surface_types=npft) +length=: +sort-key=PANEL-I02db +type=real +url=https://metoffice.github.io/jules/latest/namelists/red_params.nml.html#JULES_RED::crwn_area0 + +[namelist:jules_red=dom_order] +compulsory=true +description=The value that describes the competitive hierarchy of PFTs competition in + =JULES-RED, the higher the value the more dominant. +fail-if=len(this) != (namelist:jules_surface_types=npft) +length=: +sort-key=PANEL-I02dc +type=integer +url=https://metoffice.github.io/jules/latest/namelists/red_params.nml.html#JULES_RED::dom_order + +[namelist:jules_red=height0] +compulsory=true +description=The lowest PFT height, value corresponds to the mass0 class (m) +fail-if=len(this) != (namelist:jules_surface_types=npft) +length=: +sort-key=PANEL-I02dd +type=real +url=https://metoffice.github.io/jules/latest/namelists/red_params.nml.html#JULES_RED::height0 + +[namelist:jules_red=lai_bal0] +compulsory=true +description=The lowest PFT balanced LAI, which corresponds to the mass0 class (m2/m2) +fail-if=len(this) != (namelist:jules_surface_types=npft) +length=: +sort-key=PANEL-I02de +type=real +url=https://metoffice.github.io/jules/latest/namelists/red_params.nml.html#JULES_RED::lai_bal0 + +[namelist:jules_red=mass0] +compulsory=true +description=The lowest PFT mass class (kg C) +fail-if=len(this) != (namelist:jules_surface_types=npft) +length=: +sort-key=PANEL-I02df +type=real +url=https://metoffice.github.io/jules/latest/namelists/red_params.nml.html#JULES_RED::mass0 + +[namelist:jules_red=massi] +compulsory=true +description=The highest PFT mass class (kg C) +fail-if=len(this) != (namelist:jules_surface_types=npft) +length=: +sort-key=PANEL-I02dg +type=real +url=https://metoffice.github.io/jules/latest/namelists/red_params.nml.html#JULES_RED::massi + +[namelist:jules_red=mclass] +compulsory=true +description=Number of mass classes for each PFT +fail-if=len(this) != (namelist:jules_surface_types=npft) +length=: +sort-key=PANEL-I02dh +type=integer +url=https://metoffice.github.io/jules/latest/namelists/red_params.nml.html#JULES_RED::mclass + +[namelist:jules_red=mort_base] +compulsory=true +description=The baseline PFT mortality rate (/360 days) +fail-if=len(this) != (namelist:jules_surface_types=npft) +length=: +sort-key=PANEL-I02di +type=real +url=https://metoffice.github.io/jules/latest/namelists/red_params.nml.html#JULES_RED::mort_base + +[namelist:jules_red=phi_a] +compulsory=true +description=The allometric/power scaling of PFT mass to PFT height +fail-if=len(this) != (namelist:jules_surface_types=npft) +length=: +sort-key=PANEL-I02dj +type=real +url=https://metoffice.github.io/jules/latest/namelists/red_params.nml.html#JULES_RED::phi_a + +[namelist:jules_red=phi_g] +compulsory=true +description=The allometric/power scaling of PFT mass to PFT mass growth rate +fail-if=len(this) != (namelist:jules_surface_types=npft) +length=: +sort-key=PANEL-I02dk +type=real +url=https://metoffice.github.io/jules/latest/namelists/red_params.nml.html#JULES_RED::phi_g + +[namelist:jules_red=phi_h] +compulsory=true +description=The allometric/power scaling of PFT mass to PFT height +fail-if=len(this) != (namelist:jules_surface_types=npft) +length=: +sort-key=PANEL-I02dl +type=real +url=https://metoffice.github.io/jules/latest/namelists/red_params.nml.html#JULES_RED::phi_h + +[namelist:jules_red=phi_l] +compulsory=true +description=The allometric/power scaling of PFT mass to PFT leaf area index +fail-if=len(this) != (namelist:jules_surface_types=npft) +length=: +sort-key=PANEL-I02dm +type=real +url=https://metoffice.github.io/jules/latest/namelists/red_params.nml.html#JULES_RED::phi_l diff --git a/rose-meta/jules-shared/jules-rivers/HEAD/rose-meta.conf b/rose-meta/jules-shared/jules-rivers/HEAD/rose-meta.conf new file mode 100644 index 00000000..cc3479c2 --- /dev/null +++ b/rose-meta/jules-shared/jules-rivers/HEAD/rose-meta.conf @@ -0,0 +1,156 @@ +[namelist:jules_rivers] +compulsory=true +ns=namelist/JULES Science Settings/jules_rivers +sort-key=06 +title=River routing options +url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#namelist-JULES_RIVERS + +[namelist:jules_rivers=a_thresh] +compulsory=true +description=The threshold drainage area (specified in number of cells) + = draining to a gridbox above which the gridbox is + = considered to be a river point +sort-key=j +type=integer +url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_RIVERS::a_thresh + +[namelist:jules_rivers=cbland] +compulsory=true +description=The subsurface land wave speed (kinematic wave speed for subsurface flow in a land grid box on the river routing grid, m s-1) +range=this>0 +sort-key=f +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_RIVERS::cbland + +[namelist:jules_rivers=cbriver] +compulsory=true +description=The subsurface river wave speed (kinematic wave speed for subsurface flow in a river grid box on the river routing grid, m s-1) +range=this>0 +sort-key=g +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_RIVERS::cbriver + +[namelist:jules_rivers=cland] +compulsory=true +description=The land wave speed (kinematic wave speed for surface flow in a land grid box on the river routing grid, m s-1) +range=this>0 +sort-key=d +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_RIVERS::cland + +[namelist:jules_rivers=criver] +compulsory=true +description=The river wave speed (kinematic wave speed for surface flow in a river grid box on the river routing grid, m s-1) +range=this>0 +sort-key=e +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_RIVERS::criver + +[namelist:jules_rivers=i_river_vn] +compulsory=true +description=Routing algorithm to use +fail-if=this == 1 and namelist:jules_model_environment=l_jules_parent == 0; # UM_TRIP is not compatible with standalone. + =(this !=1 and this !=2) and namelist:jules_model_environment=l_jules_parent == 1; # UM_TRIP and RFM are the only options compatible with the UM. +sort-key=b +trigger=namelist:jules_rivers=cland: 2; + = namelist:jules_rivers=criver: 2; + = namelist:jules_rivers=cbland: 2; + = namelist:jules_rivers=cbriver: 2; + = namelist:jules_rivers=retl: 2; + = namelist:jules_rivers=retr: 2; + = namelist:jules_rivers=a_thresh: 2; + = namelist:jules_rivers=runoff_factor: 2; + = namelist:jules_rivers=rivers_speed: 1,3; + = namelist:jules_rivers=rivers_meander: 1,3; + = namelist:jules_rivers_props=l_use_area: 2; + = namelist:jules_rivers=lake_water_conserve_method: 1; + = namelist:jules_rivers=trip_globe_shape: 1; +url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_RIVERS::i_river_vn +value-titles=RFM,TRIP +values=2,3 +widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget + +[namelist:jules_rivers=l_riv_overbank] +compulsory=true +description=Enable overbank inundation +fail-if=this == '.true.' and namelist:jules_model_environment=l_jules_parent != 0; # Overbank inundation is not available to the UM or OASIS. +sort-key=n +trigger=namelist:jules_overbank=overbank_model: .true.; +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_RIVERS::l_riv_overbank + +[namelist:jules_rivers=l_rivers] +compulsory=true +description=Enable river routing +sort-key=a +trigger=namelist:jules_rivers=i_river_vn: .true.; + = namelist:jules_rivers=nstep_rivers: .true.; + = namelist:jules_rivers=l_riv_overbank: .true.; + = namelist:jules_overbank: .true.; + = namelist:jules_rivers_props: .true.; +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_RIVERS::l_rivers + +[namelist:jules_rivers=lake_water_conserve_method] +compulsory=true +description=Selects different fields for use in water conservation of lake evaporation +fail-if=this > 0 and namelist:jules_rivers=i_river_vn > 1; # lake_water_conserve_method is not compatible with standalone rivers +url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_RIVERS::lake_water_conserve_method +value-titles=Use fqw_surft,Use elake_surft +values=1,2 + +[namelist:jules_rivers=nstep_rivers] +compulsory=true +description=Number of model timesteps per routing timestep +range=1: +sort-key=c +type=integer +url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_RIVERS::nstep_rivers + +[namelist:jules_rivers=retl] +compulsory=true +description=The (resolution dependent) land return flow fraction +range=-1:1 +sort-key=h +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_RIVERS::retl + +[namelist:jules_rivers=retr] +compulsory=true +description=The (resolution dependent) river return flow fraction +range=-1:1 +sort-key=i +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_RIVERS::retr + +[namelist:jules_rivers=rivers_meander] +compulsory=true +description=Ratio of the actual to calculated river lengths in a river routing gridbox +range=this>0 +sort-key=m +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_RIVERS::rivers_meander + +[namelist:jules_rivers=rivers_speed] +compulsory=true +description=The effective river velocity (m/s) +range=this>0 +sort-key=l +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_RIVERS::rivers_speed + +[namelist:jules_rivers=runoff_factor] +compulsory=true +description=A runoff volume factor (recommended setting=1) +range=this>0 +sort-key=k +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_RIVERS::runoff_factor + +[namelist:jules_rivers=trip_globe_shape] +compulsory=true +description=The shape of the Earth in the TRIP river routing scheme +sort-key=j +url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_RIVERS::trip_globe_shape +value-titles=Spherical,Ellipsoidal +values=1,2 diff --git a/rose-meta/jules-shared/jules-soil-biogeochem/HEAD/rose-meta.conf b/rose-meta/jules-shared/jules-soil-biogeochem/HEAD/rose-meta.conf new file mode 100644 index 00000000..5ac31834 --- /dev/null +++ b/rose-meta/jules-shared/jules-soil-biogeochem/HEAD/rose-meta.conf @@ -0,0 +1,426 @@ +[namelist:jules_soil_biogeochem] +compulsory=true +ns=namelist/JULES Science Settings/jules_soil_biogeochem +sort-key=07 +title=Soil biogeochemistry options +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#namelist-JULES_SOIL_BIOGEOCHEM + +[namelist:jules_soil_biogeochem=alpha_ch4] +compulsory=true +description=Ratio between maintenance and growth respiration rates for methanogens +range=0.00001:0.1 +sort-key=8i +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::alpha_ch4 + +[namelist:jules_soil_biogeochem=bio_hum_cn] +compulsory=true +description=Bio and Hum Soil Carbon pools CN ratio +range=1:301 +sort-key=g +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::bio_hum_cn + +[namelist:jules_soil_biogeochem=ch4_cpow] +compulsory=true +description=Power of soil carbon used for anaerobic decomposition (default 1, could be 2/3 for organic soils) +range=0.01:5 +sort-key=r +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::ch4_cpow + +[namelist:jules_soil_biogeochem=ch4_substrate] +compulsory=true +description=Choose substrate for interactive methane +sort-key=o +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::ch4_substrate +value-titles=Soil carbon,NPP,Soil respiration +values=1,2,3 +widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget + +[namelist:jules_soil_biogeochem=const_ch4_cs] +compulsory=true +description=Scale factor for soil carbon substrate CH4 emissions +range=1.0e-14:1.0e-6 +sort-key=2c +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::const_ch4_cs + +[namelist:jules_soil_biogeochem=const_ch4_npp] +compulsory=true +description=Scale factor for NPP substrate CH4 emissions +range=1.0e-5:0.01 +sort-key=2d +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::const_ch4_npp + +[namelist:jules_soil_biogeochem=const_ch4_resps] +compulsory=true +description=Scale factor for soil respiration substrate CH4 emissions +range=1.0e-5:0.01 +sort-key=2e +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::const_ch4_resps + +[namelist:jules_soil_biogeochem=cs_decomp_soil_moist_func] +compulsory=true +description=Switch for moisture function for soil decomposition +sort-key=m1 +trigger=namelist:jules_soil_biogeochem=fsthsat_cs_decomp_opt1: 1; +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::cs_decomp_soil_moist_func +value-titles=Clark (2011) function, Modified Chadburn (2022) function +values=0,1 +widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget + +[namelist:jules_soil_biogeochem=cue_ch4] +compulsory=true +description=Carbon use efficiency of methanogenic growth +range=0.001:0.5 +sort-key=8f +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::cue_ch4 + +[namelist:jules_soil_biogeochem=diff_n_pft] +compulsory=true +description=Inorganic N diffusion in soil (360 days-1) +range=0.1:1500 +sort-key=b2 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::diff_n_pft + +[namelist:jules_soil_biogeochem=ev_ch4] +compulsory=true +description=Timescale over which methanogenic traits adapt to temperature change (yr) +range=0.1:10.0 +sort-key=8j +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::ev_ch4 + +[namelist:jules_soil_biogeochem=frz_ch4] +compulsory=true +description=Factor to reduce CH4 substrate production when soil is sufficiently frozen (only in microbial scheme) +range=0:1 +sort-key=8h +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::frz_ch4 + +[namelist:jules_soil_biogeochem=fsthsat_cs_decomp_opt1] +compulsory=true +description=Soil decomposition factor when soil is saturated (proportion of maximum) +range=0.0:1.0 +sort-key=m1a +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::fsthsat_cs_decomp_opt1 + +[namelist:jules_soil_biogeochem=heat_of_respiration] +compulsory=true +description=The heat released during respiration (J/kg C) +range=0: +sort-key=c1a +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::heat_of_respiration + +[namelist:jules_soil_biogeochem=k2_ch4] +compulsory=true +description=Scale factor for methanogenic respiration rate (hr-1) +range=0.001:0.5 +sort-key=8b +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::k2_ch4 + +[namelist:jules_soil_biogeochem=kaps] +compulsory=true +description=Specific soil respiration rate at 25 degC and optimum soil moisture (s-1) for 1-pool model +range=1.0e-12:1.0e-4 +sort-key=e +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::kaps + +[namelist:jules_soil_biogeochem=kaps_4pool] +compulsory=true +description=Specific soil respiration rates for the four pools of the 4-pool model (s-1) +length=4 +range=1.0e-12:1.0e-4 +sort-key=f +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::kaps_4pool + +[namelist:jules_soil_biogeochem=kd_ch4] +compulsory=true +description=Scale factor for methanogenic death/turnover rate (hr-1) +range=0.000001:0.01 +sort-key=8c +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::kd_ch4 + +[namelist:jules_soil_biogeochem=l_bgc_heat] +compulsory=true +description=Switch for release of biogeochemical heat into the soil. + =Not available to the UM. +fail-if=this == '.true.' and namelist:jules_model_environment=l_jules_parent == 1; #Biogenic heating scheme is not available to the UM +sort-key=c1 +trigger=namelist:jules_soil_biogeochem=heat_of_respiration: .true.; +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::l_bgc_heat + +[namelist:jules_soil_biogeochem=l_ch4_interactive] +compulsory=true +description=Switch on interactive methane +fail-if=this == '.true.' and namelist:jules_soil_biogeochem=l_ch4_tlayered == '.false.' +sort-key=n +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::l_ch4_interactive +value-titles=Methane flux updates soil C, Methane flux does not update soil C +values=.true.,.false. +widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget + +[namelist:jules_soil_biogeochem=l_ch4_microbe] +compulsory=true +description=Use microbial methane model + =NOT AVAILABLE TO UM +sort-key=8a +trigger=namelist:jules_soil_biogeochem=k2_ch4: .true.; + =namelist:jules_soil_biogeochem=kd_ch4: .true.; + =namelist:jules_soil_biogeochem=rho_ch4: .true.; + =namelist:jules_soil_biogeochem=q10_mic_ch4: .true.; + =namelist:jules_soil_biogeochem=cue_ch4: .true.; + =namelist:jules_soil_biogeochem=mu_ch4: .true.; + =namelist:jules_soil_biogeochem=frz_ch4: .true.; + =namelist:jules_soil_biogeochem=alpha_ch4: .true.; + =namelist:jules_soil_biogeochem=ev_ch4: .true.; + =namelist:jules_soil_biogeochem=q10_ev_ch4: .true.; +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::l_ch4_microbe +warn-if=this== '.true.' and namelist:jules_soil_biogeochem=ch4_substrate != 1 # microbial model only tuned for ch4_substrate=1 + +[namelist:jules_soil_biogeochem=l_ch4_tlayered] +compulsory=true +description=Calculate methane emissions from layered soil temperature (vs 1m average) +sort-key=p +trigger=namelist:jules_soil_biogeochem=tau_ch4: .true.; +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::l_ch4_tlayered +value-titles=Use layered soil temperature, Use depth-averaged soil temperature +values=.true.,.false. +widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget + +[namelist:jules_soil_biogeochem=l_label_frac_cs] +compulsory=true +description=Label and trace a fraction of soil carbon + =NOT AVAILABLE TO UM +sort-key=b1 +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::l_label_frac_cs + +[namelist:jules_soil_biogeochem=l_layeredc] +compulsory=true +description=Use layered soil carbon model +fail-if=this == '.true.' and namelist:jules_soil_biogeochem=soil_bgc_model == 3 +sort-key=b +trigger=namelist:jules_soil_biogeochem=tau_resp: .true.; + =namelist:jules_soil_biogeochem=l_label_frac_cs: .true.; + =namelist:jules_soil_biogeochem=diff_n_pft: .true.; + =namelist:jules_soil_biogeochem=z_burn_max: .true.; +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::l_layeredc + +[namelist:jules_soil_biogeochem=l_q10] +compulsory=true +description=Choose soil decomposition dependence on temperature +sort-key=c +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::l_q10 +value-titles=Q10 temperature function,Clark et al. (2011) temperature function +values=.true.,.false. +warn-if=this == '.false.' and namelist:jules_soil_biogeochem=l_bgc_heat == '.true.' +widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget + +[namelist:jules_soil_biogeochem=l_soil_resp_lev2] +compulsory=true +description=Soil respiration calculated using temperature and moisture from layer 2 +sort-key=m +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::l_soil_resp_lev2 +value-titles=Use 2nd soil layer + total moisture content for respiration, Use top soil layer + unfrozen moisture content for respiration +values=.true.,.false. +widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget + +[namelist:jules_soil_biogeochem=mu_ch4] +compulsory=true +description=Threshold growth rate below which methanogens die (hr-1) +range=0.000001:0.01 +sort-key=8g +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::mu_ch4 + +[namelist:jules_soil_biogeochem=n_inorg_turnover] +compulsory=true +description=Inorganic Nitrogren Turnover rate (360 days-1) +range=0.01:100 +sort-key=i +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::n_inorg_turnover + +[namelist:jules_soil_biogeochem=q10_ch4_cs] +compulsory=true +description=Q10 factor for soil carbon substrate CH4 emissions +range=0.1:10.0 +sort-key=2f +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::q10_ch4_cs + +[namelist:jules_soil_biogeochem=q10_ch4_npp] +compulsory=true +description=Q10 factor for NPP substrate CH4 emissions +range=0.1:10.0 +sort-key=2g +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::q10_ch4_npp + +[namelist:jules_soil_biogeochem=q10_ch4_resps] +compulsory=true +description=Q10 factor for soil respiration substrate CH4 emissions +range=0.1:10.0 +sort-key=2h +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::q10_ch4_resps + +[namelist:jules_soil_biogeochem=q10_ev_ch4] +compulsory=true +description=Q10 for temperature response of methanogenic traits under adaptation +range=0.1:10.0 +sort-key=8k +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::q10_ev_ch4 + +[namelist:jules_soil_biogeochem=q10_mic_ch4] +compulsory=true +description=Q10 factor for methanogens +range=0.1:10.0 +sort-key=8e +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::q10_mic_ch4 + +[namelist:jules_soil_biogeochem=q10_soil] +compulsory=true +description=Q10 factor for soil respiration +range=0.1:10.0 +sort-key=d +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::q10_soil + +[namelist:jules_soil_biogeochem=rho_ch4] +compulsory=true +description=Factor in substrate limitation function (related to half saturation of substrate for methanogenic respiration) +range=1.0:1000.0 +sort-key=8d +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::rho_ch4 + +[namelist:jules_soil_biogeochem=soil_bgc_model] +compulsory=true +description=Choice of soil biogeochemistry model +fail-if=this == 1 and namelist:jules_vegetation=l_triffid == '.true.'; # Can't use 1-pool with TRIFFID + =this == 2 and namelist:jules_vegetation=l_triffid != '.true.'; # Can't use 4-pool soil C without TRIFFID + =this == 3 and namelist:jules_vegetation=l_triffid != '.true.'; # Can't use ECOSSE without TRIFFID +sort-key=a +trigger=namelist:jules_soil_biogeochem=l_q10: 1, 2; + =namelist:jules_soil_biogeochem=q10_soil: 1, 2, 3; + =namelist:jules_soil_biogeochem=l_soil_resp_lev2: 1, 2; + =namelist:jules_soil_biogeochem=cs_decomp_soil_moist_func: 1, 2; + =namelist:jules_soil_biogeochem=kaps: 1; + =namelist:jules_soil_biogeochem=kaps_4pool: 2; + =namelist:jules_soil_biogeochem=sorp: 2; + =namelist:jules_soil_biogeochem=n_inorg_turnover: 2; + =namelist:jules_soil_biogeochem=bio_hum_cn: 2; + =namelist:jules_soil_biogeochem=diff_n_pft: 2; + =namelist:jules_soil_biogeochem=tau_lit: 2, 3; + =namelist:jules_soil_biogeochem=tau_resp: 2; + =namelist:jules_soil_ecosse=l_soil_n: 3; + =namelist:jules_soil_ecosse=depo_nit_frac: 3; + =namelist:jules_soil_ecosse=l_match_layers: 3; + =namelist:jules_soil_ecosse=dt_soilc: 3; + =namelist:jules_soil_ecosse=dz_soilc_io: 3; + =namelist:jules_soil_ecosse=plant_input_profile: 3; + =namelist:jules_soil_ecosse=pi_sfc_depth: 3; + =namelist:jules_soil_ecosse=pi_sfc_frac: 3; + =namelist:jules_soil_ecosse=bacteria_min_frac: 3; + =namelist:jules_soil_ecosse=bacteria_max_frac: 3; + =namelist:jules_soil_ecosse=bacteria_min_frac_ph: 3; + =namelist:jules_soil_ecosse=bacteria_max_frac_ph: 3; + =namelist:jules_soil_ecosse=cn_bacteria: 3; + =namelist:jules_soil_ecosse=cn_fungi: 3; + =namelist:jules_soil_ecosse=decomp_rate: 3; + =namelist:jules_soil_ecosse=decomp_wrate_min_smith: 3; + =namelist:jules_soil_ecosse=decomp_wrate_min_clark: 3; + =namelist:jules_soil_ecosse=decomp_temp_coeff_smith: 3; + =namelist:jules_soil_ecosse=decomp_ph_min: 3; + =namelist:jules_soil_ecosse=decomp_ph_max: 3; + =namelist:jules_soil_ecosse=decomp_ph_rate_min: 3; + =namelist:jules_soil_ecosse=depth_nitrif: 3; + =namelist:jules_soil_ecosse=nitrif_frac_n2o_fc: 3; + =namelist:jules_soil_ecosse=nitrif_frac_gas: 3; + =namelist:jules_soil_ecosse=nitrif_frac_no: 3; + =namelist:jules_soil_ecosse=nitrif_max_factor: 3; + =namelist:jules_soil_ecosse=nitrif_rate: 3; + =namelist:jules_soil_ecosse=nitrif_wrate_min: 3; + =namelist:jules_soil_ecosse=denit50: 3; + =namelist:jules_soil_ecosse=denit_frac_n2_fc: 3; + =namelist:jules_soil_ecosse=denit_nitrate_equal: 3; + =namelist:jules_soil_ecosse=denit_water_coeff: 3; + =namelist:jules_soil_ecosse=denit_bio_factor: 3; + =namelist:jules_soil_ecosse=amm_leach_min: 3; + =namelist:jules_soil_ecosse=n_inorg_max_conc: 3; + =namelist:jules_soil_ecosse=l_driver_ave: 3; + =namelist:jules_soil_ecosse=l_decomp_slow: 3; + =namelist:jules_soil_ecosse=temp_modifier: 3; + =namelist:jules_soil_ecosse=water_modifier: 3; + =namelist:jules_soil_ecosse=dim_cslayer: 3; +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::soil_bgc_model +value-titles=Single pool model,4-pool model,ECOSSE +values=1,2,3 +widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget + +[namelist:jules_soil_biogeochem=sorp] +compulsory=true +description=Soil leaching N Retention factor +range=0.01:100.0 +sort-key=h +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::sorp + +[namelist:jules_soil_biogeochem=t0_ch4] +compulsory=true +description=Reference temperature for Q10 function CH4 emissions +range=250:320 +sort-key=2b +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::t0_ch4 + +[namelist:jules_soil_biogeochem=tau_ch4] +compulsory=true +description=Decay factor with depth representing methane oxidation +range=0.01:100.0 +sort-key=q +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::tau_ch4 + +[namelist:jules_soil_biogeochem=tau_lit] +compulsory=true +description=Exponential decay constant for reduction of litter inputs with depth +range=0.01:100.0 +sort-key=b2 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::tau_lit + +[namelist:jules_soil_biogeochem=tau_resp] +compulsory=true +description=Exponential decay constant for reduction of respiration with depth +range=0.01:100.0 +sort-key=b2 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::tau_resp + +[namelist:jules_soil_biogeochem=z_burn_max] +compulsory=true +description=Maximum burn depth for soil - soil carbon is burned above this level +range=0.0:10.0 +sort-key=b2 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::z_burn_max diff --git a/rose-meta/jules-shared/jules-soil-ecosse/HEAD/rose-meta.conf b/rose-meta/jules-shared/jules-soil-ecosse/HEAD/rose-meta.conf new file mode 100644 index 00000000..986e7393 --- /dev/null +++ b/rose-meta/jules-shared/jules-soil-ecosse/HEAD/rose-meta.conf @@ -0,0 +1,277 @@ +[namelist:jules_soil_ecosse] +compulsory=true +ns=namelist/JULES Science Settings/jules_soil_ecosse +sort-key=07 +title=Soil ECOSSE model options + +[namelist:jules_soil_ecosse=amm_leach_min] +compulsory=true +description=Minimum allowed amount of N in NH4 after leaching (kg m-3) +range=0: +type=real + +[namelist:jules_soil_ecosse=bacteria_max_frac] +compulsory=true +description=Maximum fraction of decomposer community that are bacteria +range=0:1 +type=real + +[namelist:jules_soil_ecosse=bacteria_max_frac_ph] +compulsory=true +description=Soil pH at or above which the fraction of bacteria is at a maximum +range=0:14 +type=real + +[namelist:jules_soil_ecosse=bacteria_min_frac] +compulsory=true +description=Minimum fraction of decomposer community that are bacteria +range=0:1 +type=real + +[namelist:jules_soil_ecosse=bacteria_min_frac_ph] +compulsory=true +description=Soil pH at or below which the fraction of bacteria is at a minimum +range=0:14 +type=real + +[namelist:jules_soil_ecosse=cn_bacteria] +compulsory=true +description=C:N ratio of soil bacteria +range=0.1: +type=real + +[namelist:jules_soil_ecosse=cn_fungi] +compulsory=true +description=C:N ratio of soil fungi +range=0.1: +type=real + +[namelist:jules_soil_ecosse=decomp_ph_max] +compulsory=true +description=pH above which rate of decomposition is maximum +range=0:14 +type=real + +[namelist:jules_soil_ecosse=decomp_ph_min] +compulsory=true +description=pH below which rate of decomposition is minimum +range=0:14 +type=real + +[namelist:jules_soil_ecosse=decomp_ph_rate_min] +compulsory=true +description=Minimum allowed value of pH rate modifier for decomposition +range=0:1 +type=real + +[namelist:jules_soil_ecosse=decomp_rate] +compulsory=true +description=Rate constants for decomposition of each pool (s-1) +length=4 +type=real + +[namelist:jules_soil_ecosse=decomp_temp_coeff_smith] +compulsory=true +description=Constants in Smith et al. (2010) soil C decomposition rate temperature modifier +length=3 +type=real + +[namelist:jules_soil_ecosse=decomp_wrate_min_clark] +compulsory=true +description=Minimum allowed value of the JULES form for water rate modifier for decomposition +range=0:1 +type=real + +[namelist:jules_soil_ecosse=decomp_wrate_min_smith] +compulsory=true +description=Minimum allowed value of the Smith et al. (2010) water rate modifier for decomposition +range=0:1 +type=real + +[namelist:jules_soil_ecosse=denit50] +compulsory=true +description=Amount of nitrate at which denitrification rate is 50% of the potential rate (kg m-3) +range=0: +type=real + +[namelist:jules_soil_ecosse=denit_bio_factor] +compulsory=true +description=Factor in denitrification calculation to convert C flux into a representation of biological activity +range=0: +type=real + +[namelist:jules_soil_ecosse=denit_frac_n2_fc] +compulsory=true +description=Fraction of denitrified N that becomes N2 when soil moisture is at field capacity +range=0:1 +type=real + +[namelist:jules_soil_ecosse=denit_nitrate_equal] +compulsory=true +description=Amount of N in soil nitrate at which denitrified N is released as equal amounts of N2 and N2O (kg m-3) +range=0: +type=real + +[namelist:jules_soil_ecosse=denit_water_coeff] +compulsory=true +description=Fitted constants describing water modifier for denitrification +length=3 +type=real + +[namelist:jules_soil_ecosse=depo_nit_frac] +compulsory=true +description=Fraction of total N deposition that is added to soil nitrate +range=0:1 +type=real + +[namelist:jules_soil_ecosse=depth_nitrif] +compulsory=true +description=Greatest depth at which nitrification and denitrification are allowed (m) +range=0: +type=real + +[namelist:jules_soil_ecosse=dim_cslayer] +compulsory=true +description=Number of soil carbon layers +range=1: +type=integer + +[namelist:jules_soil_ecosse=dt_soilc] +compulsory=true +description=Timestep length for soil biogeochemistry model (s) +type=real + +[namelist:jules_soil_ecosse=dz_soilc_io] +compulsory=true +description=Thicknesses of the soil biogeochemistry layers (m) +fail-if=len(this) != dim_cslayer; # Must have a value for each layer +length=: +type=real + +[namelist:jules_soil_ecosse=l_decomp_slow] +compulsory=true +description=Switch to slow decomposition when N is limiting +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_ecosse.nml.html#JULES_SOIL_ECOSSE::l_decomp_slow +value-titles=Decomposition slowed, Decomposition less efficient +values=.true.,.false. +widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget + +[namelist:jules_soil_ecosse=l_driver_ave] +compulsory=true +description=Switch for time-averaging of ECOSSE driving variables +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_ecosse.nml.html#JULES_SOIL_ECOSSE::l_driver_ave +value-titles=Time average, Instantaneous values +values=.true.,.false. +widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget + +[namelist:jules_soil_ecosse=l_match_layers] +compulsory=true +description=Switch to match soil C and N layers to soil moisture layers +trigger=namelist:jules_soil_ecosse=dim_cslayer: .false.; + =namelist:jules_soil_ecosse=dz_soilc_io: .false.; +url=https://metoffice.github.io/jules/latest/namelists/jules_soil_ecosse.nml.html#JULES_SOIL_ECOSSE::l_match_layers +value-titles=Match to soil moisture layers, Specify layers +values=.true.,.false. +widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget + +[namelist:jules_soil_ecosse=l_soil_n] +compulsory=true +description=Switch for a prognostic model of soil Nitrogen +trigger=namelist:jules_soil_ecosse=depo_nit_frac: .true.; + =namelist:jules_soil_ecosse=l_decomp_slow: .true.; + =namelist:jules_soil_ecosse=bacteria_min_frac: .true.; + =namelist:jules_soil_ecosse=bacteria_max_frac: .true.; + =namelist:jules_soil_ecosse=bacteria_min_frac_ph: .true.; + =namelist:jules_soil_ecosse=bacteria_max_frac_ph: .true.; + =namelist:jules_soil_ecosse=cn_bacteria: .true.; + =namelist:jules_soil_ecosse=cn_fungi: .true.; + =namelist:jules_soil_ecosse=depth_nitrif: .true.; + =namelist:jules_soil_ecosse=nitrif_frac_n2o_fc: .true.; + =namelist:jules_soil_ecosse=nitrif_rate: .true.; + =namelist:jules_soil_ecosse=nitrif_frac_gas: .true.; + =namelist:jules_soil_ecosse=nitrif_frac_no: .true.; + =namelist:jules_soil_ecosse=nitrif_max_factor: .true.; + =namelist:jules_soil_ecosse=nitrif_wrate_min: .true.; + =namelist:jules_soil_ecosse=denit50: .true.; + =namelist:jules_soil_ecosse=denit_frac_n2_fc: .true.; + =namelist:jules_soil_ecosse=denit_nitrate_equal: .true.; + =namelist:jules_soil_ecosse=denit_water_coeff: .true.; + =namelist:jules_soil_ecosse=denit_bio_factor: .true.; + =namelist:jules_soil_ecosse=amm_leach_min: .true.; + =namelist:jules_soil_ecosse=n_inorg_max_conc: .true.; +type=logical + +[namelist:jules_soil_ecosse=n_inorg_max_conc] +compulsory=true +description=Maximum-allowed concentration of inorganic N in a layer (kg m-3) +type=real + +[namelist:jules_soil_ecosse=nitrif_frac_gas] +compulsory=true +description=Fraction of nitrification lost as gas through full nitrification +range=0:1 +type=real + +[namelist:jules_soil_ecosse=nitrif_frac_n2o_fc] +compulsory=true +description=Fraction of nitrification lost as N2O by partial nitrification at field capacity +range=0:1 +type=real + +[namelist:jules_soil_ecosse=nitrif_frac_no] +compulsory=true +description=Fraction of nitrification gas loss through full nitrification that is NO +range=0:1 +type=real + +[namelist:jules_soil_ecosse=nitrif_max_factor] +compulsory=true +description=Shape factor in rate modifier for nitrification (kg m-3) +range=0:1 +type=real + +[namelist:jules_soil_ecosse=nitrif_rate] +compulsory=true +description=Rate constant for nitrification (s-1) +range=0: +type=real + +[namelist:jules_soil_ecosse=nitrif_wrate_min] +compulsory=true +description=Minimum allowed value of water rate modifier for nitrification when Smith et al., 2010 form is used +range=0: +type=real + +[namelist:jules_soil_ecosse=pi_sfc_depth] +compulsory=true +description=Depth of soil over which fraction pi_sfc_frac of plant litterfall is added (m). +type=real + +[namelist:jules_soil_ecosse=pi_sfc_frac] +compulsory=true +description=Fraction of plant litterfall that is added to the surface soil layer (of depth pi_sfc_depth). +range=0:1 +type=real + +[namelist:jules_soil_ecosse=plant_input_profile] +compulsory=true +description=Switch for distribution of litterfall inputs to the soil. +trigger=namelist:jules_soil_ecosse=pi_sfc_depth: 1; + =namelist:jules_soil_ecosse=pi_sfc_frac: 1; +value-titles=RootProfile,Exponential +values=1,2 +widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget + +[namelist:jules_soil_ecosse=temp_modifier] +compulsory=true +description=Switch for form of temperature rate modifier for decomposition +value-titles=Q10,Smith +values=1,2 +widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget + +[namelist:jules_soil_ecosse=water_modifier] +compulsory=true +description=Switch for form of water rate modifier for decomposition +value-titles=Clark,Smith +values=1,2 +widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget diff --git a/rose-meta/jules-shared/jules-temp-fixes/HEAD/rose-meta.conf b/rose-meta/jules-shared/jules-temp-fixes/HEAD/rose-meta.conf new file mode 100644 index 00000000..50f4da33 --- /dev/null +++ b/rose-meta/jules-shared/jules-temp-fixes/HEAD/rose-meta.conf @@ -0,0 +1,107 @@ +[namelist:jules_temp_fixes] +compulsory=true +description=To assist managing science fixes across JULES versions +ns=namelist/JULES Science Settings/jules_temp_fixes +sort-key=00 +title=Short term logicals +url=https://metoffice.github.io/jules/latest/namelists/science_fixes.nml.html#namelist-JULES_TEMP_SWITCHES + +[namelist:jules_temp_fixes=ctile_orog_fix] +compulsory=true +description=Fix surface exchange in coastally tiled grid-boxes +fail-if=(this == '0' or this == '1') and namelist:jules_model_environment=l_jules_parent == 0; # This should be 2 in JULES standalone. +url=https://metoffice.github.io/jules/latest/namelists/science_fixes.nml.html#JULES_TEMP_FIXES::ctile_orog_fix +value-titles=No fix,Correct sea adjust land,Correct sea only +values=0,1,2 + +[namelist:jules_temp_fixes=l_accurate_rho] +compulsory=true +description=Improve the accuracy of air density in surface fluxes +type=logical +url=https://metoffice.github.io/jules/latest/namelists/science_fixes.nml.html#JULES_TEMP_FIXES::l_accurate_rho + +[namelist:jules_temp_fixes=l_dtcanfix] +compulsory=true +description=Correct the evolution of the skin temperature in the implicit solver +fail-if=this == '.false.' and namelist:jules_model_environment=l_jules_parent == 0; # This should be .true. in JULES standalone. +type=logical +url=https://metoffice.github.io/jules/latest/namelists/science_fixes.nml.html#JULES_TEMP_FIXES::l_dtcanfix + +[namelist:jules_temp_fixes=l_fix_alb_ice_thick] +compulsory=true +description=Fix bug in ice thickness used for sea ice albedo calculation. +fail-if=this == '.false.' and namelist:jules_model_environment=l_jules_parent == 0; # This should be .true. in JULES standalone. +type=logical +url=https://metoffice.github.io/jules/latest/namelists/science_fixes.nml.html#JULES_TEMP_FIXES::l_fix_alb_ice_thick + +[namelist:jules_temp_fixes=l_fix_albsnow_ts] +compulsory=true +description=Fix bug in the two-stream calculation of the albedo of snow. +fail-if=this == '.false.' and namelist:jules_model_environment=l_jules_parent == 0; # This should be .true. in JULES standalone. +type=logical +url=https://metoffice.github.io/jules/latest/namelists/science_fixes.nml.html#JULES_TEMP_FIXES::l_fix_albsnow_ts + +[namelist:jules_temp_fixes=l_fix_drydep_so2_water] +compulsory=true +description=Use correct surface resistance of water when calculating the dry deposition of SO2 +type=logical +url=https://metoffice.github.io/jules/latest/namelists/science_fixes.nml.html#JULES_TEMP_FIXES::l_fix_drydep_so2_water + +[namelist:jules_temp_fixes=l_fix_improve_drydep] +compulsory=true +description=Fix dry deposition velocities +type=logical +url=https://metoffice.github.io/jules/latest/namelists/science_fixes.nml.html#JULES_TEMP_FIXES::l_fix_improve_drydep + +[namelist:jules_temp_fixes=l_fix_lake_ice_temperatures] +compulsory=true +description=Fix evolution of lake ice temperatures +help=Allow sea ice temperatures in lakes to evolve over time for atmosphere-ocean coupled + =models when the lake is defined as a sea point but is not coupled to an ocean model. +type=logical +url=https://metoffice.github.io/jules/latest/namelists/science_fixes.nml.html#JULES_TEMP_FIXES::l_fix_lake_ice_temperatures + +[namelist:jules_temp_fixes=l_fix_moruses_roof_rad_coupling] +compulsory=true +description=Correction to the roof radiative coupling of MORUSES +type=logical +url=https://metoffice.github.io/jules/latest/namelists/science_fixes.nml.html#JULES_TEMP_FIXES::l_fix_moruses_roof_rad_coupling + +[namelist:jules_temp_fixes=l_fix_neg_snow] +compulsory=true +description=Activate corrections to avoid the generation of negative amounts of snow. +fail-if=this == '.false.' and namelist:jules_model_environment=l_jules_parent == 0; # This should be .true. in JULES standalone. +type=logical +url=https://metoffice.github.io/jules/latest/namelists/science_fixes.nml.html#JULES_TEMP_FIXES::l_fix_neg_snow + +[namelist:jules_temp_fixes=l_fix_osa_chloro] +compulsory=true +description=Correct the units of chlorophyll in the ocean surface albedo +type=logical +url=https://metoffice.github.io/jules/latest/namelists/science_fixes.nml.html#JULES_TEMP_FIXES::l_fix_osa_chloro + +[namelist:jules_temp_fixes=l_fix_snow_frac] +compulsory=true +description=Correction to prevent persistent small snow amounts when using the frac_snow_subl_melt=1 option +type=logical +url=https://metoffice.github.io/jules/latest/namelists/science_fixes.nml.html#JULES_TEMP_FIXES::l_fix_snow_frac + +[namelist:jules_temp_fixes=l_fix_ukca_h2dd_x] +compulsory=true +description=Fix for UKCA deposition of H2. +type=logical +url=https://metoffice.github.io/jules/latest/namelists/science_fixes.nml.html#JULES_TEMP_FIXES::l_fix_h2dd_x + +[namelist:jules_temp_fixes=l_fix_ustar_dust] +compulsory=true +description=Fix surface exchange for dust deposition +fail-if=this == '.false.' and namelist:jules_model_environment=l_jules_parent == 0; # This should be .true. in JULES standalone. +type=logical +url=https://metoffice.github.io/jules/latest/namelists/science_fixes.nml.html#JULES_TEMP_FIXES::l_fix_ustar_dust + +[namelist:jules_temp_fixes=l_fix_wind_snow] +compulsory=true +description=Fix to ensure wind speed is provided for snow unloading from vegetation +fail-if=this == '.false.' and namelist:jules_model_environment=l_jules_parent == 0; # This should be .true. in JULES standalone. +type=logical +url=https://metoffice.github.io/jules/latest/namelists/science_fixes.nml.html#JULES_TEMP_FIXES::l_fix_wind_snow diff --git a/rose-meta/jules-shared/jules-vegetation/HEAD/rose-meta.conf b/rose-meta/jules-shared/jules-vegetation/HEAD/rose-meta.conf index 5c8f7f03..26149cc3 100644 --- a/rose-meta/jules-shared/jules-vegetation/HEAD/rose-meta.conf +++ b/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 diff --git a/rose-meta/jules-shared/jules-water-resources/HEAD/rose-meta.conf b/rose-meta/jules-shared/jules-water-resources/HEAD/rose-meta.conf new file mode 100644 index 00000000..411e0226 --- /dev/null +++ b/rose-meta/jules-shared/jules-water-resources/HEAD/rose-meta.conf @@ -0,0 +1,150 @@ +[namelist:jules_water_resources] +compulsory=true +description=Configuration of water resource modelling +ns=namelist/JULES Science Settings/jules_water_resources +sort-key=15 +title=Water resources +url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#namelist-JULES_WATER_RESOURCES + +[namelist:jules_water_resources=l_prioritise] +compulsory=true +description=Switch to specify the priority of water demands +sort-key=a8 +trigger=namelist:jules_water_resources=priority: .true.; +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#JULES_WATER_RESOURCES::l_prioritise + +[namelist:jules_water_resources=l_water_domestic] +compulsory=true +description=Switch for modelling of water for domestic use +sort-key=a2 +trigger=namelist:jules_water_resources=rf_domestic: .true.; +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#JULES_WATER_RESOURCES::l_water_domestic + +[namelist:jules_water_resources=l_water_environment] +compulsory=true +description=Switch for modelling of water for environmental use +fail-if=this == '.true.'; # code is not yet complete +sort-key=a3 +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#JULES_WATER_RESOURCES::l_water_environment + +[namelist:jules_water_resources=l_water_industry] +compulsory=true +description=Switch for modelling of water for industrial use +sort-key=a4 +trigger=namelist:jules_water_resources=rf_industry: .true.; +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#JULES_WATER_RESOURCES::l_water_industry + +[namelist:jules_water_resources=l_water_irrigation] +compulsory=true +description=Switch for modelling of water for irrigation +fail-if=namelist:jules_irrig=l_irrig_limit == '.true.' and this == '.true.'; # l_irrig_limit must be F if l_water_irrigation=T +sort-key=a5 +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#JULES_WATER_RESOURCES::l_water_irrigation + +[namelist:jules_water_resources=l_water_livestock] +compulsory=true +description=Switch for modelling of water for livestock +sort-key=a6 +trigger=namelist:jules_water_resources=rf_livestock: .true.; +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#JULES_WATER_RESOURCES::l_water_livestock + +[namelist:jules_water_resources=l_water_resources] +compulsory=true +description=Switch for modelling of water resource modelling + =This must be .false. in the UM until further testing. +fail-if=this == '.true.' and namelist:jules_model_environment=l_jules_parent == 1; # Must be false in the UM. +sort-key=a1 +trigger=namelist:jules_water_resources=l_prioritise: .true.; + =namelist:jules_water_resources=l_water_domestic: .true.; + =namelist:jules_water_resources=l_water_environment: .true.; + =namelist:jules_water_resources=l_water_industry: .true.; + =namelist:jules_water_resources=l_water_irrigation: .true.; + =namelist:jules_water_resources=l_water_livestock: .true.; + =namelist:jules_water_resources=l_water_transfers: .true.; + =namelist:jules_water_resources=nr_gwater_model: .true.; + =namelist:jules_water_resources=nstep_water_res: .true.; + =namelist:jules_water_resources=partition_method: .true.; + =namelist:jules_water_resources_props: .true.; +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#JULES_WATER_RESOURCES::l_water_resources + +[namelist:jules_water_resources=l_water_transfers] +compulsory=true +description=Switch for modelling of water for water transfers +fail-if=this == '.true.'; # code is not yet complete +sort-key=a7 +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#JULES_WATER_RESOURCES::l_water_transfers + +[namelist:jules_water_resources=nr_gwater_model] +compulsory=true +description=Model for non-renewable groundwater +sort-key=b2 +url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#JULES_WATER_RESOURCES::nr_gwater_model +value-titles=None,Last resort,Mix +values=0,1,2 +widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget + +[namelist:jules_water_resources=nstep_water_res] +compulsory=true +description=Timestep length for water resource model (number of main model timesteps) +range=1: +sort-key=b1 +type=integer +url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#JULES_WATER_RESOURCES::nstep_water_res + +[namelist:jules_water_resources=partition_method] +compulsory=true +description=Method used to get the target fraction of demand to be met from surface water +sort-key=b6 +trigger=namelist:jules_water_resources=sfc_water_factor: 2; +url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#JULES_WATER_RESOURCES::partition_method +value-titles=None,Use ancillary file,Calculate from stores +values=0,1,2 +widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget + +[namelist:jules_water_resources=priority] +compulsory=true +description=Water sector names, in order of decreasing priority +length=: +sort-key=a9 +url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#JULES_WATER_RESOURCES::priority +values='dom','env','ind','irr','liv','tra' + +[namelist:jules_water_resources=rf_domestic] +compulsory=true +description=Fraction of water that is returned after abstraction for domestic use +range=0:1 +sort-key=b3 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#JULES_WATER_RESOURCES::rf_domestic + +[namelist:jules_water_resources=rf_industry] +compulsory=true +description=Fraction of water that is returned after abstraction for industrial purposes +range=0:1 +sort-key=b4 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#JULES_WATER_RESOURCES::rf_industry + +[namelist:jules_water_resources=rf_livestock] +compulsory=true +description=Fraction of water that is returned after abstraction for livestock +range=0:1 +sort-key=b5 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#JULES_WATER_RESOURCES::rf_livestock + +[namelist:jules_water_resources=sfc_water_factor] +compulsory=true +description=Weight applied to surface water when calculating target fraction for surface water +range=0: +sort-key=b7 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#JULES_WATER_RESOURCES::sfc_water_factor diff --git a/rose-meta/jules-standalone/HEAD/rose-meta.conf b/rose-meta/jules-standalone/HEAD/rose-meta.conf index e30a27c5..147adb5e 100644 --- a/rose-meta/jules-standalone/HEAD/rose-meta.conf +++ b/rose-meta/jules-standalone/HEAD/rose-meta.conf @@ -1,16 +1,36 @@ -# Please see jules:wiki:SharingJULESmetadata - -import=jules-shared/jules-hydrology/HEAD +############################################################################### +# This is the "standalone" flavour of the JULES metadata +############################################################################### +# This should only contain: +# * Import statements from jules-shared. +# * JULES specific amendments to the imported metadata. +# The majority of the metadata should be under rose-meta/jules-shared. +# +# Please see https://github.com/MetOffice/jules/wiki/Sharing-JULES-metadata +############################################################################### + +import=jules-shared/jules-deposition/HEAD + =jules-shared/jules-deposition-species/HEAD + =jules-shared/jules-deposition-species-specific/HEAD + =jules-shared/jules-hydrology/HEAD + =jules-shared/jules-irrig/HEAD =jules-shared/jules-model-environment/HEAD =jules-shared/jules-nvegparm/HEAD + =jules-shared/jules-overbank/HEAD =jules-shared/jules-pftparm/HEAD =jules-shared/jules-radiation/HEAD + =jules-shared/jules-red/HEAD + =jules-shared/jules-rivers/HEAD =jules-shared/jules-snow/HEAD =jules-shared/jules-soil/HEAD + =jules-shared/jules-soil-biogeochem/HEAD + =jules-shared/jules-soil-ecosse/HEAD =jules-shared/jules-surface/HEAD =jules-shared/jules-surface-types/HEAD + =jules-shared/jules-temp-fixes/HEAD =jules-shared/jules-urban/HEAD =jules-shared/jules-vegetation/HEAD + =jules-shared/jules-water-resources/HEAD [command] ns=Execution command @@ -1475,304 +1495,6 @@ length=: type=real url=https://metoffice.github.io/jules/latest/namelists/crop_params.nml.html#JULES_CROPPARM::yield_frac_io -[namelist:jules_deposition] -compulsory=true -description=Configuration of atmospheric deposition -ns=namelist/JULES Science Settings/jules_deposition -title=Deposition -url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#namelist-JULES_DEPOSITION - -[namelist:jules_deposition=dep_h2_soil_scheme] -compulsory=true -description=Scheme for H2 soil deposition -fail-if=( this == 2 and namelist:jules_model_environment=l_jules_parent == 1 ) ; # The Paulot et al. H2 scheme is not yet fully implemented for UM-coupled JULES applications (when JULES deposition called from UKCA): only Conrad & Seiler scheme available, dep_h2_soil_scheme = 1 -sort-key=5f -url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION::dep_h2_soil_scheme -value-titles=Conrad & Seiler H2 deposition scheme,Paulot et al. H2 deposition scheme -values=1,2 - -[namelist:jules_deposition=dry_dep_model] -compulsory=true -description=Dry deposition model -sort-key=2 -trigger=namelist:jules_deposition_species=dd_ice_coeff_io: 2; - =namelist:jules_deposition_species=dep_species_name_io: 1,2; - =namelist:jules_deposition_species=dep_species_rmm_io: 2; - =namelist:jules_deposition_species=diffusion_coeff_io: 2; - =namelist:jules_deposition_species=diffusion_corr_io: 2; - =namelist:jules_deposition_species=r_tundra_io: 2; - =namelist:jules_deposition_species=rsurf_std_io: 2; - =namelist:jules_deposition_species_specific=ch4_mml_io: 2; - =namelist:jules_deposition_species_specific=ch4_scaling_io: 2; - =namelist:jules_deposition_species_specific=ch4_up_flux_io: 2; - =namelist:jules_deposition_species_specific=ch4dd_tundra_io: 2; - =namelist:jules_deposition_species_specific=cuticle_o3_io: 2; - =namelist:jules_deposition_species_specific=h2dd_c_io: 2; - =namelist:jules_deposition_species_specific=h2dd_m_io: 2; - =namelist:jules_deposition_species_specific=h2dd_q_io: 2; - =namelist:jules_deposition_species_specific=r_wet_soil_o3_io: 2; -url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION::dry_dep_model -value-titles=JULES with restricted UKCA deposition,JULES with flexible UKCA deposition -values=1,2 -widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget - -[namelist:jules_deposition=dzl_const] -compulsory=true -description=Constant separation for boundary layer levels (m) -range=0: -sort-key=6 -url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION::dzl_const - -[namelist:jules_deposition=l_deposition] -compulsory=true -description=Switch to enable JULES-based atmospheric dry deposition -fail-if=(this == '.true.' and namelist:jules_surface=l_aggregate == ".true.") ; # Deposition does not work with aggregated tile -sort-key=1 -trigger=namelist:jules_deposition=dep_h2_soil_scheme: .true.; - =namelist:jules_deposition=dry_dep_model: .true.; - =namelist:jules_deposition=dzl_const: .true.; - =namelist:jules_deposition=l_deposition_flux: .true.; - =namelist:jules_deposition=l_deposition_gc_corr: .true.; - =namelist:jules_deposition=l_ukca_ddep_lev1: .true.; - =namelist:jules_deposition=l_ukca_ddepo3_ocean: .true.; - =namelist:jules_deposition=l_ukca_dry_dep_so2wet: .true.; - =namelist:jules_deposition=l_ukca_emsdrvn_ch4: .true.; - =namelist:jules_deposition=ndry_dep_species: .true.; - =namelist:jules_deposition=tundra_s_limit: .true.; - =namelist:jules_deposition_species: .true.; - =namelist:jules_deposition_species_specific: .true.; - =namelist:jules_temp_fixes=l_fix_drydep_so2_water: .true.; - =namelist:jules_temp_fixes=l_fix_improve_drydep: .true.; - =namelist:jules_temp_fixes=l_fix_ukca_h2dd_x: .true.; -type=logical -url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION::l_deposition - -[namelist:jules_deposition=l_deposition_flux] -compulsory=true -description=Switch to enable calculation of deposition fluxes -sort-key=4a -type=logical -url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION::l_deposition_flux - -[namelist:jules_deposition=l_deposition_from_ukca] -compulsory=true -description=Switch to call JULES-based deposition routines from ukca_chemistry_ctl -fail-if=( this == '.false.' and namelist:jules_model_environment=l_jules_parent == 1 ) ; # For UM_JULES applications, only the call to the deposition routines from the UKCA is currently available - =( this == '.true.' and namelist:jules_model_environment=l_jules_parent == 0 ) ; # Deposition switch cannot be true in JULES standalone as JULES-based deposition routines called from UKCA -sort-key=5a -type=logical -url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION::l_deposition_from_ukca - -[namelist:jules_deposition=l_deposition_gc_corr] -compulsory=true -description=Switch to correct stomatal conductance for bare soil evaporation -fail-if=( this == '.true.' and namelist:jules_model_environment=l_jules_parent == 1 ) ; # For UM_JULES applications, stomatal conductance corrected for bare soil evaporation is not available in the UKCA -sort-key=4b -type=logical -url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION::l_deposition_gc_corr - -[namelist:jules_deposition=l_ukca_ddep_lev1] -compulsory=true -description=Apply dry deposition losses only from the lowest level (true) or all levels (false) in the atmospheric boundary layer -sort-key=5b -type=logical -url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION::l_ukca_ddep_lev1 - -[namelist:jules_deposition=l_ukca_ddepo3_ocean] -compulsory=true -description=Use a mechanistic calculation for ocean ozone deposition -fail-if=( this == '.true.' and namelist:jules_model_environment=l_jules_parent == 0 ) ; # Deposition switch not available in JULES standalone as requires >75% open water fraction -sort-key=5c -type=logical -url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION::l_ukca_ddepo3 - -[namelist:jules_deposition=l_ukca_dry_dep_so2wet] -compulsory=true -description=Accounting for surface wetness in the dry deposition for SO2 -fail-if=( this == '.true.' and namelist:jules_model_environment=l_jules_parent == 0 ) ; # Deposition switch not fully implemented in JULES standalone -sort-key=5d -type=logical -url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION::l_ukca_dry_dep_so2wet - -[namelist:jules_deposition=l_ukca_emsdrvn_ch4] -compulsory=true -description=CH4 emission driven UKCA -sort-key=5e -type=logical -url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION::l_ukca_emsdrvn_ch4 - -[namelist:jules_deposition=ndry_dep_species] -compulsory=true -description=Number of species for dry deposition -range=1:200 -sort-key=3 -url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION::ndry_dep_species - -[namelist:jules_deposition=tundra_s_limit] -compulsory=true -description=sine of latitude of southern limit of tundra -range=-1:1 -sort-key=7 -url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION::tundra_s_limit - -[namelist:jules_deposition_species] -compulsory=true -description=Deposition parameters that depend on species -duplicate=true -ns=namelist/JULES Science Settings/jules_deposition/jules_deposition_species -title=Deposition Species -url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#namelist-JULES_DEPOSITION_SPECIES - -[namelist:jules_deposition_species=dd_ice_coeff_io] -compulsory=true -description=Coefficients for quadratic dependency of dry deposition to ice -fail-if=any(this == -1073741824.0) ; # Invalid parameter value(s) -length=3 -sort-key=6 -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION_SPECIES::dd_ice_coeff_io - -[namelist:jules_deposition_species=dep_species_name_io] -compulsory=true -description=Name of chemical species to be deposited -fail-if=(this == "'unset'") ; # Invalid name for deposited species -sort-key=01 -trigger=namelist:jules_deposition_species=dd_ice_coeff_io: this == "'SO2'" or this == "'HNO3'" or this == "'HONO2'" or this == "'ISON'" or this == "'HCl'" or this == "'HOCl'" or this == "'HBr'" or this == "'HOBr'" ; - =namelist:jules_deposition_species=diffusion_corr_io: this == "'NO2'" or this == "'O3'" or this == "'SO2'" or this == "'NH3'" or this == "'PAN'" or this == "'MPAN'" or this == "'PPAN'" or this == "'ONITU'" ; - =namelist:jules_deposition_species=r_tundra_io: this == "'NO2'" or this == "'O3'" or this == "'CO'" or this == "'H2'" or this == "'PAN'" or this == "'MPAN'" or this == "'PPAN'" or this == "'ONITU'" ; -type=character -url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION_SPECIES::dep_species_name_io - -[namelist:jules_deposition_species=dep_species_rmm_io] -compulsory=true -description=Relative molecular mass (g mol-1), used in calculation of quasi-laminar resistance (Rb) -range=0: -sort-key=02a -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION_SPECIES::dep_species_rmm_io - -[namelist:jules_deposition_species=diffusion_coeff_io] -compulsory=true -description=Diffusion coefficient (m2 s-1), used in calculation of quasi-laminar resistance (Rb) -range=-1,0: -sort-key=02b -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION_SPECIES::diffusion_coeff_io - -[namelist:jules_deposition_species=diffusion_corr_io] -compulsory=true -description=Diffusion correction for stomatal conductance -range=0: -sort-key=04 -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION_SPECIES::diffusion_corr_io - -[namelist:jules_deposition_species=r_tundra_io] -compulsory=true -description=Surface resistance used in tundra region (s m-1) -range=0:1.0e+30 -sort-key=05 -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION_SPECIES::r_tundra_io - -[namelist:jules_deposition_species=rsurf_std_io] -compulsory=true -description=Standard values of surface resistance (s m-1) -fail-if=len(this) != (namelist:jules_surface_types=npft)+(namelist:jules_surface_types=nnvg) -length=: -range=0:1.0e+30 -sort-key=03 -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION_SPECIES::rsurf_std_io - -[namelist:jules_deposition_species_specific] -compulsory=true -description=Deposition parameters that depend on species -ns=namelist/JULES Science Settings/jules_deposition/jules_deposition_species_specific -title=Deposition Species Specific -url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#namelist-JULES_DEPOSITION_SPECIES - -[namelist:jules_deposition_species_specific=ch4_mml_io] -compulsory=true -description=Factor to convert methane flux to dry dep velocity -range=0: -sort-key=02b -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION_SPECIES::ch4_mml_io - -[namelist:jules_deposition_species_specific=ch4_scaling_io] -compulsory=true -description=Scaling applied to CH4 soil uptake -range=0: -sort-key=02a -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION_SPECIES::ch4_scaling_io - -[namelist:jules_deposition_species_specific=ch4_up_flux_io] -compulsory=true -description=Uptake of methane to different surface types -fail-if=len(this) != (namelist:jules_surface_types=npft)+(namelist:jules_surface_types=nnvg) -length=: -range=0: -sort-key=02c -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION_SPECIES::ch4_up_flux_io - -[namelist:jules_deposition_species_specific=ch4dd_tundra_io] -compulsory=true -description=Coefficients of cubic fit for CH4 loss to tundra -fail-if=any(this == -1073741824.0) ; # Invalid parameter value(s) -length=4 -sort-key=02d -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION_SPECIES::ch4dd_tundra_io - -[namelist:jules_deposition_species_specific=cuticle_o3_io] -compulsory=true -description=Constant in calculation of cuticular resistance for ozone (s m-1) -range=0:1.0e+30 -sort-key=1a -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION_SPECIES::cuticle_o3_io - -[namelist:jules_deposition_species_specific=h2dd_c_io] -compulsory=true -description=Constant in quadratic function for hydrogen deposition -fail-if=len(this) != (namelist:jules_surface_types=npft)+(namelist:jules_surface_types=nnvg) - =any(this == -1073741824.0) ; # Invalid parameter value(s) -length=: -sort-key=03a -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION_SPECIES::h2dd_c_io - -[namelist:jules_deposition_species_specific=h2dd_m_io] -compulsory=true -description=Coefficient of first order term in quadratic function for hydrogen deposition -fail-if=len(this) != (namelist:jules_surface_types=npft)+(namelist:jules_surface_types=nnvg) - =any(this == -1073741824.0) ; # Invalid parameter value(s) -length=: -sort-key=03b -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION_SPECIES::h2dd_m_io - -[namelist:jules_deposition_species_specific=h2dd_q_io] -compulsory=true -description=Coefficient of second order term in quadratic function for hydrogen deposition -fail-if=len(this) != (namelist:jules_surface_types=npft)+(namelist:jules_surface_types=nnvg) - =any(this == -1073741824.0) ; # Invalid parameter value(s) -length=: -sort-key=03c -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION_SPECIES::h2dd_q_io - -[namelist:jules_deposition_species_specific=r_wet_soil_o3_io] -compulsory=true -description=Wet soil surface resistance for ozone (s m-1) -range=0:1.0e+30 -sort-key=01b -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_deposition.nml.html#JULES_DEPOSITION_SPECIES::r_wet_soil_o3_io - [namelist:jules_drive] compulsory=true description=Configuration of meteorological forcing data @@ -2581,112 +2303,6 @@ sort-key=05 type=character url=https://metoffice.github.io/jules/latest/namelists/model_grid.nml.html#JULES_INPUT_GRID::y_dim_name -[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_props] compulsory=true description=Configuration of irrigation properties @@ -3109,87 +2725,6 @@ sort-key=12 type=character url=https://metoffice.github.io/jules/latest/namelists/output.nml.html#JULES_OUTPUT_PROFILE::var_name -[namelist:jules_overbank] -compulsory=true -ns=namelist/JULES Science Settings/jules_overbank -sort-key=14 -title=River overbank inundation options -url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#namelist-JULES_overbank - -[namelist:jules_overbank=coef_b] -compulsory=true -description=Coefficient in the QBF (=bankfull discharge) allometry. -range=0: -sort-key=f -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_overbank::coef_b - -[namelist:jules_overbank=ent_ratio] -compulsory=true -description=Rosgen entrenchment ratio (= ratio of flood-prone width to bankfull width - = of a channel, where flood-prone width = when the channel depth is - = 2x bankfull depth) -range=0: -sort-key=g -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_overbank::ent_ratio - -[namelist:jules_overbank=exp_c] -compulsory=true -description=Exponent in the QBF (=bankfull discharge) allometry. -range=0: -sort-key=h -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_overbank::exp_c - -[namelist:jules_overbank=overbank_model] -compulsory=true -description=Choice of overbank inundation model -sort-key=a -trigger=namelist:jules_overbank=coef_b: 2; - = namelist:jules_overbank=ent_ratio: 2; - = namelist:jules_overbank=exp_c: 2; - = namelist:jules_overbank=riv_a: 1, 2; - = namelist:jules_overbank=riv_b: 1, 2; - = namelist:jules_overbank=riv_c: 2, 3; - = namelist:jules_overbank=riv_f: 2, 3; -url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_overbank::overbank_model -value-titles=Simple, Simple with Rosgen, Hypsometric integral -values=1,2,3 -widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget - -[namelist:jules_overbank=riv_a] -compulsory=true -description=Coefficient in the allometry for river width -range=0: -sort-key=d -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_overbank::riv_a - -[namelist:jules_overbank=riv_b] -compulsory=true -description=Exponent in the allometry for river width -range=0: -sort-key=e -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_overbank::riv_b - -[namelist:jules_overbank=riv_c] -compulsory=true -description=Coefficient in the allometry for river depth -range=0: -sort-key=b -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_overbank::riv_c - -[namelist:jules_overbank=riv_f] -compulsory=true -description=Exponent in the allometry for river depth -range=0: -sort-key=c -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_overbank::riv_f - [namelist:jules_pdm] compulsory=true description=Configuration of spatially varying PDM properties @@ -3874,350 +3409,63 @@ sort-key=Panel-BR01 type=real url=https://metoffice.github.io/jules/latest/namelists/jules_surface.nml.html#JULES_RADIATION::wght_alb -[namelist:jules_red] +[namelist:jules_rivers_props] compulsory=true -description=All parameters in this section are required to use the Robust Ecosystem Demography - = calculation. - = - =Click on names for more details - = -ns=namelist/JULES Science Settings/jules_red -sort-key=10 -title=RED PFT parameters -url=https://metoffice.github.io/jules/latest/namelists/red_params.nml.html#namelist-JULES_RED +description=Configuration of spatially varying rivers properties including inundation +ns=namelist/Ancillary data/Rivers properties +sort-key=24 +url=https://metoffice.github.io/jules/latest/namelists/ancillaries.nml.html#namelist-JULES_RIVERS_PROPS +widget[rose-config-edit]=pages.PageWithVariableTable --nvar nvars var use_file is_climatology var_name tpl_name const_val -[namelist:jules_red=alpha_recrt] +[namelist:jules_rivers_props=const_val] compulsory=true -description=The fraction of PFT carbon assimilate devoted to reproduction -fail-if=len(this) != (namelist:jules_surface_types=npft) +description=Constant value for all points (used if use_file = .false.) +fail-if=len(this) != namelist:jules_rivers_props=nvars length=: -sort-key=PANEL-I02da +sort-key=7 type=real -url=https://metoffice.github.io/jules/latest/namelists/red_params.nml.html#JULES_RED::alpha_recrt +url=https://metoffice.github.io/jules/latest/namelists/ancillaries.nml.html#JULES_RIVERS_PROPS::const_val -[namelist:jules_red=crwn_area0] +[namelist:jules_rivers_props=coordinate_file] compulsory=true -description=The lowest PFT crown area, value corresponds to the mass0 class (m2) -fail-if=len(this) != (namelist:jules_surface_types=npft) -length=: -sort-key=PANEL-I02db -type=real -url=https://metoffice.github.io/jules/latest/namelists/red_params.nml.html#JULES_RED::crwn_area0 +description=File from which to read river routing coordinates (if templating is used or reading a list of files) +fail-if='%vv' in this; # Coordinate file cannot contain variable name template. +sort-key=17b +type=character +url=https://metoffice.github.io/jules/latest/namelists/ancillaries.nml.html#JULES_RIVERS_PROPS::coordinate_file -[namelist:jules_red=dom_order] +[namelist:jules_rivers_props=file] compulsory=true -description=The value that describes the competitive hierarchy of PFTs competition in - =JULES-RED, the higher the value the more dominant. -fail-if=len(this) != (namelist:jules_surface_types=npft) -length=: -sort-key=PANEL-I02dc -type=integer -url=https://metoffice.github.io/jules/latest/namelists/red_params.nml.html#JULES_RED::dom_order +description=If read_list = TRUE, file to read list of file names + =If read_list = FALSE, file or file name template + =from which to read river routing & overbank indunation properties. +fail-if='%vv' in this and namelist:jules_rivers_props=coordinate_file == "''"; # If variable name templating is used, the file to read coordinates from must be specified. +sort-key=17 +trigger=namelist:jules_rivers_props=tpl_name: '%vv' in this; + =namelist:jules_rivers_props=read_list: '%vv' not in this; +type=character +url=https://metoffice.github.io/jules/latest/namelists/ancillaries.nml.html#JULES_RIVERS_PROPS::file -[namelist:jules_red=height0] +[namelist:jules_rivers_props=is_climatology] compulsory=true -description=The lowest PFT height, value corresponds to the mass0 class (m) -fail-if=len(this) != (namelist:jules_surface_types=npft) +description=Indicate whether the file specified is a 12-month climatology length=: -sort-key=PANEL-I02dd -type=real -url=https://metoffice.github.io/jules/latest/namelists/red_params.nml.html#JULES_RED::height0 +sort-key=4 +type=logical +url=https://metoffice.github.io/jules/latest/namelists/ancillaries.nml.html#JULES_RIVERS_PROPS::is_climatology -[namelist:jules_red=lai_bal0] +[namelist:jules_rivers_props=l_find_grid] compulsory=true -description=The lowest PFT balanced LAI, which corresponds to the mass0 class (m2/m2) -fail-if=len(this) != (namelist:jules_surface_types=npft) -length=: -sort-key=PANEL-I02de -type=real -url=https://metoffice.github.io/jules/latest/namelists/red_params.nml.html#JULES_RED::lai_bal0 +description=Switch to control specification of the land and river grids +sort-key=17b +trigger=namelist:jules_rivers_props=nx_land_grid: .false.; + =namelist:jules_rivers_props=ny_land_grid: .false.; + =namelist:jules_rivers_props=x1_land_grid: .false.; + =namelist:jules_rivers_props=y1_land_grid: .false.; +type=logical +url=https://metoffice.github.io/jules/latest/namelists/ancillaries.nml.html#JULES_RIVERS_PROPS::l_find_grid -[namelist:jules_red=mass0] -compulsory=true -description=The lowest PFT mass class (kg C) -fail-if=len(this) != (namelist:jules_surface_types=npft) -length=: -sort-key=PANEL-I02df -type=real -url=https://metoffice.github.io/jules/latest/namelists/red_params.nml.html#JULES_RED::mass0 - -[namelist:jules_red=massi] -compulsory=true -description=The highest PFT mass class (kg C) -fail-if=len(this) != (namelist:jules_surface_types=npft) -length=: -sort-key=PANEL-I02dg -type=real -url=https://metoffice.github.io/jules/latest/namelists/red_params.nml.html#JULES_RED::massi - -[namelist:jules_red=mclass] -compulsory=true -description=Number of mass classes for each PFT -fail-if=len(this) != (namelist:jules_surface_types=npft) -length=: -sort-key=PANEL-I02dh -type=integer -url=https://metoffice.github.io/jules/latest/namelists/red_params.nml.html#JULES_RED::mclass - -[namelist:jules_red=mort_base] -compulsory=true -description=The baseline PFT mortality rate (/360 days) -fail-if=len(this) != (namelist:jules_surface_types=npft) -length=: -sort-key=PANEL-I02di -type=real -url=https://metoffice.github.io/jules/latest/namelists/red_params.nml.html#JULES_RED::mort_base - -[namelist:jules_red=phi_a] -compulsory=true -description=The allometric/power scaling of PFT mass to PFT height -fail-if=len(this) != (namelist:jules_surface_types=npft) -length=: -sort-key=PANEL-I02dj -type=real -url=https://metoffice.github.io/jules/latest/namelists/red_params.nml.html#JULES_RED::phi_a - -[namelist:jules_red=phi_g] -compulsory=true -description=The allometric/power scaling of PFT mass to PFT mass growth rate -fail-if=len(this) != (namelist:jules_surface_types=npft) -length=: -sort-key=PANEL-I02dk -type=real -url=https://metoffice.github.io/jules/latest/namelists/red_params.nml.html#JULES_RED::phi_g - -[namelist:jules_red=phi_h] -compulsory=true -description=The allometric/power scaling of PFT mass to PFT height -fail-if=len(this) != (namelist:jules_surface_types=npft) -length=: -sort-key=PANEL-I02dl -type=real -url=https://metoffice.github.io/jules/latest/namelists/red_params.nml.html#JULES_RED::phi_h - -[namelist:jules_red=phi_l] -compulsory=true -description=The allometric/power scaling of PFT mass to PFT leaf area index -fail-if=len(this) != (namelist:jules_surface_types=npft) -length=: -sort-key=PANEL-I02dm -type=real -url=https://metoffice.github.io/jules/latest/namelists/red_params.nml.html#JULES_RED::phi_l - -[namelist:jules_rivers] -compulsory=true -ns=namelist/JULES Science Settings/jules_rivers -sort-key=06 -title=River routing options -url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#namelist-JULES_RIVERS - -[namelist:jules_rivers=a_thresh] -compulsory=true -description=The threshold drainage area (specified in number of cells) - = draining to a gridbox above which the gridbox is - = considered to be a river point -sort-key=j -type=integer -url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_RIVERS::a_thresh - -[namelist:jules_rivers=cbland] -compulsory=true -description=The subsurface land wave speed (kinematic wave speed for subsurface flow in a land grid box on the river routing grid, m s-1) -range=this>0 -sort-key=f -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_RIVERS::cbland - -[namelist:jules_rivers=cbriver] -compulsory=true -description=The subsurface river wave speed (kinematic wave speed for subsurface flow in a river grid box on the river routing grid, m s-1) -range=this>0 -sort-key=g -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_RIVERS::cbriver - -[namelist:jules_rivers=cland] -compulsory=true -description=The land wave speed (kinematic wave speed for surface flow in a land grid box on the river routing grid, m s-1) -range=this>0 -sort-key=d -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_RIVERS::cland - -[namelist:jules_rivers=criver] -compulsory=true -description=The river wave speed (kinematic wave speed for surface flow in a river grid box on the river routing grid, m s-1) -range=this>0 -sort-key=e -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_RIVERS::criver - -[namelist:jules_rivers=i_river_vn] -compulsory=true -description=Routing algorithm to use -fail-if=this == 1 and namelist:jules_model_environment=l_jules_parent == 0; # UM_TRIP is not compatible with standalone. - =(this !=1 and this !=2) and namelist:jules_model_environment=l_jules_parent == 1; # UM_TRIP and RFM are the only options compatible with the UM. -sort-key=b -trigger=namelist:jules_rivers=cland: 2; - = namelist:jules_rivers=criver: 2; - = namelist:jules_rivers=cbland: 2; - = namelist:jules_rivers=cbriver: 2; - = namelist:jules_rivers=retl: 2; - = namelist:jules_rivers=retr: 2; - = namelist:jules_rivers=a_thresh: 2; - = namelist:jules_rivers=runoff_factor: 2; - = namelist:jules_rivers=rivers_speed: 1,3; - = namelist:jules_rivers=rivers_meander: 1,3; - = namelist:jules_rivers_props=l_use_area: 2; - = namelist:jules_rivers=lake_water_conserve_method: 1; - = namelist:jules_rivers=trip_globe_shape: 1; -url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_RIVERS::i_river_vn -value-titles=RFM,TRIP -values=2,3 -widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget - -[namelist:jules_rivers=l_riv_overbank] -compulsory=true -description=Enable overbank inundation -fail-if=this == '.true.' and namelist:jules_model_environment=l_jules_parent != 0; # Overbank inundation is not available to the UM or OASIS. -sort-key=n -trigger=namelist:jules_overbank=overbank_model: .true.; -type=logical -url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_RIVERS::l_riv_overbank - -[namelist:jules_rivers=l_rivers] -compulsory=true -description=Enable river routing -sort-key=a -trigger=namelist:jules_rivers=i_river_vn: .true.; - = namelist:jules_rivers=nstep_rivers: .true.; - = namelist:jules_rivers=l_riv_overbank: .true.; - = namelist:jules_overbank: .true.; - = namelist:jules_rivers_props: .true.; -type=logical -url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_RIVERS::l_rivers - -[namelist:jules_rivers=lake_water_conserve_method] -compulsory=true -description=Selects different fields for use in water conservation of lake evaporation -fail-if=this > 0 and namelist:jules_rivers=i_river_vn > 1; # lake_water_conserve_method is not compatible with standalone rivers -url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_RIVERS::lake_water_conserve_method -value-titles=Use fqw_surft,Use elake_surft -values=1,2 - -[namelist:jules_rivers=nstep_rivers] -compulsory=true -description=Number of model timesteps per routing timestep -range=1: -sort-key=c -type=integer -url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_RIVERS::nstep_rivers - -[namelist:jules_rivers=retl] -compulsory=true -description=The (resolution dependent) land return flow fraction -range=-1:1 -sort-key=h -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_RIVERS::retl - -[namelist:jules_rivers=retr] -compulsory=true -description=The (resolution dependent) river return flow fraction -range=-1:1 -sort-key=i -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_RIVERS::retr - -[namelist:jules_rivers=rivers_meander] -compulsory=true -description=Ratio of the actual to calculated river lengths in a river routing gridbox -range=this>0 -sort-key=m -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_RIVERS::rivers_meander - -[namelist:jules_rivers=rivers_speed] -compulsory=true -description=The effective river velocity (m/s) -range=this>0 -sort-key=l -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_RIVERS::rivers_speed - -[namelist:jules_rivers=runoff_factor] -compulsory=true -description=A runoff volume factor (recommended setting=1) -range=this>0 -sort-key=k -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_RIVERS::runoff_factor - -[namelist:jules_rivers=trip_globe_shape] -compulsory=true -description=The shape of the Earth in the TRIP river routing scheme -sort-key=j -url=https://metoffice.github.io/jules/latest/namelists/jules_rivers.nml.html#JULES_RIVERS::trip_globe_shape -value-titles=Spherical,Ellipsoidal -values=1,2 - -[namelist:jules_rivers_props] -compulsory=true -description=Configuration of spatially varying rivers properties including inundation -ns=namelist/Ancillary data/Rivers properties -sort-key=24 -url=https://metoffice.github.io/jules/latest/namelists/ancillaries.nml.html#namelist-JULES_RIVERS_PROPS -widget[rose-config-edit]=pages.PageWithVariableTable --nvar nvars var use_file is_climatology var_name tpl_name const_val - -[namelist:jules_rivers_props=const_val] -compulsory=true -description=Constant value for all points (used if use_file = .false.) -fail-if=len(this) != namelist:jules_rivers_props=nvars -length=: -sort-key=7 -type=real -url=https://metoffice.github.io/jules/latest/namelists/ancillaries.nml.html#JULES_RIVERS_PROPS::const_val - -[namelist:jules_rivers_props=coordinate_file] -compulsory=true -description=File from which to read river routing coordinates (if templating is used or reading a list of files) -fail-if='%vv' in this; # Coordinate file cannot contain variable name template. -sort-key=17b -type=character -url=https://metoffice.github.io/jules/latest/namelists/ancillaries.nml.html#JULES_RIVERS_PROPS::coordinate_file - -[namelist:jules_rivers_props=file] -compulsory=true -description=If read_list = TRUE, file to read list of file names - =If read_list = FALSE, file or file name template - =from which to read river routing & overbank indunation properties. -fail-if='%vv' in this and namelist:jules_rivers_props=coordinate_file == "''"; # If variable name templating is used, the file to read coordinates from must be specified. -sort-key=17 -trigger=namelist:jules_rivers_props=tpl_name: '%vv' in this; - =namelist:jules_rivers_props=read_list: '%vv' not in this; -type=character -url=https://metoffice.github.io/jules/latest/namelists/ancillaries.nml.html#JULES_RIVERS_PROPS::file - -[namelist:jules_rivers_props=is_climatology] -compulsory=true -description=Indicate whether the file specified is a 12-month climatology -length=: -sort-key=4 -type=logical -url=https://metoffice.github.io/jules/latest/namelists/ancillaries.nml.html#JULES_RIVERS_PROPS::is_climatology - -[namelist:jules_rivers_props=l_find_grid] -compulsory=true -description=Switch to control specification of the land and river grids -sort-key=17b -trigger=namelist:jules_rivers_props=nx_land_grid: .false.; - =namelist:jules_rivers_props=ny_land_grid: .false.; - =namelist:jules_rivers_props=x1_land_grid: .false.; - =namelist:jules_rivers_props=y1_land_grid: .false.; -type=logical -url=https://metoffice.github.io/jules/latest/namelists/ancillaries.nml.html#JULES_RIVERS_PROPS::l_find_grid - -[namelist:jules_rivers_props=l_use_area] +[namelist:jules_rivers_props=l_use_area] compulsory=true description=Switch to use a drainage area ancillary field to identify river points sort-key=17c @@ -4635,859 +3883,154 @@ description=Constant in relationship between canopy snow unloading and canopy sn ns=namelist/JULES Science Settings/jules_snow/Other parameters sort-key=Panel-D05 type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::snowunloadfact - -[namelist:jules_snow=unload_rate_cnst] -compulsory=true -description=Constant term in background unloading rate of snow on canopies -fail-if=len(this) != namelist:jules_surface_types=npft; # A value must be given for each PFT -length=: -ns=namelist/JULES Science Settings/jules_snow/Other parameters -sort-key=Panel-D13 -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::unload_rate_cnst - -#[namelist:jules_soil] has moved to jules-shared/jules-soil -[namelist:jules_soil=confrac] -compulsory=true -description=Fraction of the gridbox assumed to be covered by convective precipitation -range=0.0:1.0 -sort-key=Panel-E10 -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::confrac - -[namelist:jules_soil=cs_min] -compulsory=true -description=Minimum allowed soil carbon (kg m-2) -range=0.000001: -sort-key=Panel-E07 -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::cs_min - -[namelist:jules_soil=dzdeep] -compulsory=true -description=Thickness of bedrock (m) -range=0.01: -sort-key=Panel-E06d -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::dzdeep - -[namelist:jules_soil=dzsoil_elev] -compulsory=true -description=Depth (m) of tiled bedrock subsurfaces under elevated tiles. -fail-if=this <= 0 ; # Must have positive value -range=0.01: -sort-key=Panel-E12 -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::dzsoil_elev - -[namelist:jules_soil=dzsoil_io] -compulsory=true -description=Soil layer depths (m), starting with the uppermost layer -fail-if=len(this) != namelist:jules_soil=sm_levels; # Must have a value for each soil level -length=: -sort-key=Panel-E11 -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::dzsoil_io - -[namelist:jules_soil=hcapdeep] -compulsory=true -description=Heat capacity of bedrock (J K-1 m-3) -range=100000:8000000 -sort-key=Panel-E06b -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::hcapdeep - -[namelist:jules_soil=hcondeep] -compulsory=true -description=Thermal conductivity of bedrock (W m-2 K-1) -range=0.4:12.0 -sort-key=Panel-E06c -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::hcondeep - -[namelist:jules_soil=l_bedrock] -compulsory=true -description=Include bedrock below soil column with thermal diffusion; does not include hydrology - =NOT AVAILABLE TO UM -sort-key=Panel-E06 -trigger=namelist:jules_soil=ns_deep: .true.; - = namelist:jules_soil=hcapdeep: .true.; - = namelist:jules_soil=hcondeep: .true.; - = namelist:jules_soil=dzdeep: .true.; -type=logical -url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::l_bedrock - -[namelist:jules_soil=l_broadcast_ancils] -description=Switch to broadcast non-soil tiled ancillary data to all soil tiles (if read from ancil files) -sort-key=Panel-E14a -type=logical -url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::l_broadcast_ancils - -[namelist:jules_soil=l_holdwater] -compulsory=true -description=Stops water being pushed out of the soil column when a single layer is supersaturated -sort-key=Panel-E13 -url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::l_holdwater -value-titles=Bug fixed,Original -values=.true.,.false. -widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget - -[namelist:jules_soil=l_tile_soil] -compulsory=true -description=Switch to set the number of soil tiles to equal the number of surface tiles -fail-if=this == '.true.' and namelist:jules_model_environment=l_jules_parent == 1; # Not available in the UM -sort-key=Panel-E14 -trigger=namelist:jules_soil=l_broadcast_ancils: .true.; - =namelist:jules_initial=l_broadcast_soilt: .true. -type=logical -url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::l_tile_soil - -[namelist:jules_soil=ns_deep] -compulsory=true -description=Number of bedrock layers -range=1: -sort-key=Panel-E06a -type=integer -url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::ns_deep - -[namelist:jules_soil=sm_levels] -compulsory=true -description=Number of soil layers -range=1: -sort-key=Panel-E01 -type=integer -url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::sm_levels - -[namelist:jules_soil=soilhc_method] -compulsory=true -description=Choice of soil thermal conductivity model -sort-key=Panel-E05 -url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::soilhc_method -value-titles=Cox et al (1999),Simplified Johansen (1975),Chadburn et al (2015) -values=1,2,3 -widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget - -[namelist:jules_soil=zsmc] -compulsory=true -description=Depth of layer over which soil moisture diagnostic is averaged (m) -range=0.01: -sort-key=Panel-E08 -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::zsmc - -[namelist:jules_soil=zst] -compulsory=true -description=Depth of layer over which soil temperature diagnostic is averaged (m) -range=0.01: -sort-key=Panel-E09 -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::zst - -[namelist:jules_soil_biogeochem] -compulsory=true -ns=namelist/JULES Science Settings/jules_soil_biogeochem -sort-key=07 -title=Soil biogeochemistry options -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#namelist-JULES_SOIL_BIOGEOCHEM - -[namelist:jules_soil_biogeochem=alpha_ch4] -compulsory=true -description=Ratio between maintenance and growth respiration rates for methanogens -range=0.00001:0.1 -sort-key=8i -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::alpha_ch4 - -[namelist:jules_soil_biogeochem=bio_hum_cn] -compulsory=true -description=Bio and Hum Soil Carbon pools CN ratio -range=1:301 -sort-key=g -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::bio_hum_cn - -[namelist:jules_soil_biogeochem=ch4_cpow] -compulsory=true -description=Power of soil carbon used for anaerobic decomposition (default 1, could be 2/3 for organic soils) -range=0.01:5 -sort-key=r -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::ch4_cpow - -[namelist:jules_soil_biogeochem=ch4_substrate] -compulsory=true -description=Choose substrate for interactive methane -sort-key=o -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::ch4_substrate -value-titles=Soil carbon,NPP,Soil respiration -values=1,2,3 -widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget - -[namelist:jules_soil_biogeochem=const_ch4_cs] -compulsory=true -description=Scale factor for soil carbon substrate CH4 emissions -range=1.0e-14:1.0e-6 -sort-key=2c -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::const_ch4_cs - -[namelist:jules_soil_biogeochem=const_ch4_npp] -compulsory=true -description=Scale factor for NPP substrate CH4 emissions -range=1.0e-5:0.01 -sort-key=2d -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::const_ch4_npp - -[namelist:jules_soil_biogeochem=const_ch4_resps] -compulsory=true -description=Scale factor for soil respiration substrate CH4 emissions -range=1.0e-5:0.01 -sort-key=2e -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::const_ch4_resps - -[namelist:jules_soil_biogeochem=cs_decomp_soil_moist_func] -compulsory=true -description=Switch for moisture function for soil decomposition -sort-key=m1 -trigger=namelist:jules_soil_biogeochem=fsthsat_cs_decomp_opt1: 1; -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::cs_decomp_soil_moist_func -value-titles=Clark (2011) function, Modified Chadburn (2022) function -values=0,1 -widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget - -[namelist:jules_soil_biogeochem=cue_ch4] -compulsory=true -description=Carbon use efficiency of methanogenic growth -range=0.001:0.5 -sort-key=8f -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::cue_ch4 - -[namelist:jules_soil_biogeochem=diff_n_pft] -compulsory=true -description=Inorganic N diffusion in soil (360 days-1) -range=0.1:1500 -sort-key=b2 -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::diff_n_pft - -[namelist:jules_soil_biogeochem=ev_ch4] -compulsory=true -description=Timescale over which methanogenic traits adapt to temperature change (yr) -range=0.1:10.0 -sort-key=8j -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::ev_ch4 - -[namelist:jules_soil_biogeochem=frz_ch4] -compulsory=true -description=Factor to reduce CH4 substrate production when soil is sufficiently frozen (only in microbial scheme) -range=0:1 -sort-key=8h -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::frz_ch4 - -[namelist:jules_soil_biogeochem=fsthsat_cs_decomp_opt1] -compulsory=true -description=Soil decomposition factor when soil is saturated (proportion of maximum) -range=0.0:1.0 -sort-key=m1a -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::fsthsat_cs_decomp_opt1 - -[namelist:jules_soil_biogeochem=heat_of_respiration] -compulsory=true -description=The heat released during respiration (J/kg C) -range=0: -sort-key=c1a -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::heat_of_respiration - -[namelist:jules_soil_biogeochem=k2_ch4] -compulsory=true -description=Scale factor for methanogenic respiration rate (hr-1) -range=0.001:0.5 -sort-key=8b -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::k2_ch4 - -[namelist:jules_soil_biogeochem=kaps] -compulsory=true -description=Specific soil respiration rate at 25 degC and optimum soil moisture (s-1) for 1-pool model -range=1.0e-12:1.0e-4 -sort-key=e -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::kaps - -[namelist:jules_soil_biogeochem=kaps_4pool] -compulsory=true -description=Specific soil respiration rates for the four pools of the 4-pool model (s-1) -length=4 -range=1.0e-12:1.0e-4 -sort-key=f -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::kaps_4pool - -[namelist:jules_soil_biogeochem=kd_ch4] -compulsory=true -description=Scale factor for methanogenic death/turnover rate (hr-1) -range=0.000001:0.01 -sort-key=8c -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::kd_ch4 - -[namelist:jules_soil_biogeochem=l_bgc_heat] -compulsory=true -description=Switch for release of biogeochemical heat into the soil. - =Not available to the UM. -fail-if=this == '.true.' and namelist:jules_model_environment=l_jules_parent == 1; #Biogenic heating scheme is not available to the UM -sort-key=c1 -trigger=namelist:jules_soil_biogeochem=heat_of_respiration: .true.; -type=logical -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::l_bgc_heat - -[namelist:jules_soil_biogeochem=l_ch4_interactive] -compulsory=true -description=Switch on interactive methane -fail-if=this == '.true.' and namelist:jules_soil_biogeochem=l_ch4_tlayered == '.false.' -sort-key=n -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::l_ch4_interactive -value-titles=Methane flux updates soil C, Methane flux does not update soil C -values=.true.,.false. -widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget - -[namelist:jules_soil_biogeochem=l_ch4_microbe] -compulsory=true -description=Use microbial methane model - =NOT AVAILABLE TO UM -sort-key=8a -trigger=namelist:jules_soil_biogeochem=k2_ch4: .true.; - =namelist:jules_soil_biogeochem=kd_ch4: .true.; - =namelist:jules_soil_biogeochem=rho_ch4: .true.; - =namelist:jules_soil_biogeochem=q10_mic_ch4: .true.; - =namelist:jules_soil_biogeochem=cue_ch4: .true.; - =namelist:jules_soil_biogeochem=mu_ch4: .true.; - =namelist:jules_soil_biogeochem=frz_ch4: .true.; - =namelist:jules_soil_biogeochem=alpha_ch4: .true.; - =namelist:jules_soil_biogeochem=ev_ch4: .true.; - =namelist:jules_soil_biogeochem=q10_ev_ch4: .true.; -type=logical -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::l_ch4_microbe -warn-if=this== '.true.' and namelist:jules_soil_biogeochem=ch4_substrate != 1 # microbial model only tuned for ch4_substrate=1 - -[namelist:jules_soil_biogeochem=l_ch4_tlayered] -compulsory=true -description=Calculate methane emissions from layered soil temperature (vs 1m average) -sort-key=p -trigger=namelist:jules_soil_biogeochem=tau_ch4: .true.; -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::l_ch4_tlayered -value-titles=Use layered soil temperature, Use depth-averaged soil temperature -values=.true.,.false. -widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget - -[namelist:jules_soil_biogeochem=l_label_frac_cs] -compulsory=true -description=Label and trace a fraction of soil carbon - =NOT AVAILABLE TO UM -sort-key=b1 -type=logical -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::l_label_frac_cs - -[namelist:jules_soil_biogeochem=l_layeredc] -compulsory=true -description=Use layered soil carbon model -fail-if=this == '.true.' and namelist:jules_soil_biogeochem=soil_bgc_model == 3 -sort-key=b -trigger=namelist:jules_soil_biogeochem=tau_resp: .true.; - =namelist:jules_soil_biogeochem=l_label_frac_cs: .true.; - =namelist:jules_soil_biogeochem=diff_n_pft: .true.; - =namelist:jules_soil_biogeochem=z_burn_max: .true.; -type=logical -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::l_layeredc - -[namelist:jules_soil_biogeochem=l_q10] -compulsory=true -description=Choose soil decomposition dependence on temperature -sort-key=c -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::l_q10 -value-titles=Q10 temperature function,Clark et al. (2011) temperature function -values=.true.,.false. -warn-if=this == '.false.' and namelist:jules_soil_biogeochem=l_bgc_heat == '.true.' -widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget - -[namelist:jules_soil_biogeochem=l_soil_resp_lev2] -compulsory=true -description=Soil respiration calculated using temperature and moisture from layer 2 -sort-key=m -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::l_soil_resp_lev2 -value-titles=Use 2nd soil layer + total moisture content for respiration, Use top soil layer + unfrozen moisture content for respiration -values=.true.,.false. -widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget - -[namelist:jules_soil_biogeochem=mu_ch4] -compulsory=true -description=Threshold growth rate below which methanogens die (hr-1) -range=0.000001:0.01 -sort-key=8g -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::mu_ch4 - -[namelist:jules_soil_biogeochem=n_inorg_turnover] -compulsory=true -description=Inorganic Nitrogren Turnover rate (360 days-1) -range=0.01:100 -sort-key=i -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::n_inorg_turnover - -[namelist:jules_soil_biogeochem=q10_ch4_cs] -compulsory=true -description=Q10 factor for soil carbon substrate CH4 emissions -range=0.1:10.0 -sort-key=2f -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::q10_ch4_cs - -[namelist:jules_soil_biogeochem=q10_ch4_npp] -compulsory=true -description=Q10 factor for NPP substrate CH4 emissions -range=0.1:10.0 -sort-key=2g -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::q10_ch4_npp - -[namelist:jules_soil_biogeochem=q10_ch4_resps] -compulsory=true -description=Q10 factor for soil respiration substrate CH4 emissions -range=0.1:10.0 -sort-key=2h -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::q10_ch4_resps - -[namelist:jules_soil_biogeochem=q10_ev_ch4] -compulsory=true -description=Q10 for temperature response of methanogenic traits under adaptation -range=0.1:10.0 -sort-key=8k -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::q10_ev_ch4 - -[namelist:jules_soil_biogeochem=q10_mic_ch4] -compulsory=true -description=Q10 factor for methanogens -range=0.1:10.0 -sort-key=8e -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::q10_mic_ch4 - -[namelist:jules_soil_biogeochem=q10_soil] -compulsory=true -description=Q10 factor for soil respiration -range=0.1:10.0 -sort-key=d -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::q10_soil - -[namelist:jules_soil_biogeochem=rho_ch4] -compulsory=true -description=Factor in substrate limitation function (related to half saturation of substrate for methanogenic respiration) -range=1.0:1000.0 -sort-key=8d -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::rho_ch4 - -[namelist:jules_soil_biogeochem=soil_bgc_model] -compulsory=true -description=Choice of soil biogeochemistry model -fail-if=this == 1 and namelist:jules_vegetation=l_triffid == '.true.'; # Can't use 1-pool with TRIFFID - =this == 2 and namelist:jules_vegetation=l_triffid != '.true.'; # Can't use 4-pool soil C without TRIFFID - =this == 3 and namelist:jules_vegetation=l_triffid != '.true.'; # Can't use ECOSSE without TRIFFID -sort-key=a -trigger=namelist:jules_soil_biogeochem=l_q10: 1, 2; - =namelist:jules_soil_biogeochem=q10_soil: 1, 2, 3; - =namelist:jules_soil_biogeochem=l_soil_resp_lev2: 1, 2; - =namelist:jules_soil_biogeochem=cs_decomp_soil_moist_func: 1, 2; - =namelist:jules_soil_biogeochem=kaps: 1; - =namelist:jules_soil_biogeochem=kaps_4pool: 2; - =namelist:jules_soil_biogeochem=sorp: 2; - =namelist:jules_soil_biogeochem=n_inorg_turnover: 2; - =namelist:jules_soil_biogeochem=bio_hum_cn: 2; - =namelist:jules_soil_biogeochem=diff_n_pft: 2; - =namelist:jules_soil_biogeochem=tau_lit: 2, 3; - =namelist:jules_soil_biogeochem=tau_resp: 2; - =namelist:jules_soil_ecosse=l_soil_n: 3; - =namelist:jules_soil_ecosse=depo_nit_frac: 3; - =namelist:jules_soil_ecosse=l_match_layers: 3; - =namelist:jules_soil_ecosse=dt_soilc: 3; - =namelist:jules_soil_ecosse=dz_soilc_io: 3; - =namelist:jules_soil_ecosse=plant_input_profile: 3; - =namelist:jules_soil_ecosse=pi_sfc_depth: 3; - =namelist:jules_soil_ecosse=pi_sfc_frac: 3; - =namelist:jules_soil_ecosse=bacteria_min_frac: 3; - =namelist:jules_soil_ecosse=bacteria_max_frac: 3; - =namelist:jules_soil_ecosse=bacteria_min_frac_ph: 3; - =namelist:jules_soil_ecosse=bacteria_max_frac_ph: 3; - =namelist:jules_soil_ecosse=cn_bacteria: 3; - =namelist:jules_soil_ecosse=cn_fungi: 3; - =namelist:jules_soil_ecosse=decomp_rate: 3; - =namelist:jules_soil_ecosse=decomp_wrate_min_smith: 3; - =namelist:jules_soil_ecosse=decomp_wrate_min_clark: 3; - =namelist:jules_soil_ecosse=decomp_temp_coeff_smith: 3; - =namelist:jules_soil_ecosse=decomp_ph_min: 3; - =namelist:jules_soil_ecosse=decomp_ph_max: 3; - =namelist:jules_soil_ecosse=decomp_ph_rate_min: 3; - =namelist:jules_soil_ecosse=depth_nitrif: 3; - =namelist:jules_soil_ecosse=nitrif_frac_n2o_fc: 3; - =namelist:jules_soil_ecosse=nitrif_frac_gas: 3; - =namelist:jules_soil_ecosse=nitrif_frac_no: 3; - =namelist:jules_soil_ecosse=nitrif_max_factor: 3; - =namelist:jules_soil_ecosse=nitrif_rate: 3; - =namelist:jules_soil_ecosse=nitrif_wrate_min: 3; - =namelist:jules_soil_ecosse=denit50: 3; - =namelist:jules_soil_ecosse=denit_frac_n2_fc: 3; - =namelist:jules_soil_ecosse=denit_nitrate_equal: 3; - =namelist:jules_soil_ecosse=denit_water_coeff: 3; - =namelist:jules_soil_ecosse=denit_bio_factor: 3; - =namelist:jules_soil_ecosse=amm_leach_min: 3; - =namelist:jules_soil_ecosse=n_inorg_max_conc: 3; - =namelist:jules_soil_ecosse=l_driver_ave: 3; - =namelist:jules_soil_ecosse=l_decomp_slow: 3; - =namelist:jules_soil_ecosse=temp_modifier: 3; - =namelist:jules_soil_ecosse=water_modifier: 3; - =namelist:jules_soil_ecosse=dim_cslayer: 3; -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::soil_bgc_model -value-titles=Single pool model,4-pool model,ECOSSE -values=1,2,3 -widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget - -[namelist:jules_soil_biogeochem=sorp] -compulsory=true -description=Soil leaching N Retention factor -range=0.01:100.0 -sort-key=h -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::sorp - -[namelist:jules_soil_biogeochem=t0_ch4] -compulsory=true -description=Reference temperature for Q10 function CH4 emissions -range=250:320 -sort-key=2b -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::t0_ch4 - -[namelist:jules_soil_biogeochem=tau_ch4] -compulsory=true -description=Decay factor with depth representing methane oxidation -range=0.01:100.0 -sort-key=q -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::tau_ch4 - -[namelist:jules_soil_biogeochem=tau_lit] -compulsory=true -description=Exponential decay constant for reduction of litter inputs with depth -range=0.01:100.0 -sort-key=b2 -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::tau_lit - -[namelist:jules_soil_biogeochem=tau_resp] -compulsory=true -description=Exponential decay constant for reduction of respiration with depth -range=0.01:100.0 -sort-key=b2 -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::tau_resp - -[namelist:jules_soil_biogeochem=z_burn_max] -compulsory=true -description=Maximum burn depth for soil - soil carbon is burned above this level -range=0.0:10.0 -sort-key=b2 -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_biogeochem.nml.html#JULES_SOIL_BIOGEOCHEM::z_burn_max - -[namelist:jules_soil_ecosse] -compulsory=true -ns=namelist/JULES Science Settings/jules_soil_ecosse -sort-key=07 -title=Soil ECOSSE model options - -[namelist:jules_soil_ecosse=amm_leach_min] -compulsory=true -description=Minimum allowed amount of N in NH4 after leaching (kg m-3) -range=0: -type=real - -[namelist:jules_soil_ecosse=bacteria_max_frac] -compulsory=true -description=Maximum fraction of decomposer community that are bacteria -range=0:1 -type=real - -[namelist:jules_soil_ecosse=bacteria_max_frac_ph] -compulsory=true -description=Soil pH at or above which the fraction of bacteria is at a maximum -range=0:14 -type=real - -[namelist:jules_soil_ecosse=bacteria_min_frac] -compulsory=true -description=Minimum fraction of decomposer community that are bacteria -range=0:1 -type=real - -[namelist:jules_soil_ecosse=bacteria_min_frac_ph] -compulsory=true -description=Soil pH at or below which the fraction of bacteria is at a minimum -range=0:14 -type=real - -[namelist:jules_soil_ecosse=cn_bacteria] -compulsory=true -description=C:N ratio of soil bacteria -range=0.1: -type=real - -[namelist:jules_soil_ecosse=cn_fungi] -compulsory=true -description=C:N ratio of soil fungi -range=0.1: -type=real - -[namelist:jules_soil_ecosse=decomp_ph_max] -compulsory=true -description=pH above which rate of decomposition is maximum -range=0:14 -type=real - -[namelist:jules_soil_ecosse=decomp_ph_min] -compulsory=true -description=pH below which rate of decomposition is minimum -range=0:14 -type=real - -[namelist:jules_soil_ecosse=decomp_ph_rate_min] -compulsory=true -description=Minimum allowed value of pH rate modifier for decomposition -range=0:1 -type=real - -[namelist:jules_soil_ecosse=decomp_rate] -compulsory=true -description=Rate constants for decomposition of each pool (s-1) -length=4 -type=real - -[namelist:jules_soil_ecosse=decomp_temp_coeff_smith] -compulsory=true -description=Constants in Smith et al. (2010) soil C decomposition rate temperature modifier -length=3 -type=real - -[namelist:jules_soil_ecosse=decomp_wrate_min_clark] -compulsory=true -description=Minimum allowed value of the JULES form for water rate modifier for decomposition -range=0:1 -type=real - -[namelist:jules_soil_ecosse=decomp_wrate_min_smith] -compulsory=true -description=Minimum allowed value of the Smith et al. (2010) water rate modifier for decomposition -range=0:1 -type=real - -[namelist:jules_soil_ecosse=denit50] -compulsory=true -description=Amount of nitrate at which denitrification rate is 50% of the potential rate (kg m-3) -range=0: -type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::snowunloadfact -[namelist:jules_soil_ecosse=denit_bio_factor] +[namelist:jules_snow=unload_rate_cnst] compulsory=true -description=Factor in denitrification calculation to convert C flux into a representation of biological activity -range=0: +description=Constant term in background unloading rate of snow on canopies +fail-if=len(this) != namelist:jules_surface_types=npft; # A value must be given for each PFT +length=: +ns=namelist/JULES Science Settings/jules_snow/Other parameters +sort-key=Panel-D13 type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::unload_rate_cnst -[namelist:jules_soil_ecosse=denit_frac_n2_fc] +#[namelist:jules_soil] has moved to jules-shared/jules-soil +[namelist:jules_soil=confrac] compulsory=true -description=Fraction of denitrified N that becomes N2 when soil moisture is at field capacity -range=0:1 +description=Fraction of the gridbox assumed to be covered by convective precipitation +range=0.0:1.0 +sort-key=Panel-E10 type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::confrac -[namelist:jules_soil_ecosse=denit_nitrate_equal] +[namelist:jules_soil=cs_min] compulsory=true -description=Amount of N in soil nitrate at which denitrified N is released as equal amounts of N2 and N2O (kg m-3) -range=0: +description=Minimum allowed soil carbon (kg m-2) +range=0.000001: +sort-key=Panel-E07 type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::cs_min -[namelist:jules_soil_ecosse=denit_water_coeff] +[namelist:jules_soil=dzdeep] compulsory=true -description=Fitted constants describing water modifier for denitrification -length=3 +description=Thickness of bedrock (m) +range=0.01: +sort-key=Panel-E06d type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::dzdeep -[namelist:jules_soil_ecosse=depo_nit_frac] +[namelist:jules_soil=dzsoil_elev] compulsory=true -description=Fraction of total N deposition that is added to soil nitrate -range=0:1 +description=Depth (m) of tiled bedrock subsurfaces under elevated tiles. +fail-if=this <= 0 ; # Must have positive value +range=0.01: +sort-key=Panel-E12 type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::dzsoil_elev -[namelist:jules_soil_ecosse=depth_nitrif] +[namelist:jules_soil=dzsoil_io] compulsory=true -description=Greatest depth at which nitrification and denitrification are allowed (m) -range=0: +description=Soil layer depths (m), starting with the uppermost layer +fail-if=len(this) != namelist:jules_soil=sm_levels; # Must have a value for each soil level +length=: +sort-key=Panel-E11 type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::dzsoil_io -[namelist:jules_soil_ecosse=dim_cslayer] -compulsory=true -description=Number of soil carbon layers -range=1: -type=integer - -[namelist:jules_soil_ecosse=dt_soilc] +[namelist:jules_soil=hcapdeep] compulsory=true -description=Timestep length for soil biogeochemistry model (s) +description=Heat capacity of bedrock (J K-1 m-3) +range=100000:8000000 +sort-key=Panel-E06b type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::hcapdeep -[namelist:jules_soil_ecosse=dz_soilc_io] +[namelist:jules_soil=hcondeep] compulsory=true -description=Thicknesses of the soil biogeochemistry layers (m) -fail-if=len(this) != dim_cslayer; # Must have a value for each layer -length=: +description=Thermal conductivity of bedrock (W m-2 K-1) +range=0.4:12.0 +sort-key=Panel-E06c type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::hcondeep -[namelist:jules_soil_ecosse=l_decomp_slow] +[namelist:jules_soil=l_bedrock] compulsory=true -description=Switch to slow decomposition when N is limiting -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_ecosse.nml.html#JULES_SOIL_ECOSSE::l_decomp_slow -value-titles=Decomposition slowed, Decomposition less efficient -values=.true.,.false. -widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget +description=Include bedrock below soil column with thermal diffusion; does not include hydrology + =NOT AVAILABLE TO UM +sort-key=Panel-E06 +trigger=namelist:jules_soil=ns_deep: .true.; + = namelist:jules_soil=hcapdeep: .true.; + = namelist:jules_soil=hcondeep: .true.; + = namelist:jules_soil=dzdeep: .true.; +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::l_bedrock -[namelist:jules_soil_ecosse=l_driver_ave] -compulsory=true -description=Switch for time-averaging of ECOSSE driving variables -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_ecosse.nml.html#JULES_SOIL_ECOSSE::l_driver_ave -value-titles=Time average, Instantaneous values -values=.true.,.false. -widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget +[namelist:jules_soil=l_broadcast_ancils] +description=Switch to broadcast non-soil tiled ancillary data to all soil tiles (if read from ancil files) +sort-key=Panel-E14a +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::l_broadcast_ancils -[namelist:jules_soil_ecosse=l_match_layers] +[namelist:jules_soil=l_holdwater] compulsory=true -description=Switch to match soil C and N layers to soil moisture layers -trigger=namelist:jules_soil_ecosse=dim_cslayer: .false.; - =namelist:jules_soil_ecosse=dz_soilc_io: .false.; -url=https://metoffice.github.io/jules/latest/namelists/jules_soil_ecosse.nml.html#JULES_SOIL_ECOSSE::l_match_layers -value-titles=Match to soil moisture layers, Specify layers +description=Stops water being pushed out of the soil column when a single layer is supersaturated +sort-key=Panel-E13 +url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::l_holdwater +value-titles=Bug fixed,Original values=.true.,.false. widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget -[namelist:jules_soil_ecosse=l_soil_n] -compulsory=true -description=Switch for a prognostic model of soil Nitrogen -trigger=namelist:jules_soil_ecosse=depo_nit_frac: .true.; - =namelist:jules_soil_ecosse=l_decomp_slow: .true.; - =namelist:jules_soil_ecosse=bacteria_min_frac: .true.; - =namelist:jules_soil_ecosse=bacteria_max_frac: .true.; - =namelist:jules_soil_ecosse=bacteria_min_frac_ph: .true.; - =namelist:jules_soil_ecosse=bacteria_max_frac_ph: .true.; - =namelist:jules_soil_ecosse=cn_bacteria: .true.; - =namelist:jules_soil_ecosse=cn_fungi: .true.; - =namelist:jules_soil_ecosse=depth_nitrif: .true.; - =namelist:jules_soil_ecosse=nitrif_frac_n2o_fc: .true.; - =namelist:jules_soil_ecosse=nitrif_rate: .true.; - =namelist:jules_soil_ecosse=nitrif_frac_gas: .true.; - =namelist:jules_soil_ecosse=nitrif_frac_no: .true.; - =namelist:jules_soil_ecosse=nitrif_max_factor: .true.; - =namelist:jules_soil_ecosse=nitrif_wrate_min: .true.; - =namelist:jules_soil_ecosse=denit50: .true.; - =namelist:jules_soil_ecosse=denit_frac_n2_fc: .true.; - =namelist:jules_soil_ecosse=denit_nitrate_equal: .true.; - =namelist:jules_soil_ecosse=denit_water_coeff: .true.; - =namelist:jules_soil_ecosse=denit_bio_factor: .true.; - =namelist:jules_soil_ecosse=amm_leach_min: .true.; - =namelist:jules_soil_ecosse=n_inorg_max_conc: .true.; -type=logical - -[namelist:jules_soil_ecosse=n_inorg_max_conc] -compulsory=true -description=Maximum-allowed concentration of inorganic N in a layer (kg m-3) -type=real - -[namelist:jules_soil_ecosse=nitrif_frac_gas] -compulsory=true -description=Fraction of nitrification lost as gas through full nitrification -range=0:1 -type=real - -[namelist:jules_soil_ecosse=nitrif_frac_n2o_fc] -compulsory=true -description=Fraction of nitrification lost as N2O by partial nitrification at field capacity -range=0:1 -type=real - -[namelist:jules_soil_ecosse=nitrif_frac_no] +[namelist:jules_soil=l_tile_soil] compulsory=true -description=Fraction of nitrification gas loss through full nitrification that is NO -range=0:1 -type=real +description=Switch to set the number of soil tiles to equal the number of surface tiles +fail-if=this == '.true.' and namelist:jules_model_environment=l_jules_parent == 1; # Not available in the UM +sort-key=Panel-E14 +trigger=namelist:jules_soil=l_broadcast_ancils: .true.; + =namelist:jules_initial=l_broadcast_soilt: .true. +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::l_tile_soil -[namelist:jules_soil_ecosse=nitrif_max_factor] +[namelist:jules_soil=ns_deep] compulsory=true -description=Shape factor in rate modifier for nitrification (kg m-3) -range=0:1 -type=real +description=Number of bedrock layers +range=1: +sort-key=Panel-E06a +type=integer +url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::ns_deep -[namelist:jules_soil_ecosse=nitrif_rate] +[namelist:jules_soil=sm_levels] compulsory=true -description=Rate constant for nitrification (s-1) -range=0: -type=real +description=Number of soil layers +range=1: +sort-key=Panel-E01 +type=integer +url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::sm_levels -[namelist:jules_soil_ecosse=nitrif_wrate_min] +[namelist:jules_soil=soilhc_method] compulsory=true -description=Minimum allowed value of water rate modifier for nitrification when Smith et al., 2010 form is used -range=0: -type=real +description=Choice of soil thermal conductivity model +sort-key=Panel-E05 +url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::soilhc_method +value-titles=Cox et al (1999),Simplified Johansen (1975),Chadburn et al (2015) +values=1,2,3 +widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget -[namelist:jules_soil_ecosse=pi_sfc_depth] +[namelist:jules_soil=zsmc] compulsory=true -description=Depth of soil over which fraction pi_sfc_frac of plant litterfall is added (m). +description=Depth of layer over which soil moisture diagnostic is averaged (m) +range=0.01: +sort-key=Panel-E08 type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::zsmc -[namelist:jules_soil_ecosse=pi_sfc_frac] +[namelist:jules_soil=zst] compulsory=true -description=Fraction of plant litterfall that is added to the surface soil layer (of depth pi_sfc_depth). -range=0:1 +description=Depth of layer over which soil temperature diagnostic is averaged (m) +range=0.01: +sort-key=Panel-E09 type=real - -[namelist:jules_soil_ecosse=plant_input_profile] -compulsory=true -description=Switch for distribution of litterfall inputs to the soil. -trigger=namelist:jules_soil_ecosse=pi_sfc_depth: 1; - =namelist:jules_soil_ecosse=pi_sfc_frac: 1; -value-titles=RootProfile,Exponential -values=1,2 -widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget - -[namelist:jules_soil_ecosse=temp_modifier] -compulsory=true -description=Switch for form of temperature rate modifier for decomposition -value-titles=Q10,Smith -values=1,2 -widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget - -[namelist:jules_soil_ecosse=water_modifier] -compulsory=true -description=Switch for form of water rate modifier for decomposition -value-titles=Clark,Smith -values=1,2 -widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget +url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::zst [namelist:jules_soil_props] compulsory=true @@ -5921,114 +4464,6 @@ sort-key=Panel-A0e type=integer url=https://metoffice.github.io/jules/latest/namelists/jules_surface_types.nml.html#JULES_SURFACE_TYPES::usr_type -[namelist:jules_temp_fixes] -compulsory=true -description=To assist managing science fixes across JULES versions -ns=namelist/JULES Science Settings/jules_temp_fixes -sort-key=00 -title=Short term logicals -url=https://metoffice.github.io/jules/latest/namelists/science_fixes.nml.html#namelist-JULES_TEMP_SWITCHES - -[namelist:jules_temp_fixes=ctile_orog_fix] -compulsory=true -description=Fix surface exchange in coastally tiled grid-boxes -fail-if=(this == '0' or this == '1') and namelist:jules_model_environment=l_jules_parent == 0; # This should be 2 in JULES standalone. -url=https://metoffice.github.io/jules/latest/namelists/science_fixes.nml.html#JULES_TEMP_FIXES::ctile_orog_fix -value-titles=No fix,Correct sea adjust land,Correct sea only -values=0,1,2 - -[namelist:jules_temp_fixes=l_accurate_rho] -compulsory=true -description=Improve the accuracy of air density in surface fluxes -type=logical -url=https://metoffice.github.io/jules/latest/namelists/science_fixes.nml.html#JULES_TEMP_FIXES::l_accurate_rho - -[namelist:jules_temp_fixes=l_dtcanfix] -compulsory=true -description=Correct the evolution of the skin temperature in the implicit solver -fail-if=this == '.false.' and namelist:jules_model_environment=l_jules_parent == 0; # This should be .true. in JULES standalone. -type=logical -url=https://metoffice.github.io/jules/latest/namelists/science_fixes.nml.html#JULES_TEMP_FIXES::l_dtcanfix - -[namelist:jules_temp_fixes=l_fix_alb_ice_thick] -compulsory=true -description=Fix bug in ice thickness used for sea ice albedo calculation. -fail-if=this == '.false.' and namelist:jules_model_environment=l_jules_parent == 0; # This should be .true. in JULES standalone. -type=logical -url=https://metoffice.github.io/jules/latest/namelists/science_fixes.nml.html#JULES_TEMP_FIXES::l_fix_alb_ice_thick - -[namelist:jules_temp_fixes=l_fix_albsnow_ts] -compulsory=true -description=Fix bug in the two-stream calculation of the albedo of snow. -fail-if=this == '.false.' and namelist:jules_model_environment=l_jules_parent == 0; # This should be .true. in JULES standalone. -type=logical -url=https://metoffice.github.io/jules/latest/namelists/science_fixes.nml.html#JULES_TEMP_FIXES::l_fix_albsnow_ts - -[namelist:jules_temp_fixes=l_fix_drydep_so2_water] -compulsory=true -description=Use correct surface resistance of water when calculating the dry deposition of SO2 -type=logical -url=https://metoffice.github.io/jules/latest/namelists/science_fixes.nml.html#JULES_TEMP_FIXES::l_fix_drydep_so2_water - -[namelist:jules_temp_fixes=l_fix_improve_drydep] -compulsory=true -description=Fix dry deposition velocities -type=logical -url=https://metoffice.github.io/jules/latest/namelists/science_fixes.nml.html#JULES_TEMP_FIXES::l_fix_improve_drydep - -[namelist:jules_temp_fixes=l_fix_lake_ice_temperatures] -compulsory=true -description=Fix evolution of lake ice temperatures -help=Allow sea ice temperatures in lakes to evolve over time for atmosphere-ocean coupled - =models when the lake is defined as a sea point but is not coupled to an ocean model. -type=logical -url=https://metoffice.github.io/jules/latest/namelists/science_fixes.nml.html#JULES_TEMP_FIXES::l_fix_lake_ice_temperatures - -[namelist:jules_temp_fixes=l_fix_moruses_roof_rad_coupling] -compulsory=true -description=Correction to the roof radiative coupling of MORUSES -type=logical -url=https://metoffice.github.io/jules/latest/namelists/science_fixes.nml.html#JULES_TEMP_FIXES::l_fix_moruses_roof_rad_coupling - -[namelist:jules_temp_fixes=l_fix_neg_snow] -compulsory=true -description=Activate corrections to avoid the generation of negative amounts of snow. -fail-if=this == '.false.' and namelist:jules_model_environment=l_jules_parent == 0; # This should be .true. in JULES standalone. -type=logical -url=https://metoffice.github.io/jules/latest/namelists/science_fixes.nml.html#JULES_TEMP_FIXES::l_fix_neg_snow - -[namelist:jules_temp_fixes=l_fix_osa_chloro] -compulsory=true -description=Correct the units of chlorophyll in the ocean surface albedo -type=logical -url=https://metoffice.github.io/jules/latest/namelists/science_fixes.nml.html#JULES_TEMP_FIXES::l_fix_osa_chloro - -[namelist:jules_temp_fixes=l_fix_snow_frac] -compulsory=true -description=Correction to prevent persistent small snow amounts when using the frac_snow_subl_melt=1 option -type=logical -url=https://metoffice.github.io/jules/latest/namelists/science_fixes.nml.html#JULES_TEMP_FIXES::l_fix_snow_frac - -[namelist:jules_temp_fixes=l_fix_ukca_h2dd_x] -compulsory=true -description=Fix for UKCA deposition of H2. -type=logical -url=https://metoffice.github.io/jules/latest/namelists/science_fixes.nml.html#JULES_TEMP_FIXES::l_fix_h2dd_x - -[namelist:jules_temp_fixes=l_fix_ustar_dust] -compulsory=true -description=Fix surface exchange for dust deposition -fail-if=this == '.false.' and namelist:jules_model_environment=l_jules_parent == 0; # This should be .true. in JULES standalone. -type=logical -url=https://metoffice.github.io/jules/latest/namelists/science_fixes.nml.html#JULES_TEMP_FIXES::l_fix_ustar_dust - -[namelist:jules_temp_fixes=l_fix_wind_snow] -compulsory=true -description=Fix to ensure wind speed is provided for snow unloading from vegetation -fail-if=this == '.false.' and namelist:jules_model_environment=l_jules_parent == 0; # This should be .true. in JULES standalone. -type=logical -url=https://metoffice.github.io/jules/latest/namelists/science_fixes.nml.html#JULES_TEMP_FIXES::l_fix_wind_snow - [namelist:jules_time] compulsory=true ns=namelist/Timestepping information @@ -6412,12 +4847,6 @@ values=1,2,3,4 warn-if=this == 3; # can_model = 3 is deprecated, with 4 preferred widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget -[namelist:jules_vegetation=can_rad_mod] -trigger=namelist:jules_vegetation=ilayers: 4,5,6; - =namelist:jules_pftparm=knl_io: 6; -values=1,4,5,6 -widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget - [namelist:jules_vegetation=cd_leaf] compulsory=true description=Leaf level drag coefficient @@ -6614,10 +5043,6 @@ sort-key=Panel-I18 type=logical url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::l_scale_resp_pm -[namelist:jules_vegetation=l_spec_veg_z0] -trigger=namelist:jules_pftparm=dz0v_dh_io: .false.; - =namelist:jules_pftparm=z0v_io: .true.; - [namelist:jules_vegetation=l_stem_resp_fix] compulsory=true description=Switch for bug fix for stem respiration to use balanced LAI to @@ -6923,157 +5348,6 @@ sort-key=6 type=character url=https://metoffice.github.io/jules/latest/namelists/ancillaries.nml.html#JULES_VEGETATION_PROPS::var_name -[namelist:jules_water_resources] -compulsory=true -description=Configuration of water resource modelling -ns=namelist/JULES Science Settings/jules_water_resources -sort-key=15 -title=Water resources -url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#namelist-JULES_WATER_RESOURCES - -[namelist:jules_water_resources=l_prioritise] -compulsory=true -description=Switch to specify the priority of water demands -sort-key=a8 -trigger=namelist:jules_water_resources=priority: .true.; -type=logical -url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#JULES_WATER_RESOURCES::l_prioritise - -[namelist:jules_water_resources=l_water_domestic] -compulsory=true -description=Switch for modelling of water for domestic use -sort-key=a2 -trigger=namelist:jules_water_resources=rf_domestic: .true.; -type=logical -url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#JULES_WATER_RESOURCES::l_water_domestic - -[namelist:jules_water_resources=l_water_environment] -compulsory=true -description=Switch for modelling of water for environmental use -fail-if=this == '.true.'; # code is not yet complete -sort-key=a3 -type=logical -url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#JULES_WATER_RESOURCES::l_water_environment - -[namelist:jules_water_resources=l_water_industry] -compulsory=true -description=Switch for modelling of water for industrial use -sort-key=a4 -trigger=namelist:jules_water_resources=rf_industry: .true.; -type=logical -url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#JULES_WATER_RESOURCES::l_water_industry - -[namelist:jules_water_resources=l_water_irrigation] -compulsory=true -description=Switch for modelling of water for irrigation -fail-if=namelist:jules_irrig=l_irrig_limit == '.true.' and this == '.true.'; # l_irrig_limit must be F if l_water_irrigation=T -sort-key=a5 -type=logical -url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#JULES_WATER_RESOURCES::l_water_irrigation - -[namelist:jules_water_resources=l_water_livestock] -compulsory=true -description=Switch for modelling of water for livestock -sort-key=a6 -trigger=namelist:jules_water_resources=rf_livestock: .true.; -type=logical -url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#JULES_WATER_RESOURCES::l_water_livestock - -[namelist:jules_water_resources=l_water_resources] -compulsory=true -description=Switch for modelling of water resource modelling - =This must be .false. in the UM until further testing. -fail-if=this == '.true.' and namelist:jules_model_environment=l_jules_parent == 1; # Must be false in the UM. -sort-key=a1 -trigger=namelist:jules_water_resources=l_prioritise: .true.; - =namelist:jules_water_resources=l_water_domestic: .true.; - =namelist:jules_water_resources=l_water_environment: .true.; - =namelist:jules_water_resources=l_water_industry: .true.; - =namelist:jules_water_resources=l_water_irrigation: .true.; - =namelist:jules_water_resources=l_water_livestock: .true.; - =namelist:jules_water_resources=l_water_transfers: .true.; - =namelist:jules_water_resources=nr_gwater_model: .true.; - =namelist:jules_water_resources=nstep_water_res: .true.; - =namelist:jules_water_resources=partition_method: .true.; - =namelist:jules_water_resources_props: .true.; -type=logical -url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#JULES_WATER_RESOURCES::l_water_resources - -[namelist:jules_water_resources=l_water_transfers] -compulsory=true -description=Switch for modelling of water for water transfers -fail-if=this == '.true.'; # code is not yet complete -sort-key=a7 -type=logical -url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#JULES_WATER_RESOURCES::l_water_transfers - -[namelist:jules_water_resources=nr_gwater_model] -compulsory=true -description=Model for non-renewable groundwater -sort-key=b2 -url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#JULES_WATER_RESOURCES::nr_gwater_model -value-titles=None,Last resort,Mix -values=0,1,2 -widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget - -[namelist:jules_water_resources=nstep_water_res] -compulsory=true -description=Timestep length for water resource model (number of main model timesteps) -range=1: -sort-key=b1 -type=integer -url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#JULES_WATER_RESOURCES::nstep_water_res - -[namelist:jules_water_resources=partition_method] -compulsory=true -description=Method used to get the target fraction of demand to be met from surface water -sort-key=b6 -trigger=namelist:jules_water_resources=sfc_water_factor: 2; -url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#JULES_WATER_RESOURCES::partition_method -value-titles=None,Use ancillary file,Calculate from stores -values=0,1,2 -widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget - -[namelist:jules_water_resources=priority] -compulsory=true -description=Water sector names, in order of decreasing priority -length=: -sort-key=a9 -url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#JULES_WATER_RESOURCES::priority -values='dom','env','ind','irr','liv','tra' - -[namelist:jules_water_resources=rf_domestic] -compulsory=true -description=Fraction of water that is returned after abstraction for domestic use -range=0:1 -sort-key=b3 -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#JULES_WATER_RESOURCES::rf_domestic - -[namelist:jules_water_resources=rf_industry] -compulsory=true -description=Fraction of water that is returned after abstraction for industrial purposes -range=0:1 -sort-key=b4 -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#JULES_WATER_RESOURCES::rf_industry - -[namelist:jules_water_resources=rf_livestock] -compulsory=true -description=Fraction of water that is returned after abstraction for livestock -range=0:1 -sort-key=b5 -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#JULES_WATER_RESOURCES::rf_livestock - -[namelist:jules_water_resources=sfc_water_factor] -compulsory=true -description=Weight applied to surface water when calculating target fraction for surface water -range=0: -sort-key=b7 -type=real -url=https://metoffice.github.io/jules/latest/namelists/jules_water_resources.nml.html#JULES_WATER_RESOURCES::sfc_water_factor - [namelist:jules_water_resources_props] compulsory=true description=Configuration of spatially-varying water resource properties diff --git a/rose-meta/jules-standalone/versions.py b/rose-meta/jules-standalone/versions.py index 1d4c41a9..2c8342b2 100644 --- a/rose-meta/jules-standalone/versions.py +++ b/rose-meta/jules-standalone/versions.py @@ -45,15 +45,15 @@ from .version81_82 import * -class vnYY_txxxx(MacroUpgrade): +class vn82_t155(MacroUpgrade): """Upgrade macro from JULES by Author""" - BEFORE_TAG = "vnY.Y" - AFTER_TAG = "vnY.Y_txxxx" + BEFORE_TAG = "vn8.2" + AFTER_TAG = "vn8.2_t155" def upgrade(self, config, meta_config=None): """Upgrade a JULES runtime app configuration.""" - # Add settings + # Bump tag to pick up metadata changes return config, self.reports diff --git a/rose-meta/jules-um/HEAD/rose-meta.conf b/rose-meta/jules-um/HEAD/rose-meta.conf index 0f8fdd05..f7699547 100644 --- a/rose-meta/jules-um/HEAD/rose-meta.conf +++ b/rose-meta/jules-um/HEAD/rose-meta.conf @@ -5,20 +5,74 @@ # * Import statements from jules-shared. # * UM specific amendments to the imported metadata. # The majority of the metadata should be under rose-meta/jules-shared. -# Please see jules:wiki:SharingJULESmetadata +# +# This file is imported by um-atmos in the UM repository. +# +# Please see https://github.com/MetOffice/jules/wiki/Sharing-JULES-metadata ############################################################################### -import=jules-shared/jules-hydrology/HEAD +import=jules-shared/jules-deposition/HEAD + =jules-shared/jules-deposition-species/HEAD + =jules-shared/jules-deposition-species-specific/HEAD + =jules-shared/jules-hydrology/HEAD + =jules-shared/jules-irrig/HEAD =jules-shared/jules-model-environment/HEAD =jules-shared/jules-nvegparm/HEAD + =jules-shared/jules-overbank/HEAD =jules-shared/jules-pftparm/HEAD =jules-shared/jules-radiation/HEAD + =jules-shared/jules-red/HEAD + =jules-shared/jules-rivers/HEAD =jules-shared/jules-snow/HEAD =jules-shared/jules-soil/HEAD + =jules-shared/jules-soil-biogeochem/HEAD =jules-shared/jules-surface/HEAD =jules-shared/jules-surface-types/HEAD + =jules-shared/jules-temp-fixes/HEAD =jules-shared/jules-urban/HEAD =jules-shared/jules-vegetation/HEAD + =jules-shared/jules-water-resources/HEAD + +[namelist:jules_deposition=l_deposition] +fail-if=(this == '.true.' and namelist:jules_surface=l_aggregate == ".true.") ; # Deposition does not work with aggregated tile + =(this == '.true.' and namelist:run_ukca=l_ukca_intdd == '.false.') ; # UKCA needs to be available and used with interactive dry deposition + +[namelist:jules_deposition=l_ukca_ddep_lev1] +fail-if=( this != namelist:run_ukca=l_ukca_ddep_lev1 ) ; # For UM_JULES applications, code uses setting of equivalent deposition switch in run_ukca namelist + +[namelist:jules_deposition=l_ukca_ddepo3_ocean] +fail-if=( this == '.true.' and namelist:jules_model_environment=l_jules_parent == 0 ) ; # Deposition switch not available in JULES standalone as requires >75% open water fraction + =( this != namelist:run_ukca=l_ukca_ddepo3_ocean ) ; # For UM_JULES applications, code uses setting of equivalent deposition switch in run_ukca namelist + +[namelist:jules_deposition=l_ukca_dry_dep_so2wet] +fail-if=( this == '.true.' and namelist:jules_model_environment=l_jules_parent == 0 ) ; # Deposition switch not fully implemented in JULES standalone + =( this != namelist:run_ukca=l_ukca_dry_dep_so2wet ) ; # For UM_JULES applications, code uses setting of equivalent deposition switch in run_ukca namelist + +[namelist:jules_deposition=l_ukca_emsdrvn_ch4] +fail-if=( this != namelist:run_ukca=l_ukca_emsdrvn_ch4 ) ; # For UM_JULES applications, code uses setting of equivalent deposition switch in run_ukca namelist + +[namelist:jules_elevate] +compulsory=true +ns=namelist/JULES Science Settings/jules_elevate +title=Tile elevations + +[namelist:jules_elevate=l_elev_absolute_height] +compulsory=true +description=Interpret tile elevations as absolute values above sea-level rather than relative to grid-box mean +fail-if=len(this) != namelist:jules_surface_types=npft + namelist:jules_surface_types=nnvg +help=Only used when jules_surface=l_aggregate is false +length=: +sort-key=1 +type=logical + +[namelist:jules_elevate=surf_hgt_io] +compulsory=true +description=Height of tile above mean gridbox surface (m) +fail-if=len(this) != namelist:jules_surface_types=npft + namelist:jules_surface_types=nnvg +help=Only used when jules_surface=l_aggregate is false +length=: +sort-key=2 +type=real [namelist:jules_flake] description=Configuration of the FLake model, only required if l_flake_model=true @@ -34,6 +88,133 @@ description=Number of FLake variables that will be provided =INCLUDED TO ALLOW TRIGGER LISTS TO BE SHARED url=https://metoffice.github.io/jules/latest/namelists/ancillaries.nml.html#JULES_FLAKE::nvars +#[namelist:jules_hydrology] has moved to jules-shared/jules-hydrology +[namelist:jules_hydrology=b_pdm] +compulsory=true +description=Shape factor for the pdf +sort-key=Panel-G04a +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_hydrology.nml.html#JULES_HYDROLOGY::b_pdm + +[namelist:jules_hydrology=dz_pdm] +compulsory=true +description=Depth of soil considered by PDM (m) +sort-key=Panel-G04a +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_hydrology.nml.html#JULES_HYDROLOGY::dz_pdm + +[namelist:jules_hydrology=l_baseflow_corr] +compulsory=false +description=Use a correction to the calculation of baseflow +type=logical + +[namelist:jules_hydrology=l_inland] +fail-if=this == '.true.' and namelist:jules_rivers=l_rivers == '.false.'; # The inland water correction needs to be use in conjunction with river routing. + +[namelist:jules_hydrology=l_limit_gsoil] +compulsory=true +description=Limit soil conductance above critical soil moisture. +sort-key=Panel-G05 +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_hydrology.nml.html#JULES_HYDROLOGY::l_limit_gsoil + +[namelist:jules_hydrology=l_pdm] +compulsory=true +description=Use PDM scheme +sort-key=Panel-G04 +trigger=namelist:jules_hydrology=b_pdm: .true.; + = namelist:jules_hydrology=dz_pdm: .true.; + = namelist:jules_hydrology=l_spdmvar: .true.; +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_hydrology.nml.html#JULES_HYDROLOGY::l_pdm + +[namelist:jules_hydrology=l_spdmvar] +compulsory=true +description=Use a linear function of topographic slope to calculate S0/Smax within the PDM scheme +fail-if=this == '.true.' and namelist:jules_hydrology=l_pdm == '.false.'; # clarify that l_spdmvar=T can only be used with l_pdm=T +sort-key=Panel-G04b +trigger=namelist:jules_hydrology=slope_pdm_max: .true.; + =namelist:jules_hydrology=s_pdm: .false.; +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_hydrology.nml.html#JULES_HYDROLOGY::l_spdmvar + +[namelist:jules_hydrology=l_top] +compulsory=true +description=Use TOPMODEL scheme +fail-if=this == '.true.' and namelist:jules_hydrology=l_pdm == '.true.'; # Can't have TOPMODEL and PDM together +sort-key=Panel-G03 +trigger=namelist:jules_hydrology=zw_max: .true.; + = namelist:jules_hydrology=ti_max: .true.; + = namelist:jules_hydrology=ti_wetl: .true.; + = namelist:jules_hydrology=nfita: .true.; + = namelist:jules_hydrology=l_wetland_unfrozen: .true.; + = namelist:jules_soil_biogeochem=ch4_substrate: .true.; + = namelist:jules_soil_biogeochem=l_ch4_tlayered: .true.; + = namelist:jules_soil_biogeochem=l_ch4_interactive: .true.; + = namelist:jules_hydrology=l_baseflow_corr: .true.; +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_hydrology.nml.html#JULES_HYDROLOGY::l_top + +[namelist:jules_hydrology=l_wetland_unfrozen] +compulsory=true +description=Use unfrozen wetland TOPMODEL scheme +sort-key=Panel-G03a +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_hydrology.nml.html#JULES_HYDROLOGY::l_wetland_unfrozen + +[namelist:jules_hydrology=nfita] +compulsory=true +description=Number of values tried in the fitting of exponential wetland/ + =saturation fraction functions with water table depth. +sort-key=Panel-G03b +type=integer +url=https://metoffice.github.io/jules/latest/namelists/jules_hydrology.nml.html#JULES_HYDROLOGY::nfita + +[namelist:jules_hydrology=s_pdm] +compulsory=true +description=Minimum storage below which there is no surface saturation + =considered by PDM (fraction of maximum storage, as S0/Smax) +sort-key=Panel-G04b1 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_hydrology.nml.html#JULES_HYDROLOGY::s_pdm + +[namelist:jules_hydrology=slope_pdm_max] +compulsory=true +description=Maximum slope (degrees) that will produce a S0/Smax value of zero + =in the linear function of topographic slope to calculate S0/Smax + =within the PDM scheme. +sort-key=Panel-G04b1 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_hydrology.nml.html#JULES_HYDROLOGY::slope_pdm_max + +[namelist:jules_hydrology=ti_max] +compulsory=true +description=Maximum possible value of the topographic index +sort-key=Panel-G03b +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_hydrology.nml.html#JULES_HYDROLOGY::ti_max + +[namelist:jules_hydrology=ti_wetl] +compulsory=true +description=Calibration parameter used in calculation of the wetland fraction +sort-key=Panel-G03b +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_hydrology.nml.html#JULES_HYDROLOGY::ti_wetl + +[namelist:jules_hydrology=zw_max] +compulsory=true +description=Maximum allowed depth to the water table (m) +sort-key=Panel-G03b +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_hydrology.nml.html#JULES_HYDROLOGY::zw_max + +[namelist:jules_irrig_props] +description=Configuration of irrigation properties + =NOT AVAILABLE TO UM + =READ BY STANDALONE EXECUTABLES ONLY + =INCLUDED TO ALLOW TRIGGER LISTS TO BE SHARED +url=https://metoffice.github.io/jules/latest/namelists/ancillaries.nml.html#namelist-JULES_IRRIG_PROPS + [namelist:jules_model_environment=l_jules_parent] fail-if=this == 0; # This should be 1 to indicate UM-JULES. =this == 2 and namelist:jules_model_environment=lsm_id != 3; # The OASIS coupler can only be used with Rivers-only (OASIS-Rivers). @@ -186,6 +367,15 @@ trigger=namelist:jules_pftparm: 1; =namelist:run_stochastic=z0v_rp_min: 1 ; =namelist:run_stochastic=z0v_rp: 1 ; +#[namelist:jules_nvegparm] has moved to jules-shared/jules-nvegparm +[namelist:jules_nvegparm=z0hm_classic_nvg_io] +compulsory=true +description=Ratio of the roughness length for heat to the roughness length for momentum for the CLASSIC aerosol scheme only +fail-if=len(this) != namelist:jules_surface_types=nnvg +length=: +type=real +url=https://metoffice.github.io/jules/latest/namelists/nveg_params.nml.html#JULES_NVEGPARM::z0hm_classic_nvg_io + [namelist:jules_pftparm=a_wl_io] length=: @@ -396,6 +586,18 @@ length=: [namelist:jules_pftparm=infil_f_io] length=: +[namelist:jules_pftparm=irrig_pft_io] +compulsory=true +description=Flag indicating whether the pft is irrigated +fail-if=len(this) != namelist:jules_surface_types=npft + =any(this > 0) and namelist:jules_model_environment=l_jules_parent == 1 ; # Tile-based irrigation scheme is not available in UM + =all(this == 0) +length=: +ns=namelist/JULES Science Settings/jules_pftparm/Other parameters +sort-key=Panel-HO05 +url=https://metoffice.github.io/jules/latest/namelists/pft_params.nml.html#JULES_PFTPARM::irrig_pft_io +values=0,1 + [namelist:jules_pftparm=jv25_ratio_io] length=: @@ -537,6 +739,84 @@ length=: [namelist:jules_pftparm=z0v_io] length=: +#[namelist:jules_radiation] has moved to jules-shared/jules-radiation +[namelist:jules_radiation=l_cosz] +compulsory=true +description=Calculate solar zenith angle in standalone. + =STANDALONE ONLY: This is not applicable to UM as the solar zenith + =angle is implicitly calculated by the UM. To create an equivalent + =standalone app it must be .true. +sort-key=Panel-BS01 +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_radiation.nml.html#JULES_RADIATION::l_cosz + +[namelist:jules_radiation=l_dolr_land_black] +compulsory=true +description=If true, + =do not use the surface emissivity in adjusting the OLR at land points + =HAS NO EFFECT IN STANDALONE +sort-key=Panel-BX01 +type=logical + +[namelist:jules_radiation=l_embedded_snow] +compulsory=true +description=Use embedded canopy snow albedo scheme. +fail-if=this == '.true.' and namelist:jules_radiation=l_spec_albedo != '.true.'; # If l_embedded_snow = T then l_spec_albedo must also be T + =this == '.true.' and namelist:jules_radiation=l_snow_albedo == '.true.'; # Embedded canopy snow albedo model is exclusive of l_snow_albedo. +sort-key=Panel-B02a +trigger=namelist:jules_snow=can_clump: .true.; + =namelist:jules_snow=n_lai_exposed: .true.; +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_radiation.nml.html#JULES_RADIATION::l_embedded_snow + +[namelist:jules_radiation=l_mask_snow_orog] +compulsory=true +description=Include orographic masking of snow. +sort-key=Panel-B06 +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_radiation.nml.html#JULES_RADIATION::l_mask_snow_orog + +[namelist:jules_radiation=l_sea_alb_var_chl] +fail-if=this == '.true.' and namelist:jules_model_environment=l_jules_parent == 0; # This is not currently available to standalone. + +[namelist:jules_radiation=l_snow_albedo] +compulsory=true +description=Include prognostic snow albedos. +fail-if=this == '.true.' and namelist:jules_radiation=l_spec_albedo == '.false.' # Prognostic snow albedo can only be used when l_spec_albedo=T +sort-key=Panel-B02 +# Only available when namelist:jules_radiation=l_spec_albedo is true, however it is not trigger-ignored as the trigger cascade results in albsnc not being available when namelist:jules_radiation=l_spec_albedo is false. +trigger=namelist:jules_snow=r0: .true.; + =namelist:jules_snow=rmax: .true.; + =namelist:jules_snow=snow_ggr: .true.; + =namelist:jules_snow=amax: .true.; + =namelist:jules_snow=dtland: .false.; + =namelist:jules_snow=kland_numerator: .false.; + =namelist:jules_pftparm=albsnc_max_io: .false.; + =namelist:jules_pftparm=albsnc_min_io: .false.; + =namelist:jules_nvegparm=albsnc_nvg_io: .false.; + =namelist:jules_radiation=l_embedded_snow: .false.; +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_radiation.nml.html#JULES_RADIATION::l_snow_albedo + +[namelist:jules_radiation=l_spec_sea_alb] +compulsory=true +description=Use spectrally varying open sea albedos +sort-key=Panel-B05c +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_radiation.nml.html#JULES_RADIATION::l_spec_sea_alb + +[namelist:jules_radiation=wght_alb] +compulsory=true +description=Weights for disaggregation of SW flux in the standard order VIS direct, VIS diffuse, NIR direct, NIR diffuse +length=4 +sort-key=Panel-BR01 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_surface.nml.html#JULES_RADIATION::wght_alb + +[namelist:jules_rivers=i_river_vn] +value-titles=UM_TRIP,RFM +values=1,2 + [namelist:jules_rivers_props] compulsory=true description=Configuration of spatially varying rivers properties @@ -544,6 +824,13 @@ description=Configuration of spatially varying rivers properties =READ BY STANDALONE EXECUTABLES ONLY url=https://metoffice.github.io/jules/latest/namelists/ancillaries.nml.html#namelist-JULES_RIVERS_PROPS +[namelist:jules_rivers_props=l_use_area] +description=Switch to use a drainage area ancillary field to identify river points + =NOT AVAILABLE TO UM + =READ BY STANDALONE EXECUTABLES ONLY + =INCLUDED TO ALLOW TRIGGER LISTS TO BE SHARED +url=https://metoffice.github.io/jules/latest/namelists/ancillaries.nml.html#JULES_RIVERS_PROPS::l_use_area + [namelist:jules_rivers_props=rivers_regrid] compulsory=true description=Regridding is required between model input and river routing grids @@ -551,40 +838,1984 @@ description=Regridding is required between model input and river routing grids =USED BY STANDALONE EXECUTABLES ONLY url=https://metoffice.github.io/jules/latest/namelists/ancillaries.nml.html#JULES_RIVERS_PROPS::rivers_regrid -[namelist:jules_surface=i_aggregate_opt] +[namelist:jules_sea_seaice] compulsory=true -description=Method of aggregating tiled properties -sort-key=Panel-F02a -url=https://metoffice.github.io/jules/latest/namelists/jules_surface.nml.html#JULES_SURFACE::i_aggregate_opt -value-titles=Original option,Separate aggregation -values=0,1 +ns=namelist/JULES Science Settings/jules_sea_seaice +title=Sea and sea-ice options -[namelist:jules_surface=l_aggregate] +[namelist:jules_sea_seaice=a_chrn_coare] compulsory=true -description=Use aggregate surface scheme -sort-key=Panel-F02 -trigger=namelist:jules_surface=i_aggregate_opt: .true.; - =namelist:recon_science=l_canopy_snow_throughfall: .false.; - =namelist:jules_elevate=surf_hgt_io: .false.; - =namelist:jules_elevate=l_elev_absolute_height: .false.; -type=logical -url=https://metoffice.github.io/jules/latest/namelists/jules_surface.nml.html#JULES_SURFACE::l_aggregate +description=Coefficient of 10m wind speed in expression for + =Charnock's coefficient in COARE algorithm. +help=Only used if namelist:jules_sea_seaice=iseasurfalg = 3 +sort-key=01 +type=real -[namelist:jules_surface=l_elev_land_ice] -# This trigger list is different, but may just be an oversight. Leave for now. -trigger=namelist:jules_soil=dzsoil_elev: .true.; - =namelist:jules_surface_types=elev_ice: .true.; - =namelist:jules_surface_types=elev_rock: .true.; +[namelist:jules_sea_seaice=ahmax] +compulsory=true +description=4-band sea ice albedo scheme: thickness above which + =underlying ocean doesn't affect sea ice albedo (m) +range=0:30 +sort-key=02 +type=real -[namelist:jules_surface=l_vary_z0m_soil] -help=Allows the bare soil momentum roughness length (z0(m)) to - =vary. This field needs to be input/reconfigured in as an - =ancillary field in the soil parameters file as STASH item 97. +[namelist:jules_sea_seaice=albicei_cice] +compulsory=true +description=4-band sea ice albedo scheme: bare ice albedo (near-IR) +range=0:1 +sort-key=04 +type=real -[namelist:jules_surface=srf_ex_cnv_gust] +[namelist:jules_sea_seaice=albicev_cice] +compulsory=true +description=4-band sea ice albedo scheme: bare ice albedo (visible) +range=0:1 +sort-key=03 +type=real + +[namelist:jules_sea_seaice=albpondi_cice] +compulsory=true +description=4-band sea ice albedo scheme: meltpond albedo (near-IR) +range=0:1 +sort-key=08 +type=real + +[namelist:jules_sea_seaice=albpondv_cice] +compulsory=true +description=4-band sea ice albedo scheme: meltpond albedo (visible) +range=0:1 +sort-key=07 +type=real + +[namelist:jules_sea_seaice=albsnowi_cice] +compulsory=true +description=4-band sea ice albedo scheme: snow albedo (near-IR) +range=0:1 +sort-key=06 +type=real + +[namelist:jules_sea_seaice=albsnowv_cice] +compulsory=true +description=4-band sea ice albedo scheme: snow albedo (visible) +range=0:1 +sort-key=05 +type=real + +[namelist:jules_sea_seaice=alphab] +# This needs triggers for NEMO, CICE, SSICEALBEDO +# [namelist:jules_sea_seaice=l_ssice_albedo] trigger=namelist_jules_sea_seaice=alphab: .true. +compulsory=true +description=Original HadGEM sea ice albedo scheme: Albedo of snow free ('bare') sea-ice +range=0:1 +sort-key=09 +type=real + +[namelist:jules_sea_seaice=alphac] +compulsory=true +description=Original HadGEM sea ice albedo scheme: Albedo of sea-ice at and + =below odegC-dtice if .not.l_ssice_albedo, + =or albedo of snow on sea-ice + =at and below 0degC-dtice if l_ssice_albedo ("C" for "cold") +range=0:1 +sort-key=10 +type=real + +[namelist:jules_sea_seaice=alpham] +compulsory=true +description=Original HadGEM sea ice albedo scheme: Albedo of sea-ice at melting point (TM) + =if .not.l_ssice_albedo, + =or albedo of snow on sea-ice at melting point (TM) if + =l_ssice_albedo. ("M" for "melting") +range=0:1 +sort-key=11 +type=real + +[namelist:jules_sea_seaice=b_chrn_coare] +compulsory=true +description=Constant term in expression for + =Charnock`s coefficient in COARE algorithm. +help=Only used if namelist:jules_sea_seaice=iseasurfalg = 3 +sort-key=12 +type=real + +[namelist:jules_sea_seaice=beta_evap] +compulsory=true +description=Efficiency of evaporation from sea-surface +help=This parameter controls the efficiency with which water can evaporate from a sea-surface. + = The default value is 1.0, moisture availability is effectively unrestricted. + = However lower values can be useful for idealised modelling, + = restricting the evaporation rate. + = For example, a value of 0.0 would result in no evaporation +range=0.0:1.0 +sort-key=12a +type=real + +[namelist:jules_sea_seaice=beta_floe] +compulsory=true +description=Constant in parametrization of crosswind length of floe +sort-key=62 +type=real + +[namelist:jules_sea_seaice=buddy_sea] +compulsory=true +description=Use neighbouring sea point wind-speeds in coastal grid points +sort-key=13 value-titles=Off,On values=0,1 +[namelist:jules_sea_seaice=cdn_hw_sea] +compulsory=true +description="High-wind limit of the neutral drag coefficient over the sea" +fail-if=this > namelist:jules_sea_seaice=cdn_max_sea; # Must not exceed cdn_max_sea +help=At very high wind speeds, the drag coefficient is not well-known, + =though observations suggest a reduction below the maximum value. + =This parameter specifies the value taken at wind speeds greater than + =u_cdn_max. +sort-key=25c +type=real + +[namelist:jules_sea_seaice=cdn_max_sea] +compulsory=true +description="Maximum neutral drag coefficient over the sea" +help=The maximum value that the 10-m neutral drag coefficient + =is permitted to take. Drag coefficients are not well-known + =at high wind speeds though evidence generally suggests that + =the drag coefficient does not increase above about 33 ms-1, + =so that it does not exceed about 0.0024, based on laboratory + =measurements. The limit in open seas seems a little higher, + =about 0.003, because the fetch is not so limited. +sort-key=25b +type=real + +[namelist:jules_sea_seaice=ce_floe] +compulsory=true +description=Effective resistance coefficient. NB. The full logarithmic + =form of the integral of U^2 is used, so this will need to + =be scaled if taken from a source where the integral has + =been approximated. +sort-key=66 +type=real + +[namelist:jules_sea_seaice=charnock] +compulsory=false +description=Charnock parameter for roughness length of sea points +range=0.0:1.0 +sort-key=14 +type=real + +[namelist:jules_sea_seaice=d_floe_max] +compulsory=true +description=Maximum crosswind length of floe +sort-key=64 +type=real + +[namelist:jules_sea_seaice=d_floe_min] +compulsory=true +description=Minimum crosswind length of floe +sort-key=63 +type=real + +[namelist:jules_sea_seaice=dalb_bare_wet] +compulsory=true +description=Original HadGEM sea ice albedo scheme: Increment to albedo + =for each degree temperature rises above 0degC-dt_bare. + =Only used if l_sice_meltponds and l_ssice_albedo +range=-1.0:0 +sort-key=15 +type=real + +[namelist:jules_sea_seaice=dalb_mlt_cice] +compulsory=true +description=4-band sea ice albedo scheme: Increment to sea ice albedo for + =each degree temperature rises above 0degC-dt_bare (not used + =when explicit meltponds are in use) +range=-1:0 +sort-key=16 +type=real + +[namelist:jules_sea_seaice=dalb_mlts_i_cice] +compulsory=true +description=4-band sea ice albedo scheme: Increment to near-IR snow albedo + =for each degree temperature rises above 0degC-dt_bare +range=-1:0 +sort-key=18 +type=real + +[namelist:jules_sea_seaice=dalb_mlts_v_cice] +compulsory=true +description=4-band sea ice albedo scheme: Increment to visible snow albedo + =for each degree temperature rises above 0degC-dt_bare +range=-1:0 +sort-key=17 +type=real + +[namelist:jules_sea_seaice=dt_bare] +# dependent on namelist:jules_sea_seaice=l_ssice_albedo +compulsory=true +description=Original HadGEM sea ice albedo scheme: Temperature below freezing + =at which melt ponds form if l_sice_meltponds and + =l_ssice_albedo (degC) +range=0:100 +sort-key=19 +type=real + +[namelist:jules_sea_seaice=dt_bare_cice] +compulsory=true +description=CICE sea ice albedo scheme: Temperature below freezing at which + =melt ponds form +range=0:100 +sort-key=20 +type=real + +[namelist:jules_sea_seaice=dt_snow_cice] +compulsory=true +description=CICE sea ice albedo scheme: Temperature range in which albedo of + =sea-ice, + =if .not. l_ssice_albedo, + =or of snow on sea-ice varies + =between its limits. +range=0:100 +sort-key=21 +type=real + +[namelist:jules_sea_seaice=dtice] +compulsory=true +description=Original HadGEM sea ice albedo scheme: Temperature range in which + =albedo of sea-ice, + =if .not.l_ssice_albedo,or of snow on sea-ice, + =if l_ssice_albedo, + =varies between its limits. Recommended range + =5-10K +range=0.1:50 +sort-key=22 +type=real + +[namelist:jules_sea_seaice=emis_sea] +compulsory=false +description=Emissivity of open sea +sort-key=23 +type=real + +[namelist:jules_sea_seaice=emis_sice] +compulsory=false +description=Emissivity of sea-ice +sort-key=24 +type=real + +[namelist:jules_sea_seaice=h_freeboard_max] +compulsory=true +description=Maximum height of freeboard +sort-key=61 +type=real + +[namelist:jules_sea_seaice=h_freeboard_min] +compulsory=true +description=Minimum height of freeboard +sort-key=60 +type=real + +[namelist:jules_sea_seaice=hcap_sea] +compulsory=true +description=Heat capacity of open sea +sort-key=68 +type=real + +[namelist:jules_sea_seaice=i_high_wind_drag] +compulsory=true +description=Option for treating drag at high wind speeds +sort-key=25a +trigger=namelist:jules_sea_seaice=cdn_max_sea: 1, 2; + =namelist:jules_sea_seaice=cdn_hw_sea: 2; + =namelist:jules_sea_seaice=u_cdn_max: 2; + =namelist:jules_sea_seaice=u_cdn_hw: 2; +value-titles="No special treatment of high winds", + ="Maximum neutral drag coefficient specified", + ="Maximum neutral drag coefficient and reduction at very high wind speeds" +values=0,1,2 + +[namelist:jules_sea_seaice=iseasurfalg] +compulsory=true +description=Algorithm for surface exchange over the sea. +help=The most basic option for surface transfer at the sea surface + =consists of a specification of Charnock's coefficient for the + =momentum roughness length, including the aerodynamically smooth + =contribution in light winds, and a fixed thermal roughness length. + =Surface divergence theory allows for a variable thermal roughness + =length that follows the aerodynamicall smooth limit in light winds + =and decreases in stronger winds, giving a slower increase in the + =exchange coefficient for moisture as the wind rises. Historically, + =roughness lengths that depend on the friction velocity have not + =been iterated within the calculation of the Obukhov length, though + =this is more consistent: an iterative option is therefore provided. + =The COARE algorithm is based on a range of observations and exists + =in various forms. It features a dependence of Charnock's coefficient + =on the wind speed and a dependence of the thermal roughness length + =on the roughness Reynolds number. Extra parameters allow different + =versions of the algorithm to be used. +sort-key=25 +trigger=namelist:jules_sea_seaice=charnock: 0,1, + =2; + =namelist:jules_sea_seaice=l_10m_neut: 3; + =namelist:jules_sea_seaice=a_chrn_coare: 3; + =namelist:jules_sea_seaice=b_chrn_coare: 3; + =namelist:jules_sea_seaice=u10_max_coare: 3; + =namelist:jules_sea_seaice=u10_min_coare: 3; +value-titles="Fixed values of Charnock's coefficient and + =thermal roughness length", + ="Fixed value of Charnock's coefficient with thermal + =roughness from surface divergence theory (non-iterative)", + ="Fixed value of Charnock's coefficient with thermal + =roughness from surface divergence theory (iterative)", + ="Roughness lengths follow functional forms of the COARE + =algorithm", + ="Variable value of Charnock's coefficient with thermal + =roughness from surface divergence theory (iterative)", + ="Variable value of Charnock's coefficient with thermal + =roughness from surface divergence theory (non-iterative)" +values=0,1,2,3,4,5 + +[namelist:jules_sea_seaice=kappa_seasurf] +compulsory=false +description=Effective thermal conductivity of sea surface layer (W / m / K) +sort-key=26 +type=real + +[namelist:jules_sea_seaice=kappai] +compulsory=false +description=Thermal conductivity of sea-ice (W / m / K) +sort-key=27 +type=real + +[namelist:jules_sea_seaice=kappai_snow] +compulsory=false +description=Thermal conductivity of snow on zero layer sea-ice (W / m / K) +sort-key=28 +type=real + +[namelist:jules_sea_seaice=l_10m_neut] +compulsory=true +description=Flag to use true neutral 10m wind speeds. +help=Only used if namelist:jules_sea_seaice=iseasurfalg = 3 + =The 10m wind speed in the COARE algorithm should strictly be + =a neutral wind speed. Historically in the UM system, + =the + =distinction between stability-adjusted and neutral 10m + =winds has been ignored, + =eg. in assimilation. This switch + =enables the distinction to be made or ignored as desired. +sort-key=29 +type=logical + +[namelist:jules_sea_seaice=l_cice_alb] +compulsory=true +description=Use sea-ice albedo scheme from the CICE model +sort-key=30 +trigger=namelist:jules_sea_seaice=alphab: .false.; + =namelist:jules_sea_seaice=alphac: .false.; + =namelist:jules_sea_seaice=alpham: .false.; + =namelist:jules_sea_seaice=dalb_bare_wet: .false.; + =namelist:jules_sea_seaice=dtice: .false.; + =namelist:jules_sea_seaice=dt_bare: .false.; + =namelist:jules_sea_seaice=pen_rad_frac: .false.; + =namelist:jules_sea_seaice=ssalphac: .false.; + =namelist:jules_sea_seaice=ssalpham: .false.; + =namelist:jules_sea_seaice=ssdtice: .false.; + =namelist:jules_sea_seaice=sw_beta: .false.; + =namelist:jules_sea_seaice=ahmax: .true.; + =namelist:jules_sea_seaice=albicei_cice: .true.; + =namelist:jules_sea_seaice=albicev_cice: .true.; + =namelist:jules_sea_seaice=albsnowi_cice: .true.; + =namelist:jules_sea_seaice=albsnowv_cice: .true.; + =namelist:jules_sea_seaice=albpondi_cice: .true.; + =namelist:jules_sea_seaice=albpondv_cice: .true.; + =namelist:jules_sea_seaice=dalb_mlt_cice: .true.; + =namelist:jules_sea_seaice=dalb_mlts_i_cice: .true.; + =namelist:jules_sea_seaice=dalb_mlts_v_cice: .true.; + =namelist:jules_sea_seaice=dt_bare_cice: .true.; + =namelist:jules_sea_seaice=dt_snow_cice: .true.; + =namelist:jules_sea_seaice=pen_rad_frac_cice: .true.; + =namelist:jules_sea_seaice=snowpatch: .true.; + =namelist:jules_sea_seaice=sw_beta_cice: .true.; + =namelist:jules_sea_seaice=l_sice_swpen: .true. +type=logical + +[namelist:jules_sea_seaice=l_ctile] +compulsory=true +description=Enable coastal tiling +sort-key=31 +trigger=namelist:run_convection=l_ccp_seabreeze: .true.; +type=logical + +[namelist:jules_sea_seaice=l_iceformdrag_lupkes] +compulsory=true +description=Switch for diagnostic form drag following Lupkes et al. (2012) + =and Lupkes & Gryanik (2015) +sort-key=58 +trigger=namelist:jules_sea_seaice=l_stability_lupkes: .true.; + =namelist:jules_sea_seaice=h_freeboard_min: .true.; + =namelist:jules_sea_seaice=h_freeboard_max: .true.; + =namelist:jules_sea_seaice=beta_floe: .true.; + =namelist:jules_sea_seaice=d_floe_min: .true.; + =namelist:jules_sea_seaice=d_floe_max: .true.; + =namelist:jules_sea_seaice=ss_floe: .true.; + =namelist:jules_sea_seaice=ce_floe: .true. ; + =namelist:jules_sea_seaice=z0h_z0m_miz: .false. ; + =namelist:jules_sea_seaice=z0miz: .false. +type=logical + +[namelist:jules_sea_seaice=l_icerough_prognostic] +compulsory=true +description=Switch for prognostic form drag +sort-key=58 +type=logical + +[namelist:jules_sea_seaice=l_saldep_freeze] +compulsory=true +description=Ocean freezing temperature (and thus sea ice formation) is salinity-dependent +sort-key=32 +type=logical + +[namelist:jules_sea_seaice=l_sice_heatflux] +compulsory=true +description=Do semi-implicit update of ti for sea-ice +sort-key=33 +type=logical + +[namelist:jules_sea_seaice=l_sice_meltponds] +compulsory=true +description=Sea-ice albedo is affected by meltponds (simple parametrization) +sort-key=34 +trigger=namelist:jules_sea_seaice=dalb_bare_wet: .true.; + =namelist:jules_sea_seaice=dt_bare: .true. +type=logical + +[namelist:jules_sea_seaice=l_sice_meltponds_cice] +compulsory=true +description=Sea-ice albedo is affected by meltponds (from CICE meltponds scheme) +sort-key=35 +trigger=namelist:jules_sea_seaice=albpondi_cice: .true.; + =namelist:jules_sea_seaice=albpondi_cice: .true.; + =namelist:jules_sea_seaice=dalb_bare_wet: .false.; + =namelist:jules_sea_seaice=dt_bare: .false.; + =namelist:jules_sea_seaice=dt_bare_cice: .false. +type=logical + +[namelist:jules_sea_seaice=l_sice_multilayers] +compulsory=true +description=Coupled to sea-ice multilayer model +sort-key=36 +type=logical + +[namelist:jules_sea_seaice=l_sice_scattering] +compulsory=true +description=Use sea-ice albedo internal scatter +sort-key=37 +trigger=namelist:jules_sea_seaice=pen_rad_frac: .true.; + =namelist:jules_sea_seaice=pen_rad_frac_cice: .true.; + =namelist:jules_sea_seaice=sw_beta: .true.; + =namelist:jules_sea_seaice=sw_beta_cice: .true.; + =namelist:jules_sea_seaice=l_sice_swpen: .true. +type=logical + +[namelist:jules_sea_seaice=l_sice_swpen] +compulsory=true +description=Penetration of SW radiation into sea ice included explicitly +help=Allow some of the penetrating solar radiation to be absorbed below the + =sea ice surface skin. This means removing this component from the surface + =net solar and passing this energy to the sea ice model through the coupler + =so that it can be absorbed within the sea ice layers. +sort-key=38 +type=logical + +[namelist:jules_sea_seaice=l_ssice_albedo] +compulsory=true +description=Include the effect of snow on the sea-ice albedo +sort-key=39 +trigger=namelist:jules_sea_seaice=alphab: .true.; + =namelist:jules_sea_seaice=alphac: .false.; + =namelist:jules_sea_seaice=alpham: .false.; + =namelist:jules_sea_seaice=dtice: .false.; + =namelist:jules_sea_seaice=dalb_bare_wet: .true.; + =namelist:jules_sea_seaice=dt_bare: .true.; + =namelist:jules_sea_seaice=ssalphac: .true.; + =namelist:jules_sea_seaice=ssalpham: .true.; + =namelist:jules_sea_seaice=ssdtice: .true.; + =namelist:jules_sea_seaice=pen_rad_frac: .true.; + =namelist:jules_sea_seaice=sw_beta: .true. +type=logical + +[namelist:jules_sea_seaice=l_stability_lupkes] +compulsory=true +description=Switch to include the stability dependence in the parametrization + =of ice form drag +sort-key=59 +type=logical + +[namelist:jules_sea_seaice=l_tstar_sice_new] +compulsory=true +description=Calculate sea-ice surface temperature in scheme compatible with multi-categories + =This logical is only used in a single category run +sort-key=40 +type=logical + +[namelist:jules_sea_seaice=l_use_dtstar_sea] +compulsory=true +description=Use the calculated change in SST from sf_flux +sort-key=67 +trigger=namelist:jules_sea_seaice=kappa_seasurf: .true.; +type=logical + +[namelist:jules_sea_seaice=nice] +compulsory=true +description=The total number of sea-ice categories +range=1:25 +sort-key=41 +type=integer + +[namelist:jules_sea_seaice=nice_use] +compulsory=true +description=The number of sea-ice categories used in surface exchange + =(should be equal to either 1 or nice) +range=1:25 +sort-key=42 +type=integer + +[namelist:jules_sea_seaice=pen_rad_frac] +compulsory=true +description=Original HadGEM sea ice albedo scheme: Fraction of SW radiation + =that penetrates seaice and scatters back causing an addition to + =the albedo. Only active if l_ssice_albedo and l_sice_scattering +range=0:1 +sort-key=43 +type=real + +[namelist:jules_sea_seaice=pen_rad_frac_cice] +compulsory=true +description=4-band sea ice albedo scheme: Fraction of SW radiation that + =penetrates seaice and scatters back causing an addition to the + =albedo in CICE multi-band scheme (not used when internal + =scattering in sea ice is modelled explicitly) +range=0:1 +sort-key=44 +type=real + +[namelist:jules_sea_seaice=seasalinityfactor] +compulsory=false +description=Scaling of qsat in sea-surface evaporation to allow for + =the salinity of sea water +range=0.0:1.0 +sort-key=45 +type=real + +[namelist:jules_sea_seaice=snowpatch] +compulsory=true +description=4-band sea ice albedo scheme: Length scale for parameterizing + =non uniform snow coverage (m) +range=0:1 +sort-key=46 +type=real + +[namelist:jules_sea_seaice=ss_floe] +compulsory=true +description=Sheltering constant +sort-key=65 +type=real + +[namelist:jules_sea_seaice=ssalphac] +compulsory=true +description=Original HadGEM sea ice albedo scheme: Namelist input for alphac + =if l_ssice_albedo - assigned to alphac in readlsta.F90 +range=0:1 +sort-key=47 +type=real + +[namelist:jules_sea_seaice=ssalpham] +compulsory=true +description=Original HadGEM sea ice albedo scheme: Namelist input for alpham + =if l_ssice_albedo - assigned to alpham in readlsta.F90 +range=0:1 +sort-key=48 +type=real + +[namelist:jules_sea_seaice=ssdtice] +compulsory=true +description=Original HadGEM sea ice albedo scheme: Namelist input for dtice if + =l_ssice_albedo - assignd to dtice in readlsta.F90. Recommended + =range 5-10K +range=0.1:50 +sort-key=49 +type=real + +[namelist:jules_sea_seaice=sw_beta] +compulsory=true +description=Original HadGEM sea ice albedo scheme: Attenutation parameter for + =SW in seaice which controls the additional albedo due to internal + =scattering +range=0:1 +sort-key=50 +type=real + +[namelist:jules_sea_seaice=sw_beta_cice] +compulsory=true +description=4-band sea ice albedo scheme: Attenutation parameter for SW in + =seaice which controls the additional albedo due to internal + =scattering in the CICE multi-band scheme (not used when internal + =scattering in sea ice is modelled explicitly) +range=0:1 +sort-key=51 +type=real + +[namelist:jules_sea_seaice=u10_max_coare] +compulsory=true +description=Highest wind speed for linear variation of Charnock's + =coefficient in COARE algorithm. +help=Only used if namelist:jules_sea_seaice=iseasurfalg = 3 + =Generically in the COARE algorithm, + =Charnock's coefficient + =exhibits a linear dependence on the 10m wind speed + =over a specified range, with constant values above and + =below. Precise values vary with the version of the COARE + =algorithm. This variable provides the upper limit of the + =linear range. +sort-key=52 +type=real + +[namelist:jules_sea_seaice=u10_min_coare] +compulsory=true +description=Lowest wind speed for linear variation of Charnock's + =coefficient in COARE algorithm. +help=Only used if namelist:jules_sea_seaice=iseasurfalg = 3 + =Generically in the COARE algorithm, + =Charnock's coefficient + =exhibits a linear dependence on the 10m wind speed + =over a specified range, with constant values above and + =below. Precise values vary with the version of the COARE + =algorithm. This variable provides the lower limit of the + =linear range. +sort-key=53 +type=real + +[namelist:jules_sea_seaice=u_cdn_hw] +compulsory=true +description="Wind speed above which the drag coefficient takes the limiting value" +fail-if=this < namelist:jules_sea_seaice=u_cdn_max; # Must exceed u_cdn_max +help=This is the wind speed at which the drag coefficient attains its limiting + =value for very high wind speeds. +sort-key=25d +type=real + +[namelist:jules_sea_seaice=u_cdn_max] +compulsory=true +description="Wind speed above which the drag coefficient begins to decrease" +help=This is the wind speed at which the drag coefficient Begins to decrease + =from its maximum value to the limiting value for very high wind speeds. + =The decrease is linear in the wind speed. +sort-key=25e +type=real + +[namelist:jules_sea_seaice=z0h_z0m_miz] +compulsory=false +description=Ratio of thermal to momentum roughness lengths for marginal ice +sort-key=54 +type=real + +[namelist:jules_sea_seaice=z0h_z0m_sice] +compulsory=false +description=Ratio of thermal to momentum roughness lengths for sea ice +sort-key=55 +type=real + +[namelist:jules_sea_seaice=z0hsea] +compulsory=true +description=Roughness length for heat over open sea (m) +sort-key=55a +type=real + +[namelist:jules_sea_seaice=z0miz] +compulsory=false +description=Roughness length for heat, + =moisture and momentum over the Marginal Ice Zone (m) +sort-key=56 +type=real + +[namelist:jules_sea_seaice=z0sice] +compulsory=false +description=Roughness length for heat, + =moisture and momentum over sea-ice (m) +sort-key=57 +type=real + +#[namelist:jules_snow] has moved to jules-shared/jules-snow +[namelist:jules_snow=a_snow_et] +compulsory=true +description=Constant in Parametrization of equitemperature metamorphism +ns=namelist/JULES Science Settings/jules_snow/Other parameters +sort-key=Panel-D14a +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::a_snow_et + +[namelist:jules_snow=aicemax] +compulsory=true +description=Maximum albedos (VIS and NIR) for bare ice +length=2 +ns=namelist/JULES Science Settings/jules_snow/Radiation parameters +range=0.01:0.99 +sort-key=Panel-D08 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::aicemax + +[namelist:jules_snow=amax] +compulsory=false +description=Maximum albedos (VIS and NIR) for fresh snow +length=2 +ns=namelist/JULES Science Settings/jules_snow/Radiation parameters +sort-key=Panel-D06 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::amax + +[namelist:jules_snow=b_snow_et] +compulsory=true +description=Constant in Parametrization of equitemperature metamorphism +ns=namelist/JULES Science Settings/jules_snow/Other parameters +sort-key=Panel-D14a +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::b_snow_et + +[namelist:jules_snow=c_snow_et] +compulsory=true +description=Constant in Parametrization of equitemperature metamorphism +ns=namelist/JULES Science Settings/jules_snow/Other parameters +sort-key=Panel-D14a +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::c_snow_et + +[namelist:jules_snow=dtland] +compulsory=false +description=Degrees Celsius below zero at which snow albedo equals cold deep snow albedo +ns=namelist/JULES Science Settings/jules_snow/Radiation parameters +sort-key=Panel-D07 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::dtland + +[namelist:jules_snow=dzsnow] +compulsory=true +description=Prescribed thickness of each snow layer (m) when the multilayer scheme is enabled. +fail-if=len(this) != namelist:jules_snow=nsmax; # A value must be given for each snow layer +length=: +sort-key=Panel-D01a +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::dzsnow + +[namelist:jules_snow=frac_snow_subl_melt] +compulsory=true +description=Switch for use of snow-cover fraction in the calculation of sublimation and melting +sort-key=Panel-D03 +url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::frac_snow_subl_melt +value-titles=Off,On +values=0,1 + +[namelist:jules_snow=graupel_options] +compulsory=true +description=Switch for treatment of graupel in the snow scheme +sort-key=Panel-D04 +url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::graupel_options +value-titles=Include graupel as snowfall,Ignore graupel in the surface snowfall, + =Treat graupel separately +values=0,1,2 + +[namelist:jules_snow=i_snow_cond_parm] +compulsory=true +description=Identifier for parametrization of snow conductivity. +ns=namelist/JULES Science Settings/jules_snow/Other parameters +sort-key=Panel-D01d +url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::i_snow_cond_parm +value-titles=Yen1981,Calonne2011 +values=0,1 + +[namelist:jules_snow=kland_numerator] +compulsory=false +description=Used in snow-ageing effect on albedo in the diagnostic albedo scheme. +ns=namelist/JULES Science Settings/jules_snow/Radiation parameters +sort-key=Panel-D07 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::kland_numerator + +[namelist:jules_snow=l_et_metamorph] +compulsory=true +description=Switch for the inclusion of equitemperature metamorphism. +ns=namelist/JULES Science Settings/jules_snow/Other parameters +sort-key=Panel-D14 +trigger=namelist:jules_snow=a_snow_et: .true.; + = namelist:jules_snow=b_snow_et: .true.; + = namelist:jules_snow=c_snow_et: .true.; + = namelist:jules_snow=rho_snow_et_crit: .true.; +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::l_et_metamorph + +[namelist:jules_snow=l_rho_snow_corr] +compulsory=false +description=Switch for using a correction to the density of the snow pack +help=Switch for using a correction to the density of the snow pack when nsnow=0 + =when relayering in the new snow scheme. + = + =Has no effect for nsmax < 1. +type=logical + +[namelist:jules_snow=l_snow_infilt] +compulsory=true +description=Switch to allow the infiltration of rain and canopy melting into the snowpack. +ns=namelist/JULES Science Settings/jules_snow/Other parameters +sort-key=Panel-D15 +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::l_snow_infilt + +[namelist:jules_snow=l_snow_nocan_hc] +compulsory=true +description=Switch to ignore heat capacity of the canopy above the snowpack on tiles where a canopy model is not used. +ns=namelist/JULES Science Settings/jules_snow/Other parameters +sort-key=Panel-D16 +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::l_snow_nocan_hc + +[namelist:jules_snow=l_snowdep_surf] +compulsory=true +description=Use equivalent canopy snow depth for surface calculations on tiles with a snow canopy +sort-key=Panel-D02 +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::l_snowdep_surf + +[namelist:jules_snow=lai_alb_lim_sn] +compulsory=true +description=Minimum LAI applied to plant canopies in the presence of snow to represent stems. +fail-if=len(this) != namelist:jules_surface_types=npft; # A value must be given for each PFT +length=: +ns=namelist/JULES Science Settings/jules_snow/Radiation parameters +sort-key=Panel-D10 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::lai_alb_lim_sn + +[namelist:jules_snow=maskd] +compulsory=false +description=Used in exponent of equation weighting snow-covered and snow-free albedo, sublimation and melting. +ns=namelist/JULES Science Settings/jules_snow/Radiation parameters +sort-key=Panel-D05 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::maskd + +[namelist:jules_snow=nsmax] +compulsory=true +description=Maximum number of layers in the snow pack when the mutilayer scheme is enabled. +range=0: +sort-key=Panel-D01 +trigger=namelist:jules_snow=dzsnow: this > 0; + =namelist:jules_snow=rho_snow_fresh: this > 0; + =namelist:jules_snow=snowliqcap: this > 0; + =namelist:jules_snow=i_relayer_opt: this > 0; + =namelist:jules_snow=i_grain_growth_opt: this > 0; + =namelist:jules_snow=i_snow_cond_parm: this > 0; + =namelist:jules_snow=l_snow_nocan_hc: this > 0; + =namelist:jules_snow=l_rho_snow_corr: this > 0; + =namelist:recon_science=l_regularize_landice_all_soil_pts: this == 0; + =namelist:recon_science=l_regularize_landice_all_lice_pts: this == 0; +type=integer +url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::nsmax + +[namelist:jules_snow=r0] +compulsory=false +description=Grain size for fresh snow (um) +ns=namelist/JULES Science Settings/jules_snow/Radiation parameters +sort-key=Panel-D06 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::r0 + +[namelist:jules_snow=rho_firn_albedo] +compulsory=true +description=Threshold density for the firn albedo parameterisation to replace that for snow +ns=namelist/JULES Science Settings/jules_snow/Radiation parameters +range=0.01:1000. +sort-key=Panel-D08 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::rho_firn_albedo + +[namelist:jules_snow=rho_snow_const] +compulsory=false +description=Constant density of lying snow (kg m-3), used on canopies and for very thin snow. +ns=namelist/JULES Science Settings/jules_snow/Other parameters +sort-key=Panel-D01b +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::rho_snow_const + +[namelist:jules_snow=rho_snow_et_crit] +compulsory=true +description=Constant in Parametrization of equitemperature metamorphism +ns=namelist/JULES Science Settings/jules_snow/Other parameters +sort-key=Panel-D14a +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::rho_snow_et_crit + +[namelist:jules_snow=rmax] +compulsory=false +description=Maximum snow grain size (um) +ns=namelist/JULES Science Settings/jules_snow/Radiation parameters +sort-key=Panel-D06 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::rmax + +[namelist:jules_snow=snow_ggr] +compulsory=false +description=Snow grain area growth rates (um2 s-1) +length=3 +ns=namelist/JULES Science Settings/jules_snow/Radiation parameters +sort-key=Panel-D06 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::snow_ggr + +[namelist:jules_snow=snow_hcap] +compulsory=false +description=Thermal capacity of lying snow (J K-1 m-3) +ns=namelist/JULES Science Settings/jules_snow/Other parameters +sort-key=Panel-D12 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::snow_hcap + +[namelist:jules_snow=snow_hcon] +compulsory=false +description=Default thermal conductivity of lying snow (W m-1 K-1). +ns=namelist/JULES Science Settings/jules_snow/Other parameters +sort-key=Panel-D11 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::snow_hcon + +[namelist:jules_snow=snowinterceptfact] +compulsory=false +description=Constant in relationship between mass of intercepted snow and snowfall rate +ns=namelist/JULES Science Settings/jules_snow/Other parameters +sort-key=Panel-D05 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::snowinterceptfact + +[namelist:jules_snow=snowliqcap] +compulsory=false +description=Liquid water holding capacity of lying snow, as a fraction of snow mass +ns=namelist/JULES Science Settings/jules_snow/Other parameters +sort-key=Panel-D01c +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::snowliqcap + +[namelist:jules_snow=snowloadlai] +description=Ratio of maximum canopy snow load to leaf area index (kg m-2) +ns=namelist/JULES Science Settings/jules_snow/Other parameters +sort-key=Panel-D05 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::snowloadlai + +[namelist:jules_snow=snowunloadfact] +description=Constant in relationship between canopy snow unloading and canopy snow melt rate +ns=namelist/JULES Science Settings/jules_snow/Other parameters +sort-key=Panel-D05 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::snowunloadfact + +[namelist:jules_snow=unload_rate_cnst] +compulsory=true +description=Constant term in background unloading rate of snow on canopies +fail-if=len(this) != namelist:jules_surface_types=npft; # A value must be given for each PFT +length=: +ns=namelist/JULES Science Settings/jules_snow/Other parameters +sort-key=Panel-D13 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_snow.nml.html#JULES_SNOW::unload_rate_cnst + +#[namelist:jules_soil] has moved to jules-shared/jules-soil +[namelist:jules_soil=confrac] +compulsory=true +description=Fraction of the gridbox assumed to be covered by convective precipitation +range=0.0:1.0 +sort-key=Panel-E10 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::confrac + +[namelist:jules_soil=cs_min] +compulsory=true +description=Minimum allowed soil carbon (kg m-2) +range=0.000001: +sort-key=Panel-E07 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::cs_min + +[namelist:jules_soil=dzdeep] +compulsory=true +description=Thickness of bedrock (m) +range=0.01: +sort-key=Panel-E06d +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::dzdeep + +[namelist:jules_soil=dzsoil_elev] +compulsory=true +description=Depth (m) of tiled bedrock subsurfaces under elevated tiles. +fail-if=this <= 0 ; # Must have positive value +range=0.01: +sort-key=Panel-E12 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::dzsoil_elev + +[namelist:jules_soil=dzsoil_io] +compulsory=true +description=Soil layer depths (m), starting with the uppermost layer +fail-if=len(this) != namelist:jules_soil=sm_levels; # Must have a value for each soil level +length=: +sort-key=Panel-E11 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::dzsoil_io + +[namelist:jules_soil=hcapdeep] +compulsory=true +description=Heat capacity of bedrock (J K-1 m-3) +range=100000:8000000 +sort-key=Panel-E06b +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::hcapdeep + +[namelist:jules_soil=hcondeep] +compulsory=true +description=Thermal conductivity of bedrock (W m-2 K-1) +range=0.4:12.0 +sort-key=Panel-E06c +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::hcondeep + +[namelist:jules_soil=l_bedrock] +compulsory=true +description=Include bedrock below soil column with thermal diffusion; does not include hydrology + =NOT AVAILABLE TO UM +sort-key=Panel-E06 +trigger=namelist:jules_soil=ns_deep: .true.; + = namelist:jules_soil=hcapdeep: .true.; + = namelist:jules_soil=hcondeep: .true.; + = namelist:jules_soil=dzdeep: .true.; +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::l_bedrock + +[namelist:jules_soil=l_holdwater] +compulsory=true +description=Stops water being pushed out of the soil column when a single layer is supersaturated +sort-key=Panel-E13 +url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::l_holdwater +value-titles=Bug fixed,Original +values=.true.,.false. +widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget + +[namelist:jules_soil=l_tile_soil] +compulsory=true +description=Switch to set the number of soil tiles to equal the number of surface tiles +fail-if=this == '.true.' and namelist:jules_model_environment=l_jules_parent == 1; # Not available in the UM +sort-key=Panel-E14 +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::l_tile_soil + +[namelist:jules_soil=ns_deep] +compulsory=true +description=Number of bedrock layers +range=1: +sort-key=Panel-E06a +type=integer +url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::ns_deep + +[namelist:jules_soil=sm_levels] +compulsory=true +description=Number of soil layers +range=1: +sort-key=Panel-E01 +type=integer +url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::sm_levels + +[namelist:jules_soil=soilhc_method] +compulsory=true +description=Choice of soil thermal conductivity model +sort-key=Panel-E05 +url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::soilhc_method +value-titles=Cox et al (1999),Simplified Johansen (1975),Chadburn et al (2015) +values=1,2,3 +widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget + +[namelist:jules_soil=zsmc] +compulsory=true +description=Depth of layer over which soil moisture diagnostic is averaged (m) +range=0.01: +sort-key=Panel-E08 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::zsmc + +[namelist:jules_soil=zst] +compulsory=true +description=Depth of layer over which soil temperature diagnostic is averaged (m) +range=0.01: +sort-key=Panel-E09 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_soil.nml.html#JULES_SOIL::zst + +[namelist:jules_soil_biogeochem=soil_bgc_model] +fail-if=this == 1 and namelist:jules_vegetation=l_triffid == '.true.'; # Can't use 1-pool with TRIFFID + =this == 2 and namelist:jules_vegetation=l_triffid != '.true.'; # Can't use 4-pool soil C without TRIFFID +trigger=namelist:jules_soil_biogeochem=l_q10: 1, 2; + =namelist:jules_soil_biogeochem=q10_soil: 1, 2; + =namelist:jules_soil_biogeochem=l_soil_resp_lev2: 1, 2; + =namelist:jules_soil_biogeochem=kaps: 1; + =namelist:jules_soil_biogeochem=kaps_4pool: 2; + =namelist:jules_soil_biogeochem=sorp: 2; + =namelist:jules_soil_biogeochem=n_inorg_turnover: 2; + =namelist:jules_soil_biogeochem=bio_hum_cn: 2; + =namelist:jules_soil_biogeochem=diff_n_pft: 2; + =namelist:jules_soil_biogeochem=tau_lit: 2; + =namelist:jules_soil_biogeochem=tau_resp: 2; +value-titles=Single pool model,4-pool model +values=1,2 + +[namelist:jules_surface=i_aggregate_opt] +compulsory=true +description=Method of aggregating tiled properties +sort-key=Panel-F02a +url=https://metoffice.github.io/jules/latest/namelists/jules_surface.nml.html#JULES_SURFACE::i_aggregate_opt +value-titles=Original option,Separate aggregation +values=0,1 + +[namelist:jules_surface=l_aggregate] +compulsory=true +description=Use aggregate surface scheme +sort-key=Panel-F02 +trigger=namelist:jules_surface=i_aggregate_opt: .true.; + =namelist:recon_science=l_canopy_snow_throughfall: .false.; + =namelist:jules_elevate=surf_hgt_io: .false.; + =namelist:jules_elevate=l_elev_absolute_height: .false.; +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_surface.nml.html#JULES_SURFACE::l_aggregate + +[namelist:jules_surface=l_elev_land_ice] +# This trigger list is different, but may just be an oversight. Leave for now. +trigger=namelist:jules_soil=dzsoil_elev: .true.; + =namelist:jules_surface_types=elev_ice: .true.; + =namelist:jules_surface_types=elev_rock: .true.; + +[namelist:jules_surface=l_vary_z0m_soil] +help=Allows the bare soil momentum roughness length (z0(m)) to + =vary. This field needs to be input/reconfigured in as an + =ancillary field in the soil parameters file as STASH item 97. + +[namelist:jules_surface=srf_ex_cnv_gust] +value-titles=Off,On +values=0,1 + +#[namelist:jules_surface_types] has moved to jules-shared/jules-surface-types +[namelist:jules_surface_types=brd_leaf_dec] +description=Pseudo level of broadleaf (decidous) PFT +fail-if=this > namelist:jules_surface_types=npft; # Pseudo level must be less than or equal to npft +range=1: +sort-key=Panel-A1b +type=integer +url=https://metoffice.github.io/jules/latest/namelists/jules_surface_types.nml.html#JULES_SURFACE_TYPES::brd_leaf_dec + +[namelist:jules_surface_types=brd_leaf_eg_temp] +description=Pseudo level of broadleaf (evergreen temperate) PFT +fail-if=this > namelist:jules_surface_types=npft; # Pseudo level must be less than or equal to npft +range=1: +sort-key=Panel-A1d +type=integer +url=https://metoffice.github.io/jules/latest/namelists/jules_surface_types.nml.html#JULES_SURFACE_TYPES::brd_leaf_eg_temp + +[namelist:jules_surface_types=brd_leaf_eg_trop] +description=Pseudo level of broadleaf (evergreen tropical) PFT +fail-if=this > namelist:jules_surface_types=npft; # Pseudo level must be less than or equal to npft +help=Must have value <= npft +range=1: +sort-key=Panel-A1c +type=integer +url=https://metoffice.github.io/jules/latest/namelists/jules_surface_types.nml.html#JULES_SURFACE_TYPES::brd_leaf_eg_trop + +[namelist:jules_surface_types=c3_crop] +description=Pseudo level of C3 crop PFT +fail-if=this > namelist:jules_surface_types=npft; # Pseudo level must be less than or equal to npft +range=1: +sort-key=Panel-A3b +type=integer +url=https://metoffice.github.io/jules/latest/namelists/jules_surface_types.nml.html#JULES_SURFACE_TYPES::c3_crop + +[namelist:jules_surface_types=c3_irrig] +compulsory=true +description=Pseudo level of C3 irrig PFT +fail-if=this > namelist:jules_surface_types=npft; # Pseudo level must be less than or equal to npft +range=1: +sort-key=Panel-A3d +type=integer +url=https://metoffice.github.io/jules/latest/namelists/jules_surface_types.nml.html#JULES_SURFACE_TYPES::c3_irrig + +[namelist:jules_surface_types=c3_pasture] +description=Pseudo level of C3 pasture PFT +fail-if=this > namelist:jules_surface_types=npft; # Pseudo level must be less than or equal to npft +range=1: +sort-key=Panel-A3c +type=integer +url=https://metoffice.github.io/jules/latest/namelists/jules_surface_types.nml.html#JULES_SURFACE_TYPES::c3_pasture + +[namelist:jules_surface_types=c4_crop] +description=Pseudo level of C4 crop PFT +fail-if=this > namelist:jules_surface_types=npft; # Pseudo level must be less than or equal to npft +range=1: +sort-key=Panel-A4b +type=integer +url=https://metoffice.github.io/jules/latest/namelists/jules_surface_types.nml.html#JULES_SURFACE_TYPES::c4_crop + +[namelist:jules_surface_types=c4_irrig] +compulsory=true +description=Pseudo level of C4 irrig PFT +fail-if=this > namelist:jules_surface_types=npft; # Pseudo level must be less than or equal to npft +range=1: +sort-key=Panel-A4d +type=integer +url=https://metoffice.github.io/jules/latest/namelists/jules_surface_types.nml.html#JULES_SURFACE_TYPES::c4_irrig + +[namelist:jules_surface_types=c4_pasture] +description=Pseudo level of C4 pasture PFT +fail-if=this > namelist:jules_surface_types=npft; # Pseudo level must be less than or equal to npft +range=1: +sort-key=Panel-A4c +type=integer +url=https://metoffice.github.io/jules/latest/namelists/jules_surface_types.nml.html#JULES_SURFACE_TYPES::c4_pasture + +[namelist:jules_surface_types=elev_ice] +compulsory=true +description=Pseudo levels of elevated ice surface type (Glacier/Icesheet model) +fail-if=any(this > namelist:jules_surface_types=npft + namelist:jules_surface_types=nnvg); # Pseudo level must be less than or equal to npft+nnvg + =any(this <= namelist:jules_surface_types=npft and this != -1); # PFTs must be grouped together first with non-vegetated tiles following +length=: +range=-1,1: +sort-key=Panel-A9b +type=integer +url=https://metoffice.github.io/jules/latest/namelists/jules_surface_types.nml.html#JULES_SURFACE_TYPES::elev_ice + +[namelist:jules_surface_types=elev_rock] +compulsory=true +description=Pseudo levels of elevated bedrock surface type (Glacier/Icesheet model) +fail-if=any(this > namelist:jules_surface_types=npft + namelist:jules_surface_types=nnvg); # Pseudo level must be less than or equal to npft+nnvg + =any(this <= namelist:jules_surface_types=npft and this != -1); # PFTs must be grouped together first with non-vegetated tiles following +length=: +range=-1,1: +sort-key=Panel-A9c +type=integer +url=https://metoffice.github.io/jules/latest/namelists/jules_surface_types.nml.html#JULES_SURFACE_TYPES::elev_rock + +[namelist:jules_surface_types=ncpft] +description=Number of crop plant functional types to be modelled + =NOT AVAILABLE TO THE UM +fail-if=this > namelist:jules_surface_types=npft; # Number of crop PFTs must be less than total number of PFTs + =this > 0 and namelist:jules_model_environment=l_jules_parent == 1; # This is not available to the UM. Should be zero. +range=0: +sort-key=Panel-A0c +trigger=namelist:jules_vegetation=l_prescsow: this > 0; +type=integer +url=https://metoffice.github.io/jules/latest/namelists/jules_surface_types.nml.html#JULES_SURFACE_TYPES::ncpft + +[namelist:jules_surface_types=ndl_leaf_dec] +description=Pseudo level of needleleaf (deciduous) PFT +fail-if=this > namelist:jules_surface_types=npft; # Pseudo level must be less than or equal to npft +range=1: +sort-key=Panel-A2b +type=integer +url=https://metoffice.github.io/jules/latest/namelists/jules_surface_types.nml.html#JULES_SURFACE_TYPES::ndl_leaf_dec + +[namelist:jules_surface_types=ndl_leaf_eg] +description=Pseudo level of needleleaf (evergreen) PFT +fail-if=this > namelist:jules_surface_types=npft; # Pseudo level must be less than or equal to npft +range=1: +sort-key=Panel-A2c +type=integer +url=https://metoffice.github.io/jules/latest/namelists/jules_surface_types.nml.html#JULES_SURFACE_TYPES::ndl_leaf_eg + +[namelist:jules_surface_types=nnvg] +help=Currently nnvg has a minumum value of 2 as soil and ice must be specified. + =See "Web Help" for general help. For UM specific help concerning pslist see + =namelist:jules_surface_types=npft +range=2: + +[namelist:jules_surface_types=npft] +help=Care has to be taken when changing the npft and nnvg values to ensure that + =they are consistent with the requested diagnostic output. The user should + =ammend if appropriate the pslist, which defines the diagnostic output on + =pseudo levels, in each domain profile (e.g. DTILE, DPFT, lt19, TILES). + =The pslist should contain pseudo level numbers, not tile ID numbers and + =can contain a subset of the available pseudo levels. + +[namelist:jules_surface_types=shrub_dec] +description=Pseudo level of shrub (deciduous) PFT +fail-if=this > namelist:jules_surface_types=npft; # Pseudo level must be less than or equal to npft +range=1: +sort-key=Panel-A5b +type=integer +url=https://metoffice.github.io/jules/latest/namelists/jules_surface_types.nml.html#JULES_SURFACE_TYPES::shrub_dec + +[namelist:jules_surface_types=shrub_eg] +description=Pseudo level of shrub (evergreen) PFT +fail-if=this > namelist:jules_surface_types=npft; # Pseudo level must be less than or equal to npft +range=1: +sort-key=Panel-A5c +type=integer +url=https://metoffice.github.io/jules/latest/namelists/jules_surface_types.nml.html#JULES_SURFACE_TYPES::shrub_eg + +[namelist:jules_surface_types=tile_map_ids] +description=Tile mapping array from input to output dump surface type configuration + =NOT AVAILABLE TO STANDALONE +fail-if=len(this) != namelist:jules_surface_types=npft + namelist:jules_surface_types=nnvg +help=Mapping array, containing tile ID numbers, used by the reconfiguration to determine which + =tile in the input dump should be used to initialise each tile in the output dump. The + =reconfiguration determines the corresponding pseudo level map (tile_map_pslevs) containing + =the pseudo levels where the tile types from tile_map_ids reside in the input dump. + =Allows new tiles added (e.g. urban_canyon and urban_roof) to be initialised from existing + =tiles (e.g. urban) or an old dump with the incorrect labelling to be used. Depends on the + =input dump so if an option file is used to change the input dump, tile_map_ids will also + =need to be ammended. +length=: +range=1: +sort-key=Panel-A0d +type=integer + +[namelist:jules_surface_types=usr_type] +description=Pseudo level of user surface types +fail-if=any(this > namelist:jules_surface_types=npft + namelist:jules_surface_types=nnvg); # Pseudo level must be less than or equal to npft+nnvg +help=Must have value less than or equal to ntype +length=: +range=1: +sort-key=Panel-A0e +type=integer +url=https://metoffice.github.io/jules/latest/namelists/jules_surface_types.nml.html#JULES_SURFACE_TYPES::usr_type + +[namelist:jules_temp_fixes=l_fix_drydep_so2_water] +fail-if=( this != namelist:temp_fixes=l_fix_drydep_so2_water ) ; # For UM_JULES applications, code uses setting of equivalent deposition switch in UM temp_fixes namelist +help=When calculating the dry deposition of SO2, the surface resistance of + =water was wrongly set to 148.9 s/m. This is used in UKESM1.0, and so + =needs to be maintained. Setting this logical to true, will set the + =surface resistance of water for the dry deposition of SO2 to 10 s/m + =instead. + +[namelist:jules_temp_fixes=l_fix_improve_drydep] +fail-if=( this != namelist:temp_fixes=l_fix_improve_drydep ) ; # For UM_JULES applications, code uses setting of equivalent deposition switch in UM temp_fixes namelist +help=Non zero dry deposition velocities are set for HCl, HOCl, HBr, HOBr, + = H2SO4, MeOH and Sec_Org. + = + = Dry deposition velocities for 9 tiles are made consistant with those of + = 13 / 17 / 27 tiles. + +[namelist:jules_temp_fixes=l_fix_ukca_h2dd_x] +fail-if=( this != namelist:temp_fixes=l_fix_ukca_h2dd_x ) ; # For UM_JULES applications, code uses setting of equivalent deposition switch in UM temp_fixes namelist +help=When set to true, this corrects a bug in the element of + = h2dd_c and h2dd_m used for the calculation of H2 dry deposition to + = shrub and bare soil. + +[namelist:jules_triffid] +compulsory=true +description=Most parameters in this section are required, even if they are not used + =However, they can be left at their default value + = + =Click on names for more details + = +ns=namelist/JULES Science Settings/jules_triffid +sort-key=10 +title=TRIFFID PFT parameters +url=https://metoffice.github.io/jules/latest/namelists/triffid_params.nml.html#namelist-JULES_TRIFFID + +[namelist:jules_triffid=ag_expand_io] +compulsory=true +description=Type of agricultural expansion employed when l_ag_expand=T. + =0 means PFTs grow into the increased agricultural area naturally (default) + =1 means new agricultural area is automatically filled with the selected PFT. +fail-if=len(this) != namelist:jules_surface_types=npft +length=: +url=https://metoffice.github.io/jules/latest/namelists/triffid_params.nml.html#JULES_TRIFFID::ag_expand_io +values=0,1 + +[namelist:jules_triffid=crop_io] +description=Flag indicating whether the PFT is crop, pasture, bioenergy/forestry, or natural. +fail-if=any(this > 1) and (namelist:jules_vegetation=l_trif_crop == '.false.') or (len(this) != namelist:jules_surface_types=npft) +length=: +url=https://metoffice.github.io/jules/latest/namelists/triffid_params.nml.html#JULES_TRIFFID::crop_io +value-titles=Natural,Crop,Pasture,Bioenergy/Forestry +values=0,1,2,3 + +[namelist:jules_triffid=g_area_io] +description=Disturbance rate (/360days) +fail-if=len(this) != namelist:jules_surface_types=npft +length=: +type=real +url=https://metoffice.github.io/jules/latest/namelists/triffid_params.nml.html#JULES_TRIFFID::g_area_io + +[namelist:jules_triffid=g_grow_io] +description=Rate of leaf growth (/360days) +fail-if=len(this) != namelist:jules_surface_types=npft +length=: +type=real +url=https://metoffice.github.io/jules/latest/namelists/triffid_params.nml.html#JULES_TRIFFID::g_grow_io + +[namelist:jules_triffid=g_root_io] +description=Turnover rate for root biomass (/360days) +fail-if=len(this) != namelist:jules_surface_types=npft +length=: +type=real +url=https://metoffice.github.io/jules/latest/namelists/triffid_params.nml.html#JULES_TRIFFID::g_root_io + +[namelist:jules_triffid=g_wood_io] +description=Turnover rate for woody biomass (/360days) +fail-if=len(this) != namelist:jules_surface_types=npft +length=: +type=real +url=https://metoffice.github.io/jules/latest/namelists/triffid_params.nml.html#JULES_TRIFFID::g_wood_io + +[namelist:jules_triffid=harvest_freq_io] +compulsory=true +description=Frequency of harvest of crops. +fail-if=len(this) != namelist:jules_surface_types=npft +length=: +sort-key=01a +url=https://metoffice.github.io/jules/latest/namelists/triffid_params.nml.html#JULES_TRIFFID::harvest_freq_io + +[namelist:jules_triffid=harvest_ht_io] +compulsory=true +description=Height to which the PFT is reduced at each harvest cycle. +fail-if=len(this) != namelist:jules_surface_types=npft +length=: +sort-key=01a +type=real +url=https://metoffice.github.io/jules/latest/namelists/triffid_params.nml.html#JULES_TRIFFID::harvest_ht_io + +[namelist:jules_triffid=harvest_type_io] +compulsory=true +description=Type of harvesting, set to 0 for natural PFTs. + =0: No harvesting (default) + =1: Continuous harvesting from litter, as historically used in TRIFFID crop scheme + =2: Periodic harvesting with harvest frequency set to harvest_freq_io. +fail-if=len(this) != namelist:jules_surface_types=npft +length=: +sort-key=01 +trigger=namelist:jules_triffid=harvest_freq_io: any(this == 2); + =namelist:jules_triffid=harvest_ht_io: any(this == 2); +url=https://metoffice.github.io/jules/latest/namelists/triffid_params.nml.html#JULES_TRIFFID::harvest_type_io +values=0,1,2 + +[namelist:jules_triffid=lai_max_io] +description=Maximum LAI +fail-if=len(this) != namelist:jules_surface_types=npft +length=: +type=real +url=https://metoffice.github.io/jules/latest/namelists/triffid_params.nml.html#JULES_TRIFFID::lai_max_io + +[namelist:jules_triffid=lai_min_io] +description=Minimum LAI +fail-if=len(this) != namelist:jules_surface_types=npft +length=: +type=real +url=https://metoffice.github.io/jules/latest/namelists/triffid_params.nml.html#JULES_TRIFFID::lai_min_io + +[namelist:jules_triffid=retran_l_io] +description=Leaf N retranslocation +fail-if=len(this) != namelist:jules_surface_types=npft +length=: +type=real +url=https://metoffice.github.io/jules/latest/namelists/triffid_params.nml.htm#JULES_TRIFFID::retran_l_io + +[namelist:jules_triffid=retran_r_io] +description=Root N retranslocation +fail-if=len(this) != namelist:jules_surface_types=npft +length=: +type=real +url=https://metoffice.github.io/jules/latest/namelists/triffid_params.nml.htm#JULES_TRIFFID::retran_r_io + +#[namelist:jules_urban] has moved to jules-shared/jules-urban +[namelist:jules_urban=l_moruses_macdonald] +compulsory=true +description=Use MacDonald et al. (1998) to calculate effective roughness length and displacement height +fail-if=namelist:jules_urban=l_urban_empirical == '.true.' and this == '.false.'; # Must be true if l_urban_empirical is true +type=logical +url=https://metoffice.github.io/jules/latest/namelists/urban.nml.html#JULES_URBAN::l_moruses_macdonald + +[namelist:jules_urban=l_urban_empirical] +compulsory=true +description=Use empirical relationships for urban geometry + =NOT AVAILABLE TO UM +type=logical +url=https://metoffice.github.io/jules/latest/namelists/urban.nml.html#JULES_URBAN::l_urban_empirical + +#[namelist:jules_vegetation] has moved to jules-shared/jules-vegetation +[namelist:jules_vegetation=act_j_coef] +compulsory=true +description=Coefficients for the activation energy of Jmax. +length=3 +sort-key=Panel-I20b1 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::act_j_coef + +[namelist:jules_vegetation=act_v_coef] +compulsory=true +description=Coefficients for the activation energy of Vcmax. +length=3 +sort-key=Panel-I20b2 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::act_v_coef + +[namelist:jules_vegetation=c1_usuh] +compulsory=true +description=Ratio of friction velocity to wind speed at the top of a dense canopy +range=0: +sort-key=Panel-I09b +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::c1_usuh + +[namelist:jules_vegetation=c2_usuh] +compulsory=true +description=Ratio of friction velocity to wind speed at the surface of the substrate under the canopy +range=0: +sort-key=Panel-I09b +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::c2_usuh + +[namelist:jules_vegetation=c3_usuh] +compulsory=true +description=Used in the exponent of the equation weighting dense and sparse vegetation + = to get u*/U(h) in neutral conditions +range=0: +sort-key=Panel-I09b +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::c3_usuh + +[namelist:jules_vegetation=can_model] +compulsory=true +description=Choice of canopy model for vegetation +sort-key=Panel-I12 +trigger=namelist:jules_snow=cansnowpft: 4; + =namelist:jules_snow=snowinterceptfact: 4; + =namelist:jules_snow=snowloadlai: 4; + =namelist:jules_snow=snowunloadfact: 4; + =namelist:jules_surface=hleaf: 3,4; + =namelist:jules_surface=hwood: 3,4; +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::can_model +value-titles=No distinct canopy,Radiative canopy with no heat capacity,Radiative canopy with heat capacity,As 3 but with snow beneath canopy +values=1,2,3,4 +#warn-if=this == 3; # can_model = 3 is deprecated, with 4 preferred (cannot be added to UM metadata as breaks Rose stem as mutually exclusive of l_aggregate). +widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget + +[namelist:jules_vegetation=cd_leaf] +compulsory=true +description=Leaf level drag coefficient +range=0:1 +sort-key=Panel-I09b +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::cd_leaf + +[namelist:jules_vegetation=dsj_coef] +compulsory=true +description=Coefficients for the rate of change with leaf temperature of the Jmax entropy factor. +length=3 +sort-key=Panel-I20a1 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::dsj_coef + +[namelist:jules_vegetation=dsv_coef] +compulsory=true +description=Coefficients for the rate of change with leaf temperature of the Vcmax entropy factor. +length=3 +sort-key=Panel-I20a1 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::dsv_coef + +[namelist:jules_vegetation=frac_min] +compulsory=true +description=Minimum fraction that a PFT is allowed to cover if TRIFFID is used +sort-key=Panel-I02b +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::frac_min + +[namelist:jules_vegetation=frac_seed] +compulsory=true +description=Seed fraction for TRIFFID +sort-key=Panel-I02b +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::frac_seed + +[namelist:jules_vegetation=fsmc_shape] +compulsory=true +description=Shape of soil moisture stress on vegetation function +fail-if=namelist:jules_vegetation=l_use_pft_psi == ".false." and this == 1; # 1. Piece-wise linear in soil potential. Currently only allowed when const_z = T and l_use_pft_psi = T. + =this == 1 and namelist:jules_model_environment=l_jules_parent == 1; # Piece-wise linear in soil potential is not currently available to the UM. Should be 0 (volumetric soil moisture). +sort-key=Panel-I17 +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::fsmc_shape +value-titles=Piece-wise linear in volumetric soil moisture +values=0 +widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget + +[namelist:jules_vegetation=ignition_method] +compulsory=true +description=The method to use for ignitions +sort-key=Panel-I16a +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::ignition_method +value-titles=(1) constant human and natural ignition sources, + =(2) constant human varying natural ignition sources, + =(3) varying human and natural ignition sources +values=1,2,3 + +[namelist:jules_vegetation=ilayers] +compulsory=true +description=Number of layers for canopy radiation model +range=1:100 +sort-key=Panel-I13a +type=integer +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::ilayers + +[namelist:jules_vegetation=jv25_coef] +compulsory=true +description=Coefficients for the ratio Jmax:Vcmax at 25 degC. +length=3 +sort-key=Panel-I20a1 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::jv25_coef + +[namelist:jules_vegetation=l_ag_expand] +compulsory=true +description=Allow assisted expansion of agricultural crop areas. + =The type of expansion is set with ag_expand_io. +fail-if=this == '.true.' and namelist:jules_vegetation=l_trif_biocrop == '.false.'; +sort-key=Panel-I02c1a1 +trigger=namelist:jules_triffid=ag_expand_io: .true.; +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::l_ag_expand + +[namelist:jules_vegetation=l_croprotate] +compulsory=true +description=Switch to allow double cropping in JULES + =NOT AVAILABLE TO UM +fail-if=namelist:jules_vegetation=l_prescsow == '.false.' and this == '.true.'; # l_prescsow must be TRUE if l_croprotate = TRUE +sort-key=Panel-I14 +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::l_croprotate + +[namelist:jules_vegetation=l_gleaf_fix] +compulsory=true +description=Use fix for accumulating g_leaf_phen_acc between calls to TRIFFID + =Standalone only bug fix. +sort-key=Panel-I15 +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::l_gleaf_fix + +[namelist:jules_vegetation=l_ht_compete] +compulsory=true +description=Switch for using height based competition in TRIFFID +sort-key=Panel-I02c +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::l_ht_compete + +[namelist:jules_vegetation=l_landuse] +compulsory=true +description=Switch for using landuse change in conjunction with TRIFFID +sort-key=Panel-I02c +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::l_landuse + +[namelist:jules_vegetation=l_leaf_n_resp_fix] +compulsory=true +description=Switch to use correct forms for canopy-average leaf nitrogen + =(for plant maintenance resp and N demand). + =This affects can_rad_mod = 1, 4 and 5, not 6 (which is correct). +sort-key=Panel-I03 +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::l_leaf_n_resp_fix + +[namelist:jules_vegetation=l_nitrogen] +compulsory=true +description=Use the TRIFFID Nitrogen limitation scheme for interactive carbon cycle +sort-key=Panel-I02c +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::l_nitrogen + +[namelist:jules_vegetation=l_nrun_mid_trif] +compulsory=true +description=Start an NRUN mid way through a TRIFFID calling period + =ONLY APPLICABLE TO UM +sort-key=Panel-I02c +type=logical + +[namelist:jules_vegetation=l_phenol] +compulsory=true +description=Include leaf phenology +sort-key=Panel-I01 +trigger=namelist:jules_vegetation=phenol_period: .true.; +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::l_phenol + +[namelist:jules_vegetation=l_prescsow] +compulsory=true +description=Use prescribed sowing dates for crops + =NOT AVAILABLE TO THE UM +sort-key=Panel-I14 +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::l_prescsow + +[namelist:jules_vegetation=l_red] +compulsory=true +description=Switch for using the Robust Ecosystem Demography (RED). + = RED is not available to the UM. +fail-if=this == '.true.' and namelist:jules_model_environment=l_jules_parent == 1; # RED is not available to the UM. + =this == '.true.' and namelist:jules_surface_types=ncpft > 0; +sort-key=Panel-I02d +trigger=namelist:jules_red: .true.; + =namelist:jules_red=alpha_recrt: .true.; + =namelist:jules_red=crwn_area0: .true.; + =namelist:jules_red=dom_order: .true.; + =namelist:jules_red=height0: .true.; + =namelist:jules_red=lai_bal0: .true.; + =namelist:jules_red=mass0: .true.; + =namelist:jules_red=massi: .true.; + =namelist:jules_red=mclass: .true.; + =namelist:jules_red=mort_base: .true.; + =namelist:jules_red=phi_a: .true.; + =namelist:jules_red=phi_g: .true.; + =namelist:jules_red=phi_h: .true.; + =namelist:jules_red=phi_l: .true.; +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::l_red + +[namelist:jules_vegetation=l_rsl_scalar] +compulsory=true +description=Switch for using roughness sublayer correction scheme in scalar + = variables. This is triggered if vegetative drag scheme is used. +sort-key=Panel-I09a +trigger=namelist:jules_vegetation=stanton_leaf: .true.; +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::l_rsl_scalar + +[namelist:jules_vegetation=l_scale_resp_pm] +compulsory=true +description=Scale whole plant maintenance respiration by the soil moisture + =stress factor, instead of only scaling leaf respiration. +sort-key=Panel-I18 +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::l_scale_resp_pm + +[namelist:jules_vegetation=l_spec_veg_z0] +trigger=namelist:jules_pftparm=dz0v_dh_io: .false.; + =namelist:jules_pftparm=z0v_io: .true.; + =namelist:run_stochastic=z0v_rp: .true.; + =namelist:run_stochastic=z0v_rp_min: .true.; + =namelist:run_stochastic=z0v_rp_max: .true.; + +[namelist:jules_vegetation=l_stem_resp_fix] +compulsory=true +description=Switch for bug fix for stem respiration to use balanced LAI to + =derive respiring stem mass. +sort-key=Panel-I06 +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::l_stem_resp_fix + +[namelist:jules_vegetation=l_trait_phys] +compulsory=true +description=Switch for using trait-based physiology. +sort-key=Panel-I07 +trigger=namelist:jules_pftparm=hw_sw_io: .true.; + =namelist:jules_pftparm=lma_io: .true.; + =namelist:jules_pftparm=nmass_io: .true.; + =namelist:jules_pftparm=nr_io: .true.; + =namelist:jules_pftparm=nsw_io: .true.; + =namelist:jules_pftparm=vint_io: .true.; + =namelist:jules_pftparm=vsl_io: .true.; + =namelist:jules_pftparm=neff_io: .false.; + =namelist:jules_pftparm=nl0_io: .false.; + =namelist:jules_pftparm=sigl_io: .false.; +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::l_trait_phys + +[namelist:jules_vegetation=l_trif_biocrop] +compulsory=true +description=Allow periodic harvesting of biocrops +fail-if=this == '.true.' and namelist:jules_vegetation=l_trif_crop == '.false.'; +sort-key=Panel-I02c1a +trigger=namelist:jules_triffid=harvest_type_io: .true.; + =namelist:jules_vegetation=l_ag_expand: .true.; +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::l_trif_biocrop + +[namelist:jules_vegetation=l_trif_crop] +compulsory=true +description=Use agricultural PFTs +fail-if=this == '.true.' and namelist:jules_vegetation=l_trif_eq == '.true.'; +sort-key=Panel-I02c1 +trigger=namelist:jules_vegetation=l_trif_biocrop: .true.; +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::l_trif_crop + +[namelist:jules_vegetation=l_trif_eq] +compulsory=true +description=Run TRIFFID in equilibrium mode +sort-key=Panel-I02c +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::l_trif_eq + +[namelist:jules_vegetation=l_trif_init_accum] +compulsory=true +description=Start a NRUN resetting accumulated Carbon fluxes to zero + =ONLY APPLICABLE TO THE UM +fail-if=this == '.true.' and namelist:jules_model_environment=l_jules_parent == 0; # This is only applicable to the UM so should be false in standalone +help=TRUE: Reset accumulated npp and respiration fluxes to 0. in an NRUN. This is the default + =FALSE: Accumulated fluxes are read from the dump. This is required for a NRUN-NRUN simulation to + =be bit comparable to a NRUN-CRUN experiment + =In a CRUN accumulated fluxes are always read from the dump +sort-key=Panel-I02c +type=logical + +[namelist:jules_vegetation=l_triffid] +compulsory=true +description=Use the TRIFFID dynamic vegetation model, except for competition +sort-key=Panel-I02 +trigger=namelist:jules_vegetation=l_nrun_mid_trif: .true.; + =namelist:jules_vegetation=l_trif_eq: .true.; + =namelist:jules_vegetation=triffid_period: .true.; + =namelist:jules_vegetation=l_veg_compete: .true.; + =namelist:jules_vegetation=l_landuse: .true.; + =namelist:jules_vegetation=l_ht_compete: .true.; + =namelist:jules_vegetation=l_nitrogen: .true.; + =namelist:jules_vegetation=l_red: .true.; + =namelist:jules_vegetation=l_trif_crop: .true.; + =namelist:jules_vegetation=l_trif_fire: .true.; + =namelist:jules_vegetation=l_trif_init_accum: .true.; + =namelist:jules_vegetation=frac_min: .true.; + =namelist:jules_vegetation=frac_seed: .true.; + =namelist:jules_vegetation=pow: .true.; + =namelist:jules_triffid: .true.; +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::l_triffid + +[namelist:jules_vegetation=l_veg_compete] +compulsory=true +description=Use competing vegetation +sort-key=Panel-I02c +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::l_veg_compete + +[namelist:jules_vegetation=l_vegcan_soilfx] +compulsory=true +description=Allow for conduction in the soil below the vegetative canopy. +sort-key=Panel-I08 +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::l_vegcan_soilfx + +[namelist:jules_vegetation=l_vegdrag_pft] +compulsory=true +description=Switch for using vegetation canopy drag scheme for each PFT +fail-if=len(this) != namelist:jules_surface_types=npft; # A value must be given for each PFT +length=: +sort-key=Panel-I09 +trigger=namelist:jules_vegetation=c1_usuh: any(this == '.true.'); + = namelist:jules_vegetation=c2_usuh: any(this == '.true.'); + = namelist:jules_vegetation=c3_usuh: any(this == '.true.'); + = namelist:jules_vegetation=cd_leaf: any(this == '.true.'); + = namelist:jules_vegetation=l_rsl_scalar: any(this == '.true.'); +type=logical +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::l_vegdrag_pft + +[namelist:jules_vegetation=n_alloc_jmax] +compulsory=true +description=Constant relating nitrogen allocation to Jmax +sort-key=Panel-I20c1 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::n_alloc_jmax + +[namelist:jules_vegetation=n_alloc_vcmax] +compulsory=true +description=Constant relating nitrogen allocation to Vcmax +sort-key=Panel-I20c1 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::n_alloc_vcmax + +[namelist:jules_vegetation=n_day_photo_acclim] +compulsory=true +description=Time constant for moving average of temperature (days) +sort-key=Panel-I20a1 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::n_day_photo_acclim + +[namelist:jules_vegetation=phenol_period] +compulsory=true +description=Update frequency for leaf phenology (days) +range=1:365 +sort-key=Panel-I01a +type=integer +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::phenol_period + +[namelist:jules_vegetation=photo_acclim_model] +compulsory=true +description=Choice of model for acclimation of photosynthesis +sort-key=Panel-I20a +trigger=namelist:jules_pftparm=ds_jmax_io: 0; + =namelist:jules_pftparm=ds_vcmax_io: 0; + =namelist:jules_vegetation=dsj_coef: this > 0; + =namelist:jules_vegetation=dsv_coef: this > 0; + =namelist:jules_vegetation=jv25_coef: this > 0; + =namelist:jules_vegetation=n_day_photo_acclim: 2, 3; +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::photo_acclim_model +value-titles=No acclimation, Thermal adaptation, Thermal acclimation, Thermal adaptation and acclimation +values=0,1,2,3 +widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget + +[namelist:jules_vegetation=photo_act_model] +compulsory=true +description=Choice of model for the activation energies of Jmax and Vcmax. +fail-if=namelist:jules_vegetation=photo_acclim_model == 0 and this != 1; +sort-key=Panel-I20b +trigger=namelist:jules_pftparm=act_jmax_io: 1; + =namelist:jules_pftparm=act_vcmax_io: 1; + =namelist:jules_vegetation=act_j_coef: 2; + =namelist:jules_vegetation=act_v_coef: 2; +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::photo_act_model +value-titles=Vary by PFT only, Vary by acclimation only +values=1,2 +widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget + +[namelist:jules_vegetation=photo_jv_model] +compulsory=true +description=Choice of model for the variation of J25:V25 +fail-if=namelist:jules_vegetation=photo_acclim_model == 0 and this != 1; +sort-key=Panel-I20c +trigger=namelist:jules_vegetation=n_alloc_jmax: 2; + =namelist:jules_vegetation=n_alloc_vcmax: 2; +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::photo_jv_model +value-titles=Jmax only, total N constant +values=1,2 +widget[rose-config-edit]=cylc8_compat.ComboBoxValueWidget + +[namelist:jules_vegetation=pow] +compulsory=true +description=Power in sigmodial function used to get competition coefficients +sort-key=Panel-I02b +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::pow + +[namelist:jules_vegetation=stanton_leaf] +compulsory=true +description=Leaf-level Stanton number +range=0:1 +sort-key=Panel-I09a1 +type=real +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::stanton_leaf + +[namelist:jules_vegetation=triffid_period] +compulsory=true +description=Update frequency for TRIFFID (days) +range=1:10000 +sort-key=Panel-I02a +type=integer +url=https://metoffice.github.io/jules/latest/namelists/jules_vegetation.nml.html#JULES_VEGETATION::triffid_period + +[namelist:jules_water_resources_props] +description=Configuration of spatially-varying water resource properties + =NOT AVAILABLE TO UM + =READ BY STANDALONE EXECUTABLES ONLY + =INCLUDED TO ALLOW TRIGGER LISTS TO BE SHARED +url=https://metoffice.github.io/jules/latest/namelists/ancillaries.nml.html#namelist-JULES_WATER_RESOURCES_PROPS + [namelist:urban_properties] description=Configuration of spatially varying urban properties =NOT AVAILABLE TO UM