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. 

Design Document

Expand
titleClick 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.

...

Page Properties
idFeature_PR


Info

Overview table for the owner and an approver of this feature

1.Description

Corrects inadequacies in sea ice nitrogen dynamics
2.OwnerNicole Jeffery
3.Created08/26/2019
4.Equ(tick)
5.Ver(tick)
6.Perf(warning)
7.Val(warning)
8.ApproverKatherine Calvin (Unlicensed)
9.Approved Date 




Expand
titleClick here for Table of Contents ...


Panel

Table of Contents

Table of Contents




Title: Improved nitrogen cycling in sea ice

Requirements and Design

E3SM Sea Ice  Group

Date:Aug 26, 2019 

Summary

The E3SMv1.1 CBGC simulations of sea ice biogeochemistry (BGC) drastically underestimate ice algal primary production in the Arctic.  This is in large part due to biases in the upper ocean nitrate pool.  However, sea ice algal primary production is also underestimated in the Southern Ocean, albeit not as drastically,  where surface nutrients do not play a role.  This suggests insufficiencies in our modelled biochemical interactions. Several studies (Fripiat et al. 2013, New insights into sea ice nitrogen biogeochemical dynamics from the nitrogen isotopes papers; Baer et al. 2015, Nitrogen uptake dynamics in landfast sea ice of the Chukchi Sea) point to dissolved organic nitrogen (DON) remineralization and nitrate production from nitrification as important nutrient sources for algal production.  These sources are important for two reasons.  First, DON is found in high concentrations in the polar oceans and, unlike nitrate, DON adsorbs to the ice crystals during sea ice growth and so can accumulate to high concentrations in the sea ice. Remineralization of DON produces ammonium which is readily taken up by ice algae, in fact, preferentially to nitrate.   Thus DON remineralization to ammonium provides a new and abundant source of nitrogen for ice algae that will almost surely mitigate our production biases.   Second, nitrate produced from nitrification is distinct from the ocean source of nitrate because it is trapped in a biofilm which adsorbs to ice crystals (Deman et al. 2019, High production going along with respiration, Impact of bio-film formation for sea ice biogeochemistry, IGS Sea Ice Symposium). This process allows for build-up of nitrate in the sea ice brine, a feature observed in sea ice cores (Baer et al., 2015; Duarte et al., 2017 Sea ice thermohaline dynamics and biogeochemistry in the Arctic Ocean: Empirical and model results)  but that is virtually impossible in our current model design.

...

The majority of code changes will involve a the MPAS-SI column package and the ice_algae.F90 subroutine.  Enabling of DIC will require and additional parameter in Registry, a new namelist parameter and some small changes to the mpassi interface.  Implementation and tuning will require updates to the default values in namelist mpassi_in.  It is expected that these changes will conserve carbon, at least in the reaction equations, and  increase ice algal primary production (reduce biases) in both polar regions, though we still expect underestimations in the Arctic.

Requirements


Requirement: Add remineralization and nitrification fluxes to sea ice biogeochemical reactions.

Date last modified: Aug 27, 2019
Contributors: Nicole Jeffery


Currently, dissolved organic nitrogen (DON), ammonium (NH4), nitrate (NO3), and algal nitrogen (N) are the four fundamental pools in the sea ice nitrogen cycle.  They satisfy coupled non-linear advection-diffusion-reaction equations.  As modelled, this cycle is not closed, though losses are tracked in a diagnostic zooplankton pool (ZOO). With conservation in mind, we will modify the DON equation source terms so that together with ammonium sources they balance nitrogen losses from algae during grazing and mortality.  We will then add a source term to the NH4 equation that can be made equivalent (via a parameter, fdon) to the remineralization loss term already present in the DON equation. Finally, we will change namelist parameters to turn on nitrification at observed rates. 

This development will be first tested algebraically to show conservation of nitrogen. In addition, the ZOO diagnostic will be used to print an error message if nitrogen is not conserved in the reaction terms.  We can test this in short stand alone MPAS-SI runs similar to the standard-bgc testsuite.

Requirement: Add adsorption of nitrate produced from nitrification

Date last modified: Aug 27, 2019
Contributors: Nicole Jeffery

Nitrate tracers are currently purely mobile.  This means that they never adhere to the ice crystals and cannot build up in the brine in significant excess of the ocean concentration.  Tracers that adhere, such as DON, move between the mobile and stationary phases via prescribed timescales with the condition that the mobile to stationary transformation occurs only during sea ice growth and the stationary to mobile transformation occurs during sea ice melt.  In the case of nitrate, we first must define a stationary fraction of nitrate equal to the nitrification source term.  Secondly, we need to implement the latter transformation, stationary to mobile,  while preventing mobile to stationary transformations.

