User Tools

Site Tools


start:hype_file_reference:xobs.txt

Xobs.txt

The file is used for introducing time series of several different variables into the model. The time series can be observations used for evaluation of the model, e.g. rswe snow water equivalent. A few of the time series can be used as forcing data, i.e. concentrations of precipitation and observed potential evaporation (repo).

The file is located in the modeldir folder. File should include a continuous time period of values for each time step, which doesn’t need to cover the whole simulation time period. Missing values should be given as -9999.

The first row is a comment row which is skipped when reading the file. The second row gives the variable names. For the first column, the date column, the name “date” can be used (no name may not be omitted). The third row gives which subbasin (subid in GeoData.txt) the column’s data is given for. The date column may in this case belong to subbasin 0 (may not be omitted). The first column is date in format yyyy-mm-dd [HH:MM]. If set in info.txt that matlab-format should be read (readformat 1) the date format is yyyymmdd[HHMM]. Second to last columns are data columns.

Observation variables that can be given in Xobs.txt are tabled below. They are a selection of the HYPE variables. Column # refers to the same column in HYPE variable table.

Column Agg. indicates the type of aggregation of the variables. The type determines how the variable is treated when asked for as an output variable or in a criterion calculation. The meanperiod of the output/criterion determines the period over which the variables values will be aggregated. They will be averaged, weight-averaged or summed according to the type of aggregation. The weight-averaged variables are weighted with the flow/water volume that they are associated to. For the concentration of precipitation that is pobs and for the flow concentrations rout. Similarly variable values in Xobs.txt represent either averages, weighted averages, or sums over the timestep.

