Page History

Contents

...

The forecast product information panel allows the user to create, edit and view product information associated with forecast time series. When the user views a forecast time series (simulated or external) in a Spatial Display or Time Series Dialog which has a product associated with it, the product information panel will show all product information added to the forecast being viewed. If the viewed product was created in a forecast which used other products as input, the product information panel will show this through its comment from user "System". In this case, the product information for the input products will be shown as well. The user can also turn this "automatic filtering" on product information associated with the viewed time series off, after which the forecast product information panel will show all forecast product information present in the system.

Image Modified

Concepts

What is a Product?

...

For example, a system could import an external weather forecast consisting of a precipitation and a temperature time series. Both of these series are linked to the product "NWP Medium Range". They are imported every six hours and the most recent forecast has a forecast time of "Tue 28-5-2019 00:00:00". The system then produces water level forecasts for several locations through a simulated forecast using the (most recent) precipitation time series as input. All of the water level time series are linked to a product called "HPC G2G Medium Range". While running the forecast, FEWS will record that an input product was used: "NWP Medium Range - Tue 28-5-2019 00:00:00" and store this information in the database. Now if a user views the water level time series for a certain location, the forecast product information panel will show the product information for product "HPC G2G Medium Range" relevant for the forecast time of the time series being viewed. It will also show a comment from the "System" for the "HPC G2G Medium Range" stating: "Created using NWP Medium Range - Tue 28-5-2019 00:00:00". Finally, the panel will also show all product information for "NWP Medium Range" relevant for the forecast time of "Tue 28-5-2019 00:00:00". 

Image Modified

Motivation

Why add a Forecast Product Information Panel?

...

In the forecaster notes system, users can acknowledge messages with level ERROR and FATAL from other users. Thus showing that they read and/or handled the note made by the other user. There is no similar functionality present in the forecast product information panel. Note that messages with level INFO and WARN do not have to be acknowledged.

Showing information on input used

...

	<workflowDescriptor id="Water_Level_Forecast" name="Water Level Forecast" visible="true" forecast="true" allowApprove="false"/>

To have comments be shown in the grid display, make sure that a <commentPositioning> element is configured in the default of the griddisplay.xml

forecastProductInfoDisplay.xml 

Since version 2022.01 a specific display config file has been introduced in order to define default settings for the product info panel.

<?xml version="1.0" encoding="UTF-8"?>
<forecastProductInfoDisplay xmlns="http://www.wldelft.nl/fews" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.wldelft.nl/fews http://fews.wldelft.nl/schemas/version1.0/forecastProductInfoDisplay.xsd">
	<productSelection enabled="true"/>
	<forecastTime>
		<defaultForecastTimeSelection>RANGE</defaultForecastTimeSelection>
		<defaultForecastPeriod unit="day" multiplier="10"/>
	</forecastTime>
	<confidence enabled="false">
		<defaultLevel>MEDIUM</defaultLevel>
	</confidence>
	<classification enabled="false"/>
	<columns>		
		<classification visibleByDefault="false"/>
	</columns>
</forecastProductInfoDisplay>

columns visibility

This applies to the visibility of columns, each column can be made invisible by default.

This will be overruled if the user changes the column visibility via the right mouse show/hide columns option also introduced in 2022.01.

Image Added

Image Added

These settings will be stored in the user settings, which will overrule the defaults from the config.

default settings for creating product info

in the config it is also possible to disable elements from the product creation panel, like is done with Confidence and Classification in the example below.

It is also possible to specify a default range for the forecast time, which in this case is 10 days:

Image Added 

Using the Forecast Product Information

What information is shown when?

• when viewing product in spatial display / TSD
• when viewing product that had input products
• when viewing several products in a dashboard
• when filter button is deactivated
• when using manual filtering (double-click)

Creating Forecast Product Information

Table columns

...

By default, the automatic filtering button is turned on and the Forecast Product Information Panel will show the product information relevant to the time series currently being viewed in the Spatial Display or Time Series Display. The title of the Forecast Product Information Panel will indicate which display it is using to determine the relevant product information.

