README -- Describes contents of HEMCO/MASKS/v2018-09 directory
24 Jan 2023
GEOS-Chem Support Team
geos-chem-support@g.harvard.edu


Overview:
===============================================================================

This directory contains the various mask files needed for certain regional
emissions inventories.


Files:
===============================================================================

All mask files have units of "1" (aka "unitless") unless otherwise specified.


AF_LANDMASK.geos.05x0666.global.nc
 -- Mask file for use with the DICE Africa emissions in GCHP which requires
    global bounds in the file
    Resolution  : GEOS-Chem 0.5 x 0.666 grid (540 x 361 boxes)
    Timestamps  : 1985/01
    Compression : Level 1 (e.g. nccopy -d1)
    Chunking    : nccopy -c lon/540,lat/361,time/1

Canada_Mask.001x001.global.nc
Canada_Mask_Mirror.001x001.global.nc
 -- Mask file (and its mirror-image) for Canada for use with the 
    Canadian oil/gas CH4 emissions  from Sheng et al. (2017)
    **************************************************************************
    ** These global mask files were created for GCHP, but cause a drastic  ***
    ** slowdown and memory increase in GCC runs, so we will use the        ***
    ** regional 0.01x0.01 masks for now (mps,9/20/18)                      ***
    **************************************************************************
    Resolution  : GENERIC 0.01 x 0.01 grid (36000 x 18000 boxes)
    Timestamp   : 2016/01 
    Compression : Level 1 (e.g. nccopy -d1)
    Chunking    : nccopy -c lon/36000,lat/18000

Canada_Mask.001x001.nc
Canada_Mask_Mirror.001x001.nc
 -- Mask file (and its mirror-image) for Canada for use with the 
    Canadian oil/gas CH4 emissions  from Sheng et al. (2017)
    Resolution  : GENERIC 0.01 x 0.01 grid over N. America (10100 x 7500 boxes)
    Timestamp   : 2016/01 
    Compression : Level 1 (e.g. nccopy -d1)
    Chunking    : nccopy -c lon/10100,lat/7500

CONUS_Mask.001x001.global.nc
CONUS_Mask_Mirror.001x001.global.nc
 -- Mask file (and its mirror-image) for the contiguous US for use with
    the gridded EPA CH4 emissions from Maasakkers et al.(2016)
    **************************************************************************
    ** These global mask files were created for GCHP, but cause a drastic  ***
    ** slowdown and memory increase in GCC runs, so we will use the        ***
    ** regional 0.01x0.01 masks for now (mps,9/20/18)                      ***
    **************************************************************************
    Resolution  : GENERIC 0.01 x 0.01 grid (36000 x 18000 boxes)
    Timestamp   : 2016/01 
    Compression : Level 1 (e.g. nccopy -d1)
    Chunking    : nccopy -c lon/36000,lat/18000

CONUS_Mask.001x001.nc
CONUS_Mask_Mirror.001x001.nc
 -- Mask file (and its mirror-image) for the contiguous US for use with
    the gridded EPA CH4 emissions from Maasakkers et al.(2016)
    Resolution  : GENERIC 0.01 x 0.01 grid over the US (7000 x 3500 boxes)
    Timestamp   : 2016/01 
    Compression : Level 1 (e.g. nccopy -d1)
    Chunking    : nccopy -c lon/7000,lat/3500

China_mask.generic.1x1.nc
 -- Mask file for use with the mercury China emissions
    Resolution  : GENERIC 1 x 1 grid (360 x 180 boxes)
    Timestamps  : 1985/01
    Compression : Level 1 (e.g. nccopy -d1)
    Chunking    : nccopy -c lon/360,lat/180,time/1

EU_mask.generic.1x1.nc
 -- Mask file for use with the mercury European emissions
    Resolution  : GENERIC 1 x 1 grid (360 x 180 boxes)
    Timestamps  : 1985/01
    Compression : Level 1 (e.g. nccopy -d1)
    Chunking    : nccopy -c lon/360,lat/180,time/1

India_mask.generic.1x1.nc
 -- Mask file for use with the mercury Indian emissions
    Resolution  : GENERIC 1 x 1 grid (360 x 180 boxes)
    Timestamps  : 1985/01
    Compression : Level 1 (e.g. nccopy -d1)
    Chunking    : nccopy -c lon/360,lat/180,time/1

