 
                     AERMOD Test Cases - 241422                 9/12/2024

This file describes test cases for the AERMOD dispersion model, dated 23132.
Due to the range of changes incorporated in version 23132 of the AERMOD dispersion 
model (see AERMOD MCB), the AERMOD test cases include several scenarios in order to
document test results for AERMOD changes, including testing of the RLINE and BUOYLINE
source types added in AERMOD 22112. 

Two separate scenarios are included in the set of standard test cases for this 
update to AERMOD. This includes results based on default options in version
23132 of AERMET and AERMOD for reference.  
                                                            
Scenario No.   AERMET/AERMOD Runs                 	
-----------------------------------------------------------------
  1	   aermet_23132_aermod_23132
  2	   aermet_23132_aermod_24142 
  3	   aermet_24142_aermod_24142  
   
Within each scenario there are 46 test cases that test a variety of options in AERMOD.
The ADJ_U* option in AERMET was used for cases that only used NWS data. The 
'TableOfCases.xlsx' spreadsheet details which cases use the ADJ_U* option. Test cases 
marked 'no' in the ADJ_U* column are using all default options for AERMET. Input and
output files associated with each of the five test cases are available for downloading
separately. 

For each scenario listed above, the 'aermod_testcase.zip' file contains an 
'inputs' folder and an 'outputs' folder.  Users can regenerate the results for
each test case by running the 'runtests_AERMOD.bat' batch file (note that users will need
to include the AERMOD executable in the 'inputs' folder).

The .PST result files associated with each individual case have been compared using the 
set of R scripts provided in the aermod_testcase.zip file. The 'Process_AERMOD_test_cases_output.R'
script reads in each .PST file and generates an .rdata file. The 'Compare_AERMOD_test_cases.R'
reads the .rdata files to provide comparison results for each case within each scenario.
Comparison figures have been provided in the'plots_scenarioX_v_scenarioX' folders along with 
a 'comparison_stats.csv' spreadsheet containing the statistical results for each case within
that scenario. 
   
A summary of the scenarios included in these standard tests is provided below:

