Tip

1. Need help? Please let us know in the UMEP Community.

2. Please report issues with the manual on the GitHub Issues.

3. Please cite SUEWS with proper information from our Zenodo page.

3.2.8. SUEWS_SiteSelect.txt

For each year and each grid, site specific surface cover information and other input parameters are provided to SUEWS by SUEWS_SiteSelect.txt. The model currently requires a new row for each year of the model run. All rows in this file will be read by the model and run.

No.	Column Name	Use	Description
1.0	Grid	MU	a unique number to represent grid
2.0	Year	MU	Year [YYYY]
3.0	StartDLS	MU	Start of the day light savings [DOY]
4.0	EndDLS	MU	End of the day light savings [DOY]
5.0	lat	MU	Latitude [deg].
6.0	lng	MU	longitude [deg]
7.0	Timezone	MU	Time zone [h] for site relative to UTC (east is positive). This should be set according to the times given in the meteorological forcing file(s).
8.0	SurfaceArea	MU	Area of the grid [ha].
9.0	Alt	MU	Altitude of grids [m].
10.0	z	MU	Measurement height [m] for all atmospheric forcing variables set in SSss_YYYY_data_tt.txt.
11.0	id	MD	Day of year [DOY]
12.0	ih	MD	Hour [H]
13.0	imin	MD	Minute [M]
14.0	Fr_Paved	MU	Surface cover fraction of Paved surfaces [-]
15.0	Fr_Bldgs	MU	Surface cover fraction of buildings [-]
16.0	Fr_EveTr	MU	Surface cover fraction of EveTr: evergreen trees and shrubs [-]
17.0	Fr_DecTr	MU	Surface cover fraction of deciduous trees and shrubs [-]
18.0	Fr_Grass	MU	Surface cover fraction of Grass [-]
19.0	Fr_Bsoil	MU	Surface cover fraction of bare soil or unmanaged land [-]
20.0	Fr_Water	MU	Surface cover fraction of open water [-]
21.0	IrrFr_Paved	MU	Fraction of Paved that is irrigated [-]
22.0	IrrFr_Bldgs	MU	Fraction of Bldgs that is irrigated [-]
23.0	IrrFr_EveTr	MU	Fraction of EveTr that is irrigated [-]
24.0	IrrFr_DecTr	MU	Fraction of DecTr that is irrigated [-]
25.0	IrrFr_Grass	MU	Fraction of Grass that is irrigated [-]
26.0	IrrFr_BSoil	MU	Fraction of BSoil that is irrigated [-]
27.0	IrrFr_Water	MU	Fraction of Water that is irrigated [-]
28.0	H_Bldgs	MU	Mean building height [m]
29.0	H_EveTr	MU	Mean height of evergreen trees [m]
30.0	H_DecTr	MU	Mean height of deciduous trees [m]
31.0	z0	O	Roughness length for momentum [m]
32.0	zd	O	Zero-plane displacement [m]
33.0	FAI_Bldgs	O	Frontal area index for buildings [-]
34.0	FAI_EveTr	O	Frontal area index for evergreen trees [-]
35.0	FAI_DecTr	O	Frontal area index for deciduous trees [-]
36.0	PopDensDay	O	Daytime population density (i.e. workers, tourists) [people ha-1]
37.0	PopDensNight	O	Night-time population density (i.e. residents) [people ha-1]
38.0	TrafficRate_WD	O	Weekday traffic rate [veh km m-2 s-1] Can be used for CO2 flux calculation - not used in v2018a.
39.0	TrafficRate_WE	O	Weekend traffic rate [veh km m-2 s-1] Can be used for CO2 flux calculation - not used in v2018a.
40.0	QF0_BEU_WD	O	Building energy use [W m-2]
41.0	QF0_BEU_WE	O	Building energy use [W m-2]
42.0	Code_Paved	L	Code for Paved surface characteristics linking to Code of SUEWS_NonVeg.txt
43.0	Code_Bldgs	L	Code for Bldgs surface characteristics linking to Code of SUEWS_NonVeg.txt
44.0	Code_EveTr	L	Code for EveTr surface characteristics linking to Code of SUEWS_Veg.txt
45.0	Code_DecTr	L	Code for DecTr surface characteristics linking to Code of SUEWS_Veg.txt
46.0	Code_Grass	L	Code for Grass surface characteristics linking to Code of SUEWS_Veg.txt
47.0	Code_BSoil	L	Code for BSoil surface characteristics linking to Code of SUEWS_NonVeg.txt
48.0	Code_Water	L	Code for Water surface characteristics linking to Code of SUEWS_Water.txt
49.0	LUMPS_DrRate	MD	Drainage rate of bucket for LUMPS [mm h-1]
50.0	LUMPS_Cover	MD	Limit when surface totally covered with water for LUMPS [mm]
51.0	LUMPS_MaxRes	MD	Maximum water bucket reservoir [mm] Used for LUMPS surface wetness control.
52.0	NARP_Trans	MD	Atmospheric transmissivity for NARP [-]
53.0	CondCode	L	Code for surface conductance parameters linking to Code of SUEWS_Conductance.txt
54.0	SnowCode	L	Code for snow surface characteristics linking to Code of SUEWS_Snow.txt
55.0	SnowClearingProfWD	L	Code for snow clearing profile (weekdays) linking to Code of SUEWS_Profiles.txt.
56.0	SnowClearingProfWE	L	Code for snow clearing profile (weekends) linking to Code of SUEWS_Profiles.txt.
57.0	AnthropogenicCode	L	Code for modelling anthropogenic heat flux linking to Code of SUEWS_AnthropogenicEmission.txt, which contains the model coefficients for estimation of the anthropogenic heat flux (used if EmissionsMethod = 1, 2 in RunControl.nml).
58.0	IrrigationCode	L	Code for modelling irrigation linking to Code of SUEWS_Irrigation.txt
59.0	WaterUseProfManuWD	L	Code for water use profile (manual irrigation, weekdays) linking to Code of SUEWS_Profiles.txt.
60.0	WaterUseProfManuWE	L	Code for water use profile (manual irrigation, weekends) linking to Code of SUEWS_Profiles.txt.
61.0	WaterUseProfAutoWD	L	Code for water use profile (automatic irrigation, weekdays) linking to Code of SUEWS_Profiles.txt. Value of integer is arbitrary but must match code specified in Code of SUEWS_Profiles.txt.
62.0	WaterUseProfAutoWE	L	Code for water use profile (automatic irrigation, weekends) linking to Code of SUEWS_Profiles.txt. Value of integer is arbitrary but must match code specified in Code of SUEWS_Profiles.txt.
63.0	FlowChange	MD	Difference in input and output flows for water surface [mm h-1]
64.0	RunoffToWater	MD MU	Fraction of above-ground runoff flowing to water surface during flooding [-]
65.0	PipeCapacity	MD MU	Storage capacity of pipes [mm]
66.0	GridConnection1of8	MD MU	Number of the 1st grid where water can flow to
67.0	Fraction1of8	MD MU	Fraction of water that can flow to GridConnection1of8 [-]
68.0	GridConnection2of8	MD MU	Number of the 2nd grid where water can flow to
69.0	Fraction2of8	MD MU	Fraction of water that can flow to GridConnection2of8 [-]
70.0	GridConnection3of8	MD MU	Number of the 3rd grid where water can flow to
71.0	Fraction3of8	MD MU	Fraction of water that can flow to GridConnection3of8 [-]
72.0	GridConnection4of8	MD MU	Number of the 4th grid where water can flow to
73.0	Fraction4of8	MD MU	Fraction of water that can flow to GridConnection4of8 [-]
74.0	GridConnection5of8	MD MU	Number of the 5th grid where water can flow to
75.0	Fraction5of8	MD MU	Fraction of water that can flow to GridConnection5of8 [-]
76.0	GridConnection6of8	MD MU	Number of the 6th grid where water can flow to
77.0	Fraction6of8	MD MU	Fraction of water that can flow to GridConnection6of8 [-]
78.0	GridConnection7of8	MD MU	Number of the 7th grid where water can flow to
79.0	Fraction7of8	MD MU	Fraction of water that can flow to GridConnection7of8 [-]
80.0	GridConnection8of8	MD MU	Number of the 8th grid where water can flow to
81.0	Fraction8of8	MD MU	Fraction of water that can flow to GridConnection8of8 [-]
82.0	WithinGridPavedCode	L	Code that links to the fraction of water that flows from Paved surfaces to surfaces in columns 2-10 of SUEWS_WithinGridWaterDist.txt.
83.0	WithinGridBldgsCode	L	Code that links to the fraction of water that flows from Bldgs surfaces to surfaces in columns 2-10 of SUEWS_WithinGridWaterDist.txt
84.0	WithinGridEveTrCode	L	Code that links to the fraction of water that flows from EveTr surfaces to surfaces in columns 2-10 of SUEWS_WithinGridWaterDist.txt.
85.0	WithinGridDecTrCode	L	Code that links to the fraction of water that flows from DecTr surfaces to surfaces in columns 2-10 of SUEWS_WithinGridWaterDist.txt.
86.0	WithinGridGrassCode	L	Code that links to the fraction of water that flows from Grass surfaces to surfaces in columns 2-10 of SUEWS_WithinGridWaterDist.txt.
87.0	WithinGridBSoilCode	L	Code that links to the fraction of water that flows from BSoil surfaces to surfaces in columns 2-10 of SUEWS_WithinGridWaterDist.txt.
88.0	WithinGridWaterCode	L	Code that links to the fraction of water that flows from Water surfaces to surfaces in columns 2-10 of SUEWS_WithinGridWaterDist.txt.
89.0	AreaWall	MU	Area of wall within grid (needed for ESTM calculation) [ m2 ].
90.0	Fr_ESTMClass_Paved1	MU	Surface cover fraction of Paved surface class 1 used in ESTM calculations
91.0	Fr_ESTMClass_Paved2	MU	Surface cover fraction of Paved surface class 2 used in ESTM calculations
92.0	Fr_ESTMClass_Paved3	MU	Surface cover fraction of Paved surface class 3 used in ESTM calculations
93.0	Code_ESTMClass_Paved1	L	Code linking to SUEWS_ESTMCoefficients.txt
94.0	Code_ESTMClass_Paved2	L	Code linking to SUEWS_ESTMCoefficients.txt
95.0	Code_ESTMClass_Paved3	L	Code linking to SUEWS_ESTMCoefficients.txt
96.0	Fr_ESTMClass_Bldgs1	MU	Surface cover fraction of building class 1 used in ESTM calculations
97.0	Fr_ESTMClass_Bldgs2	MU	Surface cover fraction of building class 2 used in ESTM calculations
98.0	Fr_ESTMClass_Bldgs3	MU	Surface cover fraction of building class 3 used in ESTM calculations
99.0	Fr_ESTMClass_Bldgs4	MU	Surface cover fraction of building class 4 used in ESTM calculations
100.0	Fr_ESTMClass_Bldgs5	MU	Surface cover fraction of building class 5 used in ESTM calculations
101.0	Code_ESTMClass_Bldgs1	L	Code linking to SUEWS_ESTMCoefficients.txt
102.0	Code_ESTMClass_Bldgs2	L	Code linking to SUEWS_ESTMCoefficients.txt
103.0	Code_ESTMClass_Bldgs3	L	Code linking to SUEWS_ESTMCoefficients.txt
104.0	Code_ESTMClass_Bldgs4	L	Code linking to SUEWS_ESTMCoefficients.txt
105.0	Code_ESTMClass_Bldgs5	L	Code linking to SUEWS_ESTMCoefficients.txt

