Tip

1. Need help? Please let us know in the SUEWS 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 samealbedo_wall samealbedo_roof

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

46 parameters

• WallInternalConvectionCoefficient

• RoofInternalConvectionCoefficient

• InternalMassConvectionCoefficient

• FloorInternalConvectionCoefficient

• WindowInternalConvectionCoefficient

• WallExternalConvectionCoefficient

• RoofExternalConvectionCoefficient

• WindowExternalConvectionCoefficient

• GroundDepth

• ExternalGroundConductivity

• MetabolismThreshold

• LatentSensibleRatio

• HeatingSystemEfficiency

• MaxCoolingPower

• CoolingSystemCOP

• VentilationRate

• InitialOutdoorTemperature

• InitialIndoorTemperature

• DeepSoilTemperature

• WaterTankWallThickness

• MainsWaterTemperature

• WaterTankSurfaceArea

• HotWaterHeatingSetpointTemperature

• HotWaterTankWallEmissivity

• DHWVesselWallThickness

• DHWWaterVolume

• DHWSurfaceArea

• HotWaterFlowRate

• DHWSpecificHeatCapacity

• HotWaterTankSpecificHeatCapacity

• DHWVesselSpecificHeatCapacity

• DHWDensity

• HotWaterTankWallDensity

• DHWVesselDensity

• HotWaterTankBuildingWallViewFactor

• HotWaterTankInternalMassViewFactor

• HotWaterTankWallConductivity

• HotWaterTankInternalWallConvectionCoefficient

• HotWaterTankExternalWallConvectionCoefficient

• DHWVesselWallConductivity

• DHWVesselInternalWallConvectionCoefficient

• DHWVesselExternalWallConvectionCoefficient

• DHWVesselWallEmissivity

• HotWaterHeatingEfficiency

• MinimumVolumeOfDHWinUse

• MaximumVolumeOfDHWinUse

• Ten Minute Profile

  • working_day

  • holiday

• Ten Minute Profile

  • working_day

  • holiday

Archetype Properties

Archetype Properties

58 parameters

• BuildingType

• BuildingName

• BuildingCount

• Occupants

• stebbs_Height

• FootprintArea

• WallExternalArea

• RatioInternalVolume

• WWR

• WallThickness

• WallEffectiveConductivity

• WallDensity

• WallCp

• WallextThickness

• WallextEffectiveConductivity

• WallextDensity

• WallextCp

• WallOuterCapFrac

• WallExternalEmissivity

• WallInternalEmissivity

• WallTransmissivity

• WallAbsorbtivity

• WallReflectivity

• RoofThickness

• RoofEffectiveConductivity

• RoofDensity

• RoofCp

• RoofextThickness

• RoofextEffectiveConductivity

• RoofextDensity

• RoofextCp

• RoofOuterCapFrac

• 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

• Ten Minute Profile

  • working_day

  • holiday

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

Soil Observation Configuration

Soil Observation Configuration

• depth

• smcap

• soil_not_rocks

• bulk_density

Land Cover

Land Cover

• Paved Surfaces

  13 parameters

  • sfr

  • emis

  • ohm_threshsw

  • ohm_threshwd

  • soildepth

  • soilstorecap

  • statelimit

  • wetthresh

  • sathydraulicconduct

  • soildensity

  • snowpacklimit

  • irrfrac

  • alb

• Buildings

  15 parameters

  • sfr

  • emis

  • ohm_threshsw

  • ohm_threshwd

  • soildepth

  • soilstorecap

  • statelimit

  • wetthresh

  • sathydraulicconduct

  • soildensity

  • snowpacklimit

  • irrfrac

  • alb

  • faibldg

  • bldgh

• Evergreen Trees

  27 parameters

  • sfr

  • emis

  • ohm_threshsw

  • ohm_threshwd

  • soildepth

  • soilstorecap

  • statelimit

  • wetthresh

  • sathydraulicconduct

  • soildensity

  • snowpacklimit

  • irrfrac

  • 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

  • soildensity

  • snowpacklimit

  • irrfrac

  • 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

  • soildensity

  • snowpacklimit

  • irrfrac

  • 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

  13 parameters

  • sfr

  • emis

  • ohm_threshsw

  • ohm_threshwd

  • soildepth

  • soilstorecap

  • statelimit

  • wetthresh

  • sathydraulicconduct

  • soildensity

  • snowpacklimit

  • irrfrac

  • alb

• Water Surfaces

  14 parameters

  • sfr

  • emis

  • ohm_threshsw

  • ohm_threshwd

  • soildepth

  • soilstorecap

  • statelimit

  • wetthresh

  • sathydraulicconduct

  • soildensity

  • 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