Tip

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

2. Please report issues with the manual on GitHub Issues (or use Report Issue for This Page for page-specific feedback).

3. Please cite SUEWS with proper information from our Zenodo page.

4.3. YAML Configuration Reference

This documentation follows the hierarchical structure of SUEWS YAML configuration files.

Note

Navigate through configuration sections using the tabs below. Click on dropdowns to expand and see detailed parameters.

Parameters

• name

• schema_version

• description

Model Configuration

Model Configuration

Model Control

Model Control

Parameters

• tstep

• forcing_file

• start_time

• end_time

Output Configuration

Output Configuration

• format

• freq

• groups

• path

Physics Methods

Physics Methods

Parameters:

netradiationmethod emissionsmethod storageheatmethod ohmincqf roughlenmommethod roughlenheatmethod

stabilitymethod smdmethod waterusemethod rslmethod faimethod

rsllevel gsmodel snowuse stebbsmethod rcmethod

Site Configuration

Site Configuration

Parameters

• name

• gridiv

Site Properties

Site Properties

Parameters

lat lng alt timezone surfacearea z z0m_in

zdm_in pipecapacity runofftowater narp_trans_site n_buildings h_std lambda_c

LUMPS Parameters

LUMPS Parameters

• raincover

• rainmaxres

• drainrt

• veg_type

SPARTACUS

SPARTACUS

14 parameters

• air_ext_lw

• air_ext_sw

• air_ssa_lw

• air_ssa_sw

• ground_albedo_dir_mult_fact

• n_stream_lw_urban

• n_stream_sw_urban

• n_vegetation_region_urban

• sw_dn_direct_frac

• use_sw_direct_albedo

• veg_contact_fraction_const

• veg_fsd_const

• veg_ssa_lw

• veg_ssa_sw

STEBBS

STEBBS

70 parameters

• WallInternalConvectionCoefficient

• RoofInternalConvectionCoefficient

• InternalMassConvectionCoefficient

• FloorInternalConvectionCoefficient

• WindowInternalConvectionCoefficient

• WallExternalConvectionCoefficient

• RoofExternalConvectionCoefficient

• WindowExternalConvectionCoefficient

• GroundDepth

• ExternalGroundConductivity

• IndoorAirDensity

• IndoorAirCp

• WallBuildingViewFactor

• WallGroundViewFactor

• WallSkyViewFactor

• MetabolicRate

• LatentSensibleRatio

• ApplianceRating

• TotalNumberofAppliances

• ApplianceUsageFactor

• HeatingSystemEfficiency

• MaxCoolingPower

• CoolingSystemCOP

• VentilationRate

• OutdoorAirAnnualTemperature

• OutdoorAirStartTemperature

• IndoorAirStartTemperature

• IndoorMassStartTemperature

• WallIndoorSurfaceTemperature

• WallOutdoorSurfaceTemperature

• RoofIndoorSurfaceTemperature

• RoofOutdoorSurfaceTemperature

• WindowIndoorSurfaceTemperature

• WindowOutdoorSurfaceTemperature

• GroundFloorIndoorSurfaceTemperature

• GroundFloorOutdoorSurfaceTemperature

• WaterTankTemperature

• InternalWallWaterTankTemperature

• ExternalWallWaterTankTemperature

• WaterTankWallThickness

• MainsWaterTemperature

• WaterTankSurfaceArea

• HotWaterHeatingSetpointTemperature

• HotWaterTankWallEmissivity

• DomesticHotWaterTemperatureInUseInBuilding

• InternalWallDHWVesselTemperature

• ExternalWallDHWVesselTemperature

• DHWVesselWallThickness

• DHWWaterVolume

• DHWSurfaceArea

• DHWVesselEmissivity

• HotWaterFlowRate

• DHWDrainFlowRate

• DHWSpecificHeatCapacity

• HotWaterTankSpecificHeatCapacity

• DHWVesselSpecificHeatCapacity

• DHWDensity

• HotWaterTankWallDensity

• DHWVesselDensity

• HotWaterTankBuildingWallViewFactor

• HotWaterTankInternalMassViewFactor

• HotWaterTankWallConductivity

• HotWaterTankInternalWallConvectionCoefficient

• HotWaterTankExternalWallConvectionCoefficient

• DHWVesselWallConductivity

• DHWVesselInternalWallConvectionCoefficient

• DHWVesselExternalWallConvectionCoefficient

• DHWVesselWallEmissivity

• HotWaterHeatingEfficiency

• MinimumVolumeOfDHWinUse

