Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Below the display of a constant value modifier is shown. Which is very similar to the display of single value modifier.
Note however that this modifier has a start and an end time. The constant value of the modifier can be specified in the
text box or with the slider. The period can be defined by using the start and end date boxes.


Image RemovedImage Added

Configuration example

Code Block
languagexml
<constantValueModifier id="mfc" name="mfc">
		<timeSeries>
			<parameterId>MFC</parameterId>
		</timeSeries>
		<softLimits>
			<maximumValue>3</maximumValue>
			<minimumValue>0</minimumValue>
		</softLimits>
		<hardLimits>
			<maximumValue>10</maximumValue>
			<minimumValue>0</minimumValue>
		</hardLimits>
		<sliderTicksStepSize>1</sliderTicksStepSize>
		<spinnerStepSize>1</spinnerStepSize>
		<defaultStartTime>start run</defaultStartTime>
		<defaultEndTime>end run</defaultEndTime>
		<defaultValue>1</defaultValue>
	</constantValueModifier>

 

...

The values entered in the text box or the slider are bounded by the hard limits defined.

sliderTicksStepSize

The step size of the the ticks in the slider.

spinnerStepSize

The step size by which the value in the spinner box increases or decreases by each click on the spinner.

defaultstarttime

The default start time of the modifier can be defined here. It corresponds to the same fields in the modifier display. This is only a default value, which can be changed by the user.

...

Enumeration modifiers are modifiers in which the user can select an option from a dropdown-list. Each available option in the drop-down list is represented by a value.

This value is applied by the modifier is applied to an a period
of time.

An example of the use of the eneration modifier is the rain snow modifier from the NWS. In this modifier the forecaster can determine
the precipitation in the snow17-model. Only two options are available rain and snow. If the forecaster chooses option rain than
a value of 1 is set into the timeseries, if an option snow is chosen than the value 2 is set into the timeseries at the specified time.
The modifier is applied to an empty time series and used an input to the model. The model knows that if value 1 is set into the
timeseries that the user has chosen option rain and that if value is 2 that option snow was chosen.

...

Below an example of the display for an enumeration modifier.


Image RemovedImage Added

SchemaConfiguration example Image Removed

Code Block

timeseries

The user can define a timeseries filter in this tag.

descriptionEnumeration

Define the text value in the display which is shown before the dropdown list

enumeration

Define the list of options available in the dropdownlist and its associated value which will be placed into
the time series.

defaultstarttime

The default start time of the modifier can be defined here. It corresponds to the same fields in the modifier display. This is only a default value, which can be changed by the user.

Possible options are:

startrun

time zero

defaultendtime

The default end time of the modifier can be defined here. It corresponds to the same fields in the modifier display. This is only a default value, which can be changed by the user.

Possible options are:

time zero

end run

Configuration example

Below is an example of the configuration of an enumeration modifier.

...

languagexml
<enumerationModifier id="rainsnow" name="rainsnow">
		<timeSeries>
			<parameterId>RAINSNOW</parameterId>
		</timeSeries>
		<descriptionEnumeration>choose precipitation:</descriptionEnumeration>
		<enumeration>
			<item text="rain" value="1"/>
			<item text="snow" value="2"/>
		</enumeration>
		<defaultStartTime>start run</defaultStartTime>
		<defaultEndTime>end run</defaultEndTime>
</enumerationModifier>

...



timeseries

The user can define a timeseries filter in this tag.

descriptionEnumeration

Define the text value in the display which is shown before the dropdown list

enumeration

Define the list of options available in the dropdownlist and its associated value which will be placed into
the time series.

defaultstarttime

The default start time of the modifier can be defined here. It corresponds to the same fields in the modifier display. This is only a default value, which can be changed by the user.

Possible options are:

startrun

time zero

defaultendtime

The default end time of the modifier can be defined here. It corresponds to the same fields in the modifier display. This is only a default value, which can be changed by the user.

Possible options are:

time zero

end run

This modifier is applied to every time series which has parameter id RAINSNOW because a filter is defined with only the parameterId RAINSNOW.

The text of the label in front of the dropdownlist is configurable. The items in the dropdownlist are also configurable. For this modifier the forecaster can choose between options rain and snow. If snow is selected a value of 2 in set into the time series for the selected period.
If rain is selected a value of 1 is written into the time series.
The numbers are treated as flags by the model to which the time series is passed.

Time series modifier

The time series modifier is a modifier which allows the forecaster to edit a timeseries by selecting points in a graph (graphical appointment of modifiers, aka GAM, see below) or by changing values in a modifier. In most applications of this modifier the forecaster is directly editing a time series which is used by the models. For example it might be used to directly edit the precipitation. This is contrary to how for example the single value modifier WECHNG is used. This modifier edits an empty time series which is than read by the snow17-model which modifies its state based on the input from this modifier. A time series modifier always has a start- and enddate. Optionally (if configured) a valid time is available.

...