atmos_turbulence_convection.py

"""

A realm process specialization.

For further information goto http://wordpress.es-doc.org/cmip6-model-specializations.
"""
# --------------------------------------------------------------------
# INTERNAL (do not change)
# --------------------------------------------------------------------
from collections import OrderedDict

DETAILS = OrderedDict()
ENUMERATIONS = OrderedDict()

# --------------------------------------------------------------------
# DESCRIPTION: Short description of the specialization.
# --------------------------------------------------------------------
DESCRIPTION = 'Atmosphere Convective Turbulence and Clouds'

# --------------------------------------------------------------------
# SUB-PROCESS: boundary_layer_turbulence
# --------------------------------------------------------------------
DETAILS['boundary_layer_turbulence'] = {
    'description': 'Properties of the boundary layer turbulence scheme',
    'properties': [
        ('scheme_name', 'ENUM:boundary_layer_turbulence_scheme_name', '0.1',
             'Boundary layer turbulence scheme name'),
        ('scheme_type', 'ENUM:boundary_layer_turbulence_scheme_type', '1.N',
             'Boundary layer turbulence scheme type'),
        ('closure_order', 'int', '1.1',
             'Boundary layer turbulence scheme closure order'),
        ('counter_gradient', 'bool', '1.1',
            'Uses boundary layer turbulence scheme counter gradient'),
        ]
    }

# --------------------------------------------------------------------
# SUB-PROCESS: deep_convection_scheme
# --------------------------------------------------------------------
DETAILS['deep_convection'] = {
    'description': 'Properties of the deep convection scheme',
    'properties': [
        ('scheme_name', 'str', '0.1',
             'Deep convection scheme name'),
        ('scheme_type', 'ENUM:deep_convection_scheme_type', '1.N',
             'Deep convection scheme type'),
        ('scheme_method', 'ENUM:deep_convection_scheme_method', '1.N',
             'Deep convection scheme method'),
        ('processes', 'ENUM:deep_convection_scheme_processes', '1.N',
            'Physical processes taken into account in the parameterisation of deep convection'),
        ('microphysics', 'ENUM:convective_microphysics_scheme_type', '0.N',
            'Microphysics scheme for deep convection. Microphysical processes directly control '
            'the amount of detrainment of cloud hydrometeor and water vapor from updrafts'),
        ]
    }

# --------------------------------------------------------------------
# SUB-PROCESS: shallow_convection_scheme
# --------------------------------------------------------------------
DETAILS['shallow_convection'] = {
    'description': 'Properties of the shallow convection scheme',
    'properties': [
        ('scheme_name', 'str', '0.1',
             'Shallow convection scheme name'),
        ('scheme_type', 'ENUM:shallow_convection_scheme_type', '1.N',
             'shallow convection scheme type'),
        ('scheme_method', 'ENUM:shallow_convection_scheme_method', '1.1',
             'shallow convection scheme method'),
        ('processes', 'ENUM:shallow_convection_scheme_processes', '1.N',
            'Physical processes taken into account in the parameterisation of shallow convection'),
        ('microphysics', 'ENUM:convective_microphysics_scheme_type', '0.N',
            'Microphysics scheme for shallow convection'),
        ]
    }


# --------------------------------------------------------------------
# PROCESS: ENUMERATIONS
# --------------------------------------------------------------------


ENUMERATIONS['boundary_layer_turbulence_scheme_name'] = {
    'description': 'Commonly used name for the boundary layer turbulence scheme.',
    'is_open': True,
    'members': [
        ('Mellor-Yamada', None),
        ('Holtslag-Boville', None),
        ('EDMF', 'Combined Eddy Diffusivity Mass-Flux')
        ]
    }

ENUMERATIONS['boundary_layer_turbulence_scheme_type'] = {
    'description': 'Type of scheme used for the parameterisation of turbulence in the boundary layer.',
    'is_open': True,
    'members': [
        ('TKE prognostic', None),
        ('TKE diagnostic', None),
        ('TKE coupled with water', None),
        ('vertical profile of Kz', None),
        ('non-local diffusion', None),
        ('Monin-Obukhov similarity', None),
        ('Coastal Buddy Scheme', 'separate components for coastal near surface winds over ocean and land'),
        ('Coupled with convection', None),
        ('Coupled with gravity waves', None),
        ('Depth capped at cloud base', 'boundary layer capped at cloud base when convection is diagnosed')
        ]
    }

ENUMERATIONS['deep_convection_scheme_type'] = {
    'description': 'Type of scheme used for the parameterisation of deep convection.',
    'is_open': True,
    'members': [
        ('mass-flux', None),
        ('adjustment', None),
        ('plume ensemble', 'Zhang-McFarlane')
        ]
    }

ENUMERATIONS['deep_convection_scheme_method'] = {
    'description': 'Method used for deep convection closure for determining cloud-base mass flux.',
    'is_open': True,
    'members': [
        ('CAPE', 'Mass flux determined by CAPE, convectively available potential energy.'),
        ('bulk', 'A bulk mass flux scheme is used'),
        ('ensemble', 'Summation over an ensemble of convective clouds with differing characteristics'),
        ('CAPE/WFN based', 'CAPE-Cloud Work Function: Based on the quasi-equilibrium of the free troposphere'),
        ('TKE/CIN based', 'TKE-Convective Inhibition: Based on the quasi-equilibrium of the boundary layer'),
        ]
    }

ENUMERATIONS['shallow_convection_scheme_method'] = {
    'description': 'Method used for shallow convection closure for determining cloud-base mass flux..',
    'is_open': True,
    'members': [
        ('same as deep (unified)', None),
        ('included in boundary layer turbulence', None),
        ('separate diagnosis', 'Deep and Shallow convection schemes use different thermodynamic closure criteria'),
        ]
    }

ENUMERATIONS['shallow_convection_scheme_type'] = {
    'description': 'Type of scheme used for the parameterisation of shallow convection.',
    'is_open': True,
    'members': [
        ('mass-flux', None),
        ('cumulus-capped boundary layer', None)
        ]
    }

ENUMERATIONS['deep_convection_scheme_processes'] = {
    'description': 'Processes taken into account by the deep convection scheme',
    'is_open': True,
    'members': [
        ('vertical momentum transport', None),
        ('convective momentum transport', None),
        ('entrainment', None),
        ('detrainment', None),
        ('penetrative convection', None),
        ('updrafts', None),
        ('downdrafts', None),
        ('radiative effect of anvils', None),
        ('re-evaporation of convective precipitation', None),
        ]
    }

ENUMERATIONS['shallow_convection_scheme_processes'] = {
    'description': 'Processes taken into account by the shallow convection scheme',
    'is_open': True,
    'members': [
        ('convective momentum transport', None),
        ('entrainment', None),
        ('detrainment', None),
        ('penetrative convection', None),
        ('re-evaporation of convective precipitation', None),
    ]
    }

ENUMERATIONS['convective_microphysics_scheme_type'] = {
    'description': 'Convective microphysics parameterization scheme',
    'is_open': True,
    'members': [
        ('tuning parameter based', None),
        ('single moment', None),
        ('two moment', None),
    ]
}