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

Support for Cloud-J version 8.0.0 #2424

Merged
merged 5 commits into from
Sep 3, 2024
Merged

Support for Cloud-J version 8.0.0 #2424

merged 5 commits into from
Sep 3, 2024

Conversation

lizziel
Copy link
Contributor

@lizziel lizziel commented Aug 13, 2024

Name and Institution (Required)

Name: Lizzie Lundgren
Institution: Harvard University

Describe the update

This pull request brings in updates for compatibility with Cloud-J version 8.0.0. The primary change is expanding the photolysis menu in configuration file geoschem_config.yml to allow easy run-time configuration of Cloud-J from GEOS-Chem run directories. Previously these settings were configured in an input file stored in external data directories.

Also in this update is the inclusion of the option to turn off the UV absorption by water vapor. H2O UV absorption is the main update in Cloud-J v8 and some GEOS-Chem users may want to experiment with it. It is turned on by default but can be toggled off in the photolysis menu of geoschem_config.yml.

This PR requires updating the Cloud-J submodule at the same time as merge. The Cloud-J PR that accompanies this PR is geoschem/Cloud-J#24.

Expected changes

We expect the mean OH will decrease and CH4 lifetime will increase due to the absorption of UV by H2O. If the UV absorption is turned off then this becomes a no diff update relative to Cloud-J 7.7.

Reference(s)

Prather, Michael (2023). An updated cloud-overlap photolysis module for atmospheric chemistry models, UCI Cloud-J v8.0, with near-UV H2O absorption [Dataset]. Dryad. https://doi.org/10.7280/D1Q398

Related Github Issues

geoschem/Cloud-J#12
closes #2386

@lizziel lizziel modified the milestones: 15.0.0, 14.5.0 Aug 13, 2024
@lizziel lizziel added Attn: Chemistry WG topic: Photolysis Related to photolyis rate computations labels Aug 13, 2024
@lizziel lizziel changed the base branch from main to dev/14.5.0 August 13, 2024 18:55
@yantosca yantosca self-assigned this Aug 13, 2024
@yantosca yantosca self-requested a review August 26, 2024 21:32
Copy link
Contributor

@yantosca yantosca left a comment

Choose a reason for hiding this comment

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

Looks good @lizziel. I just have a couple of comments.

  1. We need a CHANGELOG.md update.
  2. There are several new fields in geoschem_config.yml. We'll have to update the docs/source/gcclassic-user-guide/geoschem_config.rst file accordingly. But this can be done in the docs/dev branch later.

@lizziel
Copy link
Contributor Author

lizziel commented Aug 27, 2024

@yantosca, changelog is now updated.

I ran a 1-month benchmark comparison using latest dev/14.5.0. As expected, OH decreases and CH4 lifetime increases.

###############################################################################
### OH Metrics
### Ref = 14.5.0-alpha.6
### Dev = 14.5.0-alpha.6 + Cloud-J v8
###############################################################################

------------------------------------------------------------
Global mass-weighted OH concentration [10^5 molec cm^-3]
------------------------------------------------------------
Ref      : 13.63557837101
Dev      : 13.24662007096
Abs diff : -0.38895830005
%   diff : -2.852525

------------------------------------------------------------
CH3CCl3 (aka MCF) lifetime w/r/t tropospheric OH [years]
------------------------------------------------------------
Ref      :  4.501818
Dev      :  4.688332
Abs diff :  0.186513
%   diff :  4.143070

------------------------------------------------------------
CH4 lifetime w/r/t tropospheric OH [years]
------------------------------------------------------------
Ref      :  7.588761
Dev      :  7.911321
Abs diff :  0.322560
%   diff :  4.250497

J-values for O3(1D) decrease in the presence of moisture. Below is the 1-month zonal mean.
Screen Shot 2024-08-27 at 5 26 21 PM

@lizziel lizziel requested a review from yantosca August 27, 2024 22:03
Copy link
Contributor

@yantosca yantosca left a comment

Choose a reason for hiding this comment

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

Thanks @lizziel. This looks good to merge!

Besides options previously in input file CJ77.dat, there is now the
option to turn off the UV absorption by water vapor.

Signed-off-by: Lizzie Lundgren <[email protected]>
The concentration is computes from species concentration is H2O is
a species. Otherwise it is computed from the specific humidity
in the input meteorology.

Signed-off-by: Lizzie Lundgren <[email protected]>
This update also moves all Cloud-J parameters set in geoschem_config.yml
to new sub-menu called cloud-j within the photolysis menu.

Signed-off-by: Lizzie Lundgren <[email protected]>
Signed-off-by: Lizzie Lundgren <[email protected]>

# Conflicts:
#	CHANGELOG.md
@yantosca
Copy link
Contributor

yantosca commented Sep 3, 2024

@yantosca yantosca merged commit 40a0785 into dev/14.5.0 Sep 3, 2024
@yantosca yantosca deleted the feature/cloudj_v8 branch September 3, 2024 17:11
@msulprizio msulprizio added the topic: Chemical Mechanisms Related to KPP and/or GEOS-Chem chemistry mechanisms label Oct 1, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
topic: Chemical Mechanisms Related to KPP and/or GEOS-Chem chemistry mechanisms topic: Photolysis Related to photolyis rate computations
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants