SUEWS Historical User Manuals (2014-2017)

20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 1/71
SUEWSUMEP
SUEWS 2016a
Thecu en  e siono SUEWSis 2016a( eleased21June2016).
Thiswikipageis egula lyupda edwi hnewde elopmen s.Themanual o SUEWS_V2016acanbe
accessedhe eandshouldbe e e encedas ollows:
Wa dHC,LJä i,SOnomu a,FLindbe g,AGabey,CSBG immond2016SUEWSManual
V2016a,h p://u ban‐clima e.ne /umep/SUEWSDepa men o Me eo ology,Un e si yo 
Reading,Reading,UK
Todownload hela es  e siono SUEWSpleasecomple e heonline o m.
NEWin his e sion:seeVe sionhis o y.
In oduc ion
Su aceU banEne gyandWa e BalanceScheme(SUEWS)(Jä ie al.2011 ,Wa de al.2016 )isable
osimula e heu ban adia ion,ene gyandwa e balancesusingonlycommonlymeasu edme eo ological
a iablesandin o ma ionabou  hesu aceco e .SUEWSu ilizesane apo a ionin e cep ionapp oach
(G immonde al.1991 ),simila  o ha usedin o es s, omodele apo a ion omu bansu aces.
O e iewo SUEWS
[1] [2]
[3]
Su acesConside edinSUEWS
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 2/71
Themodelusesse ensu ace ypes:pa ed,buildings,e e g een ees/sh ubs,deciduous ees/sh ubs,
g ass,ba esoilandwa e .Thesu aces a e o eachsu ace ypea each imes episcalcula ed om he
unningwa e balanceo  hecanopywhe e hee apo a ioniscalcula ed om hePenmanMon ei h
equa ion.Thesoilmois u ebeloweachsu ace ype(excludingwa e )is akenin oaccoun .
Ho izon almo emen o wa e abo eandbelowg oundle elisallowed.Theuse canspeci y hemodel
imes ep,bu 5miniss ongly ecommended.Themainou pu  ileisp o ideda a esolu iono 60minby
de aul .Times amps e e  o heendo  hea e agingpe iod.Themodelp o ides he adia ionandene gy
balancecomponen s,su aceandsoilwe ness,su aceandsoil uno and hed ainage o eachsu ace.
P ocessesin hemodelNe allwa e adia ion
1.NARP(Ne Allwa eRadia ionPa ame e iza ion,O e lee al.2003 ,Lo idane al.2011 ) adia ion
scheme.
2.Obse edne allwa e adia ioncanbep o idedasinpu ins eado calcula edby hemodel.The ea e
se e alop ions o modellingo usingobse ed adia ioncomponen sdependingon heda aa ailable.
Asaminimum,SUEWS equi esincomingsho wa e adia ion obep o ided.
Flux Me hods Commen s
Incomingsola  adia ion Obse ed A equi edinpu  a iable
Reanalysisda a WFD,WFDEI
Ou goingsho wa e adia ion Modelled Dependen on hesu acealbedo
Obse ed Possible ouseobse a ions
Incominglongwa e adia ion Modelled Op ions:Lo idane al.2011
Obse ed Possible ouseobse a ions
Reanalysisda a WFD,WFDEI
Ou goinglongwa e adia ion Modelled Op ions:Lo idane al.2011
Obse ed Possible ouseobse a ions
An h opogenichea  lux
1.Modelledwi hinSUEWSusingsimplean h opogenichea  luxsubmodels( woop ions):
Jä ie al.(2011) app oach,basedonhea ingandcoolingdeg eedays(allowsdis inc ionbe ween
weekdaysandweekends).
Lo idane al.(2011) app oach,basedonlinea piecewise ela ionwi hai  empe a u e.
2.P ecalcula ed aluescanbesuppliedwi h heme eo ological o cingda a, o example,
LUCY(Allene al.2011 ,Lindbe ge al.2013 )
G ea e QF(Iama inoe al.2011 )
1. OHM(Objec i eHys e esisModel,G immonde al.1991 ,G immond&Oke1999a ,2002 ).
ESTM(Elemen Su aceTempe a u eMe hod,O e lee al.2005 ).(No a ailablein 2016a)
AnOHM(Analy icalObjec i eHys e esisModel)(No a ailablein 2016a)
[4] [5]
[5]
[5]
[1]
[5]
[6] [7]
[8]
[9] [10] [11]
[12]
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 3/71
2.Al e na i elyobse a ionscanbesuppliedwi h heme eo ological o cingda a.
Tu bulen hea  luxes
1.LUMPS(LocalscaleU banMe eo ologicalPa ame e iza ionScheme,G immond&Oke2002 )
p o idesasimplemeanso es ima ingsensibleandla en hea  luxes.
2.SUEWSadop samo ebiophysicalapp oach ocalcula e hela en hea  lux; hesensiblehea  luxis
hencalcula edas he esidualo  heene gybalance.Theini iales ima eo s abili yisbasedon he
LUMPScalcula ionso  u bulen sensibleandla en hea  lux.
Fo mo ede ailsseeDi e encesbe weenSUEWS,LUMPSandFRAISE.Sensibleandla en hea  luxes
ombo hLUMPSandSUEWSa ep o idedin hemodelou pu .
Whe he  he u bulen hea  luxesa ecalcula edusingLUMPSo SUEWScanha eamajo impac on he
esul s.Fo SUEWS,anapp op ia esu aceconduc ancepa ame e isa ionisalsoc i ical .
Wa e balance
The unningwa e balancea each imes episbasedon heu banwa e balancemodelo G immonde al.
(1986) andu bane apo a ionin e cep ionschemeo G immondandOke(1991) .
P ecipi a ionisa equi ed a iablein heme eo ological o cing ile.
D ainageequa ionsandcoe icien s ousemus bespeci iedin heinpu  iles.
I iga ioncanbemodelled o obse ed aluescanbep o idedi da aa ea ailable.
Soilmois u ecanbecalcula edby hemodelo obse a ionscanbep o ided(Useo obse edsoil
mois u eno possiblein 2016a).
Runo ispe mi ed:
be weensu ace ypeswi hineachmodelg id
be weenmodelg ids(No implemen edin 2016a)
odeepsoil
opipes.
Con ec i ebounda ylaye
Acon ec i ebounda ylaye (CBL)slabmodel(CleughandG immond2001 )calcula es heCBLheigh ,
empe a u eandhumidi ydu ingday ime(Onomu ae al.2015 ).
Snowmel
Thesnowmel modelwi hinSUEWSisdesc ibedinJä ie al.(2014) .Due ochangesin henewmodel
e sionV2016awhencompa ed o heolde  e sions, hesnowcalcula ionhassligh lychanged.Themain
di e enceis ha p e iouslyallsu aces a ecould eezein1h imes epbu now heamoun o  eezing
su aces a eiscalcula edsimila wayasmel wa e can eezewi hin hesnowpack.Also hesnowmel
ela edcoe icien sha eslighlychanged(seeSUEWS_Snow. x ).
The malcom o
SOLWEIG(Sola andlongwa een i onmen ali adiancegeome ymodel,Lindbe ge al.2008 ,Lindbe g
andG immond2011 )isa2D adia ionmodel oes ima emean adian  empe a u e.
Using hemodel
Themodeldis ibu edwi h hismanualcanbe unin wos anda dways:
[11]
[1][2]
[13] [3]
[1]
[14]
[15]
[16]
[17]
[18]
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 4/71
1. o anindi iduala ea
2. o mul iplea eas
The eisno equi emen  o  hea eas obeo anypa icula shapebu he ewe e e  o hemas‘g ids’.
Modelapplicabili y:Localscale–so o cingda ashouldbeabo e heheigh o  he oughnesselemen s
( ees,buildings).
P epa ing o un hemodel
The ollowingp o idessomecommen s ohelpwi h hemodelse up.
P epa a o y eading
Read hemanualand ele an pape s(and e e ences he ein):
Jä iL,G immondCSB&Ch is enA(2011)TheSu aceU banEne gyandWa e BalanceScheme
(SUEWS):E alua ioninLosAngelesandVancou e .J.Hyd ol.411,219237.
doi:10.1016/j.jhyd ol.2011.10.00
Jä iL,G immondCSB,TakaM,No dboA,Se äläH&S achanIB(2014)De elopmen o  heSu ace
U banEne gyandWa e balanceScheme(SUEWS) o coldclima eci ies.Geosci.ModelDe .7,1691
1711.doi:10.5194/gmd716912014
Wa dHC,Ko hausS,Jä iLandG immondCSB(2016)Su aceU banEne gyandWa e Balance
Scheme(SUEWS):de elopmen ande alua iona  woUKsi es.U banClima e(inp ess)
Decidewha  ypeo model unyoua ein e es edin
A ailablein his elease
LUMPS Yes–no s andalone
SUEWSa apoin o  o anindi iduala ea Yes
SUEWS o mul ipleg idso a eas Yes
SUEWSwi hBounda yLaye (BL) Yes
O e iewo scalesSou ce:[15]
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 5/71
SUEWSwi hsnow Yes
SUEWSwi hSOLWEIG No
SUEWSwi hSOLWEIGandBL No
Impo an conside a ions:
F ac ionso di e en landco e  ypes
Heigh so buildings
Su acecha ac e is ics
Sou ceo me eo ological o cingda a
Ex e nalwa e useDoes hisoccu ?(e.g.s ee cleaning,ga deni iga ion)
An h opogenichea  luxIs hislikely obeimpo an ?(e.g.ene gyemissions om anspo ,buildings,
me abolism,e c)
(I usingsnowop ion)Doessnowclea ingoccu ?
Download hep og amandexampleda a iles
Visi  hewebsi e o ecei ealink odownload hep og amandexampleda a iles.Selec  heapp op ia e
compiled e siono  hemodel odownload.Fo windows he eisanins alla ion e sionwhichwillpu  he
p og amsandall he ilesin o heapp op ia eplace.The eisalsoa e sionlinked oQGIS:UMEP.
No e,as hede ini iono longdoublep ecision a iesbe weencompu e s(e.g.Mac sWindows)sligh ly
di e en  esul smayoccu in heou pu  iles.
Tes /example ilesa egi en o  heVancou e Sunse si e,1987da a(deno edVs87)
In he ollowingSSis hesi ecode(e.g.Vs),ss heg idID,YYYY heyea and  he imein e al.
Filename Desc ip ion Inpu /ou pu
SSss_da a. x Me eo ologicalinpu  ile(60min) Inpu
SSss_YYYY_da a_5. x Me eo ologicalinpu  ile(5min) Inpu
Ini ialCondi ionsSSss_YYYY.nml(+) Ini ialcondi ions ile Inpu
SUEWS_ 2016a_Si eIn o_SSss.xlsm Sp eadshee con ainingallo he inpu
in o ma ion Inpu
RunCon ol.nml Se smodel unop ions Inpu (loca edinmain
di ec o y)
SS_Filechoices. x Summa yo model unop ions Ou pu
SSss_YYYY_5. x (Op ional)5min esolu ionou pu  ile Ou pu
SSss_YYYY_60. x 60min esolu ionou pu  ile Ou pu
SSss_DailyS a e. x
Dailys a e a iables(allyea sinone
Ou pu

20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 6/71
ile)
(+)The eisasecond ileIni ialCondi ionsSSss_YYYY_EndO Run.nmlo Ini ialCondi ionsSSss_YYYY+1.nml
in heinpu di ec o y.A  heendo  he un,anda  heendo eachyea o  he un, hese ilesa ew i enou
so ha  hisin o ma ioncouldbeused oini ialize u he model uns.
Run hemodel o exampleda a
Be o e unning hemodel o you ownda ai isgood omakece ain ha youcan un he es da aandge
hesame esul sasin heexample ilesp o ided.I is ecommended ha youmakeacopyo  heexample
ou pu  ilesandpu  hemsomewhe eelsesoyoucancompa e he esul s.Whenyou un hep og ami will
w i eo e  hesupplied iles.
To un hemodelyoucanuseCommandP omp (in hedi ec o ywhe e hep og ammeisloca ed ype he
modelname)o jus doubleclick heexecu able ile.
SuewsW appe .exe
PleaseseeT oubleshoo ingi youha ep oblems unning hemodel.
P epa a iono da a
Thissec iondesc ibes hein o ma ion equi ed o unSUEWS o you si e.Theinpu da acanbe
summa isedas ollows:
1.Me eo ological o cingda a o  heen i epe iod obemodelledandknowledgeo  hesu aces a eand
me eo ologicalcondi ionsimmedia elybe o e hes a o  he un(i  heseini ialcondi ionsa eno known,
i isusuallypossible ode e minesui able aluesby unning hemodelandusing heou pu a  heendo
he un oin e  hecondi ionsa  hes a o  he un).
2.Theloca iono  hesi e(la i ude,longi ude,al i ude).
3.In o ma ionabou  hecha ac e is icso  hesu ace,includinglandco e ,heigh so buildingsand ees,
adia i echa ac e is ics(e.g.albedo,emissi i y),d ainagecha ac e is ics,soilcha ac e is ics,snow
cha ac e is ics,phenologicalcha ac e is ics(e.g.seasonalcycleo LAI).
4.In o ma ionabou humanbeha iou ,includingene gyuseandwa e use(e.g. o i iga ion)andsnow
clea ing(i applicable).Thean h opogenicene gyuseandwa e usemaybep o idedasa imese iesin
heme eo ological o cing ilei  heseda aa ea ailableo modelledbasedonpa ame e sp o ided o
hemodel,includingpopula iondensi y,hou lyandweeklyp o ileso ene gyandwa e use,in o ma ion
abou  hep opo iono p ope iesusingi iga ionand he ypeo i iga ion(au oma ico manual).
P epa a iono si echa ac e is icsandmodelpa ame e s
Thea ea obemodelledisdesc ibedbyase o cha ac e is ics ha a especi iedin he
SUEWS_Si eSelec . x  ile.Each owco esponds oonemodelg id o oneyea (i.e. unningasingleg id
o e  h eeyea swould equi e h ee ows; unning wog idso e  woyea swould equi e ou  ows).
Cha ac e is icsa eo enselec edbyacode o apa icula se o condi ions.Fo example,aspeci icsoil
ype(links oSUEWS_Soil. x )o cha ac e is icso deciduous eesinapa icula  egion(links o
SUEWS_Veg. x ).Thein en is obuildalib a yo cha ac e is ics o di e en  ypeso u bana eas.The
codesa especi iedby heuse ,mus bein ege  aluesandmus beuniquewi hin he i s columno each
inpu  ile,o he wise hemodelwill e u nane o .(No einSUEWS_Si eSelec . x  he i s columnislabelled
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 7/71
'G id'andcancon ain epea  alues o di e en yea s.)SeeInpu  iles o de ails.
Landco e
Fo eachg id, helandco e mus beclassi iedusing he ollowingsu ace ypes:
Classi ica ion Su ace ype Filewhe echa ac e is icsa especi ied
Non ege a ed Pa edsu aces SUEWS_NonVeg. x
Buildingsu aces SUEWS_NonVeg. x
Ba esoilsu aces SUEWS_NonVeg. x
Vege a ion E e g een eesandsh ubs SUEWS_Veg. x
Deciduous eesandsh ubs SUEWS_Veg. x
G ass SUEWS_Veg. x
Wa e Wa e SUEWS_Wa e . x
Snow Snow SUEWS_Snow. x
Thesu aceco e  ac ions(i.e.p opo iono  heg id akenupbyeachsu ace)mus bespeci iedin
SUEWS_Si eSelec . x .Thesu aceco e  ac ionsa ec i ical,somakece ain ha  hedi e en su ace
co e  ac ionsa eapp op ia e o you si e.
Fo someloca ions,landco e in o ma ionmaybeal eadya ailable(e.g. om a ious emo esensing
esou ces).I no ,websi eslikeBingMapsandGoogleMapsallowyou oseeae ialimageso you si eand
canbeused oes ima e he ela i ep opo iono eachlandco e  ype.I de ailedspa ialda ase sa e
a ailable,UMEPallows o adi ec link oaGISen i onmen usingQGIS.
An h opogenichea  lux
Thepopula iondensi yisneededasaninpu  o LUMPSandSUEWS ocalcula eQF.I youha eno
in o ma ionabou  hepopula iono  hesi ewe ecommend ha youuse heLUCYmodel   oes ima e
hean h opogenichea  luxwhichcan henbep o idedasinpu SUEWSalongwi h heme eo ological
o cingda a.TheLUCYmodelcanbedownloaded omhe e.
O he in o ma ion
Thesu aceco e  ac ionsandpopula iondensi ycanha eamajo impac on hemodelou pu .Howe e ,
i isimpo an  oconside  hesui abili yo allpa ame e s o you si e.Usinginapp op ia epa ame e smay
esul in hemodel e u ningane o o ,wo se,gene a ingou pu  ha issimplyno  ep esen a i eo you
si e.Please ead hesec iononInpu  iles.Recommendedo  easonable angeso  aluesa esugges ed o
somepa ame e s,alongwi himpo an conside a ionsonhow oselec app op ia e alues o you si e.
Da aEn y
Toc ea e hese ieso inpu  ex  ilesdesc ibing hecha ac e is icso you si e, he ea e h eeop ions:
1.Da acanbeen e eddi ec lyin o heinpu  ex  iles.Theexample(. x ) ilesp o idea empla e oc ea e
you own ileswhichcanbeedi edwi ha ex edi o di ec ly.
[6] [7]
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 8/71
2.Da acanbeen e edin o hesp eadshee SUEWS_Si eIn o.xlsmand heinpu  ex  ilesgene a edby
unning hemac o.
3.UseUMEP.
To un hexlsmmac o:En e  heda a o you si ein o hexlsmsp eadshee
SUEWS_ 2016a_Si eIn o.xlsmand henuse hemac o oc ea e he ex  ileswhichwillappea  hesame
di ec o y.
I  he eisap oblem
Makesu enoneo  he ex  iles obegene a eda eopen.
I is ecommended oclose hesp eadshee be o e unning heac ualmodelcode.
No e ha inall x  iles:
The i s  wo owsa eheade s.The i s  owis hecolumnnumbe ; hesecond owis hecolumnname.
Thenamesando de o  hecolumnsshouldno beal e ed om he empla es,as hesea echeckedby
hemodelande o swillbe e u nedi pa icula columnscanno be ound.
All ilesshouldha e wo owswi h9incolumn1as hei las  wo ows.
“!”indica esacommen ,soany ex  ollowing"!"on hesamelinewillno be eadby hemodel.
I da aa euna ailableo no  equi ed,en e  he alue999in heco ec placein heinpu  ile.
Ensu e heuni sa eco ec  o allinpu in o ma ion.SeeInpu  iles o adesc ip iono pa ame e s.
Inaddi ion o hese ex  iles, he ollowing ilesa ealsoneeded o un hemodel.
P epa a iono  heRunCon ol ile
In heRunCon ol.nml ile hesi ename(SS_)anddi ec o ies o  hemodelinpu andou pu a egi en.This
meansbe o e unning hemodel(e en hewi h heexampleda ase s)youmus ei he
1.open heRunCon ol.nml ileandedi  heinpu andou pu  ilepa hsand hesi ename(wi ha ex edi o )
so ha  heya eco ec  o you se up,o
2.c ea e hedi ec o iesspeci iedin heRunCon ol.nml ile
F om hegi ensi eiden i ica ion hemodeliden i ies heinpu  ilesandgene a es heou pu  iles.Fo
examplei youspeci y
FileOu pu Pa h=“C: Folde Name SUEWSOu pu ”andusesi ecodeSS hemodelc ea esan
ou pu  ile
C: Folde Name SUEWSOu pu SSss_YYYY_60. x ( emembe  oadd helas backslashin
windowsandslashinLinux/Mac).
I  he ilepa hsa eno co ec  hep og amwill e u nane o when un(Run imeE o ,Filepa hno
ound,seee o messages)andw i e hee o  o hep oblems. x  ile.
P epa a iono  heMe eo ological o cingda a
Themodelisdesigned ouse(60min)hou lyinpu da a,whichisin e pola ed o hemodel imes ep
speci iedinRunCon ol.nml(e.g.5min).Seede ailsabou  heme eo ological o cingda a olea nmo e
abou choiceso da ainpu .Eachg idcanha ei sownme eo ological o cing ile,o asingle ilecanbe
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 9/71
used o allg ids.
P epa a iono  heIni ialCondi ions ile
In o ma ionabou  hesu aces a eandme eo ologicalcondi ionsjus be o e hes a o  he una e
p o idedin heIni ialCondi ions ile.One ileisneeded o eachg id.Fo de ailsseeIni ialCondi ions.
Run hemodel o you si e
To un hemodelyoucanuseCommandP omp (in hedi ec o ywhe e hep og ammeisloca ed ype he
modelname)o jus doubleclick heexecu able ile.
SuewsW appe .exe
PleaseseeT oubleshoo ingi youha ep oblems unning hemodel.
Analyse heou pu
I isagoodidea ope o mini ialchecks ha  hemodelou pu looks easonable.
Cha ac e is ic Things ocheck
Albedo
Is hebulkalbedoco ec ?
Thisisc i icalbecauseasmalle o hasanimpac onall he luxes(ene gyand
hyd ology)
I youha emeasu emen so ou goingsho wa e adia ioncompa e hesewi h he
modelled alues.
Howdo he aluescompa e oli e a u e alues o you a ea?
Lea a ea
index
Does hephenologylookapp op ia e(i.e.wha does heseasonalcycleo lea a ea
index(LAI)looklike?)
A e helea eson he eesa app oxima ely he igh  imeo  heyea ?
Summa yo  iles
The ablebelowlis s he iles equi ed o unSUEWSand heou pu  ilesp oduced.SSis he wole e code
(speci iedinRunCon ol) ep esen ing hesi ename,ssis heg ididen i ica ion(in ege  aluesbe ween0
and99999)andYYYYis heyea .
Thelas columnindica eswhe he  he ilesa eneeded/p oducedoncepe  un(1/ un),o oncepe day
(1/day), o eachyea (1/yea )o  o eachg id(1/g id).
[B]indica es ilesusedwi h hebounda ylaye pa o SUEWS(BLUEWS)and he e o e
a eonlyneeded/p oducedi  hisop ionisselec ed
[E]indica es ilesassocia edwi hESTMs o agehea  luxmodelsand he e o ea e
onlyneeded/p oducedi  hisop ionisselec ed
Filename Desc ip ion Loca ion Op ion
P og am
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 16/71
2 Da aa ep o idedasg a ime icsoilmois u econ en .Me ada a
mus bep o idedinSUEWS_Soil. x .
SnowF ac ionChoice
De e minesme hod o calcula ingsnowplana ea ac ion.Usedonlyi
SnowUse=1.
Value Commen s
2Se  o2incu en  elease.
SnowUse
De e mineswhe he  hesnowpa o  hemodel uns.
Value Commen s
0Snowcalcula ionsa eno pe o med.
1Snowcalcula ionsa epe o med.
SOLWEIGUse
De e mineswhe he ahigh esolu ion adia ionmodel ocalcula emean
adian  empe a eshouldbeused(SOLWEIG).NOTE: hisop ionwill
conside ablyslowdown hemodelsinceSOLWEIGisa2Dmodel.
Value Commen s
0SOLWEIGcalcula ionsa eno pe o med.
1
SOLWEIGcalcula ionsa epe o med.Ag ido mean adian
empe a u e(Tm )iscalcula edbasedonhigh esolu iondigi al
su acemodels.
S abili yMe hod
De ineswhicha mosphe ics abili y unc ionsa eused.
Value Commen s
0No used.
1No used.
2
Recommended
Momen umuns able:Dye (1974) modi iedbyHögs om(1988)
;s able:VanUldenandHol slag(1985)
Hea Dye (1974) modi iedbyHögs om(1988)
Momen um:CampbellandNo man(Eq7.27,Pg97)
Hea uns able:CampbellandNo man ;s able:Dye (1974)
[22]
[23] [24]
[22] [23]
[25]
[25] [22]

