Plotting and Snapshots
New functionality exists for saving and combining plots of output values from several different slots and runs. The Snapshot Management dialog is used to create and review snapshots of selected slot values over multiple runs.The Plotter Management dialog is used to create composite plots for display or printing.
The Snapshot Management Dialog
The Snapshot Management dialog is invoked by selecting Utilities Snapshot Management.... It allows snapshots of selected slot values to be taken after different runs. This tool is useful for saving the values to compare the effects of various operating strategies or reproduce a particular run.
Slots to be included in a snapshot are selected by clicking on the Add Data... button, which invokes a Slot Selector dialog. Newly selected slots are added to any existing slots in the Data Available: window. These selections may be cut, copied, pasted, and cleared through the Data menu. Slot selections may also be copied between the Snapshot Management and the Plotter Management dialogs. This greatly facilitates configuration of plots and preparation of snapshots for preconfigured plots.
Snapshots of the selected slots’ current values are taken by clicking on the Take Snapshot button. Each time a snapshot is taken, the Snapshot Manager creates a new Snapshot Data Object to contain its data. The new object is added to the bottom right of the workspace, and its name appears in the Snapshots Taken: window. Snapshot Objects are initialized with the name Snapshotn, where n is the smallest number, beginning with 0000, which makes the object name unique. The selected slots are copied into the Snapshot Object, retaining their unit and display configurations. These slots are initialized with the name of the object and the name of the slot from which they were copied, separated by an underscore. For example, a snapshot of the Inflow slot on the Big River Reach appears as “Big River_Inflow.” While snapshot slot names may not be changed, Snapshot Object names may be changed by entering a new name in their Name: field.
Selecting a selected slot name in the Data Available: window highlights any snapshot objects in the Snapshots Taken: window, which contain a snapshot of that slot. Double-clicking on a Snapshot Object name in the Snapshots Taken: window automatically brings up that Snapshot Object. Double-clicking on a selected slot name in the Data Available: window brings up that object and the slot’s current model values.
The Plotter Management Dialog
The Plotter Management dialog is invoked by selecting Utilities Plotting Management....
The Plotter Manager maintains a list of all existing Plot Pages, which may be created, opened, deleted and refreshed from this dialog. To create a new Plot Page, select Plot Page New..., or select the New... button. To open an existing Plot Page, highlight it and select Plot Page Open... or select the Open... button.
The Plotter dialog is used to select the number and orientation of graphs to be displayed on one page, as well as what slot data will appear in each individual graph. Plot Pages are initialized with the name Plottern, where n is the smallest number, beginning with 00000, which makes the Plot Page name unique.The plotter name is changed by typing into the Plot Page: field. The number and layout of graphs is selected through the Graph Layout: selector bar. Up to nine graphs may be generated on a single page, with graph layout referenced according to row-column notation. For example, a 2 x 1 layout consists of two rows with one graph per row. The layout is represented graphically in the Select Graph: region.
Individual graphs are selected by clicking on their icon in the Select Graph: region. Graphs which contain at least one set of data, display a data line in their icon, and the names of the included slots appear in the Slots to Graph: window. Empty graphs display only axis lines in their icon and <no data exists> in the Slots to Graph: window. To add data to a selected graph, select Data Select Slots... or select the Select Slots... button. This invokes a standard RiverWare Slot Selector with which to chose the slots to display. Newly selected slots are added to any existing slots in the Slots to Graph: window.
A graph may show current values of selected slots only, or current and previous values of selected slots for which a snapshot(s) exists. This is determined by the For Selected Graph, Show: toggle. Selected slots of which a snapshot image exists are indicated by a blue snapshot icon to the left of their name. Selected slots which are selected in the Snapshot Management’s Data Available: list but are not part of a snapshot, are indicated by a grey snapshot icon to the left of their name. Clicking on a selected slot name in the Slots to Graph: window highlights any snapshots in the Snapshots of Slots to Graph: window which contain an image of that slot.
The XMgr session which displays the Plot Page may be invoked by clicking on the Show Plotter Page button. Once the XMgr window appears, it must be populated with the selected data by clicking on the Refresh All Graphs button. If new snapshots are taken, or the data in the Plot Page is changed, the existing Plot Page may be updated by re-clicking on the Refresh All Graphs button.
Note: The modified XMgr executable which displays plots is named pxmgr. In order for RiverWare to locate this executable, it must reside in a directory which is part of the user’s default search PATH or be set as a full path and name in the XMGR_PATH environment variable. To set this environment variable, type:
% setenv XMGR_PATH /yourRiverWareDirectoryPath/pxmgr