Attention

• Two rows of -9 should be placed at end of this file.

• In this file the column order is important.

• Surface cover fractions specified from Fr_Paved to Fr_Water should sum up to 1.

• Surface cover fractions specified from Fr_ESTMClass_Paved1 to Fr_ESTMClass_Paved3 should sum up to 1.

• Surface cover fractions specified from Fr_ESTMClass_Bldgs1 to Fr_ESTMClass_Bldgs5 should sum up to 1.

• In this file the row order is important for simulations of multiple grids and multiple years. Ensure the rows in are arranged so that all grids for a particular year appear on consecutive lines (rather than grouping all years together for a particular grid). See below for a valid example:

  Grid  Year ...
  1     2001 ...
  2     2001 ...
  1     2002 ...
  2     2002 ...
  

Tip

! can be used to indicate comments in the file. Comments are not read by the programme so they can be used by the user to provide notes for their interpretation of the contents. This is strongly recommended.

3.2.8.1. Day Light Savings (DLS)

The dates for DLS normally vary for each year and country as they are often associated with a specific set of Sunday mornings at the beginning of summer and autumn. Note it is important to remember leap years. You can check http://www.timeanddate.com/time/dst/ for your city.

Tip

If DLS does not occur give a start and end day immediately after it. Make certain the dummy dates are correct for the hemisphere