20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 17/71
3 modi iedbyHögs om(1988)
4
Momen um:Businge e al.(1971) modi iedbyHögs om(1988)
Hea :Businge e al.(1971) modi iedbyHögs om(1988)
WUChoice
De ineshowex e nalwa e useiscalcula ed.
Value Commen s
0
Ex e nalwa e usemodelledusingpa ame e sspeci iedin
SUEWS_I iga ion. x .
1
Obse a ionso ex e nalwa e usep o idedin heme eo ological
o cing ilea eused.
z0_me hod
De e mineshowae odynamic oughnessleng h(z0m)andze o
displacemen heigh (zdm)a ecalcula ed.
Value Commen s
1
Valuesspeci iedinSUEWS_Si eSelec . x a eused.
z0mandzda eadjus edwi h ime oaccoun  o seasonal a ia ion
inpo osi yo deciduous ees.
2
z0mandzda ecalcula edusing' uleo  humb'(G immondand
Oke1999 )usingmeanbuildingand eeheigh speci iedin
SUEWS_Si eSelec . x .
3
z0mandzda ecalcula edbasedon heMacDonalde al.(1998)
me hodusingmeanbuildingand eeheigh s,plana ea ac ion
and on ala ealindexspeci iedinSUEWS_Si eSelec . x .
File ela edop ions
FileChoice Twole e si eiden i ica ioncode(e.g.He,Sc,Kc).
FileInpu Pa h Inpu di ec o y.
FileOu pu Pa h Ou pu di ec o y.
SkipHeade Si eIn o Numbe o heade lines oskipinSUEWS_Si eIn o ex  iles(2by
de aul ).
SkipHeade Me Numbe o heade lines oskipme eo ological o cing ile(1byde aul ).
[23]
[26]
[23]
[26] [23]
[27]
[28]
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 18/71
Mul ipleMe Files
Speci ieswhe he onesingleme eo ological o cing ileisused o all
g idso asepa a eme  ileisp o ided o eachg id.
Value Commen s
0
Singleme eo ological o cing ileused o allg ids.
Thesingle ileshouldbenamedwi h he i s g id.
1
Sepa a eme eo ological o cing ilesused o eachg id.
Theg idnumbe shouldappea in he ilename.
KeepTs epFilesIn
Speci ieswhe he inpu me eo ological o cing ilesa  he esolu iono
hemodel imes epshouldbekep whenusing hew appe .
Value Commen s
0
Me eo ological o cing ilesa model imes epdele ed.
Recommended osa ediskspaceas(e.g.5min) ilescanbela ge.
1Me eo ological o cing ilesa model imes epa eno dele ed.
KeepTs epFilesOu
Speci ieswhe he ou pu me eo ological o cing ilesa  he esolu iono
hemodel imes epshouldbekep whenusing hew appe .
Value Commen s
0
Ou pu  ilesa model imes epdele ed.
Recommended osa ediskspaceas(e.g.5min) ilescanbela ge.
1Ou pu  ilesa model imes epa eno dele ed.
W i eSu sFile
Speci ieswhe he anou pu  ilea  he esolu iono  hemodel imes ep
con ainingall hewa e balance,ene gybalanceandsnow a iables o
eachsu ace ypeshouldbew i en.
Value Commen s
0
Ou pu  iles o eachsu ace ypeno w i en.
Recommended osa ediskspaceas(e.g.5min) ilescanbela ge.
1
Ou pu  iles o eachsu ace ypew i en.
No a ailableincu en  elease.
Time ela edop ions
TimeZone Timezone[h] o si e ela i e oUTC(eas isposi i e).
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 19/71
Ts ep
Speci ies hemodel imes ep[s].A alueo 300s(5min)iss ongly
ecommended.The imes epcanno beless han1mino g ea e  han
10min,andmus beawholenumbe o minu es ha di idein oanhou
(i.e.op ionsa e1,2,3,4,5,6,10mino 60,120,180,240,300,360,600
s).
Da a ela edop ions
z
Heigh [m]o  heme eo ological o cingda a.Themos impo an heigh
is ha o  hewindspeedmeasu emen .Mus beg ea e  han he
displacemen heigh .Fo cingda ashouldbe ep esen a i eo  helocal
scale,i.e.abo e heheigh o  he oughnesselemen .
SUEWS_Si eSelec . x
Fo eachyea andeachg id,si especi icsu aceco e in o ma ionando he inpu pa ame e sisp o ided
oSUEWSbySUEWS_Si eSelec . x .Themodelcu en ly equi esanew ow o eachyea o  hemodel
un.All owsin his ile(be o e he wo owso '9')willbe eadby hemodeland un.In his ile hecolumn
o de isimpo an .'!'canbeused oindica ecommen sin he ile.Commen sa eno  eadby he
p og ammeso heycanbeusedby heuse  op o ideno es o  hei in e p e a iono  hecon en s.Thisis
s ongly ecommended.
Use Column
MU Pa ame e swhichmus besuppliedandmus bespeci ic o  hesi e/g idbeing un.
MD Pa ame e swhichmus besuppliedandmus bespeci ic o  hesi e/g idbeing un(bu de aul
aluesmaybeoki  hese aluesa eno knownspeci ically o  hesi e).
OPa ame e s ha a eop ional,dependingon hemodelse ingsinRunCon ol.Se anypa ame e s
ha a eno used/no known o‘999’.
L
Codes ha a eused olinkbe ween heinpu  iles.Thesecodesa e equi edbu  hei  aluesa e
comple elya bi a y,p o iding ha  heylink heinpu  ilesin heco ec way.Theuse should
choose hesecodes,bea inginmind ha  hecodes heyma chupwi hincolumn1o  he
co espondinginpu  ilemus beuniquewi hin ha  ile.Codesmus bein ege s.No e ha  hecodes
mus ma chupwi hcolumn1o  heco espondinginpu  ile,e eni  hosepa ame e sa eno used
(inwhichcasese allcolumnsexcep column1 o‘999’in heco espondinginpu  ile),o he wise
hemodel unwill ail.
No. Use Columnname Example Desc ip ion
G idnumbe (anyin ege 099999)iden i ying he
cu en g id.
G idnumbe sdono need obeconsecu i eand
dono need os a a apa icula  alue.
Eachg idmus ha eauniqueg idnumbe .
Allg idsmus bep esen  o allyea s.
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 20/71
1 MU G id 1
Theseg idnumbe sa e e e ed oin
G idConnec ions(columns5873)(no a ailable
in his elease!)
The wolas linesin hiscolumnmus  ead'9' o
indica e ha  helas linesha ebeen eached(using
wolinesallowsdi e encesincompu e  ilesa ings
obedeal wi h).
2 MU Yea 2011
Yea [YYYY]
Yea smus becon inuous.
3 MU S a DLS 86
S a o  hedayligh sa ings[DOY]
Inno he nhemisphe eexample,dayligh sa ing
s a sondayo yea 86.Seesec iononDayLigh
Sa ings.
4 MU EndDLS 303
Endo  hedayligh sa ings[DOY]
Inno he nhemisphe eexample,dayligh sa ing
inisheson303.Seesec iononDayLigh Sa ings.
5 MU la 60.00
La i ude o  hecen eo  heg id[decimaldeg ees]
Usecoo dina esys emWGS84.
Posi i e aluesa eno he nhemisphe e
(nega i esou he nhemisphe e).
Usedin adia ioncalcula ions.
No e,i  he o almodelleda eaissmall he
la i udeandlongi udecouldbe hesame o each
g idbu smalldi e encesin adia ionwillno be
de e mined.I youa ede ining hela i udeand
longi udedi e en lybe weeng idsmakece ain
ha youp o ideenoughdecimalplaces.
6 MU lng 18.20
Longi ude o  hecen eo  heg id[decimal
deg ees]
Usecoo dina esys emWGS84.
Posi i e aluesa e o hewes (nega i e alues
a e o heeas ).
Seela i ude o mo ede ails.
7 MU Su aceA ea 75.3 A eao  heg id[ha].
Al i ude[m]
Mean opog aphicheigh abo eseale el.
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 21/71
8 MU Al 25.0 Used o bo h he adia ionandwa e  low
be weeng ids.
9 MD id 1
Day[DOY]
Se  o1in his e sion
10 MD ih 0
Hou [H]
Se  o0in his e sion
11 MD imin 0
Minu e[M]
Se  o0in his e sion
12 MU F _Pa ed 0.20
Su aceco e  ac iono pa edsu aces[]
A ealco e  ac iono pa edsu aces( oads,
pa emen s,ca pa ks).e.g.20%o  heg idis
co e edwi hpa edsu aces.
Columns12 o18mus sum o1.
13 MU F _Bldgs 0.20 Su aceco e  ac iono buildings[]
14 MU F _E eT 0.10 Su aceco e  ac iono e e g een eesandsh ubs
[]
15 MU F _DecT 0.10 Su aceco e  ac iono deciduous eesandsh ubs
[]
16 MU F _G ass 0.30 Su aceco e  ac iono g ass[]
17 MU F _Bsoil 0.05 Su aceco e  ac iono ba esoilo unmanaged
land[]
18 MU F _Wa e 0.05
Su aceco e  ac iono openwa e []
(e.g. i e ,lakes,ponds,swimmingpools)
19 MU I F _E eT 0.50
F ac iono e e g een ees ha a ei iga ed[]
e.g.50%o  hee e g een ees/sh ubsa ei iga ed
20 MU I F _DecT 0.20 F ac iono deciduous ees ha a ei iga ed[]
21 MU I F _G ass 0.70 F ac iono g ass ha isi iga ed[]
22 MU H_Bldgs 10 Meanbuildingheigh [m]
23 MU H_E eT 15 Meanheigh o e e g een ees[m]

