Skip to content

Documentation update for switching GCHP default resolution to c90 - #557

Draft
mcdon1718-h wants to merge 5 commits into
geoschem:docs/devfrom
mcdon1718-h:docs/dev
Draft

Documentation update for switching GCHP default resolution to c90#557
mcdon1718-h wants to merge 5 commits into
geoschem:docs/devfrom
mcdon1718-h:docs/dev

Conversation

@mcdon1718-h

Copy link
Copy Markdown

Name and Institution (Required)

Name: Helena McDonald
Institution: Harvard University

Describe the update

Updates to Quickstart guide and horizontal grids supplemental guide to note the default resolution has switched to c90.

Expected changes

None.

Related Github Issue

GCHP issue #553.

@mcdon1718-h
mcdon1718-h requested a review from lizziel June 22, 2026 19:06
@mcdon1718-h

Copy link
Copy Markdown
Author

Tagging @sdeastham to make sure descriptions + citation in supplemental guide are sufficient.

@yantosca

Copy link
Copy Markdown
Contributor

@mcdon1718-h this looks good to me but I'll let @lizziel and @sdeastham chime in.

@yantosca yantosca added the TODO: Documentation Improvements or additions to documentation label Jun 23, 2026
@yantosca yantosca self-assigned this Jun 23, 2026
@yantosca yantosca added this to the 14.8.0 milestone Jun 23, 2026
Comment thread docs/source/getting-started/quick-start.rst
Comment thread docs/source/supplement/horizontal-grids.rst Outdated
@sdeastham

Copy link
Copy Markdown
Contributor

I would avoid referring to cubed-sphere resolutions as being equivalent to an LL resolution. I'd instead say something like "C90 (for example) has a resolution of approximately 110 km globally, similar to the average resolution of a 1x1 degree lat-lon grid".

I would also suggest being a little careful in general. I'm certainly in favor of the standard resolution being C90, but there's a strange inconsistency in saying "performance is degraded at C24 and C48" if we don't acknowledge that this also applies to GC-Classic. Specifically, the wording "As there are known issues with representation of some transport processes at coarser model resolutions" seems to imply that the issue is FV3 at C24/48. I would probably instead say "Users should choose their resolution with care, and higher-resolution simulations inevitably provide a more faithful representation of transport". It's a (very difficult!) research question to say what is a "sufficient" resolution; for some problems C30 might be fine, and for others you might really need C720.

…guides. Outline of timing table in horizontal grids.
@mcdon1718-h
mcdon1718-h marked this pull request as draft July 29, 2026 13:36
…90 changes; higher resolution recommended but not prescribed for scientific outputs.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

TODO: Documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants