History Control

This section provides a brief overview of the GEOS GCM output control. At its highest level, model output is controlled through a resource file named HISTORY.rc; many times, this file comes in templated format, which means it contains entries that are filled in at runtime, in such cases, the file is typically found with an extension "tmpl" appended to its name.

The output of GEOS GCM is subset in files, referred to as COLLECTIONS. An example of a COLLECTION table is provided below:

COLLECTIONS: 'geosgcm_prog'

            'geosgcm_surf'
            'geosgcm_moist'
            'geosgcm_turb'
            'geosgcm_gwd'
            'geosgcm_tend'
            'geosgcm_budi'
            'geosgcm_buda'
            'geosgcm_landice'
            'geosgcm_meltwtr'
            'geosgcm_snowlayer'
            'geosgcm_tracer'

>>>HIST_GOCART<<< 'tavg2d_aer_x' >>>HIST_GOCART<<< 'tavg3d_aer_p'

The table follows MAPL's (and MPEU's) convention of starting with a name (COLLECTION) and editing with two colons (::). The particular example above would be found in a file with the extension "tmpl' to indicate it is a template file (meaning, it has entries in a format >>>ENTRY<<< which get replaced by something meaningful at runtime.

Users can control freely the collections (or output streams) they want by simply commenting or uncommenting existing collections --- a "#" sign is a comment, which the reading software ignores.

Each collection defines its own meta-information.

 geosgcm_prog.template:  '%y4%m2%d2_%h2%n2z.nc4',
 geosgcm_prog.archive:   '%c/Y%y4',
 geosgcm_prog.format:    'CFIO',
 geosgcm_prog.frequency:  060000,
 geosgcm_prog.grid_label: PC@HIST_IMx@HIST_JM-DC
 geosgcm_prog.vscale:     100.0,
 geosgcm_prog.vunit:     'hPa',
 geosgcm_prog.vvars:     'log(PLE)' , 'DYN'          ,
 geosgcm_prog.levels:     1000 975 950 925 900 875 850 825 800 775 750 725 700 650 600 550 500 450 400 350 300 250 200 150 100 70 50 40 30 20 10 7 5 4 3 2 1 0.7 0.5 0.4 0.3 0.2 0.1 0.07 0.05 0.04 0.03 0.02,
 geosgcm_prog.fields:    'PHIS'     , 'AGCM'         ,
                         'SLP'      , 'DYN'          ,
                         'U;V'      , 'DYN'          ,
                         'T'        , 'DYN'          ,
                         'PS'       , 'DYN'          ,
                         'ZLE'      , 'DYN'          , 'H'   ,
                         'OMEGA'    , 'DYN'          ,
                         'Q'        , 'MOIST'        , 'QV'  ,
                         'QITOT'    , 'AGCM'         , 'QI'  ,
                         'QLTOT'    , 'AGCM'         , 'QL'  ,
                         'RH2'      , 'MOIST'        , 'RH'  ,
                         'O3'       , 'CHEMISTRY'    ,
                         ::