RiverWare SCT support for TVA Preschedule Editor Functionality

RiverWare SCT support for TVA Preschedule Editor Functionality
Phil Weinstein, CADSWES, 6-13-2014; Revised 6-30-2014.
Note: This proposal has not yet been reviewed.

This brief document outlines a possible approach for enhancing the RiverWare SCT (beyond RiverWare 6.5) to support the primary features of the TVA Preschedule Editor.

Below is a screenshot of that TVA application:

http://cadswes2.colorado.edu/~philw/2014/TVA/FEWS/PreschedEditor.png

Below is a mocked up version of the RiverWare 6.5 SCT (with the bottom 6 rows photoshop'ed in). The numeric values are dummies.

http://cadswes2.colorado.edu/~philw/2014/TVA/FEWS/SctMockup2.png

The addition of a "Draw 6-Hour Divider Columns/Rows" configuration option will be implemented. This will share the color configuration of the existing 4-Hour time dividers. Within each axis orientation (time horizontal and time vertical), either 4-Hour or 6-Hour time dividers can be active (not both). [DONE].

I propose that the custom summary rows/columns be edited in a GUI widget-based editor of the same flavor as this SCT support dialog:

Controls of the new "Custom Summary Row/Column Configuration Dialog" supports these types of Custom Summary Row/Column item:

Computed Summary: Sum, Average, Minimum or Maximum.
Difference of the two prior rows.
Simulation Object Slot Reference. This resolves to either a scalar slot or a series slot having a timestep size of the timestep aggregation. (In this example, this would be a daily timestep). The slot reference is composed from these pieces:
- The name of the Simulation Object of the column's (or row's) series slot.
- An optional name suffix to allow a DataObj associated with the Simulation Object to be used.
- The name of a slot.

A divider of a selectable color can be placed before each custom summary row (or column) and after the final summary row (or column). Simulation Object Slot references can be editable or non-editable ("read-only"). But of course, references to RPL expression slots cannot be made editable.

The six (6) Custom Summary Row/Columns in the "Prescheduled Editor" example might be configured like this:

	Divider	Label	Custom Row Type	Obj Suffix*	Slot Name	Editable
1	BLUE	Total	Computed / Sum			---
2	none	FS Tot	Slot Reference	" Con"	FsTotal	[off]
3	none	Diff	Difference			---
4	GREEN	MEL	Slot Reference	" Con"	Max Efficient Load	[off]
5	none	MSL	Slot Reference	" Con"	Max Sustainable Load	[off]
6	GREEN	FN	Slot Reference	" Con"	Eff En	[on]
	RED

*Use double-quotes if the suffix contains space characters.

The SCT doesn't currently support 6-hour dividers (for hourly timesteps). The SCT mockup above shows 4-hour dividers. A 6-hour divider option will be added. But these two options (4-hour and 6-hour dividers) will be mutually exclusive; turning one on will force the other one off. Also, they will share the same color configuration. [DONE]. The following screenshot shows the current SCT time divider support:

Not addressed above are these features:

Association of Plot Pages with Simulation Objects, accessible from the SCT.
Flagging cells with data qualifiers.

--- (end) ---