Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Apply a Dedicated Outdoor Air System (DOAS) template HVAC to Honeybee Rooms.
DOAS systems separate minimum ventilation supply from the satisfaction of heating + cooling demand. Ventilation air tends to be supplied at neutral temperatures (close to room air temperature) and heating / cooling loads are met with additional pieces of zone equipment (eg. Fan Coil Units (FCUs)).
Because DOAS systems only have to cool down and re-heat the minimum ventilation air, they tend to use less energy than all-air systems. They also tend to use less energy to distribute heating + cooling by puping around hot/cold water or refrigerant instead of blowing hot/cold air. However, they do not provide as good of control over humidity and so they may not be appropriate for rooms with high latent loads like auditoriums, kitchens, laundromats, etc.
rooms [Required]
Honeybee Rooms to which the input template HVAC will be assigned. This can also be a Honeybee Model for which all conditioned Rooms will be assigned the HVAC system.
system_type [Required]
Text for the specific type of DOAS system and equipment. The "HB DOAS HVAC Templates" component has a full list of the supported DOAS system templates.
vintage
Text for the vintage of the template system. This will be used to set efficiencies for various pieces of equipment within the system. The "HB Building Vintages" component has a full list of supported HVAC vintages. (Default: ASHRAE_2019).
name
Text to set the name for the HVAC system and to be incorporated into unique HVAC identifier. If the name is not provided, a random name will be assigned.
sensible_hr
A number between 0 and 1 for the effectiveness of sensible heat recovery within the system. Typical values range from 0.5 for simple glycol loops to 0.81 for enthalpy wheels (the latter of which is a fairly common ECM for DOAS systems). (Default: 0).
latent_hr
A number between 0 and 1 for the effectiveness of latent heat recovery within the system. Typical values are 0 for all types of heat recovery except enthalpy wheels, which can have values as high as 0.76. (Default: 0).
dcv
Boolean to note whether demand controlled ventilation should be used on the system, which will vary the amount of ventilation air according to the occupancy schedule of the zone. (Default: False).
doas_avail_sch
An optional On/Off discrete schedule to set when the dedicated outdoor air system (DOAS) shuts off. This will not only prevent any outdoor air from flowing thorough the system but will also shut off the fans, which can result in more energy savings when spaces served by the DOAS are completely unoccupied. If None, the DOAS will be always on. (Default: None).
report
Reports, errors, warnings, etc.
rooms
The input Rooms with a DOAS HVAC system applied.
Provides a list of available All-Air HVAC templates.
Apply a customized IdealAirSystem to Honeybee Rooms.
rooms [Required]
Honeybee Rooms to which the input ideal air properties will be assigned. This can also be a Honeybee Model for which all conditioned Rooms will be assigned the ideal air system.
economizer
Text to indicate the type of air-side economizer used on the ideal air system. Economizers will mix in a greater amount of outdoor air to cool the zone (rather than running the cooling system) when the zone needs cooling and the outdoor air is cooler than the zone. Choose from the options below. (Default: DifferentialDryBulb).
dcv
Boolean to note whether demand controlled ventilation should be used on the system, which will vary the amount of ventilation air according to the occupancy schedule of the zone. (Default: False).
sensible_hr
A number between 0 and 1 for the effectiveness of sensible heat recovery within the system. (Default: 0).
latent_hr
A number between 0 and 1 for the effectiveness of latent heat recovery within the system. (Default: 0).
heat_temp
A number for the maximum heating supply air temperature [C]. (Default: 50; suitable for most air-based HVAC systems).
cool_temp
A number for the minimum cooling supply air temperature [C]. (Default: 13; sutiable for most air-based HVAC systems).
heat_limit
A number for the maximum heating capacity in Watts. This can also be the text 'autosize' to indicate that the capacity should be determined during the EnergyPlus sizing calculation. This can also be the text 'NoLimit' to indicate no upper limit to the heating capacity. (Default: 'autosize').
cool_limit
A number for the maximum cooling capacity in Watts. This can also be the text 'autosize' to indicate that the capacity should be determined during the EnergyPlus sizing calculation. This can also be the text 'NoLimit' to indicate no upper limit to the cooling capacity. (Default: 'autosize').
heat_avail
An optional on/off schedule to set the availability of heating over the course of the simulation. This can also be the identifier of an on/off schedule to be looked up in the schedule library (Default: None).
cool_avail
An optional on/off schedule to set the availability of cooling over the course of the simulation. This can also be the identifier of an on/off schedule to be looked up in the schedule library (Default: None).
report
The execution information, as output and error streams
rooms
The input Rooms with their Ideal Air Systems edited.
Set Honeybee Rooms to be conditioned or unconditioned with a heating/cooling system.
If _conditioned is True and the connected rooms are not currently conditioned, an Ideal Air System will be assigned to them. Otherwise, if they are already conditioned, the existing HVAC system will be left as it is.
rooms [Required]
Honeybee Rooms to have their conditioned property set.
conditioned [Required]
Boolean to indicate whether the rooms are conditioned with a heating/cooling system.
rooms
Rooms that have had their interinal loads removed to reflect a plenum space.
Apply an All-Air template HVAC to a list of Honeybee Rooms.
All-air systems provide both ventilation and satisfaction of heating + cooling demand with the same stream of warm/cool air. As such, they often grant tight control over zone humidity. However, because such systems often involve the cooling of air only to reheat it again, they are often more energy intensive than systems that separate ventilation from the meeting of thermal loads.
rooms [Required]
Honeybee Rooms to which the input template HVAC will be assigned. This can also be a Honeybee Model for which all conditioned Rooms will be assigned the HVAC system.
system_type [Required]
Text for the specific type of all-air system and equipment. The "HB All-Air HVAC Templates" component has a full list of the supported all-air system templates.
vintage
Text for the vintage of the template system. This will be used to set efficiencies for various pieces of equipment within the system. The "HB Building Vintages" component has a full list of supported HVAC vintages. (Default: ASHRAE_2019).
name
Text to set the name for the HVAC system and to be incorporated into unique HVAC identifier. If the name is not provided, a random name will be assigned.
economizer
Text to indicate the type of air-side economizer used on the HVAC system. Economizers will mix in a greater amount of outdoor air to cool the zone (rather than running the cooling system) when the zone needs cooling and the outdoor air is cooler than the zone. Choose from the options below. (Default: NoEconomizer).
sensible_hr
A number between 0 and 1 for the effectiveness of sensible heat recovery within the system. Typical values range from 0.5 for simple glycol loops to 0.81 for enthalpy wheels (the latter tends to be fiarly expensive for air-based systems). (Default: 0).
latent_hr
A number between 0 and 1 for the effectiveness of latent heat recovery within the system. Typical values are 0 for all types of heat recovery except enthalpy wheels, which can have values as high as 0.76. (Default: 0).
dcv
Boolean to note whether demand controlled ventilation should be used on the system, which will vary the amount of ventilation air according to the occupancy schedule of the zone. (Default: False).
report
Reports, errors, warnings, etc.
rooms
The input Rooms with an all-air HVAC system applied.
-
Provides a list of available Dedicated Outdoor Air System (DOAS) HVAC templates.
-
Provides a list of available Dedicated Outdoor Air System (DOAS) HVAC templates.
-
Provides a list of available template systems providing heating + cooling (without ventilation).
-
Apply a template Service Hot Water (SHW) system to Honeybee Rooms.
Note that the rooms must have hot water loads assigned to them in order for them to be connected to the system.
rooms [Required]
Honeybee Rooms to which the input template system will be assigned. This can also be a Honeybee Model for which all Rooms will be assigned the SHW system.
system_type [Required]
Text for the specific type of service hot water system and equipment. The "HB SHW Templates" component has a full list of the supported system templates.
name
Text to set the name for the Service Hot Water system and to be incorporated into unique system identifier. If the name is not provided, a random name will be assigned.
efficiency
A number for the efficiency of the heater within the system. For Gas systems, this is the efficiency of the burner. For HeatPump systems, this is the rated COP of the system. For electric systems, this should usually be set to 1. If unspecified this value will automatically be set based on the equipment_type. See below for the default value for each equipment type:
condition
A number for the ambient temperature in which the hot water tank is located [C]. This can also be a Room in which the tank is located. (Default: 22).
loss_coeff
A number for the loss of heat from the water heater tank to the surrounding ambient conditions [W/K]. (Default: 6 W/K).
report
Reports, errors, warnings, etc.
rooms
The input Rooms with a Service Hot Water system applied.
-
Set the properites of a Model's electric load center, which governs how on-site electricity generation is converted and distributed.
model [Required]
A Honeybee Model for which the electric load center properties will be set. This Model should include on-site power generation objects, like Shades with PV properties assigned, in order for the inputs here to have an effect on the simulation.
inverter_eff
A number between 0 and 1 for the load centers's inverter nominal rated DC-to-AC conversion efficiency. An inverter converts DC power, such as that output by photovoltaic panels, to AC power, such as that distributed by the electrical grid and is available from standard electrical outlets. Inverter efficiency is defined as the inverter's rated AC power output divided by its rated DC power output. (Default: 0.96).
dc_to_ac_size
A positive number (typically greater than 1) for the ratio of the inverter's DC rated size to its AC rated size. Typically, inverters are not sized to convert the full DC output under standard test conditions (STC) as such conditions rarely occur in reality and therefore unnecessarily add to the size/cost of the inverter. For a system with a high DC to AC size ratio, during times when the DC power output exceeds the inverter's rated DC input size, the inverter limits the array's power output by increasing the DC operating voltage, which moves the arrays operating point down its current-voltage (I-V) curve. The default value of 1.1 is reasonable for most systems. A typical range is 1.1 to 1.25, although some large-scale systems have ratios of as high as 1.5. The optimal value depends on the system's location, array orientation, and module cost. (Default: 1.1).
model
The input Honeybee Model with the electric load center properties set.
-
Apply a template system that only supplies heating and/or cooling (no ventilation) to Honeybee Rooms.
These systems are only designed to satisfy heating + cooling demand and they cannot meet any minimum ventilation requirements.
As such, these systems tend to be used in residential or storage settings where meeting minimum ventilation requirements may not be required or the density of occupancy is so low that infiltration is enough to meet fresh air demand.
rooms [Required]
Honeybee Rooms to which the input template system will be assigned. This can also be a Honeybee Model for which all conditioned Rooms will be assigned the HVAC system.
system_type [Required]
Text for the specific type of heating/cooling system and equipment. The "HB HeatCool HVAC Templates" component has a full list of the supported Heating/Cooling system templates.
vintage
Text for the vintage of the template system. This will be used to set efficiencies for various pieces of equipment within the system. The "HB Building Vintages" component has a full list of supported HVAC vintages. (Default: ASHRAE_2019).
name
Text to set the name for the heating/cooling system and to be incorporated into unique system identifier. If the name is not provided, a random name will be assigned.
report
Reports, errors, warnings, etc.
rooms
The input Rooms with a heating/cooling system applied.
Apply a detailed Ironbug HVAC to Honeybee Rooms or a Honeybee Model.
hb_objs [Required]
Honeybee Rooms to which the input Ironbug HVAC will be assigned. This can also be a Honeybee Model for which the relevant Rooms referenced in the _hvac_system will be assigned the HVAC system.
hvac_system [Required]
A fully-detailed Irongbug HVAC system to be assigned to the input rooms (or model).
name
Text to set the name for the HVAC system and to be incorporated into unique HVAC identifier. If the name is not provided, a random name will be assigned.
report
Reports, errors, warnings, etc.
hb_objs
The input Rooms or Model with the detailed HVAC system applied.
Assign photovoltaic properties to a honeybee Shade such that it will generate electricity in energy simulations.
shades [Required]
Honeybee Shades to which photovoltaic properties will be assigned.
rated_efficiency
A number between 0 and 1 for the rated nameplate efficiency of the photovoltaic solar cells under standard test conditions (STC). Standard test conditions are 1,000 Watts per square meter solar irradiance, 25 degrees C cell temperature, and ASTM G173-03 standard spectrum. Nameplate efficiencies reported by manufacturers are typically under STC. Standard poly- or mono-crystalline silicon modules tend to have rated efficiencies in the range of 14-17%. Premium high efficiency mono-crystalline silicon modules with anti-reflective coatings can have efficiencies in the range of 18-20%. Thin film photovoltaic modules typically have efficiencies of 11% or less. (Default: 0.15 for standard silicon solar cells).
active_fraction
The fraction of the parent Shade geometry that is covered in active solar cells. This fraction includes the difference between the PV panel (aka. PV module) area and the active cells within the panel as well as any losses for how the (typically rectangular) panels can be arranged on the Shade geometry. When the parent Shade geometry represents just the solar panels, this fraction is typically around 0.9 given that the framing elements of the panel reduce the overall active area. (Default: 0.9).
module_type
Text or an integer to indicate the type of solar module. This is used to determine the temperature coefficients used in the simulation of the photovoltaic modules. Choose from the three options below. If unspecified, the module_type will be inferred from the rated_efficiency of these PVProperties using the rated efficiencies listed below.
mounting_type
Text or an integer to indicate the type of mounting and/or tracking used for the photovoltaic array. Note that the OneAxis options have an axis of rotation that is determined by the azimuth of the parent Shade geometry. Also note that, in the case of one or two axis tracking, shadows on the (static) parent Shade geometry still reduce the electrical output, enabling the simulation to account for large context geometry casting shadows on the array. However, the effects of smaller detailed shading may be improperly accounted for and self shading of the dynamic panel geometry is only accounted for via the tracking_gcr property. Choose from the following. (Default: FixedOpenRack).
loss_fraction
A number between 0 and 1 for the fraction of the electricity output lost due to factors other than EPW climate conditions, panel efficiency/type, active area, mounting, and inverter conversion from DC to AC. Factors that should be accounted for in this input include soiling, snow, wiring losses, electrical connection losses, manufacturer defects/tolerances/mismatch in cell characteristics, losses from power grid availability, and losses due to age or light-induced degradation. Losses from these factors tend to be between 10-20% but can vary widely depending on the installation, maintenance and the grid to which the panels are connected. The loss_fraction_from_components staticmethod on this class can be used to estimate this value from the various factors that it is intended to account for. (Default: 0.14).
tracking_gcr
A number between 0 and 1 that ONLY APPLIES TO ARRAYS WITH ONE AXIS mounting_type. The ground coverage ratio (GCR) is the ratio of module surface area to the area of the ground beneath the array, which is used to account for self shading of single-axis panels as they move to track the sun. A GCR of 0.5 means that, when the modules are horizontal, half of the surface below the array is occupied by the array. An array with wider spacing between rows of modules has a lower GCR than one with narrower spacing. A GCR of 1 would be for an array with no space between modules, and a GCR of 0 for infinite spacing between rows. Typical values range from 0.3 to 0.6. (Default: 0.4).
name
An optional text name for the photovoltaic properties. This can be useful for keeping track of different photovoltaics when using several of these components. If unspecified, a unique one will be generated.
report
Reports, errors, warnings, etc.
shades
The input Shades with photovoltaic properties assigned.
Adjust the properties of a Radiant HVAC that has been assigned to Honeybee Rooms.
Because Radiant HVAC systems interact with the conditioned rooms through the thermal mass of the constructions in which they are embedded, their design often requires
rooms [Required]
Honeybee Rooms that have a Radiant HVAC assigned to them, which are to have their radiant properties adjusted. This can also be a Honeybee Model for which all Rooms with a Radiant HVAC sill be adjusted.
radiant_type
Text to indicate which faces are thermally active by default. Note that systems are assumed to be embedded in concrete slabs with no insulation within the slab unless otherwise specified. Choose from the following. (Default: Floor).
min_op_time
A number for the minimum number of hours of operation for the radiant system before it shuts off. (Default: 1).
switch_time
A number for the minimum number of hours for when the system can switch between heating and cooling. (Default: 24).
report
The execution information, as output and error streams
rooms
The input Rooms with the radiant HVAC properties edited.