20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 22/71
24 MU H_DecT 15 Meanheigh o deciduous ees[m]
25 O z0 0.6
Roughnessleng h o momen um[m]
Valuesuppliedhe eisusedi z0_me hod=1in
RunCon ol.nml;o he wisese  o'999'anda alue
willbecalcula edby hemodel(z0_me hod=2,3).
26 O Zd 1.5
Ze oplanedisplacemen [m]
Valuesuppliedhe eisusedi z0_me hod=1in
RunCon ol.nml;o he wisese  o'999'anda alue
willbecalcula edby hemodel(z0_me hod=2,3).
27 O FAI_Bldgs 0.1
F on ala eaindex o buildings[]
Requi edi z0_me hod=3inRunCon ol.nml.
28 O FAI_E eT 0.2
F on ala eaindex o e e g een ees[]
Requi edi z0_me hod=3inRunCon ol.nml.
29 O FAI_DecT 0.2
F on ala eaindex o deciduous ees[]
Requi edi z0_me hod=3inRunCon ol.nml.
30 O PopDensDay 30.7
Day imepopula iondensi y(i.e.wo ke s, ou is s)
[peopleha1]
No usedincu en  e siono  hemodel.
31 O PopDensNigh 10.2
Nigh  imepopula iondensi y(i.e. esiden s)[people
ha1]
Requi edi An h opHea Choice=2in
RunCon ol.nml.
32 L Code_Pa ed 331
Code o Pa edsu acecha ac e is ics
P o ides helink ocolumn1o SUEWS_NonVeg. x ,
whichcon ains hea ibu esdesc ibingpa eda eas
in hisg id o  hisyea .Valueo in ege isa bi a y
bu mus ma chcodespeci iedincolumn1o
SUEWS_NonVeg. x .e.g.331meansuse he
cha ac e is icsspeci iedin he owo inpu  ile
SUEWS_NonVeg. x whichhas331incolumn1
(Code).
Code o Bldgssu acecha ac e is ics
P o ides helink ocolumn1o SUEWS_NonVeg. x ,
whichcon ains hea ibu esdesc ibingbuildingsin
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 23/71
33 L Code_Bldgs 332 hisg id o  hisyea .Valueo in ege isa bi a ybu
mus ma chcodespeci iedincolumn1o
SUEWS_NonVeg. x .
34 L Code_E eT 331
Code o E eT su acecha ac e is ics
P o ides helink ocolumn1o SUEWS_Veg. x ,
whichcon ains hea ibu esdesc ibinge e g een
eesandsh ubsin hisg id o  hisyea .Valueo
in ege isa bi a ybu mus ma chcodespeci iedin
column1o SUEWS_Veg. x .
35 L Code_DecT 332
Code o DecT su acecha ac e is ics
P o ides helink ocolumn1o SUEWS_Veg. x ,
whichcon ains hea ibu esdesc ibingdeciduous
eesandsh ubsin hisg id o  hisyea .Valueo
in ege isa bi a ybu mus ma chcodespeci iedin
column1o SUEWS_Veg. x .
36 L Code_G ass 333
Code o G asssu acecha ac e is ics
P o ides helink ocolumn1o SUEWS_Veg. x ,
whichcon ains hea ibu esdesc ibingg ass
su acesin hisg id o  hisyea .Valueo in ege is
a bi a ybu mus ma chcodespeci iedincolumn1
o SUEWS_Veg. x .
37 L Code_Bsoil 333
Code o BSoilsu acecha ac e is ics
P o ides helink ocolumn1o SUEWS_NonVeg. x ,
whichcon ains hea ibu esdesc ibingba esoilin
hisg id o  hisyea .Valueo in ege isa bi a ybu
mus ma chcodespeci iedincolumn1o
SUEWS_NonVeg. x .
38 L Code_Wa e 331
Code o Wa e su acecha ac e is ics
P o ides helink ocolumn1o SUEWS_Wa e . x ,
whichcon ains hea ibu esdesc ibingopenwa e
in hisg id o  hisyea .Valueo in ege isa bi a y
bu mus ma chcodespeci iedincolumn1o
SUEWS_Wa e . x .
39 MD LUMPS_D Ra e 0.25
D ainage a eo bucke  o LUMPS[mmh1]
Used o LUMPSsu acewe nesscon ol.De aul
ecommended alueo 0.25mmh1 omLo idane
al.(2011) .
[5]
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 24/71
40 MD LUMPS_Co e 1
Limi whensu ace o allyco e edwi hwa e [mm]
Used o LUMPSsu acewe nesscon ol.De aul
ecommended alueo 1mm omLo idane al.
(2011) .
41 MD LUMPS_MaxRes 10
Maximumwa e bucke  ese oi [mm]
Used o LUMPSsu acewe nesscon ol.De aul
ecommended alueo 10mm omLo idane al.
(2011) .
42 MD NARP_T ans 1
A mosphe ic ansmissi i y o NARP[]
Valuemus in he ange01.De aul  ecommended
alueo 1.
43 L CondCode 33
Code o su aceconduc ancepa ame e s
P o ides helink ocolumn1o
SUEWS_Conduc ance. x ,whichcon ains he
pa ame e s o  heJa is(1976)pa ame e isa iono
su aceconduc ance.Valueo in ege isa bi a ybu
mus ma chcodespeci iedincolumn1o
SUEWS_Conduc ance. x .e.g.33meansuse he
cha ac e is icsspeci iedin he owo inpu  ile
SUEWS_Conduc ance. x whichhas33incolumn1
(Code).
44 L SnowCode 33
Code o snowsu acecha ac e is ics
P o ides helink ocolumn1o SUEWS_Snow. x ,
whichcon ains hea ibu esdesc ibingsnow
su acesin hisg id o  hisyea .Valueo in ege is
a bi a ybu mus ma chcodespeci iedincolumn1
o SUEWS_Snow. x .
45 L SnowClea ingP o WD 331
Code o snowclea ingp o ile(weekdays)
P o ides helink ocolumn1o SUEWS_P o iles. x .
Valueo in ege isa bi a ybu mus ma chcode
speci iedincolumn1o SUEWS_P o iles. x .e.g.
331meansuse hecha ac e is icsspeci iedin he
owo inpu  ileSUEWS_P o iles. x whichhas331in
column1(Code).
Code o snowclea ingp o ile(weekends)
[5]
[5]
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 25/71
46 L SnowClea ingP o WE 332
P o ides helink ocolumn1o SUEWS_P o iles. x .
Valueo in ege isa bi a ybu mus ma chcode
speci iedincolumn1o SUEWS_P o iles. x .e.g.
332meansuse hecha ac e is icsspeci iedin he
owo inpu  ileSUEWS_P o iles. x whichhas332in
column1(Code).P o iding hesamecode o
SnowClea ingP o WDandSnowClea ingP o WE
wouldlink o hesame owinSUEWS_P o iles. x ,
i.e. hesamep o ilewouldbeused o weekdays
andweekends.
47 L An h opogenicCode 33
Code o modellingan h opogenichea  lux
P o ides helink ocolumn1o
SUEWS_An h opogenicHea . x ,whichcon ains he
modelcoe icien s o es ima iono  he
an h opogenichea  lux(usedi An h opHea Choice
=1,2inRunCon ol.nml).Valueo in ege is
a bi a ybu mus ma chcodespeci iedincolumn1
o SUEWS_An h opogenicHea . x .
48 L Ene gyUseP o WD 333
Code o ene gyusep o ile(weekdays)
P o ides helink ocolumn1o SUEWS_P o iles. x .
Valueo in ege isa bi a ybu mus ma chcode
speci iedincolumn1o SUEWS_P o iles. x .
49 L Ene gyUseP o WE 334
Code o ene gyusep o ile(weekends)
P o ides helink ocolumn1o SUEWS_P o iles. x .
Valueo in ege isa bi a ybu mus ma chcode
speci iedincolumn1o SUEWS_P o iles. x .
50 L I iga ionCode 33
Code o modellingi iga ion
P o ides helink ocolumn1o
SUEWS_I iga ion. x ,whichcon ains hemodel
coe icien s o es ima iono  hewa e use(usedi
WU_Choice=0inRunCon ol.nml).Valueo in ege
isa bi a ybu mus ma chcodespeci iedincolumn
1o SUEWS_I iga ion. x .
51 L Wa e UseP o ManuWD 335
Code o wa e usep o ile(manuali iga ion,
weekdays)
P o ides helink ocolumn1o SUEWS_P o iles. x .
Valueo in ege isa bi a ybu mus ma chcode
speci iedincolumn1o SUEWS_P o iles. x .
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 32/71
3 FalkandNiemczynowicz(1978) Recommended  o Pa ed
andBldgs
Coe icien sa especi iedin he ollowing wocolumns.
10MDD ainageCoe 1Coe icien  o d ainageequa ion[uni s a yacco ding oD ainageEqspeci iedin
p e iouscolumn]
Example alues D ainageEq
10 Coe icien D0[mmh1] 3 Recommended  o Pa edandBldgs
0.013 Coe icien D0[mmh1] 2 Recommended  o BSoil
11MDD ainageCoe 2Coe icien  o d ainageequa ion[uni s a yacco ding oD ainageEqspeci iedin
p e iouscolumn]
Example alues D ainageEq
3 Coe icien b[] 3 Recommended  o Pa edandBldgs
1.71 Coe icien b[mm1] 2 Recommended  o BSoil
12LSoilTypeCodeCode o soilcha ac e is icsbelow hissu ace
P o ides helink ocolumn1o SUEWS_Soil. x ,whichcon ains hea ibu esdesc ibingsubsu acesoil o
hissu ace ype.Valueo in ege isa bi a ybu mus ma chcodespeci iedincolumn1o SUEWS_Soil. x .
13OSnowLimPa chMaximumSWE[mm]
Limi o snowwa e equi alen when hesu aceis ullyco e edwi hsnow.
Example alues[mm]
190 Pa ed Jä ie al.(2014)
190 Bldgs Jä ie al.(2014)
190 BSoil Jä ie al.(2014)
No neededi SnowUse=0inRunCon ol.nml.
14OSnowLimRemo eSWEwhensnowis emo ed om hissu ace[mm]
Limi o snowwa e equi alen whensnowis emo ed ompa edsu acesandbuildings
Cu en lyno implemen ed o BSoilsu ace
Example alues[mm]
40 Pa ed Jä ie al.(2014)
100 Bldgs Jä ie al.(2014)
[29]
[3]
[3]
[3]
[3]
[3]
[16]
[16]
[16]
[16]
[16]

