jgfs_vminmon ecf (v17) Analysis - TerrenceMcGuinness-NOAA/global-workflow GitHub Wiki

jgfs_vminmon.ecf (GFS v17)

Branch / tenant: dev/gfs.v17 (gw_v17) Path: ecf/scripts/gfs/verf/atmos/jgfs_vminmon.ecf Analysis date: 2026-06-11 Method: On-disk analysis of v17 worktree.


Summary

jgfs_vminmon.ecf is the NCO production ecFlow task that runs the GSI Variational Minimization Monitor (VMinMon) for the GFS cycle. It extracts and archives convergence diagnostics from the atmospheric analysis, tracking the minimization behavior of the GSI variational solver. It calls JGLOBAL_ATMOS_VMINMON.


1. The script itself

Section Detail
PBS resources 1 node, 1 cpu, 1 GB, 5-min wall, shared
Modules load_modules.sh gsi (GSI monitoring tools)
J-Job JGLOBAL_ATMOS_VMINMON
Rocoto breadcrumb vminmon.sh

2. Execution chain

jgfs_vminmon.ecf
  +-- JGLOBAL_ATMOS_VMINMON
       +-- exglobal_atmos_vminmon.sh (or Python equivalent)
            +-- Extracts GSI minimization statistics
            +-- Archives convergence data for monitoring

3. What the J-Job produces

Product Description
Minimization convergence stats Cost function / gradient norm per iteration
Time-series data Appended to operational monitoring archive

4. v17-specific notes

  • Tiny resources: 1 cpu, 1 GB, 5 min — simply parses GSI output logs.
  • GSI modules: loads gsi module set (not ufsda or ufswm).
  • Monitoring only: does not affect operational products; failure is non-critical.
  • Depends on: atmospheric analysis completion (reads its output).

5. Change-impact snapshot

Symbol Risk Notes
JGLOBAL_ATMOS_VMINMON LOW Monitoring suite leaf

Sources

  • On-disk v17 worktree: ecf/scripts/gfs/verf/atmos/jgfs_vminmon.ecf.