What | Required | Description | schema location |
---|---|---|---|
Branches.xml | no | Definitions of branches | https://fewsdocs.deltares.nl/schemas/version1.0/branches.xsd |
DELFT-FEWS is a location oriented system. All time series data must be referenced to a (geographic) location. Scalar time series need no additional information. For longitudinal time series data, each point in the vector must be referenced to a location in a branch structure. This location must be identified by its coordinate within the branch (chainage), and may also be defined by its geographic coordinates within the coordinate system used.
When available on the file system, the name of the XML file is for example:
Branches 1.00 default.xml
Branches Fixed file name for the Branches configuration
1.00 Version number
default Flag to indicate the version is the default configuration (otherwise omitted).
Figure 27 Elements of the Branches configuration
geoDatum
Definition of the geoDatum used in defining the locations of the branch. This may be different than the geoDatum used in the displays. For enumeration of geoDatums, see Appendix B.
branch
Root element of the definition of a branch. Multiple entries may exist to define multiple branches.
Attributes;
- id: Id of the current branch. This ID must refer to a location ID in the Locations definition.
branchName
Name of the current branch. Used for reference purposes only
startChainage
Chainage of the start of the branch (only used in the longitudinal display)
endChainage
Chainage of the end of the branch (only used in the longitudinal display)
upNode, downNode
Optional item in branch to create branch linkage. This information is not used in DELFT-FEWS, but may be relevant to an external module when exported through the published interface.
zone
Optional item in branch that allows definition of a zone – this is a part of the branch that may be indicated in the longitudinal display with the name given (currently not used in DELFT-FEWS).
pt
Definition of the points belonging to the branch. At least two points must be defined per branch.
Attributes;
- chainage; coordinate of point as measured along the branch (should be greater than or equal to the start chainage and less than the end chainage).
- label; label used to identify the point
- x: (optional) geographic coordinate of the point (Easting)
- y: (optional) geographic coordinate of the point (Northing)
- z: (optional) elevation of the point. The elevation is an important attribute for plotting in the longitudinal profile display. This elevation is taken as the bed level.
- z_rmc: (optional) bed level of right side of main channel
- z_rb: (optional) right bank level
- z_rfp: (optional) right floodplain level
- z_lmc: (optional) bed level of left side of main channel
- z_lb: (optional) left bank level
- z_lfp: (optional) left floodplain level
- description; optional description string. When defined a vertical line will be drawn in the longitudinal display at the location of this point, and the description given displayed.
- thresholdValueSetId; optional reference to an ID of a threshold value set. When defined, the threshold values will be drawn as markers in the longitudinal display at the location of this point.
comment
Notice that the point attributes are only drawn if defined in the configuration.