1. WinSLAMM Batch Editor Module 23
Tab 21b – Batch Processor
WinSLAMM Batch Editor Module 23
Caroline Burger, PE
AECOM - Madison
UW EPD WinSLAMM Training
April 19-20, 2010

2. Tab 21b – Batch Processor
Batch Editor 1 2 3

3. Batch Editor Select ‘Run’ then ‘Run Batch Editor…’
Tab 21b – Batch Processor
Batch Editor
Select ‘Run’ then ‘Run Batch Editor…’

4. Batch Editor Select the directory where the SLU files are located.
Tab 21b – Batch Processor
Batch Editor
Select the directory where the SLU files are located.

5. Batch Editor View Clayey Soil Standard Land Use Files
Tab 21b – Batch Processor
Batch Editor
View Clayey Soil Standard Land Use Files

6. Batch Editor View Sandy Soil Standard Land Use Files
Tab 21b – Batch Processor
Batch Editor
View Sandy Soil Standard Land Use Files

7. Tab 21b – Batch Processor
Batch Editor
Double-Click on Standard Land Use File to see Source Area Names and Areas in this Pane

8. Batch Editor View Source Area Name and Area (acres)
Tab 21b – Batch Processor
Batch Editor
View Source Area Name and Area (acres)

9. Function 2 Run a Set of .dat files
Tab 21b – Batch Processor
Function Run a Set of .dat files
Use this batch mode tool to perform the following tasks:
1. Run a selected series of .dat files and get the outfall output from each file summarized in one comma-separated value file.
2. Analyze and compare the performance of selected BMPs in a series of model runs.
3. Analyze and compare the costs of selected BMPs in a series of model runs.
4. Modify groups of files at one time.

10. Function 2 - Running a Set of .dat Files
Tab 21b – Batch Processor
Function 2 - Running a Set of .dat Files
Run a Series of WinSLAMM Data Files at Once
View and Analyze the Results in Spreadsheet
Compare Files with Control Practices to a Base Conditions File
Analysis Cost Data
1. To Run a Selected Series of .dat Files:
a. Select the folder that contains the files that you want to analyze by pressing the 'Select Directory' button. The .dat files in that directory will appear in the left-most list box on the window, as files listed in the current directory. In the list box immediately to the right is a list of the standard land use (SLU) type of each of the files. If the file is not a standard land use file, it will say 'Not a SLU File'.
b. Add the files you want to analyze to the Run List. To do this, either double click on individual files or press the 'Add All Listed Files to Run List' button.
c. Press the 'Run Files in Run List' button. This will run each of the files. This output can then be viewed and analyzed in Excel or by selecting the 'View Output File" button. This feature is especially useful when comparing different control practice alternatives for a site.

11. Function 2 - Running a Set of .dat Files
Tab 21b – Batch Processor
Function 2 - Running a Set of .dat Files
2. To Compare BMP Performance:
a. Perform item a. from task 1.
b. Add the files you want to analyze to the Run List, selecting the base condition file first. To do this, either double click on individual files or press the 'Add All Listed Files to Run List' button. Note that the outputs from this file should be higher than or equal to any of the subsequent files.
c. Check the 'First File is Base Condition' box.
d. Press the 'Run Files in Run List' button. This will run each of the files. This output can then be viewed and analyzed in Excel or by selecting the 'View Output File" button. The output will include runoff volume and pollutant percent reduction calculations in the output file.
Select “Run a Set of .dat Files”

12. Function 2 - Running a Set of .dat Files
Tab 21b – Batch Processor
Function 2 - Running a Set of .dat Files
Select Directory where the .DAT files are stored
3. To Compare BMP Performance and Cost:
a. Perform items a. to c. from task .
b. Check the 'Include Cost Estimates' box and then select the Cost Data file that you want to use to analyze the costs.
Press the 'Run Files in Run List' button. This will run each of the files. This output can then be viewed and analyzed in Excel or by selecting the 'View Output File" button. The output will include runoff volume and pollutant percent reduction calculations as well as the cost per cubic foot (for runoff volume) or cost per pound of pollutant reduced by the control practices in the each .dat file.