Archetype Properties

Archetype Properties

58 parameters

• BuildingType

• BuildingName

• BuildingCount

• Occupants

• stebbs_Height

• FootprintArea

• WallExternalArea

• RatioInternalVolume

• WWR

• WallThickness

• WallEffectiveConductivity

• WallDensity

• WallCp

• WallextThickness

• WallextEffectiveConductivity

• WallextDensity

• WallextCp

• Wallx1

• WallExternalEmissivity

• WallInternalEmissivity

• WallTransmissivity

• WallAbsorbtivity

• WallReflectivity

• RoofThickness

• RoofEffectiveConductivity

• RoofDensity

• RoofCp

• RoofextThickness

• RoofextEffectiveConductivity

• RoofextDensity

• RoofextCp

• Roofx1

• RoofExternalEmissivity

• RoofInternalEmissivity

• RoofTransmissivity

• RoofAbsorbtivity

• RoofReflectivity

• FloorThickness

• GroundFloorEffectiveConductivity

• GroundFloorDensity

• GroundFloorCp

• WindowThickness

• WindowEffectiveConductivity

• WindowDensity

• WindowCp

• WindowExternalEmissivity

• WindowInternalEmissivity

• WindowTransmissivity

• WindowAbsorbtivity

• WindowReflectivity

• InternalMassDensity

• InternalMassCp

• InternalMassEmissivity

• MaxHeatingPower

• WaterTankWaterVolume

• MaximumHotWaterHeatingPower

• HeatingSetpointTemperature

• CoolingSetpointTemperature

Conductance

Conductance

11 parameters

• g_max

• g_k

• g_q_base

• g_q_shape

• g_t

• g_sm

• kmax

• s1

• s2

• tl

• th

Irrigation

Irrigation

9 parameters

• h_maintain

• faut

• ie_start

• ie_end

• internalwateruse_h

• daywatper

• daywat

• wuprofa_24hr

• wuprofm_24hr

Anthropogenic Emissions

Anthropogenic Emissions

• startdls

• enddls

• Anthropogenic Heat

  13 parameters

  • qf0_beu

  • qf_a

  • qf_b

  • qf_c

  • baset_cooling

  • baset_heating

  • ah_min

  • ah_slope_cooling

  • ah_slope_heating

  • ahprof_24hr

  • popdensdaytime

  • popdensnighttime

  • popprof_24hr

• CO2 Emissions

  14 parameters

  • co2pointsource

  • ef_umolco2perj

  • enef_v_jkm

  • fcef_v_kgkm

  • frfossilfuel_heat

  • frfossilfuel_nonheat

  • maxfcmetab

  • maxqfmetab

  • minfcmetab

  • minqfmetab

  • trafficrate

  • trafficunits

  • traffprof_24hr

  • humactivity_24hr

Snow

Snow

17 parameters

• crwmax

• crwmin

• narp_emis_snow

• preciplimit

• preciplimitalb

• snowalbmax

• snowalbmin

• snowdensmin

• snowdensmax

• snowlimbldg

• snowlimpaved

• snowprof_24hr

• tau_a

• tau_f

• tau_r

• tempmeltfact

• radmeltfact

Land Cover

Land Cover

• Paved Surfaces

  12 parameters

  • sfr

  • emis

  • ohm_threshsw

  • ohm_threshwd

  • soildepth

  • soilstorecap

  • statelimit

  • wetthresh

  • sathydraulicconduct

  • snowpacklimit

  • irrfrac

  • alb

• Buildings

  14 parameters

  • sfr

  • emis

  • ohm_threshsw

  • ohm_threshwd

  • soildepth

  • soilstorecap

  • statelimit

  • wetthresh

  • sathydraulicconduct

  • snowpacklimit

  • irrfrac

  • alb

  • faibldg

  • bldgh

• Evergreen Trees

  27 parameters

  • sfr

  • emis

  • ohm_threshsw

  • ohm_threshwd

  • soildepth

  • soilstorecap

  • statelimit

  • wetthresh

  • sathydraulicconduct

  • snowpacklimit

  • irrfrac

  • alb

  • alb_min

  • alb_max

  • beta_bioco2

  • beta_enh_bioco2

  • alpha_bioco2

  • alpha_enh_bioco2

  • resp_a

  • resp_b

  • theta_bioco2

  • maxconductance

  • min_res_bioco2

  • ie_a

  • ie_m

  • faievetree

  • evetreeh

