Last update: 25 Oct 2024

This .zip includes a sample script for creating the transportable fraction
file (XPORTFRAC) used to adjust afdust emissions after SMOKE is run.
New for 2016 beta platform, the XPORTFRAC is based on a GRIDCRO2D file from MCIP.

The sample script is called gen_afdust_tfrac.12US1.GRIDCRO2D.csh and is set up
for the 12US1 grid. This script can be run for any grid for which you have
a GRIDCRO2D file. You may use a GRIDCRO2D file for any day of the year.
The script calls a precompiled program, gen_afdust_tfrac.

In addition to the GRIDCRO2D, the program uses two ancillary files:
- gridcro2d_lu_types.12US2.csv: This provides descriptions for each land use
  variable in the GRIDCRO2D. **IMPORTANT** This must match your GRIDCRO2D file!
  You may verify this by looking in the NetCDF header of your GRIDCRO2D file,
  which should include descriptions for each LUFRAC variable. This particular
  file says "12US2", but 12US1 uses the same variables.
  An alternate file, gridcro2d_lu_types.USGS24.csv, is provided in this package
  for GRIDCRO2D files based on USGS land types (24 LUFRAC variables instead of 40).
- captureclass_fractions.txt: This specifies a transportable fraction for each
  land use type, as defined by the gridcro2d_lu_types file.

== IF USING MCIP 5.0 OR LATER ==

Older versions of MCIP, including the versions used in 2016 beta platform (circa 2019), 
included land use variables in the GRIDCRO2D file. In MCIP v5.0 and later, the land use 
information which is used by the gen_afdust_tfrac utility has been moved out of the 
GRIDCRO2D and into to its own files, called LUFRAC_CRO files. 

The gen_afdust_tfrac utility in this package has not yet been updated to work directly 
with LUFRAC_CRO files from MCIP v5.0+. Instead, we have a utility called "lugrid" which 
will read in a GRIDCRO2D and LUFRAC_CRO from MCIP v5.0+ and output a GRIDCRO2D which 
including land use information, and is compatible with MCIP v4.5 and earlier and with 
the gen_afdust_tfrac utility.

So if you have LUFRAC_CRO files from MCIP, you must run the lugrid utility prior to 
running gen_afdust_tfrac. A sample script (lugrid.csh) and executable (lugrid.exe) 
are provided.
