forked from JamesSample/enviro_mod_notes
-
Notifications
You must be signed in to change notification settings - Fork 3
/
Copy pathInput_output_data_description.txt
132 lines (98 loc) · 5.79 KB
/
Input_output_data_description.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
SimplyP v0.1 and v0.2, description of input and output data files
Last modified 04/02/2019
Leah Jackson-Blake
########################################################################
Formatting:
- Dates should be in day-first European format, i.e. DD/MM/YYYY
- Decimal separators: points are expected, not commas. I'll add another setup parameter soon to allow for semi-colon separated files with decimal commas. Get in touch if you need that doing now.
########################################################################
1) Input: Model parameters
These are defined in an Excel sheet. See the Example_Data file for a template.
The file can have any name. The path to the file is entered at the top of the Jupyter notebook used to run the model.
The sheet names must not change, nor must the parameter names within the 'Param' column.
See the 'readme' on the first sheet of the parameter file for more guidance.
########################################################################
2) Input: Meteorological data to drive the model
This should be stored in csv format with column headings:
Date (this must be the first column)
Then in any order: Precipitation
T_air
Optionally also: PET
Description of variables:
Precipitation: total precipitation (rain plus snow), units mm
T_air: air temperature, units degrees Celsius
PET: potential evapotranspiration, units mm
If the time series in this file is longer than the period defined by the start and end dates in the parameter file ('Setup' sheet, parameters 'st_dt' and 'end_dt'), then it will be automatically truncated to coincide with the desired start and end dates. N.B. it must cover the period defined by the start and end dates.
If PET data is not provided, it will be calculated by the model using the Thornthwaite method. Note that this method may provide biased results, but has been chosen as a first approximation of PET as it is simple to implement and has low data requirements.
See the Example_Data file for a template
########################################################################
3) Optional input: observed discharge and water chemistry data
In Excel files. Create separate files for discharge and water chemistry data.
Files can have any name (the path to the files is entered by the user in the parameter 'Setup' sheet)
Within the files: insert data for separate reaches on separate sheets, and number the sheets with the reach number (e.g. 1, 2,...) ONLY (the model code expects sheet names to be integers, and will return an error if not)
Each sheet within the file should have the headings (excluding the comments in brackets):
Discharge data:
Date (this must be the first column)
Q
Water chemistry data:
Date (this must be the first column)
TP, PP, TDP, SRP, SS (optional; include any of these you have data for)
where:
Q is the discharge (m3/s)
TP is total P (mg/l)
PP is particulate P (mg/l)
TDP is total dissolved P (mg/l)
SRP is soluble reactive P (mg/l)
SS is suspended sediment (mg/l)
Any columns in the sheet with names aside from these will not be read in (but need not be deleted from the file)
As with the meteorological input data, observations are automatically truncated to the start and end dates given in the parameter setup sheet
See the Example_Data file for templates
########################################################################
4) Optional output: Instream results
csvs of simulated in-stream results are provided for all reaches and for the summed inputs to a receiving waterbody (if simulated).
Files are labelled:
Instream_results_Reach#.csv where # is the reach number
Instream_results_receiving_waterbody.csv
Files have the following columns in addition to the date:
Q_cumecs: Daily mean discharge (m3/s)
Daily fluxes from the reach (kg/day):
Msus_kg/day: suspended sediment
PP_kg/day: particulate P
TDP_kg/day: total dissolved P
TP_kg/day: total P
SRP_kg/day: solube reactive P
Volume-weighted daily mean concentrations (mg/l):
SS_mgl: suspended sediment
PP_mgl: particulate P
TDP_mgl: total dissolved P
TP_mgl: total P
SRP_mgl: soluble reactive P
########################################################################
4) Optional output: Terrestrial compartment results
csvs of simulated results for the terrestrial compartment are produced for all sub-catchments.
Filenames: Results_TC_SC#.csv, where # is the sub-catchment number.
Files include the following columns in addition to the date:
C_cover_A: Soil cover and erodibility factor for agricultural land
D_snow: Snow depth (mm)
EPC0_A_kgmm: EPC0 in agricultural soil (kg/mm)
EPC0_A_mgl: EPC0 in agricultural soil (mg/l)
EPC0_NC_kgmm: EPC0 in newly-converted agricultural or semi-natural soil (kg/mm)
EPC0_NC_mgl: EPC0 in newly-converted agricultural or semi-natural soil (mg/l).
Only calculated if have NC land
P_labile_A: Labile soil P mass in agricultural land (kg)
P_labile_NC: Labile soil P mass in newly-converted agricultural or semi-natural land (kg)
Plabile_A_mgkg: Labile soil P content on agricultural land (mg P/kg soil)
Plabile_NC_mgkg: Labile soil P content on newly-converted land (mg P/kg soil);
only calculated if have newly-converted land
TDPs_A: Soil water TDP mass, agricultural land (kg)
TDPs_A_mgl: Soil water TDP concentration, agricultural land (mg/l)
TDPs_NC_mgl: Soil water TDP concentration, agricultural land (mg/l).
Only calculated if have NC land
TDPs_NC: Soil water TDP mass, newly-converted agricultural or semi-natural land (kg)
Qg: Groundwater flow (mm/d)
Qq: Quick flow (mm/d)
QsA: Soil water flow, agricultural land (mm/d)
QsS: Soil water flow, semi-natural land (mm/d)
Vg: Groundwater volume (mm)
VsA: Soil water volume, agricultural land (mm)
VsS: Soil water volume, semi-natural land (mm)