Updated 16 March 2010:  
To include corrections to ancillary files AMGREF and SRGDESC that were posted with July 2009 version.

This file describes the SMOKE ancillary inputs for EPA's Version 4 emissions
modeling platform, based on the 2005 NEI v2.  This includes data files to 
support EPA's 2005ak_05b and 2005ck_05b cases.  For more information on these 
cases and exceptions to what we provide, please refer to the readme file for 
inventories.

i)  For onroad mobile, we provide the NMIM-based "2005ah_tox_05b" emissions.
    The EPA version of the platform includes MOVES-based emissions for gasoline
    onroad vehicles, but these are not yet available.

ii) We also provide ancillary data specific to the model evaluation version 
    of the platform (case name 2005ak_05b), which uses different emissions for
    the ptipm and ptfire sectors.  These are noted where provided.

This readme describes three zip files:
1) ancillary_2005v4_smokeformat.zip:  SMOKE input ancillary files with the
      exception of spatial surrogates.

2) new36km_surg_2005v4_smokeformat.zip: New 36km spatial surrogates in SMOKE
      input format.  The remaining 36km surrogates can be found at:
      ftp://ftp.epa.gov/EmisInventory/2002v3CAP/ancillary_smoke/

3) new36km_surg_2005v4_smokeformat.zip: New 36km spatial surrogates in SMOKE
      input format.  The remaining 36km surrogates can be found at:
      ftp://ftp.epa.gov/EmisInventory/2002v3CAP/ancillary_smoke/

################################################################################
ancillary_2005v4_smokeformat.zip
================================
amgref_us_can_mex_revised_11mar2010_v8.txt: Spatial cross-reference for sectors other than othar_hg
amgref_us_can_allmex3_26may2009_v11.txt:  Spatial cross-reference for othar_hg

amptpro_2005_us_can_revised_10mar2009_v0.txt: 2005-specific temporal profiles
   used for "regulatory" (case name 2005ck_05b) and "model-evaluation" (case
   name 2005ak_05b).

amptref_v3_3_revised_13mar2009_v1.txt: Temporal cross-reference to use for the
   "regulatory" (case name 2005ck_05b) simulation except for the othpt sector.
   For "model-evaluation" (case name 2005ak_05b), use 
   ptref_ptipm_us_29nov2006_v0.txt for the ptipm and ptfire sectors. For the
   othpt sector, use ptref_othpt_19mar2009_v3.txt.

artopnt_2002detroit_12jul2007_v0.txt: Area-to-point conversion file used for
   allocating airport emissions to point locations.

beis3_efac_v3_14_16may2008_v0: BEIS3.14 emission factors.

bioseason.cmaq.2005b_36km.ncf: 2005 winter/summer switch for BEIS3 for 36km U.S.
   grid.

bioseason.cmaq.2005b_12km.ncf: 2005 winter/summer switch for BEIS3 for 12km U.S.
   grid.

costcy_for_2002_10mar2009_v4.txt: Country, state, and county names and
   properties.

griddesc_lambertonly_18may2009_v18.txt: Grid descriptions file.

gscnv_cmaq_cb05_tx_pf4_15apr2009_nf_v3.txt: VOC-to-TOG factors.

gspro_combo_2005_09sep2008_v2.txt: Combination chemical speciation file used to
   assign multiple speciation profiles with a weight to generally support a
   mixture of fuel profiles to specific counties.  See the SMOKE documentation
   for format:  http://www.smoke-model.org/version2.5/html/ch08s05s03.html

gspro_cmaq_cb05_soa_2005ck_05b_19mar2009.txt: Speciation profiles for CMAQ 
   version4.7 CB05 with SOA chemical mechanism

gsref_cmaq_cb05_soa_2005ck_05b_19mar2009.txt: Speciation cross-reference file 
   using SPECIATE4.0 with some SPECIATE4.2 profiles.  

holidays_04may2006_v0.txt: Dates for days to model as holidays in SMOKE.

invtable_hapcapnohapuse_cb05soa_nomp_17mar2009_v4.txt: SMOKE inventory table
   for all VOC "no-integrate" sectors.  These sectors are:  ptipm, ptnonipm,
   avefire (case name 2005ck_05b only), and ptfire (case name 2005ak_05b only).

invtable_hapcapintegate_cb05soa_nomp_09mar2009_v4.txt: SMOKE inventory table
   for all sectors that are at least "partial-integrate" and "full-integrate"
   for VOC.  This applies to all sectors not included in the "hapcapnohapuse"
   inventory table previously discussed.

mcodes_21nov2008_v1.txt: Mobile source codes file for SMOKE, also provided in
   each mobile inventory directory.

mactdesc_2002v3_23apr2008_v1.txt: MACT code descriptions.

naicsdesc_02jan2008_v0.txt: NAICS code descriptions.

nhapexclude_everything_05oct2007_v0.txt: List of sources excluded from the
   NONHAPVOC or NONHAPTOG calculation.  Sources in this file do not use VOC
   HAPs to compute NONHAPVOC or NONHAPTOG.  This particular nhapexclude file
   applies to sectors where no integration occurs for all sources (ptipm,
   ptnonipm, ptfire, and avefire).  See the SMOKE documentation for more:
   http://www.smoke-model.org/version2.5/html/ch08s10s06.html

nhapexclude_nonpt_pf4_06feb2009_v3.txt:  List of nonpoint sector sources that
   are excluded from VOC HAPs integration.

nhapexclude_nonroad_pf4_14apr2009_nf_v2.txt: List of nonroad mobile sector
   sources that are excluded from VOC HAPs integration.

