4.3. CESM and NorESM attributes

The following additional attributes are required for CESM model applications.

4.3.1. General

diro, logfile: Specifies the full pathname of the directory and filename of the directory and file name for mediator log output. For CESM this is determine in the attribute group MED_modelio that is generated by the CIME case control system.
flds_i2o_per_cat: if true, select per ice thickness category fields are passed to the ocean.

4.3.2. Toggle for active compoenents

ATM_model, GLC_model, ICE_model, LND_model, ROF_model, OCN_model, WAV_model: In CESM, stub components are still used. These attributes determine if the component is a stub component and sets the mediator present flag for that component to false.

4.3.3. Mediator Mapping file attributes

If a mapping file value is set to unset, then CMEPS will create an online route handle instead.

ice2atm_fmapname, ice2atm_smapname: ice -> atm fluxes and state mapping files
lnd2atm_fmapname, lnd2atm_smapname: land -> atm fluxes and state mapping files
ocn2atm_smapname, ocn2atm_fmapname: ocean -> atm fluxes and state mapping files
atm2lnd_fmapname, atm2lnd_smapname: atm -> land fluxes and state mapping files
atm2ice_fmapname, atm2ice_smapname, atm2ice_vmapname: atmosphere -> sea-ice fluxes, state, and velocities
atm2ocn_fmapname, atm2ocn_smapname, atm2ocn_vmapname: atmosphere -> ocean fluxes, state, and velocities
rof2lnd_fmapname: river -> land flux mapping file
glc2lnd_fmapname, glc2lnd_smapname: land-ice -> land fluxes and state mapping files
glc2ice_rmapname: “smoothed” land-ice -> sea-ice liquid mapping file
glc2ocn_liq_rmapname, glc2ocn_ice_rmapname: “smoothed” land-ice -> ocean liquid and ice mapping files
rof2ocn_liq_rmapname, rof2ocn_ice_rmapname: “smoothed” river -> ocean liquid and ice mapping file
wav2ocn_smapname: wave -> ocean state mapping file
lnd2rof_fmapname: land -> river flux mapping file
lnd2glc_fmapname, lnd2glc_smapname: land -> land-ice flux and state mapping file
atm2wav_smapname, ice2wav_smapname, ocn2wav_smapname: atmosphere -> wave, ice -> wave and ocean -> wave state mapping files
mapuv_with_cart3d: used for atm->ocn and atm-ice mapping of u and v if true, rotate u,v to 3d cartesian space, map from src->dest, then rotate back

4.3.4. Mediator ocean albedo attributes

The following are used by CMEPS to calculate ocean albedoes in used in med_phases_ocnalb_mod.F90

start_type

Determines if start type of the run. The currently supported values are startup, continue and branch.

orb_mode

orbital model setting configured. The supported values are:

fixed_year:  uses the orb_iyear and other orb inputs are ignored.  In
this mode, the orbital parameters are constant and based on the year.

variable_year: uses the orb_iyear and orb_iyear_align.  In this mode,
the orbital parameters vary as the model year advances and the model
year orb_iyear_align has the equivalent orbital year of orb_iyear.

fixed_parameters: uses the orb_eccen, orb_mvelp, and orb_obliq to set
the orbital parameters which then remain constant through the model integration

orb_iyear

year of orbit, used when orb_mode is fixed_year or variable_year

orb_iyear_align

model year associated with orb_iyear when orb_mode is variable_year

orb_obliq

obliquity of orbit in degrees, used when orb_mode is fixed_parameters

orb_eccen

eccentricity of orbit, used when orb_mode is fixed_parameters.

orb_mvelp

location of vernal equinox in longitude degrees, used when orb_mode is fixed_parameters

4.3.5. Mediator land-ice component attribtes

glc_renormalize_smb

Whether to renormalize the surface mass balance (smb) sent from lnd to glc so that the global integral on the glc grid agrees with the global integral on the lnd grid.

Unlike most fluxes, smb is remapped with bilinear rather than conservative mapping weights, so this option is needed for conservation. However, this can be turned off in non-fully-coupled configurations where conservation isn’t important (e.g., glc-only configurations - T compsets) to avoid the global correction that comes with this renormalization.

Allowable values are: on: do this renormalization

off: do not do this renormalization; note that this will break conservation so typically should not be used in fully-coupled cases

Only used if running with a GLC component.

glc_avg_period

Period at which coupler averages fields sent to GLC (the land-ice component). This supports doing the averaging to GLC less frequently than GLC is called (i.e., separating the averaging frequency from the calling frequency). This is useful because there are benefits to only averaging the GLC inputs as frequently as they are really needed (yearly for CISM), but GLC needs to still be called more frequently than that in order to support mid-year restarts. Setting glc_avg_period to ‘glc_coupling_period’ means that the averaging is done exactly when the GLC is called (governed by GLC_NCPL).

glc_cpl_dt

glc coupling interval in seconds