updated BVOC documentation

[lkemmons]

Description of changes

Updated BVOC documentation

Specific notes

Contributors other than yourself, if any:
Input provided by Hui Wang (UC-Irvine), @HuiWangWanderInGitHub

CTSM Issues Fixed (include github issue #):
#3876 (comment)

Are answers expected to change (and if so in what way)?

Any User Interface Changes (namelist or namelist defaults changes)?

Does this create a need to change or add documentation? Did you do so?

Testing performed, if any:
(List what testing you did to show your changes worked as expected)
(This can be manual testing or running of the different test suites)
(Documentation on system testing is here: https://github.com/ESCOMP/ctsm/wiki/System-Testing-Guide)
(aux_clm on derecho for intel/gnu and izumi for intel/gnu/nag/nvhpc is the standard for tags on master)

NOTE: Be sure to check your coding style against the standard
(https://github.com/ESCOMP/ctsm/wiki/CTSM-coding-guidelines) and review
the list of common problems to watch out for
(https://github.com/ESCOMP/CTSM/wiki/List-of-common-problems).

[slevis-lmwg]

@lkemmons thank you for your work in this section! My review is thorough, but mostly it involves adding links to the references when each one first appears. To make things easier, I will try committing the simple suggestions if github will allow me, and I will leave only a few issues for you to resolve. Thanks again.

[slevis-lmwg]

@lkemmons thank you. Now that you completed the revisions, I will attempt a git revert -m 1 08cc8256ad246aa715562597da10ef873f8bd12d on the commit that merged the latest master to your branch, because I plan to merge your branch to the b4b-dev branch rather than master.

[slevis-lmwg]

Oh... but to accomplish this I need collaborator permissions on your branch...

Please click on Settings near the top, then "Collaborators and Teams", and then follow instructions on adding me (slevis-lmwg) as collaborator.

[lkemmons]

I added you to my repo.

…

On Tue, May 19, 2026 at 12:31 PM Samuel Levis ***@***.***> wrote: *slevis-lmwg* left a comment (ESCOMP/CTSM#3909) <#3909 (comment)> For me it appears to be at the top of this page, i.e. the PR's page. — Reply to this email directly, view it on GitHub <#3909 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AH5BH7NGZN245NWP65E2P7D43SR6RAVCNFSM6AAAAACXMCEMYOVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHM2DIOJQHAZTEOJZGE> . You are receiving this because you were mentioned.Message ID: ***@***.***>

[lkemmons]

Thanks!!!

…

On Tue, May 19, 2026 at 1:15 PM Samuel Levis ***@***.***> wrote: ***@***.**** commented on this pull request. ------------------------------ In doc/source/tech_note/BVOCs/CLM50_Tech_Note_BVOCs.rst <#3909 (comment)>: > + E_{opt\_bbds} = 7.9 e^{0.22 (T_{24}-297.15)} + +where :math:`T_{24}` denotes the mean air temperature of the preceding day (Wang et al., 2024a). +For C3AG, the isoprene emission factor responds over a longer timescale of 10 days (Wang et al., 2024b) and is parameterized as a function of the mean air temperature over the preceding 10 days (:math:`T_{240}`): + +.. math:: + 🏷️ C3 arctic grass adjustment factor + + E_{opt\_C3AG} = e^{0.22 (T_{240}-288.15)} + +In addition, a dynamic temperature response curve for C3AG depends on recent temperature history as: + +.. math:: + 🏷️ C3 arctic grass leaf temperature factor + + \gamma_{T\_C3AG} = E_{opt\_C3AG} e^{(C_{C3AG}/R (1/303.15 - 1/T_{leaf}))} Thank you. I also rearranged the "/ R" using the code as my guide. The equation ends up the same. I just find it easier to interpret this way. I will push the change in a moment. — Reply to this email directly, view it on GitHub <#3909 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AH5BH7L4EGX2SZL5T5S5QIL43SXG5AVCNFSM6AAAAACXMCEMYOVHI2DSMVQWIX3LMV43YUDVNRWFEZLROVSXG5CSMV3GSZLXHM2DGMRSGMZTKNZRHA> . You are receiving this because you were mentioned.Message ID: ***@***.***>

[slevis-lmwg]

This looks ready to me.