nhapexclude_alm_no_c3_pf4_11sep2008_v0.txt: List of alm_no_c3 sector sources
   that are excluded from VOC HAPs integration.

nhapexclude_nothing_08sep2008_v0.txt: A limitation with SMOKE2.4, this file
   contains a "dummy" record of a non-existent source such that the entire
   sector is subject to VOC HAP integration.  This file is used for "full"
   integration over all sources in the sector.  The onroad mobile and seca_c3
   sectors use this file.  This file is necessary because SMKINVEN requires an
   NHAPEXCLUDE file to properly integrate VOC HAPs (despite what the SMOKE
   documentation was claiming at the time).

orisdesc_04dec2006_v0.txt: Description of ORIS facilities.

pelvconfig_inline_allpts_11apr2008_v0.txt: Elevated source selection file for
   all point source sectors in the case name 2005ck_05b except seca_c3.

pelvconfig_seca_c3_18mar2008_v0.txt: Elevated source selection file for the
   seca_c3 sector.

pelvconfig_ptfire_inline_pf31_05dec2007_v0.txt: Elevated source selection file
   for the ptfire sector (used only for the case name 2005ak_05b).

pstk_20nov2006_v0.txt: Replacement stack parameters for missing/invalid stack
   parameters in the inventory.

ptref_ptipm_us_29nov2006_v0.txt: Temporal cross-reference to use for the "model
   evaluation" (case name 2005ak_05b) for the ptipm sector.  This file replaces
   the "regulatory" (case name 2005ck_05b) file
   amptref_v3_3_revised_13mar2009_v1.txt.

ptref_othpt_19mar2009_v3.txt: Temporal cross-reference for the othpt sector.

sccdesc_pf31_03feb2009_v5.txt: SCC descriptions.

sic_desc_04oct2006_v0.txt: SIC descriptions.

srgdesc_36km_revised_17mar2009_v1.txt: Surrogate code descriptions (36 or 12 km) 
   for all U.S. and non-U.S. sectors other than othar_hg **

srgdesc_12km_01jun2007_v0.txt : Surrogate code descriptions (36 or 12 km) 
    for all U.S. sectors and othar_hg **
  
  ** note that either of the above two "SRGDESC" files can be used for the U.S. sectors
  since the U.S. codes are the same in both of these files.

repconfig/default/ (subdirectory):
   repconfig_<sector(s)>_invgrid_*.txt:  SMOKE report configuration file that
      creates gridded emission summaries.  Some of these reports are dedicated
      to one sector (e.g., "nonroad"), but most are for the general type of
      SMOKE inventory such as "area", "point", and "onroad" (mobile).  Also, the
      "pt_noplant" file is used only for the seca_c3 sector.  The asterisk "*"
      refers to other text such as date, "caphap" and version number that may be
      included in the file name.  
   repconfig_<sector(s)>_inv_*.txt:  SMOKE report configuration file that
      creates non-gridded emission summaries.  Some of these reports are
      dedicated to one sector (e.g., "nonroad"), but most are for the general
      type of SMOKE inventory such as "area", "point", and "onroad" (mobile).
      Also, the "pt_noplant" file is used only for the seca_c3 sector.  The
      asterisk "*" refers to other text such as date, "caphap" and version
      number that may be included in the file name.
   repconfig_<sector type> inv2_02jan2008_v0.txt: SMOKE report configuration 
      file applied to "area" or "point" sector type that creates emission
      summaries by VOC speciation code.
   repconfig_nonroad_inv2a_04mar2008_v1.txt: SMOKE report configuration
      file applied to nonroad mobile sector that creates emission summaries by
      VOC speciation code for exhaust VOC mode.
   repconfig_nonroad_inv2b_04mar2008_v1.txt: SMOKE report configuration
      file applied to nonroad mobile sector that creates emission summaries by
      VOC speciation code for evaporative VOC mode.
   repconfig_nonroad_inv2c_04mar2008_v1.txt: SMOKE report configuration
      file applied to nonroad mobile sector that creates emission summaries by
      VOC speciation code for refueling VOC mode.
   repconfig_onroad_inv2a_nonhapvoc_18nov2008_v0.txt: SMOKE report configuration
      file applied to onroad mobile sector that creates emission summaries by
      VOC speciation code for exhaust VOC mode.
   repconfig_onroad_inv2b_nonhapvoc_18nov2008_v0.txt: SMOKE report configuration
      file applied to onroad mobile sector that creates emission summaries by
      VOC speciation code for evaporative VOC mode.

################################################################################
################################################################################

new36km_surg_2005v4_smokeformat.zip
===================================
36US1_surg_revised/:
   CA*.txt: 36km gridded surrogates for Canada, updated in 2006.  A list of
      these new Canadian surrogate codes and descriptions can be found in
     srgdesc_36km_revised_17mar2009_v1.txt which is in ancillary_2005v4_smokeformat.zip
   

** NOTE **: The U.S. and Mexico surrogates are unchanged from the 2002V3
   platform and can be found at:
      ftp://ftp.epa.gov/EmisInventory/2002v3CAP/ancillary_smoke/

   These should be installed in this same directory.

new12km_surg_2005v4_smokeformat.zip
===================================
12km_surg_revised/:
   CA*.txt: 12km gridded surrogates for Canada, updated in 2006.  A list of
      these new Canadian surrogate codes and descriptions can be found in
      srgdesc_36km_revised_17mar2009_v1.txt which is in ancillary_2005v4_smokeformat.zip

** NOTE **: The U.S. and Mexico surrogates are unchanged from the 2002V3
   platform and can be found at:
      ftp://ftp.epa.gov/EmisInventory/2002v3CAP/ancillary_smoke/

   These should be installed in this same directory.

