Report Items Reference

Output Utilities and Data Visualization : Model Report : Report Items Reference

This section provides details about the settings that apply to each type of report item.

Account Method Table

Item Type	Account Method Table
Description	Displays a table with an account’s method categories and the selected method in each category. Note: These are account level methods, not object level methods.
Setting	Type	Notes
Selection	Single Selection	The account whose methods should be displayed
Title	Single line text	The text to appear as the table title
Show Only Non-default Methods	Yes/No	If yes, only categories with a non-default method selected are included in the table.
Sample

Account Section

Item Type	Account Section
Description	Displays a section describing an account on the workspace. The title is the name of the account. Sub-sections can be added to an account section.
Setting	Type	Notes
Account Name	Single Selection	The account associated with this section.
Include Account Type	Yes/No	If Yes, the account type is included in the section title.
Show Description	Yes/No	Not applicable.
Sample

Account Table

Item Type	Account Table
Description	Presents a table with a list of accounts (often those for a single simulation object) and optional columns for several account attributes including type, water type, water owner, and priority date
Setting	Type	Notes
Selection	Multiple Selection	The accounts to include in the table
Title	Single line text	The text to appear as the table title
Include Object Name	Yes/No
Include Account Name	Yes/No
Include Water Owner	Yes/No
Include Water Type	Yes/No
Include Priority Date	Yes/No
Sample

Accounting System Settings

Item Type	Accounting System Settings
Description	Lists the information on the accounting system including range, accrual date, water types, owners, etc. This is the information shown in the Accounting, then Account System Configuration dialog.
Setting	Type	Notes
Include Account Water Owners	Yes/No	If yes, show a table of all user-defined Water Owners.
Include Account Water Types	Yes/No	If yes, show a table of all user-defined Water Types.
Include Supply Release Types	Yes/No	If yes, show a table of all user-defined supply Release Types.
Include Supply Destinations	Yes/No	If yes, show a table of all user-defined supply Destination Types.
Sample

Chart

Item Type	Chart
Description	Displays an image of an existing Chart output device. Use the configured timestep or override with an optional setting.
Setting	Type	Notes
Chart Name	Single Selection	The existing chart device to include in the report
Title	Single line text	The text to appear above the chart.
Date/Time	Date/Time	The timestep to be used for series data within the chart. If left blank, the timestep defined on the chart is used. If specified, that date is used. See Date/Time Specification for additional information.
Chart Width (pixels)	Integer	The width of the chart in pixels. The default is 500.
Chart Height (pixels)	Integer	The height of the chart in pixels. The default is 500.
Sample

Image

Item Type	Image
Description	Shows an Image imported from a file. An optional caption setting is provided.
Setting	Type	Notes
Image Name	Single-line text	The image name is used only to identify the image within the Report Layout tree. It is initially taken from the imported image’s file name.
Caption	Multi-line text	A string of text to appear below the image. For more information on images, see the text below the table.

When you add an Image to the layout, a file selector is opened which allows you to select an image file.

After picking an image file, a new Image item is created. Optional Caption text can be specified with each image item. In the generated model report, caption text is shown under the image. For sufficiently wide images (at least 300 pixels wide), the caption is horizontally centered below the image and wrapped to the image width. Captions for narrower images are not constrained in this way; they appear under the image, left aligned, and flowing to the full display width of the generated model report page. It is not currently possible to select a different image for an existing image item. If a different image is desired, a new image item must be created. (You may wish to retain the old image item during the creation of the new image item so that the old image caption text can be copied and pasted to the new image item).

For imported images, the Image data is stored in the model file in the model report output device configuration. Including many large images in a model report configuration could potentially increase the size of the model file significantly and could result in slower model file loading.

Link Table

Item Type	Link Table
Description	Presents a table of the physical links to slots on the specified object, optionally limited to links to the slots on a second specified object.
Setting	Type	Notes
Title	Single line text	The text to appear as the table title
Object Name 1	Object Selection
Object Name 2	Object Selection	If specified, only the links between slots on Object 1 and Object 2. If not specified, any links from slots on Object 1 will be shown.
Sample

Method Table

Item Type	Method Table
Description	Displays a table of the method categories and the selected method in each category. When accounting is enabled, this table includes Object Level Accounting Methods.
Setting	Type	Notes
Object Name	Single Selection
Title	Single line text	If present, will appear as the title of the table.
Show Only Non-default Methods	Yes/No
Sample

