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/03/27 12:54]
cpers
start:hype_file_reference:pointsourcedata.txt [2024/01/25 11:37] (current)
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 ​eight types of point sources, e.g. wastewater treatment plants, industries, and urban stormwater. Conceptually,​ all eight 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.+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, the outlet lake or the aquifer below the subbasin. There can be only one abstraction from each subbasin (if several the last read will be used).
  
-//​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. 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. ​
  
  
 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 ​                                                                                                                                                                                                                                                                                                                                                                                                                                ​^ 
-|''​subid''​|//​-//​|id number for subbasin in which point source is located, integer < 10<​sup>​8</​sup>​| +| ''​psid'' ​       | //-//                | identification of point source or abstraction given as time series (unique) ​                                                                                                                                                                                                                                                                                                                                                                | 
-|''​ps_type''​|//​-//​|**For point source**: integer signifying type of point source, between 1 and 3Irrelevant if water abstraction. **For alternative tracer point source**: zero.| +| ''​subid'' ​      ​| //-//                | id number for subbasin in which point source is located, integer < 10<​sup>​8</​sup> ​                                                                                                                                                                                                                                                                                                                                                          ​
-|''​ps_vol''​|//​m<​sup>​3</​sup>/​d//​|point source discharge or, if negative, abstracted water volume| +| ''​ps_type'' ​    ​| //-//                | **For ordinary ​point source**: integer signifying type of point source, between 1 and 8**For abstraction**: minus one. **For alternative tracer point source**: ​not used (set to zero or missing value)                                                                                                                                                                                                                                 
-|''​ps_tpconc''​|//​mg/​l//​|concentration of Tot-P in point source (irrelevant if water abstraction)| +| ''​ps_vol'' ​     | //​m<​sup>​3</​sup>/​d// ​ | point source discharge or, if negative, abstracted water volume. The discharge is given per day regardless of simulation time step.                                                                                                                                                                                                                                                                                                                                                                             
-|''​ps_tnconc''​|//​mg/​l//​|concentration of Tot-N in point source (irrelevant if water abstraction)| +| ''​ps_tpconc'' ​  ​| //​mg/​l// ​            ​| concentration of Tot-P in point source (irrelevant if water abstraction) ​                                                                                                                                                                                                                                                                                                                                                                   | 
-|''​ps_spfrac''​|//​-//​|fraction of Tot-in point source that is in soluble ​form (irrelevant if water abstraction)| +| ''​ps_spfrac'' ​  | //-//                | fraction of Tot-P in point source that is in soluble form (irrelevant if water abstraction) ​                                                                                                                                                                                                                                                                                                                                                
-|''​ps_infrac''​|//​-//​|fraction of Tot-N in point source that is in inorganic form (irrelevant if water abstraction)| +| ''​ps_tnconc'' ​  ​| //​mg/​l// ​            ​| concentration of Tot-N in point source (irrelevant if water abstraction) ​                                                                                                                                                                                                                                                                                                                                                                   
-|''​ps_t1''​|//​µU/​L//​|concentration of tracer T1 in point source (irrelevant if water abstraction)| +| ''​ps_infrac'' ​  ​| //-//                | fraction of Tot-in point source that is in inorganic ​form (irrelevant if water abstraction) ​                                                                                                                                                                                                                                                                                                                                              ​
-|''​ps_t2''​|//​°C//​|temperature of point source water (used for T2 simulation) (irrelevant if water abstraction)| +| ''​ps_occonc'' ​  | //​mg/​l// ​            | concentration of organic carbon in point source (irrelevant if water abstraction) ​                                                                                                                                                                                                                                                                                                                                                          | 
-|''​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)| +| ''​ps_tsconc'' ​  | //​mg/​l// ​            | concentration of total suspended material in point source (irrelevant if water abstraction) ​                                                                                                                                                                                                                                                                                                                                                | 
-|''​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_ssfrac'' ​  | //-//                | fraction of total suspended material ​in point source that is suspended material ​(irrelevant if water abstraction) ​                                                                                                                                                                                                                                                                                                                          ​
-|''​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_t1'' ​      ​| //​µU/​L// ​            ​| concentration of tracer T1 in point source (irrelevant if water abstraction) ​                                                                                                                                                                                                                                                                                                                                                               
 +| ''​ps_t2'' ​      ​| //​°C// ​              ​| temperature of point source water (used for T2 simulation) (irrelevant if water abstraction). Can be set to -9999 to add the flow without changing the temperature of the recieving water. ​                                                                                                                                                                                                                                                 | 
 +| ''​ps_dsiconc'' ​ | //​mg/​l// ​            | concentration of dissolved silica in point source (irrelevant if water abstraction) ​                                                                                                                                                                                                                                                                                                                                                        | 
 +| ''​ps_asiconc'' ​ | //​mg/​l// ​            | concentration of algae silica in point source (irrelevant if water abstraction) ​                                                                                                                                                                                                                                                                                                                                                            
 +| ''​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) ​                                                                                                                                                                                                                               
 +| ''​ps_source'' ​  ​| //-//                | **For abstraction**:​ integer code for location of abstraction;​ from main river volume (1), outlet lake volume (2)main river volume and inflow (3) or aquifer (4). **For alternative tracer point source**: integer code for location of sourcelocal river (1), local lake (2), main river (3) or outlet lake (4). **For ordinary ​point source**: not used (set to zero or missing value)**For point source in time series file**: integer code for location; main river (3)  ​|
 </​sortable>​ </​sortable>​
  
Line 45: Line 44:
   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 57: Line 56:
   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       3
 +  668   ​2 ​   -1      3
  
  
start/hype_file_reference/pointsourcedata.txt.1522148048.txt.gz · Last modified: 2023/11/16 14:28 (external edit)