Toolbars

Menu Bar

The menu bar is the top line of the WEPS main screen. A description of each item on the menu bar is given below. NOTE: NRCS users (and some other users, depending upon the setting of specific configuration options) will see a slightly different menu bar with some of the following menu items not being available. Most noticeable will be the replacement of the "Project" menu option with the "File" menu option for single project WEPS configurations.

Project (or File)

The 'Project' menu is a drop down list of various computer operations pertaining to WEPS projects. The Project menu contains the following options:

New - allows user to create a new project from scratch (Ctrl-N).

Open... - allows user to open an existing project (Ctrl-O).

Save - saves the currently displayed project to its current file name (Ctrl-S).

Save As... - saves the currently displayed project under a different file name (Ctrl-A).

Set Run Location - allows the user to change the default Run Directory (Ctrl-U).

Reset - resets the current project selections to the system defaults.

Export Run... - allows the user to "export" or "copy" a completed WEPS run to another location and optionally delete the original copy.

Delete Project - opens a file chooser to delete a WEPS project (Ctrl-P).

Delete Run - opens a file chooser to delete a WEPS run (Ctrl-D).

Delete Management Rotation File - opens a file chooser to delete a WEPS management file (Ctrl-M).

Delete IFC Soil File - opens a file chooser to delete a WEPS soil file (Ctrl-L).

Exit - exit the WEPS program (Ctrl-X).

Run

This allows the user to run WEPS using the current inputs specified on the WEPS main screen or to restore inputs from previous WEPS Runs. The 'Run' menu on the WEPS Main Screen displays the following options:

'Make a WEPS Run' - begin a WEPS simulation using the current selected inputs (Ctrl-R).

'Make a Yield Calibration WEPS Run' - begins a WEPS simulation running WEPS in "yield calibration mode". See section titled "Making a WEPS Run" for more information on calibration runs (Ctrl-C).

'Restore a WEPS Run' - opens a list of previous WEPS runs to select and load the inputs used in a previous WEPS run (Ctrl-E).

ViewOutput

This menu allows the user to view output for the most recent (i.e., most current) WEPS run and previous WEPS runs.

'Most Recent Run' - clicking on this menu item opens a list of output options.

•	'Run Summary' - displays a brief output summary for the most recent WEPS run (Ctrl+Shift-S).

•	'Crop Summary' - displays a summary of yield parameters for the most recent WEPS run (Ctrl+Shift-C).

•	'Management Summary' - displays a summary of management operations for the most recent WEPS run (Ctrl+Shift-M).

•	'Detailed Reports' - displays a detailed output for the most recent WEPS run (Ctrl+Shift-R).

•	STIR Energy Report - displays the STIR and rotation energy report for the most recent WEPS run.

•	'Debugging Reports' - displays a screen to view additional output files from the most recent WEPS run (Ctrl+Shift-O).

'Previous Run' - clicking on this menu item opens the following list of output options.

•	'Run Summary' - opens a brief output summary of a previous WEPS run (Ctrl+Alt-S).

•	'Crop Summary' - opens a summary of yield parameters for a previous WEPS run (Ctrl+Alt-C).

•	'Management Summary' - opens a summary of management operations for a previous WEPS run (Ctrl+Alt-M).

•	'Detailed Reports' - opens the detailed output for a previous WEPS run (Ctrl+Alt-R).

•	STIR Energy Report - displays the STIR and rotation energy report for a previous WEPS run.

•	'Debugging Reports' - displays a screen to view additional output files from a previous WEPS run (Ctrl+Alt-O).

'Multiple Run Manager' - opens a window displaying output information from multiple runs for 'side-by-side' comparisons of the runs. The "Runs" menu at the top of the "WEPS Multiple Run Manager" (WMRM) screen contains items that allow the user to add a directory of runs or a single run in addition to restoring, exporting and deleting a run. Also, one can refresh the table display, print it or close it. The user can "restore" a selected run in WEPS so that its results can be viewed in more detail on the main WEPS screen and/or modify its inputs for another run. The "Help" menu item allows the user to display version information about the Multiple Run Manager.

