Page History

...

The Hydstra adapter allows the values of model parameters and initial state values to be changed by the user. These are changed within the node element of the Hydstra model definition file These values can be changed either through providing the value to be defined using a PI-XML parameter file, or through using a PI-XML time series of the values. To set this up, the nodes for which parameters are to be changed need to be identified, as well as the names of the parameter and/or initial state variables.  The snippet of a TSO file (in this case for a UH model) below shows an example of a node element definition.  To be able to change values in this element from FEWS, is it important to to record the node name (in this example: "Uh_05DB006") as that is used by the adapter. Any of the parameters/initial state values that are defined in the Symbols section can be amended. To do so the new value must be provided in the PI-XML parameters file or in the PI-XML time series file, where the name of the symbol is used as an identier (e.g. "Baseflow"). It is not required to configure all symbols, as those not provided will not be amended. Note also that if a NaN is provided as a value, or the parameter/initial state value is missing in a time series, then the original value will not be amended.

Node
    {
    Name="Uh_05DB006"
    Description=
        {
        Dimensionless unit hydrograph node.
        }
    ObjectColour=RGB(0,255,0)
    Location=39.032000,46.747000
    Type="DimHgraphNode"
    Symbols=
        {
        float Theta = 0.2
        const int TimeToPeak = 45
        float Area = 2253
        float Baseflow = 13.0
        int FileOutput = 0
        String NodeName = "Uh_05DB006"
        String PrecipSourceName = ""
        float Outflow = 0
        int Outflow.Quality = 255
    }

Identifying output time series available for import to FEWS

After the model run has completed the adapter will read configured outputs provided by the Hydstra model engine.  Outputs can be provided by the engine to be read by the adapter through to formats. The first is through TSF formatted files, and the second is a free-format text file. The format of the latter is defined in the TSO file.

To identify those outputs provided as a TSF file, the sections in the TSO file with the keywords "Output=TimeSeries" must be identified. e.g.

Output=TimeSeries(47.637,37.956,Text(..\OutputFiles\Forecast_05CE020_QR.tsf),Qual(Mode(Overwrite)),Q1,T2)