
               README for CMAQ2CAMx v2.3 - 18 April 2012

CMAQ2CAMx converts CMAQ binary ICON, BCON, and emissions inputs into
CAMx binary IC, BC, and area-/point-source emissions inputs. It also
generates CAMx ascii top concentration file.

This program requires I/O-API and NetCDF libraries. Set the following
paths in 'Makefile' in 'src' directory:

   IOAPI_INC   - I/O-API include file directory
   IOAPI_LIB   - I/O-API library file directory
   NETCDF_LIB  - NetCDF library file directory

Then, compile the program by typing:

   make

To run the program, please refer to the included sample runscripts:

   conv_icon.job  - converts CMAQ ICON files to CAMx IC and TopC files
   conv_bcon.job  - converts CMAQ BCON files to CAMx BC files
   conv_emis.job  - converts CMAQ 3-D emissions files to CAMx area-/
                    point-source emissions files
   conv_ipnt.job  - converts CMAQ in-line point-source emissions files
                    to CAMx point-source emissions files
   run_pthtq.job  - sample script for PTHTQ which does the same thing
                    as PTHT but using CMAQ METCRO3D file instead of 
                    CAMx height/pressure file

NOTE: The program prints out species mapping in effect and lists any
      species that is in the input file but not used in the mapping.
      One should always carefully check this message to verify if all
      the species needed are properly mapped.
      In case that one needs to update/revise a species mapping file,
      the MAPTBL.sample file included explains the file format.

For comments and questions, send to bkoo@environcorp.com

