Definitions of all parameters used in DELFT-FEWS
All time series data in DELFT-FEWS must be defined to be of one of the parameters supported. This configuration file defines the list of supported parameters, including the unit of the parameter.
Parameters are organised into ParameterGroups. All parameters within a group should have the same properties and the same units. Only parameters of the same group may be displayed in a single (sub) plot in the time series display, though this can be overruled if requested using a display template.
When available on the file system, the name of the XML file is for example:
Parameters 1.00 default.xml
Parameters Fixed file name for the Parameters configuration
1.00 Version number
default Flag to indicate the version is the default configuration (otherwise omitted).
The unit conversions id to convert from the (internal) units to the display units. This id should be available in the UnitConversionsDescriptors. Only required when a displayUnit is specified for a parameter group
The unit conversions id to convert from the units specified in config files to the internal units for this parameter. This id should be available in the UnitConversionsDescriptors. Only required when a user unit is specified for a thresholdValuesSet, validationRuleSet or ratingCurve
This parameter is used to resolve the internal stage unit and display stage unit and the name (label) that is used for the rating curve stage axis/column in the user interface
This parameter is used to resolve the internal discharge unit and display discharge unit and the name (label) that is used for the rating curve discharge axis/column in the user interface
Root element of each definition of a parameter group. Multiple entries may exist.
- id: Id of the parameter group. The ID must be unique.
- name: optional name for the parameter group. Used for reference only.
Figure 26 Elements of the ParameterGroup configuration in the parameter definition
Optional description of the parameter group. Used for reference purposes only.
Definition of the parameters in the group if these are "instantaneous" parameters, "accumulative" parameters or "mean" parameters.
Optional. The dimension of the parameter used to indicate what quantity the values for this parameter represent. For example: time, mass, velocity, acceleration, discharge etc.
For certain features the dimension is checked to ensure the calculation performed by FEWS will make sense. For example, the calculate budget option in the spatial display.
The following dimensions are recognized by FEWS:
Unit of the parameters defined in the group. The unit may be selected from a list of units supported by DELFT-FEWS. These are generally SI units. For an enumeration of supported units see Appendix B.
Specify when the unit seen by the user is not the same as the unit of the values internally stored in the data store. Also specify displayUnitConversionsId above. In this unit conversions the conversion from (internal) unit to display unit should be available
Optional. Default accuracy (smallest increment between two values) of the calculated or measured values for all parameters in this group. Value resolution can also be specified for a single parameter (since stable build 2011.01). By default the resolution is dynamic and the values are stored as a 32 bit floating point with 6 significant digits. Floating points don't compress very well and are slow to decode. It is far more efficient to store a value as an integer with a scale factor (= value resolution). When an 8, 16 or 24 bit integer is not big enough to achieve the value resolution the default 32 bit floating point is used as a fallback. E.g. when the accuracy of a water level is half a centimeter, specify 0.005. When the accuracy of a discharge is 10 m3/s, specify 10.
Indicates if the parameters in the group are to be converted when toggling between local and global datum. Value is either true or false. If the value is true, the elevation defined in the location is added to the time series in the database on conversion. See Locations
Definition of each parameter in a parameter group. Multiple parameters may be defined per group.
- id: Id of the parameter. The ID must be unique.
- name: optional name for the parameter. Used for reference only.
Short name for the parameter. This name will be used in the time series display and reports.
Optional description of the parameter (tool tip).
Optional. Only required when different parameters are used for the forecast and historical period. The simulated historical update run, current at the moment the forecast is created, will be used for data before the start of the forecast. It is also required to configure the simulatedHistoricalModuleInstance for the forecast module instances. When configured, this parameter can only be used for simulated forecast time series.
Optional standard name defined by the netcdf CF convention. This is currently only used for export to netcdf files. The standard name has to be valid according to the list of standard names, version 18, see http://cfconventions.org/Data/cf-standard-names/18/build/cf-standard-name-table.html
Optional standard name modifier defined by the netcdf CF convention. This is currently only used for export to netcdf files. See http://cfconventions.org/Data/cf-conventions/cf-conventions-1.6/build/cf-conventions.html#standard-name
Option to indicate if a time series of this parameter type is allowed to contain missing values when being used by a model or a transformation. When omitted this value will default to 'true'. If this is used for a transformation, then it is also required to set the option checkMissing in the inputVariable of the transformation to true.
Optional cell method (for time dimension) as defined in the netcdf CF convention. This is currently only used for export to netcdf files. See http://cfconventions.org/Data/cf-conventions/cf-conventions-1.6/build/cf-conventions.html#cell-methods
Configuring a hierarchical tree view for parameters in Fews Explorer
As of Fews 2010_01 there is a second root node parameters available in the parameters.xsd schema. This new element facilitates configurations of the parameters to be displayed in Fews Explorer in the form of a hierarchical tree. The parameters node embeds the parameterGroups element described above. The element parameterRootNode is of type ParameterNodeComplexType and represents the top node of the hierarchical tree structure that is to be displayed. Other parameterNodes can be nested within each instance of ParameterNodeComplexType. Each node has an id field and can have a name and description and multiple parameterIds. The parameterIds from parameterGroups that are not included in the hierarchical tree specified by parameterRootNode are added automatically at the root level.
This attribute is used as the identifier label which is displayed when ids are made visible within Fews Explorer.
This element is used as the name label which is displayed when names are made visible within Fews Explorer.
This element is used as the description label which is displayed when descriptions are made visible within Fews Explorer.
This element must refer to the identifier of one of the parameters defined within the parameterGroups section.
NB. Each parameterId can only be used once and has to be defined within one of the parameterGroups.
This element is of type ParameterNodeComplexType and can be used similar to parameterRootNode.
Sample xml for hierarchical parameters
Sample parameters tree view in Fews Explorer
In case there is no timeseriesset for the combination of parameter and location, the nodes will be grayed out:
Parameters in csv format
It is possible to define parameters in a csv file. By using %% can be referred to the content of the columns in the csv file. For example:
parametersALL.csv located in MapLayerFiles config directory