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

jgfs_atmos_sfcanl.ecf (GFS v17)

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


Summary

jgfs_atmos_sfcanl.ecf (on disk as jgfs_atmos_anal_sfc_gcycle.ecf) is the NCO production ecFlow task that runs the surface analysis global cycle (SFCANL/GCycle) — updating land surface fields (SST, sea ice, soil moisture/temperature, vegetation) using observational data and the previous cycle's surface state. It calls JGLOBAL_ATMOS_SFCANL_GCYCLE.


1. The script itself

Section Detail
PBS resources 1 node, 32 mpiprocs, 4 OMP threads, 128 cpus, exclusive host, 20-min wall
Modules load_modules.sh run (general modules)
J-Job JGLOBAL_ATMOS_SFCANL_GCYCLE
Rocoto breadcrumb sfcanl.sh

2. Execution chain

jgfs_atmos_anal_sfc_gcycle.ecf
  +-- JGLOBAL_ATMOS_SFCANL_GCYCLE
       +-- exglobal_atmos_sfcanl_gcycle.sh (or Python)
            +-- global_cycle.x (Fortran executable)
            +-- Updates SST, sea ice, snow, soil, vegetation

3. v17-specific notes

  • General modules (run not gsi or ufsda) — uses global_cycle Fortran executable.
  • Hybrid threading: 32 MPI x 4 OMP.
  • Exclusive host despite single node — needs full node memory.
  • Post-analysis: runs after atmospheric analysis to update surface for forecast ICs.
  • Renamed from sfcanl to anal_sfc_gcycle in v17.

4. Change-impact snapshot

Symbol Risk Notes
JGLOBAL_ATMOS_SFCANL_GCYCLE MEDIUM Provides surface ICs for forecast

Sources

  • On-disk v17 worktree: ecf/scripts/gfs/analysis/atmos/jgfs_atmos_anal_sfc_gcycle.ecf.