icon_sc.icon.names — the ICON variable registry

ICON variable-registry seed (architecture §2.5, S06).

One literal table maps each canonical name to canonical units, CF standard name (where CF has one), ICON Fortran short name, and (later, for ingestion only) the GRIB2 triplet. Naming follows §2.5 as enforced by icon_sc.core.state.names: CF standard names are canonical and unprefixed; solver-internal quantities live in the icon: namespace.

Provenance (REFERENCES.lock, S06):

  • prognostics/tracers/diagnostics: icon4py v0.2.0 states/data.py short names (rho/w/theta_v/exner/vn/…) — the first 18 rows were seeded by S02 in icon_sc.core.state.names and are re-asserted (not re-registered) here;

  • interface-level fields pres_ifc/temp_ifc and the tendency-bus slots ddt_exner_phy (ICON t_nh_diag, mo_nonhydro_types.f90) and the ddt_temp*/ddt_q* family (ICON prm_nwp_tend naming, mo_nwp_phy_types.f90);

  • metric/reference-state fields z_mc/z_ifc/ddqz_z_full/ddqz_z_half/ *_ref_mc (ICON t_nh_metrics; icon4py metric_fields/ reference_atmosphere).

Unit-string discipline: Exner is "1" (PLAN pitfall — never “dimensionless”); tracer mass fractions are "1", their tendencies "s-1".

Importing this module seeds the registry (idempotently: rows already registered by icon_sc.core are verified for consistency instead). QUANTITIES (frozen interface) is the full table, insertion-ordered.

