Climatology Handles/GUIDS¶

Climatology handles are a mechanism used in the Sasktran framework to label physical quantities such as pressure, temperature and number density. Standard names are used so that components, such as climatology objects, can be used interchangeably within the framework. Within the C++ Sasktran code the climatology handles are implemented as 128 bit structures called GUIDs which are guaranteed to be Globally Unique IDentifiers while the SasktranIF implements the GUIDs as strings. Keep in mind that almost all climatology objects only support a small sub-set of the physical quantities listed below, see the documentation for each climatology object.

In Matlab and Python the GUID is surrounded by the stringizing character, ‘, to make the GUID a simple string; we also note that many of the current GUIDs are exported by the sasktranif.sasktranif module and may be used instead of the string form. Matlab users must use strings.

Users can only use the GUIDs listed below, they are not yet able to define their own GUIDs.

Atmospheric State GUIDS¶

GUID String Species Units

SKCLIMATOLOGY_AIRNUMBERDENSITY_CM3 Air number density Molecules per cm3.

SKCLIMATOLOGY_PRESSURE_PA Pressure Pascals

SKCLIMATOLOGY_TEMPERATURE_K Temperature Kelvins

SKCLIMATOLOGY_POTENTIAL_TEMPERATURE_K Potential temperature Kelvins

SKCLIMATOLOGY_ALBEDO Albedo No units

SKCLIMATOLOGY_EPV Ertels Potential Vorticity

SKCLIMATOLOGY_GEOMETRIC_HEIGHT Geometric height.

SKCLIMATOLOGY_GEOPOTENTIAL_HEIGHT Geopotential height.

SKCLIMATOLOGY_SURFACE_GEOPOTENTIAL_HEIGHT Surface Geopotential Height

SKCLIMATOLOGY_SURFACE_PRESSURE_PA Surface Pressure

SKCLIMATOLOGY_CLOUD_FRACTION Cloud fraction

SKCLIMATOLOGY_QI_MMR Mass fraction of cloud ice water

SKCLIMATOLOGY_QL_MMR Mass fraction of cloud liquid water

SKCLIMATOLOGY_QV Specific Humidity

SKCLIMATOLOGY_RH Relative Humidity

SKCLIMATOLOGY_AOA_DAYS Age of Air Days

Aerosol GUIDS¶

GUID String Species Units

SKCLIMATOLOGY_AEROSOL_CM3 Aerosol. Mean particle number density per cm³

SKCLIMATOLOGY_AEROSOLH2SO4_CM3 Sulphate aerosol. Mean particle number density per cm³

SKCLIMATOLOGY_AEROSOLDUST_CM3 Dust aerosol. Mean particle number density per cm³

SKCLIMATOLOGY_AEROSOLICE_CM3 Ice aerosol. Mean particle number density per cm³

SKCLIMATOLOGY_AEROSOLWATER_CM3 Water aerosol Mean particle number density per cm³

SKCLIMATOLOGY_ICE_CM3 Ice Ice crystal number density per cm³

SKCLIMATOLOGY_AEROSOL_EXTINCTIONPERKM Extinction Extinction per km

SKCLIMATOLOGY_LOGNORMAL_MODERADIUS_MICRONS Log-Normal Mode Radius Microns

SKCLIMATOLOGY_LOGNORMAL_MODEWIDTH Log-Normal Mode width No Units

SKCLIMATOLOGY_EFFECTIVESIZE_MICRONS Aerosol Effective Size Microns

SKCLIMATOLOGY_AEROSOLSURFACEAREA_UM2PerCM3 Aerosol Surface Area um²cm^-3

SKCLIMATOLOGY_DUST_0p7mu Dust Aerosol, R_eff0.7 um

SKCLIMATOLOGY_DUST_1p4mu Dust Aerosol, R_eff1.4 um

SKCLIMATOLOGY_DUST_2p4mu Dust Aerosol, R_eff2.4 um

SKCLIMATOLOGY_DUST_4p5mu Dust Aerosol, R_eff4.5 um

SKCLIMATOLOGY_BCPI Geos Chem Black Carbon I