• For northern hemisphere, use: 180 181

• For southern hemisphere, use:  365 1

Example when running multiple years (in this case 2008 and 2009 in Canada):

Year	start of daylight savings	end of daylight savings
2008	170	240
2009	172	242

3.2.8.2. Grid Connections (water flow between grids)

Caution

• Not available in this version.

• columns between GridConnection1of8 and GridConnection8of8 in SUEWS_SiteSelect.txt can be set to zero.

This section gives an example of water flow between grids, calculated based on the relative elevation of the grids and length of the connecting surface between adjacent grids. For the square grids in the figure, water flow is assumed to be zero between diagonally adjacent grids, as the length of connecting surface linking the grids is very small. Model grids need not be square or the same size.

The table gives example values for the grid connections part of SUEWS_SiteSelect.txt for the grids shown in the figure. For each row, only water flowing out of the current grid is entered (e.g. water flows from 234 to 236 and 237, with a larger proportion of water flowing to 237 because of the greater length of connecting surface between 234 and 237 than between 234 and 236. No water is assumed to flow between 234 and 233 or 235 because there is no elevation difference between these grids. Grids 234 and 238 are at the same elevation and only connect at a point, so no water flows between them. Water enters grid 234 from grids 230, 231 and 232 as these are more elevated.

Fig. 3.1 Example grid connections showing water flow between grids.

Note

Arrows indicate the water flow in to and out of grid 234, but note that only only water flowing out of each grid is entered in SUEWS_SiteSelect.txt

Fig. 3.2 Example values for the grid connections part of SUEWS_SiteSelect.txt for the grids.

An example SUEWS_SiteSelect.txt can be found below:

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
Grid   Year   StartDLS   EndDLS   lat       lng       Timezone   SurfaceArea   Alt       z         id       ih       imin     Fr_Paved   Fr_Bldgs   Fr_EveTr   Fr_DecTr   Fr_Grass   Fr_Bsoil   Fr_Water   IrrFr_Paved     IrrFr_Bldgs     IrrFr_EveTr   IrrFr_DecTr   IrrFr_Grass   IrrFr_BSoil   IrrFr_Water   H_Bldgs    H_EveTr     H_DecTr     z0          zd           FAI_Bldgs      FAI_EveTr        FAI_DecTr        PopDensDay   PopDensNight   TrafficRate_WD   TrafficRate_WE   QF0_BEU_WD   QF0_BEU_WE   Code_Paved   Code_Bldgs   Code_EveTr   Code_DecTr     Code_Grass    Code_Bsoil     Code_Water   LUMPS_DrRate   LUMPS_Cover   LUMPS_MaxRes         NARP_Trans           CondCode            SnowCode         SnowClearingProfWD   SnowClearingProfWE   AnthropogenicCode    IrrigationCode       WaterUseProfManuWD   WaterUseProfManuWE   WaterUseProfAutoWD   WaterUseProfAutoWE   FlowChange     RunoffToWater        PipeCapacity   GridConnection1of8   Fraction1of8   GridConnection2of8   Fraction2of8   GridConnection3of8   Fraction3of8   GridConnection4of8   Fraction4of8   GridConnection5of8   Fraction5of8   GridConnection6of8   Fraction6of8   GridConnection7of8    Fraction7of8          GridConnection8of8    Fraction8of8          WithinGridPavedCode   WithinGridBldgsCode        WithinGridEveTrCode   WithinGridDecTrCode   WithinGridGrassCode   WithinGridUnmanBSoilCode   WithinGridWaterCode   AreaWall                Fr_ESTMClass_Paved1     Fr_ESTMClass_Paved2     Fr_ESTMClass_Paved3   Code_ESTMClass_Paved1   Code_ESTMClass_Paved2   Code_ESTMClass_Paved3   Fr_ESTMClass_Bldgs1   Fr_ESTMClass_Bldgs2     Fr_ESTMClass_Bldgs3     Fr_ESTMClass_Bldgs4     Fr_ESTMClass_Bldgs5     Code_ESTMClass_Bldgs1      Code_ESTMClass_Bldgs2   Code_ESTMClass_Bldgs3   Code_ESTMClass_Bldgs4   Code_ESTMClass_Bldgs5
1      2004   85         302      57.7700   11.8700   2.0000     1.0000        15.0000   50.0000   1.0000   0.0000   0.0000   0.2000     0.2000     0.2000     0.1000     0.1000     0.1000     0.1000     0.0             0.0             0.0000        0.0000        0.0000        0.0           0.0           15.00      15.000      15.000      0.0100      0.2000       0.3000         0.3000           0.3000           0.0000       0.0000         0.0134           0.0095           0.7442       0.7955       661.0000     662.0000     661.0000     662.0000       663.0000      663.0000       661.0000     0.2500         1.0000        10.0000              1.0000               200.0000            660.0000         660.0000             660.0000             661.0000             660.0000             660.0000             660.0000             660.0000             660.0000             0.0000         0.1000               100.0000       0.0000               0.0000         0.0000               0.0000         0.0000               0.0000         0.0000               0.0000         0.0000               0.0000         0.0000               0.0000         0.0000                0.0000                0.0000                0.0000                661.0000              662.0000                   663.0000              664.0000              665.0000              666.0000                   667.0000              -999.0000               0.0000                  1.0000                  0.0000                99999.0000              807.0000                99999.0000              1.0000                0.0000                  0.0000                  0.0000                  0.0000                  801.0000                   99999.0000              99999.0000              99999.0000              99999.0000
1      2005   85         302      57.7700   11.8700   2.0000     1.0000        15.0000   50.0000   1.0000   0.0000   0.0000   0.2000     0.2000     0.2000     0.1000     0.1000     0.1000     0.1000     0.0             0.0             0.0000        0.0000        0.0000        0.0           0.0           1.00       1.000       1.000       0.0100      0.2000       0.3000         0.3000           0.3000           0.0000       0.0000         0.0134           0.0095           0.7442       0.7955       661.0000     662.0000     661.0000     662.0000       663.0000      663.0000       661.0000     0.2500         1.0000        10.0000              1.0000               200.0000            660.0000         660.0000             660.0000             661.0000             660.0000             660.0000             660.0000             660.0000             660.0000             0.0000         0.1000               100.0000       0.0000               0.0000         0.0000               0.0000         0.0000               0.0000         0.0000               0.0000         0.0000               0.0000         0.0000               0.0000         0.0000                0.0000                0.0000                0.0000                661.0000              662.0000                   663.0000              664.0000              665.0000              666.0000                   667.0000              -999.0000               0.0000                  1.0000                  0.0000                99999.0000              807.0000                99999.0000              1.0000                0.0000                  0.0000                  0.0000                  0.0000                  801.0000                   99999.0000              99999.0000              99999.0000              99999.0000
-9
-9