User Tools

Site Tools


start:hype_file_reference:branchdata.txt

This is an old revision of the document!


BranchData.txt

This file contains all bifurcations within a HYPE model domain. Bifurcations are stream splits in downstream direction. They can occur naturally, but are often used in HYPE to describe inter-catchment water transfers for e.g. hydropower production. HYPE allows to split water flows by fixed fractions and additionally to define minimum and maximum flow limits.

BranchData.txt is a tab-separated file located in the modeldir folder. Sub-basins with bifurcations are listed row-wise. The first row contains a column header with variable names. Variable names are not case-sensitive (max. 10 characters, no spaces). Columns with headings unknown to HYPE are skipped while reading the file, but must not longer than ten characters. Columns containing character strings, e.g. descriptive meta-data, must not exceed a length of 50 characters. The columns may be in any order. A value must exist for every column and row, i.e. empty cells are not allowed.

Example for a BranchData.txt file structure with two bifurcations:

name         sourceid branchid mainpart maxqmain minqmain maxqbranch
bifurcation1 43       576      0.9      5000     350      1
bifurcation2 3955     2301     0.5      0        0        500

The table below describes all BranchData.txt columns read by HYPE.

Variable ID Unit Description
sourceid-SUBID of sub-basin with bifurcation, i.e. with two downstream sub-basins
branchid-SUBID of sub-basin receiving the second branch flow, must be located in a row below the sub-basin with bifurcation in GeoData.txt
mainpart-fraction of flow from subbasin sourceid that flows in the main branch (as given in column maindown in GeoData.txt) (between 0 and 1). Default is 1.
maxQmainm3/smaximum flow that is allowed in the main branch. Use 0 for no limitation or exclude column completely.
minQmainm3/sminimum flow that is required in the main branch before water is routed into branch. Use 0 for no limitation or exclude column completely.
maxQbranchm3/smaximum flow that is allowed in the branch. Use 0 for no limitation or exclude column completely.
start/hype_file_reference/branchdata.txt.1427378179.txt.gz ยท Last modified: 2023/11/16 14:28 (external edit)