SKCLIMATOLOGY_BCPO Geos Chem Black Carbon O

SKCLIMATOLOGY_SALA Geos Chem Sea Salt aerosol Accum

SKCLIMATOLOGY_SALC Geos Chem Sea Salt aerosol Coarse

SKCLIMATOLOGY_OCPI Geos Chem Organic Carbon Aerosol I

SKCLIMATOLOGY_OCPO Geos Chem Organic Carbon Aerosol O

Molecular Number Density GUIDS¶

GUID String Species Units

SKCLIMATOLOGY_Ar_CM3 Argon Atoms per cm³

SKCLIMATOLOGY_BRCL_CM3 BrCl Molecules per cm³

SKCLIMATOLOGY_BRNO3_CM3 BrNO₃ Molecules per cm³

SKCLIMATOLOGY_BRO_CM3 BrO Molecules per cm³

SKCLIMATOLOGY_BRX_CM3 BrX Molecules per cm³

SKCLIMATOLOGY_BRY_CM3 BrY Molecules per cm³

SKCLIMATOLOGY_BR_CM3 Br Molecules per cm³

SKCLIMATOLOGY_C2H2_CM3 C₂H₂ Molecules per cm³

SKCLIMATOLOGY_C2H4_CM3 C₂H₄ Molecules per cm³

SKCLIMATOLOGY_C2H6_CM3 C₂H₆ Molecules per cm³

SKCLIMATOLOGY_C3H6O_CM3 C₃H₆O Acetone Molecules per cm³

SKCLIMATOLOGY_C5H8_CM3 C₅H₈ Isoprene Molecules per cm³

SKCLIMATOLOGY_CCL4_CM3 CCl₄ Molecules per cm³

SKCLIMATOLOGY_CF2CL2_CM3 CF₂Cl₂ Molecules per cm³

SKCLIMATOLOGY_CF4_CM3 CF₄ Molecules per cm³

SKCLIMATOLOGY_CFCL3_CM3 CFCl₃ Molecules per cm³

SKCLIMATOLOGY_CH2O_CM3 CH₂O Formaldehyde Molecules per cm³

SKCLIMATOLOGY_CH3BR_CM3 CH₃Br Molecules per cm³

SKCLIMATOLOGY_CH3CL_CM3 CH₃Cl Molecules per cm³

SKCLIMATOLOGY_CH3CN_CM3 CH₃CN Molecules per cm³

SKCLIMATOLOGY_CH3I_CM3 CH₃I Methyl iodide Molecules per cm³

SKCLIMATOLOGY_CH3OH_CM3 CH₃OH Molecules per cm³

SKCLIMATOLOGY_CH4_CM3 CH₄ Methane Molecules per cm³

SKCLIMATOLOGY_CL2O2_CM3 Cl₂O₂ Molecules per cm³

SKCLIMATOLOGY_CL2_CM3 Cl₂ Molecules per cm³

SKCLIMATOLOGY_CLNO3_CM3 CLNO₃ Molecules per cm³

SKCLIMATOLOGY_CLONO2_CM3 ClONO₂ Molecules per cm³

SKCLIMATOLOGY_CLO_CM3 ClO Molecules per cm³

SKCLIMATOLOGY_CLY_CM3 ClY Molecules per cm³

SKCLIMATOLOGY_CL_CM3 Cl Molecules per cm³

SKCLIMATOLOGY_CO2_CM3 CO₂ Molecules per cm³

SKCLIMATOLOGY_COF2_CM3 COF₂ Molecules per cm³

SKCLIMATOLOGY_CO_CM3 CO Molecules per cm³

SKCLIMATOLOGY_H2CO_CM3 H₂CO Molecules per cm³

SKCLIMATOLOGY_H2O2_CM3 H₂O₂ Molecules per cm³

SKCLIMATOLOGY_H2O_CM3 H₂O Molecules per cm³

SKCLIMATOLOGY_H2S_CM3 H₂S Molecules per cm³

SKCLIMATOLOGY_H2_CM3 H₂ Molecules per cm³

SKCLIMATOLOGY_HBR_CM3 HBr Molecules per cm³

