Tip
Need help? Please let us know in the UMEP Community.
Please report issues with the manual on the GitHub Issues.
Please cite SUEWS with proper information from our Zenodo page.
4. Output files#
4.1. Runtime diagnostic information#
4.1.1. Error messages: problems.txt#
If there are problems running the program serious error messages will be written to problems.txt.
Serious problems will usually cause the program to stop after writing the error message. If this is the case, the last line of Error messages: problems.txt will contain a non-zero number (the error code).
If the program runs successfully, problems.txt file ends with:
Run completed. 0
SUEWS has a large number of error messages included to try to capture common errors to help the user determine what the problem is. If you encounter an error that does not provide an error message please capture the details so we can hopefully provide better error messages in future.
See Troubleshooting section for help solving problems. If the file paths are not correct the program will return an error when run (see Workflow of using SUEWS).
4.1.2. Warning messages: warnings.txt#
If the program encounters a more minor issue it will not stop but a warning may be written to warnings.txt. It is advisable to check the warnings to ensure there is not a more serious problem.
The warnings.txt file can be large (over several GBs) given warning messages are written out during a large scale simulation, you can use
tail
/head
to view the ending/starting part without opening the whole file on Unix-like systems (Linux/mac OS), which may slow down your system.To prevent warnings.txt from being written, set
SuppressWarnings
to 1 in RunControl.nml.Warning messages are usually written with a grid number, timestamp and error count. If the problem occurs in the initial stages (i.e. before grid numbers and timestamps are assigned, these are printed as 00000).
4.1.3. Summary of model parameters: SS_FileChoices.txt#
For each run, the model parameters specified in the input files are written out to the file SS_FileChoices.txt.
4.2. Model output files#
Note
Temporal information in output files (i.e., iy
, id
, it
 and imin
if existing) are in local time (i.e. consistent with Meteorological Input File) and indicate the ending timestamp of corresponding periods: e.g. for hourly data, 2021-09-12 13:00
indicates a record for the period between 2021-09-12 12:00
(inclusive) and 2021-09-12 13:00
(exclusive).
4.2.1. SSss_YYYY_SUEWS_TT.txt#
SUEWS produces the main output file (SSss_YYYY_SUEWS_tt.txt) with time resolution (TT min) set by ResolutionFilesOut
in RunControl.nml.
Before these main data files are written out, SUEWS provides a summary of the column names, units and variables included in the file Ss_YYYY_TT_OutputFormat.txt (one file per run).
The variables included in the main output file are determined according to WriteOutOption
set in RunControl.nml.
Column |
Name |
WriteOutOption |
Description |
---|---|---|---|
1 |
Year |
0,1,2 |
Year [YYYY] |
2 |
DOY |
0,1,2 |
Day of year [DOY] |
3 |
Hour |
0,1,2 |
Hour [H] |
4 |
Min |
0,1,2 |
Minute [M] |
5 |
Dectime |
0,1,2 |
Decimal time [-] |
6 |
Kdown |
0,1,2 |
Incoming shortwave radiation [W m-2] |
7 |
Kup |
0,1,2 |
Outgoing shortwave radiation [W m-2] |
8 |
Ldown |
0,1,2 |
Incoming longwave radiation [W m-2] |
9 |
Lup |
0,1,2 |
Outgoing longwave radiation [W m-2] |
10 |
Tsurf |
0,1,2 |
Bulk surface temperature [°C] |
11 |
QN |
0,1,2 |
Net all-wave radiation [W m-2] |
12 |
QF |
0,1,2 |
Anthropogenic heat flux [W m-2] |
13 |
QS |
0,1,2 |
Storage heat flux [W m-2] |
14 |
QH |
0,1,2 |
Sensible heat flux (calculated using SUEWS) [W m-2] |
15 |
QE |
0,1,2 |
Latent heat flux (calculated using SUEWS) [W m-2] |
16 |
QHlumps |
0,1 |
Sensible heat flux (calculated using LUMPS) [W m-2] |
17 |
QElumps |
0,1 |
Latent heat flux (calculated using LUMPS) [W m-2] |
18 |
QHresis |
0,1 |
Sensible heat flux (calculated using resistance method) [W m-2] |
19 |
Rain |
0,1,2 |
Rain [mm] |
20 |
Irr |
0,1,2 |
Irrigation [mm] |
21 |
Evap |
0,1,2 |
Evaporation [mm] |
22 |
RO |
0,1,2 |
Runoff [mm] |
23 |
TotCh |
0,1,2 |
Change in surface and soil moisture stores [mm] |
24 |
SurfCh |
0,1,2 |
Change in surface moisture store [mm] |
25 |
State |
0,1,2 |
Surface wetness state [mm] |
26 |
NWtrState |
0,1,2 |
Surface wetness state (for non-water surfaces) [mm] |
27 |
Drainage |
0,1,2 |
Drainage [mm] |
28 |
SMD |
0,1,2 |
Soil moisture deficit [mm] |
29 |
FlowCh |
0,1 |
Additional flow into water body [mm] |
30 |
AddWater |
0,1 |
Additional water flow received from other grids [mm] |
31 |
ROSoil |
0,1 |
Runoff to soil (sub-surface) [mm] |
32 |
ROPipe |
0,1 |
Runoff to pipes [mm] |
33 |
ROImp |
0,1 |
Above ground runoff over impervious surfaces [mm] |
34 |
ROVeg |
0,1 |
Above ground runoff over vegetated surfaces [mm] |
35 |
ROWater |
0,1 |
Runoff for water body [mm] |
36 |
WUInt |
0,1 |
Internal water use [mm] |
37 |
WUEveTr |
0,1 |
Water use for irrigation of evergreen trees [mm] |
38 |
WUDecTr |
0,1 |
Water use for irrigation of deciduous trees [mm] |
39 |
WUGrass |
0,1 |
Water use for irrigation of grass [mm] |
40 |
SMDPaved |
0,1 |
Soil moisture deficit for paved surface [mm] |
41 |
SMDBldgs |
0,1 |
Soil moisture deficit for building surface [mm] |
42 |
SMDEveTr |
0,1 |
Soil moisture deficit for evergreen surface [mm] |
43 |
SMDDecTr |
0,1 |
Soil moisture deficit for deciduous surface [mm] |
44 |
SMDGrass |
0,1 |
Soil moisture deficit for grass surface [mm] |
45 |
SMDBSoil |
0,1 |
Soil moisture deficit for bare soil surface [mm] |
46 |
StPaved |
0,1 |
Surface wetness state for paved surface [mm] |
47 |
StBldgs |
0,1 |
Surface wetness state for building surface [mm] |
48 |
StEveTr |
0,1 |
Surface wetness state for evergreen tree surface [mm] |
49 |
StDecTr |
0,1 |
Surface wetness state for deciduous tree surface [mm] |
50 |
StGrass |
0,1 |
Surface wetness state for grass surface [mm] |
51 |
StBSoil |
0,1 |
Surface wetness state for bare soil surface [mm] |
52 |
StWater |
0,1 |
Surface wetness state for water surface [mm] |
53 |
Zenith |
0,1,2 |
Solar zenith angle [°] |
54 |
Azimuth |
0,1,2 |
Solar azimuth angle [°] |
55 |
AlbBulk |
0,1,2 |
Bulk albedo [-] |
56 |
Fcld |
0,1,2 |
Cloud fraction [-] |
57 |
LAI |
0,1,2 |
Leaf area index [m 2 m-2] |
58 |
z0m |
0,1 |
Roughness length for momentum [m] |
59 |
zdm |
0,1 |
Zero-plane displacement height [m] |
60 |
ustar |
0,1,2 |
Friction velocity [m s-1] |
61 |
Lob |
0,1,2 |
Obukhov length [m] |
62 |
RA |
0,1 |
Aerodynamic resistance [s m-1] |
63 |
RS |
0,1 |
Surface resistance [s m-1] |
64 |
Fc |
0,1,2 |
CO2 flux [umol m-2 s-1] |
65 |
FcPhoto |
0,1 |
CO2 flux from photosynthesis [umol m-2 s-1] |
66 |
FcRespi |
0,1 |
CO2 flux from respiration [umol m-2 s-1] |
67 |
FcMetab |
0,1 |
CO2 flux from metabolism [umol m-2 s-1] |
68 |
FcTraff |
0,1 |
CO2 flux from traffic [umol m-2 s-1] |
69 |
FcBuild |
0,1 |
CO2 flux from buildings [umol m-2 s-1] |
70 |
FcPoint |
0,1 |
CO2 flux from point source [umol m-2 s-1] |
71 |
QNSnowFr |
1 |
Net all-wave radiation for snow-free area [W m-2] |
72 |
QNSnow |
1 |
Net all-wave radiation for snow area [W m-2] |
73 |
AlbSnow |
1 |
Snow albedo [-] |
74 |
QM |
1 |
Snow-related heat exchange [W m-2] |
75 |
QMFreeze |
1 |
Internal energy change [W m-2] |
76 |
QMRain |
1 |
Heat released by rain on snow [W m-2] |
77 |
SWE |
1 |
Snow water equivalent [mm] |
78 |
MeltWater |
1 |
Meltwater [mm] |
79 |
MeltWStore |
1 |
Meltwater store [mm] |
80 |
SnowCh |
1 |
Change in snow pack [mm] |
81 |
SnowRPaved |
1 |
Snow removed from paved surface [mm] |
82 |
SnowRBldgs |
1 |
Snow removed from building surface [mm] |
83 |
Ts |
0,1,2 |
Skin temperature [°C] |
84 |
T2 |
0,1,2 |
Air temperature at 2 m agl [°C] |
85 |
Q2 |
0,1,2 |
Air specific humidity at 2 m agl [g kg-1] |
86 |
U10 |
0,1,2 |
Wind speed at 10 m agl [m s-1] |
87 |
RH2 |
0,1,2 |
Relative humidity at 2 m agl [%] |
4.2.2. SSss_DailyState.txt#
Contains information about the state of the surface and soil and vegetation parameters at a time resolution of one day. One file is written for each grid so it may contain multiple years.
Column |
Name |
Description |
---|---|---|
1 |
Year |
Year [YYYY] |
2 |
DOY |
Day of year [DOY] |
3 |
Hour |
Hour of the last timestep of a day [HH] |
4 |
Min |
Minute of the last timestep of a day [MM] |
5 |
HDD1_h |
Heating degree days [°C d] |
6 |
HDD2_c |
Cooling degree days [°C d] |
7 |
HDD3_Tmean |
Average daily air temperature in forcing data [°C] |
8 |
HDD4_T5d |
5-day running-mean air temperature in forcing data [°C] |
9 |
P_day |
Daily total precipitation [mm] |
10 |
DaysSR |
Days since rain [days] |
11 |
GDD_EveTr |
Growing degree days for evergreen tree [°C d] |
12 |
GDD_DecTr |
Growing degree days for deciduous tree [°C d] |
13 |
GDD_Grass |
Growing degree days for grass [°C d] |
14 |
SDD_EveTr |
Senescence degree days for evergreen tree [°C d] |
15 |
SDD_DecTr |
Senescence degree days for deciduous tree [°C d] |
16 |
SDD_Grass |
Senescence degree days for grass [°C d] |
17 |
Tmin |
Daily minimum temperature in forcing data [°C] |
18 |
Tmax |
Daily maximum temperature in forcing data [°C] |
19 |
DLHrs |
Day length [h] |
20 |
LAI_EveTr |
Leaf area index of evergreen trees [m-2 m-2] |
21 |
LAI_DecTr |
Leaf area index of deciduous trees [m-2 m-2] |
22 |
LAI_Grass |
Leaf area index of grass [m-2 m-2] |
23 |
DecidCap |
Moisture storage capacity of deciduous trees [mm] |
24 |
Porosity |
Porosity of deciduous trees [-] |
25 |
AlbEveTr |
Albedo of evergreen trees [-] |
26 |
AlbDecTr |
Albedo of deciduous trees [-] |
27 |
AlbGrass |
Albedo of grass [-] |
28 |
WU_EveTr1 |
Total water use for evergreen trees [mm] |
29 |
WU_EveTr2 |
Automatic water use for evergreen trees [mm] |
30 |
WU_EveTr3 |
Manual water use for evergreen trees [mm] |
31 |
WU_DecTr1 |
Total water use for deciduous trees [mm] |
32 |
WU_DecTr2 |
Automatic water use for deciduous trees [mm] |
33 |
WU_DecTr3 |
Manual water use for deciduous trees [mm] |
34 |
WU_Grass1 |
Total water use for grass [mm] |
35 |
WU_Grass2 |
Automatic water use for grass [mm] |
36 |
WU_Grass3 |
Manual water use for grass [mm] |
37 |
LAIlumps |
Leaf area index used in LUMPS (normalised 0-1) [-] |
38 |
AlbSnow |
Snow albedo [-] |
39 |
DensSnow_Paved |
Snow density - paved surface [kg m-3] |
40 |
DensSnow_Bldgs |
Snow density - building surface [kg m-3] |
41 |
DensSnow_EveTr |
Snow density - evergreen surface [kg m-3] |
42 |
DensSnow_DecTr |
Snow density - deciduous surface [kg m-3] |
43 |
DensSnow_Grass |
Snow density - grass surface [kg m-3] |
44 |
DensSnow_BSoil |
Snow density - bare soil surface [kg m-3] |
45 |
DensSnow_Water |
Snow density - water surface [kg m-3] |
46 |
a1 |
OHM cofficient a1 - [-] |
47 |
a2 |
OHM cofficient a2 [W m-2 h-1] |
48 |
a3 |
OHM cofficient a3 - [W m-2] |
4.2.3. InitialConditionsSSss_YYYY.nml#
At the end of the model run (or the end of each year in the model run) a new InitialConditions file is written out (to the input folder) for each grid, see Initial Conditions file
4.2.4. SSss_YYYY_snow_TT.txt#
SUEWS produces a separate output file for snow (when SnowUse
= 1 in RunControl.nml) with details for each surface type.
File format of SSss_YYYY_snow_TT.txt
Column |
Name |
Description |
---|---|---|
1 |
iy |
Year [YYYY] |
2 |
id |
Day of year [DOY] |
3 |
it |
Hour [H] |
4 |
imin |
Minute [M] |
5 |
dectime |
Decimal time [-] |
6 |
SWE_Paved |
Snow water equivalent – paved surface [mm] |
7 |
SWE_Bldgs |
Snow water equivalent – building surface [mm] |
8 |
SWE_EveTr |
Snow water equivalent – evergreen surface [mm] |
9 |
SWE_DecTr |
Snow water equivalent – deciduous surface [mm] |
10 |
SWE_Grass |
Snow water equivalent – grass surface [mm] |
11 |
SWE_BSoil |
Snow water equivalent – bare soil surface [mm] |
12 |
SWE_Water |
Snow water equivalent – water surface [mm] |
13 |
Mw_Paved |
Meltwater – paved surface [mm h-1] |
14 |
Mw_Bldgs |
Meltwater – building surface [mm h-1] |
15 |
Mw_EveTr |
Meltwater – evergreen surface [mm h-1] |
16 |
Mw_DecTr |
Meltwater – deciduous surface [mm h-1] |
17 |
Mw_Grass |
Meltwater – grass surface [mm h-1 1] |
18 |
Mw_BSoil |
Meltwater – bare soil surface [mm h-1] |
19 |
Mw_Water |
Meltwater – water surface [mm h-1] |
20 |
Qm_Paved |
Snowmelt-related heat – paved surface [W m-2] |
21 |
Qm_Bldgs |
Snowmelt-related heat – building surface [W m-2] |
22 |
Qm_EveTr |
Snowmelt-related heat – evergreen surface [W m-2] |
23 |
Qm_DecTr |
Snowmelt-related heat – deciduous surface [W m-2] |
24 |
Qm_Grass |
Snowmelt-related heat – grass surface [W m-2] |
25 |
Qm_BSoil |
Snowmelt-related heat – bare soil surface [W m-2] |
26 |
Qm_Water |
Snowmelt-related heat – water surface [W m-2] |
27 |
Qa_Paved |
Advective heat – paved surface [W m-2] |
28 |
Qa_Bldgs |
Advective heat – building surface [W m-2] |
29 |
Qa_EveTr |
Advective heat – evergreen surface [W m-2] |
30 |
Qa_DecTr |
Advective heat – deciduous surface [W m-2] |
31 |
Qa_Grass |
Advective heat – grass surface [W m-2] |
32 |
Qa_BSoil |
Advective heat – bare soil surface [W m-2] |
33 |
Qa_Water |
Advective heat – water surface [W m-2] |
34 |
QmFr_Paved |
Heat related to freezing of surface store – paved surface [W m-2] |
35 |
QmFr_Bldgs |
Heat related to freezing of surface store – building surface [W m-2] |
36 |
QmFr_EveTr |
Heat related to freezing of surface store – evergreen surface [W m-2] |
37 |
QmFr_DecTr |
Heat related to freezing of surface store – deciduous surface [W m-2] |
38 |
QmFr_Grass |
Heat related to freezing of surface store – grass surface [W m-2] |
39 |
QmFr_BSoil |
Heat related to freezing of surface store – bare soil surface [W m-2] |
40 |
QmFr_Water |
Heat related to freezing of surface store – water [W m-2] |
41 |
fr_Paved |
Fraction of snow – paved surface [-] |
42 |
fr_Bldgs |
Fraction of snow – building surface [-] |
43 |
fr_EveTr |
Fraction of snow – evergreen surface [-] |
44 |
fr_DecTr |
Fraction of snow – deciduous surface [-] |
45 |
fr_Grass |
Fraction of snow – grass surface [-] |
46 |
Fr_BSoil |
Fraction of snow – bare soil surface [-] |
47 |
RainSn_Paved |
Rain on snow – paved surface [mm] |
48 |
RainSn_Bldgs |
Rain on snow – building surface [mm] |
49 |
RainSn_EveTr |
Rain on snow – evergreen surface [mm] |
50 |
RainSn_DecTr |
Rain on snow – deciduous surface [mm] |
51 |
RainSn_Grass |
Rain on snow – grass surface [mm] |
52 |
RainSn_BSoil |
Rain on snow – bare soil surface [mm] |
53 |
RainSn_Water |
Rain on snow – water surface [mm] |
54 |
qn_PavedSnow |
Net all-wave radiation – paved surface [W m-2] |
55 |
qn_BldgsSnow |
Net all-wave radiation – building surface [W m-2] |
56 |
qn_EveTrSnow |
Net all-wave radiation – evergreen surface [W m-2] |
57 |
qn_DecTrSnow |
Net all-wave radiation – deciduous surface [W m-2] |
58 |
qn_GrassSnow |
Net all-wave radiation – grass surface [W m-2] |
59 |
qn_BSoilSnow |
Net all-wave radiation – bare soil surface [W m-2] |
60 |
qn_WaterSnow |
Net all-wave radiation – water surface [W m-2] |
61 |
kup_PavedSnow |
Reflected shortwave radiation – paved surface [W m-2] |
62 |
kup_BldgsSnow |
Reflected shortwave radiation – building surface [W m-2] |
63 |
kup_EveTrSnow |
Reflected shortwave radiation – evergreen surface [W m-2] |
64 |
kup_DecTrSnow |
Reflected shortwave radiation – deciduous surface [W m-2] |
65 |
kup_GrassSnow |
Reflected shortwave radiation – grass surface [W m-2] |
66 |
kup_BSoilSnow |
Reflected shortwave radiation – bare soil surface [W m-2] |
67 |
kup_WaterSnow |
Reflected shortwave radiation – water surface [W m-2] |
68 |
frMelt_Paved |
Amount of freezing melt water – paved surface [mm] |
69 |
frMelt_Bldgs |
Amount of freezing melt water – building surface [mm] |
70 |
frMelt_EveTr |
Amount of freezing melt water – evergreen surface [mm] |
71 |
frMelt_DecTr |
Amount of freezing melt water – deciduous surface [mm] |
72 |
frMelt_Grass |
Amount of freezing melt water – grass surface [mm] |
73 |
frMelt_BSoil |
Amount of freezing melt water – bare soil surface [mm] |
74 |
frMelt_Water |
Amount of freezing melt water – water surface [mm] |
75 |
MwStore_Paved |
Melt water store – paved surface [mm] |
76 |
MwStore_Bldgs |
Melt water store – building surface [mm] |
77 |
MwStore_EveTr |
Melt water store – evergreen surface [mm] |
78 |
MwStore_DecTr |
Melt water store – deciduous surface [mm] |
79 |
MwStore_Grass |
Melt water store – grass surface [mm] |
80 |
MwStore_BSoil |
Melt water store – bare soil surface [mm] |
81 |
MwStore_Water |
Melt water store – water surface [mm] |
82 |
DensSnow_Paved |
Snow density – paved surface [kg m-3] |
83 |
DensSnow_Bldgs |
Snow density – building surface [kg m-3] |
84 |
DensSnow_EveTr |
Snow density – evergreen surface [kg m-3] |
85 |
DensSnow_DecTr |
Snow density – deciduous surface [kg m-3] |
86 |
DensSnow_Grass |
Snow density – grass surface [kg m-3] |
87 |
DensSnow_BSoil |
Snow density – bare soil surface [kg m-3] |
88 |
DensSnow_Water |
Snow density – water surface [kg m-3] |
89 |
Sd_Paved |
Snow depth – paved surface [mm] |
90 |
Sd_Bldgs |
Snow depth – building surface [mm] |
91 |
Sd_EveTr |
Snow depth – evergreen surface [mm] |
92 |
Sd_DecTr |
Snow depth – deciduous surface [mm] |
93 |
Sd_Grass |
Snow depth – grass surface [mm] |
94 |
Sd_BSoil |
Snow depth – bare soil surface [mm] |
95 |
Sd_Water |
Snow depth – water surface [mm] |
96 |
Tsnow_Paved |
Snow surface temperature – paved surface [°C] |
97 |
Tsnow_Bldgs |
Snow surface temperature – building surface [°C] |
98 |
Tsnow_EveTr |
Snow surface temperature – evergreen surface [°C] |
99 |
Tsnow_DecTr |
Snow surface temperature – deciduous surface [°C] |
100 |
Tsnow_Grass |
Snow surface temperature – grass surface [°C] |
101 |
Tsnow_BSoil |
Snow surface temperature – bare soil surface [°C] |
102 |
Tsnow_Water |
Snow surface temperature – water surface [°C] |
4.2.5. SSss_YYYY_RSL_TT.txt#
SUEWS produces a separate output file for wind, temperature and humidity profiles in the roughness sublayer at 30 levels (see Wind, Temperature and Humidity Profiles in the Roughness Sublayer level details).
File format of SSss_YYYY_RSL_TT.txt:
Column |
Name |
Description |
---|---|---|
1 |
Year |
Year [YYYY] |
2 |
DOY |
Day of year [DOY] |
3 |
Hour |
Hour [H] |
4 |
Min |
Minute [M] |
5 |
Dectime |
Decimal time [-] |
6 |
z_1 |
Height at level 1 [m] |
7 |
z_2 |
Height at level 2 [m] |
8 |
z_3 |
Height at level 3 [m] |
9 |
z_4 |
Height at level 4 [m] |
10 |
z_5 |
Height at level 5 [m] |
11 |
z_6 |
Height at level 6 [m] |
12 |
z_7 |
Height at level 7 [m] |
13 |
z_8 |
Height at level 8 [m] |
14 |
z_9 |
Height at level 9 [m] |
15 |
z_10 |
Height at level 10 [m] |
16 |
z_11 |
Height at level 11 [m] |
17 |
z_12 |
Height at level 12 [m] |
18 |
z_13 |
Height at level 13 [m] |
19 |
z_14 |
Height at level 14 [m] |
20 |
z_15 |
Height at level 15 [m] |
21 |
z_16 |
Height at level 16 [m] |
22 |
z_17 |
Height at level 17 [m] |
23 |
z_18 |
Height at level 18 [m] |
24 |
z_19 |
Height at level 19 [m] |
25 |
z_20 |
Height at level 20 [m] |
26 |
z_21 |
Height at level 21 [m] |
27 |
z_22 |
Height at level 22 [m] |
28 |
z_23 |
Height at level 23 [m] |
29 |
z_24 |
Height at level 24 [m] |
30 |
z_25 |
Height at level 25 [m] |
31 |
z_26 |
Height at level 26 [m] |
32 |
z_27 |
Height at level 27 [m] |
33 |
z_28 |
Height at level 28 [m] |
34 |
z_29 |
Height at level 29 [m] |
35 |
z_30 |
Height at level 30 [m] |
36 |
U_1 |
Wind speed at level 1 [m s-1] |
37 |
U_2 |
Wind speed at level 2 [m s-1] |
38 |
U_3 |
Wind speed at level 3 [m s-1] |
39 |
U_4 |
Wind speed at level 4 [m s-1] |
40 |
U_5 |
Wind speed at level 5 [m s-1] |
41 |
U_6 |
Wind speed at level 6 [m s-1] |
42 |
U_7 |
Wind speed at level 7 [m s-1] |
43 |
U_8 |
Wind speed at level 8 [m s-1] |
44 |
U_9 |
Wind speed at level 9 [m s-1] |
45 |
U_10 |
Wind speed at level 10 [m s-1] |
46 |
U_11 |
Wind speed at level 11 [m s-1] |
47 |
U_12 |
Wind speed at level 12 [m s-1] |
48 |
U_13 |
Wind speed at level 13 [m s-1] |
49 |
U_14 |
Wind speed at level 14 [m s-1] |
50 |
U_15 |
Wind speed at level 15 [m s-1] |
51 |
U_16 |
Wind speed at level 16 [m s-1] |
52 |
U_17 |
Wind speed at level 17 [m s-1] |
53 |
U_18 |
Wind speed at level 18 [m s-1] |
54 |
U_19 |
Wind speed at level 19 [m s-1] |
55 |
U_20 |
Wind speed at level 20 [m s-1] |
56 |
U_21 |
Wind speed at level 21 [m s-1] |
57 |
U_22 |
Wind speed at level 22 [m s-1] |
58 |
U_23 |
Wind speed at level 23 [m s-1] |
59 |
U_24 |
Wind speed at level 24 [m s-1] |
60 |
U_25 |
Wind speed at level 25 [m s-1] |
61 |
U_26 |
Wind speed at level 26 [m s-1] |
62 |
U_27 |
Wind speed at level 27 [m s-1] |
63 |
U_28 |
Wind speed at level 28 [m s-1] |
64 |
U_29 |
Wind speed at level 29 [m s-1] |
65 |
U_30 |
Wind speed at level 30 [m s-1] |
66 |
T_1 |
Air temperature at level 1 [°C] |
67 |
T_2 |
Air temperature at level 2 [°C] |
68 |
T_3 |
Air temperature at level 3 [°C] |
69 |
T_4 |
Air temperature at level 4 [°C] |
70 |
T_5 |
Air temperature at level 5 [°C] |
71 |
T_6 |
Air temperature at level 6 [°C] |
72 |
T_7 |
Air temperature at level 7 [°C] |
73 |
T_8 |
Air temperature at level 8 [°C] |
74 |
T_9 |
Air temperature at level 9 [°C] |
75 |
T_10 |
Air temperature at level 10 [°C] |
76 |
T_11 |
Air temperature at level 11 [°C] |
77 |
T_12 |
Air temperature at level 12 [°C] |
78 |
T_13 |
Air temperature at level 13 [°C] |
79 |
T_14 |
Air temperature at level 14 [°C] |
80 |
T_15 |
Air temperature at level 15 [°C] |
81 |
T_16 |
Air temperature at level 16 [°C] |
82 |
T_17 |
Air temperature at level 17 [°C] |
83 |
T_18 |
Air temperature at level 18 [°C] |
84 |
T_19 |
Air temperature at level 19 [°C] |
85 |
T_20 |
Air temperature at level 20 [°C] |
86 |
T_21 |
Air temperature at level 21 [°C] |
87 |
T_22 |
Air temperature at level 22 [°C] |
88 |
T_23 |
Air temperature at level 23 [°C] |
89 |
T_24 |
Air temperature at level 24 [°C] |
90 |
T_25 |
Air temperature at level 25 [°C] |
91 |
T_26 |
Air temperature at level 26 [°C] |
92 |
T_27 |
Air temperature at level 27 [°C] |
93 |
T_28 |
Air temperature at level 28 [°C] |
94 |
T_29 |
Air temperature at level 29 [°C] |
95 |
T_30 |
Air temperature at level 30 [°C] |
96 |
q_1 |
Specific humidity at level 1 [g kg-1] |
97 |
q_2 |
Specific humidity at level 2 [g kg-1] |
98 |
q_3 |
Specific humidity at level 3 [g kg-1] |
99 |
q_4 |
Specific humidity at level 4 [g kg-1] |
100 |
q_5 |
Specific humidity at level 5 [g kg-1] |
101 |
q_6 |
Specific humidity at level 6 [g kg-1] |
102 |
q_7 |
Specific humidity at level 7 [g kg-1] |
103 |
q_8 |
Specific humidity at level 8 [g kg-1] |
104 |
q_9 |
Specific humidity at level 9 [g kg-1] |
105 |
q_10 |
Specific humidity at level 10 [g kg-1] |
106 |
q_11 |
Specific humidity at level 11 [g kg-1] |
107 |
q_12 |
Specific humidity at level 12 [g kg-1] |
108 |
q_13 |
Specific humidity at level 13 [g kg-1] |
109 |
q_14 |
Specific humidity at level 14 [g kg-1] |
110 |
q_15 |
Specific humidity at level 15 [g kg-1] |
111 |
q_16 |
Specific humidity at level 16 [g kg-1] |
112 |
q_17 |
Specific humidity at level 17 [g kg-1] |
113 |
q_18 |
Specific humidity at level 18 [g kg-1] |
114 |
q_19 |
Specific humidity at level 19 [g kg-1] |
115 |
q_20 |
Specific humidity at level 20 [g kg-1] |
116 |
q_21 |
Specific humidity at level 21 [g kg-1] |
117 |
q_22 |
Specific humidity at level 22 [g kg-1] |
118 |
q_23 |
Specific humidity at level 23 [g kg-1] |
119 |
q_24 |
Specific humidity at level 24 [g kg-1] |
120 |
q_25 |
Specific humidity at level 25 [g kg-1] |
121 |
q_26 |
Specific humidity at level 26 [g kg-1] |
122 |
q_27 |
Specific humidity at level 27 [g kg-1] |
123 |
q_28 |
Specific humidity at level 28 [g kg-1] |
124 |
q_29 |
Specific humidity at level 29 [g kg-1] |
125 |
q_30 |
Specific humidity at level 30 [g kg-1] |
4.2.6. SSss_YYYY_BL_TT.txt#
Meteorological variables modelled by CBL portion of the model are output in to this file created for each day with time step (see CBL input files).
Column |
Name |
Description |
Units |
---|---|---|---|
1 |
iy |
Year [YYYY] |
|
2 |
id |
Day of year [DoY] |
|
3 |
it |
Hour [H] |
|
4 |
imin |
Minute [M] |
|
5 |
dectime |
Decimal time [-] |
|
6 |
zi |
Convectibe boundary layer height |
m |
7 |
Theta |
Potential temperature in the inertial sublayer |
K |
8 |
Q |
Specific humidity in the inertial sublayer |
g kg-1 |
9 |
theta+ |
Potential temperature just above the CBL |
K |
10 |
q+ |
Specific humidity just above the CBL |
g kg-1 |
11 |
Temp_C |
Air temperature |
°C |
12 |
RH |
Relative humidity |
% |
13 |
QH_use |
Sensible heat flux used for calculation |
W m-2 |
14 |
QE_use |
Latent heat flux used for calculation |
W m-2 |
15 |
Press_hPa |
Pressure used for calculation |
hPa |
16 |
avu1 |
Wind speed used for calculation |
m s-1 |
17 |
ustar |
Friction velocity used for calculation |
m s-1 |
18 |
avdens |
Air density used for calculation |
kg m-3 |
19 |
lv_J_kg |
Latent heat of vaporization used for calculation |
J kg-1 |
20 |
avcp |
Specific heat capacity used for calculation |
J kg-1 K-1 |
21 |
gamt |
Vertical gradient of potential temperature |
K m-1 |
22 |
gamq |
Vertical gradient of specific humidity |
kg kg-1 m-1 |
4.2.7. SSss_YYYY_ESTM_TT.txt#
If the ESTM model option is run, the following output file is created.
Note
First time steps of storage output could give NaN values during the initial converging phase.
ESTM output file format
Column |
Name |
Description |
Units |
---|---|---|---|
1 |
iy |
Year |
|
2 |
id |
Day of year |
|
3 |
it |
Hour |
|
4 |
imin |
Minute |
|
5 |
dectime |
Decimal time |
|
6 |
QSnet |
Net storage heat flux (QSwall+QSground+QS) |
W m-2 |
7 |
QSair |
Storage heat flux into air |
W m-2 |
8 |
QSwall |
Storage heat flux into wall |
W m-2 |
9 |
QSroof |
Storage heat flux into roof |
W m-2 |
10 |
QSground |
Storage heat flux into ground |
W m-2 |
11 |
QSibld |
Storage heat flux into internal elements in buildling |
W m-2 |
12 |
Twall1 |
Temperature in the first layer of wall (outer-most) |
K |
13 |
Twall2 |
Temperature in the first layer of wall |
K |
14 |
Twall3 |
Temperature in the first layer of wall |
K |
15 |
Twall4 |
Temperature in the first layer of wall |
K |
16 |
Twall5 |
Temperature in the first layer of wall (inner-most) |
K |
17 |
Troof1 |
Temperature in the first layer of roof (outer-most) |
K |
18 |
Troof2 |
Temperature in the first layer of roof |
K |
19 |
Troof3 |
Temperature in the first layer of roof |
K |
20 |
Troof4 |
Temperature in the first layer of roof |
K |
21 |
Troof5 |
Temperature in the first layer of ground (inner-most) |
K |
22 |
Tground1 |
Temperature in the first layer of ground (outer-most) |
K |
23 |
Tground2 |
Temperature in the first layer of ground |
K |
24 |
Tground3 |
Temperature in the first layer of ground |
K |
25 |
Tground4 |
Temperature in the first layer of ground |
K |
26 |
Tground5 |
Temperature in the first layer of ground (inner-most) |
K |
27 |
Tibld1 |
Temperature in the first layer of internal elements |
K |
28 |
Tibld2 |
Temperature in the first layer of internal elements |
K |
29 |
Tibld3 |
Temperature in the first layer of internal elements |
K |
30 |
Tibld4 |
Temperature in the first layer of internal elements |
K |
31 |
Tibld5 |
Temperature in the first layer of internal elements |
K |
32 |
Tabld |
Air temperature in buildings |
K |
4.2.8. SSss_YYYY_SPARTACUS_TT.txt#
If the SPARTACUS model option is run, the following output file is created.
SPARTACUS output file format
Column |
Name |
Description |
|
---|---|---|---|
1 |
Year |
Year [YYYY] |
|
2 |
DOY |
Day of year [DOY] |
|
3 |
Hour |
Hour [H] |
|
4 |
Min |
Minute [M] |
|
5 |
Dectime |
Decimal time [-] |
|
6 |
alb |
Albedo at top-of-canopy. Average of diffuse and direct albedos weighted by the amount of diffuse and direct shortwave radiation. |
|
7 |
emis |
Emissivity at top-of-canopy |
|
8 |
Lemission |
Longwave upward emission at top-of-canopy [W m-2] |
|
9 |
Lup |
Longwave upward (emission+reflected) at top-of-canopy [W m-2] |
|
10 |
Kup |
Shortwave upward (reflected) at top-of-canopy [W m-2] |
|
11 |
Qn |
Net all-wave radiation at top-of-canopy [W m-2] |
|
12 |
LCAAbs1 |
Longwave absorption rate in clear-air part of layer 1 [W m-2] |
|
13 |
LCAAbs2 |
Longwave absorption rate in clear-air part of layer 2 [W m-2] |
|
14 |
LCAAbs3 |
Longwave absorption rate in clear-air part of layer 3 [W m-2] |
|
15 |
LCAAbs4 |
Longwave absorption rate in clear-air part of layer 4 [W m-2] |
|
16 |
LCAAbs5 |
Longwave absorption rate in clear-air part of layer 5 [W m-2] |
|
17 |
LCAAbs6 |
Longwave absorption rate in clear-air part of layer 6 [W m-2] |
|
18 |
LCAAbs7 |
Longwave absorption rate in clear-air part of layer 7 [W m-2] |
|
19 |
LCAAbs8 |
Longwave absorption rate in clear-air part of layer 8 [W m-2] |
|
20 |
LCAAbs9 |
Longwave absorption rate in clear-air part of layer 9 [W m-2] |
|
21 |
LCAAbs10 |
Longwave absorption rate in clear-air part of layer 10 [W m-2] |
|
22 |
LCAAbs11 |
Longwave absorption rate in clear-air part of layer 11 [W m-2] |
|
23 |
LCAAbs12 |
Longwave absorption rate in clear-air part of layer 12 [W m-2] |
|
24 |
LCAAbs13 |
Longwave absorption rate in clear-air part of layer 13 [W m-2] |
|
25 |
LCAAbs14 |
Longwave absorption rate in clear-air part of layer 14 [W m-2] |
|
26 |
LCAAbs15 |
Longwave absorption rate in clear-air part of layer 15 [W m-2] |
|
27 |
LWallNet1 |
Net longwave flux into walls in layer 1 [W m-2] |
|
28 |
LWallNet2 |
Net longwave flux into walls in layer 2 [W m-2] |
|
29 |
LWallNet3 |
Net longwave flux into walls in layer 3 [W m-2] |
|
30 |
LWallNet4 |
Net longwave flux into walls in layer 4 [W m-2] |
|
31 |
LWallNet5 |
Net longwave flux into walls in layer 5 [W m-2] |
|
32 |
LWallNet6 |
Net longwave flux into walls in layer 6 [W m-2] |
|
33 |
LWallNet7 |
Net longwave flux into walls in layer 7 [W m-2] |
|
34 |
LWallNet8 |
Net longwave flux into walls in layer 8 [W m-2] |
|
35 |
LWallNet9 |
Net longwave flux into walls in layer 9 [W m-2] |
|
36 |
LWallNet10 |
Net longwave flux into walls in layer 10 [W m-2] |
|
37 |
LWallNet11 |
Net longwave flux into walls in layer 11 [W m-2] |
|
38 |
LWallNet12 |
Net longwave flux into walls in layer 12 [W m-2] |
|
39 |
LWallNet13 |
Net longwave flux into walls in layer 13 [W m-2] |
|
40 |
LWallNet14 |
Net longwave flux into walls in layer 14 [W m-2] |
|
41 |
LWallNet15 |
Net longwave flux into walls in layer 15 [W m-2] |
|
42 |
LRfNet1 |
Net longwave flux into roofs in layer 1 [W m-2] |
|
43 |
LRfNet2 |
Net longwave flux into roofs in layer 2 [W m-2] |
|
44 |
LRfNet3 |
Net longwave flux into roofs in layer 3 [W m-2] |
|
45 |
LRfNet4 |
Net longwave flux into roofs in layer 4 [W m-2] |
|
46 |
LRfNet5 |
Net longwave flux into roofs in layer 5 [W m-2] |
|
47 |
LRfNet6 |
Net longwave flux into roofs in layer 6 [W m-2] |
|
48 |
LRfNet7 |
Net longwave flux into roofs in layer 7 [W m-2] |
|
49 |
LRfNet8 |
Net longwave flux into roofs in layer 8 [W m-2] |
|
50 |
LRfNet9 |
Net longwave flux into roofs in layer 9 [W m-2] |
|
51 |
LRfNet10 |
Net longwave flux into roofs in layer 10 [W m-2] |
|
52 |
LRfNet11 |
Net longwave flux into roofs in layer 11 [W m-2] |
|
53 |
LRfNet12 |
Net longwave flux into roofs in layer 12 [W m-2] |
|
54 |
LRfNet13 |
Net longwave flux into roofs in layer 13 [W m-2] |
|
55 |
LRfNet14 |
Net longwave flux into roofs in layer 14 [W m-2] |
|
56 |
LRfNet15 |
Net longwave flux into roofs in layer 15 [W m-2] |
|
57 |
LRfIn1 |
Longwave flux into roofs in layer 1 [W m-2] |
|
58 |
LRfIn2 |
Longwave flux into roofs in layer 2 [W m-2] |
|
59 |
LRfIn3 |
Longwave flux into roofs in layer 3 [W m-2] |
|
60 |
LRfIn4 |
Longwave flux into roofs in layer 4 [W m-2] |
|
61 |
LRfIn5 |
Longwave flux into roofs in layer 5 [W m-2] |
|
62 |
LRfIn6 |
Longwave flux into roofs in layer 6 [W m-2] |
|
63 |
LRfIn7 |
Longwave flux into roofs in layer 7 [W m-2] |
|
64 |
LRfIn8 |
Longwave flux into roofs in layer 8 [W m-2] |
|
65 |
LRfIn9 |
Longwave flux into roofs in layer 9 [W m-2] |
|
66 |
LRfIn10 |
Longwave flux into roofs in layer 10 [W m-2] |
|
67 |
LRfIn11 |
Longwave flux into roofs in layer 11 [W m-2] |
|
68 |
LRfIn12 |
Longwave flux into roofs in layer 12 [W m-2] |
|
69 |
LRfIn13 |
Longwave flux into roofs in layer 13 [W m-2] |
|
70 |
LRfIn14 |
Longwave flux into roofs in layer 14 [W m-2] |
|
71 |
LRfIn15 |
Longwave flux into roofs in layer 15 [W m-2] |
|
72 |
LTopNet |
Top-of-canopy net longwave flux [W m-2] |
|
73 |
LGrndNet |
Net longwave flux into the ground [W m-2] |
|
74 |
LTopDn |
Top-of-canopy downwelling longwave flux [W m-2] |
|
75 |
KCAAbs1 |
Shortwave absorption rate in clear-air part of layer 1 [W m-2] |
|
76 |
KCAAbs2 |
Shortwave absorption rate in clear-air part of layer 2 [W m-2] |
|
77 |
KCAAbs3 |
Shortwave absorption rate in clear-air part of layer 3 [W m-2] |
|
78 |
KCAAbs4 |
Shortwave absorption rate in clear-air part of layer 4 [W m-2] |
|
79 |
KCAAbs5 |
Shortwave absorption rate in clear-air part of layer 5 [W m-2] |
|
80 |
KCAAbs6 |
Shortwave absorption rate in clear-air part of layer 6 [W m-2] |
|
81 |
KCAAbs7 |
Shortwave absorption rate in clear-air part of layer 7 [W m-2] |
|
82 |
KCAAbs8 |
Shortwave absorption rate in clear-air part of layer 8 [W m-2] |
|
83 |
KCAAbs9 |
Shortwave absorption rate in clear-air part of layer 9 [W m-2] |
|
84 |
KCAAbs10 |
Shortwave absorption rate in clear-air part of layer 10 [W m-2] |
|
85 |
KCAAbs11 |
Shortwave absorption rate in clear-air part of layer 11 [W m-2] |
|
86 |
KCAAbs12 |
Shortwave absorption rate in clear-air part of layer 12 [W m-2] |
|
87 |
KCAAbs13 |
Shortwave absorption rate in clear-air part of layer 13 [W m-2] |
|
88 |
KCAAbs14 |
Shortwave absorption rate in clear-air part of layer 14 [W m-2] |
|
89 |
KCAAbs15 |
Shortwave absorption rate in clear-air part of layer 15 [W m-2] |
|
90 |
KWallNet1 |
Net shortwave flux into walls in layer 1 [W m-2] |
|
91 |
KWallNet2 |
Net shortwave flux into walls in layer 2 [W m-2] |
|
92 |
KWallNet3 |
Net shortwave flux into walls in layer 3 [W m-2] |
|
93 |
KWallNet4 |
Net shortwave flux into walls in layer 4 [W m-2] |
|
94 |
KWallNet5 |
Net shortwave flux into walls in layer 5 [W m-2] |
|
95 |
KWallNet6 |
Net shortwave flux into walls in layer 6 [W m-2] |
|
96 |
KWallNet7 |
Net shortwave flux into walls in layer 7 [W m-2] |
|
97 |
KWallNet8 |
Net shortwave flux into walls in layer 8 [W m-2] |
|
98 |
KWallNet9 |
Net shortwave flux into walls in layer 9 [W m-2] |
|
99 |
KWallNet10 |
Net shortwave flux into walls in layer 10 [W m-2] |
|
100 |
KWallNet11 |
Net shortwave flux into walls in layer 11 [W m-2] |
|
101 |
KWallNet12 |
Net shortwave flux into walls in layer 12 [W m-2] |
|
102 |
KWallNet13 |
Net shortwave flux into walls in layer 13 [W m-2] |
|
103 |
KWallNet14 |
Net shortwave flux into walls in layer 14 [W m-2] |
|
104 |
KWallNet15 |
Net shortwave flux into walls in layer 15 [W m-2] |
|
105 |
KRfNet1 |
Net shortwave flux into roofs in layer 1 [W m-2] |
|
106 |
KRfNet2 |
Net shortwave flux into roofs in layer 2 [W m-2] |
|
107 |
KRfNet3 |
Net shortwave flux into roofs in layer 3 [W m-2] |
|
108 |
KRfNet4 |
Net shortwave flux into roofs in layer 4 [W m-2] |
|
109 |
KRfNet5 |
Net shortwave flux into roofs in layer 5 [W m-2] |
|
110 |
KRfNet6 |
Net shortwave flux into roofs in layer 6 [W m-2] |
|
111 |
KRfNet7 |
Net shortwave flux into roofs in layer 7 [W m-2] |
|
112 |
KRfNet8 |
Net shortwave flux into roofs in layer 8 [W m-2] |
|
113 |
KRfNet9 |
Net shortwave flux into roofs in layer 9 [W m-2] |
|
114 |
KRfNet10 |
Net shortwave flux into roofs in layer 10 [W m-2] |
|
115 |
KRfNet11 |
Net shortwave flux into roofs in layer 11 [W m-2] |
|
116 |
KRfNet12 |
Net shortwave flux into roofs in layer 12 [W m-2] |
|
117 |
KRfNet13 |
Net shortwave flux into roofs in layer 13 [W m-2] |
|
118 |
KRfNet14 |
Net shortwave flux into roofs in layer 14 [W m-2] |
|
119 |
KRfNet15 |
Net shortwave flux into roofs in layer 15 [W m-2] |
|
120 |
KRfIn1 |
Shortwave flux into roofs in layer 1 [W m-2] |
|
121 |
KRfIn2 |
Shortwave flux into roofs in layer 2 [W m-2] |
|
122 |
KRfIn3 |
Shortwave flux into roofs in layer 3 [W m-2] |
|
123 |
KRfIn4 |
Shortwave flux into roofs in layer 4 [W m-2] |
|
124 |
KRfIn5 |
Shortwave flux into roofs in layer 5 [W m-2] |
|
125 |
KRfIn6 |
Shortwave flux into roofs in layer 6 [W m-2] |
|
126 |
KRfIn7 |
Shortwave flux into roofs in layer 7 [W m-2] |
|
127 |
KRfIn8 |
Shortwave flux into roofs in layer 8 [W m-2] |
|
128 |
KRfIn9 |
Shortwave flux into roofs in layer 9 [W m-2] |
|
129 |
KRfIn10 |
Shortwave flux into roofs in layer 10 [W m-2] |
|
130 |
KRfIn11 |
Shortwave flux into roofs in layer 11 [W m-2] |
|
131 |
KRfIn12 |
Shortwave flux into roofs in layer 12 [W m-2] |
|
132 |
KRfIn13 |
Shortwave flux into roofs in layer 13 [W m-2] |
|
133 |
KRfIn14 |
Shortwave flux into roofs in layer 14 [W m-2] |
|
134 |
KRfIn15 |
Shortwave flux into roofs in layer 15 [W m-2] |
|
135 |
KTopDnDir |
Direct shortwave flux into roofs [W m-2] |
|
136 |
KTopNet |
Top-of-canopy net shortwave flux [W m-2] |
|
137 |
KGrndDnDir |
Direct downwelling shortwave flux into the ground [W m-2] |
|
138 |
KGrndNet |
Net shortwave flux into the ground [W m-2] |