Configuration

The 'Configuration' menu currently has only one item, 'Edit Configuration', which brings up a tabbed window with various configuration options for WEPS (Ctrl+Alt+E).

'WEPS' - opens a tab that allows the user to set the WEPS executable file and its command-line arguments (see Science Overview section of the WEPS User Manual for the command-line argument definitions):

•	Executable - enter the path and file name for the default WEPS executable or click the folder icon to display a file chooser.

•	Arguments - enter the default WEPS command-line arguments (see Appendix for argument list).

•	Calibration - enter the command-line arguments to be used for a yield calibration run (see Appendix for argument list).

'Windgen' - opens a tab that allows the user to set the windgen executable file, its command-line arguments, the windgen database records and index files, the interpolation executables and the distance used to determine the stations displayed in the dropdown choice lists:

•	Executable - enter the path and file name for the default windgen executable or click the folder icon to display a file chooser.

•	Arguments - enter the default windgen command-line arguments (see Appendix for argument list).

•	Database- enter the location for the windgen database location or click the folder icon to display a file chooser.

•	Index - enter the location of the index file (used to generate list of windgen stations) or click the folder icon to display a file chooser.

•	Interpolate 1 - enter the executable that determines the stations to use for interpolation or click the folder icon to display a file chooser.

•	Interpolate 2 - enter the executable that generates the interpolated station or click the folder icon to display a file chooser.

•	Radius - enter the distance used to display the list of station choices available in the dropdown choice lists.

•	Modes - Select the desired station selection modes available to the user: Station Choice List; Nearest Station; File; GIS; Interpolated; and NRCS.

'Cligen' - opens a tab that allows the user to set the cligen executable file, its command-line arguments, the cligen database records and index files and the distance used to determine the stations displayed in the dropdown choice lists:

•	Executable- enter the path and file name for the default cligen executable or click the folder icon to display a file chooser.

•	Arguments - enter the default cligen command-line arguments (see Appendix for argument list).

•	Database - enter the location for the cligen database location or click the folder icon to display a file chooser.

•	Index - enter the location of the index file (used to generate list of cligen stations) or click the folder icon to display a file chooser.

•	Radius - enter the distance used to display the list of station choices available in the dropdown choice lists.

•	Modes - Select the desired station selection modes available to the user: Station Choice List; Nearest Station; File; GIS; and NRCS.

'Directories' - opens a tab that allows the user to select the directories used for templates, skeleton files, databases, and projects by entering the path or clicking the folder icon to display a file chooser:

•	Man Template Open- enter the default directory for opening the management templates

•	Man Template Save- enter the default directory for saving the management templates.

•	Man Conversion Dir - enter the default directory for the management conversion (NRCS XML format) files.

•	Operation Records - enter the default directory for the management operation database files.

•	Crop Records - enter the default directory for the crop database files.

•	MCREW Dir - enter the default directory for MCREW configuration files.

•	Projects Dir - enter the default directory for WEPS projects.

•	New Project Default Runs Location - enter the directory for the WEPS runs to be placed by default for new projects (This option is unavailable for single-
project mode WEPS configurations ).

•	MCREW Data Config - enter the default file for MCREW configuration parameters.

•	Management Translation File- enter the translation file for converting NRCS RUSLE2 "skeleton" files to WEPS files.

•	Report Image Filename - enter the file name of the image to be displayed on the report files such as a agency logo.

•	Detail Report Filters - enter the path and file name of the XML formatted file describing the specific information to be available in the WEPS "Detail Reports".

•	Field Barriers File - enter the path and file name for the barriers database.

'Soil' - opens a tab that allows the user to set the soil specific parameters for WEPS:

•	Soil Database - enter the default directory (which includes subdirectories) for soil database files. These files can be WEPS 'ifc' files or soil SSURGO Access database files (click the path or click the folder icon to display a file chooser). If the file SDMDataAccess.nrcs.usda.gov.db is in the specified directory, the user also has the option of selecting soil data directly from NRCS Soil Data Mart (internet access required).

•	Organic Soil File - enter the selected soil "ifc" file to use in lieu of the real organic soil (This option is available since WEPS does not yet adequately address hydrologic and erosion issues related to highly organic soils).

•	Test for Organic Soils - this option enables several checks to determine if the selected soil is an "organic soil". If enabled, a popup will display allowing the user to substitute the specified "Organic Soil File" (the previously described configuration field) in place of the user's original selection.

•	Organic Matter Threshold - enter the value used to trigger organic matter level test component of the "Test for Organic Soils" configuration, if enabled.

•	Ignore Organic Surface Layer - if set, this flag will automatically remove the surface layer if it is determined to be an "organic" layer. This flag is useful for selecting soil that NRCS has previously mapped in a "native" state and has been disturbed for cropland production, etc. in such a manner that the original organic surface layer no longer exists.

•	Maximum Depth of Organic Surface Layer to Ignore - sets the maximum depth allowed to determine if the surface layer is to be automatically removed when the "Ignore Organic Surface Layer" configuration flag is set.

•	Average Stratified Soil Layers - specifies whether an NRCS surveyed soil component that has stratified soil layers, but not populated the individual layers, should "average" those layers properties.

•	Allow Estimations in the Soil User Interface - if selected, the interface can be used to generate a complete soil record if some of the necessary properties are not populated in the selected soil record.

•	Do Not Estimate Missing SSURGO Database Soil Values - if set, the interface will not accept SSURGO database records that are not fully populated. If not set, the interface will attempt to estimate some of the missing properties and load the file.

'GIS' - opens a tab that allows the user to select the directory used for GIS (shape) files used by the "Map" component in the WEPS interface (alternatively, the user can click on the folder icon to display a file chooser to select the desired directory path).

•	GIS Data - enter the directory containing all GIS data directories/files, e.g: cligen and windgen polygon shape files; country, state county boundaries; CMZ zones, etc.

'Output' - opens a tab that allows the user to set the following output options:

•	Reporting period for detailed submodel reports.

•	Flags for submodel reports, which give model developers and advanced users more detailed output than is available through the interface. See the Appendix for flag numbers to set for submodel reports.

'Email' - opens email and Mantis (bug tracker/submission system) settings:

Email Settings

•	Click the button to select to either "Use SMTP server" or "Use default mail client".

•	If "Use SMTP server" is selected, then enter your mailhost SMTP server address in the "Server Name" field.

•	Selecting "Use default mail client" causes your default system email client to be used for outgoing email from your WEPS application. Note: This setting does not work for all users and email clients. Additionally, select the "Use Outlook client" if Microsoft Outlook is the user's default email client. This setting deals with anomalies in Outlook's email messaging system so that it will work with WEPS.

•	Server Name - enter your email host's SMTP server address here.

•	Send From - enter the email address of the sender (user).

•	Send Comments To - enter email address for recipient of email comments.

•	Send Bug Reports To - enter email address for recipient of bug reports.

Mantis Settings

•	Your email - enter your email address that Mantis will use.

•	Mantis URL - enter the URL address (should be filled in by default).

•	Mantis user id - enter user id if registered EWERU Mantis user.

•	Mantis password - enter password if registered EWERU Mantis user.

•	Mantis project - enter the project Mantis submits reports to (should be populated by default).

'Run' - opens a tab with WEPS run options:

•	Default Run Mode - click a button to select a type of run length as either the NRCS method (which specifies a fixed number of cycles and is required for all "official" NRCS WEPS runs), use "Dates" to specify simulation run start and end dates on the main screen, or select "Cycle" to specify the number of rotation cycles on the main screen. NOTE: If the NRCS method is selected, the run length is fixed and cannot be altered (current default length is 15). This mode is required for all official NRCS WEPS runs.

•	Delete files after run - click the check box to enable this option. If set, all files listed in the "File Filter" field will be deleted at the conclusion of the WEPS run.

•	File Filter - enter the name(s) of files that should be deleted after a simulation run. This is intended to reduce the number of files in the run directory and conserve space. A list of multiple files should be delimited by commas, colons or blank spaces.

•	Display batch script creation option - if enabled, the user has the option to generate a batch file for the run rather than actually making the simulation run.

'Miscellaneous' - opens a tab that allows the user to set the following:

•	Measurement Units - display either Metric or English units on WEPS screens.

•	Time steps per day for wind speed distribution - enter the number of time steps used for the daily distribution of simulated wind speed.

•	Display latitude and longitude fields - check box to display the latitude and longitude fields in the 'Location' panel on the Main screen. Un-check the box to hide these fields.

•	Display state and county fields - check box to display the state and county fields in the 'Location' panel on the Main screen. Un-check the box to hide these fields.

•	Display elevation - check box to display the elevation field in the 'Location' panel on the Main screen. Un-check the box to hide this field.

•	Display use map button - check box to display the 'Use Map' button in the 'Location' panel on the Main screen. Un-check the box to hide this button.

•	Region slope is read only- check box to only display the simulation region slope on the Main screen and not allow it to be edited.

•	Rock fragments is readonly - check box to disable ability to edit the rock fragments field on the Main screen.

•	Barriers are readonly - check box to disable ability to edit barrier parameters on the Main screen.

•	Enable full MCREW editing functionality in WEPS - check box to enable the full MCREW editing functionality in WEPS. Allows additional editing functionality of MCREW. This should be disabled for normal WEPS operation because of undesirable effects for WEPS operation. Un-check the box to disable this functionality. When this functionality is disabled, the MCREW File 'Open' and 'Open Copy of Template' menu items are disabled.

•	Do not display system locale warning at startup - check box to turn off the display of a warning when WEPS is installed in a non-US locale. To avoid problems, WEPS is always installed using the "US locale", regardless of the local PC settings. The following is an example of the warning message displayed if the box is not checked and WEPS is installed in a non-US locale.

"WEPS has detected that this machine is using the German (Germany) locale. WEPS uses the English (United States) locale. You do not need to change your machine's locale, but be aware that numbers will be formatted in the English (United States) style."

For more info about what a "locale" is, see:

www.microsoft.com/globaldev/DrIntl/faqs/Locales.mspx

•	Do not prompt to review warnings when restoring a run.- check box to turn off warnings displayed from a previous run when it is restored.

•	Hide project file buttons - if checked, hides the "Project" buttons for soil and management fields on the Main screen.

•	Hide template file buttons - if checked, hides the "Template" buttons for soil and management fields on the Main screen.

•	Show Countries in Site Chooser - if selected, the "Country" field displays in the `Location` panel on the Main screen.

•	Days to keep logs - specifies the number of days WEPS log files are retained on the computer.

•	Tooltip Delay (ms) - sets the delay time for the initial appearance of the tooltip and for the dismissal of the tooltip box from the screen. The units are in milli-seconds. To disable tooltip display, set the "Initial" value to 1000 (1 second) and the "Dismiss" value to zero.

'Formats' - opens a tab that allows the user to set the following format options:

•	Operation Date - click the down arrow to the right of the box displays a list of available formats for the operation date. The format is displayed on this tab, next to "Operation Date" when a format is selected.

At the bottom of the Configuration panel are three buttons:

OK - saves the changes for the current running instance of the user interface only and closes the window.

Cancel - ignores any changes made in the configuration window.

Help - opens general help for the configuration window.

Tools

This menu contain various tools available for use with WEPS, including:

'Send Email' - send email comments to EWERU (or to anyone else, if desired), providing the computer is connected to the Internet and the email configuration options are properly configured. The user can also attach current WEPS project and run files to the messages (Ctrl+Alt-S).

'Bug/Comment Report' - send a Mantis ticket with comments and/or bug reports to the EWERU Mantis bug tracker/submission system, providing the computer is connected to the Internet and the email configuration options are properly configured. The user can also attach current WEPS project and run files to the messages.

'Display Wind Station' - displays wind information for the currently selected WINDGEN station including wind parameters by month. Clicking the down arrow to the right of the station name displays a list of available wind stations from which to choose. The assumed wind speed threshold (see discussion below) for the calculations (m/s), the station elevation (m), and the average wind energy for the year (kJ/m^2/day) are also displayed. The following parameters are displayed for each month (Ctrl+Alt-W).

•	Winds > Threshold - the percentage of the time the wind is above the given threshold. This parameter will give the user an indication of the percentage of time winds are near or above erosive speeds and should only be used for general purposes. The actual threshold of wind erosion used in WEPS varies with the surface conditions.

•	Energy - the erosive wind energy greater than the given threshold (kJ/m2/day).

•	Monthly Percent - percentage of the annual erosive wind energy.

•	Preponderance - the prevalence of the prevailing wind erosion direction for the month (maximum ratio of parallel to perpendicular erosion forces). A preponderance value of 1.0 indicates no prevailing wind erosion direction. A value of 2.0 indicates a prevailing wind erosion direction, with wind erosion forces twice as great parallel as perpendicular to prevailing wind erosion direction.

•	Prevailing Wind Erosion Direction - displays the prevailing wind erosion direction for the month.

'WEPS Diff' - opens a window that allows a comparison of differences in two WEPS specific files.

Help

This menu contains help options for WEPS, including:

'Help Topics' - displays a window containing the WEPS online help system (Ctrl+Alt+T).

'User Guide' - displays a copy of the PDF formatted WEPS User's Guide (a PDF viewer must be installed on the computer for this function to work.

'Welcome Wizard' - Runs an initial configuration wizard that requests the user's name and email address and sets them in the local configuration file.

'About WEPS' - displays the Build Date, Release Number, and Java Runtime Version used for WEPS (Ctrl+Alt+A).

Button Bar

At the top of the main WEPS window (below the menu bar) is a series of buttons with icons, designed to help the user in the operation of WEPS.

Project Operations

This button allows user to create a new WEPS project from scratch. This has the same function as selecting 'New' under 'Project' on the menu bar. NOTE: This button not available in NRCS configured single project mode release of WEPS.

This button opens an existing WEPS project. This has the same function as selecting 'Open' under 'Project' on the menu bar. NOTE: This button not available in NRCS configured single project mode release of WEPS.

This button saves the currently displayed WEPS project to its current file name. This has the same function as selecting 'Save' under 'Project' on the menu bar.

Run and Help

The 'Run' button begins a WEPS simulation run.

The 'Reload' button allows the user to "restore the inputs from a previous WEPS run" into the main WEPS interface window.

The 'Email' button allows the user to email comments to WERU, along with the contents of a WEPS project or WEPS run, if desired. Clicking the 'Email' button brings up a separate window (see below).

The user may enter the path/name of a file attachment manually (or select the "Attach Run" or "Attach Project" buttons to automatically zip the selected run or project directory) and then open the email client (either the built-in WEPS email client or the user's default client, depending upon what is specified in the configuration file). The user may provide additional information within the email client as they see fit. If you are connected to the Internet and the email options are properly set in the configuration screen, clicking 'Send' will email the message to EWERU, along with any attached files, so that your inquiry can be answered.

The 'Mantis' button allows the user to send electronically comments and/or bug reports to EWERU, , along with the contents of a WEPS project or WEPS run, if desired. Clicking the 'Mantisl' button brings up a separate window (see left).

The 'Question' button opens the general help system for WEPS.

The 'Context Help' button provides help for a particular item on the WEPS screen. Clicking the 'Context Help' button on the tool bar and then clicking on the item on the screen for which help is desired brings up a help screen for that specific item.

Following the icon buttons, the current run name is displayed. If the run name is too long to fit on the button bar, it will be truncated at the end of the name. NOTE: The main WEPS interface screen can now be resized, so it is now possible for one to widen the screen to see more of a long run name.

These buttons display the Run, Management, Crop, Stir Energy and Detailed Report output screens respectively.

Runs Location

This panel is located immediately below the "Button Bar" on th Main WEPS screen.

This 'Set Run Location' button allows the user to change the default WEPS Run Directory by popping up a modified file chooser window (see below).