Difference between revisions of "UKCA Chemistry and Aerosol vn10.9 Tutorial 8"

From UKCA
 
(14 intermediate revisions by the same user not shown)
Line 1: Line 1:
[[UKCA Chemistry and Aerosol Tutorials at vn10.9+]]
+
[[UKCA Chemistry and Aerosol Tutorials at vn10.9]]
   
 
==What you will learn in this Tutorial==
 
==What you will learn in this Tutorial==
Line 9: Line 9:
 
<span style="color:green">'''Task 8.1:''' Add in wet deposition for '''BOB''', using the following values:</span>
 
<span style="color:green">'''Task 8.1:''' Add in wet deposition for '''BOB''', using the following values:</span>
   
{| border="1"
+
{| class="wikitable" border = "1px"
  +
!style="text-align:top;"|<math>\ k(298)\ </math>
! <math>\ k(298)\ </math> || <math>\ -\left({\Delta H}/R\right)\ </math> || <math>\ k(298)</math> for the 1st dissociation || <math>\ -\left({\Delta H}/R\right)</math> for the 1st dissociation || <math>\ k(298)</math> for the 2nd dissociation || <math>\ -\left({\Delta H}/R\right)</math> for the 2nd dissociation
 
  +
!style="text-align:top;"| <math>\ -\left({\Delta H}/R\right)\ </math>
  +
!style="text-align:top;"| <math>\ k(298)</math> for the 1st dissociation
  +
!style="text-align:top;"| <math>\ -\left({\Delta H}/R\right)</math> for the 1st dissociation
  +
!style="text-align:top;"| <math>\ k(298)</math> for the 2nd dissociation
  +
!style="text-align:top;"| <math>\ -\left({\Delta H}/R\right)</math> for the 2nd dissociation
 
|-
 
|-
 
| <math>\ 0.21 \times 10^{+06}\ </math> || <math>\ 0.87 \times 10^{+04}\ </math> || <math>\ 0.2 \times 10^{+02}\ </math> || <math>\ 0.0\ </math> || <math>\ 0.0\ </math> || <math>\ 0.0\ </math>
 
| <math>\ 0.21 \times 10^{+06}\ </math> || <math>\ 0.87 \times 10^{+04}\ </math> || <math>\ 0.2 \times 10^{+02}\ </math> || <math>\ 0.0\ </math> || <math>\ 0.0\ </math> || <math>\ 0.0\ </math>
Line 34: Line 39:
 
===Chemistry Scheme Specification===
 
===Chemistry Scheme Specification===
   
Within the UKCA code, whether a species is wet deposited or not is controlled in the '''ukca_chem_<span style="color:blue">scheme</span>.F90''' file. In the '''chch_defs_<span style="color:blue">scheme</span>''' array there are lines like
+
Within the UKCA code, whether a species is wet deposited or not is controlled in the '''<code>ukca_chem_master.F90</code>''' module. In the '''<code>chch_defs_master</code>''' array there are lines like
   
  +
! 10 DD: 7,WD: 4,
chch_t( 10,'HONO2 ', 1,'TR ',' ', 1, <span style="color:red">'''1'''</span>, 0), & ! 10 DD: 7,WD: 4,
 
chch_t( 11,'H2O2 ', 1,'TR ',' ', 1, <span style="color:red">'''1'''</span>, 0), & ! 11 DD: 8,WD: 5,
+
chch_t1(10,'HONO2 ',1,'TR ',' ',1,<span style="color:red">'''1'''</span>,0,TI+S+T+ST+R,0,0,107),&
  +
! 11 DD: 8,WD: 5,
 
chch_t1(11,'H2O2 ',1,'TR ',' ',1,<span style="color:red">'''1'''</span>,0,TI+S+T+ST+OL+R,0,0,&
  +
107),&
   
 
Where the <span style="color:red">'''1'''</span> in the 7th column turns on wet deposition of that species (being 0 otherwise). You will need to change the 0 to a '''1''' for the species that you wish to now wet deposit.
 
Where the <span style="color:red">'''1'''</span> in the 7th column turns on wet deposition of that species (being 0 otherwise). You will need to change the 0 to a '''1''' for the species that you wish to now wet deposit.
Line 43: Line 51:
 
===Setting Henry's Law values===
 
===Setting Henry's Law values===
   
In the '''ukca_chem_<span style="color:blue">scheme</span>.F90''' the parameters required to calculate <math>H_{eff}</math> are held in the '''henry_defs_<span style="color:blue">scheme</span>''' array, and has format
+
In the '''<code>ukca_chem_master.F90</code>''' module the parameters required to calculate <math>H_{eff}</math> are held in the '''<code>henry_defs_master</code>''' array (of defined size '''<code>n_wet_master</code>'''), and has format
   
{| border="1"
+
{| class="wikitable" border = "1px"
  +
| '''<code>N</code>''' || '''<code><span style="color:red">'SPECIES&nbsp;&nbsp;&nbsp;'</span></code>'''
  +
|-
 
| <math>\ k(298)\ </math> || <math>\ -\left({\Delta H}/R\right)\ </math> || <math>\ k(298)</math> for the 1st dissociation || <math>\ -\left({\Delta H}/R\right)</math> for the 1st dissociation || <math>\ k(298)</math> for the 2nd dissociation || <math>\ -\left({\Delta H}/R\right)</math> for the 2nd dissociation
 
| <math>\ k(298)\ </math> || <math>\ -\left({\Delta H}/R\right)\ </math> || <math>\ k(298)</math> for the 1st dissociation || <math>\ -\left({\Delta H}/R\right)</math> for the 1st dissociation || <math>\ k(298)</math> for the 2nd dissociation || <math>\ -\left({\Delta H}/R\right)</math> for the 2nd dissociation
  +
|-
  +
| '''<code><span style="color:red">SCHEME</span></code>''' || '''<code><span style="color:green">QUALIFIER</span></code>''' || '''<code><span style="color:blue">DISQUALIFIER</span></code>''' || '''<code>VN</code>'''
 
|}
 
|}
   
Line 63: Line 75:
 
and column 3 contains the values of <math>k(298)</math> and column 4 contains the value of <math>-{\Delta H}/R</math>. Similarly, if the species dissociates a second time then a further factor of <math>1+k(aq)/H^{+}</math> is applied, where this value of <math>k(aq)</math> is calculated from the values of <math>k(298)</math> and <math>-{\Delta H}/R</math> in columns 5 and 6.
 
and column 3 contains the values of <math>k(298)</math> and column 4 contains the value of <math>-{\Delta H}/R</math>. Similarly, if the species dissociates a second time then a further factor of <math>1+k(aq)/H^{+}</math> is applied, where this value of <math>k(aq)</math> is calculated from the values of <math>k(298)</math> and <math>-{\Delta H}/R</math> in columns 5 and 6.
   
'''Note:''' As with the 2D dry deposition values in '''depvel_defs_<span style="color:blue">scheme</span>''', the order of '''henry_defs_<span style="color:blue">scheme</span>''' also assumes that the values are in the same order as the species (that wet deposit) in the '''chch_defs_<span style="color:blue">scheme</span>''' array.
+
'''Note:''' As with the 2D dry deposition values in '''<code>depvel_defs_master</code>''', the order of '''<code>henry_defs_master</code>''' also assumes that the values are in the same order as the species (that wet deposit) in the '''<code>chch_defs_master</code>''' array.
   
 
Examples for this array are
 
Examples for this array are
   
  +
! 4
0.2100E+06, 0.8700E+04, 0.2000E+02, 0.0000E+00, 0.0000E+00, 0.0000E+00,& ! 4 HONO2
 
  +
wetdep(4,'HONO2 ',&
0.8300E+05, 0.7400E+04, 0.2400E-11,-0.3730E+04, 0.0000E+00, 0.0000E+00,& ! 5 H2O2
 
  +
(/0.21e+06,0.87e+04,0.20e+02,0.00e+00,0.00e+00,0.00e+00/),TI+T+ST+R,0,0,107),&
 
  +
wetdep(4,'HONO2 ',&
===Increase the value of JPDW===
 
  +
(/0.21e+06,0.87e+04,0.157e+02,0.00e+00,0.00e+00,0.00e+00/),S,0,0,107),&
 
  +
! 5
Similar to when adding dry deposition of a species you will need to increase the size of the '''JPDW''' counter. This is done in the <code>ukca_setup_chem_mod.F90</code> module.
 
  +
wetdep(5,'H2O2 ',&
  +
(/0.83e+05,0.74e+04,0.24e-11,-0.373e+04,0.e+00,0.e+00/),TI+T+ST+OL+R,0,0,107),&
  +
wetdep(5,'H2O2 ',&
  +
(/0.83e+05,0.74e+04,0.22e-11,-0.373e+04,0.00e+00,0.00e+00/),S,0,0,107),&
   
 
==Solution to Task 8.1: Add wet deposition of a species==
 
==Solution to Task 8.1: Add wet deposition of a species==
Line 80: Line 96:
 
* ''Add in wet deposition for '''BOB''', using the following values:''
 
* ''Add in wet deposition for '''BOB''', using the following values:''
   
{| border="1"
+
{| class="wikitable" border = "1px"
  +
!style="text-align:top;"|<math>\ k(298)\ </math>
! <math>\ k(298)\ </math> || <math>\ -\left({\Delta H}/R\right)\ </math> || <math>\ k(298)</math> for the 1st dissociation || <math>\ -\left({\Delta H}/R\right)</math> for the 1st dissociation || <math>\ k(298)</math> for the 2nd dissociation || <math>\ -\left({\Delta H}/R\right)</math> for the 2nd dissociation
 
  +
!style="text-align:top;"| <math>\ -\left({\Delta H}/R\right)\ </math>
  +
!style="text-align:top;"| <math>\ k(298)</math> for the 1st dissociation
  +
!style="text-align:top;"| <math>\ -\left({\Delta H}/R\right)</math> for the 1st dissociation
  +
!style="text-align:top;"| <math>\ k(298)</math> for the 2nd dissociation
  +
!style="text-align:top;"| <math>\ -\left({\Delta H}/R\right)</math> for the 2nd dissociation
 
|-
 
|-
 
| <math>\ 0.21 \times 10^{+06}\ </math> || <math>\ 0.87 \times 10^{+04}\ </math> || <math>\ 0.2 \times 10^{+02}\ </math> || <math>\ 0.0\ </math> || <math>\ 0.0\ </math> || <math>\ 0.0\ </math>
 
| <math>\ 0.21 \times 10^{+06}\ </math> || <math>\ 0.87 \times 10^{+04}\ </math> || <math>\ 0.2 \times 10^{+02}\ </math> || <math>\ 0.0\ </math> || <math>\ 0.0\ </math> || <math>\ 0.0\ </math>
Line 109: Line 130:
 
+um_sources=branches/dev/lukeabraham/vn10.9_UKCA_Tutorial_Solns@46696
 
+um_sources=branches/dev/lukeabraham/vn10.9_UKCA_Tutorial_Solns@46696
   
These differences can be found in the file '''<code>/home/ukca/Tutorial/vn10.9/worked_solutions/Task5.3/Task5.3_rose.patch</code>''' on PUMA.
+
These differences can be found in the file '''<code>/home/ukca/Tutorial/vn10.9/worked_solutions/Task8.1/Task8.1_rose.patch</code>''' on PUMA.
   
 
'''vm:'''
 
'''vm:'''
Index: app/fcm_make/rose-app.conf
+
Index: app/fcm_make/rose-app.conf
 
===================================================================
 
===================================================================
--- app/fcm_make/rose-app.conf (revision 60203)
+
--- app/fcm_make/rose-app.conf (revision 60160)
+++ app/fcm_make/rose-app.conf (revision 60205)
+
+++ app/fcm_make/rose-app.conf (revision 60206)
 
@@ -42,4 +42,4 @@
 
@@ -42,4 +42,4 @@
 
stash_version=1A
 
stash_version=1A
Line 163: Line 184:
 
Sample output from this task can be found at '''<code>/work/n02/n02/ukca/Tutorial/vn10.9/sample_output/Task8.1/atmosa.pa19810901_00</code>''' on ARCHER.
 
Sample output from this task can be found at '''<code>/work/n02/n02/ukca/Tutorial/vn10.9/sample_output/Task8.1/atmosa.pa19810901_00</code>''' on ARCHER.
   
  +
==Checklist==
[[UKCA Chemistry and Aerosol vn10.9+ Tutorial 9|Tutorial 9]]
 
  +
  +
: <span style="font-size:20px">☐</span> Put a 1 in the W column of the <code>chch_defs_master</code> in <code>ukca_chem_master.F90</code>.
  +
: <span style="font-size:20px">☐</span> Append the Henry's Law parameter values in the <code>depvel_defs_master</code> array, and increment <code>n_wet_master</code>.
  +
 
[[UKCA Chemistry and Aerosol vn10.9 Tutorial 9|Tutorial 9]]
 
----
 
----
 
''Written by [[User:Nla27 | Luke Abraham]] 2017''
 
''Written by [[User:Nla27 | Luke Abraham]] 2017''

Latest revision as of 09:58, 11 December 2017

UKCA Chemistry and Aerosol Tutorials at vn10.9

What you will learn in this Tutorial

In this tutorial you will learn how the wet deposition of chemical species is handelled in UKCA. You will then add-in the wet deposition of one of your new tracers.

Task 8.1: Add wet deposition of a species

Task 8.1: Add in wet deposition for BOB, using the following values:

for the 1st dissociation for the 1st dissociation for the 2nd dissociation for the 2nd dissociation

Adding Wet Deposition

The formulation used in UKCA is described in Giannakopoulos (1999)[1]. This scheme uses the following formula to calculate the effective Henry's Law coefficient

where is the rate constant at 298K.

During this tutorial you will be tasked with adding the wet deposition of one of your new tracers.

References

  1. Giannakopoulos, C., M. P. Chipperfield, K. S. Law, and J. A. Pyle (1999), Validation and intercomparison of wet and dry deposition schemes using 210Pb in a global three-dimensional off-line chemical transport model, J. Geophys. Res., 104(D19), 23761–23784, doi:10.1029/1999JD900392.

Turning on Wet Deposition for a Species

Chemistry Scheme Specification

Within the UKCA code, whether a species is wet deposited or not is controlled in the ukca_chem_master.F90 module. In the chch_defs_master array there are lines like

!  10 DD: 7,WD: 4,
chch_t1(10,'HONO2     ',1,'TR        ','          ',1,1,0,TI+S+T+ST+R,0,0,107),&
!  11 DD: 8,WD: 5,
chch_t1(11,'H2O2      ',1,'TR        ','          ',1,1,0,TI+S+T+ST+OL+R,0,0,&
   107),& 

Where the 1 in the 7th column turns on wet deposition of that species (being 0 otherwise). You will need to change the 0 to a 1 for the species that you wish to now wet deposit.

Setting Henry's Law values

In the ukca_chem_master.F90 module the parameters required to calculate are held in the henry_defs_master array (of defined size n_wet_master), and has format

N 'SPECIES   '
for the 1st dissociation for the 1st dissociation for the 2nd dissociation for the 2nd dissociation
SCHEME QUALIFIER DISQUALIFIER VN

Columns 3 and 4 are used if the species dissociates in the aqueous phase. In this case, is further multiplied by a factor of

where

and column 3 contains the values of and column 4 contains the value of . Similarly, if the species dissociates a second time then a further factor of is applied, where this value of is calculated from the values of and in columns 5 and 6.

Note: As with the 2D dry deposition values in depvel_defs_master, the order of henry_defs_master also assumes that the values are in the same order as the species (that wet deposit) in the chch_defs_master array.

Examples for this array are

!    4  
wetdep(4,'HONO2     ',&
(/0.21e+06,0.87e+04,0.20e+02,0.00e+00,0.00e+00,0.00e+00/),TI+T+ST+R,0,0,107),&
wetdep(4,'HONO2     ',&
(/0.21e+06,0.87e+04,0.157e+02,0.00e+00,0.00e+00,0.00e+00/),S,0,0,107),&
!    5
wetdep(5,'H2O2      ',&
(/0.83e+05,0.74e+04,0.24e-11,-0.373e+04,0.e+00,0.e+00/),TI+T+ST+OL+R,0,0,107),&
wetdep(5,'H2O2      ',&
(/0.83e+05,0.74e+04,0.22e-11,-0.373e+04,0.00e+00,0.00e+00/),S,0,0,107),&

Solution to Task 8.1: Add wet deposition of a species

You were given the task

  • Add in wet deposition for BOB, using the following values:
for the 1st dissociation for the 1st dissociation for the 2nd dissociation for the 2nd dissociation

For a working Rose suite that has completed this task, please see

  • ARCHER: u-as292@60205
  • vm: u-as297@60206

The specific Rose changes made are:

The specific Rose changes made are:

ARCHER:

Index: app/fcm_make/rose-app.conf
===================================================================
--- app/fcm_make/rose-app.conf	(revision 60203)
+++ app/fcm_make/rose-app.conf	(revision 60205)
@@ -42,4 +42,4 @@
 stash_version=1A
 timer_version=3A
 um_rev=vn10.9
-um_sources=branches/dev/lukeabraham/vn10.9_UKCA_Tutorial_Solns@46683
+um_sources=branches/dev/lukeabraham/vn10.9_UKCA_Tutorial_Solns@46696

These differences can be found in the file /home/ukca/Tutorial/vn10.9/worked_solutions/Task8.1/Task8.1_rose.patch on PUMA.

vm:

 Index: app/fcm_make/rose-app.conf
===================================================================
--- app/fcm_make/rose-app.conf	(revision 60160)
+++ app/fcm_make/rose-app.conf	(revision 60206)
@@ -42,4 +42,4 @@
 stash_version=1A
 timer_version=3A
 um_rev=vn10.9
-um_sources=branches/dev/lukeabraham/vn10.9_UKCA_Tutorial_Solns@46683
+um_sources=branches/dev/lukeabraham/vn10.9_UKCA_Tutorial_Solns@46696

The specific UM changes made are:

Index: src/atmosphere/UKCA/ukca_chem_master.F90
===================================================================
--- src/atmosphere/UKCA/ukca_chem_master.F90	(revision 46683)
+++ src/atmosphere/UKCA/ukca_chem_master.F90	(revision 46696)
@@ -82,7 +82,7 @@
 INTEGER, PARAMETER :: n_chch_master = 150 ! number of known species
 INTEGER, PARAMETER :: n_het_master  =  10 ! number of heterogeneous reactions
 INTEGER, PARAMETER :: n_dry_master  =  58 ! number of dry deposition reactions
-INTEGER, PARAMETER :: n_wet_master  =  49 ! number of wet deposition reactions
+INTEGER, PARAMETER :: n_wet_master  =  50 ! number of wet deposition reactions
 INTEGER, PARAMETER :: n_bimol_master= 401 ! number of bimolecular reactions
 INTEGER, PARAMETER :: n_ratj_master =  76 ! number of photolysis reactions
 INTEGER, PARAMETER :: n_ratt_master =  49 ! number of termolecular reactions
@@ -378,7 +378,7 @@
 chch_t1(114,'GLY       ',1,'TR        ','          ',0,1,0,R,0,0,107),&
 chch_t1(115,'oXYLENE   ',1,'TR        ','          ',0,0,1,R,0,0,107),&
 chch_t1(116,'ALICE     ',1,'TR        ','          ',1,0,1,ST,0,0,107),&
-chch_t1(117,'BOB       ',1,'TR        ','          ',0,0,0,ST,0,0,107)/)
+chch_t1(117,'BOB       ',1,'TR        ','          ',0,1,0,ST,0,0,107)/)
 
 ! Heterogeneous chemistry
 ! Columns take the following meanings:
@@ -1039,7 +1039,10 @@
 wetdep(38,'s-BuOOH   ',&
 (/0.34e+03,0.57e+04,0.00e+00,0.00e+00,0.00e+00,0.00e+00/),R,0,0,107), & 
 wetdep(39,'GLY       ',&
-(/0.36e+06,0.00e+00,0.00e+00,0.00e+00,0.00e+00,0.00e+00/),R,0,0,107) /)
+(/0.36e+06,0.00e+00,0.00e+00,0.00e+00,0.00e+00,0.00e+00/),R,0,0,107),&
+!    UKCA Tutorial: wet deposition of BOB
+wetdep(40,'BOB       ',&
+(/0.21e+06,0.87e+04,0.20e+02,0.00e+00,0.00e+00,0.00e+00/),ST,0,0,107) /)
 
 ! Bimolecular reactions are too many to define here in one statement.
 TYPE(ratb_t1) :: ratb_defs_master(1:n_bimol_master) 

These differences can be found in the file /home/ukca/Tutorial/vn10.9/worked_solutions/Task8.1/Task8.1_code.patch on PUMA.

Sample output from this task can be found at /work/n02/n02/ukca/Tutorial/vn10.9/sample_output/Task8.1/atmosa.pa19810901_00 on ARCHER.

Checklist

Put a 1 in the W column of the chch_defs_master in ukca_chem_master.F90.
Append the Henry's Law parameter values in the depvel_defs_master array, and increment n_wet_master.

Tutorial 9


Written by Luke Abraham 2017