# 4.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 Grid MU

Grid numbers do not need to be consecutive and do not need to start at a particular value. Each grid must have a unique grid number. All grids must be present for all years. These grid numbers are referred to columns from GridConnection1of8 to GridConnection8of8

Not available in this version.

2 Year MU Year [YYYY] Years must be continuous. If running multiple years, ensure the rows in SUEWS_SiteSelect.txt are arranged so that all grids for a particular year appear on consecutive lines (rather than grouping all years together for a particular grid).
3 StartDLS MU Start of the day light savings [DOY] See Day Light Savings (DLS).
4 EndDLS MU End of the day light savings [DOY] See Day Light Savings (DLS).
5 lat MU

Use coordinate system WGS84. Positive values are northern hemisphere (negative southern hemisphere). Used in radiation calculations.

Note

If the total modelled area is small the latitude and longitude could be the same for each grid but small differences in radiation will not be determined. If you are defining the latitude and longitude differently between grids make certain that you provide enough decimal places.

6 lng MU

Use coordinate system WGS84. For compatibility with GIS, negative values are to the west, positive values are to the east (e.g. Vancouver = -123.12; Shanghai = 121.47)

Note

this is a change of sign convention between v2016a and v2017a See lat for more details.

7 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 SurfaceArea MU Area of the grid [ha].
9 Alt MU

Used for both the radiation and water flow between grids.

Not available in this version.

