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.