Test Name            			Description
--------------------------------------------------------------------------------------
aertest.inp           			Simple test case referenced in AERMOD User's Guide
allsrcs.inp           			Test case including all standard source types
capped.inp            			Capped and horizontal stack tests
capped_nostd.inp      			Capped and horizontal stack tests using MC w/NOSTD option
testgas.inp           			Gas deposition test case with limited screening met data
testgas2.inp          			Gas deposition test case with 1 year of Houston met data
testpart.inp          			Particle deposition test with limited screening met data
testprt2.inp          			Particle deposition test with 1 year of Houston met data
openpits.inp          			OPENPIT source test case
lovett.inp            			Lovett model evaluation data
mcr.inp               			Martins Creek model evaluation data
flatelev.inp          			FLAT & ELEV test case based on Lovett data
mcr.inp               			Martin's Creek model evaluation data
multurb.inp           			Multiple urban area test case
hrdow.inp             			Hour-of-day by day-of-week EMISFACT test case
surfcoal.inp          			Surface coal mine evaluation data
olm.inp               			OLM test case
olmgrp.inp            			OLM test case with OLMGROUP option
pvmrm.inp             			PVMRM test case
psdcred.inp           			PVMRM test case with PSDCREDIT BETA option
scimtest.inp          			SCIM (Sampled Chronological Input Model) test case
testpm25.inp          			PM-2.5 test case with 5-years of met data
testpm10_1986.inp     			PM-10 test case with MULTYEAR option - Year 1
testpm10_1987.inp     			PM-10 test case with MULTYEAR option - Year 2
testpm10_1988.inp     			PM-10 test case with MULTYEAR option - Year 3
testpm10_1989.inp     			PM-10 test case with MULTYEAR option - Year 4
testpm10_1990.inp     			PM-10 test case with MULTYEAR option - Year 5
testpm10.inp          			PM-10 test case with single 5-year data file (1986-1990)
aermod-baldwin10.inp  			3-line Buoyant Line, 10-degree orientation - evaluate with Lovett met
aermod-baldwin45.inp  			3-line Buoyant Line, 45-degree orientation - evaluate with Lovett met
aermod-baldwin85.inp  			3-line Buoyant Line, 85-degree orientation - evaluate with Lovett met
aermod-baldwinHoriz.inp  		3-line Buoyant Line, Horizontal orientation - evaluate with Lovett met
aermod-baldwinVert.inp  		3-line Buoyant Line, Vertical orientation - evaluate with Lovett met
Test1_Base_cart_3cond_SNC.inp		Test1_Base_cart_full test for comparison to R-LINE: 3 met conditions
Test3_Base_cart_3cond_SNC_bar.inp	Test3_Base_cart_full with barrier test for comparison to R-LINE: 3 met conditions
Test3_Base_cart_3cond_SNC_bar_evt.inp	Test3_Base_cart_full with barrier test for comparison to R-LINE: 3 met conditions
Test4_Base_cart_3cond_SNC_dep.inp	Test4_Base_cart_full with depression test for comparison to R-LINE: 3 met conditions
Test5_Dual_cart_3cond_SNC.inp		Test5_Dual_cart_full test for comparison to R-LINE: 3 met conditions
Test6_Tri_cart_3cond_SNC.inp		Test6_Tri_cart_full test for comparison to R-LINE: 3 met conditions
Test7_Quad_cart_3cond_SNC.inp		Test7_Quad_cart_full test for comparison to R-LINE: 3 met conditions
Test9_Base_cart_parl_3cond_SNC.inp	Test9_Base_cart_parl test for comparison to R-LINE: 3 met conditions
Test10_Base_cart_perp_3cond_SNC.inp	Test10_Base_cart_perp test for comparison to R-LINE: 3 met conditions
Test13_Base_cart_3cond_SNC_IRE.inp	Test13_Base_cart_full_lRE test for comparison to R-LINE: 3 met conditions
Test14_Base_cart_3cond_SNC_hRE.inp	Test14_Base_cart_full_hRE test for comparison to R-LINE: 3 met conditions
Test15_Base_cart_3cond_SNC_nar.inp	Test15_Base_cart_full_nar test for comparison to R-LINE: 3 met conditions
Test16_Base_cart_3cond_SNC_med.inp	Test16_Base_cart_full_med test for comparison to R-LINE: 3 met conditions
Test17_Base_cart_3cond_SNC_wid.inp	Test17_Base_cart_full_wid test for comparison to R-LINE: 3 met conditions
Test18_Base_cart_3cond_SNC_2ln.inp	Test18_Base_cart_full test for comparison to R-LINE: 3 met conditions
Test19_Base_cart_3cond_SNC_4ln.inp	Test19_Base_cart_full test for comparison to R-LINE: 3 met conditions
Test20_Urban_cart_3cond_SNC.inp		Test20_Urban_cart_full test for comparison to R-LINE: 3 met conditions
bg_no2_arm2_ppb.inp			Background NO2 test using ARM2 option and BACKUNIT:ppb
bg_no2_arm2_ugm3.inp			Background NO2 test using ARM2 option and BACKUNIT:ugm3
bg_no2_grsm_ppb.inp			Background NO2 test using GRSM option and BACKUNIT:ppb
bg_no2_grsm_ugm3.inp			Background NO2 test using GRSM option and BACKUNIT:ugm3
bg_no2_olm_ppb.inp			Background NO2 test using OLM option and BACKUNIT:ppb
bg_no2_olm_ugm3.inp			Background NO2 test using OLM option and BACKUNIT:ugm3
bg_no2_pvmrm_ppb.inp			Background NO2 test using PVMRM option and BACKUNIT:ppb
bg_no2_pvmrm_ugm3.inp			Background NO2 test using PVMRM option and BACKUNIT:ugm3
bg_no2_ttrm_ppb.inp			Background NO2 test using TTRM option and BACKUNIT:ppb
bg_no2_ttrm_ugm3.inp			Background NO2 test using TTRM option and BACKUNIT:ugm3
blp_urban.inp				Modified BLINE test using combined particle and vapor-phase emissions
grsm_beta.inp				Case to test the switch of the GRSM option from alpha to beta
in_urban.inp				Case to test the urban debug option using Indianapolis dataset

The aermod test cases have been expanded to examine a broader range of 
concentrations from the model. Most of the test cases above now output
both a plot file of the maximum concentrations at each receptor and 
a postfile of all concentrations for each hour at each receptor. A 
suite of R scripts have been developed to process these files and 
create a series of plots. The following files are part of this 
processing system:

File Name                             Description
----------------------------------    --------------------------------------
runtests_AERMOD.bat                   A DOS batch script that will run the 
                                      aermod test cases for a particular 
                                      version of the model. 

Process_AERMOD_test_cases_output.R    An R script that processes the postfiles
                                      from each model run and creates R data
                                      files for compressed file formats. 

Compare_AERMOD_test_cases.R           An R script that processes the R data 
                                      files the sets of model runs to create 
                                      a set of comparison plots.

read_POS.fun.R                        An R script that is used by the processing
                                      R script. 

read_POS_TESTDEP.fun.R                An R script that is used by the processing
                                      R script. 