Model Information

Item Type	Model Information
Description	Lists the information contained in the Model Info dialog (accessed from the workspace using File, then Model Info), including the model’s save history and the specified comments.
Setting	Type	Notes
Include File Save History	Yes/No
Include File Comment	Yes/No
Sample

Object Section

Item Type	Object Section
Description	Creates a section for a workspace object, whose title is the name of that object and whose contents are controlled by the items in the section.
Setting	Type	Notes
Object Name	Single Selection
Include Object Type	Yes/No
Show Description	Yes/No	Optionally include the description shown on the Description tab in the Open Object dialog.
Sample

Output Canvas

Item Type	Output Canvas
Description	Displays an image of an existing Output Canvas device. Use the configured timestep or override with an optional setting. See Output Canvas for additional information.
Setting	Type	Notes
Output Canvas Name	Single Selection	The existing Output Canvas device to include in the report
Title	Single line text	The text to appear above the canvas image.
Date/Time	Date/Time	The timestep to be used for series data within the output canvas. If left blank, the timestep defined on the canvas is used. If specified, that date is used. See Date/Time Specification for additional information.
Max Width (pixels)	Integer	The maximum width of the canvas in pixels. The default is 10000. The image is the natural size or smaller and the aspect ratio from the original canvas is maintained.
Max Height (pixels)	Integer	The maximum height of the canvas in pixels. The default is 10000. The image is the natural size or smaller and the aspect ratio from the original canvas is maintained.
Sample

Periodic Slot Table

Item Type	Periodic Slot Table
Description	Shows a table where the rows represent the time intervals of a periodic slot and the columns represent the columns in one or more periodic slots. These are used to display periodic slots that have only one column. Note: An error is generated if periodic slots having different overall periods are included. However, different time interval configurations can be represented within a single Periodic Slot Table. This includes mixes of regular interval and irregular interval configurations, and different specific interval start times.
Setting	Type	Notes
Title	Single line text	If present, will appear as the title of the table.
Column Slots	Sortable Slot Selection	See Lists of Items for details on selecting lists of items,
Sample

Plot Page

Item Type	Plot Page
Description	Displays an image of an existing plot page output device. Use the Plot Page’s timesteps or override with an optional setting.
Setting	Type	Notes
Plot Page Name	Single Selection
Title	Single line text	If present, will appear as the title of the plot page.
Width (pixels)	Integer
Height (pixels)	Integer
Start Date	Date/Time	Specify the date/times to use in the report, if desired. This will override the Plot Page dates when specified. See Date/Time Specification for details.
End Date	Date/Time
Sample

RPL Group

Item Type	RPL Group
Description	Displays a section for a single policy or utility group in a RPL set.
Setting	Type	Notes
Set	Single Selection	These items might generate output for a RPL Report Group, and that group might include references to workspace objects, slots, or subbasins, so these items include format settings that apply to slots, objects, and subbasins. For example, each includes the “Slot: Include Object Name” setting which is used when generating output for a RPL Report Group containing a slot. See Blocks and Groups in RiverWare Policy Language (RPL) for details on groups. See RPL Printing and Formatting in RiverWare Policy Language (RPL) for details on the RPL selector.
Group	Single Selection
Show Execution Properties	Yes/No	Show the index or priority range of the group (where applicable) and whether the group is enabled or disabled.
Show Descriptions	Yes/No	Include the Descriptions entered on each RPL Editor dialog. See Descriptions in RiverWare Policy Language (RPL) for details.
Show Notes	Yes/No	Include the Notes entered on each RPL Editor dialog. See Notes in RiverWare Policy Language (RPL) for details.
Show RPL Comments	Yes/No	Include Comments that are inline in the RPL Expression. See Comments in RiverWare Policy Language (RPL) for details.
List Rules in Order of Execution	Yes/No	For Policy Groups in RBS Rulesets, Initialization Rules Sets, and Iterative MRM Rules Sets, when set to Yes, the rules are displayed based on the Agenda Order. (See Show Advanced Properties in RiverWare Policy Language (RPL) for details on the Agenda Order.) When set to No, rules are displayed in the order they are shown in the RPL Set Editor. For Report Groups, Optimization Goal Sets, Accounting Methods and functions, this setting has no effect. These items are always displayed in the same order as in the RPL Set Editor.
Sample

