STEBBS Physics Methods

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.46. STEBBS Physics Methods#

STEBBS (Surface Temperature Energy Balance Based Scheme) physics switches.

Groups the six STEBBS-scoped method switches that previously sat flat on model.physics (gh#1456). The master on/off toggle is split into enabled (bool) and parameters (StebbsParameterSource); the two compose back to the single legacy stebbsmethod integer column on ModelPhysics.to_df_state and are decomposed on from_df_state. The DataFrame / Fortran column names are unchanged.

Parameters:

enabled#

Master on/off switch for STEBBS. When false, STEBBS calculations are disabled and Parameters is ignored.

Unit:

dimensionless

Default:

False

Method Interactions

Enables the STEBBS branch; capacitance/RC options are only meaningful when STEBBS is enabled.

Provides to: stebbs.capacitance

parameters#

Source of STEBBS parameters when STEBBS is enabled (stebbs.enabled=true).

Options:
1 (DEFAULT) = STEBBS uses default parameters
2 (PROVIDED) = STEBBS uses user-specified parameters
Default:

1 (DEFAULT)

capacitance#

Method to determine the two weighting factors (wall_outer_heat_capacity_fraction and roof_outer_heat_capacity_fraction) splitting heat capacity of building envelope into two nodes in STEBBS.

Options:
0 (DEFAULT) = Default value of 0.5 is used
1 (PROVIDED) = Use user defined value (wall_outer_heat_capacity_fraction and roof_outer_heat_capacity_fraction) between 0 and 1
2 (PARAMETERISE) = Use building material thermal property to parameterise the weighting factor
Default:

0 (DEFAULT)

Method Interactions

Only meaningful when STEBBS is enabled; controls building-envelope heat-capacity splitting.

Depends on: stebbs.enabled

setpoint#

Method to determine the approach of space heating/cooling setpoints in STEBBS.

Options:
0 (Constant) = Use the user-provided heating_setpoint_temperature and cooling_setpoint_temperature throughout the day.
1 (Dependent) = Use the user-provided setpoints
2 (Scheduled) = Use the user-provided heating_setpoint_temperature_profile and cooling_setpoint_temperature_profile.
Default:

0 (CONSTANT)

same_albedo_wall#

Controls assumption of same albedoes for walls.

Unit:

dimensionless

Example:

0 (DISABLED)

same_albedo_roof#

Controls assumption of same albedoes for roofs.

Unit:

dimensionless

Example:

0 (DISABLED)

same_emissivity_wall#

Controls assumption of same emissivities for walls.

Unit:

dimensionless

Example:

0 (DISABLED)

same_emissivity_roof#

Controls assumption of same emissivities for roofs.

Unit:

dimensionless

Example:

0 (DISABLED)

ref#

The ref parameter group is defined by the Reference Info structure.