10 z MU z must be greater than the displacement height. Forcing data should be representative of the local-scale, i.e. above the height of the roughness elements.
11 id MD Day [DOY] Not used: set to 1 in this version.
12 ih MD Hour [H] Not used: set to 0 in this version.
13 imin MD Minute [M] Not used: set to 0 in this version.
14 Fr_Paved MU Surface cover fraction of paved surfaces [-].
15 Fr_Bldgs MU Surface cover fraction of buildings [-]
16 Fr_EveTr MU Surface cover fraction of evergreen trees and shrubs [-]
17 Fr_DecTr MU Surface cover fraction of deciduous trees and shrubs [-]
18 Fr_Grass MU Surface cover fraction of grass [-]
19 Fr_Bsoil MU Surface cover fraction of bare soil or unmanaged land [-]
20 Fr_Water MU Surface cover fraction of open water [-] (e.g. river, lakes, ponds, swimming pools)
21 IrrFr_EveTr MU Fraction of evergreen trees that are irrigated [-] e.g. 50% of the evergreen trees/shrubs are irrigated
22 IrrFr_DecTr MU Fraction of deciduous trees that are irrigated [-]
23 IrrFr_Grass MU Fraction of grass that is irrigated [-]
24 H_Bldgs MU Mean building height [m]
25 H_EveTr MU Mean height of evergreen trees [m]
26 H_DecTr MU Mean height of deciduous trees [m]
27 z0 O Roughness length for momentum [m] Value supplied here is used if RoughLenMomMethod = 1 in RunControl.nml ; otherwise set to ‘-999’ and a value will be calculated by the model (RoughLenMomMethod = 2, 3).
28 zd O Zero-plane displacement [m] Value supplied here is used if RoughLenMomMethod = 1 in RunControl.nml ; otherwise set to ‘-999’ and a value will be calculated by the model (RoughLenMomMethod = 2, 3).
29 FAI_Bldgs O Frontal area index for buildings [-] Required if RoughLenMomMethod = 3 in RunControl.nml .
30 FAI_EveTr O Frontal area index for evergreen trees [-] Required if RoughLenMomMethod = 3 in RunControl.nml .
31 FAI_DecTr O Frontal area index for deciduous trees [-] Required if RoughLenMomMethod = 3 in RunControl.nml .
32 PopDensDay O Daytime population density (i.e. workers, tourists) [people ha -1 ] Population density is required if EmissionsMethod = 2 in RunControl.nml . The model will use the average of daytime and night-time population densities, unless only one is provided. If daytime population density is unknown, set to -999.
33 PopDensNight O Night-time population density (i.e. residents) [people ha -1 ] Population density is required if EmissionsMethod = 2 in RunControl.nml . The model will use the average of daytime and night-time population densities, unless only one is provided. If night-time population density is unknown, set to -999.
34 TrafficRate_WD O Weekday traffic rate [veh km m-2 s-1]. Can be used for CO2 flux calculation.
35 TrafficRate_WE O Weekend traffic rate [veh km m-2 s-1]. Can be used for CO2 flux calculation.
36 QF0_BEU_WD O Weekday building energy use [W m-2] Can be used for CO2 flux calculation.
37 QF0_BEU_WE O Weekend building energy use [W m-2] Can be used for CO2 flux calculation.
38 Code_Paved L Code for Paved surface characteristics Provides the link to column 1 of SUEWS_NonVeg.txt, which contains the attributes describing paved areas in this grid for this year. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_NonVeg.txt. e.g. 331 means use the characteristics specified in the row of input file SUEWS_NonVeg.txt which has 331 in column 1 (Code).
39 Code_Bldgs L Code for Bldgs surface characteristics Provides the link to column 1 of SUEWS_NonVeg.txt, which contains the attributes describing buildings in this grid for this year. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_NonVeg.txt.
40 Code_EveTr L Code for EveTr surface characteristics Provides the link to column 1 of SUEWS_Veg.txt, which contains the attributes describing evergreen trees and shrubs in this grid for this year. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Veg.txt.
41 Code_DecTr L Code for DecTr surface characteristics Provides the link to column 1 of SUEWS_Veg.txt, which contains the attributes describing deciduous trees and shrubs in this grid for this year. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Veg.txt.
42 Code_Grass L Code for Grass surface characteristics Provides the link to column 1 of SUEWS_Veg.txt, which contains the attributes describing grass surfaces in this grid for this year. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Veg.txt.
43 Code_BSoil L Code for BSoil surface characteristics Provides the link to column 1 of SUEWS_NonVeg.txt, which contains the attributes describing bare soil in this grid for this year. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_NonVeg.txt.
44 Code_Water L Code for Water surface characteristics Provides the link to column 1 of SUEWS_Water.txt, which contains the attributes describing open water in this grid for this year. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Water.txt.
45 LUMPS_DrRate MD Drainage rate of bucket for LUMPS [mm h-1] Used for LUMPS surface wetness control. Default recommended value of 0.25 mm h-1 from Loridan et al. (2011) [L2011] .
46 LUMPS_Cover MD Limit when surface totally covered with water [mm] Used for LUMPS surface wetness control. Default recommended value of 1 mm from Loridan et al. (2011) [L2011] .
47 LUMPS_MaxRes MD Maximum water bucket reservoir [mm] Used for LUMPS surface wetness control. Default recommended value of 10 mm from Loridan et al. (2011) [L2011] .
48 NARP_Trans MD Atmospheric transmissivity for NARP [-] Value must in the range 0-1. Default recommended value of 1.
49 CondCode L Code for surface conductance parameters Provides the link to column 1 of SUEWS_Conductance.txt, which contains the parameters for the Jarvis (1976) parameterisation of surface conductance. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Conductance.txt. e.g. 33 means use the characteristics specified in the row of input file SUEWS_Conductance.txt which has 33 in column 1 (Code).
50 SnowCode L Code for snow surface characteristics Provides the link to column 1 of SUEWS_Snow.txt, which contains the attributes describing snow surfaces in this grid for this year. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Snow.txt.
51 SnowClearingProfWD L Code for snow clearing profile (weekdays) Provides the link to column 1 of SUEWS_Profiles.txt. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Profiles.txt. e.g. 1 means use the characteristics specified in the row of input file SUEWS_Profiles.txt which has 1 in column 1 (Code).
52 SnowClearingProfWE L Code for snow clearing profile (weekends) Provides the link to column 1 of SUEWS_Profiles.txt. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Profiles.txt. e.g. 1 means use the characteristics specified in the row of input file SUEWS_Profiles.txt which has 1 in column 1 (Code). Providing the same code for SnowClearingProfWD and SnowClearingProfWE would link to the same row in SUEWS_Profiles.txt, i.e. the same profile would be used for weekdays and weekends.
53 AnthropogenicCode L Code for modelling anthropogenic heat flux Provides the link to column 1 of SUEWS_AnthropogenicHeat.txt, which contains the model coefficients for estimation of the anthropogenic heat flux (used if EmissionsMethod = 1, 2, 3 in RunControl.nml ). Value of integer is arbitrary but must match code specified in column 1 of SUEWS_AnthropogenicHeat.txt.
54 IrrigationCode L Code for modelling irrigation Provides the link to column 1 of SUEWS_Irrigation.txt, which contains the model coefficients for estimation of the water use (used if WU_Choice = 0 in RunControl.nml ). Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Irrigation.txt.
55 WaterUseProfManuWD L Code for water use profile (manual irrigation, weekdays) Provides the link to column 1 of SUEWS_Profiles.txt. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Profiles.txt.
56 WaterUseProfManuWE L Code for water use profile (manual irrigation, weekends) Provides the link to column 1 of SUEWS_Profiles.txt. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Profiles.txt.
57 WaterUseProfAutoWD L Code for water use profile (automatic irrigation, weekdays) Provides the link to column 1 of SUEWS_Profiles.txt. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Profiles.txt.
58 WaterUseProfAutoWE L Code for water use profile (automatic irrigation, weekends) Provides the link to column 1 of SUEWS_Profiles.txt. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Profiles.txt.
59 FlowChange MD Difference in input and output flows for water surface [mm h-1] Used to indicate river or stream flow through the grid. Currently not fully tested!
60 RunoffToWater MD MU Fraction of above-ground runoff flowing to water surface during flooding [-] Value must be in the range 0-1. Fraction of above-ground runoff that can flow to the water surface in the case of flooding.
61 PipeCapacity MD MU Storage capacity of pipes [mm] Runoff amounting to less than the value specified here is assumed to be removed by pipes.
62 GridConnection1of8 MD MU The next 8 pairs of columns specify the water flow between grids. The first column of each pair specifies the grid that the water flows to (from the current grid, column 1); the second column of each pair specifies the fraction of water that flow to that grid. The fraction (i.e. amount) of water transferred may be estimated based on elevation, the length of connecting surface between grids, presence of walls, etc. Water cannot flow from the current grid to the same grid, so the grid number here must be different to the grid number in column 1. Water can flow to a maximum of 8 other grids. If there is no water flow between grids, or a single grid is run, set to 0. See section on Grid Connections
63 Fraction1of8 MD MU Fraction of water that can flow to the grid specified in previous column [-]
64 GridConnection2of8 MD MU Number of the grid where water can flow to
65 Fraction2of8 MD MU Fraction of water that can flow to the grid specified in previous column [-]
66 GridConnection3of8 MD MU Number of the grid where water can flow to
67 Fraction3of8 MD MU Fraction of water that can flow to the grid specified in previous column [-]
68 GridConnection4of8 MD MU Number of the grid where water can flow to
69 Fraction4of8 MD MU Fraction of water that can flow to the grid specified in previous column [-]
70 GridConnection5of8 MD MU Number of the grid where water can flow to
71 Fraction5of8 MD MU Fraction of water that can flow to the grid specified in previous column [-]
72 GridConnection6of8 MD MU Number of the grid where water can flow to
73 Fraction6of8 MD MU Fraction of water that can flow to the grid specified in previous column [-]
74 GridConnection7of8 MD MU Number of the grid where water can flow to
75 Fraction7of8 MD MU Fraction of water that can flow to the grid specified in previous column [-]
76 GridConnection8of8 MD MU Number of the grid where water can flow to
77 Fraction8of8 MD MU Fraction of water that can flow to the grid specified in previous column [-]
78 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 . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_WithinGridWaterDist.txt.
79 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. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_WithinGridWaterDist.txt.
80 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. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_WithinGridWaterDist.txt.
81 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. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_WithinGridWaterDist.txt.
82 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. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_WithinGridWaterDist.txt.
83 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. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_WithinGridWaterDist.txt.
84 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. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_WithinGridWaterDist.txt.
85 AreaWall MU Area of wall within grid (needed for ESTM calculation).
86 Fr_ESTMClass_Paved1 MU Surface cover fraction of paved surface class 1 used in ESTM calculations
87 Fr_ESTMClass_Paved2 MU Surface cover fraction of paved surface class 2 used in ESTM calculations
88 Fr_ESTMClass_Paved3 MU Surface cover fraction of paved surface class 3 used in ESTM calculations
89 Code_ESTMClass_Paved1 L Code linking to SUEWS_ESTMCoefficients.txt
90 Code_ESTMClass_Paved2 L Code linking to SUEWS_ESTMCoefficients.txt
91 Code_ESTMClass_Paved3 L Code linking to SUEWS_ESTMCoefficients.txt
92 Fr_ESTMClass_Bldgs1 MU Surface cover fraction of building class 1 used in ESTM calculations
93 Fr_ESTMClass_Bldgs2 MU Surface cover fraction of building class 2 used in ESTM calculations
94 Fr_ESTMClass_Bldgs3 MU Surface cover fraction of building class 3 used in ESTM calculations
95 Fr_ESTMClass_Bldgs4 MU Surface cover fraction of building class 4 used in ESTM calculations
96 Fr_ESTMClass_Bldgs5 MU Surface cover fraction of building class 5 used in ESTM calculations
97 Code_ESTMClass_Bldgs1 L Code linking to SUEWS_ESTMCoefficients.txt
98 Code_ESTMClass_Bldgs2 L Code linking to SUEWS_ESTMCoefficients.txt
99 Code_ESTMClass_Bldgs3 L Code linking to SUEWS_ESTMCoefficients.txt
100 Code_ESTMClass_Bldgs4 L Code linking to SUEWS_ESTMCoefficients.txt
101 Code_ESTMClass_Bldgs5 L Code linking to SUEWS_ESTMCoefficients.txt

Attention

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.

## 4.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

## 4.2.8.2. Grid Connections (water flow between grids)¶

Caution

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.

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

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
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_EveTr IrrFr_DecTr IrrFr_Grass 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 10.0000 1.0000 0.0000 0.0000 1.0000   0.0000   0.0000   0.0000   0.0000   0.0000   0.0000   0.0000      0.0000      0.0000      0.0010  0.0000  0.0000  0.0100 0.2000 0.0000    0.0000    0.0000    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 10.0000 1.0000 0.0000 0.0000 1.0000   0.0000   0.0000   0.0000   0.0000   0.0000   0.0000   0.0000      0.0000      0.0000      0.0010  0.0000  0.0000  0.0100 0.2000 0.0000    0.0000    0.0000    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