Image Added

Image Added

The Forecast Product Information Panel's automatic filtering can also listen to a Dashboard Display. In this case it will show all product information relevant for the time series shown in the Spatial Displays that are part of the dashboard. If several dashboard frames contain different products, this can result in product information being shown on several products.

Image Added

As mentioned in the section about Input Products, if one of the time series currently being shown used an input product when it was created, the Forecast Product Information Panel will also show product information about this input product.

Image Added

When the automatic filtering button is turned off, the Forecast Product Information Panel will display all product information present in the system.

Image Added

It is possible to filter the information in the table by double-clicking a cell. Cells on which a filter is active are indicated by a light-blue background. Double-clicking the cell again will remove the filter.

Image Added

Creating or Editing Forecast Product Information

New product information can be added using the Image Added button. When clicked, the forecast product information creation dialog is shown:

Image Added

The top part of this dialog can be used to select the forecast product the information should apply to. This includes a drop down selection of the currently visible products and an option to select the forecast times for which the information should be valid. It is possible to specify product information for a particular forecast time, or for a range of forecast times. The bottom part of the dialog contains the options to specify the product information. The user can choose a confidence and classification they would like to attach to their comment, and type a comment in the provided text box. When the OK button is clicked, the forecast product information will be created.

Created forecast product information can be edited by selecting the product information you wish to edit in the table and then using the edit button Image Added. The same dialog is shown for edits however the options to select to which product the information applies will be disabled:

Image Added

Forecast product information can also be deleted. To do so, select the product information you wish to delete in the table and press the delete button Image Added.

It is only possible to create, edit or delete product information for products that are currently being viewed through a Spatial Display, Time Series Display or Dashboard Display, even if the automatic filtering is turned off.

Table columns

The table in the Forecast Product Information Panel contains the following columns:

• Name: the name of the product this information applies to.
• Forecast Time: the forecast time or range of forecast times this information applies to.
• Product Time: the time at which the product time series was added to the database. This is only available when automatic filtering is on, since without automatic filtering a product information could apply to several time series which were created at different times.
• User: the user that created or edited the product information, or "System" if it is a system comment.
• Modification Time: the time at which the product information was created or last edited.
• Confidence: the confidence level set by the user when creating or editing the product information.
• Comment: the comment entered by the user when creating or editing the product information.
• Classification: the classification level set by the user when creating or editing the product information.

Disapproving External Forecasts

An external forecasts product for a single external forecast time can be disapproved by ticking the check box in the "Disapproved" column. This check box is only available for the system product (non comment) rows that represent an external forecast. When you disapprove an external forecast all the time series related to this product for the a single external forecast time will no longer be visible in displays and no longer used by any workflow run executed after the disapproving. It is possible to undo the disapproving to enable the forecast again. You need the configured editPermission for the product to disapprove a forecast. Additionally product info rows for disapproved forecasts between the used external forecast time and the system time are added to the panel. The event codes codes "ExternalForecast.Disapproved" and "ExternalForecast.Approved" are used in the log message on (dis)approving. The log message contains the user name, forecast time and product id.

Image Added

Showing Forecast Product Information in the Time Series Dialog

The forecast product information applicable to the time series shown can be included in the graph in the Time Series display. If one or more rows in the product info table are selected, only the product information of the selected rows will be shown. Similarly, if the table is filtered only the product information of the visible rows will be shown in the graph. Finally, the shown comments will appear in the same order as the product information appears in the table, so the order can be changed by sorting the table.

Image Addedalso include it will follow sorting, filtering and selection of info in panel

Showing Forecast Product Information in the Spatial Display

The forecast product information applicable to the time series shown can be included on the map in the Spatial Display. If one or more rows in the product info table are selected, only the product information of the selected rows will be shown. Similarly, if the table is filtered only the product information of the visible rows will be shown on the map. Finally, the shown comments will appear in the same order as the product information appears in the table, so the order can be changed by sorting the table.

Image Addedalso include it will follow sorting, filtering and selection of info in panel

Exporting Forecast Product Information through the PI REST Web Service

...