# 11. Version History¶

## 11.2. Version 2017b (released 2 August 2017)¶

PDF Manual for v2017b

1. Surface-level diagnostics: T2 (air temperature at 2 m agl), Q2 (air specific humidity at 2 m agl) and U10 (wind speed at 10 m agl) added as default output.
2. Output in netCDF format. Please note this feature is NOT enabled in the public release due to the dependency of netCDF library. Assistance in enabling this feature may be requested to the development team via SUEWS mail list.
3. Edits to the manual.
4. New capabilities being developed, including two new options for calculating storage heat flux (AnOHM, ESTM) and modelling of carbon dioxide fluxes. These are currently under development and should not be used in Version 2017b.
5. Known issues
1. BLUEWS parameters need to be checked
2. Observed soil moisture can not be used as an input
3. Wind direction is not currently downscaled so non -999 values will cause an error.

## 11.3. Version 2017a (Feb 2017)¶

1. Changes to input file formats (including RunControl.nml and InitialConditions files) to facilitate setting up and running the model. Met forcing files no longer need two rows of -9 at the end to indicate the end of the file.
2. Changes to output file formats (now option to write out only a subset of variables, rather than all variables).
3. SUEWS can now disaggregate forcing files to the model time-step and aggregate output at the model time-step to lower resolution. This removes the need for the python wrapper used with previous versions.
4. InitialConditions format and requirements changed. A single file can now be provided for multiple grids. SUEWS will approximate most (but not all) of the required initial conditions if values are unknown. (However, if detailed information about the initial conditions is known, this can still be provided to and used by SUEWS.)
5. Leaf area index calculations now use parameters provided for each vegetated surface (previously only the deciduous tree LAI development parameters were applied to all vegetated surfaces).
6. For compatibility with GIS, the sign convention for longitude has been changed. Now negative values are to the west, positive values are to the east. Note this appears to have been incorrectly coded in previous versions (but may not necessarily have been problematic).
7. Storage heat flux calculation adapted for shorter (sub-hourly) model time-step: hysteresis calculation now based on running means over the previous hour.
8. Improved error handling, including separate files for serious errors (problems.txt) and less critical issues (warnings.txt).
9. Edits to the manual.
10. New capabilities being developed, including two new options for calculating storage heat flux (AnOHM, ESTM) and modelling of carbon dioxide fluxes. These are currently under development and should not be used in Version 2017a.

## 11.4. Version 2016a (released 21 June 2016)¶

PDF Manual for v2016a

1. Major changes to the input file formats to facilitate the running of multiple grids and multiple years. Surface characteristics are provided in SUEWS_SiteSelect.txt and other input files are cross-referenced via codes or profile types.
2. The surface types have been altered:
• Previously, grass surfaces were entered separately as irrigated grass and unirrigated grass surfaces, whilst the ‘unmanaged’ land cover fraction was assumed by the model to behave as unirrigated grass. There is now a single surface type for grass (total for irrigated plus unirrigated) and a new bare soil surface type.
• The proportion of irrigated vegetation must now be specified for grass, evergreen trees and deciduous trees individually.
3. The entire model now runs at a time step specified by the user. Note that 5 min is strongly recommended. (Previously only the water balance calculations were done at 5 min with the energy balance calculations at 60 min).
4. Surface conductance now depends on the soil moisture under the vegetated surfaces only (rather than the total soil moisture for the whole study area as previously).
5. Albedo of evergreen trees and grass surfaces can now change with leaf area index as was previously possible for deciduous trees only.
6. New suggestions in Troubleshooting section.
7. Edits to the manual.
8. CBL model included.
9. SUEWS has been incorporated into UMEP

## 11.5. Version 2014b (released 8 October 2014)¶

PDF Manual for v2014b

These affect the run configuration if previously run with older versions of the model:

1. New input of three additional columns in the Meteorological input file (diffusive and direct solar radiation, and wind direction)
2. Change of input variables in InitialConditions.nml file. Note we now refer to CT as ET (ie. Evergreen trees rather than coniferous trees)
3. In GridConnectionsYYYY.txt, the site names should now be without the underscore (e.g Sm and not Sm_)

Other issues:

1. Number of grid areas that can be modelled (for one grid, one year 120; for one grid two years 80)
2. Comment about Time interval of input data
3. Bug fix: Column headers corrected in 5 min file
4. Bug fix: Surface state 60 min file - corrected to give the last 5 min of the hour (rather than cumulating through the hour)
5. Bug fix: units in the Horizontal soil water transfer
6. ErrorHints: More have been added to the problems.txt file.
7. Manual: new section on running the model appropriately
8. Manual: notation table updated
9. Possibility to add snow accumulation and melt: new paper

