Introduction

This page describes input and output files of TARGET. It is not intended as a full scientific description of the inner workings of the model. Please see the bibliography page for publications describing model.

Input and output files

A full example can be found in the Bitbucket code repository in the examples directory.

The table below list the required and optional input files. The following directory structure is expected. Replace [runName] with the run name defined in the control file.

runDirectory
----------- controlfiles
           -----------[runName]
                       ----------- Mawson_stations.txt
----------- input
           -----------[runName]
                       ----------- LC
                                   ----------- 25m-radius-stations_LC.csv
                       ----------- MET
                                   ----------- Mawson-meteorology_KentTown_30min.csv
----------- output
           -----------[runName]
                                   ----------- [runName].nc   The next table shows the output files produced by TARGET.

MET forcing data

TARGET requires reference meteorological data to drive the model and calculate microscale urban air temperature. The following meteorological variables are required: incoming shortwave (solar) radiation, incoming longwave (terrestrial), relative humidity, reference wind speed (typically at 10 m), and air temperature. The user must define the height above ground of reference wind speed and air temperature measurements. Ideally, meteorological data should be representative of a nearby urban site. However, the nearest airport weather station will suffice. Ideally, the ground surface characteristics (i.e. % of plan area of model land cover types) below the reference weather (i.e within 125 m radius of station) station should also be defined. If this is unknown assume reference station land cover is 100% dry grass.

Meteorological data should be stored in csv format with the following column headers:

datetime – date and time, e.g. 1/1/2011 12:00
Ta – air temperature in degrees Celsius
RH – relative humidity in percentage
WS – wind speed in meters per second
P – atmospheric pressure in mb/hPa
Kd – incoming shortwave radiation in Wm-2
Ld – incoming longwave radiation in Wm-2

Land cover data

Land cover data should be provided for the entire domain. The planar fraction of land cover types and building heights and widths for each grid cell are defined in a csv file will the following format:

FID – cell identifier, unique numerical number for each grid point.
roof – fractional roof planar area
road – fractional road planar area
watr – factional water planar area
conc – fractional concrete planar area
Veg – fractional tree planar area
dry – fractional dry grass area
irr – fractional irrigated grass/low vegetation area
H – average building height (m)
W – average street width, distance between buildings (m)

These data can be derived at resolution of the user choice. A resolution of 30 – 50m is recommended to captures microscale effects. If the user has exiting raster land cover datasets, an easy way to tabulate these data is (1) define a fishnet with resolution 30 m and (2) use ArcGIS function “tabulate area”.

Model output

The model output is netCDF format. By default, all variables are written to the output. To suppress some variables, they can be added to the control file, as below

disableOutput=Utb,Fid,modUTaRef,TbRur,HttcCan,HttcUrbNew,TsurfWall,TsurfCan,TsurfHorz,Ucan

The variables Tac, Tmrt, and UTCI will always be outputted.

The domain dimensions are set in the control file, for example, as below giving the top left x,y coordinate, the resolution of each grid square, and the x,y dimensions of the domain.

DomainDim=344,235
latEdge=-37.505054
lonEdge=144.647901
latResolution=.00004294
lonResolution=.0021849

Executing the code

The control file (Mawson_stations.txt)

#---------------------------------------------------------------------------------------------------------
####### Mawson Main Control File #######
##### AWS SITES   #####

#---------------------------------------------------------------------------------------------------------
####### INPUTS #######
site_name = "Mawson"		# site name (string)
run_name   = "Mawson_newSVF_fast_walls1a_newTree_TbRur_Tbcan_N_Y_Y_30min_kent_wall_C5_test1"  # run name (string)
inpt_met_file =  "Mawson-meteorology_KentTown_30min.csv"	# input meteorolgical file (i.e. forcing file)
inpt_lc_file  =  "25m-radius-stations_LC.csv"          #  input land cover data file
date_fmt = '%d/%m/%Y %H:%M'                            # format of datetime in input met files
timestep = '1800S'     # define in seconds 
use solve = 'N'               # if set to Y it will  solve (iteratively) Tb above canyon and roof
include roofs = 'Y'             # turn roofs on and off to affect Tac
direct roofs = 'Y'             # turn roofs on and off to affect Tac
#--------------------------------------------------------------------------------------------------------
# dates
#---------------------------------------------------------------------------------------------------------
date1A=2011,2,14,0		# year,month,day,hour	#start date for simulation (should be a minimum of 24 hours prior to date1)
date1 =2011,2,15,0		# year,month,day,hour	## the date/time for period of interest (i.e. before this will not be saved)
date2 =2011,2,16,18 		# year,month,day,hour	# end date for validation period
######################

##### Validation Info ####
val_ta = 'Y'                ## generate validation plots for Ta?
val_ts = 'Y'                ## generate validation plots for Ts?
gis_plot = 'N'              ## generated GIS validation plots?
inpt_obs_file =  'Mawson_obs_30min.csv'		## oberved AWS data (for validation)
xyresol=25
radius=25m
date1Ts1=2011,2,16,14				# year,month,day,hour # start date/time for obs Ts data (AWS)
date1Ts2=2011,2,16,16				# year,month,day,hour # end   date/time for obs Ts data (AWS)
date2Ts1=2011,2,15,2				# year,month,day,hour # start date/time for obs Ts data (AWS)
date2Ts2=2011,2,15,3				# year,month,day,hour # end   date/time for obs Ts data (AWS)
Ts_prd1 = 'day'					# names for Ts test periods
Ts_prd2 = 'night'				# names for Ts test periods
STa = '01','02','03','04','05','06','07','08','09','10','11','12','13','16','17','18','19','20','21','22','23','24','25','26','27','28','29','30'
########################


mod_ldwn = 'N'  # used modelled ldown
use_obs_ws   	= 'N'				# trigger to activate use of observed ws inputs
lat=-37.8136
domainDim=9,3
latEdge=-37.505054
lonEdge=144.647901
latResolution=.00004294
lonResolution=.0021849
disableOutput=Utb,Fid,modUTaRef,TbRur,HttcCan,HttcUrbNew,TsurfWall,TsurfCan,TsurfHorz,Ucan

Land cover (25m-radius-stations_LC.csv)

FID,roof,road,watr,conc,Veg,dry,irr,H,W
1,0.068740955,0,0,0.70984081,0.071635311,0.149782923,0,0.1,50
2,0.010130246,0,0.010130246,0.510853836,0.197539797,0.271345875,0,0.1,50
3,0.210564399,0,0.001447178,0.552098408,0.143994211,0.091895803,0,7.5,35
4,0.002894356,0,0,0.824891462,0.145441389,0.026772793,0,0.1,50
5,0.086107091,0,0.308248915,0.430535456,0.165701881,0.009406657,0,6.5,50
6,0.001447178,0,0.313314038,0.179450072,0.179450072,0.303907381,0.022431259,0.1,50
8,0.026049204,0,0.051374819,0.335745297,0.169319826,0.251808973,0.165701881,0.1,50
9,0.288712012,0,0.005065123,0.11577424,0.081041968,0.507959479,0.001447178,3.5,50
10,0.527496382,0,0,0.283646889,0.098408104,0.090448625,0,3.5,15
11,0.501447178,0,0,0.264109986,0.117221418,0.117221418,0,3.5,15
12,0.305354559,0,0.073806078,0.283646889,0.098408104,0.222141823,0.016642547,4.5,15
13,0.471780029,0,0,0.272793054,0.167149059,0.088277858,0,3.5,15
16,0.285817656,0,0,0.256150506,0.191027496,0.246020261,0.020984081,5,15
17,0.08683068,0,0,0.181620839,0.227930536,0.384949349,0.118668596,3.5,50
18,0.390738061,0,0,0.258321273,0.204775687,0.1447178,0.001447178,5,15
19,0.472503618,0,0,0.191027496,0.203328509,0.133140376,0,5,15
20,0.295947902,0,0,0.60130246,0.092619392,0.00723589,0.002894356,9,15
21,0.204775687,0,0.117945007,0.300289436,0.067293777,0.260492041,0.049204052,5,25
22,0.474674385,0,0,0.285094067,0.060781476,0.174384949,0.005065123,5,15
23,0.012301013,0,0.016642547,0.023878437,0.321273517,0.625904486,0,0.1,50
24,0,0,0.240955138,0,0.319102749,0.439942113,0,0.1,50
25,0,0,0.658465991,0,0.019536903,0.291606368,0.030390738,0.1,50
26,0,0,0.010853835,0.010130246,0.128798842,0.646164978,0.204052098,0.1,50
27,0,0,0.377713459,0,0.322720694,0.299565846,0,0.1,50
28,0,0,0,0.251085384,0.43487699,0.274240231,0.039797395,0.1,50
29,0,0,0.002170767,0.003617945,0.194645441,0.769898697,0.029667149,0.1,50
30,0,0,0.006512301,0,0.062228654,0.930535456,0.000723589,0.1,50

MET forcing data (Mawson-meteorology_KentTown_30min.csv)

datetime,Ta,RH,WS,P,Kd,Ld
1/1/2011 0:00,20.4,81,0.555555556,1011.2,0,331.45
1/1/2011 0:30,20,81,1.111111111,1011.1,0,334.73
1/1/2011 1:00,19.9,77,1.388888889,1010.9,0,335.03
1/1/2011 1:30,19.6,78,0,1010.6,0,339.27
1/1/2011 2:00,19.2,82,0.555555556,1010.8,0,338.56
1/1/2011 2:30,19.5,78,0,1010.3,0,339.48
1/1/2011 3:00,19.2,78,1.388888889,1010.6,0,336.58
1/1/2011 3:30,18.9,80,0,1011,0,331.36
1/1/2011 4:00,18.8,75,0.555555556,1010.8,0,330.04
1/1/2011 4:30,18.6,69,2.5,1012.2,0,340.36
1/1/2011 5:00,18.3,73,1.111111111,1011.6,2.01,334.76
1/1/2011 5:30,18.5,73,1.388888889,1011.3,24.61,348.78
1/1/2011 6:00,18.6,71,1.111111111,1011.7,58.19,361.7
...
...