Last update: 24 Nov 2021

This package contains sample scripts and executables for running the SMOKE
program Gentpro, which creates meteorologically-based temporal profiles for
SMOKE for the RWC and agricultural (livestock and fertilizer) sectors.

== Residential Wood Combustion (RWC) ==

A sample run script to run Gentpro to create day-of-year temporal profiles
based on daily minimum temperature is provided in the package: run_gentpro_rwc.csh

Descriptions of inputs and settings, and what you need to change or not change, 
are provided in the run script as comments.

Gentpro will give you an ATREF, ATPRO_MONTHLY (month-of-year profiles), and ATPRO_DAILY
(day-of-month profiles). As mentioned in the run script comments, the ATREF output by Gentpro
can generally be ignored, and you should instead use the ATREF included in the appropriate
emissions modeling platform when running Temporal as part of regular SMOKE.
The ATPRO_MONTHLY and ATPRO_DAILY will be needed, but you will need to make the following edits
prior to running Temporal:

- Manually edit the ATPRO_MONTHLY and ATPRO_DAILY files to remove the extra leading
  zeros from the FIPS codes so that all FIPS codes and FIPS-based profile codes are 
  five characters.
  For example, change "000000001001" to "01001", and change "000000048221" to "48221".
  This will allow you to use the ATREF files from EPA emissions modeling platforms as is,
  and is also consistent with EPA practice.
  Easiest way to do this is to remove the string "0000000" (seven zeroes) from both files.

- Append the following four profiles to the ATPRO_MONTHLY output by Gentpro. These profiles are
  needed for the RWC SCCs which do not use temperature-based temporalization:
  
"17001x",0.111111111111,0.111111111111,0.111111111111,0.111111111111,0.111111111111,0,0,0,0.111111111111,0.111111111111,0.111111111111,0.111111111111
"17005x",0.333333333333,0.333333333333,0,0,0,0,0,0,0,0,0,0.333333333333
"17750x",0.013013013013,0.00900900900901,0.016016016016,0.0540540540541,0.119119119119,0.136136136136,0.15015015015,0.134134134134,0.154154154154,0.108108108108,0.0750750750751,0.031031031031
"17751x",0.140873015873,0.131944444444,0.140873015873,0.118055555556,0.0228174603175,0.0128968253968,0.00793650793651,0.00892857142857,0.0168650793651,0.117063492063,0.133928571429,0.147817460317
  
- If you only want to run a CONUS domain which does not include Alaska, Hawaii, Puerto Rico,
  or Virgin Islands, remove those states from your RWC emissions inventory prior to running SMOKE.
  This will prevent the need to separately generate profiles for those regions, since a Gentpro run 
  for a CONUS domain will not give you profiles for AK, HI, etc.

== Agricultural emissions (ag) ==

A sample run script to run Gentpro to create hour-of-month temporal profiles
based on meteorological conditions according to the "Bash" algorithm is 
provided in the package: run_gentpro_ag.csh

Descriptions of inputs and settings, and what you need to change or not change, 
are provided in the run script as comments.

Gentpro will give you an ATREF and a netCDF-formatted ATPRO_HOURLY_NCF which contains
the hourly profiles. As mentioned in the run script comments, the ATREF output by Gentpro
can generally be ignored, and you should instead use the ATREF included in the appropriate
emissions modeling platform when running Temporal as part of regular SMOKE.
The ATPRO_HOURLY_NCF will be needed when running Temporal.

Also, as mentioned in the run script comments, this package contains two separate versions
of the Gentpro executable: "gentpro" from SMOKE v4.8, and "gentpro_v37" from SMOKE v3.7.
As of 11/24/21, Gentpro from SMOKE v4.X does not work with ag processing because of how
the FIPS code is formatted in the ATPRO_HOURLY_NCF. You must use the SMOKE v3.7 version
of Gentpro for generating ag profiles.

If you only want to run a CONUS domain which does not include Alaska, Hawaii, Puerto Rico,
or Virgin Islands, remove those states from your ag emissions inventory prior to running SMOKE.
