Contents
RPL Predefined Function Help content in RiverWare 6.7 / March 2015
Phil Weinstein, David Neumann, Patrick Lynn, Edie Zagona, CADSWES
Edit: 3-16-2015, Phil,
ready for review.
Overview
RiverWare 6.7 displays RPL Predefined Function Online Help Content -- as HTML in a QWebView -- in the following three dialogs:
Prior to this enhancement, panels and dialogs which normally show a user-provided description for a RPL Function, in the case of RPL Predefined Functions, showed either a blank panel or the message, "See Online Help for documentation of predefined functions". ( See the accompanying image ).
These panels now show an HTML version of online documentation for the particular RPL Predefined Function.
Also, a Description panel was added to the RPL Palette's "Predefined Function Tab", similar to, and controlled in parallel with the visibility of the "Description" panel on the "User-Defined Functions" tab.
The Function HTML help content -- for all, approx. 200 RPL Predefined Functions -- is bound to the RiverWare executable as a Qt Resource. (A compressed copy of the full HTML page -- without images -- is part of the RiverWare executable). Referenced images are loaded at run time by RiverWare's integrated QWebKit browser.
The following document describes the technical process of integrating this help content into the RiverWare build:
The RPL Predefined Function Help viewer panel
The new help content is displayed in a new Qt4 QWebKit-based integrated web browser deployed as a panels where a RPL Predefined Function "context" is available. The HTML content has a "responsive" layout, displaying well regardless of the available width for the panel.
Math formulas are currently implemented as images (JPEG), and are not currently scalable. Care was taken to insure that those images don't impose a minimum width on the containing table. If the available width does not accommodate the image width, then the image extends beyond the right side of the content. The obscured part of such images can be seen either by horizontal scrolling or enlarging the width of the containing dialog's window.
In this initial implementation, hyper-links within the displayed content are not operational. (Where we were able to do so with our automated publishing process, associated link text -- e.g. "Click Here" -- has also been removed).
|
The initial implementation of the viewer panel supports these two context menu operations:
The "Copy" operation copies the selected text, as just plain text (not HTML). If a PDF printer driver is installed on the system, a RPL Predefined Function's help content can be printed to a PDF file. The screenshot to the right shows such a PDF as viewed in Adobe Reader. |
Predefined Function Editor dialog
The Predefined Function "Editor" dialog now displays the help content for the particular function.
As mentioned above, this is in place of the message which used to be displayed (before RiverWare 6.7) ... "See Online Help for documentation of predefined functions".
RPL Palette
With this enhancement, both the User-Defined Functions and the Predefined Functions tabs in the RPL Palette optionally show a "Description" panel. As before, this panel on the User-Defined Functions tab shows an editable, user-provided function description. The panel on the Predefined Functions tab shows the corresponding help content.
The Description panels on those two tabs are shown using the single "Show Descriptions" checkbox under the "Function Menu" ( see below ).
When the description panel is shown, navigating through the Predefined Functions list with the up and down arrows instantly and rapidly displays the newly selection function's help content in the Description panel.
RPL Set Editor
RPL Predefined Function Groups can optionally be included in the tree of RPL Groups and their contained RPL block items. (See the first accompanying screenshot).
When "Predefined Groups" and the optional Selected Description panel are shown -- and when a RPL Predefined Function is selected, the associated help content is displayed in the Selected Description panel.
As with the RPL Palette (see above), navigating through the Predefined Functions list with the up and down arrows instantly and rapidly displays the newly selection function's help content in the description panel.
--- (end) ---
Documentation of the RiverWare rules in the URGWOM ruleset version 6.0 (2013) was prepared to serve as a reference for URGWOM users. This report provides summaries of key aspects of the policy coded in URGWOM including the impact of San Juan water on operations in the basin, stipulations for flood control operations, Compact calculations, diversions to acequias, MRGCD, Albuquerque, six pueblos, releases to meet downstream target flows, and recreational interests. The priorities at each dam along the Rio Chama and Rio Grande are summarized. Aspects of RiverWare that are used abundantly in the ruleset and that are important to understanding the policy as coded in URGWOM are discussed. Discussions for each individual rule and an overall flowchart of policy for the ruleset are included in the Appendix to serve as a reference for URGWOM users. This report could also be used to complete an initial review of the policy as coded in URGWOM.
Boroughs, Craig. 2013. User Manual for the Upper Rio Grande Water Operations Model (URGWOM). Report to the URGWOM Technical Team. Albuquerque, New Mexico.
States of New Mexico, Colorado, and Texas. 1938. Rio Grande Compact.
Upper Colorado River Compact. 1948. States of New Mexico, Colorado, Utah, Arizona, and Wyoming.
URGWOM RiverWare Ruleset version 6.0. 2013. URGWOM Technical Team
U.S. Army Corps of Engineers (Corps). 2009. Final Environmental Assessment and Finding of No Significant Impact for a Temporary Deviation in the Operation of Cochiti Lake and Jemez Canyon Dam, Sandoval County, New Mexico.
U.S. Fish and Wildlife Service (Service). 2003. Biological and Conference Opinions on the Effects of Actions Associated With the Programmatic Biological Assessment of Bureau of Reclamation’s Water and River Maintenance Operations, Army Corps of Engineers’ Flood Control Operation, and Non-Federal Actions on the Middle Rio Grande, New Mexico. Albuquerque, New Mexico.