Tip

  1. Need help? Please let us know in the UMEP Community.

  2. Find an issue within this page? Please report it in the GitHub issues.

  3. A good understanding of SUEWS is a prerequisite to the proper use of SuPy.

df_state variables

Note

Data structure of df_state is explained here.

aerodynamicresistancemethod
Description

Internal use. Please DO NOT modify

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

None

ah_min
Description

Minimum QF values.

Dimensionality

(2,)

Dimensionality Remarks

2: {Weekday, Weekend}

SUEWS-related variables

AHMin_WD, AHMin_WE

ah_slope_cooling
Description

Cooling slope of QF calculation.

Dimensionality

(2,)

Dimensionality Remarks

2: {Weekday, Weekend}

SUEWS-related variables

AHSlope_Cooling_WD, AHSlope_Cooling_WE

ah_slope_heating
Description

Heating slope of QF calculation.

Dimensionality

(2,)

Dimensionality Remarks

2: {Weekday, Weekend}

SUEWS-related variables

AHSlope_Heating_WD, AHSlope_Heating_WE

ahprof_24hr
Description

Hourly profile values used in energy use calculation.

Dimensionality

(24, 2)

Dimensionality Remarks

24: hours of a day

2: {Weekday, Weekend}

SUEWS-related variables

EnergyUseProfWD, EnergyUseProfWE

alb
Description

Effective surface albedo (middle of the day value) for summertime.

Dimensionality

(7,)

Dimensionality Remarks

7: { Paved, Bldgs, EveTr, DecTr, Grass, BSoil, Water}

SUEWS-related variables

AlbedoMax

albdectr_id
Description

Albedo of deciduous surface DecTr on day 0 of run

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

albDecTr0

albevetr_id
Description

Albedo of evergreen surface EveTr on day 0 of run

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

albEveTr0

albgrass_id
Description

Albedo of grass surface Grass on day 0 of run

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

albGrass0

albmax_dectr
Description

Effective surface albedo (middle of the day value) for summertime.

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

AlbedoMax

albmax_evetr
Description

Effective surface albedo (middle of the day value) for summertime.

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

AlbedoMax

albmax_grass
Description

Effective surface albedo (middle of the day value) for summertime.

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

AlbedoMax

albmin_dectr
Description

Effective surface albedo (middle of the day value) for wintertime (not including snow).

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

AlbedoMin

albmin_evetr
Description

Effective surface albedo (middle of the day value) for wintertime (not including snow).

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

AlbedoMin

albmin_grass
Description

Effective surface albedo (middle of the day value) for wintertime (not including snow).

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

AlbedoMin

alpha_bioco2
Description

The mean apparent ecosystem quantum. Represents the initial slope of the light-response curve.

Dimensionality

(3,)

Dimensionality Remarks

3: { EveTr, DecTr, Grass}

SUEWS-related variables

alpha

alpha_enh_bioco2
Description

Part of the alpha coefficient related to the fraction of vegetation.

Dimensionality

(3,)

Dimensionality Remarks

3: { EveTr, DecTr, Grass}

SUEWS-related variables

alpha_enh

alt
Description

Altitude of grids [m].

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

Alt

baset
Description

Base Temperature for initiating growing degree days (GDD) for leaf growth. [°C]

Dimensionality

(3,)

Dimensionality Remarks

3: { EveTr, DecTr, Grass}

SUEWS-related variables

BaseT

baset_cooling
Description

Critical cooling temperature.

Dimensionality

(2,)

Dimensionality Remarks

2: {Weekday, Weekend}

SUEWS-related variables

TCritic_Cooling_WD, TCritic_Cooling_WE

baset_hc
Description

Base temperature for heating degree days [°C]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

BaseT_HC

baset_heating
Description

Critical heating temperature.

Dimensionality

(2,)

Dimensionality Remarks

2: {Weekday, Weekend}

SUEWS-related variables

TCritic_Heating_WD, TCritic_Heating_WE

basete
Description

Base temperature for initiating sensesance degree days (SDD) for leaf off. [°C]

Dimensionality

(3,)

Dimensionality Remarks

3: { EveTr, DecTr, Grass}

SUEWS-related variables

BaseTe

basetmethod
Description

Determines method for base temperature used in HDD/CDD calculations.

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

BaseTMethod

beta_bioco2
Description

The light-saturated gross photosynthesis of the canopy. [umol m-2 s-1 ]

Dimensionality

(3,)

Dimensionality Remarks

3: { EveTr, DecTr, Grass}

SUEWS-related variables

beta

beta_enh_bioco2
Description

Part of the beta coefficient related to the fraction of vegetation.

Dimensionality

(3,)

Dimensionality Remarks

3: { EveTr, DecTr, Grass}

SUEWS-related variables

beta_enh

bldgh
Description

Mean building height [m]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

H_Bldgs

capmax_dec
Description

Maximum water storage capacity for upper surfaces (i.e. canopy)

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

StorageMax

capmin_dec
Description

Minimum water storage capacity for upper surfaces (i.e. canopy).

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

StorageMin

chanohm
Description

Bulk transfer coefficient for this surface to use in AnOHM [-]

Dimensionality

(7,)

Dimensionality Remarks

7: { Paved, Bldgs, EveTr, DecTr, Grass, BSoil, Water}

SUEWS-related variables

AnOHM_Ch

co2pointsource
Description

CO2 emission factor [kg km-1]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

CO2PointSource

cpanohm
Description

Volumetric heat capacity for this surface to use in AnOHM [J m-3]

Dimensionality

(7,)

Dimensionality Remarks

7: { Paved, Bldgs, EveTr, DecTr, Grass, BSoil, Water}

SUEWS-related variables

AnOHM_Cp

crwmax
Description

Maximum water holding capacity of snow [mm]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

CRWMax

crwmin
Description

Minimum water holding capacity of snow [mm]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

CRWMin

daywat
Description

Irrigation flag: 1 for on and 0 for off.

Dimensionality

(7,)

Dimensionality Remarks

7: {Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday}

SUEWS-related variables

DayWat(1), DayWat(2), DayWat(3), DayWat(4), DayWat(5), DayWat(6), DayWat(7)

daywatper
Description

Fraction of properties using irrigation for each day of a week.

Dimensionality

(7,)

Dimensionality Remarks

7: {Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday}

SUEWS-related variables

DayWatPer(1), DayWatPer(2), DayWatPer(3), DayWatPer(4), DayWatPer(5), DayWatPer(6), DayWatPer(7)

decidcap_id
Description

Storage capacity of deciduous surface DecTr on day 0 of run.

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

decidCap0

dectreeh
Description

Mean height of deciduous trees [m]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

H_DecTr

diagnose
Description

Internal use. Please DO NOT modify

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

None

diagqn
Description

Internal use. Please DO NOT modify

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

None

diagqs
Description

Internal use. Please DO NOT modify

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

None

drainrt
Description

Drainage rate of bucket for LUMPS [mm h-1]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

LUMPS_DrRate

ef_umolco2perj
Description

Emission factor for fuels used for building heating.

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

EF_umolCO2perJ

emis
Description

Effective surface emissivity.

Dimensionality

(7,)

Dimensionality Remarks

7: { Paved, Bldgs, EveTr, DecTr, Grass, BSoil, Water}

SUEWS-related variables

Emissivity

emissionsmethod
Description

Determines method for QF calculation.

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

EmissionsMethod

enddls
Description

End of the day light savings [DOY]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

EndDLS

enef_v_jkm
Description

Emission factor for heat [J k|m^-1|].

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

EnEF_v_Jkm

evapmethod
Description

Internal use. Please DO NOT modify

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

None

evetreeh
Description

Mean height of evergreen trees [m]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

H_EveTr

faibldg
Description

Frontal area index for buildings [-]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

FAI_Bldgs

faidectree
Description

Frontal area index for deciduous trees [-]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

FAI_DecTr

faievetree
Description

Frontal area index for evergreen trees [-]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

FAI_EveTr

faut
Description

Fraction of irrigated area that is irrigated using automated systems

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

Faut

fcef_v_kgkm
Description

CO2 emission factor for weekdays [kg km-1];;CO2 emission factor for weekends [kg km-1]

Dimensionality

(2,)

Dimensionality Remarks

2: {Weekday, Weekend}

SUEWS-related variables

FcEF_v_kgkmWD, FcEF_v_kgkmWE

flowchange
Description

Difference in input and output flows for water surface [mm h-1]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

FlowChange

frfossilfuel_heat
Description

Fraction of fossil fuels used for building heating [-]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

FrFossilFuel_Heat

frfossilfuel_nonheat
Description

Fraction of fossil fuels used for building energy use [-]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

FrFossilFuel_NonHeat

g1
Description

Related to maximum surface conductance [mm s-1]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

G1

g2
Description

Related to Kdown dependence [W m-2]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

G2

g3
Description

Related to VPD dependence [units depend on gsModel]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

G3

g4
Description

Related to VPD dependence [units depend on gsModel]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

G4

g5
Description

Related to temperature dependence [°C]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

G5

g6
Description

Related to soil moisture dependence [mm-1]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

G6

gddfull
Description

The growing degree days (GDD) needed for full capacity of the leaf area index (LAI) [°C].

Dimensionality

(3,)

Dimensionality Remarks

3: { EveTr, DecTr, Grass}

SUEWS-related variables

GDDFull

gsmodel
Description

Formulation choice for conductance calculation.

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

gsModel

h_maintain
Description

water depth to maintain used in automatic irrigation (e.g., ponding water due to flooding irrigation in rice crop-field) [mm].

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

H_maintain

humactivity_24hr
Description

Hourly profile values used in human activity calculation.

Dimensionality

(24, 2)

Dimensionality Remarks

24: hours of a day

2: {Weekday, Weekend}

SUEWS-related variables

ActivityProfWD, ActivityProfWE

ie_a
Description

Coefficient for automatic irrigation model.

Dimensionality

(3,)

Dimensionality Remarks

3: { EveTr, DecTr, Grass}

SUEWS-related variables

Ie_a1, Ie_a2, Ie_a3

ie_end
Description

Day when irrigation ends [DOY]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

Ie_end

ie_m
Description

Coefficient for manual irrigation model.

Dimensionality

(3,)

Dimensionality Remarks

3: { EveTr, DecTr, Grass}

SUEWS-related variables

Ie_m1, Ie_m2, Ie_m3

ie_start
Description

Day when irrigation starts [DOY]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

Ie_start

internalwateruse_h
Description

Internal water use [mm h-1]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

InternalWaterUse

irrfracbldgs
Description

Fraction of Bldgs that is irrigated [-]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

IrrFr_Bldgs

irrfracbsoil
Description

Fraction of BSoil that is irrigated [-]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

IrrFr_BSoil

irrfracdectr
Description

Fraction of DecTr that is irrigated [-]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

IrrFr_DecTr

irrfracevetr
Description

Fraction of EveTr that is irrigated [-]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

IrrFr_EveTr

irrfracgrass
Description

Fraction of Grass that is irrigated [-]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

IrrFr_Grass

irrfracpaved
Description

Fraction of Paved that is irrigated [-]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

IrrFr_Paved

irrfracwater
Description

Fraction of Water that is irrigated [-]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

IrrFr_Water

kkanohm
Description

Thermal conductivity for this surface to use in AnOHM [W m K-1]

Dimensionality

(7,)

Dimensionality Remarks

7: { Paved, Bldgs, EveTr, DecTr, Grass, BSoil, Water}

SUEWS-related variables

AnOHM_Kk

kmax
Description

Maximum incoming shortwave radiation [W m-2]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

Kmax

lai_id
Description

Initial LAI values.

Dimensionality

(3,)

Dimensionality Remarks

3: { EveTr, DecTr, Grass}

SUEWS-related variables

LAIinitialDecTr, LAIinitialEveTr, LAIinitialGrass

laicalcyes
Description

Internal use. Please DO NOT modify

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

None

laimax
Description

full leaf-on summertime value

Dimensionality

(3,)

Dimensionality Remarks

3: { EveTr, DecTr, Grass}

SUEWS-related variables

LAIMax

laimin
Description

leaf-off wintertime value

Dimensionality

(3,)

Dimensionality Remarks

3: { EveTr, DecTr, Grass}

SUEWS-related variables

LAIMin

laipower
Description

parameters required by LAI calculation.

Dimensionality

(4, 3)

Dimensionality Remarks

4: {LeafGrowthPower1, LeafGrowthPower2, LeafOffPower1, LeafOffPower2}

3: { EveTr, DecTr, Grass}

SUEWS-related variables

LeafGrowthPower1, LeafGrowthPower2, LeafOffPower1, LeafOffPower2

laitype
Description

LAI calculation choice.

Dimensionality

(3,)

Dimensionality Remarks

3: { EveTr, DecTr, Grass}

SUEWS-related variables

LAIEq

lat
Description

Latitude [deg].

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

lat

lng
Description

longitude [deg]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

lng

maxconductance
Description

The maximum conductance of each vegetation or surface type. [mm s-1]

Dimensionality

(3,)

Dimensionality Remarks

3: { EveTr, DecTr, Grass}

SUEWS-related variables

MaxConductance

maxfcmetab
Description

Maximum (day) CO2 from human metabolism. [W m-2]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

MaxFCMetab

maxqfmetab
Description

Maximum value for human heat emission. [W m-2]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

MaxQFMetab

min_res_bioco2
Description

Minimum soil respiration rate (for cold-temperature limit) [umol m-2 s-1].

Dimensionality

(3,)

Dimensionality Remarks

3: { EveTr, DecTr, Grass}

SUEWS-related variables

min_respi

minfcmetab
Description

Minimum (night) CO2 from human metabolism. [W m-2]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

MinFCMetab

minqfmetab
Description

Minimum value for human heat emission. [W m-2]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

MinQFMetab

narp_emis_snow
Description

Effective surface emissivity.

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

Emissivity

narp_trans_site
Description

Atmospheric transmissivity for NARP [-]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

NARP_Trans

netradiationmethod
Description

Determines method for calculation of radiation fluxes.

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

NetRadiationMethod

ohm_coef
Description

Coefficients for OHM calculation.

Dimensionality

(8, 4, 3)

Dimensionality Remarks

8: { Paved, Bldgs, EveTr, DecTr, Grass, BSoil, Water, one extra land cover type (currently NOT used)}

4: {SummerWet, SummerDry, WinterWet, WinterDry}

3: {a1, a2, a3}

SUEWS-related variables

a1, a2, a3

ohm_threshsw
Description

Temperature threshold determining whether summer/winter OHM coefficients are applied [°C]

Dimensionality

(8,)

Dimensionality Remarks

8: { Paved, Bldgs, EveTr, DecTr, Grass, BSoil, Water, one extra land cover type (currently NOT used)}

SUEWS-related variables

OHMThresh_SW

ohm_threshwd
Description

Soil moisture threshold determining whether wet/dry OHM coefficients are applied [-]

Dimensionality

(8,)

Dimensionality Remarks

8: { Paved, Bldgs, EveTr, DecTr, Grass, BSoil, Water, one extra land cover type (currently NOT used)}

SUEWS-related variables

OHMThresh_WD

ohmincqf
Description

Determines whether the storage heat flux calculation uses Q* or ( Q* +QF).

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

OHMIncQF

pipecapacity
Description

Storage capacity of pipes [mm]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

PipeCapacity

popdensdaytime
Description

Daytime population density (i.e. workers, tourists) [people ha-1]

Dimensionality

(2,)

Dimensionality Remarks

2: {Weekday, Weekend}

SUEWS-related variables

PopDensDay

popdensnighttime
Description

Night-time population density (i.e. residents) [people ha-1]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

PopDensNight

popprof_24hr
Description

Hourly profile values used in dynamic population estimation.

Dimensionality

(24, 2)

Dimensionality Remarks

24: hours of a day

2: {Weekday, Weekend}

SUEWS-related variables

PopProfWD, PopProfWE

pormax_dec
Description

full leaf-on summertime value Used only for DecTr (can affect roughness calculation)

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

PorosityMax

pormin_dec
Description

leaf-off wintertime value Used only for DecTr (can affect roughness calculation)

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

PorosityMin

porosity_id
Description

Porosity of deciduous vegetation on day 0 of run.

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

porosity0

preciplimit
Description

Temperature limit when precipitation falls as snow [°C]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

PrecipLimSnow

preciplimitalb
Description

Limit for hourly precipitation when the ground is fully covered with snow [mm]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

PrecipLimAlb

qf0_beu
Description

Building energy use [W m-2]

Dimensionality

(2,)

Dimensionality Remarks

2: {Weekday, Weekend}

SUEWS-related variables

QF0_BEU_WD, QF0_BEU_WE

qf_a
Description

Base value for QF calculation.

Dimensionality

(2,)

Dimensionality Remarks

2: {Weekday, Weekend}

SUEWS-related variables

QF_A_WD, QF_A_WE

qf_b
Description

Parameter related to heating degree days.

Dimensionality

(2,)

Dimensionality Remarks

2: {Weekday, Weekend}

SUEWS-related variables

QF_B_WD, QF_B_WE

qf_c
Description

Parameter related to heating degree days.

Dimensionality

(2,)

Dimensionality Remarks

2: {Weekday, Weekend}

SUEWS-related variables

QF_C_WD, QF_C_WE

radmeltfact
Description

Hourly radiation melt factor of snow [mm W-1 h-1]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

RadMeltFactor

raincover
Description

Limit when surface totally covered with water for LUMPS [mm]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

LUMPS_Cover

rainmaxres
Description

Maximum water bucket reservoir [mm] Used for LUMPS surface wetness control.

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

LUMPS_MaxRes

resp_a
Description

Respiration coefficient a.

Dimensionality

(3,)

Dimensionality Remarks

3: { EveTr, DecTr, Grass}

SUEWS-related variables

resp_a

resp_b
Description

Respiration coefficient b - related to air temperature dependency.

Dimensionality

(3,)

Dimensionality Remarks

3: { EveTr, DecTr, Grass}

SUEWS-related variables

resp_b

roughlenheatmethod
Description

Determines method for calculating roughness length for heat.

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

RoughLenHeatMethod

roughlenmommethod
Description

Determines how aerodynamic roughness length (z0m) and zero displacement height (zdm) are calculated.

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

RoughLenMomMethod

runofftowater
Description

Fraction of above-ground runoff flowing to water surface during flooding [-]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

RunoffToWater

s1
Description

A parameter related to soil moisture dependence [-]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

S1

s2
Description

A parameter related to soil moisture dependence [mm]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

S2

sathydraulicconduct
Description

Hydraulic conductivity for saturated soil [mm s-1]

Dimensionality

(7,)

Dimensionality Remarks

7: { Paved, Bldgs, EveTr, DecTr, Grass, BSoil, Water}

SUEWS-related variables

SatHydraulicCond

sddfull
Description

The sensesence degree days (SDD) needed to initiate leaf off. [°C]

Dimensionality

(3,)

Dimensionality Remarks

3: { EveTr, DecTr, Grass}

SUEWS-related variables

SDDFull

sfr
Description

Surface cover fractions.

Dimensionality

(7,)

Dimensionality Remarks

7: { Paved, Bldgs, EveTr, DecTr, Grass, BSoil, Water}

SUEWS-related variables

Fr_Bldgs, Fr_Bsoil, Fr_DecTr, Fr_EveTr, Fr_Grass, Fr_Paved, Fr_Water

smdmethod
Description

Determines method for calculating soil moisture deficit (SMD).

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

SMDMethod

snowalb
Description

Initial snow albedo

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

SnowAlb0

snowalbmax
Description

Effective surface albedo (middle of the day value) for summertime.

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

AlbedoMax

snowalbmin
Description

Effective surface albedo (middle of the day value) for wintertime (not including snow).

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

AlbedoMin

snowdens
Description

Initial snow density of each land cover.

Dimensionality

(7,)

Dimensionality Remarks

7: { Paved, Bldgs, EveTr, DecTr, Grass, BSoil, Water}

SUEWS-related variables

SnowDensBldgs, SnowDensPaved, SnowDensDecTr, SnowDensEveTr, SnowDensGrass, SnowDensBSoil, SnowDensWater

snowdensmax
Description

Maximum snow density [kg m-3]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

SnowDensMax

snowdensmin
Description

Fresh snow density [kg m-3]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

SnowDensMin

snowfrac
Description

Initial plan area fraction of snow on each land cover`

Dimensionality

(7,)

Dimensionality Remarks

7: { Paved, Bldgs, EveTr, DecTr, Grass, BSoil, Water}

SUEWS-related variables

SnowFracBldgs, SnowFracPaved, SnowFracDecTr, SnowFracEveTr, SnowFracGrass, SnowFracBSoil, SnowFracWater

snowlimbldg
Description

Limit of the snow water equivalent for snow removal from roads and roofs [mm]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

SnowLimRemove

snowlimpaved
Description

Limit of the snow water equivalent for snow removal from roads and roofs [mm]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

SnowLimRemove

snowpack
Description

Initial snow water equivalent on each land cover

Dimensionality

(7,)

Dimensionality Remarks

7: { Paved, Bldgs, EveTr, DecTr, Grass, BSoil, Water}

SUEWS-related variables

SnowPackBldgs, SnowPackPaved, SnowPackDecTr, SnowPackEveTr, SnowPackGrass, SnowPackBSoil, SnowPackWater

snowpacklimit
Description

Limit for the snow water equivalent when snow cover starts to be patchy [mm]

Dimensionality

(7,)

Dimensionality Remarks

7: { Paved, Bldgs, EveTr, DecTr, Grass, BSoil, Water}

SUEWS-related variables

SnowLimPatch

snowprof_24hr
Description

Hourly profile values used in snow clearing.

Dimensionality

(24, 2)

Dimensionality Remarks

24: hours of a day

2: {Weekday, Weekend}

SUEWS-related variables

SnowClearingProfWD, SnowClearingProfWE

snowuse
Description

Determines whether the snow part of the model runs.

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

SnowUse

snowwater
Description

Initial amount of liquid water in the snow on each land cover

Dimensionality

(7,)

Dimensionality Remarks

7: { Paved, Bldgs, EveTr, DecTr, Grass, BSoil, Water}

SUEWS-related variables

SnowWaterBldgsState, SnowWaterPavedState, SnowWaterDecTrState, SnowWaterEveTrState, SnowWaterGrassState, SnowWaterBSoilState, SnowWaterWaterState

soildepth
Description

Depth of soil beneath the surface [mm]

Dimensionality

(7,)

Dimensionality Remarks

7: { Paved, Bldgs, EveTr, DecTr, Grass, BSoil, Water}

SUEWS-related variables

SoilDepth

soilstore_id
Description

Initial water stored in soil beneath each land cover

Dimensionality

(7,)

Dimensionality Remarks

7: { Paved, Bldgs, EveTr, DecTr, Grass, BSoil, Water}

SUEWS-related variables

SoilstoreBldgsState, SoilstorePavedState, SoilstoreDecTrState, SoilstoreEveTrState, SoilstoreGrassState, SoilstoreBSoilState

soilstorecap
Description

Limit value for SoilDepth [mm]

Dimensionality

(7,)

Dimensionality Remarks

7: { Paved, Bldgs, EveTr, DecTr, Grass, BSoil, Water}

SUEWS-related variables

SoilStoreCap

stabilitymethod
Description

Defines which atmospheric stability functions are used.

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

StabilityMethod

startdls
Description

Start of the day light savings [DOY]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

StartDLS

state_id
Description

Initial wetness condition on each land cover

Dimensionality

(7,)

Dimensionality Remarks

7: { Paved, Bldgs, EveTr, DecTr, Grass, BSoil, Water}

SUEWS-related variables

BldgsState, PavedState, DecTrState, EveTrState, GrassState, BSoilState, WaterState

statelimit
Description

Upper limit to the surface state. [mm]

Dimensionality

(7,)

Dimensionality Remarks

7: { Paved, Bldgs, EveTr, DecTr, Grass, BSoil, Water}

SUEWS-related variables

StateLimit

storageheatmethod
Description

Determines method for calculating storage heat flux ΔQS.

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

StorageHeatMethod

storedrainprm
Description

Coefficients used in drainage calculation.

Dimensionality

(6, 7)

Dimensionality Remarks

6: { StorageMin, DrainageEq, DrainageCoef1, DrainageCoef2, StorageMax, current storage}

7: { Paved, Bldgs, EveTr, DecTr, Grass, BSoil, Water}

SUEWS-related variables

DrainageCoef1, DrainageCoef2, DrainageEq, StorageMax, StorageMin

surfacearea
Description

Area of the grid [ha].

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

SurfaceArea

tau_a
Description

Time constant for snow albedo aging in cold snow [-]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

tau_a

tau_f
Description

Time constant for snow albedo aging in melting snow [-]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

tau_f

tau_r
Description

Time constant for snow density ageing [-]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

tau_r

tempmeltfact
Description

Hourly temperature melt factor of snow [mm K-1 h-1]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

TempMeltFactor

th
Description

Upper air temperature limit [°C]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

TH

theta_bioco2
Description

The convexity of the curve at light saturation.

Dimensionality

(3,)

Dimensionality Remarks

3: { EveTr, DecTr, Grass}

SUEWS-related variables

theta

timezone
Description

Time zone [h] for site relative to UTC (east is positive). This should be set according to the times given in the meteorological forcing file(s).

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

Timezone

tl
Description

Lower air temperature limit [°C]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

TL

trafficrate
Description

Traffic rate used for CO2 flux calculation.

Dimensionality

(2,)

Dimensionality Remarks

2: {Weekday, Weekend}

SUEWS-related variables

TrafficRate_WD, TrafficRate_WE

trafficunits
Description

Units for the traffic rate for the study area. Not used in v2018a.

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

TrafficUnits

traffprof_24hr
Description

Hourly profile values used in traffic activity calculation.

Dimensionality

(24, 2)

Dimensionality Remarks

24: hours of a day

2: {Weekday, Weekend}

SUEWS-related variables

TraffProfWD, TraffProfWE

tstep
Description

Specifies the model time step [s].

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

Tstep

veg_type
Description

Internal use. Please DO NOT modify

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

None

waterdist
Description

Fraction of water redistribution

Dimensionality

(8, 6)

Dimensionality Remarks

8: { Paved, Bldgs, EveTr, DecTr, Grass, BSoil, Water, one extra land cover type (currently NOT used)}

6: { Paved, Bldgs, EveTr, DecTr, Grass, BSoil}

SUEWS-related variables

ToBSoil, ToBldgs, ToDecTr, ToEveTr, ToGrass, ToPaved, ToRunoff, ToSoilStore, ToWater

waterusemethod
Description

Defines how external water use is calculated.

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

WaterUseMethod

wetthresh
Description

Depth of water which determines whether evaporation occurs from a partially wet or completely wet surface [mm].

Dimensionality

(7,)

Dimensionality Remarks

7: { Paved, Bldgs, EveTr, DecTr, Grass, BSoil, Water}

SUEWS-related variables

WetThreshold

wuprofa_24hr
Description

Hourly profile values used in automatic irrigation.

Dimensionality

(24, 2)

Dimensionality Remarks

24: hours of a day

2: {Weekday, Weekend}

SUEWS-related variables

WaterUseProfAutoWD, WaterUseProfAutoWE

wuprofm_24hr
Description

Hourly profile values used in manual irrigation.

Dimensionality

(24, 2)

Dimensionality Remarks

24: hours of a day

2: {Weekday, Weekend}

SUEWS-related variables

WaterUseProfManuWD, WaterUseProfManuWE

z
Description

Measurement height [m].

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

z

z0m_in
Description

Roughness length for momentum [m]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

z0

zdm_in
Description

Zero-plane displacement [m]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

zd