20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 33/71
No neededi SnowUse=0inRunCon ol.nml.
15LOHMCode_Summe We Code o OHMcoe icien s ouse o  hissu acedu ingwe condi ionsin
summe .
Links oSUEWS_OHMCoe icien s. x .Valueo in ege isa bi a ybu mus ma chcodespeci iedincolumn
1o SUEWS_OHMCoe icien s. x .
16LOHMCode_Summe D yCode o OHMcoe icien s ouse o  hissu acedu ingd ycondi ionsin
summe .
Links oSUEWS_OHMCoe icien s. x .Valueo in ege isa bi a ybu mus ma chcodespeci iedincolumn
1o SUEWS_OHMCoe icien s. x .
17LOHMCode_Win e We Code o OHMcoe icien s ouse o  hissu acedu ingwe condi ionsinwin e .
Links oSUEWS_OHMCoe icien s. x .Valueo in ege isa bi a ybu mus ma chcodespeci iedincolumn
1o SUEWS_OHMCoe icien s. x .
18LOHMCode_Win e D yCode o OHMcoe icien s ouse o  hissu acedu ingd ycondi ionsinwin e .
Links oSUEWS_OHMCoe icien s. x .Valueo in ege isa bi a ybu mus ma chcodespeci iedincolumn
1o SUEWS_OHMCoe icien s. x .
SUEWS_Veg. x
SUEWS_Veg. x speci ies hecha ac e is ics o  he ege a edsu aceco e  ypes(E eT ,DecT ,G ass)by
linkingcodesincolumn1o SUEWS_Veg. x  o hecodesspeci iedinSUEWS_Si eSelec . x (Code_E eT ,
Code_DecT ,Code_G ass).Each owshouldco espond oapa icula su ace ype.Fo sugges ionson
how ocomple e his able,see:TypicalValues.
No.UseColumnnameExampleDesc ip ion
Coe icien sa especi iedin he ollowing ou columns.
N.B.No handSou hhemisphe esa e ea edsligh lydi e en ly.
Cu en lyonly heDecT  aluesa eused; alues o o he su acesigno ed!
22MDLea G ow hPowe 1Coe icien (powe ) o lea g ow h[]
SeeAppendixAJä ie al.(2014)  o mo ede ails.
Example alues LAIEq
0.03 Jä ie al.(2011) 0
0.04 Jä ie al.(2014) 1
Cu en lyonly heDecT  aluesa eused; alues o o he su acesigno ed!
23MDLea G ow hPowe 2Cons an in helea g ow hequa ion[°C1]
SeeAppendixAJä ie al.(2014)  o mo ede ails.
Example alues[°C1] LAIEq
0.0005 Jä ie al.(2011) 0
[16]
[1]
[16]
[16]
[1]
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 34/71
0.0010 Jä ie al.(2014) 1
Cu en lyonly heDecT  aluesa eused; alues o o he su acesigno ed!
24MDLea O Powe 1Coe icien (powe ) o lea o []
SeeAppendixAJä ie al.(2014)  o mo ede ails.
Example alues LAIEq
0.03 Jä ie al.(2011) 0
1.5 Jä ie al.(2014) 1
Cu en lyonly heDecT  aluesa eused; alues o o he su acesigno ed!
25MDLea O Powe 2Cons an in helea o equa ion[°C1]
SeeAppendixAJä ie al.(2014)  o mo ede ails.
Example alues[°C1] LAIEq
0.0005 Jä ie al.(2011) 0
0.0015 Jä ie al.(2014) 1
Cu en lyonly heDecT  aluesa eused; alues o o he su acesigno ed!
26LOHMCode_Summe We Code o OHMcoe icien s ouse o  hissu acedu ingwe condi ionsin
summe .
Links oSUEWS_OHMCoe icien s. x .Valueo in ege isa bi a ybu mus ma chcodespeci iedincolumn
1o SUEWS_OHMCoe icien s. x .
27LOHMCode_Summe D yCode o OHMcoe icien s ouse o  hissu acedu ingd ycondi ionsin
summe .
Links oSUEWS_OHMCoe icien s. x .Valueo in ege isa bi a ybu mus ma chcodespeci iedincolumn
1o SUEWS_OHMCoe icien s. x .
28LOHMCode_Win e We Code o OHMcoe icien s ouse o  hissu acedu ingwe condi ionsinwin e .
Links oSUEWS_OHMCoe icien s. x .Valueo in ege isa bi a ybu mus ma chcodespeci iedincolumn
1o SUEWS_OHMCoe icien s. x .
29LOHMCode_Win e D yCode o OHMcoe icien s ouse o  hissu acedu ingd ycondi ionsinwin e .
Links oSUEWS_OHMCoe icien s. x .Valueo in ege isa bi a ybu mus ma chcodespeci iedincolumn
1o SUEWS_OHMCoe icien s. x .
SUEWS_Wa e . x
SUEWS_Wa e . x speci ies hecha ac e is ics o  hewa e su aceco e  ypebylinkingcodesincolumn1
o SUEWS_Wa e . x  o hecodesspeci iedinSUEWS_Si eSelec . x (Code_Wa e ).
No.UseColumnnameExampleDesc ip ion
[16]
[16]
[1]
[16]
[16]
[1]
[16]
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 35/71
Su aces a ecanno exceed his alue.
Se  oala ge alue(e.g.20000mm=20m)i  hewa e bodyissubs an ial(lake, i e ,e c)o asmall
alue(e.g.10mm)i wa e bodiesa e e yshallow(e.g. oun ains).
Wa e S a especi iedin heIni ialCondi ions ilemus no exceed his alue.
9MDD ainageEq999D ainageequa ion ouse o  hissu ace.
No cu en lyused o wa e su ace.
10MDD ainageCoe 1999Coe icien  o d ainageequa ion[uni s a yacco ding oequa ion]
No cu en lyused o wa e su ace
11MDD ainageCoe 2999Coe icien  o d ainageequa ion[uni s a yacco ding oequa ion]
No cu en lyused o wa e su ace
12LOHMCode_Summe We Code o OHMcoe icien s ouse o  hissu acedu ingwe condi ionsin
summe .
Links oSUEWS_OHMCoe icien s. x .Valueo in ege isa bi a ybu mus ma chcodespeci iedincolumn
1o SUEWS_OHMCoe icien s. x .
13LOHMCode_Summe D yCode o OHMcoe icien s ouse o  hissu acedu ingd ycondi ionsin
summe .
Links oSUEWS_OHMCoe icien s. x .Valueo in ege isa bi a ybu mus ma chcodespeci iedincolumn
1o SUEWS_OHMCoe icien s. x .
14LOHMCode_Win e We Code o OHMcoe icien s ouse o  hissu acedu ingwe condi ionsinwin e .
Links oSUEWS_OHMCoe icien s. x .Valueo in ege isa bi a ybu mus ma chcodespeci iedincolumn
1o SUEWS_OHMCoe icien s. x .
15LOHMCode_Win e D yCode o OHMcoe icien s ouse o  hissu acedu ingd ycondi ionsinwin e .
Links oSUEWS_OHMCoe icien s. x .Valueo in ege isa bi a ybu mus ma chcodespeci iedincolumn
1o SUEWS_OHMCoe icien s. x .
SUEWS_Snow. x
SUEWS_Snow. x speci ies hecha ac e is ics o snowsu aceswhenSnowUse=1inRunCon ol.nml.I  he
snowpa o  hemodelisno  un, ill his ablewi h‘999’excep  o  he i s (Code)columnandse
SnowUse=0inRunCon ol.nml.Fo ade aileddesc ip iono  he a iables,seeJä ie al.(2014) .In he
cu en  eleaseSnowUseshouldbese  o0.
No.UseColumnnameExampleDesc ip ionCode o OHMcoe icien s ouse o  hissu acedu ingwe
condi ionsinsumme .
Links oSUEWS_OHMCoe icien s. x .Valueo in ege isa bi a ybu mus ma chcodespeci iedincolumn
1o SUEWS_OHMCoe icien s. x .
17LOHMCode_Summe D yCode o OHMcoe icien s ouse o  hissu acedu ingd ycondi ionsin
summe .
Links oSUEWS_OHMCoe icien s. x .Valueo in ege isa bi a ybu mus ma chcodespeci iedincolumn
1o SUEWS_OHMCoe icien s. x .
[16]
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 36/71
18LOHMCode_Win e We Code o OHMcoe icien s ouse o  hissu acedu ingwe condi ionsinwin e .
Links oSUEWS_OHMCoe icien s. x .Valueo in ege isa bi a ybu mus ma chcodespeci iedincolumn
1o SUEWS_OHMCoe icien s. x .
19LOHMCode_Win e D yCode o OHMcoe icien s ouse o  hissu acedu ingd ycondi ionsinwin e .
Links oSUEWS_OHMCoe icien s. x .Valueo in ege isa bi a ybu mus ma chcodespeci iedincolumn
1o SUEWS_OHMCoe icien s. x .
SUEWS_Soil. x
SUEWS_Soil. x speci ies hecha ac e is icso  hesubsu acesoilbeloweacho  henonwa e su ace
ypes(Pa ed,Bldgs,E eT ,DecT ,G ass,BSoil).Themodeldoesno ha easois o ebelow hewa e
su aces.No e ha  hesesubsu acesoils o esa edi e en  o heba esoil/unmamnagedsu aceco e
ype.Eacho  henonwa e su ace ypesneed olink osoilcha ac e is icsspeci iedhe e.I  hesoil
cha ac e is icsa eassumed obe hesame o allsu ace ypes,useasinglecode alue olink he
cha ac e is icshe ewi h heSoilTypeCodecolumnsinSUEWS_NonVeg. x andSUEWS_Veg. x .
Soilmois u ecanei he bep o idedusingobse a ionalda ain heme  o cing ile(smd_choice=1o 2in
RunCon ol.nml)andp o idingsomeme ada ain o ma ionhe e(OBS_columns),o modelledbySUEWS
(smd_choice=0inRunCon ol.nml).No e, heop ion ouseobse a ionalda aisno ope a ionalin
hecu en  elease!
No. Use Columnname Example Desc ip ion
1 L Code 331
Codelinking o heSoilTypeCodecolumnin
SUEWS_NonVeg. x ( o Pa ed,BldgsandBSoilsu aces)
andSUEWS_Veg. x ( o E eT ,DecT andG asssu aces).
Valueo in ege isa bi a ybu mus ma chcodespeci iedin
SUEWS_Si eSelec . x .
2 MD SoilDep h 350
Dep ho subsu acesoils o e[mm]
i.e. hedep ho soilbenea h hesu ace
3 MD SoilS o eCap 150
Capaci yo subsu acesoils o e[mm]
i.e.howmuchwa e canbes o edin hesubsu acesoil
whena maximumcapaci y.
SoilS o eCapmus no beg ea e  hanSoilDep h.
4 MD Sa Hyd aulicCond 0.0005 Hyd aulicconduc i i y o sa u a edsoil[mms1]
5 MD SoilDensi y 1.16 Soildensi y[kgm3]
6 O In il a ionRa e 999
In il a ion a e[mmh1]
No cu en lyused
Dep ho soilmois u emeasu emen s[mm]
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 37/71
7 O OBS_SMDep h Useonlyi soilmois u eisobse edandp o idedin he
me  o cing ileandsmd_choice=1o 2.
Useo obse edsoilmois u eno cu en ly es ed
8 O OBS_SMCap
Maxiumumobse edsoilmois u e[m3m3o kgkg1]
Useonlyi soilmois u eisobse edandp o idedin he
me  o cing ileandsmd_choice=1o 2.
Useo obse edsoilmois u eno cu en ly es ed
9 O OBS_SoilNo Rocks
F ac iono soilwi hou  ocks[]
Useonlyi soilmois u eisobse edandp o idedin he
me  o cing ileandsmd_choice=1o 2.
Useo obse edsoilmois u eno cu en ly es ed
SUEWS_Conduc ance. x
SUEWS_Conduc ance. x con ains hepa ame e sneeded o  heJa is(1976)su aceconduc ancemodel
usedin hemodellingo e apo a ioninSUEWS.These aluesshouldno bechangedindependen lyo
eacho he .Thesugges ed aluesbelowha ebeende i edusingda ase s o LosAngelesandVancou e
(seeJä ie al.(2011) )andshouldbeusedwi hgsChoice=1inRunCon ol.nml.Anal e na i e
o mula ion(gsChoice=2)usessligh lydi e en  unc ional o msanddi e en coe icien s(wi hdi e en
uni s).
No. Use Column
name Example Desc ip ion
1 L Code
Codelinking o heCondCodecolumninSUEWS_Si eSelec . x .
Valueo in ege isa bi a ybu mus ma chcodespeci iedin
SUEWS_Si eSelec . x .
2 MD G1 16.4764 Rela ed omaximumsu aceconduc ance[mms1]
3 MD G2 566.0923 Rela ed oKdowndependence[Wm2]
4 MD G3 0.2163 Rela ed oVPDdependence[uni sdependongsChoicein
RunCon ol.nml]
5 MD G4 3.3649 Rela ed oVPDdependence[uni sdependongsChoicein
RunCon ol.nml]
6 MD G5 11.0764 Rela ed o empe a u edependence[°C]
7 MD G6 0.0176 Rela ed osoilmois u edependence[mm1]
8 MD TH 40 Uppe ai  empe a u elimi [°C]
9 MD TL 0 Lowe ai  empe a u elimi [°C]
[1]

