README -- describes contents of HEMCO/RRTMG/v2018-11 02 Nov 2018 GEOS-Chem Support Team geos-chem-support@g.harvard.edu 12/14/2023 update: Files modis_surf_albed.2x25.nc and species_clim_profiles.2x25.nc are now overwritten to replace 00:00:0.0 with 00:00:00 in time units attribute. This enables compatibility with MAPL used in GCHP. Contents: =============================================================================== (1) modis_surf_albedo.2x25.nc -- Contains surface albedo and emissivity processed from MODIS MCD43C3.5 and MOD11C2. Albedo is direct (black sky) and diffuse (white sky) and interpolated to the first 21 wavelengths of GADS. Original files were created by David Ridley as bpch and converted to netCDF by Bob Yantosca (using IDL routine bpch2coards and then scripts/fix_species_clim_profiles.sh). Resolution : GEOS-Chem 2 x 2.5 grid (144 x 91 x 1 boxes) Units : ppb Timestamps : 2002/01/01, 2002/01/09, 2002/01/17, ... (every 8 days) Compression : Level 1 (e.g. nccopy -d1) Chunking : nccopy -c lon/144,lat/91,time/1 (2) modis_surf_albedo.4x5.nc -- Contains surface albedo and emissivity processed from MODIS MCD43C3.5 and MOD11C2. Albedo is direct (black sky) and diffuse (white sky) and interpolated to the first 21 wavelengths of GADS. Original files were created by David Ridley as bpch and converted to netCDF by Bob Yantosca (using IDL routine bpch2coards and then scripts/fix_species_clim_profiles.sh). Resolution : GEOS-Chem 4 x 5 grid (72 x 46 x 1 boxes) Units : ppb Timestamps : 2002/01/01, 2002/01/09, 2002/01/17, ... (every 8 days) Compression : Level 1 (e.g. nccopy -d1) Chunking : nccopy -c lon/72,lat/46,time/1 (3) modis_emissivity.2x25.nc -- Contains surface emissivity processed from MODIS MCD43C3.5 and MOD11C2. Emissivity has been interpolated to last 40 wavelengths of GADS. Emissivity is stored in the 16 spectral bands (indices 1..NBNDLW) that RRTMG expects as input. This data was created by David Ridley in bpch format and converted to netCDF by Bob Yantosca. NOTE: The bpch data files contained emissivity for 16 different wavelength bands; however, these were stored in the first 16 levels of the bpch file. Because we cannot use levels to store band values in netCDF, we have stored the emissivity at each spectral band as a different variable in the netCDF file. Resolution : GEOS-Chem 2 x 2.5 grid (144 x 91 x 1 boxes) Units : 1 Timestamps : 2002/01/01, 2002/01/09, 2002/01/17, ... (every 8 days) Compression : Level 1 (e.g. nccopy -d1) Chunking : nccopy -c lon/72,lat/46,lev/1,time/1 (4) modis_emissivity.4x5.nc -- Contains surface emissivity processed from MODIS MCD43C3.5 and MOD11C2. Emissivity has been interpolated to last 40 wavelengths of GADS. Emissivity is stored in the 16 spectral bands (1..NBNDLW) that RRTMG expects as input. This data was created by David Ridley in bpch format and converted to netCDF by Bob Yantosca. NOTE: The bpch data files contained emissivity for 16 different wavelength bands; however, these were stored in the first 16 levels of the bpch file. Because we cannot use levels to store band values in netCDF, we have stored the emissivity at each spectral band as a different variable in the netCDF file. Resolution : GEOS-Chem 4 x 5 grid (72 x 46 x 1 boxes) Units : 1 Timestamps : 2002/01/01, 2002/01/09, 2002/01/17, ... (every 8 days) Compression : Level 1 (e.g. nccopy -d1) Chunking : nccopy -c lon/72,lat/46,lev/1,time/1 (5) species_clim_profiles.2x25.nc -- Contains stored N2O and CH4 profiles created based on climatology. These are global July mean profiles from TES that are interpolated to the 3D GEOS-Chem grid as a simple solution to account for stratospheric contribution of these species to radiative BALANCE. This file was created by David Ridley as bpch and converted to netCDF by Bob Yantosca (using scripts/rrtmg_2x25.pro) Resolution : GEOS-Chem 2 x 2.5 grid (144 x 91 x 72 boxes) Units : ppb Timestamps : 2000/01/01 Compression : Level 1 (e.g. nccopy -d1) Chunking : nccopy -c lon/144,lat/91,lev/1,time/1 (6) species_clim_profiles.2x25.nc -- Contains stored N2O and CH4 profiles created based on climatology. These are global July mean profiles from TES that are interpolated to the 3D GEOS-Chem grid as a simple solution to account for stratospheric contribution of these species to radiative BALANCE. This file was created by David Ridley as bpch and converted to netCDF by Bob Yantosca (using scripts/rrtmg_4x5.pro). Resolution : GEOS-Chem 2 x 2.5 grid (72 x 46 x 72 boxes) Units : ppb Timestamps : 2000/01/01 Compression : Level 1 (e.g. nccopy -d1) Chunking : nccopy -c lon/72,lat/46,lev/1,time/1 (7) scripts: -- Folder containing data processing scripts (bash, IDL, Python) used to convert bpch data files to netCDF format. (1) To convert species_clim_profiles to netCDF: Run (a) Use GAMAP routine : bpchcoards (b) Use shell script : fix_species_clim_profiles.sh (2) To convert the modis_surf_albedo to netCDF: (a) Use IDL routine : rrtmg_2x25.pro (b) Use IDL routine : rrtmg_4x5.pro (3) To convert the modis_emissivity to netCDF: run (a) Use python script : fix_emiss_2x25.py (b) Use shell script : fix_emiss_atts 2x25 (c) Use python script : fix_emiss_4x5.py (d) Use shell script : fix_emiss_atts 4x5 NOTE: You can then use nc_chunk.pl FILENAME 1 to compress and chunk the resultant files. Also note: assumes that you have the netCDF operators (nco) installed on your system. The netCDF operators are used to edit metadata and variable names for COARDS compliance. NOTES: - All files were updated on August 11, 2020 to reformat the time dimension unit string for compatibility with the MAPL library used in GCHP. All time units are now 'hours since 1985-1-1 00:00:00' rather than 'hours since 1985-1-1' or 'hours since 1985-1-1 00:00:0.0'. (Lizzie Lundgren (GCST))