Skip to content

Add GCHP ctmEnv-only simulation option#477

Draft
lizziel wants to merge 1 commit intomainfrom
feature/gchp_ctmenv_only_simulation
Draft

Add GCHP ctmEnv-only simulation option#477
lizziel wants to merge 1 commit intomainfrom
feature/gchp_ctmenv_only_simulation

Conversation

@lizziel
Copy link
Contributor

@lizziel lizziel commented Feb 21, 2025

Name and Institution (Required)

Name: Lizzie Lundgren
Institution: Harvard University

Describe the update

This update introduces a compile-time option for a GCHP-like simulation that does not run GEOS-Chem or advection. Only ExtData, History, and the ctmEnv gridded component are run, although both GEOS-Chem and FV3 are compiled.

The purpose of this is to experiment with producing 12 km lat-lon wind exports from c720 mass flux imports using MAPL in a way that is lightweight and fast. However, it is useful for testing and potentially other applications as well. It is currently being used to test early implementations of MAPL3. It could also be extended in the future to a dynamics-only simulation using a simple tracer.

Notes and instructions:

  • The ctmEnv-only simulation option is enabled by building with -DMODEL_CTMENV=y.
  • It should be used with the ctmEnv-only run directory that is an option during run directory creation.
  • The runScriptSamples/operational_examples/harvard_cannon directory has a run script set up for use with it. See file gchp.ctmenv.run.
  • No restart file is used for the simulation, making it extremely lightweight and fast when run at high resolutions.
  • All of GCHP is compiled with the exception of code within #ifndef MODEL_CTMENV blocks.
  • Dynamics is both compiled and initialized, but is not run. This avoids code dependency issues.
  • GEOS-Chem is compiled but is not added as a child gridded component. It is needed for run directory creation, although does not require compiling. Future work could remove compiling it. It is kept to minimize differences in CMake files between the ctmEnv and standard GCHP simulations.

This update will require concurrent merge of two subdirectory PRs:

Expected changes

This is a no diff update.

Reference(s)

None

Related Github Issue

None

@lizziel lizziel added category: Feature Request New feature or request topic: Run Directories Related to GCHP run directories labels Feb 21, 2025
@lizziel lizziel self-assigned this Feb 21, 2025
@lizziel
Copy link
Contributor Author

lizziel commented Feb 21, 2025

fyi @sdeastham

@lizziel lizziel added no-diff-to-benchmark This update will not change the results of fullchem benchmark simulations topic: Runtime Related to runtime issues (e.g. simulation stops with error) labels Feb 21, 2025
@lizziel lizziel force-pushed the feature/gchp_ctmenv_only_simulation branch from 57865f1 to 018a15c Compare July 17, 2025 15:13
@lizziel lizziel force-pushed the feature/gchp_ctmenv_only_simulation branch from 018a15c to be068fe Compare October 29, 2025 18:38
@lizziel
Copy link
Contributor Author

lizziel commented Oct 29, 2025

Using this implementation for 12 km winds is on hold, but I am currently experimenting with it for testing MAPL3. We may or may not bring the changes in this PR into the standard model in the future.

GEOS-Chem is not added as a gridded component and FV3 advection
is not run. Enable by building with -DMODEL_CTMENV=y. A message
is printed during configure stage if building with MODEL_CTMENV
turned on. Otherwise, no message is printed.

Signed-off-by: Lizzie Lundgren <elundgren@seas.harvard.edu>
@lizziel lizziel force-pushed the feature/gchp_ctmenv_only_simulation branch from 711f2d3 to 7fd8b2e Compare November 3, 2025 21:46
@lizziel
Copy link
Contributor Author

lizziel commented Nov 4, 2025

This update is now rebased on dev/14.7.0. Since it is very useful for testing I would like to bring it into the standard model, possibly in 14.7.1.

@yantosca yantosca force-pushed the main branch 6 times, most recently from 82d6639 to 3216f28 Compare February 8, 2026 02:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

category: Feature Request New feature or request no-diff-to-benchmark This update will not change the results of fullchem benchmark simulations topic: Run Directories Related to GCHP run directories topic: Runtime Related to runtime issues (e.g. simulation stops with error)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant