df_state.rst

df_state variables

Note

Data structure of df_state is explained here </data-structure/supy-io.ipynb#df_state_init:-model-initial-states>.

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 <suews:AHMin_WD>, AHMin_WE <suews:AHMin_WE>

ah_slope_cooling

Description

Cooling slope of QF calculation.

Dimensionality

(2,)

Dimensionality Remarks

2: {Weekday, Weekend}

SUEWS-related variables

AHSlope_Cooling_WD <suews:AHSlope_Cooling_WD>, AHSlope_Cooling_WE <suews: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 <suews:AHSlope_Heating_WD>, AHSlope_Heating_WE <suews: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 <suews:EnergyUseProfWD>, EnergyUseProfWE <suews:EnergyUseProfWE>

alb

Description

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

Dimensionality

(7,)

Dimensionality Remarks

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

SUEWS-related variables

AlbedoMax <suews:AlbedoMax>

albdectr_id

Description

Albedo of deciduous surface DecTr on day 0 of run

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

albDecTr0 <suews:albDecTr0>

albevetr_id

Description

Albedo of evergreen surface EveTr on day 0 of run

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

albEveTr0 <suews:albEveTr0>

albgrass_id

Description

Albedo of grass surface Grass on day 0 of run

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

albGrass0 <suews:albGrass0>

albmax_dectr

Description

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

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

AlbedoMax <suews:AlbedoMax>

albmax_evetr

Description

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

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

AlbedoMax <suews:AlbedoMax>

albmax_grass

Description

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

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

AlbedoMax <suews: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 <suews: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 <suews: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 <suews:AlbedoMin>

alpha_bioco2

Description

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

Dimensionality

(3,)

Dimensionality Remarks

3: { suews:EveTr, suews:DecTr, suews:Grass}

SUEWS-related variables

alpha <suews:alpha>

alpha_enh_bioco2

Description

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

Dimensionality

(3,)

Dimensionality Remarks

3: { suews:EveTr, suews:DecTr, suews:Grass}

SUEWS-related variables

alpha_enh <suews:alpha_enh>

alt

Description

Altitude of grids [m].

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

Alt <suews:Alt>

baset

Description

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

Dimensionality

(3,)

Dimensionality Remarks

3: { suews:EveTr, suews:DecTr, suews:Grass}

SUEWS-related variables

BaseT <suews:BaseT>

baset_cooling

Description

Critical cooling temperature.

Dimensionality

(2,)

Dimensionality Remarks

2: {Weekday, Weekend}

SUEWS-related variables

TCritic_Cooling_WD <suews:TCritic_Cooling_WD>, TCritic_Cooling_WE <suews:TCritic_Cooling_WE>

baset_hc

Description

Base temperature for heating degree days [°C]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

:option:BaseT_HC <suews:BaseT_HC>

baset_heating

Description

Critical heating temperature.

Dimensionality

(2,)

Dimensionality Remarks

2: {Weekday, Weekend}

SUEWS-related variables

TCritic_Heating_WD <suews:TCritic_Heating_WD>, TCritic_Heating_WE <suews:TCritic_Heating_WE>

basete

Description

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

Dimensionality

(3,)

Dimensionality Remarks

3: { suews:EveTr, suews:DecTr, suews:Grass}

SUEWS-related variables

BaseTe <suews:BaseTe>

basetmethod

Description

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

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

BaseTMethod <suews:BaseTMethod>

beta_bioco2

Description

The light-saturated gross photosynthesis of the canopy. [umol ]

Dimensionality

(3,)

Dimensionality Remarks

3: { suews:EveTr, suews:DecTr, suews:Grass}

SUEWS-related variables

beta <suews:beta>

beta_enh_bioco2

Description

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

Dimensionality

(3,)

Dimensionality Remarks

3: { suews:EveTr, suews:DecTr, suews:Grass}

SUEWS-related variables

beta_enh <suews:beta_enh>

bldgh

Description

Mean building height [m]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

H_Bldgs <suews:H_Bldgs>

capmax_dec

Description

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

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

StorageMax <suews:StorageMax>

capmin_dec

Description

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

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

StorageMin <suews:StorageMin>

chanohm

Description

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

Dimensionality

(7,)

Dimensionality Remarks

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

SUEWS-related variables

AnOHM_Ch <suews:AnOHM_Ch>

co2pointsource

Description

CO2 emission factor [kg ]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

CO2PointSource <suews:CO2PointSource>