RPL Rule/Goal

Item Type	RPL Rule/Goal
Description	Displays a section for a single RPL item (Rule/Goal/Accounting Method/Init Rule).
Setting	Type	Notes
Set	Single Selection
Rule / Goal / Method / Init Rule	Single Selection	The Setting name depends on the type of set selected.
Show Execution Properties	Yes/No	Show the index, priority, and flag where applicable and whether the item is enabled or disabled.
Show Description	Yes/No	Include the Descriptions entered on each RPL Editor dialog. See Descriptions in RiverWare Policy Language (RPL) for details.
Show Notes	Yes/No	Include the Notes entered on each RPL Editor dialog. See Notes in RiverWare Policy Language (RPL) for details.
Show RPL Comments	Yes/No	Include Comments that are inline in the RPL Expression. See Comments in RiverWare Policy Language (RPL) for details.
Sample

RPL Set

Item Type	RPL Set
Description	Displays a section for each policy and utility group in a RPL set.
Setting	Type	Notes
Set	Single Selection	These items might generate output for a RPL Report Group, and that group might include references to workspace objects, slots, or subbasins, so these items include format settings that apply to slots, objects, and subbasins. For example, each includes the “Slot: Include Object Name” setting which is used when generating output for a RPL Report Group containing a slot. See Blocks and Groups in RiverWare Policy Language (RPL) for details on groups. See RPL Printing and Formatting in RiverWare Policy Language (RPL) for details on the RPL selector.
Show Policy Groups	Yes/No
Show Utility Groups	Yes/No
Show Global Groups	Yes/No
Show Execution Properties	Yes/No	For each item in the set, show the index, priority, and flag where applicable and whether the item is enabled or disabled.
Show Descriptions	Yes/No	Include the Descriptions entered on each RPL Editor dialog. See Descriptions in RiverWare Policy Language (RPL) for details.
Show Notes	Yes/No	Include the Notes entered on each RPL Editor dialog. See Notes in RiverWare Policy Language (RPL) for details.
Show RPL Comments	Yes/No	Include Comments that are inline in the RPL Expression. See Comments in RiverWare Policy Language (RPL) for details.
List Rules in Order of Execution	Yes/No	For RBS Rulesets, Initialization Rules Sets, and Iterative MRM Rules Sets, when set to Yes, the rules are displayed based on the Agenda Order. (See Show Advanced Properties in RiverWare Policy Language (RPL) for details on the Agenda Order.) When set to No, rules are displayed in the order they are shown in the RPL Set Editor. For Report Groups, Optimization Goal Sets, Accounting Methods and functions, this setting has no effect. These items are always displayed in the same order as in the RPL Set Editor.

RPL Statement

Item Type	RPL Statement
Description	Shows a single top-level RPL Statement within a RPL Block (a Rule, Goal, User-Defined Accounting Method or Initialization Rule).
Setting	Type	Notes
Set	Single Selection
Rule / Goal / Method / Init Rule	Single Selection	The Setting name depends on the type of set selected.
Statement	Single Selection	The RPL Statement within the selected RPL Block. Statement items are presented in a menu in the form of the statement number (1) and the Statement name. Note: The default statement name is the statement type (Assignment, Print, etc.). You can rename statements as follows. From the main RPL Set editor, Select View, then Show Statements. Locate the desired statement in the tree-view. Right-click the statement and select Rename. Enter a new name.
Title	Text	Optional title text placed above the RPL Statement. The line editor includes a Set to Rule and Statement Name button, which recomputes the title from the RPL Block and Statement names.
Show RPL Comments	Yes/No	Include comments that are inline in the RPL Expression.
Sample

Run Control

Item Type	Run Control
Description	Shows the information contained in the single run control dialog, including the controller, start and end dates, and timestep size.
Setting	Type	Notes
N/A
Sample

Run History

Item Type	Run History
Description	Shows status information about the last run.
Setting	Type	Notes
Include RiverWare Version	Yes/No	Show the RiverWare version used for the last run.
Include User	Yes/No	Show the user name for the user that made for the last run.
Include Controller	Yes/No	Show the RiverWare controller used for the last run.
Include Run Start Time	Yes/No	Display the time at which the last run was started.
Include Run Duration	Yes/No	Display the duration of the last run.
Include Run Status	Yes/No	Show the status of the last run including Finished, Aborted, Stopped, etc.
Sample