20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 38/71
10 MD S1 0.45
Rela ed osoilmois u edependence[]
Thesewillchangein he u u e oensu econsis encywi hsoil
beha iou
11 MD S2 15
Rela ed osoilmois u edependence[mm]
Thesewillchangein he u u e oensu econsis encywi hsoil
beha iou
12 MD Kmax 1200 Maximumincomingsho wa e adia ion[Wm2]
SUEWS_An h opogenicHea . x
SUEWS_An h opogenicHea Flux. x p o ides hepa ame e sneeded omodel hean h opogenichea  lux
usingei he  heme hodo Jä ie al.(2011)basedonhea ingandcoolingdeg eedays
(An h opHea Choice=2in4.1RunCon ol.nml)o  heme hodo Lo idane al.(2011)basedonai
empe a u e(An h opHea Choice=1inRunCon ol.nml).Thesubdaily a ia ioninan h opogenichea  lux
ismodelledacco ding o hedailycyclesspeci iedinSUEWS_P o iles. x .Al e na i ely,i a ailable, he
an h opogenichea  luxcanbep o idedin heme  o cing ile(andse An h opHea Choice=0in
RunCon ol.nml),inwhichcaseallcolumnshe eexcep CodeandBaseTHDDshouldbese  o’999’.
No.UseColumnnameExampleDesc ip ionSUEWS_I iga ion. x
SUEWSincludesasimplemodel o ex e nalwa e usei obse edda aa eno a ailable.Themodel
calcula esdailywa e use om hemeandailyai  empe a u e,numbe o dayssince ainand ac iono
i iga eda eausingau oma ic/manuali iga ion.Thesubdailypa e no wa e useismodelledacco ding o
hedailycyclesspeci iedinSUEWS_P o iles. x .
Al e na i ely,i a ailable, heex e nalwa e usecanbep o idedin heme  o cing ile(andse WU_choice=
1inRunCon ol.nml),inwhichcaseallcolumnshe eexcep Codeshouldbese  o'999'.
No. Use Columnname Example Desc ip ion
1 L Code
Codelinking o
[[#SUEWS_Si eSelec . x |SUEWS_Si eSelec . x ] o i iga ion
modelling(I iga ionCode).
Valueo in ege isa bi a ybu mus ma chcodesspeci iedin
SUEWS_Si eSelec . x .
2 MU Ie_s a 1366 Daywheni iga ions a s[DOY]
3 MU Ie_end 1366 Daywheni iga ionends[DOY]
4 MU In e nalWa e Use 0 In e nalwa e use[mmh1]
5 MU Fau 01 F ac iono i iga eda ea ha isi iga edusingau oma ed
sys ems(e.g.sp inkle s).
6 MD Ie_a1 84.54 Coe icien  o au oma ici iga ionmodel[mmd1]
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 39/71
7 MD Ie_a2 9.96 Coe icien  o au oma ici iga ionmodel[mmd1°C1]
8 MD Ie_a3 3.67 Coe icien  o au oma ici iga ionmodel[mmd2]
9 MD Ie_m1 25.36 Coe icien  o manuali iga ionmodel[mmd1]
10 MD Ie_m2 3.00 Coe icien  o manuali iga ionmodel[mmd1°C1]
11 MD Ie_m3 1.10 Coe icien  o manuali iga ionmodel[mmd2]
12 MU DayWa (1) 0o 1 I iga ionallowedonSundays[1],i no [0]
13 MU DayWa (2) 0o 1 I iga ionallowedonMondays[1],i no [0]
14 MU DayWa (3) 0o 1 I iga ionallowedonTuesdays[1],i no [0]
15 MU DayWa (4) 0o 1 I iga ionallowedonWednesdays[1],i no [0]
16 MU DayWa (5) 0o 1 I iga ionallowedonThu sdays[1],i no [0]
17 MU DayWa (6) 0o 1 I iga ionallowedonF idays[1],i no [0]
18 MU DayWa (7) 0o 1 I iga ionallowedonSa u days[1],i no [0]
19 MU DayWa Pe (1) 01 F ac iono p ope iesusingi iga iononSundays[01]
20 MU DayWa Pe (2) 01 F ac iono p ope iesusingi iga iononMondays[01]
21 MU DayWa Pe (3) 01 F ac iono p ope iesusingi iga iononTuesdays[01]
22 MU DayWa Pe (4) 01 F ac iono p ope iesusingi iga iononWednesdays[01]
23 MU DayWa Pe (5) 01 F ac iono p ope iesusingi iga iononThu sdays[01]
24 MU DayWa Pe (6) 01 F ac iono p ope iesusingi iga iononF idays[01]
25 MU DayWa Pe (7) 01 F ac iono p ope iesusingi iga iononSa u days[01]
SUEWS_P o iles. x
SUEWS_P o iles. x speci ies hedailycycleo  a iables ela ed ohumanbeha iou (ene gyuse,wa e use
andsnowclea ing).Di e en p o ilescanbespeci ied o weekdaysandweekends.Thep o ilesa e
p o ideda hou ly esolu ionhe e; hemodelwill henin e pola e hehou lyene gyandwa e usep o iles o
he esolu iono  hemodel imes epandno malize he aluesp o ided.Thusi doesno ma e whe he
columns225addup o,say1,24,o ano he numbe ,because hemodelwillhandle his.Cu en ly, he
snowclea ingp o ilesa eno in e pola edas hesea ee ec i elyaswi ch(0o 1).
I  hean h opogenichea  luxandwa e usea especi iedin heme  o cing ile, heene gyandwa e use
p o ilesa eno used.
P o ilesa especi ied o  he ollowing
An h opogenichea  lux(weekdayandweekend)
Wa e use(weekdayandweekend;manualandau oma ici iga ion)
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 40/71
Snow emo al(weekdayandweekend)
No. Use Column
name Example Desc ip ion
1 L Code
Codelinking o he ollowingcolumnsinSUEWS_Si eSelec . x :
Ene gyUseP o WD:An h opogenichea  lux,weekdays
Ene gyUseP o WE:An h opogenichea  lux,weekends
Wa e UseP o ManuWD:Manuali iga on,weekdays
Wa e UseP o ManuWE:Manuali iga on,weekends
Wa e UseP o Au oWD:Au oma ici iga on,weekdays
Wa e UseP o Au oWE:Au oma ici iga on,weekends
SnowClea ingP o WD:Snowclea ing,weekdays
SnowClea ingP o WE:Snowclea ing,weekends
Valueo in ege isa bi a ybu mus ma chcodesspeci iedin
SUEWS_Si eSelec . x .
2
25 MU 023
Mul iplie  o eachhou o  heday[] o ene gyandwa e use.
Fo SnowClea ing,se  hosehou s o1whensnow emo al om
pa edand oo su aceisallowed(0o he wise)i  hesnow emo al
limi sse in heSUEWS_NonVeg. x (SnowLimRemo ecolumn)a e
exceeded.
SUEWS_Wi hinG idWa e Dis . x
SUEWS_Wi hinG idWa e Dis . x speci ies hemo emen o wa e be weensu aceswi hinag id/a ea.I
allowsimpe iousconnec i i y obe akenin oaccoun .
Each owco esponds oasu ace ype(linkedby heCodeincolumn1 o heSi eSelec . x columns:
Wi hinG idPa edCode,Wi hinG idBldgsCode,…,Wi hinG idWa e Code).Eachcolumncon ains he ac ion
o wa e  lowing om hesu ace ype oeacho  heo he su ace ypeso  o uno o  hesubsu acesoil
s o e.
No e:
Thesumo each ow(excluding heCode)mus equal1.
Wa e canno  low omonesu ace o ha samesu ace,so hediagonalelemen sshouldbeze o.
The owco esponding o hewa e su aceshouldbeze o,as he eiscu en lyno lowpe mi ed om
hewa e su ace oo he su acesby hemodel.
Cu en lywa e canno go obo h uno andsoils o e(i.e.i mus go ooneo  heo he – uno  o
impe ioussu aces;soils o e o pe ioussu aces).
In he ablebelow, o example,
all low ompa edsu acesgoes o uno ;
90%o  low ombuildingsgoes o uno ,wi hsmallamoun sgoing oo he su aces(mos lypa ed
su acesasbuildingsa eo ensu oundedbypa eda eas);
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 41/71
all low om ege a edandba esoila easgoesin o hesubsu acesoils o e;
he owco esponding owa e con ainsze os(asi iscu en lyno used).
1 2 3 4 5 6 7 8 9 10
Code ToPa ed ToBuil ToE eT ToDecT ToG ass ToBSoil ToWa e ToRuno ToSoilS o e
10 0 0 0 0 0 0 0 1 0 !
20 0.06 0 0.01 0.01 0.01 0.01 0 0.9 0 !
30 0 0 0 0 0 0 0 0 1 !
40 0 0 0 0 0 0 0 0 1 !
50 0 0 0 0 0 0 0 0 1 !
60 0 0 0 0 0 0 0 0 1 !
70 0 0 0 0 0 0 0 0 0 !
S o agehea  lux ela ed
Dependingonhow hes o agehea  luxiscalcula ed(speci iedbyQSChoiceinRunCon ol.nml),di e en
inpu  ilesa e equi ed.
Op ion QSChoice Filesneeded
OHM 1 Coe icien sspeci iedinSUEWS_OHMCoe icien s. x
Obse a ions 2 Addda a ome eo ological o cing ile
AnOHM 3 P ope iesspeci iedwi ho he si echa ac e is ics.
ESTM 4
P ope iesspeci iedinSUEWS_ESTMCoe icien s. x
Modelop ionsspeci iedinESTMinpu .nml
Su ace empe a u esp o idedinSS_YYYY_ESTM_Ts_da a. x
OHM
OHM, heObjec i eHys e esisModel(G immonde al.1991) calcula es hes o agehea  luxasa
unc iono ne allwa e adia ionandsu acecha ac e is ics.
SUEWS_OHMCoe icien s. x
Fo eachsu ace,OHM equi es h eemodelcoe icien s(a1,a2,a3).The h eeshouldbeselec edasa
se .
A a ie yo  alueshasbeende i ed o di e en ma e ialsandcanbe oundin heli e a u e(see:Typical
Values).
[9]
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 48/71
22 O kdi
Di use adia ion[Wm2]
Recommendedi SOLWEIGUse=1
23 O kdi
Di ec  adia ion[Wm2]
Recommendedi SOLWEIGUse=1
24 O wdi
Winddi ec ion[°]
Cu en lyno implemen ed
CBLinpu  iles
Main e e ences o  hispa o  hemodel:Onomu ae al.(2015) andCleughandG immond(2001) .
I CBLslabmodelisused(CBLuse=1inRunCon ol.nml) he ollowing ilesa eneeded:
Filename Pu pose
CBL_ini ial_da a. x
Gi esini ialda ae e ymo ningwhenCBLslabmodels a s unning.
ilenamemus ma ch heIni ialDa a_FileNameinCBLInpu .nml.
ixed o ma .
CBLInpu .nml
Speci ies unop ions,pa ame e sandinpu  ilenames.
Canbeinanyo de
CBL_ini ial_da a. x
This ileshouldgi eini ialda ae e ymo ningwhenCBLslabmodels a s unning.The ilenameshould
ma ch heIni ialDa a_FileNameinCBLInpu .nml.
De ini ionsandexample ileo ini ial aluesp epa ed o Sac amen o.
No. Columnname Desc ip ion
1 id Dayo yea [DOY]
2 zi0 ini ialcon ec i ebounda ylaye heigh (m)
3 gam _Km e icalg adien o po en ial empe a u e(Km1)
4 gamq_gkgm e icalg adien o speci ichumidi y(gkg1m1)
5 The a+_K po en ial empe a u ea  he opo CBL(K)
6 q+_gkg speci ichumidi ya  he opo CBL(gkg1)
7 The a_K po en ial empe a u einCBL(K)
8 q_gkg speci ichumidiyinCBL(gkg1)
[15] [14]

20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 49/71
gam _Kmandgamq_gkgmw i en o wosigni ican  igu esa e equi ed o  hemodelpe o mancein
app op ia e anges .
id zi0 gam _Km gamq_gkgm The a+_K q+_gkg he a_K q_gkg
234 188 0.032 0.00082 290.4 9.6 288.7 8.3
235 197 0.089 0.089 290.2 8.4 288.3 8.7
⁞ ⁞ ⁞ ⁞ ⁞ ⁞ ⁞ ⁞
⁞ ⁞ ⁞ ⁞ ⁞ ⁞ ⁞ ⁞
CBL_Inpu .nml
Name Desc ip ion
En ainmen Type
De e minesen ainmen scheme.SeeCleughandG immond2000  o
de ails.
Value Commen s
1 TennekesandD iedonks(1981)Recommended
2 McNaugh onandSp ings(1986)
3 Rayne andWa son(1991)
4 Tennekes(1973)
QH_Choice
De e minesQHused o CBLmodel.
Value Commen s
1 QHmodelledbySUEWS
2 QHmodelledbyLUMPS
3 Obse edQH aluesa eused om heme eo ologicalinpu  ile
Wsb
Subsidence eloci y(ms1)ineq.1and2o Onomu ae al.(2015) .
(0.01ms1 ecommended)
CBLday(id)
CBLmodelisused o  hedaysyouchoose.
Se CBLday(id)=1
I CBLmodelisse  o un o DOY175–177,CBLday(175)=1,
CBLday(176)=1,CBLday(177)=1
CO2_included Se  oze oincu en  e sion
De e minesini ial alues(seeCBL_Ini ial_da a. x )
[15]
[14]
[15]
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 50/71
Ini ialDa a_use
Value Commen s
0 Allini ial aluesa ecalcula ed.(No a ailableincu en  elease.)
1
Takezi0,gam _Kmandgamq_gkgm ominpu da a ile.The a+_K,
q+_gkg,The a_Kandq_gkga ecalcula edusingTemp_C,a hand
P es_kPainme eo ologicalinpu  ile.
2 Takeallini ial alues ominpu da a ile(seeCBL_Ini ial_da a. x ).
Ini ialDa a_FileName I Ini ialDa a_use≥1,w i e he ilenameincluding hepa h omsi e
di ec o ye.g.Ini ialDa a_FileName='CBLinpu iles CBL_ini ial_da a. x '
Sonde lag
Value Commen s
0 Doesno  ead adiosonde e icalp o ileda a ecommended
1 Reads adiosonde e icalp o ileda a
FileSonde(id)
I Sonde lag=1,w i e he ilenameincluding hepa h omsi edi ec o y
e.g.FileSonde(id)='CBLinpu iles XXX. x ',XXXisana bi a yname.
SOLWEIGinpu  iles
I  heSOLWEIGmodelop ionisused(SOLWEIGou =1),spa ialda aandaSOLWEIGInpu .nml ileneed o
bep epa ed.TheDigi alSu aceModels(DSMs)aswellasde i a i eso igina ing omDSMs,e.g.SkyView
Fac o s(SVF)mus ha e hesamespa ial esolu ionandex en .SinceSOLWEIGisa2Dmodeli will
conside ablyinc easecompu a ion imeandshouldbeusedwi hca e.
Desc ip iono choicesinSOLWEIGinpu _ ile.nml ile.The ilecanbeinanyo de .
Name Uni s Desc ip ion
Pos u e 
De e mines hepos u eo ahuman o which he adian  luxesshouldbe
conside ed
1 S anding(de aul )
2 Si ing
absL 
Abso p ioncoe icien o longwa e adia iono ape son.
Recommended alue:0.97
absK 
Abso p ioncoe icien o sho wa e adia iono ape son.
Recommended alue:0.70
heigh g a i y m
Cen eo g a i y o ape son.
Recommended alue o as andingman:1.1m
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 51/71
use egdem 
Vege a ionscheme
1 Vege a ionschemeisac i e(Lindbe gandG immond2011 )
2 No ege a ionschemeused
DSMPa h  Pa h oDigi alSu aceModels(DSM).
DSMname  G oundandBuildingDSM
CDSMname  Vege a ioncanopyDSM
TDSMname  Vege a ion unkzoneDSM
T ansMin 
T anmissi i yo K h oughdeciduous ege a ion(lea on)
Recommended alue:0.02(Kona skae al.2014 )
T ansMax 
T anmissi i yo K h oughdeciduous ege a ion(lea o )
Recommended alue:0.50(Kona skae al.2014 )
SVFPa h  Pa h oSVFsma ices(SeeLindbe gandG immond(2011)  o de ails)
SVFSu ix  Su ixused(i any)
BuildingName  Booleanma ix o loca ionso buildingpixels
ow  Xcoo dina e o poin o in e es .He eall a iables om hemodelwillw i en
oSOLWEIGpoiOUT. x
col  Ycoo dina e o poin o in e es .He eall a iables om hemodelwillw i en
oSOLWEIGpoiOUT. x
onlyglobal 
Global adia ion
0 Di useanddi ec sho wa e adia ion aken omme  o cing ile.
1Di useanddi ec sho wa e adia ioncalcula ed omReindle al.
(1990)
SOLWEIGpoi_ou 
W i eou pu  a iablesa poin o in e es (seebelow)
0 NoPOIou pu
Tm _ou  0 Nog idou pu
1 W i eg id o ile(sa esasERSIAsciig id)
Lup2d_ou  0 Nog idou pu
1 W i eg id o ile(sa esasERSIAsciig id)
[18]
[37]
[37]
[18]
[38]
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 52/71
Ldown2d_ou  0 Nog idou pu
1 W i eg id o ile(sa esasERSIAsciig id)
Kup2d_ou  0 Nog idou pu
1 W i eg id o ile(sa esasERSIAsciig id)
Kdown2d_ou  0 Nog idou pu
1 W i eg id o ile(sa esasERSIAsciig id)
GVF_ou  0 Nog idou pu
1 W i eg id o ile(sa esasERSIAsciig id)
SOLWEIG_ldown  0 No ac i e(useSUEWS oes ima eLdownabo ecanyon)
1 UseSOLWEIG oes ima eLdownabo ecanyon
Ou In e al min Ou pu in e al.Se  o60incu en  e sion.
RunFo G id 
G id o whichSOLWEIGshouldbe un.
999 Allg ids(usewi hca e)
Ou pu  ilesE o Messages:p oblems. x
I  he ea ep oblemswi h unning hep og amane o messagewillbew i en op oblems. x .Se ious
p oblemswillusuallycause hep og am os opa e w i ing hee o message.I  hep og amencoun e sa
mo emino issuei willno s opbu awa ningmaybew i en op oblems. x .
Weha eala genumbe o e o messagesincluded o y ocap u ecommone o s ohelp heuse
de e minewha  hep oblemis.I youencoun e ane o  ha doesno p o ideane o message o
p oblems. x pleasecap u e hede ailssowecanhope ullyp o idebe e e o messages.
SeeT oubleshoo ingsec ion o helpsol ingp oblems.I  he ilepa hsa eno co ec  hep og amwill
e u nane o when un(seeP epa ing o un hemodel).
Modelpa ame e s:SS_FileChoices. x
Fo each un, hemodelpa ame e sspeci iedinRunCon ol,Ini ialCondi ionsandSi eIn o ilesa ew i en
ou  o he ileSS_FileChoices. x .
Modelou pu  ilesSSss_YYYY_ . x
SUEWSp oduces hemainou pu  ile(SSss_YYYY_ . x )wi h ime esolu ion( min)de inedby hemodel
imes ep(se inRunCon ol).
Column Name Desc ip ion
1 iy Yea [YYYY]
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 53/71
2 id Dayo yea [DOY]
3 i Hou [H]
4 imin Minu e[M]
5 dec ime Decimal ime[]
6 kdown Incomingsho wa e adia ion[Wm2]
7 kup Ou goingsho wa e adia ion[Wm2]
8 ldown Incominglongwa e adia ion[Wm2]
9 lup Ou goinglongwa e adia ion[Wm2]
10 Tsu Su ace empe a u e[°C]
11 qn Ne allwa e adia ion[Wm2]
12 h_mod Sensiblehea  lux(calcula edusingLUMPS)[Wm2]
13 e_mod La en hea  lux(calcula edusingLUMPS)[Wm2]
14 qs S o agehea  lux[Wm2]
15 q An h opogenichea  lux[Wm2]
16 qh Sensiblehea  lux(calcula edusingSUEWS)[Wm2]
17 qe La en hea  lux(calcula edusingSUEWS)[Wm2]
18 P/i Rain[mm]
19 Ie/i Ex e nalwa e usein hes udya ea[mm]
20 E/i E apo a ion[mm]
21 D /i D ainage[mm]
22 S /i Su acemois u es a e[mm]
23 NWS /i Landsu aces a e(i.e.Wa e su aceexcluded)[mm]
24 su Ch/i Changeinsu acemois u es o e[mm]
25 o Ch/i Changeinsu aceandsoilmois u es o es[mm]
26 RO/i Runo [mm]
27 ROsoil/i Soil uno (subsu ace)[mm]
28 ROpipe Runo  ecei edbypipes[mm]
29 ROpa Abo eg ound uno onpa edsu aces[mm]

20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 54/71
30 RO eg Abo eg ound uno on ege a edsu aces[mm]
31 ROwa e Runo occu ing h oughwa e body[mm]
32 Addi ionalWa e Wa e  low ecei ed omo he g ids[mm]
33 FlowChange Di e enceininpu andou pu  lowso wa e body[mm]
34 WU_in In e nalwa e use[mm]
35 WU_E eT Wa e use o i iga iono e e g een ees[mm]
36 WU_DecT Wa e use o i iga iono deciduous ees[mm]
37 WU_G ass Wa e use o i iga iono g ass[mm]
38 a Ae odynamic esis ance[sm1]
39 s Su ace esis ance[sm1]
40 us a F ic ion eloci y[ms1]
41 l_Ob Obukho leng h[m]
42 Fcld Cloud ac ion[ en hs]
43 SoilS Soilmois u e[mm]
44 smd Soilmois u ede ici [mm]
45 smd_Pa ed Soilmois u ede ici o pa edsu ace[mm]
46 smd_Bldgs Soilmois u ede ici o buildingsu ace[mm]
47 smd_E eT Soilmois u ede ici o e e g eensu ace[mm]
48 smd_DecT Soilmois u ede ici o deciduoussu ace[mm]
49 smd_G ass Soilmois u ede ici o g asssu ace[mm]
50 smd_BSoil Soilmois u ede ici o ba esoilsu ace[mm]
51 S _Pa ed S a eo pa edsu ace[mm]
52 S _Bldgs S a eo buildingsu ace[mm]
53 S _E eT S a eo e e g eensu ace[mm]
54 S _DecT S a eo deciduoussu ace[mm]
55 S _G ass S a eo g asssu ace[mm]
56 S _BSoil S a eo ba esoilsu ace[mm]
57 S _Wa e S a eo  hewa e body[mm]
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 55/71
58 LAI Lea a eaindex[m2m2]
59 z0m Roughnessleng h o momen um[m]
60 zdm Displacemen heigh [m]
61 qn1_SF Ne allwa e adia ion o snow eea ea[Wm2]
62 qn1_S Ne allwa e adia ion o snowsu ace[Wm2]
63 Qm Snow ela edhea exchange[Wm2]
64 QmF eez In e nalene gychange[Wm2]
65 QmRain Hea  eleaseby ainonsnow[Wm2]
66 SWE Snowwa e equi alen [mm]
67 Mw Mel wa e [mm]
68 MwS o e Mel wa e s o e[mm]
69 snowRem_Pa ed Snow emo al ompa edsu aces[mm]
70 snowRem_Bldgs Snow emo al ombuildings[mm]
71 ChSnow/i Changeinsnowpack[mm]
72 SnowAlb Snowalbedo[]
SSss_DailyS a e. x
Con ainsin o ma ionabou  hes a eo  hesu aceandsoilpa ame e sa a ime esolu iono oneday.One
ileisw i en o eachg idsomaycon ainmul ipleyea s.
Column Name Desc ip ion
1 iy Yea [YYYY]
2 id Dayo yea [DOY]
3 HDD1_h Hea ingdeg eedays[°C]
4 HDD2_c Coolingdeg eedays[°C]
5 HDD3_Tmean A e agedailyai  empe a u e[°C]
6 HDT4_T5d 5day unningmeanai  empe a u e[°C]
7 P/day Daily o alp ecipi a ion[mm]
8 DaysSR Dayssince ain[days]
9 GDD1_g G owingdeg eedays o lea g ow h[°C]
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 56/71
10 GDD2_s G owingdeg eedays o senescence[°C]
11 GDD3_Tmin Dailyminimum empe a u e[°C]
12 GDD4_Tmax Dailymaximum empe a u e[°C]
13 GDD5_DayLH s Dayleng h[h]
14 LAI_E eT Lea a eaindexo e e g een ees[m2m2]
15 LAI_DecT Lea a eaindexo deciduous ees[m2m2]
16 LAI_G ass Lea a eaindexo g ass[m2m2]
17 DecidCap Mois u es o agecapaci yo deciduous ees[mm]
18 Po osi y Po osi yo deciduous ees[]
19 AlbE eT Albedoo e e g een ees[]
20 AlbDecT Albedoo deciduous ees[]
21 AlbG ass Albedoo g ass[]
22 WU_E eT (1) To alwa e use o e e g een ees[mm]
23 WU_E eT (2) Au oma icwa e use o e e g een ees[mm]
24 WU_E eT (3) Manualwa e use o e e g een ees[mm]
25 WU_DecT (1) To alwa e use o deciduous ees[mm]
26 WU_DecT (2) Au oma icwa e use o deciduous ees[mm]
27 WU_DecT (3) Manualwa e use o deciduous ees[mm]
28 WU_G ass(1) To alwa e use o g ass[mm]
29 WU_G ass(2) Au oma icwa e use o g ass[mm]
30 WU_G ass(3) Manualwa e use o g ass[mm]
31 del aLAI Changeinlea a eaindex(no malised01)[]
32 LAIlumps Lea a eaindexusedinLUMPS(no malised01)[]
33 AlbSnow Snowalbedo[]
34 DensSnow_Pa ed Snowdensi ypa edsu ace[kgm3]
35 DensSnow_Bldgs Snowdensi ybuildingsu ace[kgm3]
36 DensSnow_E eT Snowdensi ye e g eensu ace[kgm3]
37 DensSnow_DecT Snowdensi ydeciduoussu ace[kgm3]
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 57/71
38 DensSnow_G ass Snowdensi yg asssu ace[kgm3]
39 DensSnow_BSoil Snowdensi yba esoilsu ace[kgm3]
40 DensSnow_Wa e Snowdensi ywa e su ace[kgm3]
Ini ialCondi ionsSSss_YYYY.nml
A  heendo  hemodel un(o  heendo eachyea in hemodel un)anewIni ialCondi ions ileisw i en
ou (loca edin heinpu  olde ),seeIni ialCondi ionsSSss_YYYY.nml
SSss_YYYY_snow_ . x
SUEWSp oducesasepa a eou pu  ile o snow(whensnowUse=1inRunCon ol.nml)wi hde ails o
eachsu ace ype.
File o ma o SSss_YYYY_snow_60. x
Column Name Desc ip ion
1 iy Yea [YYYY]
2 id Dayo yea [DOY]
3 i Hou [H]
4 imin Minu e[M]
5 dec ime Decimal ime[]
6 SWE_Pa ed Snowwa e equi alen –pa edsu ace[mm]
7 SWE_Bldgs Snowwa e equi alen –buildingsu ace[mm]
8 SWE_E eT Snowwa e equi alen –e e g eensu ace[mm]
9 SWE_DecT Snowwa e equi alen –deciduoussu ace[mm]
10 SWE_G ass Snowwa e equi alen –g asssu ace[mm]
11 SWE_BSoil Snowwa e equi alen –ba esoilsu ace[mm]
12 SWE_Wa e Snowwa e equi alen –wa e su ace[mm]
13 Mw_Pa ed Mel wa e –pa edsu ace[mmh1]
14 Mw_Bldgs Mel wa e –buildingsu ace[mmh1]
15 Mw_E eT Mel wa e –e e g eensu ace[mmh1]
16 Mw_DecT Mel wa e –deciduoussu ace[mmh1]
17 Mw_G ass Mel wa e –g asssu ace[mmh1]
18 Mw_BSoil Mel wa e –ba esoilsu ace[mmh1]
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 64/71
24 Tg ound3 Tempe a u ein he i s laye o g ound K
25 Tg ound4 Tempe a u ein he i s laye o g ound K
26 Tg ound5 Tempe a u ein he i s laye o g ound(inne mos ) K
27 Tibld1 Tempe a u ein he i s laye o in e nalelemen s K
28 Tibld2 Tempe a u ein he i s laye o in e nalelemen s K
29 Tibld3 Tempe a u ein he i s laye o in e nalelemen s K
30 Tibld4 Tempe a u ein he i s laye o in e nalelemen s K
31 Tibld5 Tempe a u ein he i s laye o in e nalelemen s K
32 Tabld Ai  empe a u einbuildings K
T oubleshoo ingHow oc ea eadi ec o y?
pleasesea ch hewebusing hisph asei youdono knowhow oc ea ea olde o di ec o y
How ounzipa ile
pleasesea ch hewebusing hisph asei youdono knowhow ounzipa ile
A ex edi o
isap og am oedi plain ex  iles.I yousea chon hewebusing heph ase‘ ex edi o ’youwill ind
nume ousp og ams.Theseinclude o example,No ePad,Edi Pad,Tex Pade c
Commandp omp
F omS a selec  un– ypecmd– hiswillopenawindow.Changedi ec o y o heloca iono whe eyou
s o edyou  iles.The ollowingwebsi emaybehelp uli youdono knowwha acommandp omp is:
h p://dosp omp .in o/
Dayo yea [DOY]
Janua y1s isday1,Feb ua y1s isday32.I yousea chon hewebusing heph ase‘dayo yea
calenda ’youwill ind ables ha allow apidcon e sions.Remembe  ha a e Feb ua y28 hDOYwillbe
di e en be weenleapyea sandnonleapyea s.
Fi s  hings oChecki  hep og amseems oha ep oblems
Check hep oblems. x  ile.
Check ileop ions–inRunCon ol.nml.
Lookin heou pu di ec o y o  heSS_FileChoices. x .Thisallowsyou ocheckallop ions ha we e
usedin he un.Youmaywan  ocompa ei wi h heo iginal e sionsuppliedwi h hemodel.
Apopupsaying“ ilepa hno  ound"
Thismeans hep og amcanno  ind he ilepa hsde inedinRunCon ol.nml ile.Possiblesolu ions:
Check ha youha ec ea ed he olde  ha youspeci iedinRunCon ol.nml.
Checkdoes heou pu di ec o yexis ?
Check ha youha easingleo doublequo esa ound heFileInpu Pa h,FileOu pu Pa handFileCode

20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 65/71
“%sa _ ap_p ess.  emp=0.0000p essu edec ime”
Tempe a u eisze oandincalcula iono wa e  apou p essu epa ame e iza ionisused.Youdon’ need o
wo yi  he empe a u eshouldbe0°C.I i shouldno be0°C hissugges s ha  he eisap oblemwi h he
da a.
%Tchanged o i limi s
[TL=0.1]/[TL=39.9]Youmaywan  ochange hecoe icien s o su ace esis ance.I youha eda a
om hese empe a u es,wewouldhappilyde e mine hem.
“Re e ence ounde ined a iable,a ayelemen o  unc ion esul ”
Pa ame e (s)missing ominpu  iles.
Seealso hee o messagesp o idedinp oblems. x
Cu en con ibu o s:
P o C.S.B.G immond(Uni e si yo Reading;p e iouslyIndianaUni e si y,King’sCollegeLondon,
UK);D LeenaJä i(Uni e si yo Helsinki,Finland);ShihoOnomu a(Gö ebo gUni e si y,Sweden),
D HelenWa d(Uni e si yo Reading),D F ed ikLindbe g(Gö ebo gUni e si y,Sweden),D Andy
Gabey(Reading),D TingSUN(Reading)
Pas Con ibu o s:
D B ianO e le(IndianaUni e si y),D ThomasLo idan(King’sCollegeLondon)
Use swhoha eb ough  hings oou a en ion oimp o e hismanualand hemodel:
D AndyCou s(MonashUni e si y,Aus alia),Ke yNice(MonashUni e si y,Aus alia),Shiho
Onomu a(Gö ebo gUni e si y,Sweden),D S e anSmi h(Uni e si yo Reading,UK),D HelenWa d
(King’sCollegeLondon,UK;Uni e si yo Reading,UK);DuickYoung(King’sCollegeLondon),D Ning
Zhang(NanjingUni e si y,China)
Funding osuppo de elopmen :
Na ionalScienceFounda ion(USA,BCS0095284,ATM0710631),EUF amewo k7BRIDGE
(211345);EUemBRACE;UKMe O ice;NERCClea LO,NERCTRUC.UKMe O iceCSSP/New on
unding
No a ion
De ini ion
λF on ala eaindex
ΔQS s o agehea  lux
Bounda yLaye pa o SUEWS
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 66/71
BLUEWS
Rela ionbe weenBLUEWSandSUEWSSou ce:
Bldgs Buildingsu ace
CBL Con ec i ebounda ylaye
DEM Digi alEle a ionModel
DSM Digi alsu acemodel
DTM Digi alTe ainModel
DecT deciduous eesandsh ubs
E eT E e g een eesandsh ubs
ESTM Elemen Su aceTempe a u eMe hod(O e lee al.,2005 )
G ass G asssu ace
BSoil Unmanagedlandand/o ba esoil
L↓ incominglongwa e adia ion
LAI Lea a eaindex
LUMPS LocalscaleU banMe eo ologicalPa ame e iza ionScheme(Lo idane al.2011 )
NARP Ne Allwa eRadia ionPa ame e iza ion(O e lee al.2003 ,Lo idane al.2011 )
OHM Objec i eHys e esisModel(G immonde al.1991 ,G immond&Oke1999a ,2002 )
Pa ed Pa edsu ace
Q* ne allwa e adia ion
QE la en hea  lux
QF an h opogenichea  lux
QH sensiblehea  lux
SOLWEIG Thesola andlongwa een i onmen ali adiancegeome ymodel(Lindbe ge al.2008 ,
Lindbe gandG immond2011 )
[15]
[12]
[5]
[4] [5]
[9] [10] [11]
[17]
[18]
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 67/71
SVF Sky iew ac o
he a po en ial empe a u e
imes epo da a
UMEP U banMul iscaleEn i onmen alP edic o
Wa e Wa e su ace
zi Con ec i ebounda ylaye heigh
De elopmen Ve sionHis o yNewinSUEWSVe sion2016a( eleased15June2016)
1.Majo changes o heinpu  ile o ma s o acili a e he unningo mul ipleg idsandmul ipleyea s.
Su acecha ac e is icsa ep o idedinSi eSelec . x ando he inpu  ilesa ec oss e e enced iacodes
o p o ile ypes.
2.Thesu ace ypesha ebeenal e ed:
P e iously,g asssu aceswe een e edsepa a elyasi iga edg assanduni iga edg asssu aces,
whils  he‘unmanaged’landco e  ac ionwasassumedby hemodel obeha easuni iga edg ass.
The eisnowasinglesu ace ype o g ass( o al o i iga edplusuni iga ed)andanewba esoil
su ace ype.
Thep opo iono i iga ed ege a ionmus nowbespeci ied o g ass,e e g een eesanddeciduous
eesindi idually.
3.Theen i emodelnow unsa a imes epspeci iedby heuse .No e ha 5miniss ongly ecommended.
(P e iouslyonly hewa e balancecalcula ionswe edonea 5minwi h heene gybalancecalcula ions
a 60min).
4.Su aceconduc ancenowdependson hesoilmois u eunde  he ege a edsu acesonly( a he  han
he o alsoilmois u e o  hewholes udya eaasp e iously).
5.Albedoo e e g een eesandg asssu acescannowchangewi hlea a eaindexaswasp e iously
possible o deciduous eesonly.
6.Newsugges ionsinT oubleshoo ingsec ion.
7.Edi s o hemanual.
8.CBLmodelincluded.
9.SUEWShasbeeninco po a edin oUMEP
NewinSUEWSVe sion2014b( eleased8Oc obe 2014)
[V2014manual]Thesea ec  he uncon igu a ioni p e iously unwi holde  e sionso  hemodel:
1.Newinpu o  h eeaddi ionalcolumnsin heMe eo ologicalinpu  ile(di usi eanddi ec sola  adia ion,
andwinddi ec ion)
2.Changeo inpu  a iablesinIni ialCondi ions.nml ile.No ewenow e e  oCTasET(ie.E e g een ees
a he  hanconi e ous ees)
3.InG idConnec ionsYYYY. x , hesi enamesshouldnowbewi hou  heunde sco e(e.g“Sm”andno
“Sm_”)
O he issues:
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 68/71
1.Numbe o g ida eas ha canbemodelled( o oneg id,oneyea 120; o oneg id woyea s80)
2.Commen abou Timein e alo inpu da a
3.Bug ix:Columnheade sco ec edin5min ile
4.Bug ix:Su aces a e60min ileco ec ed ogi e helas 5mino  hehou ( a he  hancumula ing
h ough hehou )
5.Bug ix:uni sin heHo izon alsoilwa e  ans e
6.E o Hin s:Mo eha ebeenadded o hep oblems. x  ile.
7.Manual:newsec ionon unning hemodelapp op ia ely
8.Manual:no a ion ableupda ed
9.Possibili y oaddsnowaccumula ionandmel :newpape
Jä iL,G immondCSB,TakaM,No dboA,Se äläH,andS achanIB2014:De elopmen o  heSu ace
U banEne gyandWa e balanceScheme(SUEWS) o coldclima eci ies,Geosci.ModelDe .7,1691
1711,doi:10.5194/gmd716912014.
NewinSUEWSVe sion2014a.1( eleasedFeb ua y26,2014)
1.Pleasesee hela genumbe o changesmadein he2014a elease.
2.Thisisamino change oadd essins alling heso wa e.
3.Mino upda es o hemanual
NewinSUEWSVe sion2014a( eleased21Feb2014)
1.Bug ix:Ex e nali iga ioniscalcula edascombined omau oma icandmanuali iga ionanddu ing
p ecipi a ione en s hemanuali iga ionis educed o60%o  hecalcula ed alues.Inp e ious e sion
o  hemodel, hei iga ionwasinallcases aken60%o  hecalcula ed alue,bu now hishasbeen
ixed.
2.Inp e ious e sionso  hemodel,i iga ionwasonlyallowedon hei iga edg asssu ace ype.Now,
i iga ionisalsoallowedone e g eenanddeciduous ees/sh ubssu aces.Thesea eno howe e
ea edassepa a esu aces,bu  heamoun o i iga ionise enlydis ibu ed o hewholesu ace ype
in hemodelleda ea.Theamoun o wa e iscalcula edusingsameequa ionas o g asssu ace
(equa ion5inJä ie al.2011),and he ac iono i iga ed ees/sh ubs( ela i e o hea eao
ee/sh ubssu ace)isse in hegis ile(SeeTable4.11:SSss_YYYY.gis)
3.In hecu en  e siono  hemodel, heuse isable oadjus  helea onandlea o leng hsin he
Func ionalTypes.nml ile.Inaddi ion,use canchoosewhe he  ouse empe a u edependen  unc ions
o combina iono  empe a u eanddayleng h(ad ised obeuseda highla i udes)
4.In hegis ile, he eisanew a iableAl  ha is hea eaal i udeabo eseale el.I no knownexac lyuse
anapp oxima e alue.
5.Snow emo alp o ilehasbeenadded o heHou lyP o ileSSss_YYYY. x .No ye used!
6.Model imein e alhasbeenchanged omminu es oseconds.P e e edin e alis3600seconds(1
hou )
7.Manualco ec ion:inpu  a iableSoilmois u esaidsoilmois u ede ici in hemanual–wo d emo ed
8.Mul iplecompiled e sionso SUEWS eleased.The ea enowuse sinApple,LinuxandWindows
en i onmen s.Sowewillnow eleasecompiled e sions o mo eope a ingsys ems(sec ion3).
9.The ea esomechangesin heou pu  ilecolumnssoplease,check he espec i e ableo eachused
ou pu  ile.
10.Bug ix:wi h e ysmallamoun o  ege a ioninana ea–impac edPhenology o LUMPS
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 69/71
NewinSUEWSVe sion2013a
1.Radia ionselec ionbug ixed
2.Ae odynamic esis ance–when e ylownolonge  e e s oneu al(whichcausedala gejump)–bu
s ayslow
3.I iga iondayo week ixed
4.Newe o messages
5.min ile–nowincludesadecimal imecolumn–seeSec ion5.4–Table5.3
NewinSUEWSVe sion2012b
1.E o messagegene a edi all heda aa eno a ailable o  hesu ace esis ancecalcula ions
2.E o messagegene a edi windda aa ebelowze oplanedisplacemen heigh .
3.Alle o messagesnoww i en o‘P oblem. x ’ a he  hanembeddedinanE o File.No esomee o s
willbew i enand hep og amwillcon inueo he swills op hep og am.
4.De aul  a iables emo ed(seebelow).Modelwills opi anyda aa ep oblema ic.Fileshouldbe
checked oensu e ha  easonableda aa ebeingused.I ane o occu swhen he eshouldno beone
le usknowasi maymeanweha emade helimi s oo es ic i e.
Con en snolonge usedFilede aul Fcld=0.1de aul P es=1013de aul RH=50de aul T=10de aul U=3
RunCon ol.nml
Jus dele elines om ile
Valuesyouhadwe elikelydi e en  om heseexample alueshownhe e
NewinSUEWSVe sion2012a
1.Imp o ede o messageswhenane o isencoun e ed.E o messagewillgene allybew i en o he
sc eenand o he ile‘p oblems. x ’
2.Fo ma o allinpu  ilesha echanged.
3.Newexcelsp eadshee andRp og amme ohelpp epa e equi edda a iles.(No  equi ed)
4.Fo ma o coe  lux(OHM)inpu  ilesha echanged.
Thisallows o clea e iden i ica ion o use so  hecoe icien s ha a eac ually obeused
This equi esanaddi ional ilewi hcoe icien s.Thesedono need obeadjus edbu newcoe icien s
canbeadded.Wewouldapp ecia e ecei ingaddi ionalcoe icien sso heycanbeincludedin u u e
eleases–PleaseemailSue.
5.S o agehea  lux(OHM)coe icien scanbechangedby
imeo yea (summe ,win e )
su acewe nesss a e
6.New ilesa ew i en:DailyS a e. x
P o ides hes a uso  a iables ha a eupda edonadailyo basiso asnapsho a  heendo each
day.
7.Su aceTypes
Cla i ica iono su ace ypeshasbeenmade.SeeGISandOHM ela ed iles
NewinSUEWSVe sion2011b
1.S o agehea  lux(ΔQs)andan h opogenichea  lux(QF)canbese  obe0Wm2

20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 70/71
2.Calcula iono hyd aulicconduc i i yinsoilhasbeenimp o edandHyd aulicConduc inSUEWSInpu .nml
is eplacedwi hnameSa Hyd aulicConduc
3.Following emo ed omHeade Inpu .nml
Thelowe  h eea enowde e mined om hewa e usebeha iou usedinSUEWS
1.Followingadded oHeade Inpu .nml
Sa Hyd aulicConduc
de aul Q
de aul Qs
2.I ΔQsandQFa eno calcula edin hemodelbu a egi enasaninpu , hemissingda ais eplacedwi h
hede aul  alues.
3.Added oSAHPinpu  ile
AHDIUPRF–diu nalp o ileusedi An h opHea Choice=1
V2012a hisbecameobsole eOHM ile(SSss_YYYY.ohm)
Di e encesbe weenSUEWS,LUMPSandFRAISE
Thela ges di e encebe weenLUMPSandSUEWSis ha  hela e simula es heu banwa e balancein
de ailwhileLUMPS akesasimple app oach o  hesensibleandla en hea  luxesand hewa e balance
(“wa e bucke ”).Thecalcula iono e apo a ion/la en hea inSUEWSismo ebiophysicallybased.Due oi s
simplici y,LUMPS equi eslesspa ame e sino de  o un.SUEWSgi es u bulen hea  luxescalcula ed
wi hbo hmodelsasanou pu .Themodelcan unLUMPSalonewi hou  unningSUEWS(Table4.1–
SuewsS a us).
Simila i iesanddi e encesbe weenLUMPSandSUEWS.
LUMPS SUEWS
Ne allwa e
adia ion(Q*) Inpu o NARP Inpu o NARP
S o agehea  lux
(ΔQS) Inpu o  omOHM Inpu o  omOHM
An h opogenic
hea  lux(QF) Inpu o calcula ed Inpu o calcula ed
La en hea (QE) DeB uinandHol slag
(1982) PenmanMon ei hequa ion2
Sensiblehea  lux
(QH)
DeB uinandHol slag
(1982) Residual oma ailableene gyminusQE
Wa e balance Nowa e balanceincluded Runningwa e balanceo canopyandwa e balanceo
soil
Soilmois u e No conside ed Modelled
20/06/2016 SUEWSUMEP
h p://u banclima e.ne /umep/SUEWS 71/71
Su acewe ness Simplewa e bucke model Runningwa e balance
I iga ion Only ac iono su ace
a ea ha isi iga ed Inpu o calcula edwi hasimplemodel
Su aceco e buildings,pa ed,
ege a ion
buildings,pa ed,coni e ousanddeciduous
ees/sh ubs,i iga edanduni iga edg ass
FRAISEFluxRa io–Ac i eIndexSu aceExchange
FRAISEp o idesanes ima eo meanmidday(±3ha oundsola noon)ene gypa i ioning omin o ma ion
on hesu acecha ac e is icsandes ima eso  hemeanmiddayincoming adia i eene gyand
an h opogenichea  elease.Please e e  oLo idanandG immond(2012)  o  u he de ails.
Topic FRAISE LUMPS SUEWS
Complexi y Simples :FRAISE Mo ecomplex:SUEWS
So wa e
p o ided: Rcode Windowsexe(w i en
inFo an)
Windowsexe(w i eninFo an)
o he  e sionsa ailable
Applicable
pe iod:
Midday(wi hin3ho
sola noon) hou ly 5minhou lyannual
Unique
ea u es:
calcula esac i esu ace
–and luxes
adia ionandene gy
balances
adia ion,ene gyandwa e balance
(includesLUMPS)
[39]