Simulation File Format

ID: - WT: - This format is used to store simulation information. Of which a good portion is outlined in *Concepts*

#EBNF and explantion#

Results File Format

ID: - WT: - This format is used to store the raw simulation results, various cross-section/reach labels, and reach lengths.

#EBNF and explantion#

Chart File Format

ID: - WT: - This Contains a series of final data in the form of scenario divisions and reach group. The daa is intended to be displayed in a graph.

#EBNF and Explanation#

Import File Format

ID: - WT: - The Simulated Data such and water elevations and slope of the energy gradeline can be pasted in, entered in manually, or imported in. The Import File Format follows, but is essentially the Hec-Ras output text file format.

#EBNF and explanation#

Concepts

ID: - WT: - There are several concept which one might be interested in for the use of the program. Here is a listing of those with written documentation: * Hec-Ras * Simulation Name * Gamma/Water Density * Time/Timesteps * Cross-Sections/Reaches * Erosion Functions * Soil Elevations * Water Elevations * Energy Gradeline * Table/Data Modeling * Results * Graph Generation

Hec-Ras

ID: - WT: - Hec-Ras is a hydology modeling program written by the Corp of Engineers. This program can take hydo-graphs and generate a simulation of flow in a river, also providing a wide selection of information. For this program Hec-Ras provides 2 important values: Water Elevation per Time and the Slope of the Energy Gradeline.

Simulation Name

ID: - WT: - This can really be any label or name you choose for the graph. It is intended to provide a human legible title to the simulation, which is progated to produced results and graphs. The only stipulation on the contents of this value is that double quotes, '"' are not permitted as they interfer with the file format.

Gamma/Water Density

ID: - WT: - Water Density is a double floating point number. Which is probably only to use by the numerical analyst, but suffice it to say-it is a number which can contain a decimal point. Average/Standard water density is #WATER DENSITY#. n However, this value can change with temperate and supended matter, so you may change it as you see fit. Using an inapproiate value is a matter which the employer of this program would be responible for.

Time and Timesteps

ID: - WT: - The data in the simulation in discrete over space and time, so the time in the simulation is divided into a series of "timesteps" of equal duration. The duration of a step is specified in days, hours, and minutes (a string containing this information as Xd-Yh-Zm is called a DHM string, or in DHM format). The Simulation Duration then is given by the number of timesteps times the duration of a timestep.

Points in time internal are represented at the time elapsed since the beginning of the simulation (0d-0h-0m). However for human readability, how can give a base date at times, do display points in time as a date rather than a DHM string.

Cross-Sections/Reachs

ID: - WT: - Cross Sections in the simulation are essentially reaches of the river. But cross-sections are also appropiate as a cross-section of the river is used to describe the reach.

There is an amount of daa associated with each cross-sections. First is a name, to label associated information. Next is associated hec-ras reach and river station labels. These labels are used to import hec-ras data by identifing a particular station whoses profiles are to be read in. Each reach, also, has an associated length in miles. Finally, there are the cross-section/ reach geometries. These serve as X,Y coordinates in the plane perpendicular to the river at some point. Both X,Y are floating point numbers in feet. The X values are relative to some point, but Y is the elevation of the river bed at X with repect to mean sea level. The elevations between the given points are interpolated linerally. So for an irregular channel, it is best to be a greater number of X,Y points to describe the geometry. The only note, is that points with the same X value are not valid.

Erosion Functions

ID: - WT: - Erosion Function are the set of function which each function describes the erosability of a particular soil type as function of shear stress (Tau #UNITS#). In This program functions are entered as a series of Tau,Erosion(in/sec) points, which are linerally interpolated between as needed. However, NO expolate is don't. An Error occurs if the shear stress goes out of the range of know points. Each function is given in order from 1 to n (n is the number of soils) and these correspond to soils 1 to n.

Soil Elevations

ID: - WT: - The Soil Elevations for a given cross-section are the elevations in feet about mean sea level that corrspond to the bottom of each soil strata appearing at that cross-section/reach. Not obviously you only need to use the soil that will appear in the cross-section. The bottom most strata isn't considered to have a bottom, but the evalation is used to order the soil strata, so an elevation must be given for it. Normally this doesn't matter, but in determining a starting point for the cross-section, it is important that it's bottom be below the lowest point of the cross-section. However, note that the uppermost strata isn't considered to have an upper end, but this doesn't matter and is solely for your informatin.

Water Elevations

ID: - WT: - The Water elevations represent the elevation of the water's surface at a particular location for a given time. The Water elevation values are given in feet about mean sea level. Values are a table/function of *time/timestep* and *cross-section*.

Energy Gradline

ID: - WT: - The Energy Gradline #explanation#, given in #units#. Values are a table/function of *time/timestep* and *cross-section*

Results

ID: - WT: - Final Results are given cubic feet per timestep for each timestep (which has a given length).

So if you have 3 hour time steps you get cubic feet per 3 hours. Furthermore, if the simulation runs 24 hours, you will have 8 values. From this a variety of things can be done. Like applying conversion factors or averaging to a unit time, while generating graphs. For more information about this see *Generating Graphs*. And for information about getting raw numbers from the graph see *Graph*.

ID: - WT: - First there are several concept to breifly cover conversion factors, time normalization, length averaging, scenarios, and reach grouping.

Conversion Factors come in two flavors a global converstion factor and a local muliplier. The first is intended for global converstion of units. (e.g. Cubic Feet to Cubic Yards). The later is for multiplier that depend on a factor that is reach specific. (e.g. Average reach depth)

Time Normalization Is a conversion factor which affects the time unit. Though a general unit like minute or hour may be asked for, the actually conversion factor has to be calculated from the duration of a timestep.

Length Averaging This normalized the raw data via length. Often reachs with have different lengths in miles. Choosing to averages produces value per unit length.

Scenearios This are groupings of time which different start/stop points in the simulation and different ways in which the timesteps covered are grouped together. That canbe useful for looking at results over longer steps of times, or even over the scenarios. Steps within scenarios are called Divisions.

Groups This allow grouping together the results from different reaches. E.g. A group labels "Total River" could be a group of all the reaches so you can look at total erosion over the whole length of river. Reaches can appear in multiple groups. And if you are doing averaging based on length, then a group doesn't produce a sum of the members erosion, but an average per length erosion rate using data from all the members.

Graph Generation This generation of the graph data is what will be discussed here. The method takes a 2-pass approach. The first pass creates a table, where values per each divison and cross-section are given. At this time, cross-section multiplers, global convertion factors, and time normalization if needed are applied. The next pass produces the final table consisting of groups and values per time division. In the second pass, groups are consituted according to whether averaging is being used or not. This final table of groups vs. scenario/division is what is graphes. Note. that with converstion factors of all 1 and groups covering all availible cross-sections(while having only one member), that a scenario can be constructed to graph the raw results directly.

Main

ID: 1 WT: - This is what is called a Multi Document Interface(MDI) window; that is, several "child" windows or documents can be opened and displayed at the same time inside it. These windows may be of the following types:

* Simulation - setup data to produce per reach and time results. * Results - view the raw data or set parameter to generate graphs. * Chart - View and tweak a chart, you may also copy the chart to clipboard both as a graphic and a table of data.

This window also provides the menu bar in which some common commands can be accessed.

* File Menu - Commands to Open/Create/Close Files and to exit the program * Edit Menu - Copy special areas in the window * Window - Arrange windows and view a list of open windows/files * Help - Provide information about this program.

File Menu

ID: 11 WT: - This File menu contains all commands related to opening, creating, closing, and saving. These include:

* New Simulation * Open * Save * Save As * Close * Exit

See Also *Simulation*, *Results*, *Chart*, *About*

New Simulation

ID: 12 WT: - New Simulation creates an Empty Simulation window to start entering data into. A simulation is the collection of data required to determine the potential erosion in a reaches of some sort of water way.

See Also *Concepts*

Open

ID: 13 WT: - Open brings up a file dialog box similar to the one shown. From this box one selects the type of file they which to open, and the locate and select that file.

* .sim files are Saved simulations * .rst files are Saved results * .grd files are Saved Charts

Save

ID: 14 WT: - Save commits a window/file to disk. If the file is a new file, then a filename will be needed and this command operates like *save as*. For information on file formats see the appropiate *help entry*.

Save As

ID: 15 WT: - Save As commits a window/file to disk as a filename expliticly given by the user. A dialog box will open like the one shown, and the use must chose a location and filename to give the file. Each window type has it's own *file format*, and the appropiate one is automatically selected.

Close

ID: 16 WT: - This is a very simple command. It closes the active window. However before closing it, it will ask to save should the window be classified as modified. Then the *Save*/*Save As* command is called as appropiately.

Exit

ID: 17 WT: - This command exits the program, however, not before properly *closing* all opened windows.

Edit Menu

ID: 21 WT: - This edit menu it typical for command which edit something, at the very least clipboard(copy/paste). These are commands in the edit menu, which may are make not be enabled: * Copy

Copy

ID: 22 WT: - While, you can normally use #Ctrl-C# for copying data, this menu item is used for copy special parts of an open window, they maynot be a text box.

Window Menu

ID: 31 WT: 0 The menu has command for arranging, view lists of, and selecting windows, including: * Cascade * Tile Horizontally * Tile Vertically The rest is a list of windows which have been opened. Selection such an item to bring it to the front, actived for use.

Cascade

ID: 32 WT: - This command arranged windows in a series or non-maximzed windows similar to pile of cards.

Title Horzonitally

ID: 33 WT: - This command arranges all the windows side by side like a set of floor tiles. Should a divison on the screen needs to be made, the horizontal direction is prefered over the vertical direction.

Title Veritcally

ID: 33 WT: - This command arranges all the windows side by side like a set of floor tiles. Should a divison on the screen needs to be made, the vertical direction is prefered over the horizontal direction.

Help Menu

ID: 41 WT: - The help menu provides a possible entry point into the documentation for this program.

* About - give brief program and copyright information * Contents - displays help's table of contents * Index - browse/search the index * Search - do a full text search of the help documentation.

Simulation Window

ID: 101 WT: - This simulation is the interface by which to view and edit the data/paramters of the "simulation." Click on the various parts of this image to select more detail about that particular area.

Process Simulation

ID: 102 WT: 10102 This button initiates the simulation calculation. After processing, a log of the process is displayed using the *Log Viewer*. The final results are displayed in a *result window* for later saving.

Simulation Parameters

ID: 111 WT: 10111 This simulation parameters are a group of data describing the physical setup of the channel bed(s) and also describing the time parameters of the simulation.

The following image are the different parts of the Simulation Parameters interface:

Simulation Name

ID: 112 WT: 10112 The simulation is primary for human reading and identification. There is no real limitation on the string you can enter here other, than it must be a single line and contain no quotes. #image# See Also: *Simulation Name, Concepts*

Gamma

ID: 113 WT: 10113 Gamma represents the average density of water in this simulation. It must be a number(may have a decimal point). And is given in #units# #image# See Also: *Water Density*

Time-Step

ID: 114 WT: 10114 These components are used to definite the duration of a time-step. (See Also, *Time-steps and Time*). This is done in the days. hours, and minutes. As use enter different part, then the values will be normalized. i.e. Conversions take place so that minutes # 60, hours # 24. All parts must be non-negative integer values. #image#

Time-step count

ID: 115 WT: 10115 Ultimatly, the simulation is done in wholly in the form of timesteps. this parmeter defines how timesteps to take. This must be a positive integer value(anything else is invalid). Together with the time-step duration, a total simulation duration can be calculated. #image#

Cross-Sections

ID: 116 WT: 10116 In order to setup the values of each cross-section we need to know how many there are. This parameter defines this, and must be a positive integer. For an overview of cross-section parameters see *Cross-sections/Reaches* #image#

Name

ID: 117 WT: 10117 This Button starts the *table editor* to edit all label parameters (some are used for import from hec-ras) for each cross-section. Any string without quotes are newline should be ok for input. Here is a overview of the table. #image#

The First column is the reach/cross-section name we are giving it within this program.

The Second column is the hec-ras reach label. This is used for identifying locations to import values for. It is up to 16 characters long.

The Third is the hec-rec river station label. It is alose used for identifying locations to import values for. It is up to 16 characters. Note: Right now the Hec-Ras River label is not used for IDing locations, so please make sure that a given river station/reach pair is unique, in the files you are importing from.

see also *Cross-Sections/Reaches* and *hec-ras*

Geometries

ID: 118 WT: 10118 This Button starts the *table editor* to edit all *cross-section* geometries, that is the bed shape in the plane perpindicular to the river. Here is an overview: #image#

The first column is an X coordinate of a location on the geometry. It is in feet, and can be from the left or from the right, but one should try to be consistent throughout. The "starting" point can even be non-zero, as long as all the other X values are equally shifted. This allow referencing the X coordinates from a common point on land(e.g. a tripod). The second column is the Y coordinate. It is the elevation of the coordsponding X coordinate about mean sea level. Note that while, elevation can be repeated, no location can have two elevations. So X coordinates may not be repeated.

Length

ID: 119 WT: 10119 This Button starts the *table editor* to edit all *cross-section* lengths. The lengths are given in miles. Here is an overview of the interface: #image#

There is only one column, the length column. However, each row strating from 1 and going to the number of cross-sections, represent the length of reach x.

Soil Types

This specifies the total number of soil types in the simulation. Each type has a number ranging from 1 to the number of soil types. This parameter is a positive integer. #image# see Also: *soil functions*, *soil elevations*

Soil Functions

ID: 121 WT: 10121 This button starts the *table editor* to edit the *erosion functions* of each soil type. There is one function for each type as is entered as (shress stress, erosion) pairs via the following interface, to produce a function of shress stress, yielding erosion. Values are linearlly interpolated between, but doesn't extrapolate. #image#

The first column is the stress stress value of the particular function given in #units#. The second column is the erosion rate given in feet per second.

Soil Elevations

ID: 122 WT: 10122 This buttons starts the *table editor* to edit the *soil elevations* within each *cross-section*. Here is an overview: #image#

The first column is the soil type represented, the second is the bottom of it's strata given as an elevation in feet about mean sea level. The lowest strata, should have a bottom lower than the lowest point in the associated cross-section. Also not all, but at least one soil type must be present. And there can even be multiple strata of the same soil type.

Simulation Tables

ID: 131 WT: 10131 These are the tables and function relating to the hyrdology of the river in question. Click on the following image parts for more information. #image#

Water Elevations

ID: 132 WT: 10132 This starts the *table editor* to edit the water elevations with respect to mean sea level(in feet). Each table in the editor is the cross-section we are looking at, and each row are the timesteps from 1 to the number of timesteps. So the floating point number given is in feet and is given for each cross-section at each timestep #image# See also *water elevations*

Slope of the Energy Gradeline.

ID: 133 WT: 10133 This starts the *table editor* to edit the *slope of the energy gradeline* at each cross-section for each timestep. Here is an example table: #image# the the energy grade line is a unitless value.

Import Hec-Ras Table

ID: 134 WT: 10134 This starts an process using the Hec-Ras import labels given in the *cross-section* *names* table, so import Water Elev and E.G. Slope from a *Hec-Ras* *text output file*.

Table Editor

ID: 201 WT: - This is a editor/view to edit data in a variety of tables. It supports "arrays" of tables so you can have different tables for different objects(e.g. different reaches). It can handle arrays with a fixed number of values, or those to which records can be added to and removed from different tables. It also can view them as read-only. Here is a typical interface, click on the various parts for more information. #image#

Tables

ID: 202 WT: 10202 This allow you to change the number of tables in the array, however at this time is almost never used. It's value must be a positive integer. #image#

Close

ID: 203 WT: 10203 This buttom simply closes the editor and returns to the parent window. #image#

#image#First

ID: 204 WT: 10240 Move to the First object(table) in the group.

#image#Prev

ID: 204 WT: 10240 Move to the Previous object(table) in the group.

#image#Next

ID: 204 WT: 10240 Move to the next object(table) in the group.

#image#Last

ID: 204 WT: 10240 Move to the Last object(table) in the group.

#image#First

ID: 204 WT: 10240 Here is a typical grid. #image#

The very top grey parts is the table header, it tells you The top grey area of the column headers Move to the First object(table) in the group. what row and table you are on, and what both represent. The side side array are the row headers, and the rest is the grid proper.

To navigate the cells in the grid, can scroll to browse the rows and column. Once in the grid, you can use the arrow keys and tab to naavigate around. #images#

To select a cell you can click on it. And to edit it you can #enter?#, #doubleclick?#, #click on selected?#, #type???# when edit the cell a cursor with appear in the cell: #image#

To append a record(if you are allowed to), look for the last row. It will have a "*" in the row header. Enter the record here, and move around the cursor/hit enter when done, and the row will become a normal record an a new line with an asterik will be add for the next new record. #image#

To delete a record click on the row header the row you wish to delete. This will selection the row. Now press the #del# key. #image#

Log Viewer

ID: 301 WT: - The log viewer is a simple dialog, which displays a rich text log. Errors/Failurs in bright red, Success in dark green. Everything else in black. #image#

Log Pane

ID: 302 WT: 10302 This is where the actual text of the log appears. You can navigate around in to as normally. #image#

Copy

ID: 303 WT: 10303 This button copies the text in the log window to clipboard. #image#

Close

ID: 304 WT: 10304 This button simply closes the log dialog.

Results Window

ID: 401 WT: - This window is used to view the raw data that comes out of processing the simulation. From her eyou can set parameters of graphs to create. #image#

Simulation

ID: 402 WT: 10402 This is the title of the parent simulation, or the parent's *simulation name*. #image#

Filename

ID: 403 WT: 10403 This is the name of the file that the parent simulation was stored in.

Min Timestep

ID: 404 WT: 10404 This is essentially the *timestep* of the parent simulation. This is called the minimum timestep, because while use can group together timestep together for graph output, making larger timesteps; you cannot make a timestep of the graph smaller than the simulation produced.

Duration

ID: 405 WT: 10405 This is the length of the parent simulation, in number of *timesteps*.

Cross-Sections

ID: 406 WT: 10406 This is the total number of *reaches* in the parent simulation.

View Names

ID: 407 WT: 10407 This starts the *table editor* in read-only mode in order to view the *reach* names.

View Results

ID: 408 WT: 10408 This starts the *table editor* in read-only mode in order to view the results of the simulations (rememver they are in cubic feet of soil per cross-section length per timestep-duration.

Make Graph

ID: 411 WT: 10411 This Area encompasses the parameters for generating a graph #image# see also: *Generating Graphs*, *Graph*

Additional Title

ID: 412 WT: 10412 This is a place were a subtitle specified for the next graph to create #image#

Base Date

ID: 413 WT: 10413 Here you may specify a Base Date to make all periods of time relative to. #image#

Average per Time

ID: 414 WT: 10414 This optional allow one to specify a time unit to put the graph in. So instead of cubic feet per timestep, it would be the average erosion per unit time based upon the data in timestep's span on time. #image# See Also: *Generating Graphs*

Output Unit

ID: 415 WT: 10415 This is the unit text to display. The default is cubic feet, meaning cubic feet per timestep/division. While this is primarily an arbitary value for reading purposes, you may choose one from the drop down list. Selecting one, will update the conversion factor to an appropiate value. #image# See Also: *Generating Graphs*

Converstion Factor

ID: 416 WT: 10416 Here one can set a global conversion factor to convert from cubic feet (per given reach per timestep) the default is cubic feet. The factor is applied according to *Generating Graphs*. The factor must be a floating point number. #image#

Scenarios

ID: 417 WT: 10417 This button opens up the scenario editor. This allows the setting of different scenarios that take place at different point in the simulation and display them side-by-side on the graph at a total for the scenarios or some set of scenario divisions. See Also: *Graph Generation*, *Scenario Editor*

Reach Groups

ID: 418 WT: 10418 This buttons opens up the reach/cross-section group editor. This allows setting up reach group that consider the data from several groups and display them side-by-side with other reaches and group as it's own line item. The exact behavior depends whether the graph is averaging over length or not. If so that amount of erosion is summed, if not an average is produced from that total divided by the sum of the reach lengths. #image# See Also: *Graph Generation*, *Reach Group Editor*

Generate Graph

ID: 419 WT: 10419 This button takes the parameters given in the make graph area, and produces a finished set of data and displays it as a graph #image# See Also: *Graphing Graphs*, *Graphs*

Reach Group Editor

ID: 501 WT: - This dialog is the place where the setup of reach groups occurs. This major areas are the List of Groups(at the top) and group member selection(at the bottom). Changes are applyied in real time. #image#

OK

ID: 502 WT: 10502 This button simply closes the Reach Group Editor.

Groups

ID: 511 WT: 10511 This Area contains contains all the facilities to edit the list of groups(not members of those groups). Here you can add, delete, and rename group. You can also specify whether or not to average according to length in the groups or just sum. #image#

Group List

ID: 512 WT: 10512 This is the list of groups in slated for the next graph. Primary column here are the group names, group types, and group members. Note: There cannot be a group with no member, such groups are interpreted as all reachs(primarily to save money). #TODO for empty groups maybe display all check marks# #image# See Also: *Add*, *Delete*, *Rename*, *Generate Graph*

Name

ID: 513 WT: 10513 This textbox is a parameters for other operation. For example, if you type NewGroup here and press Add, a new group called 'NewGroup' will be added to the list. The name must be a string without newlines or double quotes. #TODO fix theat focus problem# #image#

Add

ID: 514 WT: 10514 The Add button will create a new Reach group. The procedure is as follows.

1.) In the *Name* textbox type in the name of a group you wish to create. The name must be unique and void of double quotes and newlines. #image# 2.) Click the Add Button #image# 3.) The Group will now appear in the *Group List* as a group with all reaches as members. #image#

Rename

ID: 515 WT: 10515 The Rename button will rename an existing Reach group. The procedure to rename a group is as follows.

1.) In The *Group List*, Select the Group you wish to rename by clicking on it. #image# 2.) Type in the Name to Rename the Group to in the *Name* textbox. Remember the name must be unique and void of double quotes and newlines. #image# 3.) Click the Rename Button #image# 4.) The Group will appear in the *group list* with it's new name. #image#

Remove

ID: 516 WT: 10516 The Remove button will delete an existing Reach group. The procedure to remove one is as follows:

1.) In the *Group List*, select the group you wish to remove #image# 2.) Click the Remove Button. #image# 3.) The Group will Disappear from the Group List. #image#

Multiplier

ID: 517 WT: 10517 The Multipler Box is used to edit a group modifier. Sometimes multipliers are dependent on the reach members in order to be meaningful(e.g. a multiplier bases on total length of reaches). The Default is 1. #image# See Also: *Graph Generation*

Group Average

ID: 518 WT: 10518 This checkbox, allows selecting between summing the group member erosion data. Giving a Total erosion in some period of time, or averaging over the entiring length covered by the group to produce per unit length values. #image#

Group Member Selection

ID: 521 WT: 10521 The Group Member Selection is the area of functionality whee one can select group members, for the currently selected group. #image# See Also: *Graph Generation*

Reach List

ID: 522 WT: 10522 The Reach List is the List of all the Reaches/CrossSections in the 'simulation'. Here you add/removed members by clicking the checkbox right besides the name of each reach. #image# See Also: *Graph Generation*

Invert

ID: 523 WT: 10523 The Invert button will invert your group member selections. That is, anything that was checked will be unchecked, and anything that was unchecked will be checked. #image# See Also: *Graph Generation*

Mark All

ID: 524 WT: 10524 The Mark All name for this button is a bit misleading. Remember that an empty list is considered to be a full list. So inorder to to mark the group as an "All" group, the group list is emptied. See Also: *Graph Generation*

Scenario Editor

ID: 601 WT: - The Scenario Editor is used for Setting up the scenario parameters slated for the next graph. Scenarios can overlap in time, and have the following parameters: *Starting TimeStep*, *Total Timesteps*, *Number of Divisions*. #image# See Also: *Graph Generation*

OK

ID: 602 WT: 10602 This button simply closes the scenario editor dialog. #image#

Scenarios

ID: 611 WT: 10611 This area is the place where you can *Add*, *Rename*, and *Remove* Scenarios. #image# See Also: *Graph Generation*

Scenario List

ID: 612 WT: 10612 This is the list of Scenarios. It displays then with name, Starting Time, and Ending Time. See Also: *Graph Generation*

Name

ID: 613 WT: 10613 This textbox is a parameters for other operations. For example, if you type NewGroup here and press Add, a new group called 'NewGroup' will be added to the list. The name must be a string without newlines or double quotes. #TODO fix theat focus problem# #image#

Add

ID: 614 WT: 10614 The Add button will create a new Scenario. The procedure is as follows.

1.) In the *Name* textbox type in the name of a group you wish to create. The name must be unique and void of double quotes and newlines. #image# 2.) Click the Add Button #image# 3.) The Scenario will now appear in the *Scenario List* as a group with all reaches as members. #image#

Rename

ID: 615 WT: 10615 The Rename button will rename an existing Scenario. The procedure to rename a group is as follows.

1.) In The *Scenario List*, Select the Scenario you wish to rename by clicking on it. #image# 2.) Type in the Name to Rename the Scenario to in the *Name* textbox. Remember the name must be unique and void of double quotes and newlines. #image# 3.) Click the Rename Button #image# 4.) The Scenario will appear in the *Scenario list* with it's new name. #image#

Remove

ID: 616 WT: 10616 The Remove button will delete an existing Scenario. The procedure to remove one is as follows:

1.) In the *Scenario List*, select the group you wish to remove #image# 2.) Click the Remove Button. #image# 3.) The Scenario will Disappear from the *Scenario List*. #image#

BaseDate

ID: 617 WT: 10617 This Display the Entered BaseDate for the Graph. If a valid date starting, stoping of scenarios and divisions will be displayed related to this date as a date. Otherwise, it is displayed as a *DHM String*.

Scenario Information

ID: 621 WT: 10621 This area displays a summary of information about the currently selected scenario. #image#

Sceneraio Start

ID: 622 WT: 10622 This displays the starting time or date related to the beginning of the scenarios. The exact display depends on whether the BaseDate is a valid date or not. #image#

Scenario Completion

ID: 623 WT: 10623 This Displays the completion time or date related to the beginning of the scenarios. The exact display depends on whether the BaseDate is a valid date or not. #image#

Scenario Duration

ID: 624 WT: 10624 This displays the duration *time* of the sceneraion as a *DHMString* image.

Division Size

ID: 625 WT: 10625 This displays the scenario's division size. For a definition of Divisions see *Time Divisions* #image#

Scenario Options

ID: 631 WT: 10631 This area is whether the actual parameteres of the current scenario are editted. #image# See Also: *Graph Generation*

Beginning

ID: 632 WT: 10632 This Parameter is an Integer from 1 to the number of timesteps and specified the exact timestep on which the scenario begins. #image# See Also: *Graph Generation*

Time Divisions

ID: 633 WT: 10633 This Parameter is an Integer from 1 to the total number of *timesteps* such that "total mod divisions = 0" is true, that is the parameter divides the total number of timesteps. A Scenario's total number of related timesteps can be equally divided into a number of Divisions, thus displaying different periods of time on the graph within the same scenerio(non-overlaping). A Division is some sub-division of simulation *timesteps* and the division size is the length of time covered by those timesteps. See Also: *Graph Generation*

Total Timesteps

ID: 634 WT: 10634 This Parameter is an Integer from 1 to the number of *timesteps* from the begining timestep to the end of the simulation. So if a simulation has 30 timesteps and this scenarios beginning timestep is 10 then the total number of timestep in the scenarion can be from 1 to 21 (30 - 10 + 1). See Also: *Graph Generation*

Graph

ID: 701 WT: - This is the graph display window(graphs can be saved). Click on parts of the interface for more information. #image#

Close

ID: 702 WT: 10702 This button simply closes the graph windows. #image#

Copy

ID: 703 WT: 10703 This button copies two pieces of information to clipboard. 1.) The Chart Data as a table 2.) The Chart Graphic Both can be pasted into other applications, even an excel spreadsheet.

To paste the Chart Data, usually the a simple Paste operating is all that is needed.

To paste the Chart Graphic, usually one has to use a Paster Special operatin from the applications Edit menu. #image#

Options

ID: 704 WT: 10704 The Options Button will bring up an *option dialog* which you can adjust the current viewing and display of the graph in various ways See Alse:*Chart Object* #image#

Chart Object

ID: 705 WT: 10705 The Chart object is the actual display area where the graph appears. The primary thing you can do in the chart object area, is rotate the graphic. #image# In order to perform this operation, first press the ctrl key on the ketboard. Then click and hold with your primary mouse button and the graph. Now you can rotate the display the graph along several axis. #image# #todo zoom doesn't initally get setup in the options dialog correctly#

Chart Options

ID: 801 WT: - This Dialog is where one can set the display and view parameter of the associated graph. There are several areas of infromation, denoted by the tabs along the top. #image#.

OK

ID: 802 WT: 10802 This closes the options dialog applying any changes made since the last *Apply* or *Ok* #image#

Cancel

ID: 803 WT: 10803 This closes the options dialog without applying any changes made since the last *Apply* or *Ok* #image#

Apply

ID: 804 WT: 10804 This applys any changes made since the last *Apply* or *Ok*

Erosion Options Tabs

ID: 805 WT: 10805 These select different areas of information, specifically:

1.) Erosion - Set the parameter of the erosion axis. 2.) View - Set the View types, like perspective. 3.) Zoom - Set the Zoom and Relative size of the graph.

#image#

Erosion Tab

ID: 811 WT: 10811 This Area of information contained options to adjust the display of the erosion axis. #image#

Auto/Manual Resize

ID: 812 WT: 10812 Thes option buttons allow the user to choose between manually specifing the parameters of the erosion axis, or letting the programming dynamically choose them based upon the range of data and the size of the graph. #image#

Minimum

ID: 813 WT: 10813 If the user has choosen to *manually* specify the parameters of the erosion graph, then this box will be enabled. Here the user can specify a floating point number that will mark the lowest value which will be shown on the erosion axis. #image#

Maximum

ID: 814 WT: 10814 If the user has choosen to *manually* specify the parameters of the erosion graph, then this box will be enabled. Here the user can specify a floating point number that will mark the highest value which will be shown on the erosion axis.

Major Ticks

ID: 815 WT: 10815 If the user has choosen to *manually* specify the parameters of the erosion graph, then this box will be enabled. Here the user can specify a positive integer to describe the number of Major tick marks which will be shown in the graph. A major tick mark is an embolded line shown at a particular erosion value on the graph's grid. A major tick mark also Shows the Marked values if room permits for the text. #images#

Minor Ticks

ID: 816 WT: 10816 If the user has choosen to *manually* specify the parameters of the erosion graph, then this box will be enabled. Here the use can specify a non-negitve integer to describe the number of Minor tick marks which will be shown between major tick marks. A minor tick mark is a line shown at erosions values on the graph's grid between major tick mark, the value described by the minor tick mark is NOT shown.

View Tab

ID: 821 WT: 10821 This Area allow the user to set parameter considering how the graph is viewed/displayed. #image#

Prespective

ID: 822 WT: 10822 This parameter has a number of options in the drop down boxes, each specifiying a different type of projection that can be applied to the graph.

#image#

1.) Frontal - Shows the Graph as a 2-dimensional projection from the front, there is no dephth. 2.) Oblique - This is a semi-3-dimensional projection, however, the xy plance never changes. 3.) Orthogonal - This a like a normal perspective, however, vertical line are kept perfectly vertical. 4.) Overhead - This is like a frontal project, except from the top 5.) Perspective - This is your normal 3d perspective project. It is the default.

Zoom Tab

ID: 831 WT: 10831 This area of infomration contains parameter about the size of zoom of this graph. #image#

Zoom

ID: 832 WT: 10832 This parameter is a positive number, these specifiy the percent of the zoom. #image#

Auto/Manual Resize

ID: 833 WT: 10833 These option buttons specify whether to allow the user to specify this size of the graph in pixels manual or to auto resize the graph with the size of the window.

Height

ID: 834 WT: 10834 This textbox is enabled if the user has specified to manually size the graph. This parameter represents a positive integer that specifies the height of the graph in number of pixels. #image#

Width

ID: 835 WT: 10834 This textbox is enabled if the user has specified to manually size the graph. This parameter repsents a positive integer that specifies the width of the graph in number of pixels.