Mexico_Mask.001x001.global.nc
Mexico_Mask_Mirror.001x001.global.nc
 -- Mask file (and its mirror-image) for Mexico for use with the Mexican
    oil/gas CH4 emissions from Sheng et al. (2017)
    **************************************************************************
    ** These global mask files were created for GCHP, but cause a drastic  ***
    ** slowdown and memory increase in GCC runs, so we will use the        ***
    ** regional 0.01x0.01 masks for now (mps,9/20/18)                      ***
    **************************************************************************
    Resolution  : GENERIC 0.01 x 0.01 grid (36000 x 18000 boxes)
    Timestamp   : 2016/01 
    Compression : Level 1 (e.g. nccopy -d1)
    Chunking    : nccopy -c lon/36000,lat/18000

Mexico_Mask.001x001.nc
Mexico_Mask_Mirror.001x001.nc
 -- Mask file (and its mirror-image) for Mexico for use with the Mexican
    oil/gas CH4 emissions  from Sheng et al. (2017)
    Resolution  : GENERIC 0.01 x 0.01 grid over N. America (10100 x 7500 boxes)
    Timestamp   : 2016/01 
    Compression : Level 1 (e.g. nccopy -d1)
    Chunking    : nccopy -c lon/10100,lat/7500

MIX_Asia_mask.generic.025x025.nc
 -- Mask file for use with the MIX Asian emissions
    Resolution  : GENERIC 0.25 x 0.25 grid (1440 x 720 grid boxes)
    Timestamps  : 2008/01
    Compression : Level 1 (e.g. nccopy -d1)
    Chunking    : nccopy -c lon/1440,lat/720,time/1

USA_mask.geos.1x1.nc
 -- Mask file for use with the mercury and tagged CO US emissions
    Resolution  : GEOS-Chem 1 x 1 grid (360 x 181 boxes)
    Timestamps  : 1985/01/01 00:00 UTC
    Compression : Level 1 (e.g. nccopy -d1)
    Chunking    : nccopy -c lon/360,lat/181,time/1


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%%      MASK FILES USED WITH INVENTORIES SINCE RETIRED FROM GEOS-Chem     %%%
%%%              We will keep these files here for reference               %%%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

BRAVO.MexicoMask.generic.1x1.nc
 -- Mask file for use with the BRAVO Mexican emissions
    Resolution  : GENERIC 1 x 1 grid (360 x 180 boxes)
    Timestamp   : 1999/01 
    Compression : Level 1 (e.g. nccopy -d1)
    Chunking    : nccopy -c lon/360,lat/180,time/1

Canada_mask.geos.1x1.nc
 -- Mask file for use with the CAC Canadian emissions
    Resolution  : GEOS-Chem 1 x 1 grid (360 x 181 boxes)
    Timestamp   : 2000/01
    Compression : Level 1 (e.g. nccopy -d1)
    Chunking    : nccopy -c lon/360,lat/181,time/1

EMEP_mask.geos.1x1.20151222.nc
 -- Mask file for use with the EMEP European emissions
    Resolution  : GEOS-Chem 1 x 1 grid (360 x 181 boxes)
    Timestamps  : 1985/01
    Compression : Level 1 (e.g. nccopy -d1)
    Chunking    : nccopy -c lon/360,lat/181,time/1

SE_Asia_mask.generic.1x1.nc
 -- Southeast Asia mask file for use with the Streets SE Asia emissions
    Resolution  : GENERIC 1 x 1 grid (360 x 180 boxes)
    Timestamps  : 2000/01/01 00:00 UTC
    Compression : Level 1 (e.g. nccopy -d1)
    Chunking    : nccopy -c lon/360,lat/180,time/1

USA_LANDMASK_NEI2011_0.1x0.1.20160921.nc
 -- Mask file for use with the NEI2011 emissions.
    Resolution  : REGIONAL 0.1 x 0.1 grid (400 x 900 boxes)
    Timestamps  : 2011/11/01 00:00 UTC
    Units       : 1
    Compression : Level 1 (e.g. nccopy -d1)
    Chunking    : nccopy -c lon/900,lat/400,time/1