Output Utilities and Data Visualization
RiverWare Data Format (RDF)
During a multiple run or through the output manager, output can be written to an RDF text file. This section describes the structure of the RiverWare Data Format (RDF) file.
See “RDF Viewer” in Solution Approaches for more information on quickly viewing the results of an MRM run using the RDF Viewer.
Output File Structure
The output file has the following hierarchical structure, where package refers to the set of runs.
• Package name
• Package owner (user who conducts the run)
• Object/slot combinations and units saved for the run
• Number of runs
• Description (text)
• Type (simulation, optimization, etc.)
For each run:
• Start date
• End date
• Timestep
• Duration
• Rule set
• Constraint set
• Slot set
• Consecutive set
For each object/slot combination:
• Value
• Time stamp
Results of multiple runs are the values for any object/slot combinations. Multislots, as well as series and expression slots, are stored as a time series of values. Table and scalar slots are stored as tables of values.
Results from multiple runs are written to a formatted text (ASCII) file. See “ASCII File Format” for details.
ASCII File Format
Information on the package level:
name:<package name>
owner:<package owner>
description:<multiple run description>
create_date:<yy-mm-dd hh:mm>
number_of_runs:<number of runs>
END_PACKAGE_PREAMBLE
For each run:
start:<yy-mm-dd hh:mm>
end:<yy-mm-dd hh:mm>
time_step_unit:<timestep unit>
unit_quantity:<number of units in the timestep>
time_steps:<number of timesteps>
slot_set:<input DMI (if slot-based run)>
consecutive:<no = 0, yes = 1>
idx_sequential: <no = 0, yes = 1>
END_RUN_PREAMBLE
For each timestep:
<yy-mm-dd hh:mm>
For each object/slot combination:
object_type: <object type>
object_name: <object name>
slot_name: <slot name>
If a table slot:
rows: <number of rows>
cols: <number of columns>
END_SLOT_PREAMBLE
for all rows:
<row numbers, one row number per line>
for all columns:
units: <unit>
scale: <scale>
<values, one value per line>
END_COLUMN
If not a table slot:
END_SLOT_PREAMBLE
units: <slot units>
scale: <scale>
<values, one value per line>
END_COLUMN
Two standalone tools are available to post-process RDF files. These tools can be found on the RiverWare web site. RdfToExcel will write the contents of an RDF file to an Excel workbook, and RdfAnnualizer will take an RDF file with a timestep of less than a 1 Year and aggregate its data to create an RDF file with a 1 Year timestep. Help documentation is packaged with the tools.
Revised: 11/11/2019