cpanohm

Description

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

Dimensionality

(7,)

Dimensionality Remarks

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

SUEWS-related variables

AnOHM_Cp <suews:AnOHM_Cp>

crwmax

Description

Maximum water holding capacity of snow [mm]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

CRWMax <suews:CRWMax>

crwmin

Description

Minimum water holding capacity of snow [mm]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

CRWMin <suews: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) <suews:DayWat(1)>, DayWat(2) <suews:DayWat(2)>, DayWat(3) <suews:DayWat(3)>, DayWat(4) <suews:DayWat(4)>, DayWat(5) <suews:DayWat(5)>, DayWat(6) <suews:DayWat(6)>, DayWat(7) <suews: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) <suews:DayWatPer(1)>, DayWatPer(2) <suews:DayWatPer(2)>, DayWatPer(3) <suews:DayWatPer(3)>, DayWatPer(4) <suews:DayWatPer(4)>, DayWatPer(5) <suews:DayWatPer(5)>, DayWatPer(6) <suews:DayWatPer(6)>, DayWatPer(7) <suews: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 <suews:decidCap0>

dectreeh

Description

Mean height of deciduous trees [m]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

:option:H_DecTr <suews: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 ]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

LUMPS_DrRate <suews:LUMPS_DrRate>

ef_umolco2perj

Description

Emission factor for fuels used for building heating.

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

EF_umolCO2perJ <suews:EF_umolCO2perJ>

emis

Description

Effective surface emissivity.

Dimensionality

(7,)

Dimensionality Remarks

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

SUEWS-related variables

Emissivity <suews:Emissivity>

emissionsmethod

Description

Determines method for QF calculation.

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

EmissionsMethod <suews:EmissionsMethod>

enddls

Description

End of the day light savings [DOY]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

EndDLS <suews:EndDLS>

enef_v_jkm

Description

Emission factor for heat [J k].

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

EnEF_v_Jkm <suews: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

:option:H_EveTr <suews:H_EveTr>

faibldg

Description

Frontal area index for buildings [-]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

FAI_Bldgs <suews:FAI_Bldgs>

faidectree

Description

Frontal area index for deciduous trees [-]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

FAI_DecTr <suews:FAI_DecTr>

faievetree

Description

Frontal area index for evergreen trees [-]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

FAI_EveTr <suews:FAI_EveTr>

faut

Description

Fraction of irrigated area that is irrigated using automated systems

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

Faut <suews:Faut>

fcef_v_kgkm

Description

CO2 emission factor for weekdays [kg ];;CO2 emission factor for weekends [kg ]

Dimensionality

(2,)

Dimensionality Remarks

2: {Weekday, Weekend}

SUEWS-related variables

FcEF_v_kgkmWD <suews:FcEF_v_kgkmWD>, FcEF_v_kgkmWE <suews:FcEF_v_kgkmWE>

flowchange

Description

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

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

FlowChange <suews:FlowChange>

frfossilfuel_heat

Description

Fraction of fossil fuels used for building heating [-]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

FrFossilFuel_Heat <suews:FrFossilFuel_Heat>

frfossilfuel_nonheat

Description

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

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

FrFossilFuel_NonHeat <suews:FrFossilFuel_NonHeat>

g1

Description

Related to maximum surface conductance [mm ]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

G1 <suews:G1>

g2

Description

Related to Kdown dependence [W ]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

G2 <suews:G2>

g3

Description

Related to VPD dependence [units depend on gsModel]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

G3 <suews:G3>

g4

Description

Related to VPD dependence [units depend on gsModel]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

G4 <suews:G4>

g5

Description

Related to temperature dependence [°C]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

G5 <suews:G5>

g6

Description

Related to soil moisture dependence []

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

G6 <suews:G6>

gddfull

Description

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

Dimensionality

(3,)

Dimensionality Remarks

3: { suews:EveTr, suews:DecTr, suews:Grass}

SUEWS-related variables

GDDFull <suews:GDDFull>

gsmodel

Description

Formulation choice for conductance calculation.

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

gsModel <suews: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 <suews: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 <suews:ActivityProfWD>, ActivityProfWE <suews:ActivityProfWE>

ie_a

Description

Coefficient for automatic irrigation model.

Dimensionality

(3,)

Dimensionality Remarks

3: { suews:EveTr, suews:DecTr, suews:Grass}

SUEWS-related variables

