honeybee_openstudio.hvac.standards.radiant_system_controls module

Module taken from OpenStudio-standards.

https://github.com/NREL/openstudio-standards/blob/master/ lib/openstudio-standards/prototypes/common/objects/Prototype.radiant_system_controls.rb

honeybee_openstudio.hvac.standards.radiant_system_controls.model_add_radiant_basic_controls(model, zone, radiant_loop, radiant_temperature_control_type='SurfaceFaceTemperature', slab_setpoint_oa_control=False, switch_over_time=24.0, slab_sp_at_oat_low=73, slab_oat_low=65, slab_sp_at_oat_high=68, slab_oat_high=80)[source]

Native EnergyPlus objects implement control for a single zone with a radiant system.

Parameters:

  • model – OpenStudio Model.

  • zone – [OpenStudio::Model::ThermalZone>] zone to add radiant controls.

  • radiant_loop – [OpenStudio::Model::ZoneHVACLowTempRadiantVarFlow>] radiant loop in thermal zone.

  • radiant_temperature_control_type –

    [String] determines the controlled temperature for the radiant system. Options include the following.

    • SurfaceFaceTemperature

    • SurfaceInteriorTemperature

  • slab_setpoint_oa_control – [Bool] True if slab setpoint is to be varied based on outdoor air temperature.

  • switch_over_time – [Double] Time limitation for when the system can switch between heating and cooling.

  • slab_sp_at_oat_low – [Double] radiant slab temperature setpoint, in F, at the outdoor high temperature.

  • slab_oat_low – [Double] outdoor drybulb air temperature, in F, for low radiant slab setpoint.

  • slab_sp_at_oat_high – [Double] radiant slab temperature setpoint, in F, at the outdoor low temperature.

  • slab_oat_high – [Double] outdoor drybulb air temperature, in F, for high radiant slab setpoint.

honeybee_openstudio.hvac.standards.radiant_system_controls.model_add_radiant_proportional_controls(model, zone, radiant_loop, radiant_temperature_control_type='SurfaceFaceTemperature', use_zone_occupancy_for_control=True, occupied_percentage_threshold=0.1, model_occ_hr_start=6.0, model_occ_hr_end=18.0, proportional_gain=0.3, switch_over_time=24.0)[source]

Implement a proportional control for a single thermal zone with a radiant system.

Parameters:

  • model – Openstudio Model.

  • zone – [OpenStudio::Model::ThermalZone>] zone to add radiant controls.

  • radiant_loop – [OpenStudio::Model::ZoneHVACLowTempRadiantVarFlow>] radiant loop in thermal zone.

  • radiant_temperature_control_type –

    [String] determines the controlled temperature for the radiant system. Options include the following:

    • SurfaceFaceTemperature

    • SurfaceInteriorTemperature

  • use_zone_occupancy_for_control – [Boolean] Set to true if radiant system is to use specific zone occupancy objects for CBE control strategy. If false, then it will use values in model_occ_hr_start and model_occ_hr_end for all radiant zones. default to true.

  • occupied_percentage_threshold – [Double] the minimum fraction (0 to 1) that counts as occupied. If this parameter is set, the returned ScheduleRuleset will be 0 = unoccupied, 1 = occupied. Otherwise the ScheduleRuleset will be the weighted fractional occupancy schedule.

  • model_occ_hr_start – [Double] Starting decimal hour of whole building occupancy.

  • model_occ_hr_end – [Double] Ending decimal hour of whole building occupancy.

  • proportional_gain – [Double] Proportional gain constant (recommended 0.3 or less).

  • switch_over_time – [Double] Time limitation for when the system can switch between heating and cooling.