C1 SNICAR-AD Shortwave Radiation for Sea Ice and Land Design Document

The Design Document page provides a description of the algorithms, implementation and planned testing including unit, verification, validation and performance testing. Please read  Step 1.3 Performance Expectations that explains feature documentation requirements from the performance group point of view. 

Design Document

 Click here for instructions to fill up the table below ......

The first table in Design Document gives overview of this document, from this info the Design Documents Overview page is automatically created.

In the overview table below 4.Equ means Equations and Algorithms, 5.Ver means Verification, 6.Perf - Performance, 7. Val - Validation

  • Equations: Document the equations that are being solved and describe algorithms
  • Verification Plans: Define tests that will be run to show that implementation is correct and robust. Involve unit tests to cover range of inputs as well as benchmarks.
  • Performance expectations: Explain the expected performance impact from this development
  • Validation Plans: Document what process-based, stand-alone component, and coupled model runs will be performed, and with what metrics will be used to assess validity

Use the symbols below (copy and paste) to indicate if the section is in progress or done or not started.

In the table below 4.Equ means Equations and Algorithms, 5.Ver means Verification, 6.Perf - Performance, 7. Val - Validation,   (tick) - competed, (warning) - in progress, (error) - not done


Overview table for the owner and an approver of this feature

1.Description

SNICAR-AD Shortwave Radiation for Sea Ice and Land

2.Owner

Cheng Dang (Unlicensed)
3.Created 
4.Equ(tick)
5.Ver(tick)
6.Perf(tick)
7.Val(tick)
8.Approver
9.Approved Date
V2.0Pending
 Click here for Table of Contents ...

Table of Contents




Title: SNICAR-AD Shortwave Radiation for Sea Ice and Land

Requirements and Design

E3SM Cryosphere Group

Date:  


Summary


The goal of this task is to remove the discrepancy of shortwave radiative transfer simulation for snowpacks on sea ice and on land in E3SM. We implement the radiative transfer scheme SNICAR-AD in the sea-ice component MPAS-seaice and the land component ELM for E3SM to predict consistent and improved shortwave radiative properties of snow-covered surfaces.


Requirements

ELM: modify the land shortwave code to include a subroutine that adopts the new radiative transfer algorithm.

MPAS-seaice: modify the sea-ice shortwave radiative transfer code to include a new subroutine that

  1. provides new input files for snow and ice optics adopted by ELM;
  2. expands the shortwave radiative calculation from three to five subdivided solar bands adopted by ELM;
  3. removes empirical adjustment for radiative-effective snow grain size;
  4. adopts a new algorithm to correct for the bias of near-infrared albedo and absorption when solar zenith angles are larger than 75 degrees.


Date last modified: Jun 1st, 2019 


Algorithmic Formulations

Design solution: described in the following article

Dang, C., Zender, C. S., and Flanner, M. G.: Inter-comparison and improvement of 2-stream shortwave radiative transfer models for a unified treatment of cryospheric surfaces in ESMs, The Cryosphere Discuss., https://doi.org/10.5194/tc-2019-22, in review, 2019.

Date last modified: July 1st, 2019
Contributors: Cheng Dang (Unlicensed) Charlie Zender Mark Flanner




Design and Implementation

Implementation: 

In the sea-ice and land shortwave code (ice_shortwace.F90, SnowSnicarMod.F90), we implemented SNICAR_AD that can be turned on/off by configuration toggles in the model namelists.

MPAS-source code: https://github.com/chengdang/MPAS-Model/tree/seaice/cdang_SnicarAD

ELM-source code: https://github.com/chengdang/E3SM/tree/chengdang/lnd/SNICAR_AD


Date last modified: July 1st, 2019

Contributors: Cheng Dang (Unlicensed)




Planned Verification and Unit Testing 

Verification and Unit Testing:

  • The offline radiative transfer model has been tested against a multi-stream benchmark model. (Dang, C., Zender, C. S., and Flanner, M. G.: Inter-comparison and improvement of 2-stream shortwave radiative transfer models for a unified treatment of cryospheric surfaces in ESMs, The Cryosphere Discuss., https://doi.org/10.5194/tc-2019-22, in review, 2019.)


Date last modified: July 1st, 2019

Contributors: Cheng Dang (Unlicensed)




Planned Validation Testing 

Validation Testing: 


Date last modified: July 1st, 2019
Contributors: Cheng Dang (Unlicensed)



Planned Performance Testing 

Performance Testing: 

The new implementation is not expected to have a significant impact on the computational cost/performance of E3SM.

Date last modified: July 1st, 2019

Contributors: Cheng Dang (Unlicensed)