Sea-Ice
- Control
model
cryosphere
cice
CICE sea-ice top-level component (stage 2 of the EqESM project): the cesm3_cice6_6_3_22 ice component as an esm 2.0.0 assembly, per the stage1/boundaries.md 1.3 boundary table. Five systems: IceCap (mounted from ./cice_coupling.esm, the med<->ice cap renames, the med2mod/mod2med areacor scaling, and the merge_fluxes export aggregation of ice_import_export.F90), Thermodynamics (./cice_thermodynamics.esm, the BL99 column physics: prep_radiation shortwave/albedo, step_therm1 vertical conduction and surface energy balance, step_therm2 growth/melt/ponds and the ocean heat/fresh/salt fluxes), Dynamics (./cice_dynamics.esm, the EVP momentum balance and stress relaxation of step_dyn_horiz), Transport (./cice_transport.esm, the per-category conservative advection of the area/volume/enthalpy/Tsfc states as a centered B-grid flux divergence -- the continuous flux form of the conservation law CICE integrates with incremental remapping, not the remap scheme itself), and the inline Control model, which is the ice_step orchestration (CICE_RunMod.F90:109-369 via ice_step_mod.F90) written as algebraic rate rules over one coupling period: the subcycling dt_dyn = dt/ndtd of the dynamics loop (CICE_RunMod.F90:271-281, ice_calendar dt_dyn), and the atmosphere boundary layer of the constant scheme (atmo_boundary_const, icepack_atmo.F90:398-496): wind = sqrt(uatm^2 + vatm^2) (prepare_forcing, ice_forcing.F90:1796), tau = rhoa*0.0012*wind with the components strairx = tau*uatm, strairy = tau*vatm (F90:460-464), shcoef = senscoef*cp_air*rhoa*wind (F90:493) and lhcoef = latncoef*Lsub*rhoa*wind (F90:494, Lheat = Lsub for ice F90:472-476). The coupling array wires the data flow with variable_map param_to_var entries in the ice_step order: the cap state fields (potT, Qa, rhoa, the four shortwave bands, flw, sst, sss, frzmlt, frain, fsnow, uocn, vocn, ss_tltx, ss_tlty) into Thermodynamics and Dynamics; the transport-owned mass states aicen/vicen/vsnon into Thermodynamics, Dynamics, and the cap aggregation; (the thermodynamics -> transport enthalpy hand-off, state_to_tracers, is an operator-splitting step the single-period assembly does not wire: Transport carries its own enthalpy-product states vqicen/vsqsnon); the dynamics-owned velocity uvel/vvel into Transport and the full ocean stress taux/tauy into the cap's Fioi_taux/tauy sign flip and the thermodynamics' ustar; and the per-category thermodynamics fluxes and albedos into the cap's export aggregation. Deferred to stage 3 (documented in the subcomponent descriptions and README.md): the Tsfc implicit surface-energy-balance solve (carried as a free parameter), the incremental-remap discretization of the transport PDEs (the lowered transport is a centered flux divergence without CICE's positivity/monotonicity guarantees), the ridge redistribution (the kstrength = 1 Rothrock strength itself is evaluated in Dynamics) and the kdyn/ktherm alternates, the similarity atmbndy scheme, the per-band Fioi_swpen_* fields, and the wave/aerosol/isotope exports. The shape-mismatched variable_map edges (3x5 dynamics/transport to the single-cell Thermodynamics/IceCap) carry faq full-map broadcast and single-cell select transforms (index of the traced cell (2,2) = global (3,5) inside a faq over ncat; the native compiler requires the full-rank index form), and the tests block pins the coupled assembly at the step-1 export-time state (17 assertions: the export-state chain through the coupling, the constant-scheme Control chain, and the broadcast ocean/tilt stress). The whole-coupling-period trace over [0, 3600] from the cold start remains a stage-3 concern. See README.md 'Testing'. Reference: stage1/cesm/components/cice/src/cicecore/drivers/nuopc/cmeps/.
- 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).
- IceCap
model
cryosphere
cice
CICE cap-boundary component (stage 2 of the EqESM project): the med<->ice field conversions and the export aggregation of ice_import_export.F90 (cesm3_cice6_6_3_22, cicecore/drivers/nuopc/cmeps/) as algebraic equations, per the stage1/boundaries.md 1.3 boundary table. Imports (med -> ice), exactly ice_import (F90:414-700): the ocean state So_t -> sst, So_s -> sss, So_u/So_v -> uocn/vocn, So_dhdx/So_dhdy -> ss_tltx/ss_tlty (F90:477-482, 610-624); the atmosphere state Sa_z -> zlvl, Sa_tbot -> Tair, Sa_shum -> Qa, Sa_u/Sa_v -> uatm/vatm (F90:487-501, 606-608); the potential-temperature branch Sa_ptem -> potT and Sa_dens -> rhoa when both are present, else the Sa_pbot branch potT = Tair*(100000/pbot)^0.286 and rhoa = pbot/(287.058*(1+0.608*Qa)*Tair) with the Fortran's zero/1.2 fallbacks (F90:503-515, 655-681); the flux imports Fioo_q -> frzmlt, Faxa_swvdr/swndr/swvdf/swndf -> swvdr/swidr/swvdf/swidf, Faxa_lwdn -> flw, Faxa_rain -> frain, Faxa_snow -> fsnow, each multiplied by med2mod_areacor (F90:529-575; frain stays kg/m2/s - the melt-pond volume change divides the water equivalent by rhofresh inside the pond law, icepack_meltpond_lvl.F90:158-160, and the ocean rain drain adds frain*aice, icepack_therm_itd.F90:2179). Exports (ice -> med), exactly ice_export (F90:1030-1317) and the merge_fluxes aggregation of icepack_flux.F90:180-260: the ice-fraction scaling ailohi = min(aice, 1) (F90:949) and the state fields Si_ifrac, Si_t = Tffresh + sum_n(Tsfc*aicen)/ailohi (F90:950-951; the trcr(:,nt_Tsfc) aggregate of icepack_aggregate), the merge_fluxes aggregations that scale_fluxes divides by the ice area aice (ice_flux.F90:1565-1592, so the coupled fields are per unit ice area) include Si_avsdr/anidr/avsdf/anidf = [sum_n(albedo*aicen)]/aice (the coupling_prep albedo aggregation, CICE_RunMod.F90:549-582; direct = diffuse under the ccsm3 shortwave scheme, icepack_shortwave.F90:568-572), Si_vice = sum_n vicen, Si_vsno = sum_n vsnon, Si_snowh = vsno/ailohi for ailohi > 0 (F90:1121-1129); the air-ice fluxes Faii_taux/tauy = strairxT/strairyT (the T-point atmo stress of the constant boundary-layer scheme, F90:962-964), Faii_lat/sen = [sum_n(flatn/fsensn*aicen)]/aice (icepack_flux.F90:204-206), Faii_lwup = [sum_n((flwoutn-(1-emissivity)*flw)*aicen)]/aice with the outgoing-longwave fix -stefan_boltzmann*(Tf+Tffresh)^4/ailohi where flwout > -puny (F90:213-215, 1149-1164), Faii_evap = [sum_n(evapn*aicen)]/aice, Faii_swnet = [sum_n(swabs*aicen)]/aice; and the ice-ocean fluxes Fioi_swpen = [sum_n(fswthru*aicen)]/aice (F90:247), Fioi_melth = [sum_n(fhocnn*aicen)]/aice, Fioi_meltw = [sum_n(freshn*aicen)]/aice, Fioi_salt = [sum_n(fsaltn*aicen)]/aice, Fioi_taux/tauy = -strocnxT/strocnyT (F90:966-968, the sign flip of the ice-into-ocean stress convention). All Faii_*/Fioi_* exports carry mod2med_areacor (state_setexport areacor, F90:1051-1317); the Si_* state exports do not. The wave (Si_thick, Si_floediam), aerosol (Fioi_bcpho/bcphi, Fioi_flxdst), isotope (Fioi_meltw_wiso, Faii_evap_wiso, Si_qref_wiso), and per-band penetration (Fioi_swpen_vdr/vdf/idr/idf) exports are deferred and carried as zero parameters; the reference-height exports Si_u10/Si_tref/Si_qref come from the transcribed similarity scheme (atmo_boundary_layer, icepack_atmo.F90:52-389): the atmbndy = 'default' similarity solve under the D-class natmiter = 5 and atmiter_conv = 0 (the do-while of F90:269 always runs 5 updates; unrolled here) with highfreq = .true. relative wind, and the merge_fluxes aicen_init weighting (icepack_flux.F90:180-260) divided by the post-thermo ice area in scale_fluxes (ice_flux.F90:1565-1592), so Si_tref = sum_n(Trefn*aicen_init)/sum_n(aicen) and likewise for Si_qref and Si_u10. The Rothrock ice strength (icepack_mechred.F90:1660-1712, kstrength = 1) is carried here as an algebraic probe of the dynamics physics, and the dynamics pointwise laws (the EVP stress maps, the strain invariant, the viscosities/replacement pressure, and the stepu ocean-ice stress) are carried here as dump-pinned probes as well, since the dynamics skeleton tests cannot compile on the single-cell geometry; the D-class ridge settings are krdg_partic = 1, krdg_redist = 1, mu_rdg = 4. The POP-grid rotation of tauxa/tauya/tauxo/tauyo (ANGLET, F90:962-968) and the tmask ocean-mask guards collapse to the identity on the single-cell skeleton and are documented in the descriptions. The Tf ocean freezing temperature is the import-side shr_frz_freezetemp law (share/shr_frz_mod.F90.in:94-105, the Assur-1958 liquidus clamped to >= -2 C; bugs.md #6) via the shared sea_freezing_temperature template. The tests block pins the imports, the freezing-temperature law, and the export aggregation (including the scale_fluxes /aice division) against the stage-1 dumps (stage1/dumps/cice/); see the test descriptions and README.md. Reference: stage1/cesm/components/cice/src/cicecore/drivers/nuopc/cmeps/ice_import_export.F90.
- Shortwave
model
cryosphere
cice
CICE delta-Eddington shortwave radiation (stage 2 of the EqESM project): compute_dEdd_3bd (icepack_shortwave.F90:1703-3013) and its per-layer solver solution_dEdd (F90:3022-3488), the 3-band radiation scheme of the CICE sea-ice column. The model is a transcription of the Fortran law: the dzk/frsnw layer geometry (F90:2132-2156, 2122-2125); the snow IOP interpolation against the SNICAR grain-radius tables (F90:2396-2424, icepack_shortwave_data.F90:116-232) and the snow mass extinction ks (F90:2422-2425); the per-layer tau/w0/g assembly over the snow-cover, bare-ice and pond branches including the bulk aerosol mixing (F90:2425-2547, 2562-2717, 2549-2557); the per-band ocean albedo (F90:2772-2775); the delta-Eddington layer solution with the 8-point Gauss-Legendre angular integration of the diffuse reflectivity/transmissivity and the fresnel (refraction) layer at the base of the surface scattering layer (solution_dEdd F90:3296-3406); the downward and upward layer-combination recurrences with the trmin activity cutoff (F90:3287, 3408-3466); the interface flux fractions dfdir/dfdif (F90:2804-2832); and the band-weighted accumulations avdr/avdf/aidr/aidf, fsfc/fint/fthru, the visible/NIR transmitted fluxes and the Sabs/Iabs/fthrul layer absorptions (F90:2834-2960). The surface type srftyp (0 = air/bare ice, 1 = snow, 2 = pond) is a scalar parameter; the pond branch is transcribed but untested (the instrumented run contains no pond rows - see README-cice-shortwave.md). The 8-point Gauss diffuse reflectivity is written as an explicit sum over the 8 abscissas rather than an esm integral: no ESD quadrature rule exists for a bare mu axis (integral reaches evaluation only when an EarthSciDiscretizations rewrite rule lowers it; probed on this branch). The Fortran's trmin guard skips the layer solution below the cutoff; here the full solution is computed and the outputs are masked with the same condition, which reproduces the Fortran bit-for-bit (the guard condition is a property of the full solution). All laws are imported by reference from ./cice_templates.esm; the numeric tuples are extracted from the stage-1 instrumentation dump stage1/dumps/cice/cice_dedd.csv by stage1/analysis/gen_cice_dedd_tests.py.
- Thermodynamics
model
cryosphere
cice
CICE column thermodynamics (stage 2 of the EqESM project): the per-category vertical heat conduction, surface energy balance, and growth/melt closures of the D-class run configuration of cesm3_cice6_6_3_22 (ktherm = 2 mushy, shortwave = 'dEdd', frzpnd = 'hlid' sea-level ponds, nilyr = 8, nslyr = 3, phi_i_mushy = 0.45, hs0 = 0.0, snwredist = 'none', use_smliq_pnd = .false., congel_freeze = 'one-step', saltflux_option = 'constant', tfrz_option = 'mushy', conduct = 'MU71', dpscale = 1e-3, vapor_flux_correction = .false.), written over the ncat thickness categories and the nilyr/nslyr layer axes. The Fortran state is the layer enthalpy (zqin, zqsn; icepack_therm_vertical.F90:1155-1156) with temperatures recovered by icepack_mushy_temperature_mush (icepack_mushy_physics.F90:348-452) for the ice and icepack_enthalpy_snow/temperature_snow (F90:145-179) for the snow; this model carries qicen/qsnon as states and recovers zTin/zTsn through the same laws. Heat conduction: the Fortran assembles and solves an implicit backward-Euler tridiagonal for the surface and layer temperatures (the mushy two-stage solver, icepack_therm_mushy.F90:1800-1985 with the kh conductances F90:1928-2061); this model writes the equivalent energy-conserving semi-discrete (method-of-lines) form d(q_k)/dt = (kh_up*(T_up - T_k) + kh_dn*(T_dn - T_k) + Iswabs_k)/hilyr with the interface conductances kh of the mushy conductance block (F90:1989-2061: kh_top = 2*kslyr/hslyr F90:2042, kh_snowice = 2*kslyr*kilyr(1)/(kslyr*hilyr + kilyr(1)*hslyr) F90:2046-2048, kh_bot = 2*kilyr(nilyr)/hilyr F90:2060, interior harmonic means F90:2052-2054) and the per-layer absorbed shortwave of the dEdd solver (Iswabs/Sswabs, deferred to the delta-Eddington rewrite, carried as parameters), i.e. the continuous PDE rho*cp*dT/dt = d/dz(k dT/dz) + S in enthalpy form; the layer conductivity is the mush law km = phi*(kb - ki) + ki of heat_conductivity (icepack_mushy_physics.F90:476-494; the ktherm = 1 MU71/bubbly laws remain as alternates in cice_templates.esm and are not used here). The surface temperature Tsfc is solved in the Fortran by the implicit surface energy balance fsurfn(Tsfc) - fcondtopn = 0 (the convergence checks fcondtop - fsurfn < ferrmax of the mushy two-stage solver, icepack_therm_mushy.F90:535/588/834/892, with fcondtop = 2*ks(1)*(Tsf - zTsn(1))/hslyr of F90:1674-1680 and the top-melt closure etop_mlt = max((fsurfn - fcondtopn)*dt, 0) of icepack_therm_vertical.F90:1337-1338; the downward-positive fcondtopn enters the surface heat budget as -fcondtopn, so the converged solve has fsurfn = fcondtopn); the balance is transcendental in Tsfc (the saturation-humidity exponential), so the skeleton carries Tsfc as a parameter fed by the coupled solve (stage-3 wiring). Growth/melt closures of thickness_changes (icepack_therm_vertical.F90): the melt enthalpies qmlt = enthalpy_of_melting(zSin) and qm = zqin - qmlt (F90:1283-1287), the congelation enthalpy qbot = qbotm - qbotw with qbotm = enthalpy_mush_liquid_fraction(Tbot, phi_i_mushy) and qbotw = enthalpy_brine(sst) under congel_freeze = 'one-step' (F90:1413-1416), the top/basal melt closures dhi = etop_mlt/qm(1) and ebot_mlt/qm(nilyr) (F90:1565-1581, 1589-1603), the snow/ice sublimation-condensation closures with qsub = zqsn(1) - rhos*Lvap over snow and qm(1) - rhoi*Lvap over ice (F90:1355-1403, 1502-1559), and the ocean heat flux fhocnn = fbot + (esub + etop_mlt + ebot_mlt)/dt + emlt_ocn/dt with emlt_ocn = -(qbotw*congeln + qmlt(1)*(melttn + evapin/rhoi) + qmlt(nilyr)*meltbn) (F90:1419, 1401, 1571, 1595, 1630, 1917; max(zqin, qmlt) = qmlt in the run regime since qm < 0 at melt). Radiation: the dEdd surface laws of icepack_shortwave.F90 - the snow fraction of shortwave_dEdd_set_snow (F90:3448-3454, hs0 = 0.0 so fs in {0,1}), the effective pond area of shortwave_dEdd_set_eff for tr_pond_sealvl (F90:3495-3637), the band albedos alvdrn/alidrn/alvdfn/alidfn (outputs of the deferred compute_dEdd_3bd solve, F90:1677-2936, carried as parameters), the component albedos albicen/albsnon/albpndn of F90:1496-1498 (the band-weighted sums of the awtvdr/awtidr/awtvdf/awtidf weights, icepack_parameters.F90:218-221; exact for the run's fs in {0,1} and apeffn = 0 surface-type masks), and the conservation fswintn = swabs - fswsfc - fswthrun with swabs = sum(sw*(1-al)) and fswthrun = sum of the four band transmissions. Melt ponds: the 'hlid' sea-level scheme of compute_ponds_sealvl (icepack_meltpond_sealvl.F90:50-265) with the Stefan lid growth/melt; dvn carries the per-step dvpondn and the pond tracers apnd/hpnd/ipnd/dhsn/ffracn are carried as parameters fed by the coupling (stage 3), with only the set_eff apeffn law pinned by tests. The surface-flux block (surface_heat_flux, icepack_therm_shared.F90:109-167; frzmlt_bottom_lateral, F90:637-678) is unchanged from the ktherm = 1 skeleton, with the run's emissivity = 0.95 (forcing_nml override, bugs.md #11). The ocean flux laws are the corrected rate forms of F90:510-521: freshn = -(rhoi*(congeln + meltbn + melttn) + rhos*meltsn) and fsaltn = -rhoi*dhi*ice_ref_salinity*0.001 with dhi = congeln + meltbn + melttn + evapin/rhoi (the evapn and new-snowfall terms of freshn = evapn - (rhoi*dhi + rhos*dhs) cancel exactly, F90:510-513, 1641-1672), the per-category snow thickness rate dsnown = fsnow/rhos - meltsn + evapsn/rhos, and the cell-level merged aggregates of icepack_flux.F90:196-257 (aice, fsurf, fcondtop, fhocn, fresh, fsalt, flwout, fsens, flat, evap, fswabs, fswthru, fswint, congel, meltb, meltt, melts, dsnow as sum_n(aicen*xn), with the flwout emissivity correction flwout = sum_n((flwoutn - 0.05*flw)*aicen) of F90:209-211 and the rain drainage fresh = fresh + frain*aice of icepack_therm_itd.F90:2043). The delta-Eddington solver (compute_dEdd_3bd, icepack_shortwave.F90:1677-3389) and the mushy enthalpy/T inversion pinning are deferred; see README.md for the coverage table.
- Transport
model
cryosphere
cice
CICE horizontal transport (stage 2 of the EqESM project): the per-category conservative advection of the area, volume and enthalpy/surface-temperature tracer states of the default 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, global cells (2..4, 4..8) of the stage-1 dump) with the EarthSciDiscretizations CICE B-grid flux-divergence rules (grids/cice_bgrid/rules/transport_flux_divergence.esm and its layered companion transport_flux_divergence_layered.esm). The conservative statement per category n is the continuity system d(aicen)/dt + div(aicen*u) = 0, d(vicen)/dt + div(vicen*u) = 0, d(vsnon)/dt + div(vsnon*u) = 0, plus the tracer-product forms the Fortran conserves (update_fields, ice_transport_remap.F90:3556-3571; tracer types of ice_init.F90:3061-3067): d(aTsfcn)/dt + div(aTsfcn*u) = 0 for the area tracer Tsfcn (trcr_depend = 0), d(vqicen)/dt + div(vqicen*u) = 0 for the volume tracer qicen over the 8 ice layers (trcr_depend = 1, vqicen = vicen*qicen), and d(vsqsnon)/dt + div(vsqsnon*u) = 0 for the snow-volume tracer qsnon over the 3 snow layers (trcr_depend = 2, vsqsnon = vsnon*qsnon). The tracers are recovered by tracer_from_product (cice_templates.esm): Tsfcn = aTsfcn/aicen, qicen_adv = vqicen/vicen, qsnon_adv = vsqsnon/vsnon, floored where the transported mass vanishes exactly as the Fortran's update_fields/tracers_to_state (0 for Tsfc and qice, -rhos*Lfresh for qsno; ice_transport_remap.F90:3631-3658, ice_transport_driver.F90:990-1114). Every divergence is the spatial-D rewrite target D(c*uvel, x) + D(c*vvel, y) (the tracer_flux_divergence template), lowered by the rule to the conservative cell flux divergence (F_e(i,j) - F_e(i-1,j) + F_n(i,j) - F_n(i,j-1))/tarea of the Fortran's mass update (ice_transport_remap.F90:3586-3590) with the CENTERED face reconstruction F_e = HTE*((uS+uN)/2)*((cL+cR)/2), F_n = HTN*((vW+vE)/2)*((cS+cN)/2); the layered rule applies the same stencil on the passive layer axis (imported twice, layer renamed to ice_layer / snow_layer with N_LAYER bound to N_ILYR / N_SLYR). THIS IS NOT CICE'S INCREMENTAL REMAPPING. The Fortran advects with the incremental-remapping scheme of Dukowicz & Baumgardner (2000) / Lipscomb & Hunke (2004) (horizontal_remap, ice_transport_remap.F90:317-831: limited linear reconstruction construct_fields F90:1009-1283, departure_points F90:1449-1623, departure-region integrals transport_integrals F90:3188-3472), which is upwind-biased, monotone for the tracers and positivity-preserving for the masses. The centered flux divergence here is the continuous flux form of the same conservation law: it is conservative but neither upwind nor limited, so it carries NO positivity or monotonicity guarantee -- an integration can drive aicen/vicen/vsnon negative or create tracer extrema near sharp ice edges, and the tracer recovery floors only the exactly-zero-mass case. No upwind or limited face rule exists for the cice_bgrid grid in EarthSciDiscretizations (the upwind/limiter rules there are for the 1-D Cartesian grids only), and incremental remapping itself is a stage-3 discretization (see README.md 'Transport scheme'). The integrated test cice_transport_centered_flux_35_integrated quantifies the scheme difference against the dump at a single interior cell (residuals ~10% of the transported change, tolerances rel 1e-4/1e-4/2e-4); the measured worst-case scheme residuals of the model against the dump t_exit over the whole traced domain are aicen 4.0e-4, vicen 3.7e-4, vsnon 4.8e-4, Tsfcn 2.2e-3, qicen 2.1e-4, qsnon 9.9e-6 relative (each above one tenth of the field's transported change, so the other tests pin the operator itself, not the trajectory: the uniform-field and divergence pins evaluate the lowered rule exactly, rel 1e-12, and the uniform-tracer preservation test checks the advection-consistency property of the product/recovery formulation). The velocity and grid fields are parameters overridden from the dumps in the tests: uvel/vvel are the transport dump's t_entr step-1 ncat-1 rows (the cell (i,j) row carries the U(i,j) NE-corner velocity = the post-dynamics field), HTE/HTN/tarea are derived from the stress-dump metrics (HTE = (3*cyp - cym)/4, HTN = (3*cxp - cxm)/4, tarea = dxT*dyT; ice_dyn_shared.F90:432-436). Import contract: the model declares the N_I/N_J/NCAT/N_ILYR/N_SLYR metaparameters and the i/j/ncat/ice_layer/snow_layer index sets locally (a workaround for the esm CLI RangeSpec round-trip bug with faq-range metaparameter references under template-import bindings), and imports the rules by reference from ${ESD_ROOT} (an EarthSciDiscretizations checkout at main, which carries both cice_bgrid transport rules since PR #50 / #59). Assembly: the recovered states are named qicen_adv/qsnon_adv because the esm CLI's initial-conditions shape check resolves an override key's trailing local name against the first declaring model, so a Transport state named qicen would shadow Thermodynamics.qicen in the cice.esm assembly test. The thermodynamics -> transport enthalpy hand-off (initializing vqicen = vicen*qicen from the post-thermodynamics state each step, the Fortran's state_to_tracers) is an operator-splitting sequencing step the single-period assembly cannot express, so cice.esm does not wire Thermodynamics.qicen/qsnon into this model; the tests set the product states by initial_conditions.