SKCLIMATOLOGY_HCL_CM3 HCl Molecules per cm³

SKCLIMATOLOGY_HCN_CM3 HCN Molecules per cm³

SKCLIMATOLOGY_HCOOH_CM3 HCOOH Molecules per cm³

SKCLIMATOLOGY_HF_CM3 HF Molecules per cm³

SKCLIMATOLOGY_HI_CM3 HI Molecules per cm³

SKCLIMATOLOGY_HNO2_CM3 HNO₂ Nitrous Acid Molecules per cm³

SKCLIMATOLOGY_HNO3_CM3 HNO₃ Nitric Acid Molecules per cm³

SKCLIMATOLOGY_HNO4_CM3 HNO₄ Molecules per cm³

SKCLIMATOLOGY_HO2_CM3 HO₂ Molecules per cm³

SKCLIMATOLOGY_HOBR_CM3 HOBr Molecules per cm³

SKCLIMATOLOGY_HOCL_CM3 HOCl Molecules per cm³

SKCLIMATOLOGY_H_CM3 H Atoms per cm³

SKCLIMATOLOGY_He_CM3 He Molecules per cm³

SKCLIMATOLOGY_MECL_CM3 MECl Molecules per cm³

SKCLIMATOLOGY_N_CM3 N Atoms per cm³

SKCLIMATOLOGY_N2O5_CM3 N₂O₅ Molecules per cm³

SKCLIMATOLOGY_N2O_CM3 N₂O Molecules per cm³

SKCLIMATOLOGY_N2_CM3 N₂ Molecules per cm³

SKCLIMATOLOGY_NH3_CM3 NH₃ Ammonia Molecules per cm³

SKCLIMATOLOGY_NITS Inorganic Nitrates

SKCLIMATOLOGY_NO2_CM3 NO₂ Nitrogen Dioxide Molecules per cm³

SKCLIMATOLOGY_NO3_CM3 NO₃ Molecules per cm³

SKCLIMATOLOGY_NOPLUS_CM3 NO⁺ Molecules per cm³

SKCLIMATOLOGY_NOY_CM3 NOY Molecules per cm³

SKCLIMATOLOGY_NO_CM3 NO Molecules per cm³

SKCLIMATOLOGY_O2_CM3 O₂ Molecular oxygen Molecules per cm³

SKCLIMATOLOGY_O3_CM3 O₃ Ozone Molecules per cm³

SKCLIMATOLOGY_OCLO_CM3 OClO Molecules per cm³

SKCLIMATOLOGY_OCS_CM3 OCS Molecules per cm³

SKCLIMATOLOGY_OH_CM3 OH Hydroxyl Molecules per cm³

SKCLIMATOLOGY_O_CM3 O Atomic oxygen Atoms per cm³

SKCLIMATOLOGY_PAN_CM3 PAN Peroxy acetyl nitrate Molecules per cm³

SKCLIMATOLOGY_PH3_CM3 PH₃ Molecules per cm³

SKCLIMATOLOGY_ROOH_CM3 ROOH Molecules per cm³

SKCLIMATOLOGY_ROO_CM3 ROO Molecules per cm³

SKCLIMATOLOGY_SF6_CM3 SF₆ Molecules per cm³

SKCLIMATOLOGY_SO2_CM3 SO₂ Molecules per cm³

SKCLIMATOLOGY_SO4_CM3 SO₄ Molecules per cm³

SKCLIMATOLOGY_XXX_CM3 XXX Molecules per cm³

Molecular Volume Mixing Ratio GUIDS¶

GUID String Species Units

SKCLIMATOLOGY_BRX_VMR BrX Volume Mixing Ratio

SKCLIMATOLOGY_BRY_VMR BrY Volume Mixing Ratio

SKCLIMATOLOGY_BRO_VMR BrO Volume Mixing Ratio

SKCLIMATOLOGY_CO2_VMR CO₂ Volume Mixing Ratio

SKCLIMATOLOGY_C3H6O_VMR C₃H₆O Volume Mixing Ratio

SKCLIMATOLOGY_C5H8_VMR C₅H₈ Volume Mixing Ratio