Ie_a1 <suews:Ie_a1>, Ie_a2 <suews:Ie_a2>, Ie_a3 <suews:Ie_a3>

ie_end

Description

Day when irrigation ends [DOY]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

Ie_end <suews:Ie_end>

ie_m

Description

Coefficient for manual irrigation model.

Dimensionality

(3,)

Dimensionality Remarks

3: { suews:EveTr, suews:DecTr, suews:Grass}

SUEWS-related variables

Ie_m1 <suews:Ie_m1>, Ie_m2 <suews:Ie_m2>, Ie_m3 <suews:Ie_m3>

ie_start

Description

Day when irrigation starts [DOY]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

:option:Ie_start <suews:Ie_start>

internalwateruse_h

Description

Internal water use [mm ]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

InternalWaterUse <suews:InternalWaterUse>

irrfracbldgs

Description

Fraction of Bldgs that is irrigated [-]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

IrrFr_Bldgs <suews:IrrFr_Bldgs>

irrfracbsoil

Description

Fraction of BSoil that is irrigated [-]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

IrrFr_BSoil <suews:IrrFr_BSoil>

irrfracdectr

Description

Fraction of DecTr that is irrigated [-]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

IrrFr_DecTr <suews:IrrFr_DecTr>

irrfracevetr

Description

Fraction of EveTr that is irrigated [-]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

IrrFr_EveTr <suews:IrrFr_EveTr>

irrfracgrass

Description

Fraction of Grass that is irrigated [-]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

IrrFr_Grass <suews:IrrFr_Grass>

irrfracpaved

Description

Fraction of Paved that is irrigated [-]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

IrrFr_Paved <suews:IrrFr_Paved>

irrfracwater

Description

Fraction of Water that is irrigated [-]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

IrrFr_Water <suews:IrrFr_Water>

kkanohm

Description

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

Dimensionality

(7,)

Dimensionality Remarks

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

SUEWS-related variables

AnOHM_Kk <suews:AnOHM_Kk>

kmax

Description

Maximum incoming shortwave radiation [W ]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

Kmax <suews:Kmax>

lai_id

Description

Initial LAI values.

Dimensionality

(3,)

Dimensionality Remarks

3: { suews:EveTr, suews:DecTr, suews:Grass}

SUEWS-related variables

LAIinitialDecTr <suews:LAIinitialDecTr>, LAIinitialEveTr <suews:LAIinitialEveTr>, LAIinitialGrass <suews: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: { suews:EveTr, suews:DecTr, suews:Grass}

SUEWS-related variables

LAIMax <suews:LAIMax>

laimin

Description

leaf-off wintertime value

Dimensionality

(3,)

Dimensionality Remarks

3: { suews:EveTr, suews:DecTr, suews:Grass}

SUEWS-related variables

LAIMin <suews:LAIMin>

laipower

Description

parameters required by LAI calculation.

Dimensionality

(4, 3)

Dimensionality Remarks

4: {LeafGrowthPower1, LeafGrowthPower2, LeafOffPower1, LeafOffPower2}

3: { suews:EveTr, suews:DecTr, suews:Grass}

SUEWS-related variables

:option:LeafGrowthPower1 <suews:LeafGrowthPower1>, LeafGrowthPower2 <suews:LeafGrowthPower2>, LeafOffPower1 <suews:LeafOffPower1>, LeafOffPower2 <suews:LeafOffPower2>

laitype

Description

LAI calculation choice.

Dimensionality

(3,)

Dimensionality Remarks

3: { suews:EveTr, suews:DecTr, suews:Grass}

SUEWS-related variables

LAIEq <suews:LAIEq>

lat

Description

Latitude [deg].

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

lat <suews:lat>

lng

Description

longitude [deg]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

lng <suews:lng>

maxconductance

Description

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

Dimensionality

(3,)

Dimensionality Remarks

3: { suews:EveTr, suews:DecTr, suews:Grass}

SUEWS-related variables

MaxConductance <suews:MaxConductance>

maxfcmetab

Description

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

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

MaxFCMetab <suews:MaxFCMetab>

maxqfmetab

Description

Maximum value for human heat emission. [W ]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

MaxQFMetab <suews:MaxQFMetab>

min_res_bioco2

Description

Minimum soil respiration rate (for cold-temperature limit) [umol ].

Dimensionality

(3,)

Dimensionality Remarks

3: { suews:EveTr, suews:DecTr, suews:Grass}

SUEWS-related variables

min_respi <suews:min_respi>

minfcmetab

