2 Jun 2011 Script notes for the 2005v4_2 platform (2005cs, 2012cs, 2014cs) --directory structure-- To use these scripts, unzip these script .zips, the ancillary file .zips located in ../ancillary_smoke, and the inventory file .zips located in ../2005emis, ../2012emis, and ../2014emis, to the following directories: Choose a directory into which unzip the script .zips. Call this directory ${SMK_HOME}; you will need to edit the SMK_HOME definition within each of the run scripts accordingly. Ancillary and inventory file .zips should be unzipped in ${SMK_HOME}/inputs/. To run SMOKE, execute the scripts that are unzipped to $SMK_HOME/subsys26/smoke26/scripts/cases/.../. Separate scripts are provided for each sector and grid. Make sure you create the directories $SMK_HOME/intermed and $SMK_HOME/smoke_out before starting. If you don't, the script will crash and tell you to create these directories. --SMOKE, I/O API-- The proper SMOKE version to use with these scripts is SMOKE v2.6. The SMOKE source code we used is provided, along with our executables (compiled on our own machines, meaning they likely won't work for others), in smoke26_source_code_execs.zip. The scripts assume the SMOKE executables are located in $SMK_HOME/subsys26/smoke26/$SMOKE_EXE where SMK_HOME is whatever directory you unzip the script .zip files to, and SMOKE_EXE is set by the subsys/scripts/platform script described below. (example: SMOKE_EXE = Linux_ia64ifort) Required I/O API programs must be here: $SMK_HOME/subsys26/ioapi/$SMOKE_EXE Additional files may need to be downloaded from the EPA website if you wish to process biogenic emissions (see --land use-- below). --meteorology-- Meteorological inputs, needed for biogenics and the onroad MOVES PM temperature adjustment, are not provided. Change the definition of MET_ROOT at the top of the beis and on_moves scripts to point to your copy of the meteorological inputs (MCIP). --script order-- Each point sector has two scripts, a "Onetime" script and an "Annual" script. The "Onetime" script comes first. For the on_moves sectors, the base script goes first, followed by "temp_adj" and then "reports". Run the 36km jobs before running the 12km jobs. You could skip the 36km runs and start with the 12km jobs if you only want to process emissions at 12km resolution, but you would have to edit the run settings file (RUNSET) so that the scripts do not skip the non-grid-dependent SMOKE programs (e.g. Smkinven, Spcmat, Temporal). --domain totals-- Included in the script package is an optional QA program called "domain totals". After Mrggrid is run for each day, this program outputs a file containing domain-wide daily totals for each species from the merged model-ready emissions. By default, this program is turned off. To use the domain totals program, follow these instructions: - Compile the following Fortran program ${SMK_HOME}/subsys26/smoke26/scripts/run/domain_totals/domaintotal_all_species.F A Makefile is provided in the same directory. - Move the resulting executable (domaintotal_new.x) to the parent directory: ${SMK_HOME}/subsys26/smoke26/scripts/run/ - In the runsettings file (.../scripts/cases/${CASE}/run_settings_*.txt), comment out the lines that say "mrggrid, [grid name], domain, ..." --python-- These scripts require the following python prerequesites: 1) Python__ 2.4.x or newer 2) Numerical python 24.2 This is an older version of the more robust numPy package. It is available at: http://sourceforge.net/projects/numpy/files/Old%20Numeric/ 3) Scientific python This package allows interfacing with netCDF files. It is available at: http://sourcesup.cru.fr/projects/scientific-py/ 4) UNIX-type system with the csh installed 5) netCDF C libraries in your LD_LIBRARY_PATH environment variable These libraries are required by scientific python and available at: http://www.unidata.ucar.edu/downloads/netcdf/netcdf-3_6_3/index.jsp --land use-- Make sure your copies of the biogenic land use files (BELD3_A, BELD3_B, and BELD3_TOT) are in the ${SMK_HOME}/inputs/2005ck_05b/beis/ directory and that the filenames match the run script. See [**Note B3**] in the beis run scripts. The beld3 inputs required to create the land use files are here: ftp://ftp.epa.gov/EmisInventory/beld_3/b3_files/ --ptipm NAMEBREAK_DAILY-- For the automatic creation of PTDAY .lst files to work, the variable NAMEBREAK_DAILY may need to be adjusted. See [**Note 1P**] in the ptipm run script. --chlorine-- For the final merge, be sure to install the contents of the following .tar and .zip files according to the these instructions: - Install .../2005v4/mercury_cl2_seasalt/ocean_cl2.zip to ${SMK_HOME}/intermed/2005ck_05b/. --future year and control case dependencies-- The 2012cs_05b and 2014cs_05b future year emissions cases reuse 2005cs_05b emissions for the following sectors: avefire, beis, othar, othon, othpt. The 2012cs_o3tag_05b and 2012cs_pmtag_05b tagging scenarios use some untagged sector emissions from 2012cs_05b. Note that unlike for 2012cs_05b, avefire emissions are rerun specifically for the future year tagging cases. The 2014cs_tr1remedy_05b future year control case uses 2014cs_05b emissions for all sectors except ptipm. --CAMX conversion scripts-- Scripts have also been included for those wishing to convert the CMAQ-ready emissions files produced by SMOKE into a format compatible with the CAMx model. These scripts are included in all .zip files with the name "camx" in them. camx_conv_helper_scripts.zip and camx_conv_tag_helper_scripts.zip contain source code for a few Fortran programs which must be compiled on your machine.