Järvi L, Grimmond CSB, Taka M, Nordbo A, Setälä H, and Strachan IB Version 2014: Development of the Surface Urban Energy and Water balance Scheme (SUEWS) for cold climate cities, Geosci. Model Dev. 7, 1691-1711, doi:10.5194/gmd-7-1691-Version 2014.

## 11.6. Version 2014a.1 (released 26 February 2014)¶

1. Please see the large number of changes made in the Version 2014a release.
2. This is a minor change to address installing the software.
3. Minor updates to the manual

## 11.7. Version 2014a (released 21 February 2014)¶

1. Bug fix: External irrigation is calculated as combined from automatic and manual irrigation and during precipitation events the manual irrigation is reduced to 60% of the calculated values. In previous version of the model, the irrigation was in all cases taken 60% of the calculated value, but now this has been fixed.
2. In previous versions of the model, irrigation was only allowed on the irrigated grass surface type. Now, irrigation is also allowed on evergreen and deciduous trees/shrubs surfaces. These are not however treated as separate surfaces, but the amount of irrigation is evenly distributed to the whole surface type in the modelled area. The amount of water is calculated using same equation as for grass surface (equation 5 in Järvi et al. Version 2011), and the fraction of irrigated trees/shrubs (relative to the area of tree/shrubs surface) is set in the gis file (See Table 4.11: SSss_YYYY.gis)
3. In the current version of the model, the user is able to adjust the leaf-on and leaf-off lengths in the FunctionalTypes. nml file. In addition, user can choose whether to use temperature dependent functions or combination of temperature and day length (advised to be used at high-latitudes)
4. In the gis-file, there is a new variable Alt that is the area altitude above sea level. If not known exactly use an approximate value.
5. Snow removal profile has been added to the HourlyProfileSSss_YYYY.txt. Not yet used!
6. Model time interval has been changed from minutes to seconds. Preferred interval is 3600 seconds (1 hour)
7. Manual correction: input variable Soil moisture said soil moisture deficit in the manual – word removed
8. Multiple compiled versions of SUEWS released. There are now users in Apple, Linux and Windows environments. So we will now release compiled versions for more operating systems (section 3).
9. There are some changes in the output file columns so please, check the respective table of each used output file.
10. Bug fix: with very small amount of vegetation in an area – impacted Phenology for LUMPS

## 11.8. Version 2013a¶

2. Aerodynamic resistance – when very low - no longer reverts to neutral (which caused a large jump) – but stays low
3. Irrigation day of week fixed
4. New error messages
5. min file – now includes a decimal time column – see Section 5.4 – Table 5.3

## 11.9. Version 2012b¶

1. Error message generated if all the data are not available for the surface resistance calculations
2. Error message generated if wind data are below zero plane displacement height.
3. All error messages now written to ‘Problem.txt’ rather than embedded in an ErrorFile. Note some errors will be written and the program will continue others will stop the program.
4. Default variables removed (see below). Model will stop if any data are problematic. File should be checked to ensure that reasonable data are being used. If an error occurs when there should not be one let us know as it may mean we have made the limits too restrictive.

Contents no longer used File defaultFcld=0.1 defaultPres=1013 defaultRH=50 defaultT=10 defaultU=3 RunControl.nml

• Just delete lines from file
• Values you had were likely different from these example value shown here

## 11.10. Version 2012a¶

1. Improved error messages when an error is encountered. Error message will generally be written to the screen and to the file ‘problems.txt’
2. Format of all input files have changed.
3. New excel spreadsheet and R programme to help prepare required data files. (Not required)
4. Format of coef flux (OHM) input files have changed.
• This allows for clearer identification for users of the coefficients that are actually to be used
• This requires an additional file with coefficients. These do not need to be adjusted but new coefficients can be added. We would appreciate receiving additional coefficients so they can be included in future releases – Please email Sue.
5. Storage heat flux (OHM) coefficients can be changed by
• time of year (summer, winter)
• surface wetness state
6. New files are written: DailyState.txt
• Provides the status of variables that are updated on a daily or basis or a snapshot at the end of each day.
7. Surface Types
• Clarification of surface types has been made. See GIS and OHM related files

## 11.11. Version 2011b¶

1. Storage heat flux (ΔQs) and anthropogenic heat flux (QF) can be set to be 0 W m-2
2. Calculation of hydraulic conductivity in soil has been improved and HydraulicConduct in SUEWSInput.nml is replaced with name SatHydraulicConduct
• HydraulicConduct
• GrassFractionIrrigated
• PavedFractionIrrigated
• TreeFractionIrrigated

The lower three are now determined from the water use behaviour used in SUEWS