Description

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

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

MinFCMetab <suews:MinFCMetab>

minqfmetab

Description

Minimum value for human heat emission. [W ]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

MinQFMetab <suews:MinQFMetab>

narp_emis_snow

Description

Effective surface emissivity.

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

Emissivity <suews:Emissivity>

narp_trans_site

Description

Atmospheric transmissivity for NARP [-]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

NARP_Trans <suews:NARP_Trans>

netradiationmethod

Description

Determines method for calculation of radiation fluxes.

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

NetRadiationMethod <suews:NetRadiationMethod>

ohm_coef

Description

Coefficients for OHM calculation.

Dimensionality

(8, 4, 3)

Dimensionality Remarks

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

4: {SummerWet, SummerDry, WinterWet, WinterDry}

3: {a1, a2, a3}

SUEWS-related variables

:option:a1 <suews:a1>, a2 <suews:a2>, a3 <suews:a3>

ohm_threshsw

Description

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

Dimensionality

(8,)

Dimensionality Remarks

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

SUEWS-related variables

OHMThresh_SW <suews:OHMThresh_SW>

ohm_threshwd

Description

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

Dimensionality

(8,)

Dimensionality Remarks

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

SUEWS-related variables

OHMThresh_WD <suews:OHMThresh_WD>

ohmincqf

Description

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

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

:option:OHMIncQF <suews:OHMIncQF>

pipecapacity

Description

Storage capacity of pipes [mm]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

PipeCapacity <suews:PipeCapacity>

popdensdaytime

Description

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

Dimensionality

(2,)

Dimensionality Remarks

2: {Weekday, Weekend}

SUEWS-related variables

PopDensDay <suews:PopDensDay>

popdensnighttime

Description

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

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

PopDensNight <suews: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 <suews:PopProfWD>, PopProfWE <suews: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 <suews: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 <suews:PorosityMin>

porosity_id

Description

Porosity of deciduous vegetation on day 0 of run.

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

porosity0 <suews:porosity0>

preciplimit

Description

Temperature limit when precipitation falls as snow [°C]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

PrecipLimSnow <suews: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 <suews:PrecipLimAlb>

qf0_beu

Description

Building energy use [W ]

Dimensionality

(2,)

Dimensionality Remarks

2: {Weekday, Weekend}

SUEWS-related variables

QF0_BEU_WD <suews:QF0_BEU_WD>, QF0_BEU_WE <suews:QF0_BEU_WE>

qf_a

Description

Base value for QF calculation.

Dimensionality

(2,)

Dimensionality Remarks

2: {Weekday, Weekend}

SUEWS-related variables

QF_A_WD <suews:QF_A_WD>, QF_A_WE <suews: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 <suews:QF_B_WD>, QF_B_WE <suews: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 <suews:QF_C_WD>, QF_C_WE <suews:QF_C_WE>

radmeltfact

Description

Hourly radiation melt factor of snow [mm ]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

RadMeltFactor <suews:RadMeltFactor>

raincover

Description

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

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

LUMPS_Cover <suews: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 <suews:LUMPS_MaxRes>

resp_a

Description

Respiration coefficient a.

Dimensionality

(3,)

Dimensionality Remarks

3: { suews:EveTr, suews:DecTr, suews:Grass}

SUEWS-related variables

resp_a <suews:resp_a>

resp_b

Description

Respiration coefficient b - related to air temperature dependency.

Dimensionality

(3,)

Dimensionality Remarks

3: { suews:EveTr, suews:DecTr, suews:Grass}

SUEWS-related variables

resp_b <suews:resp_b>

roughlenheatmethod

Description

Determines method for calculating roughness length for heat.

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

RoughLenHeatMethod <suews: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 <suews:RoughLenMomMethod>

runofftowater

Description

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

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

RunoffToWater <suews:RunoffToWater>

s1

Description

A parameter related to soil moisture dependence [-]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

S1 <suews:S1>

s2

Description

A parameter related to soil moisture dependence [mm]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

S2 <suews:S2>

sathydraulicconduct

Description

Hydraulic conductivity for saturated soil [mm ]

Dimensionality

(7,)

Dimensionality Remarks

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

SUEWS-related variables

SatHydraulicCond <suews:SatHydraulicCond>

sddfull

Description

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

Dimensionality

(3,)

Dimensionality Remarks

3: { suews:EveTr, suews:DecTr, suews:Grass}

SUEWS-related variables

SDDFull <suews:SDDFull>

