Skip to content

Add CATChem as a NUOPC component#3223

Draft
benkozi wants to merge 25 commits into
ufs-community:developfrom
benkozi:feature/catchem-ufs
Draft

Add CATChem as a NUOPC component#3223
benkozi wants to merge 25 commits into
ufs-community:developfrom
benkozi:feature/catchem-ufs

Conversation

@benkozi

@benkozi benkozi commented May 6, 2026

Copy link
Copy Markdown

Commit Queue Requirements:

  • This PR addresses a relevant WM issue (if not, create an issue).
  • All subcomponent pull requests (if any) have been reviewed by their code managers.
  • Run the full Intel+GNU RT suite (compared to current baselines), preferably on Ursa (Derecho or Hercules are acceptable alternatives). Exceptions: documentation-only PRs, CI-only PRs, etc.
    • Commit log file w/full results from RT suite run (if applicable).
    • Verify that test_changes.list indicates which tests, if any, are changed by this PR. Commit test_changes.list, even if it is empty.
  • Fill out all sections of this template.
  • Include CATChem in repo_check.sh

Description:

Introduces CATChem as a new NUOPC component. CATChem (Configurable ATmospheric Chemistry) includes all chemical and aerosol processes needed to perform atmospheric chemistry and composition simulations. CATChem, in combination with the emissions processing engine CECE, comprise the core GCAFSv2 components.

This PR combines contributions from @lwcugb and @bbakernoaa.

Commit Message:

* UFSWM - Add CATChem as a NUOPC component
  * AQM - 
  * CDEPS - 
  * CICE - 
  * CMEPS - 
  * CMakeModules - 
  * UFSATM - Add additional chemistry model field selection logic to support the CATChem component
    * ccpp-physics - Add additional chemistry model field selection logic to support the CATChem component
    * atmos_cubed_sphere - 
  * GOCART - 
  * MOM6 - 
  * NOAHMP - 
  * WW3 - 
  * fire_behavior
  * stochastic_physics - 

Priority:

  • Critical Bugfix: Reason
  • High: Reason
  • Normal

Git Tracking

UFSWM:

Sub component Pull Requests:

UFSWM Blocking Dependencies:

  • Blocked by #
  • None

Documentation:

  • Documentation update required.
    • Relevant updates are included with this PR.
    • A WM issue has been opened to track the need for a documentation update; a person responsible for submitting the update has been assigned to the issue (link issue): Add CATChem WM documentation CATChem#164
  • Documentation update NOT required.
    • Explanation:

Changes

Regression Test Changes (Please commit test_changes.list):

  • PR Adds New Tests/Baselines.
  • PR Updates/Changes Baselines.
  • No Baseline Changes.

Input data Changes:

  • None.
  • PR adds input data.
  • PR changes existing input data.

Library Changes/Upgrades:

  • Required
    • Library names w/versions:
    • Git Stack Issue (JCSDA/spack-stack#)
  • No Updates

Testing Log:

  • RDHPCS
    • Orion
    • Hercules
    • GaeaC6
    • Derecho
    • Ursa
  • WCOSS2
    • Dogwood/Cactus
    • Acorn
  • CI
  • opnReqTest (complete task if unnecessary)

Comment thread tests/rt.sh Outdated
Comment thread tests/tests/catchem_control
@gspetro-NOAA gspetro-NOAA added Baseline Updates Current baselines will be updated. New Baselines New baselines will be added to project. CATChem There are changes to the CATChem component repository. UFSATM There are changes to the UFSATM repository. CCPP There are changes to a CCPP repository. and removed Baseline Updates Current baselines will be updated. labels May 7, 2026
@gspetro-NOAA gspetro-NOAA moved this from Evaluating to Draft in PRs to Process Jun 23, 2026
Comment thread CMakeLists.txt
###############################################################################
if(CATCHEM)
set(CATCHEM_BUILD_NUOPC ON CACHE BOOL "Enable CATChem NUOPC cap for UFS integration" FORCE)
set(CATCHEM_TRACE_NUOPC OFF CACHE BOOL "Enable ESMF trace regions in the CATChem NUOPC cap" FORCE)

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Minor. Do we need to build the tests? I think the CATCHEM_BUILD_TESTING flag is on by default.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CATChem There are changes to the CATChem component repository. CCPP There are changes to a CCPP repository. New Baselines New baselines will be added to project. UFSATM There are changes to the UFSATM repository.

Projects

Status: Draft

Development

Successfully merging this pull request may close these issues.

Integrate CATChem into the ufs-weather-model

3 participants