Note

Please report issues with the manual on the GitHub page.

5. Output files

5.1. Runtime diagnostic information

5.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 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 Preparing to run the model).

5.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).

5.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.

5.2. Model output files

5.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 [%]

5.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 [°C]
8 HDD4_T5d 5-day running-mean air temperature [°C]
9 P_day Daily total precipitation [mm]
10 DaysSR Days since rain [days]
11 GDD_EveTr Growing degree days for evergreen eree [°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 eree [°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 [°C]
18 Tmax Daily maximum temperature [°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 deltaLAI Change in leaf area index (normalised 0-1) [-]
38 LAIlumps Leaf area index used in LUMPS (normalised 0-1) [-]
39 AlbSnow Snow albedo [-]
40 DensSnow_Paved Snow density - paved surface [kg m-3]
41 DensSnow_Bldgs Snow density - building surface [kg m-3]
42 DensSnow_EveTr Snow density - evergreen surface [kg m-3]
43 DensSnow_DecTr Snow density - deciduous surface [kg m-3]
44 DensSnow_Grass Snow density - grass surface [kg m-3]
45 DensSnow_BSoil Snow density - bare soil surface [kg m-3]
46 DensSnow_Water Snow density - water surface [kg m-3]
47 a1 OHM cofficient a1 - [-]
48 a2 OHM cofficient a2 [W m-2 h-1]
49 a3 OHM cofficient a3 - [W m-2]

5.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

5.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]

5.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: levels 1 and 30 are positioned at 0.1 and 3.0 Zh (i.e., canopy height) with other levels evenly distributed in between.

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]

5.2.6. SSss_YYYY_BL.txt

Meteorological variables modelled by CBL portion of the model are output in to this file created for each day with time step (see section CBL Input).

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

5.2.7. SOLWEIGpoiOut.txt

Calculated variables from POI, point of interest (row, col) stated in SOLWEIGinput.nml.

SOLWEIG model output file format: SOLWEIGpoiOUT.txt

Column Name Description Units
1 id Day of year  
2 dectime Decimal time  
3 azimuth Azimuth angle of the Sun °
4 altitude Altitude angle of the Sun °
5 GlobalRad Input Kdn W m-2
6 DiffuseRad Diffuse shortwave radiation W m-2
7 DirectRad Direct shortwave radiation W m-2
8 Kdown2d Incoming shortwave radiation at POI W m-2
9 Kup2d Outgoing shortwave radiation at POI W m-2
10 Ksouth Shortwave radiation from south at POI W m-2
11 Kwest Shortwave radiation from west at POI W m-2
12 Knorth Shortwave radiation from north at POI W m-2
13 Keast Shortwave radiation from east at POI W m-2
14 Ldown2d Incoming longwave radiation at POI W m-2
15 Lup2d Outgoing longwave radiation at POI W m-2
16 Lsouth Longwave radiation from south at POI W m-2
17 Lwest Longwave radiation from west at POI W m-2
18 Lnorth Longwave radiation from north at POI W m-2
19 Least Longwave radiation from east at POI W m-2
20 Tmrt Mean Radiant Temperature °C
21 I0 theoretical value of maximum incoming solar radiation W m-2
22 CI clearness index for Ldown (Lindberg et al. 2008)  
23 gvf Ground view factor (Lindberg and Grimmond 2011)  
24 shadow Shadow value (0= shadow, 1 = sun)  
25 svf Sky View Factor from ground and buildings  
26 svfbuveg Sky View Factor from ground, buildings and vegetation  
27 Ta Air temperature °C
28 Tg Surface temperature °C

5.2.8. 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