Evp
- Dynamics
model
cryosphere
cice
CICE sea-ice dynamics (stage 2 of the EqESM project): the B-grid momentum balance and the classic-EVP stress evolution of the default kdyn = 1 (EVP) configuration of cesm3_cice6_6_3_22, lowered onto the traced 3x5 subdomain (N_I = 3 T cells along x, N_J = 5 along y) of the stage-1 dump with the EarthSciDiscretizations CICE B-grid rules (grids/cice_bgrid): strain_rates_divu/tension/shear lower D(uvel,x)+D(vvel,y), D(uvel,x)-D(vvel,y), D(uvel,y)+D(vvel,x) to the four-corner (NE/NW/SW/SE) staggered strain-rate combinations of strain_rates (ice_dyn_shared.F90:2094-2175), and stress_divergence_strintx/strinty lower D(sigma11,x)+D(sigma12,y) and D(sigma12,x)+D(sigma22,y) to the B-grid stress integrals strintx/strinty = uarear*(str1 - str2 + str3 - str4) of stepu (ice_dyn_evp.F90:1698-1765, 958-961). The Fortran integrates the momentum equation in stepu (ice_dyn_shared.F90:923-964) inside the ndte = 120 subcycles of evp (ice_dyn_evp.F90:259-1447), solving implicitly with the intermediates vrel = aiX*rhow*Cw*|u_ocn - u| (F90:931-932), taux/tauy = vrel*waterx/y with the cosw/sinw rotation of the ocean velocity (F90:817-818; the default cosw = 1, sinw = 0; the full coupled form is carried here as in dyn_finish, F90:1345-1348), Cb = TbU/(|u| + u0) (F90:937), cca = (brlx + revp)*Umassdti + vrel*cosw + Cb, ccb = fm + sign(1,fm)*vrel*sinw, ab2 = cca^2 + ccb^2, cc1/cc2 (F90:949-956) and the update uvel = (cca*cc1 + ccb*cc2)/ab2, vvel = (cca*cc2 - ccb*cc1)/ab2 (F90:958-959); the model writes the continuous limit m*du/dt = tau_a + tau_tilt + tau_o + div(sigma) - Cb*u + m*f*khat x u instead (the implicit-solve algebra cca/ccb/ab2/cc1/cc2 is solver machinery, documented here rather than transcribed). The stress evolution: the classic-EVP under-relaxed maps stressp_new = (stressp*(1-arlx1i*revp) + arlx1i*(zetax2*divu - rep_prs))*denom1 etc. (stress, ice_dyn_evp.F90:1584-1609) with arlx = 2*elasticDamp*ndte, arlx1i = 1/arlx, brlx = ndte, denom1 = 1/(1+arlx1i) for revised_evp = .false. (set_evp_parameters, ice_dyn_shared.F90:451-484), which relax toward the plastic targets zetax2*divu - rep_prs, etax2*tension, 0.5*etax2*shear with the subcycle time step dt/ndte, i.e. the continuous relaxation d(sigma)/dt = (sigma_target - sigma)/Td with Td = 2*elasticDamp*dt (elasticDamp = 0.36 default); here the four-corner staggered stresses stressp_1..4 of the Fortran are carried per corner on the corner axis, and the stressp/stressm/stress12 unknowns ARE the four-corner fields of the dump (newp/newm/new12 ksub1), so no corner collapse is needed. The strain rates of strain_rates are area-weighted (the Fortran comment 'NOTE these are actually strain rates * area (m^2/s)', F90:2119-2120), so divu/tension/shear/Delta carry units m^2/s and the viscosities zetax2 = (1+Ktens)*tmpcalc, etax2 = epp2i*zetax2 with tmpcalc = capping*strength/max(Delta, DminArea) + (1-capping)*strength/(Delta + DminArea) (visc_replpress, ice_dyn_shared.F90:2467-2471, DminArea = DminTarea = deltaminEVP*dxT*dyT) carry kg/(m^2 s); rep_prs = (1-Ktens)*tmpcalc*Delta (F90:2470) is N/m. The ice strength P is the run's kstrength = 1 Rothrock (1975) potential-energy form (icepack_ice_strength, icepack_mechred.F90:1660-1712, with the D-class krdg_partic = krdg_redist = 1 and mu_rdg = 4): the open-water fraction aice0 = 1 - aice, the cumulative distribution Gsum and its normalization (ridge_itd, F90:848-889), the exponential participation functions apartic(0..ncat) (F90:919-934), the exponential redistribution hrmin/hrexp/krdg (F90:1004-1010), aksum (F90:1031-1036) and strength = Cf*Cp*sum_n(apartic*dh2rdg)/aksum (F90:1697-1710), evaluated per T cell from the transported aicen/vicen and pinned against cice_ice_strength.csv at all 15 traced cells (rel 1e-12); the ridge redistribution itself (ridge_shift of area/volume/enthalpy between categories) remains outside this model. The ocean-ice stress magnitude uses the dump's aiX = 1 - exp(-Cb_ocn*(1-aice)) (the cap's aice_init-based concentration, ice_dyn_shared.F90:928-930; aiX is a dump parameter here, NOT derived from aicen -- the 4-cell U-point average misses up to 2.6e-3 of the cap value, see README.md). The coupled momentum + stress ODEs are integrated over one EVP subcycle (dte = 30 s) in the test cice_dynamics_evp_subcycle_integrated, with strairx/strairy recovered from the momentum dump's forcex/forcey, and the interior stresses asserted against the dumped subcycle update with per-assertion tolerances of 0.6x the dumped increment (scheme-difference tolerances: the model's continuous momentum ODE is not the Fortran's semi-implicit pseudo-time stepu, so the velocities are not asserted; the cap test cice_coupling.esm pins the stepu partials vrel*waterx/y). Import contract: the model declares the N_I/N_J/NCAT metaparameters and i/j/corner/ncat index sets locally (the esm CLI 0.4.0/0.6.0 rejects faq-range metaparameter references when a template library is imported with bindings -- RangeSpec round-trip parse bug of the esm CLI), and imports the five B-grid lowering rules by reference from the EarthSciDiscretizations library (${ESD_ROOT} must be set to that repo's checkout when running the tests). The free-name contract of grid.esm: the model supplies dxT, dyT, cxp, cyp, cxm, cym, dxhy, dyhx, HTE, HTN, uarear as its own [i,j] parameters (the pin test overrides them from the dump; the metric derivations and their F90:413-437, 682-703 citations live in grids/cice_bgrid/grid.esm).