# Variable ID Unit Description Agg. Reference area Component
5rswemmobserved snow water equivalent, provided in Xobs.txtAvg.subbasin land areaSnow
6rsnwcmobserved snow depth, provided in Xobs.txtAvg.subbasin land areaSnow
27resfcmobserved frost depth, provided in Xobs.txtAvg.subbasin land areamissing
28regwmobserved groundwater level, provided in Xobs.txtAvg.subbasin land areamissing
39rfsc-recorded fractional snow cover area, provided in Xobs.txtAvg.subbasin land areamissing
41rfse-recorded fractional snow cover area error, provided in Xobs.txtAvg.subbasin land areamissing
42rfsm-recorded fractional snow cover multi, provided in Xobs.txt :?:Avg.subbasin land areamissing
43rfme-recorded fractional snow cover multi error, provided in Xobs.txtAvg.subbasin land areamissing
46wstrmobserved water level olake, provided in Xobs.txtAvg.outlet lake areamissing
57rinfm3/sobserved flow to outlet lake (including P-E of the lake), provided in Xobs.txtAvg.subbasin upstream areamissing
72rolicmrecorded olake ice depth, provided in Xobs.txtAvg.outlet lake areamissing
73rilicmrecorded ilake ice depth, provided in Xobs.txtAvg.internal lake areamissing
74rolbcmrecorded olake blackice depth, provided in Xobs.txtAvg.outlet lake areamissing
75rilbcmrecorded ilake blackice depth, provided in Xobs.txtAvg.internal lake areamissing
76rolscmrecorded olake snow depth, provided in Xobs.txtAvg.outlet lake areamissing
77rilscmrecorded ilake snow depth, provided in Xobs.txtAvg.internal lake areamissing
84rmricmrecorded main river ice depth, provided in Xobs.txtAvg.main river areamissing
85rlricmrecorded local river ice depth, provided in Xobs.txtAvg.local river areamissing
86rmrbcmrecorded main river blackice depth, provided in Xobs.txtAvg.main river areamissing
87rlrbcmrecorded local river blackice depth, provided in Xobs.txtAvg.local river areamissing
88rmrscmrecorded main river snow depth, provided in Xobs.txtAvg.main river areamissing
89rlrscmrecorded local river snow depth, provided in Xobs.txtAvg.local river areamissing
100rolt°Crecorded olake surface temperature, provided in Xobs.txtAvg.outlet lake areamissing
101rilt°Crecorded ilake surface temperature, provided in Xobs.txtAvg.internal lake areamissing
102rmrt°Crecorded main river surface temperature, provided in Xobs.txtAvg.main river areamissing
117rgmbmmrecorded glacier mass balance, provided in Xobs.txtAvg.specific glacier areamissing
119rgmakm2area used in recorded mass balance, provided in Xobs.txtAvg.specific glacier areamissing
120rgmpdaysrecorded mass balance period, provided in Xobs.txtAvg.nonemissing
121S105-recorded (FSUHSS) snow cover surrounding terrain open (fraction from 0 to 10), provided in Xobs.txtAvg.area of non-forest land covermissing
122S106-recorded (FSUHSS) snow cover course open (fraction from 0 to 10), provided in Xobs.txtAvg.area of non-forest land covermissing
123S108cmrecorded (FSUHSS) mean depth open, provided in Xobs.txtAvg.area of non-forest land covermissing
124S111g/cm3recorded (FSUHSS) mean density open, provided in Xobs.txtAvg.area of non-forest land covermissing
125S114mmrecorded (FSUHSS) snow water equivalent open, provided in Xobs.txtAvg.area of forest land covermissing
126S205-recorded (FSUHSS)snow cover surrounding terrain forest (fraction from 0 to 10), provided in Xobs.txtAvg.area of forest land covermissing
127S206-recorded (FSUHSS) snow cover course forest (fraction from 0 to 10), provided in Xobs.txtAvg.area of forest land covermissing
128S208cmrecorded (FSUHSS) mean depth forest, provided in Xobs.txtAvg.area of forest land covermissing
129S211g/cm3recorded (FSUHSS) mean density forest, provided in Xobs.txtAvg.area of forest land covermissing
130S214mmrecorded (FSUHSS) snow water equivalent forest, provided in Xobs.txtAvg.area of forest land covermissing
142reT1µU/Lobserved concentration of tracer T1 in outflow from olake/subbasin, unit dependent on substance simulated, values provided in Xobs.txtW. Avg.subbasin upstream areatracer T1
143reT2°Cobserved water temperature in outflow from olake/subbasin, provided in Xobs.txt (average based on recorded flow if present)W. Avg.subbasin upstream areamissing
144reIN,
reON,
reSP,
rePP,
reTN,
reTP
µg/Lobserved concentration of N and P species in outflow from olake/subbasin, provided in Xobs.txt (average based on recorded flow if present)W. Avg.subbasin upstream areamissing
145cpT1µU/Lobserved concentration of tracer T1 in precipitation, unit user-provided, values provided in Xobs.txtW. Avg.subbasin areatracer T1
156reOCmg/Lobserved OC concentration in outflow from olake/subbasin, provided in Xobs.txtW. Avg.subbasin upstream areamissing
165repomm/[period]observed potential evapotranspiration, provided in Xobs.txtSumsubbasin areamissing
166eobsmm/[period]observed evapotranspiration, provided in Xobs.txtSumsubbasin areamissing
171rrunmm/[period]observed local runoff from land area, provided in Xobs.txtSumsubbasin land areamissing
194cpINµg/Lobserved concentration of inorganic nitrogen in precipitation, provided in Xobs.txtW. Avg.subbasin areamissing
195cpSPµg/Lobserved concentration of soluble phosphorus in precipitation, provided in Xobs.txtW. Avg.subbasin areamissing
248roumm3/sobserved outflow from olake outlet 1Avg.subbasin upstream areamissing
249roubm3/sobserved outflow from olake outlet 2Avg.subbasin upstream areamissing
270xom0..9depends on variable typeobservations of not predefined variable (to be averaged over output time interval) provided in Xobs.txt or XobsXOMn.txtAvg.depends on variable typemissing
271xos0..9depends on variable typeobservations of not predefined variable (to be summed over output time interval) provided in Xobs.txt or XobsXOSn.txtSumdepends on variable typemissing
start/hype_file_reference/xobs.txt.txt · Last modified: 2018/06/21 09:29 by cpers