13. Function 2 - Running a Set of .dat Files
Tab 21b – Batch Processor
Function 2 - Running a Set of .dat Files
Or Select “Add All Files to Run List” to Run Them All
Double Click on a Specific File Name to Select one or More .dat Files

14. Function 2 - Running a Set of .dat Files
Tab 21b – Batch Processor
Function 2 - Running a Set of .dat Files
Run the Files
Base Condition Analysis

15. Function 2 - Running a Set of .dat Files
Tab 21b – Batch Processor
Function 2 - Running a Set of .dat Files
View the Output in WinSLAMM or…
The output file will have the name 'DATSetOutput.csv' in the same directory as .dat files listed in the current directory. If you elected to evaluate the cost of the practices in your file, this file will also include the cost data for each file in your list. This file will be over-written if you run the files in the Run List again, so save the file with a different name if you want to save the output.

16. Function 2 - Running a Set of .dat Files
Tab 21b – Batch Processor
Function 2 - Running a Set of .dat Files
Open the Output File in a Spreadsheet

17. Function 2 - Modify a Set of .dat Files
Tab 21b – Batch Processor
Function 2 - Modify a Set of .dat Files
Select ‘.DAT File Batch Changes
4. Modify groups of files at one time.
a. Select the folder that contains the files that you want to analyze by pressing the 'Select Directory' button. The .dat files in that directory will appear in the left-most list box on the window, as files listed in the current directory. In the list box immediately to the right is a list of the standard land use (SLU) type of each of the files. If the file is not a standard land use file, it will say 'Not a SLU File'.
b. Add the files you want to modify to the Run List. To do this, either double click on individual files or press the 'Add All Listed Files to Run List' button.
c. Press the '.DAT File Changes' button.
Access this tool from the WinSLAMM Batch Editor window by selecting the 'Run a Set of .dat Files' button. Use the 'Select Directory' button to show the .dat files that are in a directory. To view the output, select the 'View Output File' button. The output is a comma separated value file that includes the site description text of each file in the run list. If the site description text has any commas in it, the format of the output file will be distorted. To correct this, the program will strip any commas in the site description text from the output of this tool. You can also manually strip the commas out of any set of .dat file site descriptions by using the Group DAT File Batch Changes tool.

18. Function 2 - Modify a Set of .dat Files
Tab 21b – Batch Processor
Function 2 - Modify a Set of .dat Files
This option allows you to change the current file data of the group of .dat files that you want to analyze in the Run List.
To Change the Street Delivery Files of the .dat files in the Run List
1. Go to the 'Current File Data' tab in the 'Modify .dat File Value in a group of Files' Window, and select the 'Change .std File Name to:' radio button.
2. Select the Street Delivery Land Use type you want to change the .std files in the Run File list to.
3. Press the 'Select File' button to browse to the .std file you want to apply, or type in the file name.
4. Select the 'Process Files' button to assign the variable to the files in the Run List.
To Change the Parameter Files of the .dat files in the Run List
1. Go to the 'Current File Data' tab in the 'Modify .dat File Value in a group of Files' Window, and select the 'Change Paramter File Name to:' radio button.
2. Select the Paramter File type you want to change the files in the Run File list to.
3. Press the 'Select <parameter file type> File' button to browse to the parameter file you want to apply, or type in the file name.
To Change the Rain File of the .dat files in the Run List
1. Go to the 'Current File Data' tab in the 'Modify .dat File Value in a group of Files' Window, and select the 'Change Rain File Name to:' radio button.
3. Press the 'Select File' button to browse to the .ran file you want to apply, or type in the file name.
4. Select either the 'Use Entire Rain File Dat Range' button or the 'Select Date Range' button. If you elect to select the date range, you must enter the start rain date and the end rain date using the "mm/dd/yy' format.
5. Select the 'Process Files' button to assign the variable to the files in the Run List.
To Change the Winter Season Option of the .dat files in the Run List
1. Go to the 'Current File Data' tab in the 'Modify .dat File Value in a group of Files' Window, and select the 'Winter Season' radio button.
2. Select the 'Activate Winter Season Option' checkbox. To remove the winter season option, just select the 'Winter Season' radio button and do not check the 'Activate Winter Season Option' checkbox.
3. Enter the Start of Winter date and End of Winter date, using the "mm/dd" format.
For additional information, see the help file