With the nitrification parameter set to 0, the code should be identical up to round off error in the biogeochemical tracers.  With nitrification at observed values, we expect to see higher nitrate concentrations in some polar sea ice, but no unphysical accumulations.  This can be tested by activating a warning flag already implemented that will indicate higher than expected concentrations of BGC tracers.

Requirement: Enable DIC (dissolved inorganic carbon)

Date last modified: Sept 13, 2019
Contributors: Nicole Jeffery

The dissolved inorganic carbon tracer was partially implemented in v1.  In particularly, DIC is already coupled to MPAS-O, the tracer transport is enabled with a config_use_carbon namelist option, default dimensions already exist in Registry and are set to appropriate values.  However, the parameter config_mobility_type_inorganic_carbon needs to be added in Registry and the namelist to ensure that the correct transport physics treatment is used.  As an initial test, we will treat DIC in the same manner as DOC, an initially mobile tracer that strongly adsorbs to the ice matrix (config_mobility_type_inorganic_carbon = 0.0) . 

Reaction source and sink terms for DIC are straight forward, following the nitrogen cycle.

Algorithmic Formulations

Design solution: modify the reaction terms in the NH4 and DON equations

Date last modified:Aug 27, 2019
Contributors: Nicole Jeffery


  1. Requirement: Add remineralization and nitrification fluxes to sea ice biogeochemical reactions.

...

     DIC_s = DIC_s + DOC_r(n).   

end do

Design and Implementation

See seaice/njeffery_zbgcNMods

Implementation: Improvements to nitrogen cycling reaction terms

Date last modified: Sept 10, 2019
Contributors: Nicole Jeffery


In the subroutine algal_dyn (column/ice_zbgc.F90) add source terms from zooplankton grazing:

...

Save the nitrification source of Nitrate for adsorption to ice crystals:

nitrification = Nit_s_n

Implementation: Adsorption of nitrification source of nitrate to ice crystals

Date last modified: Sept 10, 2019
Contributors: Nicole Jeffery


Redefine the stationary (adsorbed) concentration of a tracer to allow for nitrified nitrate:

...

 if (sum_tot > c0) trcrn(nt_zbgc_frac+m-1) = sum_new/sum_tot

end if

enddo

Implementation: Enable DIC

Date last modified: Sept 13, 2019
Contributors: Nicole Jeffery

The most challenging aspect here is to conserve both carbon and nitrogen. There are additional organic carbon pools that can track  material that is not in the DON (protein) pool.  Here we redefine the DOC source terms as differences between the total carbon grazed or from algal mortality and subtract the contribution that fluxed to the DON pool (in carbon units).   For n = 1,2

...

We will also add two variables (dC and dN) to sum the total changes in carbon and nitrogen in each grid level and timestep. These values should sum to zero up to round off error.

Planned Verification and Unit Testing 

Verification and Unit Testing: Run standard tests (bgc and physics)

Date last modified: Sept 10, 2019
Contributors: (Nicole JefferyAdrian Turner)

seaice/njeffery_zbgcNMods will be tested to check for BFB in standard_physics test suite  and the snow_tracer_physics test suite which include regression tests with seaice/develop master, parallelism and restartability tests.

...

Update: These tests were completed on Sept 17, 2019.  All tests were BFB except the regression standard_bgc and regression aerosol_shortwave.  In the latter, verticalAerosolConc and mobileFraction tracers  differed only to round off.   Conservation tests for nitrogen and carbon reaction kinetics passed.  PR to seaice/develop is submitted https://github.com/MPAS-Dev/MPAS-Model/pull/369. These tests will be performed by Adrian Turner before the PR is accepted.

Planned Validation Testing 

Validation Testing: GCASE tests with ocean-ice bgc

Date last modified: Sept 10, 2019
Contributors: (Nicole Jeffery)

We wil also run three tests:

...

We are looking for increases in total sea ice primary production (PP) in both the Arctic and Southern ocean regions particularly in test 1 compared with test 3.  We will not tune further at this stage until all the physics and bgc code improvements are in.  Current model versions underestimate total PP in both poles.  We should also see increases in maximum and average sea ice nitrate concentrations but values should not build up unphysically.  There is some data which shows a 1-10x increase in sea ice nitrate relative to the ocean values in some locations.


Planned Performance Testing 

Performance Testing: Compare performance of GCASE runs

Date last modified: Sept 10, 2019
Contributors: (Nicole Jeffery)


Compare years per day of 1 and 3 (on anvil).  We don't expect to see any degradation of performance.

...