| Description of variable | Unit | Range | R | DT | Mnemonic |
|---|---|---|---|---|---|
| Time domain | |||||
| Year when hydrological simulation started | - | [1..∞] | ∗ | I | bruny |
| Year when hydrological simulation ended | - | [bruny..∞] | - | I | eruny |
| Time (Julian daynumber) when hydrological simulation started (Minimum); will be 0.0 when simulation started at 1st of January, 00.00 hour. | - | [0.0..366] | - | R | brund-1 |
| Time (Julian daynumber) when hydrological simulation ended (Maximum) | - | [0.0..366] | - | R | erund |
| Step size of time-interval for dynamic hydrological data | d | [1.0..30.0] | - | R | period |
| Geometry of model system | |||||
| Number of model compartments | - | [1.numnod] | ∗ | I | numnod |
| Number of horizons | - | [1 ..numlay] | - | I | numlay |
| Number of drainage systems (value must be 0, 1, 2, 3, 4 or 5) | - | [0,1,2,3,4,5] | - | I | nrlevs |
| Compartment number of the deepest compartment (bottom) of each horizon/layer | - | [1..numnod] | ∗ | I | botcom(numlay) |
| Volume fraction moisture at Saturation | m3 m-3 | [0.0 .. 1.0] | ∗ | R | thetas (numlay) |
| Volume fraction moisture at Field Capacity | m3 m-3 | [0.0 .. 1.0] | ∗ | R | thetafc(numlay) |
| Volume fraction moisture at Wilting point | m3 m-3 | [0.0 .. 1.0] | ∗ | R | thetawp(numlay) |
| Thickness of compartments | m | [0.001..100] | ∗ | R | dz(numnod) |
| Initial conditions | |||||
| Volume fraction moisture initially present in compartments 1 – NUMNOD | m3 m-3 | [0.0 .. 1.0] | ∗ | R | theta(numnod) |
| Initial groundWaterlevel | m-ss | [0.0..∞] | ∗ | R | gwl |
| Storage by initial ponding (m+surface) | m | [0.0..∞] | - | R | pond |
| Dynamic part | |||||
| Time (Julian daynumber) in hydrological model | - | [0.0..∞] | ∗ | R | tcum |
| Precipitation (incl. irrigation) water flux | m d-1 | [0.0..∞] | - | R | iprec |
| Evaporation flux by interception | m d-1 | [0.0..∞] | - | R | iintc |
| Actual evaporation flux by bare soil | m d-1 | [0.0..∞] | - | R | ievap |
| Evaporation flux by ponding | m d-1 | [0.0] | - | R | 0.0 |
| Potential evaporation flux by soil | m d-1 | [0.0..∞] | - | R | ipeva |
| Potential transpiration flux | m d-1 | [0.0..∞] | - | R | iptra |
| Flux of surface RUnoff | m d-1 | [0.0..∞] | - | R | iruno |
| Groundwater level at end of time-interval | m-ss | [0.0..∞] | - | R | gwl |
| Storage by ponding at soil surface at end of time-interval | m | [0.0..∞] | - | R | pond |
| Suction (pressure head) of soil moisture (negative when unsaturated) | cm | [-∞..+∞] | ∗ | R | h(numnod) |
| Volume fraction of moisture at end of time-interval | m3 m-3 | [0.0 .. 1.0] | ∗ | R | theta(numnod) |
| Actual transpiration flux | m d-1 | [0.0..∞] | ∗ | R | inqrot(numnod) |
| Flux incoming from above (compartments 1 – numnod+1, downward=positive) | m d-1 | [0.0..∞] | ∗ | R | inq(numnod+1) |
| Flux of drainage system of 1st order (e.g. canal) | m d-1 | [0.0..∞] | ∗ | R | inqdra(1,numnod) |
| Flux of drainage system of 2nd order (e.g. ditch) | m d-1 | [0.0..∞] | ∗ | R | inqdra(2,numnod) |
| Flux of drainage system of 3rd order (e.g. trench) | m d-1 | [0.0..∞] | ∗ | R | inqdra(3,numnod) |
| Flux of drainage system of 4th order (e.g. tube drain) | m d-1 | [0.0..∞] | ∗ | R | inqdra(4,numnod) |
| Flux of drainage system of 5th order (e.g. rapid drainage) | m d-1 | [0.0..∞] | ∗ | R | inqdra(5,numnod) |
Appendix B — Formatted and unformatted binary output files
This annex describes the contents of additional output files with the extensions *.afo, *.aun, *.bfo, and *.bun. The files *.afo and *.aun, as well as *.bfo and *.bun, contain identical information; they differ only in format. The *.aun and *.bun files are binary and unformatted, whereas the *.afo and *.bfo files are formatted. The description given in this annex uses the following symbols:
- Unit: units as applied in these output files; units differ from those applied in SWAP!
- Range: upper and lower boundary of given data
- R: an asterisk (*) indicates that data are written to a new record;
- DT: data type; R means Real*4, I means Integer*2 and C means CharacterString;
- Mnemonic: the name of the variable as applied in the source code of Swap
Part of the content of this file is optional and indicated with grey shading of the corresponding rows. The optional content is indiced with the switch swop (see section File Options). The temperature parameter (tsoil) has a value of “-99.9” when temperature processes were not simulated.
The snow-parameters (ssnow, igsnow, isubl) have a value of ‘0’, when snow processes were not simulated. This value of 0, rather than -99.9, is used to ensure consistency in water balance calculations.
| Description of variable | Unit | Range | R | DT | Mnemonic |
|---|---|---|---|---|---|
| Header | |||||
| Project Name (example: * Project: CranGras) | - | ... | ∗ | C80 | Project |
| File Content (example: * File content: formatted hydrological data) | - | ... | ∗ | C80 | FilText |
| File Name (example: * File name: result.bfo) | - | ... | ∗ | C80 | FilNam |
| Model Version (example: * Model version: SWAP3.0.0) | - | ... | ∗ | C80 | Model_ID |
| Date and time of file creation (example: * Generated at: 28-Mar-2003 13:59:31) | - | ... | ∗ | C80 | DTstring |
| Switch for Options of content of this file (SWOP) | - | [1..2] | ∗ | I | swop |
| Time domain | |||||
| Year when hydrological simulation started | - | [1..] | ∗ | I | bruny |
| Year when hydrological simulation ended | - | [bruny..] | - | I | eruny |
| Time (Julian daynumber) when hydrological simulation started (Minimum); will be 0.0 when simulation started at 1st of January, 00.00 hour. | - | [0.0..366.0] | - | R | brund-1 |
| Time (Julian daynumber) when hydrological simulation ended (Maximum) | - | [0.0..366.0] | - | R | erund |
| Geometry of model system | |||||
| Number of model compartments | - | [1..numnod] | ∗ | I | numnod |
| Number of horizons | - | [1..numlay] | - | I | numlay |
| Number of drainage systems (value must be 0, 1, 2, 3, 4 or 5) | - | [0..5] | - | I | nrlevs |
| Compartment number of the deepest compartment (bottom) of each horizon/layer | - | [1..numnod] | ∗ | I | botcom(numlay) |
| Volume fraction moisture at Saturation | m3, m-3 | [0.0..1.0] | ∗ | R | thetas (numlay) |
| Volume fraction moisture at Field Capacity | m3, m-3 | [0.0..1.0] | ∗ | R | thetafc(numlay) |
| Volume fraction moisture at Wilting point | m3, m-3 | [0.0..1.0] | ∗ | R | thetawp(numlay) |
| Thickness of compartments | m | [0.001..100.0] | ∗ | R | dz(numnod) |
| Areic volume of static macropores in domain 1 (Main Bypass Flow domain) per compartment 1 … NUMNOD | m3 m-2 | [0.0..] | ∗ | R | VlMpStDm1(numnod) |
| Areic volume of static macropores in domain 2 (Internal Catchment domain) per compartment 1 … NUMNOD | m3 m-2 | [0.0..] | ∗ | R | VlMpStDm2(numnod) |
| Diameter of soil matrix polygones per compartment m [0.001 ... 10.0] * R DiPoCp(numnod) 1 … NUMNOD | m | [0.001..10.0] | ∗ | R | DiPoCp(numnod) |
| Initial conditions | |||||
| Volume fraction moisture initially present in compartments 1 … NUMNOD | m3, m-3 | [0.0 ... 1.0] | ∗ | R | Theta(numnod) |
| Initial groundwaterlevel (negative below soil surface, when positive use Pond) | m-ss | [0.0 ... ] | ∗ | R | Gwl |
| Storage by initial ponding | m | [0.0..] | - | R | Pond |
| Storage by snow | m | [0.0..] | ∗ | R | Ssnow |
| Soil temperature of compartments 1 ... NUMNOD | °C | [-50.0..50.0] | ∗ | R | Tsoil(numnod) |
| Initial conditions for macropores, domain 1 (Main Bypass Flow domain) | |||||
| Water level | m-ss | [0.0..] | ∗ | R | WaLevDm1 |
| Areic volume | m3 m-2 | [0.0..] | - | R | VlMpDm1 |
| Areic volume of water stored | m3 m-2 | [0.0..] | - | R | WaSrDm1 |
| Initial conditions for macropores, domain 2 (Internal Catchment domain) | |||||
| Areic volume | m3 m-2 | [0.0..] | - | R | VlMpDm2 |
| Areic volume of water stored | m3 m-2 | [0.0..] | - | R | WaSrDm2 |
| Dynamic part | |||||
| Time (Julian daynumber) in hydrological model. (1.0 means: 1st of January, 24.00 hour) | - | [0.0..] | ∗ | R | Daycum |
| Stepsize of time-interval for dynamic hydrological data | d | [1.0..30.0] | - | R | period |
| Rainfall water flux | m d,-1, | [0.0..] | - | R | Igrai |
| Snowfall water flux | m d,-1, | [0.0..] | - | R | Igsnow |
| Irrigation flux | m d,-1, | [0.0..] | - | R | Igrid |
| Evaporation flux by interception of precipitation water | m d,-1, | [0.0..] | - | R | Ierai |
| Evaporation flux by interception of irrigation water | m d,-1, | [0.0..] | - | R | Ieirr |
| Sublimation of snow (Evaporation flux) | m d,-1, | [0.0..] | - | R | ISubl |
| Actual evaporation flux by bare soil | m d,-1, | [0.0..] | - | R | Ievap |
| Evaporation flux by ponding | m d,-1, | [0.0] | - | R | Iepnd |
| Potential evaporation flux by soil | m d,-1, | [0.0..] | - | R | Ipeva |
| Potential transpiration flux | m d,-1, | [0.0..] | - | R | Iptra |
| Flux of surface Runon (originates from other source/field) | m d,-1, | [0.0..] | - | R | Irunon |
| Flux of surface Runoff (negative value means inundation) | m d,-1, | [..] | - | R | Iruno |
| Groundwater level at end of time-interval (negative below soil surface, when positive use Pond) | m-ss | [0.0..] | - | R | Gwl |
| Storage by ponding at soil surface at end of time-interval | m | [0.0..] | - | R | Pond |
| Storage by snow at end of time-interval | m | [0.0..] | - | R | SSnow |
| Error in Water Balance | m | [..] | - | R | Wbalance |
| Suction (pressure head) of soil moisture (negative = unsaturated) | cm | [..] | ∗ | R | h(numnod) |
| Volume fraction of moisture at end of time-interval | m3 m-3 | [0.0..1.0] | ∗ | R | theta(numnod) |
| Actual transpiration flux | m d-1 | [0.0..] | ∗ | R | inqrot(numnod) |
| Flux incoming from above (compartments 1 … numnod+1, positive = downward) | m d-1 | [..] | ∗ | R | inq(numnod+1) |
| Flux of drainage system of 1st order (e.g. canal) | m d-1 | [..] | ∗ | R | inqdra(1,numnod) |
| Flux of drainage system of 2nd order (e.g. ditch) | m d-1 | [..] | ∗ | R | inqdra(2,numnod) |
| Flux of drainage system of 3rd order (e.g. trench) | m d-1 | [..] | ∗ | R | inqdra(3,numnod) |
| Flux of drainage system of 4th order (e.g. tube drain) | m d-1 | [..] | ∗ | R | inqdra(4,numnod) |
| Flux of drainage system of 5th order (e.g. rapid drainage) | m d-1 | [..] | ∗ | R | inqdra(5,numnod) |
| Soil cover | m2 m-2 | [0.0..1.0] | ∗ | R | soco |
| LAI | m2 m-2 | [0.0..10.0] | - | R | lai |
| Rooting Depth | m | [0.0...numnnod] | - | R | drz |
| Crop Factor (or crop height) | - or cm | [0.0..] | - | R | cf |
| Average daily air temperature | °C | [-50.0..50.0] | ∗ | R | tav |
| Average daily soil temperature of compartments 1… NUMNOD | °C | [-50.0..50.0] | ∗ | R | Tsoil(numnod) |
| Dynamic part for macropores, domain 1 (Main Bypass Flow domain) | |||||
| Water level at end of time-interval | m-ss | [0.0..] | ∗ | R | WaLevDm1 |
| Areic volume at end of time-interval | m3 m-2 | [0.0..] | - | R | VlMpDm1 |
| Areic volume of water stored at end of time-interval | m3 m-2 | [0.0..] | - | R | WaSrDm1 |
| Infiltration flux at soil surface directly by precipitation | m d-1 | [0.0..] | - | R | IQInTopPreDm1 |
| Infiltration flux at soil surface indirectly by lateral overland flow (runoff) | m d-1 | [0.0..] | - | R | IQInTopLatDm1 |
| Exchange flux with soil matrix per compartment 1-numnod (positive: from macropores into matrix) | m d-1 | [..] | ∗ | R | InQExcMtxDm1Cp(numnod) |
| Rapid drainage flux towards drain tube per compartment 1-numnod | m d-1 | [0.0..] | ∗ | R | InQOutDrRapCp(numnod) |
| Average fraction of macropore wall in contact with macropore water during timestep per comp. 1-numnod | m d-1 | [0.0..] | ∗ | R | FrMpWalWetDm1(numnod) |
| Dynamic part for macropores, domain 2 (Internal Catchment domain) | |||||
| Areic volume at end of time-interval | m3 m-2 | [0. 0 .. ] | ∗ | R | VlMpDm2 |
| Areic volume of water stored at end of time-interval | m3 m-2 | [0. 0 .. ] | - | R | WaSrDm2 |
| Infiltration flux at soil surface directly by precipitation | m d-1 | [0. 0 .. ] | - | R | IQInTopPreDm2 |
| Infiltration flux at soil surface indirectly by lateral overland flow (runoff) | m d-1 | [0. 0 .. ] | - | R | IQInTopLatDm2 |
| Exchange flux with soil matrix per compartment 1-numnod (positive: from macropores into matrix) | m d-1 | [ .. ] | ∗ | R | InQExcMtxDm2Cp(numnod) |
| Average fraction of macropore wall in contact with macropore water during timestep per comp. 1-numnod | m d-1 | [0.0 .. ] | ∗ | R | FrMpWalWetDm2(numnod) |