Validation run matrix for combined BrC AOD/RRTMG/FFOC branch

[maxcharvey]

Goal

Create the short-test workflow needed before production BrC runs with:

• online AOD
• persistent PBRCPOA
• RRTMG enabled
• FFOCPI/FFOCPO

Needed

Branch/submodule state

• Pin GEOS-Chem branch/commit after #11, Update CI tests to use the new geoschem/buildmatrix images. geoschem/GCClassic#14, GC_diagnostics geoschem/GCClassic#15, Updated README to include GEOS-Chem publications geoschem/GCClassic#16 are integrated.
• Pin Cloud-J branch/commit if NRHAER, AN_, or A_ changes.
• Pin HEMCO if any emissions changes are required.
• Update GCClassic superproject gitlinks so git submodule update recreates the build.

Compile tests

• Configure with -DRRTMG=y.
• Use an interactive Slurm allocation for compile/debug loops.
• Record compiler, flags, submodule SHAs, and GEOSChemBuildProperties.txt.

Run-dir audit

Use the local GEOS-Chem run-check workflow to verify:

• restart file date/path and missing species
• geoschem_config.yml species list includes BrC + PBRCPOA + FFOCPI/FFOCPO
• RRTMG active and wavelengths configured
• HISTORY.rc includes BrC AOD, RRTMG PM/DU/BRC, and FFOC diagnostics
• HEMCO_Config.rc GFED and CEDS frequency/scaling are intended
• CYS/missing restart species are understood before execution

Short runs

Run in order:

1. dry-run
2. 1-hour fullchem, RRTMG off, online AOD on
3. 1-hour fullchem, RRTMG on, baseline/PM/DU/BRC diagnostics
4. 1-day smoke test only after 1-hour outputs are clean

Output checks

• No NaN/Inf in AOD, BrC diagnostics, RRTMG fluxes.
• BrC species concentrations nonzero where expected.
• FFOCPI/FFOCPO nonzero when CEDS OC emissions active.
• Dust RRTMG bins present after BrC slot shift.
• BrC forcing diagnostic finite and separable from PM.

Acceptance criteria

• Reproducible run directory and build path documented.
• Combined branch compiles with RRTMG.
• Short RRTMG run completes using ./gcclassic from the run directory.
• Wiki updated with SHAs, run path, diagnostics, and known caveats.

Related GEOS-Chem issues: maxcharvey/geos-chem#11, geoschem#14, geoschem#15, geoschem#16.

[maxcharvey]

Validation matrix run completed on max/full_test.

Main outcomes: fullchem scheme 4 and scheme 0 smoke tests passed, RRTMG BrC smoke passed, 24h run completed to 2019-07-02 00:00, and offAOD Fortran core completed against a StateMet-enabled 1h output.

Branch: max/full_test.

Pinned commits:

• GCClassic: 475ffbd9cbf0adf0ee5f74eed06eb5e3739d1fe3
• GEOS-Chem: e586d1f207701ca31af2f50c55a26b5607c17664
• Cloud-J: 52407dbc3ab47874dafa7d9b87ed53ece3750945
• HEMCO: 3bdab085e8c6c5cf562a425251f655044ea7bb34

Validation completed:

• 1h fullchem scheme 4: pass
• 1h fullchem scheme 0: pass
• 1h RRTMG BrC smoke: pass
• 24h fullchem scheme 4 to 2019-07-02 00:00: pass
• StateMet-enabled offAOD prep run: pass
• offAOD Fortran core: pass

Caveat: a separate 0100->0200 restart mini-run hit HEMCO PS_NEXTDAY handling in the temporary met setup. The 24h run crossed the day boundary and wrote the final restart, so this does not look like a BrC-code issue.