Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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.

...

Page Properties
idFeature_PR
Info

Overview table for the owner and an approver of this feature

1.Description

Interactions with the surface models (soot and dust effects on ice albedo)
2.OwnerHailong Wang
3.Created
4.Equ(tick)
5.Ver(warning)
6.Perf(warning)
7.Val(warning)
8.ApproverPhil Rasch (pnl.gov)
9.Approved Date
V1.0Declined
Expand
titleClick here for Table of Contents ...
Panel

Table of Contents

Table of Contents

...

The objective of this task is to improve the compatibility between MAM aerosols (in the atmospheric component) and treatment of light-absorbing particles deposited to snow and sea ice (in land and sea ice components), to fix recently identified bugs in calculating snow grain sizes in the released CLM (in ALM as well), and to provide new input files for snow and ice optics are needed for running the model. 

Requirements

  1. modify the atmospheric aerosol deposition code to separately treat BC mixed internally within hydrometeors and externally to hydrometeors, and to partition dust into four size bins instead of two

  2. modify the SNICAR code to take size-dependent BC optical properties (i.e., depending on snow grain size and BC particle size) and provide a new lookup table for the optical properties

  3. modify the code in ALM for calculating snow grain size to fix an identified bug

  4. Do the same to the sea ice component to take new size-dependent BC optical properties    

Date last modified:  
 

Contributors: Hailong Wang
 (add your name to this list if it does not appear)

 

Algorithmic Formulations

Design solution: described in the following articles:


Flanner, M. G., Liu, X., Zhou, C., Penner, J. E., and Jiao, C.: Enhanced solar energy absorption by internally-mixed black carbon in snow grains, Atmos. Chem. Phys., 12, 4699-4721, doi:10.5194/acp-12-4699-2012, 2012.
Liu, X., Easter, R. C., Ghan, S. J., Zaveri, R., Rasch, P., Shi, X., Lamarque, J.-F., Gettelman, A., Morrison, H., Vitt, F., Conley, A., Park, S., Neale, R., Hannay, C., Ekman, A. M. L., Hess, P., Mahowald, N., Collins, W., Iacono, M. J., Bretherton, C. S., Flanner, M. G., and Mitchell, D.: Toward a minimal representation of aerosols in climate models: description and evaluation in the Community Atmosphere Model CAM5, Geosci. Model Dev., 5, 709-739, doi:10.5194/gmd-5-709-2012, 2012.

 

Date last modified: 

Contributors: @Hailong Wang, Mark Flanner 

 

Design and Implementation

Implementation:

Will follow an initial implementation to a developer version of CESM by Mark Flanner.

Date last modified:  

Contributors: Hailong Wang (add your name to this list if it does not appear)

 

 

Planned Verification and Unit Testing 

Verification and Unit Testing:

Will evaluate the results of our new implementation against those in Flanner et al. (2012). 

Date last modified:  
Contributors: Hailong WangYun Qian, Mark Flanner (add your name to this list if it does not appear)

 

How will XXX be tested? i.e. how will be we know when we have met requirement XXX. Will these unit tests be included in the ongoing going forward?

Planned Validation Testing 

Validation Testing: short-desciption-of-testing-here

Date last modified:
Contributors: (add your name to this list if it does not appear)

 

How will XXX be tested? What observational or other dataset will be used?  i.e. how will be we know when we have met requirement XXX. Will these unit tests be included in the ongoing going forward?

Planned Performance Testing 

Performance Testing: short-desciption-of-testing-here

Date last modified:
Contributors: (add your name to this list if it does not appear)

 

How will XXX be tested? i.e. how will be we know when we have met requirement XXX. Will these unit tests be included in the ongoing going forward?

 

...