Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update Wesley documentation #34

Merged
merged 4 commits into from
Mar 7, 2024
Merged
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
77 changes: 58 additions & 19 deletions docs/src/wesley1989.md
Original file line number Diff line number Diff line change
@@ -1,30 +1,69 @@
# Wesley 1989 Dry Deposition Surface Resistance

## Introduction
This is the Wesely 1989 algorithm for surface resistance to dry deposition.

Citation for the original article, followed by citation for an article with some corrections which have been
incorporated here:

M. L. Wesely, Parameterization of surface resistances to gaseous dry deposition in regional-scale numerical models,
Atmos. Environ. 23, 1293–1304 (1989), http:dx.doi.org/10.1016/0004-6981(89)90153-4.
1. M. L. Wesely, Parameterization of surface resistances to gaseous dry deposition in regional-scale numerical models,
Atmos. Environ. 23, 1293–1304 (1989), http://dx.doi.org/10.1016/0004-6981(89)90153-4.

J. Walmsley, and M. L. Wesely, Modification of coded parametrizations of surface resistances to gaseous dry deposition,
2. J. Walmsley, and M. L. Wesely, Modification of coded parametrizations of surface resistances to gaseous dry deposition,
Atmos. Environ. 30(7), 1181–1188 (1996), http://dx.doi.org/10.1016/1352-2310(95)00403-3.

The abstract of the original article:

Methods for estimating the dry deposition velocities of atmospheric gases in the U.S. and surrounding areas have been
improved and incorporated into a revised computer code module for use in numerical models
of atmospheric transport and deposition of pollutants over regional scales. The key improvement is
the computation of bulk surface resistances along three distinct pathways of mass transfer to sites of
deposition at the upper portions of vegetative canopies or structures, the lower portions, and the ground
(or water surface). This approach replaces the previous technique of providing simple look-up tables
of bulk surface resistances. With the surface resistances divided explicitly into distinct pathways,
the bulk surface resistances for a large number of gases in addition IO those usually addressed
in acid deposition models (SO2, O3, NOx, and HNO3) can be computed, if estimates of the effective Henry’s Law constants
and appropriate measures of the chemical reactiiity of the various substances are known.
This has been accomnlished successfullv for H2O2, HCHO, CH3CHO (to represent other aldehydes CH3O2H
(to represent organic peroxides), CH3C(O)O2H, HCOOH (to represent organic acids), NH3, CH3C(O)O2NO2,
and HNO2. Other factors considered include surface temperature, stomatal response to environmental parameters,
the wetting of surfaces by dew and rain, and the covering of surfaces by snow. Surface emission of gases
and variations of uptake characteristics by individual plant species within the landuse types are not considered explicitly.
Methods for estimating the dry deposition velocities of atmospheric gases in the U.S. and surrounding areas have been improved and incorporated into a revised computer code module for use in numerical models of atmospheric transport and deposition of pollutants over regional scales. The key improvement is the computation of bulk surface resistances along three distinct pathways of mass transfer to sites of deposition at the upper portions of vegetative canopies or structures, the lower portions, and the ground (or water surface). This approach replaces the previous technique of providing simple look-up tables of bulk surface resistances. With the surface resistances divided explicitly into distinct pathways, the bulk surface resistances for a large number of gases in addition to those usually addressed in acid deposition models (SO<sub>2</sub>, O<sub>3</sub>, NO<sub>x</sub>, and HNO<sub>3</sub>) can be computed, if estimates of the effective Henry’s Law constants and appropriate measures of the chemical reactivity of the various substances are known. This has been accomplished successfully for H<sub>2</sub>O<sub>2</sub>, HCHO, CH<sub>3</sub>O<sub>2</sub>H (to represent organic peroxides), CH<sub>3</sub>C(O)O<sub>2</sub>H, HCOOH (to represent organic acids), NH<sub>3</sub>, CH<sub>3</sub>C(O)O<sub>2</sub>NO<sub>2</sub>, and HNO<sub>2</sub>. Other factors considered include surface temperature, stomatal response to environmental parameters, the wetting of surfaces by dew and rain, and the covering of surfaces by snow. Surface emission of gases and variations of uptake characteristics by individual plant species within the land use types are not considered explicitly.

## Main functions
Function ```WesleySurfaceResistance``` is used to calculate surface resistance to dry depostion [s/m] based on Wesely (1989) equation 2.
The inputs of the function are information on the chemical of interest ```gasData```, solar irradiation ```G``` [W/m²], the surface air temperature ```Ts``` [°C], the slope of the local terrain ```Θ``` [radians], the season index ```iSeason```, the land use index ```iLandUse```, whether there is currently rain or dew ```rain``` or ```dew```, and whether the chemical of interest is either SO2 ```isSO2``` or O3 ```isO3```.
Here's an example:

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this should probably be julia @example 1 instead of julia @example1

Copy link
Contributor Author

@jialinl6 jialinl6 Mar 1, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh, I see! Sorr about that. I will correct this!

```julia @example1
gasData::GasData = AtmosphericDeposition.So2Data
G, Ts, θ = [1.0, 20.0, 1.0] # [W/m², °C, radians]
iSeason, iLandUse = [1, 1] # the season index and land use index need to be integers
rain::Bool, dew::Bool, isSO2::Bool, isO3::Bool = [true, true, true, false]

WesleySurfaceResistance(gasData, G, Ts, θ, iSeason, iLandUse, rain, dew, isSO2, isO3) # [s/m]
```
This will return you the value of surface resistance to dry deposition of SO<sub>2</sub> with given solar irradiation, temperature and local terrain during midsummer with lush vegetation (season) in areas of evergreen needleleaf trees (land).

## Default parameters
a. For season index ```iSeason```, there're five seasonal categories

1. Midsummer with lush vegetation
2. Autumn with cropland not harvested
3. Late autumn after frost, no snow
4. Winter, snow on ground
5. Transitional

b. For land use index ```iLandUse```, there're five land use categories

1. Evergreen–needleleaf trees
2. Deciduous broadleaf trees
3. Grass
4. Desert
5. Shrubs and interrupted woodlands

c. For gasData ```gasData```, we include the following species:

| Variable name | Species |
| -----------| --- |
|So2Data | SO2|
|O3Data | O3|
|No2Data | NO2|
|NoData | NO|
|Hno3Data | HNO3|
|H2o2Data | H2O2|
|AldData | Acetaldehyde (aldehyde class)|
|HchoData | Formaldehyde|
|OpData | Methyl hydroperoxide (organic peroxide class)|
|PaaData | Peroxyacetyl nitrate|
|OraData | Formic acid (organic acid class)|
|Nh3Data | NH3|
|PanData | Peroxyacetyl nitrate|
|Hno2Data | Nitrous acid|

Wesely (1989) suggests that, in general, the sum of NO and NO<sub>2</sub> should be considered rather than NO2 alone because rapid in-air chemical reactions can cause a significant change of NO and NO<sub>2</sub> vertical fluxes between the surface and the point at which deposition velocities are applied, but the sum of NO and NO<sub>2</sub> fluxes should be practically unchanged.
Loading