User Tools

Site Tools


start:hype_file_reference:pointsourcedata.txt

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
start:hype_file_reference:pointsourcedata.txt [2018/12/14 11:26]
cpers
start:hype_file_reference:pointsourcedata.txt [2020/12/02 08:24] (current)
cpers
Line 1: Line 1:
 ====== PointSourceData.txt ====== ====== PointSourceData.txt ======
  
-This file contains ​points source ​concentrations and discharges. HYPE allows to separate three types of point sources, e.g. wastewater treatment plants, industries, and urban stormwater. Conceptually,​ all three are treated the same by HYPE ([[start:​hype_model_description:​hype_human_water#​point_sources|see description]]),​ but HYPE will separate them in the [[start:​hype_file_reference:​yyyy_ss.txt|annual load result files]] if these are requested in [[start:​hype_file_reference:​info.txt&#​output_options|output options of info.txt]]. Point source loads are added to main rivers as a constant flux. +This file contains ​information about point sources. It may hold constant point sources' ​concentrations and discharges ​or, for time series of point sources, instead identification to find these in the time series files ([[start:​hype_file_reference:​pstimeseries.txt|PSTIMESeries.txt]]). These two types may not be mixed, which one to use is set in info.txt. 
 + 
 +HYPE allows to separate three types of point sources, e.g. wastewater treatment plants, industries, and urban stormwater. Conceptually,​ all three are treated the same by HYPE ([[start:​hype_model_description:​hype_human_water#​point_sources|see description]]),​ but HYPE will separate them in the [[start:​hype_file_reference:​yyyy_ss.txt|annual load result files]] if these are requested in [[start:​hype_file_reference:​info.txt&#​output_options|output options of info.txt]]. Point source loads are added to main rivers as a constant flux. 
  
 Tracers (substance T1) can be added as point sources to the main river with the method above. An alternative use of point sources for tracers is possible though. Tracers can be added to the local river, internal lake, main river or outlet lake. These point sources are not separated into different types of point sources (they are signified by using type zero). These point sources can not be used together with [[start:​hype_file_reference:​info.txt|info.txt]] output options ''​printload''​ or ''​printwaterbal''​. Tracers (substance T1) can be added as point sources to the main river with the method above. An alternative use of point sources for tracers is possible though. Tracers can be added to the local river, internal lake, main river or outlet lake. These point sources are not separated into different types of point sources (they are signified by using type zero). These point sources can not be used together with [[start:​hype_file_reference:​info.txt|info.txt]] output options ''​printload''​ or ''​printwaterbal''​.
  
-The point sources file can also be used for water abstraction sinks, if point source discharges volume are set to values < 0. Abstraction can be made from the main river or an outlet lake. Only one row with abstraction per subbasin is allowed.+The point sources file can also be used for water abstraction sinks. If point source discharges volume are set to values < 0, or the point source type (''​ps_type''​) is set to minus 1, the point source is interpreted as an abstraction instead. Abstraction can be made from the main river or an outlet lake. 
  
 //​PointSourceData.txt//​ is a tab-separated file located in the [[start:​hype_file_reference:​info.txt&#​model_options|modeldir]] folder. Point sources are listed row-wise, multiple point sources for each sub-basin are allowed (but not multiple abstractions). 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 are not allowed to be longer than ten characters. Columns containing character strings, e.g. descriptive meta-data, must not exceed a length of 100 characters. The columns may be in any order. A value must exist for every column and row, i.e. empty cells are not allowed. ​ //​PointSourceData.txt//​ is a tab-separated file located in the [[start:​hype_file_reference:​info.txt&#​model_options|modeldir]] folder. Point sources are listed row-wise, multiple point sources for each sub-basin are allowed (but not multiple abstractions). 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 are not allowed to be longer than ten characters. Columns containing character strings, e.g. descriptive meta-data, must not exceed a length of 100 characters. The columns may be in any order. A value must exist for every column and row, i.e. empty cells are not allowed. ​
Line 12: Line 14:
 The table below describes all //​PointSourceData.txt//​ columns read by HYPE. The general unit (U) is used in tables of parameters and input data where the unit is not defined. The table below describes all //​PointSourceData.txt//​ columns read by HYPE. The general unit (U) is used in tables of parameters and input data where the unit is not defined.
  
-/** 
- * ____________IMPORTANT!__________IMPORTANT!________________IMPORTANT!_______________________IMPORTANT!______________ 
- * 
- * The table below is maintained in spreadsheed file '​file_reference_tables.xlsx'​ 
- * in the wiki back-up folder on our server. 
- * Please edit table contents there and then copy-paste the updated full table to this page. Ask René if something is  
- * unclear. Thanks. 
- * ___________________________________________________________________________________________________________________ 
- */ 
  
 <​sortable>​ <​sortable>​
 ^ Variable ID ^ Unit ^ Description ^ ^ Variable ID ^ Unit ^ Description ^
 +|''​psid''​|//​-//​|identification of point source or abstraction given as time series (unique)|
 |''​subid''​|//​-//​|id number for subbasin in which point source is located, integer < 10<​sup>​8</​sup>​| |''​subid''​|//​-//​|id number for subbasin in which point source is located, integer < 10<​sup>​8</​sup>​|
-|''​ps_type''​|//​-//​|**For point source**: integer signifying type of point source, between 1 and 3. Irrelevant if water abstraction. **For alternative tracer point source**: zero.|+|''​ps_type''​|//​-//​|**For ​ordinary ​point source**: integer signifying type of point source, between 1 and 3. **For abstraction**: minus one. **For alternative tracer point source**: ​not used (set to zero or missing value).|
 |''​ps_vol''​|//​m<​sup>​3</​sup>/​d//​|point source discharge or, if negative, abstracted water volume| |''​ps_vol''​|//​m<​sup>​3</​sup>/​d//​|point source discharge or, if negative, abstracted water volume|
 |''​ps_tpconc''​|//​mg/​l//​|concentration of Tot-P in point source (irrelevant if water abstraction)| |''​ps_tpconc''​|//​mg/​l//​|concentration of Tot-P in point source (irrelevant if water abstraction)|
Line 37: Line 31:
 |''​fromdate''​|//​date-time//​|Gives the start date for the point source. Format: yyyy-mm-dd [HH:MM]. Set to 0 if the source is from before the simulation start. (optional, default is 0, i.e. constant source for the simulation period)| |''​fromdate''​|//​date-time//​|Gives the start date for the point source. Format: yyyy-mm-dd [HH:MM]. Set to 0 if the source is from before the simulation start. (optional, default is 0, i.e. constant source for the simulation period)|
 |''​todate''​|//​date-time//​|Gives the end date for the point source. Format: yyyy-mm-dd [HH:MM]. Set to 0 if the source is continuing after the simulation end. (optional, default is 0, i.e. constant source for the simulation period)| |''​todate''​|//​date-time//​|Gives the end date for the point source. Format: yyyy-mm-dd [HH:MM]. Set to 0 if the source is continuing after the simulation end. (optional, default is 0, i.e. constant source for the simulation period)|
-|''​ps_source''​|//​-//​|**For abstraction**:​ integer code for location of abstraction;​ from main river volume (1), outlet lake volume (2) or main river volume and inflow (3), default is 1. **For alternative tracer point source**: integer code for location of source local river (1), local lake (2), main river (3) or outlet lake (4). For other point source: not used.|+|''​ps_source''​|//​-//​|**For abstraction**:​ integer code for location of abstraction;​ from main river volume (1), outlet lake volume (2) or main river volume and inflow (3). **For alternative tracer point source**: integer code for location of source local river (1), local lake (2), main river (3) or outlet lake (4). **For ordinary ​point source**: not used (set to zero or missing value).|
 </​sortable>​ </​sortable>​
  
Line 47: Line 41:
   456   ​1 ​      ​10 ​    ​0.5 ​      ​40 ​       0.3       ​0.9 ​      0   456   ​1 ​      ​10 ​    ​0.5 ​      ​40 ​       0.3       ​0.9 ​      0
   765   ​2 ​      ​2301 ​  ​2 ​        ​100 ​      ​0.3 ​      ​0.9 ​      0   765   ​2 ​      ​2301 ​  ​2 ​        ​100 ​      ​0.3 ​      ​0.9 ​      0
-  4050  ​3       -100   ​0 ​        ​0 ​        ​0 ​        ​0 ​        2+  4050  ​-1      ​-100   ​0 ​        ​0 ​        ​0 ​        ​0 ​        2
  
 Second example: A constant point source of nitrogen and T2 increased 10-fold from March 21 2004. Second example: A constant point source of nitrogen and T2 increased 10-fold from March 21 2004.
Line 59: Line 53:
   subid ps_type ps_source ps_vol ps_t1 fromdate ​  ​todate   subid ps_type ps_source ps_vol ps_t1 fromdate ​  ​todate
   456   ​0 ​      ​2 ​        ​10 ​    ​4 ​    ​1999-08-05 1999-08-05   456   ​0 ​      ​2 ​        ​10 ​    ​4 ​    ​1999-08-05 1999-08-05
 +
 +Fourth example, time series point source: first row: a waste water point source, second row an abstraction from the main river and its inflow
 +
 +  subid psid ps_type ps_source
 +  567   ​1 ​   1       0
 +  668   ​2 ​   -1      3
  
  
start/hype_file_reference/pointsourcedata.txt.1544783191.txt.gz · Last modified: 2018/12/14 11:26 by cpers