Skip to content

Add temperature/snow-dependent sea ice albedo#163

Open
simone-silvestri wants to merge 15 commits intomainfrom
ss/sea-ice-albedo
Open

Add temperature/snow-dependent sea ice albedo#163
simone-silvestri wants to merge 15 commits intomainfrom
ss/sea-ice-albedo

Conversation

@simone-silvestri
Copy link
Copy Markdown
Member

@simone-silvestri simone-silvestri commented Apr 15, 2026

Summary

Add a state-dependent sea ice albedo parameterization following the CCSM3 scheme
(Briegleb et al. 2004; Briegleb & Light 2007), replacing the default constant albedo.
The SeaIceAlbedo struct stores references to sea ice model fields and is evaluated
pointwise via stateindex inside the atmosphere--sea-ice flux kernel.

Also adds Adapt.adapt_structure for InterfaceProperties so that nested structs
containing GPU field references (like SeaIceAlbedo) are properly adapted when
passed to GPU kernels.

Algorithm

The broadband albedo is computed in four steps:

1. Temperature-dependent melt reduction

Near the melting point, albedo is reduced to represent implicit melt-pond formation:

fT = clamp((Ts - Tm + ΔT) / ΔT, 0, 1)

αi = αi_cold - Δαi * fT
αs = αs_cold - Δαs * fT

where αi_cold = 0.54, αs_cold = 0.83, Δαi = 0.075, Δαs = 0.10, and ΔT = 1 K.

2. Thin-ice transition to ocean albedo

For ice thinner than h_min = 0.5 m, the bare-ice albedo blends toward ocean albedo αo = 0.06:

fh = clamp(hi / h_min, 0, 1)

αi = αo + (αi - αo) * fh

3. Snow cover blending

Snow depth interpolates between bare-ice and snow albedo, reaching full snow cover at hs_min = 0.02 m:

fs = clamp(hs / hs_min, 0, 1)

4. Final albedo

α = fs * αs + (1 - fs) * αi

Default parameters

Parameter Default Source
Cold ice albedo αi_cold 0.54 0.52 × 0.73 + 0.48 × 0.33 (vis + nir weighted)
Cold snow albedo αs_cold 0.83 0.52 × 0.96 + 0.48 × 0.68
Ice melt reduction Δαi 0.075 Briegleb et al. (2004)
Snow melt reduction Δαs 0.10 Briegleb et al. (2004)
Melting temperature Tm 0 °C
Temperature range ΔT 1 K
Ocean albedo αo 0.06
Min ice thickness h_min 0.5 m
Min snow depth hs_min 0.02 m

Changes

  • New file: sea_ice_albedo.jlSeaIceAlbedo struct, constructor, stateindex, Adapt.adapt_structure
  • InterfaceComputations.jl — export SeaIceAlbedo, include sea_ice_albedo.jl
  • interface_states.jlAdapt.adapt_structure for InterfaceProperties
  • atmosphere_sea_ice_fluxes.jl — evaluate radiation properties via stateindex before the similarity-theory iteration; pass local_interface_properties with scalar albedo/emissivity

References

  • Briegleb, B.P., C.M. Bitz, E.C. Hunke, W.H. Lipscomb, and M.M. Schramm (2004):
    Scientific description of the sea ice component in CCSM3. NCAR Tech Note NCAR/TN-463+STR.
  • Briegleb, B.P. and B. Light (2007): NCAR/TN-472+STR.

Tests

test/test_sea_ice_albedo.jl — 8 test sets:

  • Constructor (Float64/Float32)
  • Nothing snow thickness
  • Cold thick ice, no snow → α = 0.54
  • Cold thick ice, deep snow → α = 0.83
  • Melting ice, no snow → α = 0.465
  • Zero ice → ocean albedo α = 0.06
  • Partial snow cover → weighted blend
  • Adapt.adapt_structure for SeaIceAlbedo and InterfaceProperties

- Bathymetry: minor fix in regrid_bathymetry
- DataWrangling: inpainting and restoring improvements
- Diagnostics: MLD minor update
- EarthSystemModels: simplify time stepping, minor earth_system_model cleanup
- InterfaceComputations: minor refactors in sea_ice_ocean fluxes and heat flux formulations