SKCLIMATOLOGY_CCL4_VMR CCl₄ Volume Mixing Ratio

SKCLIMATOLOGY_CF2CL2_VMR CF₂Cl₂ Volume Mixing Ratio

SKCLIMATOLOGY_CFCL3_VMR CFCl₃ Volume Mixing Ratio

SKCLIMATOLOGY_CH2O_VMR CH₂O Volume Mixing Ratio

SKCLIMATOLOGY_CH3BR_VMR CH₃Br Volume Mixing Ratio

SKCLIMATOLOGY_CH3CL_VMR CH₃Cl Volume Mixing Ratio

SKCLIMATOLOGY_CH3I_VMR CH₃I Volume Mixing Ratio

SKCLIMATOLOGY_CH4_VMR CH₄ Volume Mixing Ratio

SKCLIMATOLOGY_CLY_VMR ClY Volume Mixing Ratio

SKCLIMATOLOGY_CO_VMR CO Volume Mixing Ratio

SKCLIMATOLOGY_CO2_VMR CO₂ Volume Mixing Ratio

SKCLIMATOLOGY_H2_VMR H₂ Volume Mixing Ratio

SKCLIMATOLOGY_H2O_VMR H₂O Volume Mixing Ratio

SKCLIMATOLOGY_HNO2_VMR HNO₂ Volume Mixing Ratio

SKCLIMATOLOGY_HNO3_VMR HNO₃ Volume Mixing Ratio

SKCLIMATOLOGY_MECL_VMR MECl Volume Mixing Ratio

SKCLIMATOLOGY_N2_VMR N₂ Volume Mixing Ratio

SKCLIMATOLOGY_N2O_VMR N₂O Volume Mixing Ratio

SKCLIMATOLOGY_NO2_VMR NO₂ Volume Mixing Ratio

SKCLIMATOLOGY_NO_VMR NO Volume Mixing Ratio

SKCLIMATOLOGY_NOY_VMR NOY Volume Mixing Ratio

SKCLIMATOLOGY_NH3_VMR NH₃ Volume Mixing Ratio

SKCLIMATOLOGY_O3_VMR O₃ Volume Mixing Ratio

SKCLIMATOLOGY_O2_VMR O₂ Volume Mixing Ratio

SKCLIMATOLOGY_PAN_VMR PAN Volume Mixing Ratio

SKCLIMATOLOGY_SO2_VMR SO₂ Volume Mixing Ratio

SKCLIMATOLOGY_SO4_VMR SO₄ Volume Mixing Ratio

SKCLIMATOLOGY_XXX_VMR XXX Volume Mixing Ratio

Photochemical emission GUIDS¶

GUID String Species Units

SKEMISSION_PHOTOCHEMICAL_0 User defined species 0

SKEMISSION_PHOTOCHEMICAL_1 User defined species 1

SKEMISSION_PHOTOCHEMICAL_2 User defined species 2

SKEMISSION_PHOTOCHEMICAL_3 User defined species 3

SKEMISSION_PHOTOCHEMICAL_4 User defined species 4

SKEMISSION_PHOTOCHEMICAL_5 User defined species 5

SKEMISSION_PHOTOCHEMICAL_6 User defined species 6

SKEMISSION_PHOTOCHEMICAL_7 User defined species 7

SKEMISSION_PHOTOCHEMICAL_8 User defined species 8

SKEMISSION_PHOTOCHEMICAL_9 User defined species 9

SKEMISSION_PHOTOCHEMICAL_O2 O2

SKEMISSION_PHOTOCHEMICAL_OH OH

SKEMISSION_PHOTOCHEMICAL_O3 O3

SKEMISSION_THERMAL: Thermal emission

Collisional Induced Absorption (CIA)¶

GUID String Species Description

SKCLIMATOLOGY_O2_O2_CM6 square of O2-O2 number density Suitable for O2/O2 collisional induced absorption (CIA)

Miscellaneous GUIDS¶

GUID String Description

SKCLIMATOLOGY_UNDEFINED Undefined quantity

SKCLIMATOLOGY_JH2O Used in Pratmo