Download Speciation Tool User`s Guide

Speciation Tool User’s Guide, Version 3.1 CNV _OUT 4.0 RUNNING THE SPECIATION TOOL Example: CNV_OUT, outputs/gscnv_02coalstudy.dat The CNV_OUT optional keyword is used to specify a path and file name for the model TOG/VOC conversion factors written in SMOKE GSCNV format. Paths can be relative paths from the Speciation Tool main directory (as shown) or absolute paths. If this keyword is omitted, the output file name is derived from the run control parameter specifications and the run date and is written to the relative path /outputs. An example of a default output file name is outputs/gscnv_CB05_NOINTEGRATE_CAMX_26Jun2011. Header Records: Metadata The Speciation Tool output files, GSPRO and GSCNV, contain header records that are referred to as “metadata”. Each of the output files has the same common metadata keywords. The purpose of the metadata records is to provide a summary of the data and parameters that were used to generate the outputs. Table 4-­‐2 provides the list of metadata keywords for an example run. Table 4-­‐2. Metadata keywords and example. Metadata Keyword
#SPTOOL_AQM
#SPTOOL_CARBONS
#SPTOOL_GAS_PROFILES
#SPTOOL_INVTABLE
#SPTOOL_MECH
#SPTOOL_PM_PROFILES
#SPTOOL_PROCESS
#SPTOOL_STATIC
#SPTOOL_VOC_TYPE
Example
CMAQ
carbons_cb6_cb05_cbiv_saprc99.csv
Qry_gas_specie_export.txt
invtable_caphap_27jun2007_v7.txt
CB05
Not Applicable
process_poll.csv
Not Applicable
INTEGRATE
If the keyword is not applicable for a particular run, the corresponding value is set to "Not Applicable". For example, if the output type is specified as PM, the metadata record #SPTOOL_GAS_PROFILES is set to “Not Applicable”. These headers can be used as a guide for merging different GSPRO tables. Before combining outputs for toxics TOG profiles with NONHAPTOG profiles, be sure to confirm that the same chemical mechanism was specified for each run and that the same input files for the VOC calculations were used for each run. 4.4 Run the Speciation Tool To run the Speciation Tool, enter the following command: perl $SPTOOL_SRC_HOME/run_sptool.pl $SPTOOL_DB <run_name> <run_control_file>
where: $SPTOOL_DB is the Speciation Tool database name <run_name> is the user-­‐assigned run name <run_control_file> is the name and location of the control file that defines the run parameters and input and output file names UNC-­‐EMAQ(1-­‐05)-­‐010.v1 4-­‐7 ENVIRON