Add flag in cable.nml for coupled model

[penguian]

keyword_nml;_coupled;_flag;_cable_user_nogit owner:rml599@nci.org.au resolution_fixed type_defect | by lxs599

---

The flag cable_user%CABLE_RUNTIME_COUPLED is currently used in cable_soilsnow.F90. The flag is used to control the following aspects of soil moisture and snow initialisation. This code should only be executed once at the very beginning of a run when there is no proper restart file.

IF( .NOT.cable_user%CABLE_RUNTIME_COUPLED and ktau_gl <= 2 ) THEN

1) Snow depth on permanent ice points is set to max_glacier_snowd

2) Snow density is initialised at permanent ice points.

3) Soil moisture is set to 0.95 saturation value for permanent ice points.

4) Soil moisture at the lowest 3 levels is set to values close to field capacity for all other grids.

5) Soil ice is initialised where soil temperature is below freezing point.

The initialisation is conditional on ktau_gl. This counter increments across restarts in atmosphere only runs but is reset to 1 for coupled model restarts. Hence the flag should always be .true. for coupled model runs. For atmosphere only runs, the flag can be set .false. if initialisation is required or .true. for runs which use a start dump from a previous simulation.

The cable code should be changed to make .true. the default behaviour. This is in cable_common.F90, line 79.

The default behaviour in the UM is also updated in cable.nml in CABLE-AUX/UM. For offline applications this flag needs to be set to false in order to recover previous behaviour. Previously this flag was non-existent in cable.nml and the default value of false was picked up. Now this requires explicit setting in cable.nml. Updated examples cable.nml for both UM and offline apps are available in https://trac.nci.org.au/svn/cable/branches/Share/CABLE-AUX.

pushed to trunk finalized @ 2c9f4547aadec52496e543fcd196e475f44922ec

---

Issue migrated from trac:43 at 2023-11-27 11:08:26 +1100

[penguian]

@rml599@nci.org.au changed status from new to assigned

[penguian]

@rml599@nci.org.au changed owner from lxs599 to rml599

[penguian]

@rml599@nci.org.au edited the issue description

[penguian]

@rml599@nci.org.au edited the issue description

[penguian]

@jxs599@nci.org.au changed status from assigned to closed

[penguian]

@jxs599@nci.org.au changed resolution from ` tofixed`

[penguian]

@jxs599@nci.org.au edited the issue description

[penguian]

@jxs599@nci.org.au changed milestone from step 1 - validation to step 7 - finalised

[penguian]

@jxs599@nci.org.au edited the issue description

[penguian]

@ccc561@nci.org.au _changed keywords from nml; coupled; flag; cable_user to nml; coupled; flag; cable_user nogit_