New documentation for the CTSM dust emission module#3624
New documentation for the CTSM dust emission module#3624dmleung wants to merge 28 commits intoESCOMP:b4b-devfrom
Conversation
|
Hi @samsrabin I do need to make a few more commits to clean up the doc, check section numbers, and add references before it's ready for review. I will make updates soon, but I do want to put a draft PR here. Thanks! |
|
I rebased this to come to b4b-dev rather than master. |
|
I rebased this to come in on b4b-dev rather than master. |
|
Oh, I don't know we are merging to b4b-dev. Thanks for doing that Erik! |
samsrabin
added
documentation
… pass the initial check.
|
Hi @samsrabin and @ekluzek, I just wanted to ping you and say that I think this PR is ready for review when you have time. |
ekluzek
left a comment
ekluzek
left a comment
There was a problem hiding this comment.
@dmleung thanks for your work here! It's nice to have this update in place, and not to have to worry about getting it in later.
I have a couple suggestions about handling "g" and changing rho _{a} to rho _{atm} as that seems to be more consistent in other places in the tech note. We should also just remove the details about Zender, as that will be documented in the CLM50 tech note, and it would be confusing here. You might mention it as the previous method and say details on it are in the CLM50 tech note. But, it adds too much complexity to give the full details of both here.
ekluzek
changed the title
|
@dmleung |
Hi Sam, yes! Is it okay if I try to finish it by this weekend so you can work on it next week? |
|
That sounds good. Thank you @dmleung! |
…nstants for the dust doc. Removed description of Zender 2003 dust emission scheme in the doc.
|
@slevis-lmwg @ekluzek |
slevis-lmwg
left a comment
slevis-lmwg
left a comment
There was a problem hiding this comment.
Requesting a correction that I noticed, and maybe I can resolve it myself.
| And so the fraction of time :math:`\eta` within :math:`\Delta t` with active emission is determined for :eq:`30.8`. | ||
|
|
||
|
|
||
| The total vertical mass emission flux of dust, :math:`F_{d}` (kg m\ :sup:`-2` s\ :sup:`-1`) is then computed with all the above equations and terms. The emission flux is then passed through the coupler to the atmospheric model (CAM) to simulate dust aerosol transport and deposition. The default aerosol model supported in the CAM6 and CAM7 physics is the Modal Aerosol Model (MAM). CAM7 uses the 5-mode MAM (MAM5), in which three modes (Aitken, accumulation, and coarse modes) by default contain dust. The total mass emission flux per grid is partitioned into the three modes following the Brittle Fragmentation Theory (BFT) by Kok et al. (2014) and later modified by Meng et al. (2022). In the current model version, the fractions of dust emission flux partitioned in the three modes are 1.65E-05, 0.021, and 0.979 for the Aitken (0.01–0.1 um), accumulation (0.1–1 um), and coarse (1–10 um) modes, respectively. These values are prescribed in the MAM code inside CAM. |
There was a problem hiding this comment.
Need to add links to the bibliography for the papers here.
Co-authored-by: Danny M. Leung <97262277+dmleung@users.noreply.github.com>
Co-authored-by: Danny M. Leung <97262277+dmleung@users.noreply.github.com>
Co-authored-by: Danny M. Leung <97262277+dmleung@users.noreply.github.com>
Co-authored-by: Danny M. Leung <97262277+dmleung@users.noreply.github.com>
Co-authored-by: Danny M. Leung <97262277+dmleung@users.noreply.github.com>
Co-authored-by: Danny M. Leung <97262277+dmleung@users.noreply.github.com>
Co-authored-by: Danny M. Leung <97262277+dmleung@users.noreply.github.com>
Co-authored-by: Danny M. Leung <97262277+dmleung@users.noreply.github.com>
Co-authored-by: Danny M. Leung <97262277+dmleung@users.noreply.github.com>
Co-authored-by: Danny M. Leung <97262277+dmleung@users.noreply.github.com>
Co-authored-by: Danny M. Leung <97262277+dmleung@users.noreply.github.com>
Co-authored-by: Danny M. Leung <97262277+dmleung@users.noreply.github.com>
Co-authored-by: Danny M. Leung <97262277+dmleung@users.noreply.github.com>
Co-authored-by: Danny M. Leung <97262277+dmleung@users.noreply.github.com>
Co-authored-by: Danny M. Leung <97262277+dmleung@users.noreply.github.com>
Co-authored-by: Danny M. Leung <97262277+dmleung@users.noreply.github.com>
Co-authored-by: Danny M. Leung <97262277+dmleung@users.noreply.github.com>
Co-authored-by: Danny M. Leung <97262277+dmleung@users.noreply.github.com>
Co-authored-by: Danny M. Leung <97262277+dmleung@users.noreply.github.com>
ekluzek
left a comment
ekluzek
left a comment
There was a problem hiding this comment.
There are some conversations to resolve with suggested changes. But everything else looks good to me. I committed the suggestions which all looked like improvements to me.
Once conversations are resolved we can merge this in.
|
|
||
| f_{rock} = 1 - \frac{\ln(\frac{z_{0a}}{z_{0s}})}{\ln[b_{1}(\frac{X}{z_{0s}})^{b_{2}}]} | ||
|
|
||
| where :math:`X = 10` m is the distance downstream the point of discontinuity in surface obstacle, :math:`b_{1} = 0.7` and :math:`b_{2} = 0.8` are coefficients (:ref:`Darmenova et al., 2009<Darmenovaetal2009>`), :math:`z_{0s}` is the soil roughness length. :math:`z_{0a}` is from :ref:`Prigent et al. (2005)<Prigentetal2005>` and should not be confused with the aerodynamic roughness length :math:`Z_{0}` from the model. This equation only applies for gridcells with VAI smaller than the VAI threshold for dust emission. |
There was a problem hiding this comment.
Some more uses of VAI to fix. Here and below.
4 participants
… New CTSM dust emission documentation by @dmleung.
Description of changes
This PR is on updating the ctsm tech note / documentation on the CTSM dust emission modules, Leung_2023 and Zender_2003.
Specific notes
Contributors other than yourself, if any:
@samsrabin @ekluzek
@tilmes
CTSM Issues Fixed (include github issue #):
#3170
Are answers expected to change (and if so in what way)?
No, this is a documentation to the dust emission module
Any User Interface Changes (namelist or namelist defaults changes)?
No
Does this create a need to change or add documentation? Did you do so?
This PR is on changing the documentation.
Testing performed, if any: