In order to configure an isis model in fews you must configure the adaptor with an .ini file. The structure of the file is as follows:
Introduction
The ISIS /RS adapter for the EA FFS FEWS will be driven by an INI file created by ISIS. The purpose of the file is to identify the locations and unit types of the inputs, outputs and controls of the ISIS model in a form that the adapter can read without knowledge of the ISIS DAT file format.
The file format has been was originally developed with the following in mind: •
- To minimise coding and maximise the sharing of code between the adapter and FloodWorks, the parameters are the same as those in the equivalent FloodWorks parameter
...
- file.
...
...
- The generic approach means there are several elements that will always take the same value in the ISIS adapter but which would have different values in, say, a PDM adapter.
...
The INI file is in 14 sections as follows:
1. General
2. InputDimensions
3. Inputs
4. ControlDimensions
5. Controls
6. OutputDimensions
7. Outputs
8. StatesDimensions
9. RealParameterDimensions
10. RealParameters
11. IntegerParameterDimensions
12. IntegerParameters
13. CharacterParameterDimensions
14. CharacterParameters
The sections can be in any order.
Parameters
The full parameter list is below, followed by endnotes explaining some of the particular ISIS values. The following definitions will be useful:
• Flow input series: QTBDY marked as being used as an input to the operational model
• Stage input series: HTBDY marked as being used as an input to the operational model
• Wind input series: component of a WIND unit marked as being used as an input to the operational model
• Simple control: GAUGE, VERTICAL SLUICE, RADIAL SLUICE, ABSTRACTION, GATED WEIR, PUMP, or BLOCKAGE marked as being used as an input to the operational model
• Flow output series: node marked as providing flow output to the operational model
• Stage output series: node marked as providing stage output to the operational model
Name | Generic meaning | ISIS value | |||
General | |||||
AlgorithmID | Algorithm ID | IWRS2 | |||
ModelID | Model ID | The ID of this particular ISIS model - the name specified for the export (e.g. MyModel) | |||
InputDimensions | |||||
Total | Total number of input series | Number of flow or stage input series + 2 * Number of wind input series | |||
Count0d | Number of scalar sets of input series | 0 | |||
Count1d | Number of 1-d arrays of input series | 2 | |||
Count2d | Number of 2-d arrays of input series | 0 | |||
Size1d | Dimensions of 1d series | Number of flow or stage input series, 2 * Number of wind input series | |||
Size2d | Dimensions of 2d series | Omit | |||
Inputs | |||||
IDs | Location IDs for the input data streams | ISIS node label for each flow or stage input, Identifier for each wind component input stream (each separated by a comma and a space) | |||
ControlDimensions | |||||
Total | Total number of control series | Number of simple controls + 5 * Number of breaches | |||
Count0d | Number of scalar sets of control series | 0 | |||
Count1d | Number of 1-d arrays of control series | 2 | |||
Count2d | Number of 2-d arrays of control series | 0 | |||
Size1d | Dimensions of 1d series | Number of simple controls, 5 * Number of breaches | |||
Size2d | Dimensions of 2d series | Omit | |||
Controls | |||||
IDs | Location IDs for the control data streams | Upstream ISIS node label for each simple control, Identifier for each breach component stream (each separated by a comma and a space) | |||
OutputDimensions | |||||
Total | Total number of output series | Total number of output series | |||
Count0d | Number of scalar sets of output series | 0 | |||
Count1d | Number of 1-d arrays of output series | 1 | |||
Count2d | Number of 2-d arrays of output series | 0 | |||
Size1d | Dimensions of 1d series | Number of output series | |||
Size2d | Dimensions of 2d series | ||||
Outputs | |||||
IDs | Location IDs for the output data streams | ISIS node label for each output (each separated by a comma and a space) | |||
StatesDimensions | |||||
Total | Total number of states | 0 | |||
Count0d | Number of scalar states | 0 | |||
Count1d | Number of 1-d arrays of states | 0 | |||
Count2d | Number of 2-d arrays of states | 0 | |||
Size1d | Dimensions of 1d states | Omit | |||
Size2d | Dimensions of 2d states | Omit | |||
RealParameterDimensions | |||||
Total | Total number of real parameters | 3 | |||
Count0d | Number of scalar real parameters | 3 | |||
Count1d | Number of 1-d arrays of real parameters | 0 | |||
Count2d | Number of 2-d arrays of real parameters | 0 | |||
Size1d | Dimensions of 1d real parameter arrays | Omit | |||
Size2d | Dimensions of 2d real parameter arrays | Omit | |||
RealParameters | |||||
Values | Real parameters | Blank Timeout per 1h of simulated time (s), Save interval (s) | |||
IntegerParameterDimensions | |||||
Total | Total number of integer parameters | 2 + | Number of flow or stage input series + | Number of simple controls + | Number of output series + |
Count0d | Number of scalar integer parameters | 2 | |||
Count1d | Number of 1-d arrays of integer parameters | 3 | |||
Count2d | Number of 2-d arrays of integer parameters | 1 | |||
Size1d | Dimensions of 1d integer parameter arrays | Number of flow or stage input series, Number of simple controls, Number of output series | |||
Size2d | Dimensions of 2d integer parameter arrays | 2 , Number of breaches | |||
IntegerParameters | |||||
Values | Integer parameters Version number (currently 4), ISIS label length (8 or 12), Unit type for each flow or stage input series , | ||||
CharacterParameterDimensions | |||||
Total | Total number of character parameters 1 + | ||||
Count0d | Number of scalar character parameters | 1 | |||
Count1d | Number of 1-d arrays of character parameters | 4 | |||
Count2d | Number of 2-d arrays of character parameters | 1 | |||
Size1d | Dimensions of 1d character parameter arrays | Number of input series, | |||
Size2d | Dimensions of 2d character parameter arrays | 2 , Number of breaches | |||
CharacterParameters | |||||
Values | String parameters | Blank, |
Example
...
latest documentation of the adapter is maintained by CH2M HILL and can be found here.
Example
An example of the ISIS ini file can be found here.
| Info |
|---|
Note that this file is generated in by ISIS (file > export to EA FFS) - see ISIS documentation for further details. |