sfr

Description

Surface cover fractions.

Dimensionality

(7,)

Dimensionality Remarks

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

SUEWS-related variables

Fr_Bldgs <suews:Fr_Bldgs>, Fr_Bsoil <suews:Fr_Bsoil>, Fr_DecTr <suews:Fr_DecTr>, Fr_EveTr <suews:Fr_EveTr>, Fr_Grass <suews:Fr_Grass>, Fr_Paved <suews:Fr_Paved>, Fr_Water <suews:Fr_Water>

smdmethod

Description

Determines method for calculating soil moisture deficit (SMD).

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

SMDMethod <suews:SMDMethod>

snowalb

Description

Initial snow albedo

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

SnowAlb0 <suews:SnowAlb0>

snowalbmax

Description

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

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

AlbedoMax <suews: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 <suews:AlbedoMin>

snowdens

Description

Initial snow density of each land cover.

Dimensionality

(7,)

Dimensionality Remarks

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

SUEWS-related variables

:option:SnowDensBldgs <suews:SnowDensBldgs>, SnowDensPaved <suews:SnowDensPaved>, SnowDensDecTr <suews:SnowDensDecTr>, SnowDensEveTr <suews:SnowDensEveTr>, SnowDensGrass <suews:SnowDensGrass>, SnowDensBSoil <suews:SnowDensBSoil>, SnowDensWater <suews:SnowDensWater>

snowdensmax

Description

Maximum snow density [kg ]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

SnowDensMax <suews:SnowDensMax>

snowdensmin

Description

Fresh snow density [kg ]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

SnowDensMin <suews:SnowDensMin>

snowfrac

Description

