-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathmanual.html
More file actions
286 lines (232 loc) · 13.3 KB
/
manual.html
File metadata and controls
286 lines (232 loc) · 13.3 KB
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
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<link href="favicon.ico" rel="shortcut icon" type="image/x-icon" />
<title>TARGET technical manual</title>
<link href="styles/main.css" rel="stylesheet" type="text/css">
<script type="text/javascript"
src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML">
</script>
</head>
<body id="manual">
<div class="container">
<header>
Technical Manual
</header>
<div class="sidebar1">
<ul class="nav">
<li><a href="index.html" id="homenav">Home</a></li>
<li><a href="download.html" id="downloadnav">Download</a></li>
<li><a href="manual.html" id="manualnav">Technical Manual</a></li>
<li><a href="bibliography.html" id="biblionav">Bibliography</a></li>
<!--li><a href="#">Link four</a></li-->
</ul>
<aside>
<p>Thanks for visiting</p>
</aside>
<!-- end .sidebar1 --></div>
<article class="content">
<section>
<h2>Introduction</h2>
<p>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 <a href="bibliography.html">bibliography page</a> for publications describing model.</p>
</section>
</section>
<section><h2>Input and output files</h2>
<p>A full example can be found in the Bitbucket code repository in the examples directory.
<p>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.
<p> runDirectory
<br> ----------- controlfiles
<br> -----------[runName]
<br> ----------- Mawson_stations.txt
<br> ----------- input
<br> -----------[runName]
<br> ----------- LC
<br> ----------- 25m-radius-stations_LC.csv
<br> ----------- MET
<br> ----------- Mawson-meteorology_KentTown_30min.csv
<br> ----------- output
<br> -----------[runName]
<br> ----------- [runName].nc
The next table shows the output files produced by TARGET.</p>
<table width="200" border="1">
<caption>
<h3>Input files</h3>
</caption>
<tr>
<td width="24%" class="filename"><a href="#control">Mawson_stations.txt</a></td>
<td width="62%">Control file</td>
<td width="14%">Mandatory</td>
</tr>
<tr>
<td class="filename"><a href="#LC">25m-radius-stations_LC.csv</a></td>
<td>Land cover</td>
<td>Mandatory</td>
</tr>
<tr>
<td class="filename"><a href="#MET">Mawson-meteorology_KentTown_30min.csv</a></td>
<td>MET forcing data</td>
<td>Mandatory</td>
</tr>
<h4>MET forcing data</h4>
<p>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.
<p>Meteorological data should be stored in csv format with the following column headers:
<p>datetime – date and time, e.g. 1/1/2011 12:00
<br>Ta – air temperature in degrees Celsius
<br>RH – relative humidity in percentage
<br>WS – wind speed in meters per second
<br>P – atmospheric pressure in mb/hPa
<br>Kd – incoming shortwave radiation in Wm-2
<br>Ld – incoming longwave radiation in Wm-2
<h4>Land cover data</h4>
<p>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:
<p>FID – cell identifier, unique numerical number for each grid point.
<br>roof – fractional roof planar area
<br>road – fractional road planar area
<br>watr – factional water planar area
<br>conc – fractional concrete planar area
<br>Veg – fractional tree planar area
<br>dry – fractional dry grass area
<br>irr – fractional irrigated grass/low vegetation area
<br>H – average building height (m)
<br>W – average street width, distance between buildings (m)
<p>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”.
</table>
<p> </p>
<table width="200" border="1">
<caption>
<h3>Output files</h3>
</caption>
<tr>
<td width="24%" class="filename"><a href="#output">[runName].nc</a></td>
<td width="53%">Output for each time step for each grid square.</td>
<td width="23%"> </td>
</tr>
</table>
<h4>Model output</h4>
<p>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
<p>disableOutput=Utb,Fid,modUTaRef,TbRur,HttcCan,HttcUrbNew,TsurfWall,TsurfCan,TsurfHorz,Ucan
<p>The variables Tac, Tmrt, and UTCI will always be outputted.
<p>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.
<p>DomainDim=344,235
<br>latEdge=-37.505054
<br>lonEdge=144.647901
<br>latResolution=.00004294
<br>lonResolution=.0021849
</section>
<section id=exe><h2>Executing the code </h2>
<br>$ cd src/
<br>$ cd Target/
<br>$ javac -cp ../../netcdfAll-4.6.11.jar *.java
<br>$ cd ..
<br>$ java -cp ../slf4j-jdk14-1.7.14.jar:../netcdfAll-4.6.11.jar:. Target.RunToolkit /home/user/TargetRuns/Mawson/controlfiles/Mawson/Mawson_stations.txt
</section>
<section id=control><h2>The control file (Mawson_stations.txt)</h2>
<pre>
#---------------------------------------------------------------------------------------------------------
####### 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
</pre>
</section>
<section id=LC><h2>Land cover (25m-radius-stations_LC.csv)</h2>
<pre>
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
</pre>
</section>
<section id=MET><h2>MET forcing data (Mawson-meteorology_KentTown_30min.csv)</h2>
<pre>
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
...
...
</pre>
</section>
<!-- end .content --></article>
<footer>
<p>See <a href="https://github.com/mothlight/target.github.io">https://github.com/mothlight/target.github.io</a> for source code of this site.</p>
</footer>
<!-- end .container --></div>
</body>
</html>