Scalar Slot Grid

Item Type	Scalar Slot Grid
Description	Presents a table showing a grid of scalar slot values. The rows of the table represent objects while the columns represent one or more named scalar slots.
Setting	Type	Notes
Title	Single line text	If present, will appear as the title of the table.
Row Objects	Sortable Object List	See Lists of Items for details on selecting lists of items.
Column Slots	Slot Name List	See Lists of Items for details on selecting lists of items.
Sample

Section

Item Type	Section
Description	Presents a titled section whose contents are controlled by the items in the section.
Setting	Type	Notes
Title	Single line text	The text used as the section name.
Sample

Slot

Item Type	Slot
Description	Shows a slot’s name, description, and values. For, table, periodic and scalar slots, the values are shown. For series slots, a plot of the time series is shown. For Expression Slots, the RPL expression is shown along with a plot (series) or value (scalar)
Setting	Type	Notes
Slot Name	Single Selection
Include Object Name	Yes/No
Include Account Name	Yes/No
Include Slot Type	Yes/No
Maximum Columns Per Table	Integer	If positive, values may be displayed in multiple tables as needed.
Plot Width (pixels)	Integer	Applies to SeriesSlots whose values are plotted.
Plot Height (pixels)	Integer	Applies to SeriesSlots whose values are plotted.
Add PE/Storage Column	Yes/No	For certain table slots like the reservoir’s Elevation Area Table, a column of storage values corresponding to the elevations (using the Elevation Volume Table) are shown. Select No to not show this Storage column.
Start Date	Date/Time	Specify the date/times to use in the plot of series data, if desired. This will override the default dates when specified. See Date/Time Specification for details.
End Date	Date/Time
Show Description	Yes/No	Include the description entered on the Open Slot dialog.
Show RPL Comments	Yes/No	For Expression Slots, show the RPL inline comments.
Samples

Slot Value Table

Item Type	Slot Value Table
Description	Presents a table showing the name and a single value for one or more selected slots. Each row of the table is a slot. Columns include the Slot, Object (optional), Account (optional), Value, and Units.
Setting	Type	Notes
Selection	Multiple Selection
Title	Single line text	If present, will appear as the title of the table.
Include Object Name	Yes/No
Include Account Name	Yes/No
Sample

Subbasin

Item Type	Subbasin
Description	Shows a table of the members of a subbasin.
Setting	Type	Notes
Subbasin	Single Selection
Sample

Supply Table

Item Type	Supply Table
Description	Presents a table of supplies and optional columns for supply attributes including type, release type, and destination.
Setting	Type	Notes
Selection	Multiple Selection	The Supplies to include in the table
Title	Single line text	The text to appear as the table title
Include Supply Type	Yes/No	Show whether the supply is an Inflow/Outflow, Diversion/Return Flow, or Transfer supply
Include Release Type	Yes/No
Include Destination	Yes/No
Sample

Table of Contents

Item Type	Table of Contents
Description	Lists the sections in the report, with hyperlinks to their locations.
Setting	Type	Notes
Title	Single line text
Sample

Tabular Series Slot Report

Item Type	Tabular Series Slot Report
Description	Displays an existing Tabular Series Slot Report output device in either HTML or text format. The title defined within the Tabular Series Slot Report is extracted from the report and presented as a report item title text within the generated Model Report. Use the configured timesteps or override with an optional setting.
Setting	Type	Notes
Tabular Series Slot Report Name	Single Selection	The existing tabular series slot report device to include in the report
Tabular Series Slot Report Format	HTML/Text	Tabular Series Slot Reports can be generated as an HTML table or as a Text table.
Start Date	Date/Time	Specify the date/times to use in the report, if desired. This will override the Tabular Series Slot Report dates. See Date/Time Specification for details.
End Date	Date/Time
Sample

Text

Item Type	Text
Description	Prints user defined text. The text can be Plain Text or Rich Text which allows formatting.
Setting	Type	Notes
Text	Multi-line text	Select More to edit the text in a dialog.
Type	Rich or Plain	Specify whether the text is Plain Text (non-formatted letters and numbers) or Rich Text (formatted with fonts, colors, size, bullets etc). See Text Considerations for details on Rich Text.

Revised: 07/09/2023