Initial plan area fraction of snow on each land cover`

Dimensionality

(7,)

Dimensionality Remarks

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

SUEWS-related variables

:option:SnowFracBldgs <suews:SnowFracBldgs>, SnowFracPaved <suews:SnowFracPaved>, SnowFracDecTr <suews:SnowFracDecTr>, SnowFracEveTr <suews:SnowFracEveTr>, SnowFracGrass <suews:SnowFracGrass>, SnowFracBSoil <suews:SnowFracBSoil>, SnowFracWater <suews: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 <suews: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 <suews:SnowLimRemove>

snowpack

Description

Initial snow water equivalent on each land cover

Dimensionality

(7,)

Dimensionality Remarks

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

SUEWS-related variables

:option:SnowPackBldgs <suews:SnowPackBldgs>, SnowPackPaved <suews:SnowPackPaved>, SnowPackDecTr <suews:SnowPackDecTr>, SnowPackEveTr <suews:SnowPackEveTr>, SnowPackGrass <suews:SnowPackGrass>, SnowPackBSoil <suews:SnowPackBSoil>, SnowPackWater <suews:SnowPackWater>

snowpacklimit

Description

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

Dimensionality

(7,)

Dimensionality Remarks

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

SUEWS-related variables

SnowLimPatch <suews: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 <suews:SnowClearingProfWD>, SnowClearingProfWE <suews:SnowClearingProfWE>

snowuse

Description

Determines whether the snow part of the model runs.

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

SnowUse <suews:SnowUse>

snowwater

Description

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

Dimensionality

(7,)

Dimensionality Remarks

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

SUEWS-related variables

SnowWaterBldgsState <suews:SnowWaterBldgsState>, SnowWaterPavedState <suews:SnowWaterPavedState>, SnowWaterDecTrState <suews:SnowWaterDecTrState>, SnowWaterEveTrState <suews:SnowWaterEveTrState>, SnowWaterGrassState <suews:SnowWaterGrassState>, SnowWaterBSoilState <suews:SnowWaterBSoilState>, SnowWaterWaterState <suews:SnowWaterWaterState>

soildepth

Description

Depth of soil beneath the surface [mm]

Dimensionality

(7,)

Dimensionality Remarks

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

SUEWS-related variables

SoilDepth <suews:SoilDepth>

soilstore_id

Description

Initial water stored in soil beneath each land cover

Dimensionality

(7,)

Dimensionality Remarks

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

SUEWS-related variables

SoilstoreBldgsState <suews:SoilstoreBldgsState>, SoilstorePavedState <suews:SoilstorePavedState>, SoilstoreDecTrState <suews:SoilstoreDecTrState>, SoilstoreEveTrState <suews:SoilstoreEveTrState>, SoilstoreGrassState <suews:SoilstoreGrassState>, SoilstoreBSoilState <suews:SoilstoreBSoilState>

soilstorecap

Description

Limit value for SoilDepth [mm]

Dimensionality

(7,)

Dimensionality Remarks

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

SUEWS-related variables

SoilStoreCap <suews:SoilStoreCap>

stabilitymethod

Description

Defines which atmospheric stability functions are used.

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

StabilityMethod <suews:StabilityMethod>

startdls

Description

Start of the day light savings [DOY]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

:option:StartDLS <suews:StartDLS>

state_id

Description

Initial wetness condition on each land cover

Dimensionality

(7,)

Dimensionality Remarks

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

SUEWS-related variables

:option:BldgsState <suews:BldgsState>, PavedState <suews:PavedState>, DecTrState <suews:DecTrState>, EveTrState <suews:EveTrState>, GrassState <suews:GrassState>, BSoilState <suews:BSoilState>, WaterState <suews:WaterState>

statelimit

Description

Upper limit to the surface state. [mm]

Dimensionality

(7,)

Dimensionality Remarks

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

SUEWS-related variables

StateLimit <suews:StateLimit>

storageheatmethod

Description

Determines method for calculating storage heat flux ΔQS.

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

StorageHeatMethod <suews:StorageHeatMethod>

storedrainprm

Description

Coefficients used in drainage calculation.

Dimensionality

(6, 7)

Dimensionality Remarks

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

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

SUEWS-related variables

DrainageCoef1 <suews:DrainageCoef1>, DrainageCoef2 <suews:DrainageCoef2>, DrainageEq <suews:DrainageEq>, StorageMax <suews:StorageMax>, StorageMin <suews:StorageMin>

surfacearea

Description

Area of the grid [ha].

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

SurfaceArea <suews:SurfaceArea>

tau_a

Description

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

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

tau_a <suews:tau_a>

tau_f

Description

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

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

tau_f <suews:tau_f>

tau_r

Description

Time constant for snow density ageing [-]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

tau_r <suews:tau_r>

tempmeltfact

Description

Hourly temperature melt factor of snow [mm ]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

TempMeltFactor <suews:TempMeltFactor>

th

Description

Upper air temperature limit [°C]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

TH <suews:TH>

theta_bioco2

Description

The convexity of the curve at light saturation.

Dimensionality

(3,)

Dimensionality Remarks

3: { suews:EveTr, suews:DecTr, suews:Grass}

SUEWS-related variables

theta <suews: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

:option:Timezone <suews:Timezone>

tl

Description

Lower air temperature limit [°C]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

TL <suews:TL>

trafficrate

Description

Traffic rate used for CO2 flux calculation.

Dimensionality

(2,)

Dimensionality Remarks

2: {Weekday, Weekend}

SUEWS-related variables

TrafficRate_WD <suews:TrafficRate_WD>, TrafficRate_WE <suews: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 <suews: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 <suews:TraffProfWD>, TraffProfWE <suews:TraffProfWE>

tstep

Description

Specifies the model time step [s].

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

Tstep <suews: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: { suews:Paved, suews:Bldgs, suews:EveTr, suews:DecTr, suews:Grass, suews:BSoil, suews:Water, one extra land cover type (currently NOT used)}

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

SUEWS-related variables

ToBSoil <suews:ToBSoil>, ToBldgs <suews:ToBldgs>, ToDecTr <suews:ToDecTr>, ToEveTr <suews:ToEveTr>, ToGrass <suews:ToGrass>, ToPaved <suews:ToPaved>, ToRunoff <suews:ToRunoff>, ToSoilStore <suews:ToSoilStore>, ToWater <suews:ToWater>

waterusemethod

Description

Defines how external water use is calculated.

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

WaterUseMethod <suews: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: { suews:Paved, suews:Bldgs, suews:EveTr, suews:DecTr, suews:Grass, suews:BSoil, suews:Water}

SUEWS-related variables

WetThreshold <suews: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 <suews:WaterUseProfAutoWD>, WaterUseProfAutoWE <suews: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 <suews:WaterUseProfManuWD>, WaterUseProfManuWE <suews:WaterUseProfManuWE>

z

Description

Measurement height [m].

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

z <suews:z>

z0m_in

Description

Roughness length for momentum [m]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

z0 <suews:z0>

zdm_in

Description

Zero-plane displacement [m]

Dimensionality

0

Dimensionality Remarks

Scalar

SUEWS-related variables

zd <suews:zd>