honeybee_openstudio.ventcool module

OpenStudio ventilative cooling translators.

honeybee_openstudio.ventcool.afn_crack_to_openstudio(afn_crack, os_model, os_reference_crack=None)[source]

Convert Honeybee AFNCrack to OpenStudio AirflowNetworkCrack.

Parameters:

  • opening – The Honeybee VentilationOpening object to be translated to OpenStudio. Note that this object must be assigned to a parent Aperture with a parent Room in order to be successfully translated.

  • os_model – The OpenStudio model to which the AirflowNetworkSurface will be added.

  • os_reference_crack – An optional AirflowNetworkReferenceCrackConditions object to set the reference. If None, a default reference crack will be created. (Default: None).

honeybee_openstudio.ventcool.outdoor_temperature_sensor(os_model)[source]

Create an EnergyManagementSystemSensor for Site Outdoor Air DryBulb Temperature.

honeybee_openstudio.ventcool.ventilation_control_program_manager(os_model)[source]

Create an EMS Program Manager for all window opening.

honeybee_openstudio.ventcool.ventilation_control_to_openstudio_afn(control, open_factors, os_sub_faces, os_zone_air_temp, os_model, room_id='')[source]

Convert Honeybee VentilationControl to OpenStudio EnergyManagementSystemProgram.

Parameters:

  • control – The Honeybee VentilationControl object to be translated to OpenStudio.

  • open_factors – A list of numbers for the opening factor of each Subface to be controlled by the VentilationControl.

  • os_sub_faces – A list of OpenStudio SubSurface objects that have AFN SimpleOpening or HorizontalOpening objects to be controlled by the EMS.

  • os_zone_air_temp – The OpenStudio EnergyManagementSystemSensor object for the Zone Air Temperature that corresponds with the VentilationControl. If this sensor does not yet exist in the model, the zone_temperature_sensor function in this module can be used to create it.

  • os_model – The OpenStudio model to which the EnergyManagementSystemProgram will be added.

  • room_id – An optional Room identifier to be used to ensure the names used in the resulting EnergyManagementSystemProgram are unique to the Room to which the VentilationControl is applied.

honeybee_openstudio.ventcool.ventilation_fan_to_openstudio(fan, os_model)[source]

Convert VentilationFan to OpenStudio ZoneVentilationDesignFlowRate.

honeybee_openstudio.ventcool.ventilation_opening_to_openstudio(opening, os_model)[source]

Convert VentilationOpening to OpenStudio ZoneVentilationWindandStackOpenArea.

Parameters:

  • opening – The Honeybee VentilationOpening object to be translated to OpenStudio. Note that this object must be assigned to a parent Aperture with a parent Room in order to be successfully translated.

  • os_model – The OpenStudio model to which the ZoneVentilationWindandStackOpenArea will be added.

honeybee_openstudio.ventcool.ventilation_opening_to_openstudio_afn(opening, os_model, os_reference_crack=None)[source]

Convert Honeybee VentilationOpening to OpenStudio AirflowNetworkSimpleOpening.

The returned output may also be a AirflowNetworkHorizontalOpening or a AirflowNetworkCrack if the opening is assigned to a parent Aperture or Door that is horizontal and so it cannot be represented with AirflowNetworkSimpleOpening.

Parameters:

  • opening – The Honeybee VentilationOpening object to be translated to OpenStudio. Note that this object must be assigned to a parent Aperture with a parent Room in order to be successfully translated.

  • os_model – The OpenStudio model to which the AirflowNetworkSimpleOpening will be added.

  • os_reference_crack – An optional AirflowNetworkReferenceCrackConditions object to set the reference when the ventilation opening is being translated to a large crack. This happens when the ventilation opening is horizontal and in an outdoor Face. If None, a default reference crack will be created. (Default: None).

Returns:

A tuple with two elements.

  • os_opening – The OpenStudio AFN SimpleOpening, HorizontalOpening or Crack that represents the ventilation opening.

  • opening_factor - A number for the opening factor to be assigned to the parent OpenStudio AirflowNetworkSurface and incorporated into the EMS program.

honeybee_openstudio.ventcool.ventilation_sim_control_to_openstudio(vent_sim_control, os_model)[source]

Convert VentilationSimulationControl to OpenStudio.

This method returns an AirflowNetworkReferenceCrackConditions that can be used for the rest of the AFN setup.

honeybee_openstudio.ventcool.zone_temperature_sensor(os_zone, os_model)[source]

Create an EnergyManagementSystemSensor for Zone Air Temperature.