• Deciduous Trees

  31 parameters

  • sfr

  • emis

  • ohm_threshsw

  • ohm_threshwd

  • soildepth

  • soilstorecap

  • statelimit

  • wetthresh

  • sathydraulicconduct

  • snowpacklimit

  • irrfrac

  • alb

  • alb_min

  • alb_max

  • beta_bioco2

  • beta_enh_bioco2

  • alpha_bioco2

  • alpha_enh_bioco2

  • resp_a

  • resp_b

  • theta_bioco2

  • maxconductance

  • min_res_bioco2

  • ie_a

  • ie_m

  • faidectree

  • dectreeh

  • pormin_dec

  • pormax_dec

  • capmax_dec

  • capmin_dec

• Grass

  25 parameters

  • sfr

  • emis

  • ohm_threshsw

  • ohm_threshwd

  • soildepth

  • soilstorecap

  • statelimit

  • wetthresh

  • sathydraulicconduct

  • snowpacklimit

  • irrfrac

  • alb

  • alb_min

  • alb_max

  • beta_bioco2

  • beta_enh_bioco2

  • alpha_bioco2

  • alpha_enh_bioco2

  • resp_a

  • resp_b

  • theta_bioco2

  • maxconductance

  • min_res_bioco2

  • ie_a

  • ie_m

• Bare Soil

  12 parameters

  • sfr

  • emis

  • ohm_threshsw

  • ohm_threshwd

  • soildepth

  • soilstorecap

  • statelimit

  • wetthresh

  • sathydraulicconduct

  • snowpacklimit

  • irrfrac

  • alb

• Water Surfaces

  13 parameters

  • sfr

  • emis

  • ohm_threshsw

  • ohm_threshwd

  • soildepth

  • soilstorecap

  • statelimit

  • wetthresh

  • sathydraulicconduct

  • snowpacklimit

  • irrfrac

  • alb

  • flowchange

Vertical Layers

Vertical Layers

• nlayer

• height

• veg_frac

• veg_scale

• building_frac

• building_scale

• Roof Layer

  • alb

  • emis

  • statelimit

  • soilstorecap

  • wetthresh

  • roof_albedo_dir_mult_fact

  • wall_specular_frac

• Wall Layer

  • alb

  • emis

  • statelimit

  • soilstorecap

  • wetthresh

  • roof_albedo_dir_mult_fact

  • wall_specular_frac

Initial States

Initial States

Parameters

• snowalb

Paved Surface Initial State

Paved Surface Initial State

10 parameters

• state

• soilstore

• snowfrac

• snowpack

• icefrac

• snowwater

• snowdens

• temperature

• tsfc

• tin

Buildings Surface Initial State

Buildings Surface Initial State

10 parameters

• state

• soilstore

• snowfrac

• snowpack

• icefrac

• snowwater

• snowdens

• temperature

• tsfc

• tin

Evergreen Tree Initial State

Evergreen Tree Initial State

15 parameters

• state

• soilstore

• snowfrac

• snowpack

• icefrac

• snowwater

• snowdens

• temperature

• tsfc

• tin

• alb_id

• lai_id

• gdd_id

• sdd_id

• wu

Deciduous Tree Initial State

Deciduous Tree Initial State

17 parameters

• state

• soilstore

• snowfrac

• snowpack

• icefrac

• snowwater

• snowdens

• temperature

• tsfc

• tin

• alb_id

• lai_id

• gdd_id

• sdd_id

• wu

• porosity_id

• decidcap_id

Grass Initial State

Grass Initial State

15 parameters

• state

• soilstore

• snowfrac

• snowpack

• icefrac

• snowwater

• snowdens

• temperature

• tsfc

• tin

• alb_id

• lai_id

• gdd_id

• sdd_id

• wu

Bare Soil Surface Initial State

Bare Soil Surface Initial State

10 parameters

• state

• soilstore

• snowfrac

• snowpack

• icefrac

• snowwater

• snowdens

• temperature

• tsfc

• tin

Water Surface Initial State

Water Surface Initial State

10 parameters

• state

• soilstore

• snowfrac

• snowpack

• icefrac

• snowwater

• snowdens

• temperature

• tsfc

• tin

Roofs Initial State

Roofs Initial State

10 parameters

• state

• soilstore

• snowfrac

• snowpack

• icefrac

• snowwater

• snowdens

• temperature

• tsfc

• tin

Walls Initial State

Walls Initial State

10 parameters

• state

• soilstore

• snowfrac

• snowpack

• icefrac

• snowwater

• snowdens

• temperature

• tsfc

• tin