icon_sc.icon.names.QUANTITIES: Final[Mapping[str, QuantityDef]] = mappingproxy({'air_density': QuantityDef(name='air_density', units='kg m-3', cf_name='air_density', icon_name='rho', grib2=None), 'upward_air_velocity': QuantityDef(name='upward_air_velocity', units='m s-1', cf_name='upward_air_velocity', icon_name='w', grib2=None), 'icon:virtual_potential_temperature': QuantityDef(name='icon:virtual_potential_temperature', units='K', cf_name=None, icon_name='theta_v', grib2=None), 'icon:exner_function': QuantityDef(name='icon:exner_function', units='1', cf_name=None, icon_name='exner', grib2=None), 'icon:normal_wind': QuantityDef(name='icon:normal_wind', units='m s-1', cf_name=None, icon_name='vn', grib2=None), 'icon:tangential_wind': QuantityDef(name='icon:tangential_wind', units='m s-1', cf_name=None, icon_name='vt', grib2=None), 'specific_humidity': QuantityDef(name='specific_humidity', units='1', cf_name='specific_humidity', icon_name='qv', grib2=None), 'specific_cloud_content': QuantityDef(name='specific_cloud_content', units='1', cf_name='specific_cloud_content', icon_name='qc', grib2=None), 'specific_ice_content': QuantityDef(name='specific_ice_content', units='1', cf_name='specific_ice_content', icon_name='qi', grib2=None), 'specific_rain_content': QuantityDef(name='specific_rain_content', units='1', cf_name='specific_rain_content', icon_name='qr', grib2=None), 'specific_snow_content': QuantityDef(name='specific_snow_content', units='1', cf_name='specific_snow_content', icon_name='qs', grib2=None), 'specific_graupel_content': QuantityDef(name='specific_graupel_content', units='1', cf_name='specific_graupel_content', icon_name='qg', grib2=None), 'eastward_wind': QuantityDef(name='eastward_wind', units='m s-1', cf_name='eastward_wind', icon_name='u', grib2=None), 'northward_wind': QuantityDef(name='northward_wind', units='m s-1', cf_name='northward_wind', icon_name='v', grib2=None), 'air_temperature': QuantityDef(name='air_temperature', units='K', cf_name='air_temperature', icon_name='temp', grib2=None), 'air_virtual_temperature': QuantityDef(name='air_virtual_temperature', units='K', cf_name='air_virtual_temperature', icon_name='tempv', grib2=None), 'air_pressure': QuantityDef(name='air_pressure', units='Pa', cf_name='air_pressure', icon_name='pres', grib2=None), 'air_pressure_at_ground_level': QuantityDef(name='air_pressure_at_ground_level', units='Pa', cf_name='air_pressure_at_ground_level', icon_name='pres_sfc', grib2=None), 'air_pressure_on_interface_levels': QuantityDef(name='air_pressure_on_interface_levels', units='Pa', cf_name='air_pressure_on_interface_levels', icon_name='pres_ifc', grib2=None), 'air_temperature_on_interface_levels': QuantityDef(name='air_temperature_on_interface_levels', units='K', cf_name='air_temperature_on_interface_levels', icon_name='temp_ifc', grib2=None), 'altitude': QuantityDef(name='altitude', units='m', cf_name='altitude', icon_name='z_mc', grib2=None), 'altitude_on_interface_levels': QuantityDef(name='altitude_on_interface_levels', units='m', cf_name='altitude_on_interface_levels', icon_name='z_ifc', grib2=None), 'icon:ddqz_z_full': QuantityDef(name='icon:ddqz_z_full', units='m', cf_name=None, icon_name='ddqz_z_full', grib2=None), 'icon:ddqz_z_half': QuantityDef(name='icon:ddqz_z_half', units='m', cf_name=None, icon_name='ddqz_z_half', grib2=None), 'icon:exner_ref_mc': QuantityDef(name='icon:exner_ref_mc', units='1', cf_name=None, icon_name='exner_ref_mc', grib2=None), 'icon:theta_ref_mc': QuantityDef(name='icon:theta_ref_mc', units='K', cf_name=None, icon_name='theta_ref_mc', grib2=None), 'icon:rho_ref_mc': QuantityDef(name='icon:rho_ref_mc', units='kg m-3', cf_name=None, icon_name='rho_ref_mc', grib2=None), 'icon:ddt_temp': QuantityDef(name='icon:ddt_temp', units='K s-1', cf_name=None, icon_name='ddt_temp', grib2=None), 'icon:ddt_qv': QuantityDef(name='icon:ddt_qv', units='s-1', cf_name=None, icon_name='ddt_qv', grib2=None), 'icon:ddt_qc': QuantityDef(name='icon:ddt_qc', units='s-1', cf_name=None, icon_name='ddt_qc', grib2=None), 'icon:ddt_qi': QuantityDef(name='icon:ddt_qi', units='s-1', cf_name=None, icon_name='ddt_qi', grib2=None), 'icon:ddt_qr': QuantityDef(name='icon:ddt_qr', units='s-1', cf_name=None, icon_name='ddt_qr', grib2=None), 'icon:ddt_qs': QuantityDef(name='icon:ddt_qs', units='s-1', cf_name=None, icon_name='ddt_qs', grib2=None), 'icon:ddt_qg': QuantityDef(name='icon:ddt_qg', units='s-1', cf_name=None, icon_name='ddt_qg', grib2=None), 'icon:ddt_exner_phy': QuantityDef(name='icon:ddt_exner_phy', units='s-1', cf_name=None, icon_name='ddt_exner_phy', grib2=None), 'icon:ddt_vn_phy': QuantityDef(name='icon:ddt_vn_phy', units='m s-2', cf_name=None, icon_name='ddt_vn_phy', grib2=None), 'icon:ddt_temperature_slow': QuantityDef(name='icon:ddt_temperature_slow', units='K s-1', cf_name=None, icon_name=None, grib2=None), 'icon:qnc': QuantityDef(name='icon:qnc', units='m-3', cf_name=None, icon_name='qnc', grib2=None), 'icon:rain_gsp_rate': QuantityDef(name='icon:rain_gsp_rate', units='kg m-2 s-1', cf_name=None, icon_name='rain_gsp_rate', grib2=None), 'icon:snow_gsp_rate': QuantityDef(name='icon:snow_gsp_rate', units='kg m-2 s-1', cf_name=None, icon_name='snow_gsp_rate', grib2=None), 'icon:ice_gsp_rate': QuantityDef(name='icon:ice_gsp_rate', units='kg m-2 s-1', cf_name=None, icon_name='ice_gsp_rate', grib2=None), 'icon:graupel_gsp_rate': QuantityDef(name='icon:graupel_gsp_rate', units='kg m-2 s-1', cf_name=None, icon_name='graupel_gsp_rate', grib2=None), 'icon:inv_ddqz_z_full': QuantityDef(name='icon:inv_ddqz_z_full', units='m-1', cf_name=None, icon_name='inv_ddqz_z_full', grib2=None), 'icon:ddqz_z_full_e': QuantityDef(name='icon:ddqz_z_full_e', units='m', cf_name=None, icon_name='ddqz_z_full_e', grib2=None), 'icon:scalfac_dd3d': QuantityDef(name='icon:scalfac_dd3d', units='1', cf_name=None, icon_name='scalfac_dd3d', grib2=None), 'icon:rayleigh_w': QuantityDef(name='icon:rayleigh_w', units='1', cf_name=None, icon_name='rayleigh_w', grib2=None), 'icon:coeff1_dwdz': QuantityDef(name='icon:coeff1_dwdz', units='m-1', cf_name=None, icon_name='coeff1_dwdz', grib2=None), 'icon:coeff2_dwdz': QuantityDef(name='icon:coeff2_dwdz', units='m-1', cf_name=None, icon_name='coeff2_dwdz', grib2=None), 'icon:theta_ref_ic': QuantityDef(name='icon:theta_ref_ic', units='K', cf_name=None, icon_name='theta_ref_ic', grib2=None), 'icon:theta_ref_me': QuantityDef(name='icon:theta_ref_me', units='K', cf_name=None, icon_name='theta_ref_me', grib2=None), 'icon:rho_ref_me': QuantityDef(name='icon:rho_ref_me', units='kg m-3', cf_name=None, icon_name='rho_ref_me', grib2=None), 'icon:d_exner_dz_ref_ic': QuantityDef(name='icon:d_exner_dz_ref_ic', units='m-1', cf_name=None, icon_name='d_exner_dz_ref_ic', grib2=None), 'icon:d2dexdz2_fac1_mc': QuantityDef(name='icon:d2dexdz2_fac1_mc', units='m-1', cf_name=None, icon_name='d2dexdz2_fac1_mc', grib2=None), 'icon:d2dexdz2_fac2_mc': QuantityDef(name='icon:d2dexdz2_fac2_mc', units='m-2', cf_name=None, icon_name='d2dexdz2_fac2_mc', grib2=None), 'icon:ddxn_z_full': QuantityDef(name='icon:ddxn_z_full', units='1', cf_name=None, icon_name='ddxn_z_full', grib2=None), 'icon:ddxt_z_full': QuantityDef(name='icon:ddxt_z_full', units='1', cf_name=None, icon_name='ddxt_z_full', grib2=None), 'icon:vwind_impl_wgt': QuantityDef(name='icon:vwind_impl_wgt', units='1', cf_name=None, icon_name='vwind_impl_wgt', grib2=None), 'icon:vwind_expl_wgt': QuantityDef(name='icon:vwind_expl_wgt', units='1', cf_name=None, icon_name='vwind_expl_wgt', grib2=None), 'icon:exner_exfac': QuantityDef(name='icon:exner_exfac', units='1', cf_name=None, icon_name='exner_exfac', grib2=None), 'icon:wgtfac_c': QuantityDef(name='icon:wgtfac_c', units='1', cf_name=None, icon_name='wgtfac_c', grib2=None), 'icon:wgtfac_e': QuantityDef(name='icon:wgtfac_e', units='1', cf_name=None, icon_name='wgtfac_e', grib2=None), 'icon:wgtfacq_c': QuantityDef(name='icon:wgtfacq_c', units='1', cf_name=None, icon_name='wgtfacq_c', grib2=None), 'icon:wgtfacq_e': QuantityDef(name='icon:wgtfacq_e', units='1', cf_name=None, icon_name='wgtfacq_e', grib2=None), 'icon:pg_exdist': QuantityDef(name='icon:pg_exdist', units='m', cf_name=None, icon_name='pg_exdist', grib2=None), 'icon:mask_prog_halo_c': QuantityDef(name='icon:mask_prog_halo_c', units='1', cf_name=None, icon_name='mask_prog_halo_c', grib2=None), 'icon:hmask_dd3d': QuantityDef(name='icon:hmask_dd3d', units='1', cf_name=None, icon_name='hmask_dd3d', grib2=None), 'icon:zdiff_gradp': QuantityDef(name='icon:zdiff_gradp', units='m', cf_name=None, icon_name='zdiff_gradp', grib2=None), 'icon:vertoffset_gradp': QuantityDef(name='icon:vertoffset_gradp', units='1', cf_name=None, icon_name='vertoffset_gradp', grib2=None), 'icon:nflat_gradp': QuantityDef(name='icon:nflat_gradp', units='1', cf_name=None, icon_name='nflat_gradp', grib2=None), 'icon:coeff_gradekin': QuantityDef(name='icon:coeff_gradekin', units='m-1', cf_name=None, icon_name='coeff_gradekin', grib2=None), 'icon:zd_diffcoef': QuantityDef(name='icon:zd_diffcoef', units='1', cf_name=None, icon_name='zd_diffcoef', grib2=None), 'icon:zd_intcoef': QuantityDef(name='icon:zd_intcoef', units='1', cf_name=None, icon_name='zd_intcoef', grib2=None), 'icon:zd_vertoffset': QuantityDef(name='icon:zd_vertoffset', units='1', cf_name=None, icon_name='zd_vertoffset', grib2=None), 'icon:geopot': QuantityDef(name='icon:geopot', units='m2 s-2', cf_name=None, icon_name='geopot', grib2=None), 'icon:c_lin_e': QuantityDef(name='icon:c_lin_e', units='1', cf_name=None, icon_name='c_lin_e', grib2=None), 'icon:e_bln_c_s': QuantityDef(name='icon:e_bln_c_s', units='1', cf_name=None, icon_name='e_bln_c_s', grib2=None), 'icon:geofac_div': QuantityDef(name='icon:geofac_div', units='m-1', cf_name=None, icon_name='geofac_div', grib2=None), 'icon:geofac_rot': QuantityDef(name='icon:geofac_rot', units='m-1', cf_name=None, icon_name='geofac_rot', grib2=None), 'icon:geofac_n2s': QuantityDef(name='icon:geofac_n2s', units='m-2', cf_name=None, icon_name='geofac_n2s', grib2=None), 'icon:geofac_grdiv': QuantityDef(name='icon:geofac_grdiv', units='m-2', cf_name=None, icon_name='geofac_grdiv', grib2=None), 'icon:geofac_grg_x': QuantityDef(name='icon:geofac_grg_x', units='m-1', cf_name=None, icon_name='geofac_grg_x', grib2=None), 'icon:geofac_grg_y': QuantityDef(name='icon:geofac_grg_y', units='m-1', cf_name=None, icon_name='geofac_grg_y', grib2=None), 'icon:nudgecoeff_e': QuantityDef(name='icon:nudgecoeff_e', units='1', cf_name=None, icon_name='nudgecoeff_e', grib2=None), 'icon:rbf_vec_coeff_v1': QuantityDef(name='icon:rbf_vec_coeff_v1', units='1', cf_name=None, icon_name='rbf_vec_coeff_v1', grib2=None), 'icon:rbf_vec_coeff_v2': QuantityDef(name='icon:rbf_vec_coeff_v2', units='1', cf_name=None, icon_name='rbf_vec_coeff_v2', grib2=None), 'icon:rbf_vec_coeff_e': QuantityDef(name='icon:rbf_vec_coeff_e', units='1', cf_name=None, icon_name='rbf_vec_coeff_e', grib2=None), 'icon:c_intp': QuantityDef(name='icon:c_intp', units='1', cf_name=None, icon_name='c_intp', grib2=None), 'icon:pos_on_tplane_e_x': QuantityDef(name='icon:pos_on_tplane_e_x', units='m', cf_name=None, icon_name='pos_on_tplane_e_x', grib2=None), 'icon:pos_on_tplane_e_y': QuantityDef(name='icon:pos_on_tplane_e_y', units='m', cf_name=None, icon_name='pos_on_tplane_e_y', grib2=None), 'icon:e_flx_avg': QuantityDef(name='icon:e_flx_avg', units='1', cf_name=None, icon_name='e_flx_avg', grib2=None)})

canonical name → QuantityDef, in table order.

Type:

The ICON registry-seed table (frozen interface, SPEC S06)