Note: Ocean simulation refactoring (flux_and_restoring, Oceans.jl, ocean_simulation.jl)
and Diagnostics (interface_fluxes) are handled in PR #155 and #158.
- Bathymetry: minor fix in regrid_bathymetry
- DataWrangling: inpainting and restoring improvements
- Diagnostics: interface flux diagnostics and MLD updates
- Oceans: refactor ocean simulation, extract flux_and_restoring
- EarthSystemModels: simplify time stepping, minor earth_system_model cleanup
- InterfaceComputations: minor refactors in sea_ice_ocean fluxes and heat flux formulations
New type SeaIceAlbedo implementing the CCSM3 albedo parameterization
(Briegleb et al. 2004):
- Broadband albedos: bare ice 0.54, snow-covered 0.83
- Temperature-dependent reduction near melting (implicit melt ponds)
- Thin-ice transition to ocean albedo below 0.5 m
- Snow cover blending (full snow albedo at hs > 0.02 m)
- Handles nothing snow_thickness gracefully

Also evaluates state-dependent albedo to scalar via stateindex at
the top of the atmosphere-sea ice flux kernel, fixing a potential
struct-in-arithmetic bug when the albedo is not a plain number.

Changes to atmosphere_sea_ice_fluxes.jl:
- Evaluate radiation properties (α, ϵ) via stateindex before iteration
- Pass local_interface_properties with scalar values to compute_interface_state
- Add hs (snow thickness) to local_interior_state
- Rename h → hi for ice thickness in interior state

References:
- Briegleb et al. (2004): NCAR Tech Note
- Briegleb & Light (2007): NCAR/TN-472+STR
simone-silvestri and others added 2 commits April 15, 2026 14:31
- Add Adapt.adapt_structure for InterfaceProperties so that
  SeaIceAlbedo Fields are properly adapted for GPU kernels
- Fix get_snow_thickness call to pass grid argument

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
simone-silvestri added a commit that referenced this pull request Apr 15, 2026
Strip out changes that belong to other PRs or branches:
- FluxAndRestoring struct and plumbing (separate PR)
- Bottom drag rework (drag_bulk_velocity, Uᴮ)
- Barotropic potential toggle, clock kwarg, materialize_buoyancy_gradients
- TKE advection change, meridional heat transport deletion
- Bathymetry minimum depth, inpainting NaN fill, restoring extract_field_time_series
- Sea ice albedo (CCSM3 scheme) and Adapt for InterfaceProperties (PR #163)
- ocean_surface_salinity/temperature view change

Keep only snow model integration: snow thermodynamics, snowfall routing,
IceSnowConductiveFlux flux balance, hs in exchanger and interior state.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
simone-silvestri and others added 2 commits April 15, 2026 15:12
Strip out changes that belong to other PRs: FluxAndRestoring, bottom drag
rework, barotropic potential toggle, meridional heat transport deletion,
bathymetry/inpainting/restoring changes, NCAR bulk flux includes/exports,
snow-specific h→hi rename and hs additions.

Keep only sea ice albedo: SeaIceAlbedo struct, stateindex evaluation in
atmosphere-sea-ice kernel, Adapt for InterfaceProperties, export/include.

Add test_sea_ice_albedo.jl covering: constructor, cold/melting ice,
thin ice→ocean transition, snow cover blending, nothing snow thickness,
Adapt.adapt_structure for both SeaIceAlbedo and InterfaceProperties.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@simone-silvestri simone-silvestri changed the base branch from ss/patch-1 to main April 15, 2026 13:13
@codecov
Copy link
Copy Markdown

codecov Bot commented Apr 15, 2026

Codecov Report

❌ Patch coverage is 82.75862% with 5 lines in your changes missing coverage. Please review.

Files with missing lines Patch % Lines
...stemModels/InterfaceComputations/sea_ice_albedo.jl 81.81% 4 Missing ⚠️
...InterfaceComputations/atmosphere_sea_ice_fluxes.jl 83.33% 1 Missing ⚠️

📢 Thoughts on this report? Let us know!

@simone-silvestri simone-silvestri requested a review from jagoosw May 1, 2026 10:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant