diag_table_standard_source.yaml

#######################################################################################################
# This yaml file is used by make_diag_table.py to create a diag_table file specifying MOM5 diagnostics.
# Latest version: https://github.com/COSIMA/make_diag_table
#
# Define the diagnostics you want in the diag_table section below.
#
# The MOM diag_table format is defined here:
# https://github.com/mom-ocean/MOM5/blob/master/src/shared/diag_manager/diag_table.F90
# https://mom6.readthedocs.io/en/main/api/generated/pages/Diagnostics.html
#######################################################################################################


# Define global default settings which will be applied to all diagnostics,
# unless overridden in diag_table section below, either in defaults or individual fields.
# You're unlikely to need to change any of the global_defaults.
global_defaults:
# global_section:
    title: ACCESS-ESM_CMIP6  # any string
    base_date: [ 0001, 1, 1, 0, 0, 0 ]  # reference time used for the time units. six integers: year, month, day, hour, minute, second
# file section:
    file_name:  # String, or list of components, for file name (without trailing ".nc").
    # If a list, its elements are a mixture of strings and dictionaries.
    # String list elements are concatenated, each preceded by file_name_separator.
    # Dictionary list elements must have one key-value pair; the value is a list
    # containing 1 or more strings to be concatenated, each preceded by the key
    # (a string) instead of file_name_separator. The key may be an empty string,
    # which is useful if file_name_date begins with %, since FMS prepends _ .
    # All filename list string elements (other than field_name) must exist as keys in global_defaults.
    # If file_name_date is used, it must be the last item.
    # Key values are looked up, converted to strings and then substituted using file_name_substitutions.
    # Empty strings (and their preceding separator) are ignored if file_name_omit_empty is true.
    # A separator is not used prior to the first item.
        - file_name_prefix
        - file_name_dimension
        - field_name  # substituted by field name in diag_table section below
        - output_freq
        - '':
            - output_freq_units
        - reduction_method
        - file_name_date
    output_freq: 1  # integer: output sampling frequency in output_freq_units (0: every timestep; -1: only at end of run)
    output_freq_units: months  # time units for output: years, months, days, hours, minutes, or seconds
    file_format: 1  # integer, must be 1, specifying NetCDF (the only format currently supported)
    time_axis_units: days  # time units for the output file time axis: years, months, days, hours, minutes, or seconds
    time_axis_name: time  # must be "time" (case-insensitive)
    new_file_freq: 1  # optional integer: frequency (in new_file_freq_units) for closing the existing file, and creating a new file
    new_file_freq_units: years  # time units for new_file_freq: years, months, days, hours, minutes, or seconds (optional; required if and only if new_file_freq specified)
    start_time:  # Time to start the file for the first time. The format of this string is the same as base_date (optional; requires new_file_freq, new_file_freq_units)
    file_duration:  # integer: How long file should receive data after start time (optional; requires new_file_freq, new_file_freq_units, start_time)
    file_duration_units:  # units for file_duration: years, months, days, hours, minutes, or seconds (optional; required if and only if file_duration specified)
# field section:
    module_name: ocean_model
    field_name:  # set via keys in the fields section of the diag_table section below
    output_name:  # same as field_name unless overridden
    # file_name:  # same as file_name in file section above unless overridden in diag_table section below
    time_sampling: all  # Currently not used.  Please use the string "all".
    reduction_method: mean  # mean, snap, rms, pow##, min, max, or diurnal##
    # reduction_method options:
    #     mean or average or true: Average from the last time written to the current time. Becomes "average" in diag_table.
    #     snap or none or false: No reduction.  Write snapshot of current time step value only. Becomes "none" in diag_table.
    #     rms: Calculate the root mean square from the last time written to the current time.
    #     pow##: Calculate the mean of the power ## from the last time written to the current time.
    #     min: Minimum value from last write to current time.
    #     max: Maximum value from last write to current time.
    #     diurnal##: ## diurnal averages
    regional_section: none  # string: bounds of the regional section to capture ("none" indicates a global region). String format: lat_min, lat_max, lon_min, lon_max, vert_min, vert_max. Use vert_min = -1 and vert_max = -1 to get the entire vertical axis.
    packing: 2
    # packing is the Fortran number KIND of the data written:
    #     1: double precision
    #     2: float (single precision)
    #     4: packed 16-bit integers
    #     8: packed 1-byte (not tested)
# extra things for constructing filename:
    file_name_dimension: 3d  # descriptor for filename, e.g. 3d, 2d, scalar
    file_name_prefix: ocean
    file_name_date: "ym%4yr%2mo"  # run date/time of file opening; format: %, 1 digit (#digits), one of (yr, mo, dy, hr, mi, sc); date/time components will be separated by _ in filename.
    file_name_separator: "-"  # used to separate filename components; best not to use "_" to avoid confusion with fields and dates
    file_name_omit_empty: true  # whether to omit empty filename components to avoid duplicate file_name_separator
    file_name_substitutions:  # string replacements for filename components
        years: yearly
        months: monthly
        days: daily
        hours: hourly
        none: snap  # careful! will apply to both reduction_method and regional_section
        'False': snap
        average: mean
        'True': mean
        None: ""  # for empty items


#######################################################################################################
# diag_table section - this defines the diagnostics that will appear in diag_table.
# 
# Top-level categories in diag_table have arbitrary names (they're just used for
# comments in the output diag_table). Make as many of these as you like to group
# similar diagnostics with shared defaults. Note that each of the top-level
# categories can have only have one instance of each field name, so if you need
# multiple outputs of the same field (e.g. as both averages and snapshots), you’ll
# need to make additional categories.
# 
# Within each top-level category there's an optional defaults section and a
# fields section. The defaults section overrides items in global_defaults for
# all fields in the category. The field section specifies diagnostic field
# names. To add a new diagnostic, all you need to do is add its name to the
# field section in the appropriate category. Each field name can be followed by
# a dictionary overriding the category and global defaults for that field only.
# 
# Some of the available diagnostics are listed here:
# https://raw.githubusercontent.com/COSIMA/access-om2/master/MOM_diags.txt
# https://github.com/COSIMA/access-om2/wiki/Technical-documentation#MOM5-diagnostics-list
diag_table:
    'static 2d grid data':
        defaults:  # these can be overridden for individual fields below
            file_name_dimension: 2d  # descriptor for filename, e.g. 3d, 2d, scalar
            file_name:  # String, or list of components, for file name (without trailing ".nc").
            # If a list, its elements are a mixture of strings and dictionaries.
            # String list elements are concatenated, each preceded by file_name_separator.
            # Dictionary list elements must have one key-value pair; the value is a list
            # containing 1 or more strings to be concatenated, each preceded by the key
            # (a string) instead of file_name_separator. The key may be an empty string,
            # which is useful if file_name_date begins with %, since FMS prepends _ .
            # All filename list string elements (other than field_name) must exist as keys in global_defaults.
            # If file_name_date is used, it must be the last item.
            # Key values are looked up, converted to strings and then substituted using file_name_substitutions.
            # Empty strings (and their preceding separator) are ignored if file_name_omit_empty is true.
            # A separator is not used prior to the first item.
                - file_name_prefix
                - file_name_dimension
                - field_name  # substituted by field name in fields section below
            reduction_method: snap  # mean, snap, rms, pow##, min, max, or diurnal##
            output_freq: -1  # Output frequency in output_freq_units (0: every timestep; -1: only at end of run)
            new_file_freq:  # optional integer: frequency (in new_file_freq_units) for closing the existing file, and creating a new file
        fields:
            area_t:
            area_u:
            geolat_c:
            geolat_t:
            geolon_c:
            geolon_t:
            ht:
            hu:
            kmt:
            kmu:
            pbot0:
            tide_speed_wave:
            roughness_length:
            roughness_amp:
            visc_crit_bih:
            tide_speed_drag:
            tide_speed_mask:

    'yearly 3d ocean fields':
        defaults:  # these can be overridden for individual fields below
            file_name_dimension: 3d  # descriptor for filename, e.g. 3d, 2d, scalar
            output_freq: 1  # integer: output sampling frequency in output_freq_units (0: every timestep; -1: only at end of run)
            output_freq_units: years  # time units for output: years, months, days, hours, minutes, or seconds
        fields:
            tx_trans_rho:
            tx_trans_rho_gm: 
            tx_trans_gm:
            tx_trans:
            tz_trans:
            tx_trans_submeso:
            ty_trans_submeso:
            tz_trans_sq:
            rho_dzt:
            pot_rho_0:
            sw_heat:
            sw_frac:
            temp_rivermix:
            temp_tendency_expl:
            salt_tendency_expl:
            temp_submeso:
            salt_submeso:
            neutral_rho:
            pot_rho_2:
            drhodtheta:
            drhodsalinity:
            cabbeling:
            thermobaricity:
            mixdownslope_temp:
            mixdownslope_salt:
            diff_cbt_wave:
            diff_cbt_drag:
            mix_efficiency:
            power_diss_wave:
            power_diss_drag:
            diff_cbt_kpp_t:
            diff_cbt_kpp_s:
            temp_xflux_adv:
            temp_yflux_adv:
            temp_zflux_adv:
            salt_xflux_adv:
            salt_yflux_adv:
            salt_zflux_adv:
            lap_fric_u:
            lap_fric_v:
            wt:
            wrhot:

    'monthly 3d ocean fields':
        defaults:  # these can be overridden for individual fields below
            file_name_dimension: 3d  # descriptor for filename, e.g. 3d, 2d, scalar
            output_freq: 1  # integer: output sampling frequency in output_freq_units (0: every timestep; -1: only at end of run)
            output_freq_units: months  # time units for output: years, months, days, hours, minutes, or seconds
        fields:
            temp:
            pot_temp:
            salt:
            age_global:
            press:
            rho:
            bv_freq:
            ty_trans:
            ty_trans_gm:
            ty_trans_rho:
            ty_trans_rho_gm:
            u:
            v:
            temp_tendency:
            salt_tendency:
            dzt:
            temp_vdiffuse_impl:
            salt_vdiffuse_impl:

    'monthly 3d BGC fields':
        defaults:  # these can be overridden for individual fields below
            file_name_prefix: oceanbgc
            file_name_dimension: 3d  # descriptor for filename, e.g. 3d, 2d, scalar
            output_freq: 1  # integer: output sampling frequency in output_freq_units (0: every timestep; -1: only at end of run)
            output_freq_units: months  # time units for output: years, months, days, hours, minutes, or seconds
        fields:
            no3:
            phy:
            o2:
            det:
            zoo:
            caco3:
            dic:
            alk:
            adic:
            fe:
            pprod_gross:

    'monthly 2d ocean fields':
        defaults:  # these can be overridden for individual fields below
            file_name_dimension: 2d  # descriptor for filename, e.g. 3d, 2d, scalar
            output_freq: 1  # integer: output sampling frequency in output_freq_units (0: every timestep; -1: only at end of run)
            output_freq_units: months  # time units for output: years, months, days, hours, minutes, or seconds
        fields:
            pbot_t:
            patm_t:
            sea_level:
            sea_level_sq:
            surface_temp:
            squared_surface_temp:
            surface_salt:
            mld:
            mld_sq:
            lprec:
            fprec:
            evap:
            runoff:
            melt:
            pme_river:
            sfc_salt_flux_ice:
            sfc_salt_flux_runoff:
            sfc_hflux_from_water_prec:
            sfc_hflux_from_water_evap:
            sfc_hflux_from_runoff:
            fprec_melt_heat:
            lw_heat:
            evap_heat:
            sens_heat:
            swflx:
            agm:
            frazil_2d:
            pme:
            pme_sbc:
            river:
            swflx_vis:
            sfc_hflux_coupler:
            sfc_hflux_pme:
            temp_runoff:
            wfimelt:
            wfiform:
            anompb:
            eta_t:
            conv_rho_ud_t:
            bottom_temp:
            bottom_salt:
            bottom_age_global:
            potrho_mix_base:
            potrho_mix_depth:
            temp_sigma:
            eddy_depth:
            agm_grid_scaling:
            rossby:
            rossby_radius:
            buoy_freq_ave_submeso:
            hblt_submeso:
            bvfreq_bottom:
            power_waves:
            energy_flux:
            langmuirfactor:
            psiu:
            temp_sigma_diff_xflux_int_z:
            temp_sigma_diff_yflux_int_z:
            temp_xflux_submeso_int_z:
            temp_yflux_submeso_int_z:
            salt_xflux_ndiffuse_int_z:
            salt_yflux_ndiffuse_int_z:
            temp_xflux_ndiffuse_int_z:
            temp_yflux_ndiffuse_int_z:
            ekman_we:
            psiv:
            tau_curl:
            tau_x:
            tau_y:
            eta_u:
            urhod:
            vrhod:
            usurf:
            vsurf:
            ubott:
            vbott:
            viscosity_scaling:
            bmf_u:
            bmf_v:
            bottom_power_u:
            bottom_power_v:
            wind_power_u:
            wind_power_v:
            hblt: {reduction_method: 'max'}

    'monthly 2d BGC fields':
        defaults:  # these can be overridden for individual fields below
            file_name_prefix: oceanbgc
            file_name_dimension: 2d  # descriptor for filename, e.g. 3d, 2d, scalar
            output_freq: 1  # integer: output sampling frequency in output_freq_units (0: every timestep; -1: only at end of run)
            output_freq_units: months  # time units for output: years, months, days, hours, minutes, or seconds
        fields:
            stf03:
            stf07:
            stf09:
            stf10:
            pco2:
            paco2:
            pprod_gross_2d:
            atm_co2:
            wnd:
            det_sediment:
            caco3_sediment:
            surface_no3:
            surface_phy:
            surface_alk:
            surface_dic:
            surface_adic:
            surface_o2:

    'monthly 1d ocean fields':
        defaults:  # these can be overridden for individual fields below
            file_name_dimension: 1d  # descriptor for filename, e.g. 3d, 2d, scalar
            output_freq: 1  # integer: output sampling frequency in output_freq_units (0: every timestep; -1: only at end of run)
            output_freq_units: months  # time units for output: years, months, days, hours, minutes, or seconds
            file_name:
                - file_name_prefix
                - file_name_dimension
                - output_freq
                - '':
                    - output_freq_units
                - file_name_date
        fields:
            geolat_c: {reduction_method: 'snap'} # See https://github.com/ACCESS-NRI/access-esm1.5-configs/issues/74
            temp_merid_flux_advect_global:
            temp_merid_flux_over_global:
            temp_merid_flux_gyre_global:
            salt_merid_flux_advect_global:
            salt_merid_flux_over_global:
            salt_merid_flux_gyre_global:
            temp_merid_flux_advect_southern:
            temp_merid_flux_over_southern:
            temp_merid_flux_gyre_southern:
            salt_merid_flux_advect_southern:
            salt_merid_flux_over_southern:
            salt_merid_flux_gyre_southern:
            temp_merid_flux_advect_atlantic:
            temp_merid_flux_over_atlantic:
            temp_merid_flux_gyre_atlantic:
            salt_merid_flux_advect_atlantic:
            salt_merid_flux_over_atlantic:
            salt_merid_flux_gyre_atlantic:
            temp_merid_flux_advect_pacific:
            temp_merid_flux_over_pacific:
            temp_merid_flux_gyre_pacific:
            salt_merid_flux_advect_pacific:
            salt_merid_flux_over_pacific:
            salt_merid_flux_gyre_pacific:
            temp_merid_flux_advect_arctic:
            temp_merid_flux_over_arctic:
            temp_merid_flux_gyre_arctic:
            salt_merid_flux_advect_arctic:
            salt_merid_flux_over_arctic:
            salt_merid_flux_gyre_arctic:
            temp_merid_flux_advect_indian:
            temp_merid_flux_over_indian:
            temp_merid_flux_gyre_indian:
            salt_merid_flux_advect_indian:
            salt_merid_flux_over_indian:
            salt_merid_flux_gyre_indian:
            
    'monthly scalar ocean fields':
        defaults:  # these can be overridden for individual fields below
            file_name_dimension: scalar  # descriptor for filename, e.g. 3d, 2d, scalar
            output_freq: 1  # integer: output sampling frequency in output_freq_units (0: every timestep; -1: only at end of run)
            output_freq_units: months  # time units for output: years, months, days, hours, minutes, or seconds
            file_name:
                - file_name_prefix
                - file_name_dimension
                - output_freq
                - '':
                    - output_freq_units
                - file_name_date
        fields:
            total_mass_seawater:
            total_volume_seawater:
            eta_global:
            eta_adjust:
            pbot_adjust:
            temp_global_ave:
            salt_global_ave:
            total_ocean_pme_river:
            total_ocean_river:
            total_ocean_evap:
            total_ocean_pme_sbc:
            total_ocean_fprec:
            total_ocean_lprec:
            total_ocean_runoff:
            total_ocean_salt:
            total_ocean_heat:
            total_ocean_hflux_pme:
            total_ocean_swflx:
            total_ocean_swflx_vis:
            total_ocean_evap_heat:
            total_ocean_lw_heat:
            total_ocean_sens_heat:
            total_ocean_fprec_melt_heat:
            total_ocean_runoff_heat:
            ke_tot:
            pe_tot:
            temp_surface_ave:
            salt_surface_ave:

    'monthly scalar BGC fields':
        defaults:  # these can be overridden for individual fields below
            file_name_prefix: oceanbgc
            file_name_dimension: scalar  # descriptor for filename, e.g. 3d, 2d, scalar
            output_freq: 1  # integer: output sampling frequency in output_freq_units (0: every timestep; -1: only at end of run)
            output_freq_units: months  # time units for output: years, months, days, hours, minutes, or seconds
            file_name:
                - file_name_prefix
                - file_name_dimension
                - output_freq
                - '':
                    - output_freq_units
                - file_name_date
        fields:
            total_co2_flux:
            total_aco2_flux: