Control Specifications

Control Specifications are one of the main components in a Project, even though they do not contain much parameter data. Their principle purpose is to control when simulations start and stop, and what time interval is used in the simulation.

Creating a New Control Specifications

A new Control Specifications is created using the Control Specifications Manager. To access the manager, click on the Components menu and select the Control Specifications Manager command. The manager will open and show all of the Control Specifications currently in the Project. The manager can remain open while you manage Control Specifications or while you perform tasks elsewhere in the program. You can close the manager using the X button in the upper right corner. The buttons to the right of the specifications list can be used to manage existing specifications or create a new one. To create a new Control Specifications, press the New button. After you press the button, a window will open where you can name and describe the new Control Specifications that will be created. A default name is provided for the new specifications; you can use the default or replace it with your own choice. A description can also be entered. If the description is long, you can press the button to the right of the description field to open an editor. The editor makes it easy to enter and edit long descriptions. When you are satisfied with the name and description, press the Create button to finish the process of creating the new Control Specifications. You cannot press the Create button if no name is specified for the new specifications. If you change your mind and do not want to create a new Control Specifications, press the Cancel button or the X button in the upper right to return to the Control Specifications Manager window.

Copying a Control Specifications

There are two ways to copy a Control Specifications. Both methods for copying a Control Specifications create an exact duplicate with a different name. Once the copy has been made it is independent of the original and they do not interact.

The first way to create a copy is to use the Control Specifications Manager, which is accessed from the Components menu. Select the Control Specifications you wish to copy by clicking on it in the list of current Control Specifications. The selected Control Specifications is highlighted after you select it. After you select a Control Specifications you can press the Copy button on the right side of the window. A new Copy Control Specifications window will open where you can name and describe the copy that will be created. A default name is provided for the copy; you can use the default or replace it with your own choice. A description can also be entered; if it is long you can use the button to the right of the description field to open an editor. When you are satisfied with the name and description, press the Copy button to finish the process of copying the selected Control Specifications. You cannot press the Copy button if no name is specified. If you change your mind and do not want to copy the selected Control Specifications, press the Cancel button or the X button in the upper right to return to the Control Specifications Manager window.

The second way to copy is from the Components tab of the Watershed Explorer. Move the mouse over the Control Specifications you wish to copy, then press the right mouse button. A context menu is displayed that contains several choices including Copy. Click the Create Copy command. A new Copy Control Specifications window will open where you can name and describe the copy that will be created. A default name is provided for the copy; you can use the default or replace it with your own choice. A description can also be entered; if it is long you can use the button to the right of the description field to open an editor. When you are satisfied with the name and description, press the Copy button to finish the process of copying the selected Control Specifications. You cannot press the Copy button if no name is specified. If you change your mind and do not want to copy the selected Control Specifications, press the Cancel button or the X button in the upper right of the Copy Control Specifications window to return to the Watershed Explorer.

Renaming a Control Specifications

There are two ways to rename a Control Specifications. Both methods for renaming a specifications change its name and then all references to the old specifications name are automatically updated to the new name.

The first way to perform a rename is to use the Control Specifications Manager, which you can access from the Components menu. Select the Control Specifications you wish to rename by clicking on it in the list of current Control Specifications. The selected Control Specifications is highlighted after you select it. After you select a Control Specifications you can press the Rename button on the right side of the window. A new Rename Control Specifications window will open where you can provide the new name. If you wish you can also change the description at the same time. If the new description will be long, you can use the button to the right of the description field to open an editor. When you are satisfied with the name and description, press the Rename button to finish the process of renaming the selected Control Specifications. You cannot press the Rename button if no name is specified. If you change your mind and do not want to rename the selected Control Specifications, press the Cancel button or the X button in the upper right of the Rename Control Specifications window to return to the Control Specifications Manager window.

The second way to rename is from the Components tab of the Watershed Explorer. Select the Control Specifications you wish to rename by clicking on it in the Watershed Explorer; it will become highlighted. Keep the mouse over the selected specifications and click the right mouse button. Select the Rename command from the menu and the highlighted name will change to editing mode as shown in the following figure. You can then move the cursor with the arrow keys on the keyboard or by clicking with the mouse. You can also use the mouse to select some or all of the name. Change the name by typing with the keyboard. When you have finished changing the name, press the Enter key to finalize your choice. You can also finalize your choice by clicking elsewhere on the Components tab. If you change your mind while in editing mode and do not want to rename the selected Control Specifications, press the Escape key.

Deleting a Control Specifications

There are two ways to delete a Control Specifications. Both methods for deleting a Control Specifications remove it from the Project and then automatically update all references to that Control Specifications. Once a Control Specifications has been deleted it cannot be retrieved or undeleted. Any references to the deleted Control Specifications will switch to using no Control Specifications, which is usually not a valid choice during a simulation. At a later time you will have to go to those components and manually select a different Control Specifications.

The first way to perform a deletion is to use the Control Specifications Manager, which you can access from the Components menu. Select the Control Specifications you wish to delete by clicking on it in the list of current Control Specifications. The selected Control Specifications is highlighted after you select it. After you select a Controls Specifications you can press the Delete button on the right side of the window. A window will open where you must confirm that you wish to delete the selected Control Specifications as shown below. Press the OK button to delete the Control Specifications. If you change your mind and do not want to delete the selected Control Specifications, press the Cancel button or the X button in the upper right to return to the Control Specifications Manager window.

The second way to delete is from the Components tab of the Watershed Explorer. Select the Control Specifications you wish to delete by clicking on it in the Watershed Explorer; it will become highlighted. Keep the mouse over the selected Control Specifications and click the right mouse button. A context menu is displayed that contains several choices including delete. Click the Delete command. A window will open where you must confirm that you wish to delete the selected Control Specifications. Press the OK button to delete the Control Specifications. If you change your mind and do not want to delete the selected Control Specifications, press the Cancel button or the X button in the upper right to return to the Watershed Explorer.

Time Window

Each Control Specifications sets the Time Window over which a simulation will be performed. The time window is specified using a separate Start Date, Start Time, End Date, and End Time. There is no limit on the length of a time window, or the number of simulation time steps it can contain. The program contains simulation methods suitable for both event and continuous simulation. Whether a particular simulation is considered event or continuous depends on the length of the time window set in the Control Specifications and the methods chosen in the Basin Model.

The program is capable of processing dates from 1583 AD through 4000 AD. All dates are processed according to the rules specified in the Gregorian calendar for leap year. The format for specifying a date is to use two digits for the day, followed by the three-letter month abbreviation, and finally the four digit year. Two digit years are never used for entering or displaying dates. For example, the date February 8, 1936 should be entered as follows:

08Feb1936

It is very important to use the correct format or the date you enter may be incorrectly interpreted. If the program is not able to interpret a date, the entry field will become blank. The same format is used for both start and end dates, and for dates throughout the program.

The program processes times assuming an arbitrary local time zone that does not observe summer time (daylight savings in the United States). It uses 24-hour clock time instead of AM or PM notation. Time windows can only be entered with minute resolution. Times may range from 00:00 at the beginning of a day to 23:59 at the end. If a time of 24:00 is entered, it is automatically converted to 00:00 on the following day. For example, the time of 2:15:00 PM should be entered as follows:

14:15

It is very important to use the correct format, including the colon, or the time may be incorrectly interpreted. The same format is used for start and end times, and for times throughout the program.

Enter or edit the time window in the Component Editor for the Control Specifications. Access the editor from the Watershed Explorer on the Components tab by clicking on the desired Control Specifications icon. Type the date and time information in the appropriate fields.

Time Interval

Each Control Specifications includes the Time Interval that will be used to perform computations during a simulation. The same interval will be used when viewing time-series results from the simulation. In some cases, computations may be carried out at a shorter time interval and results interpolated to the interval specified in the Control Specifications. Some methods in the Basin Model have parameters that are sensitive to time interval. Those parameters should be estimated with knowledge of the time interval in the Control Specifications.

Time-series gage data and grid data are interpolated to the time interval during a simulation. The original data stored for the gage or grid is not altered; the available data is interpolated as part of the simulation process and is not retained. The interpolation is performed linearly in time between the available data points.

Specify the time interval in the Component Editor for the Control Specifications (illustrated in the previous figure). Access the editor from the Watershed Explorer on the Components tab by clicking on the desired Control Specifications icon. Select the desired time interval from the list of available choices. The possible choices range from 1 minute to 1 day.

It is important that any minutes included in a start or end time be an integer multiple of the time interval. For example, if the time interval were chosen to be 10 minutes, then the start or end time could be 10:00, 10:10, 10:20 or other multiples of 10 minutes. For the same time interval of 10 minutes, the start or end time could not be 10:07 because that is not an integer multiple of the time interval.