19. Function 2 - Modify a Set of .dat Files
Tab 21b – Batch Processor
Function 2 - Modify a Set of .dat Files
This option allows you to modify or add grass swales to the group of .dat files that you want to analyze. To modify the existing grass swale control variables that are in files in the Run List, follow these steps:
Change a Variable in .dat Files that already have Grass Swales
1. Go to the 'Grass Swales' tab in the 'Modify .dat File Value in a group of Files' Window, and select the 'Grass Swale Modifications' radio button.
2. Select the variable that you want to apply to all the .dat files in the run file list (Run List) of the 'File Selection for DAT Set Model Run' window by selecting the appropriate radio button. Then enter the desired value in the text box for that variable. If you select 'Swale Dyn. (Dynamic) Infiltration Rate', the 'Select infiltration rate by soil type' list will activate. If you select 'Swale density', the 'Typical Swale Density by Land Use' list will activate. If you select the 'Avg. Swale Length to Outlet (ft)' button, then you can either enter the average swale length you would like to apply to all files in your group of .dat files, or, by entering '9999', you will allow the program to calculate the average swale length based upon the land use area served by swales for each file in your group of .dat files.
3. Select the land use you want to apply the changed variable to. You can select 'All Land Uses', the 'Combined Land Uses', or an individual land use.
4. Select the 'Process Files' button to assign the variable to the files in the Run List.
You may also perform the following actions on the files in the Run List:
Add Grass Swales to the .dat Files in the Run List
2. Select the 'Add Grass Swale to File' checkbox.
3. Enter a value in all the variables that are activated.
Remove Grass Swales from the .dat Files in the Run List
Select the checkbox 'Remove Grass Swales from File'.
For additional information, see the help file.

20. Function 2 - Modify a Set of .dat Files
Tab 21b – Batch Processor
Function 2 - Modify a Set of .dat Files
This option allows you to change the soil type of the group of .dat files that you want to analyze in the Run List.
To Change the Soil Type of the .dat files in the Run List
1. Go to the 'Source Area Modifications' tab in the 'Modify .dat File Value in a group of Files' Window, and select the 'Soil Type Modifications' radio button.
2. Select the soil type you want to change the files to.
3. If you selected 'Clayey' soils, you will need to select the building density.
4. If you selected 'Medium or High' building density, you will need to choose whether or not alleys are present.
5. Select the 'Process Files' button to assign the variable to the files in the Run List.
These changes will replace the existing variables in the .dat files in the Run List unless you also make 'File Name Modifications' to the files in the Run List. Once you have completed the file modifications, if you have also renamed the file or changed the Standard Land Use classification text, to see the changes in the File List, you must re-select the directory the files are in by pressing the 'Select Directory' button on the File Selection for DAT Set Model Run window.

21. Function 2 - Modify a Set of .dat Files
Tab 21b – Batch Processor
Function 2 - Modify a Set of .dat Files
File Name Modifications. To change the file names when you modify the file contents with the tools in this window, check the File Name Modification checkbox. There will be two file name change options:
1. Numeric Modifications. To place numbers at the end of each file in the Run List, select the 'Numeric Modifications' button, and then either the button to replace numbers at the end of the file name or to add numbers to the end of the file. Then enter the starting number in the text box and finally, enter the maximum number of digits that you are adding to the set of files in the Run List. For example, if the final number will be 105, select '3'. Then press the 'Process File' button to make the changes in the file name.
2. Text Modifications. To add text, select the 'Add Text' button, and then either the 'Before' or 'After' the file name button to place the additional text either before or after the existing file name. Type in the additional text, which will then be placed in each file in the Run List, when you press the 'Process File' button. To replace text within the file name, select the 'Replace Text Within the File Name' button, and then type in the exact text string you want to replace (case matters) in each file name in the Run List and type in the text you want to replace it with, and then press the 'Process File' button.
Editing the Site Description Text. If you are modifying files, you may also want to change the file description for those files. For standard land use files, you will probably want to modify the standard land use code that is in the comment line of each file. There are four site description text change options. The first three are for changing various components of the Standard Land Use (SLU) file codes. The final one is used to make general changes in the site description text.
Questions?