ventilation
Honeybee-PH-HVAC-Equipment: Ventilation (ERV) Devices.
Source: honeybee_phhvac/ventilation.py
UnknownPhExhaustVentTypeError
Raised when an unrecognized exhaust ventilation device type is encountered.
Inherits from: Exception
Attributes
| Attribute | Type | Description |
|---|---|---|
msg | format | — |
Ventilator
A Passive House ventilation heat-recovery unit (ERV/HRV).
Inherits from: _base._PhHVACBase
Attributes
| Attribute | Type | Description |
|---|---|---|
display_name | str | User-facing name for the ventilator. |
id_num | int | Numeric identifier for the ventilator. |
quantity | int | Number of identical units. |
sensible_heat_recovery | float | Sensible heat recovery efficiency (0-1). |
latent_heat_recovery | float | Latent heat recovery efficiency (0-1). |
electric_efficiency | float | Specific electric power in Wh/m3. |
frost_protection_reqd | bool | Whether frost protection is required. |
temperature_below_defrost_used | float | Temperature threshold for defrost activation (C). |
in_conditioned_space | bool | Whether the unit is located in conditioned space. |
PhVentilationSystem
Passive House Fresh-Air Ventilation System.
Inherits from: _base._PhHVACBase
Attributes
| Attribute | Type | Description |
|---|---|---|
display_name | str | User-facing name for the ventilation system. |
sys_type | int | System type identifier (1 = Balanced PH ventilation with HR). |
supply_ducting | List[ducting.PhDuctElement] | Supply-air duct elements. |
exhaust_ducting | List[ducting.PhDuctElement] | Exhaust-air duct elements. |
id_num | int | Numeric identifier for the system. |
Properties
| Property | Type | Description |
|---|---|---|
ventilation_unit | Optional[Ventilator] | Return the Ventilator (ERV/HRV) assigned to this system. |
supply_ducting_total_length | float | Return the total length of all supply-air ducting in model-units. |
exhaust_ducting_total_length | float | Return the total length of all exhaust-air ducting in model-units. |
supply_ducting_size_description | Optional[str] | Return the size of the supply-air ducting. |
exhaust_ducting_size_description | Optional[str] | Return the size of the exhaust-air ducting. |
Methods
add_supply_duct_element(_duct_element)
Add a supply-air duct element to the ventilation system.
| Arg | Type | Description |
|---|---|---|
_duct_element | ducting.PhDuctElement | The duct element to add. |
Returns: None
add_exhaust_duct_element(_duct_element)
Add an exhaust-air duct element to the ventilation system.
| Arg | Type | Description |
|---|---|---|
_duct_element | ducting.PhDuctElement | The duct element to add. |
Returns: None
move(moving_vec3D)
Move the System’s ducts along a vector.
| Arg | Type | Description |
|---|---|---|
moving_vec3D | — | A Vector3D with the direction and distance to move the ray. |
rotate(axis_vec3D, angle_degrees, origin_pt3D)
Rotate the System’s ducts by a certain angle around an axis and origin.
| Arg | Type | Description |
|---|---|---|
axis_vec3D | — | A Vector3D axis representing the axis of rotation. |
angle_degrees | — | An angle for rotation in degrees. |
origin_pt3D | — | A Point3D for the origin around which the object will be rotated. |
rotate_xy(angle_degrees, origin_pt3D)
Rotate the System’s ducts counterclockwise in the XY plane by a certain angle.
| Arg | Type | Description |
|---|---|---|
angle_degrees | — | An angle in degrees. |
origin_pt3D | — | A Point3D for the origin around which the object will be rotated. |
reflect(normal_vec3D, origin_pt3D)
Reflect the System’s ducts across a plane with the input normal vector and origin.
| Arg | Type | Description |
|---|---|---|
normal_vec3D | — | A normalized Vector3D representing the plane normal. |
origin_pt3D | — | A Point3D representing the origin from which to reflect. |
scale(scale_factor, origin_pt3D)
Scale the System’s ducts by a factor from an origin point.
| Arg | Type | Description |
|---|---|---|
scale_factor | float | A number representing how much the ducts should be scaled. |
origin_pt3D | Optional[Point3D] | A Point3D representing the origin from which to scale. If None, it will be scaled from the World origin (0, 0, 0). |
Returns: PhVentilationSystem
ExhaustVentDryer
Exhaust ventilation device representing a clothes dryer.
Inherits from: _ExhaustVentilatorBase
Attributes
| Attribute | Type | Description |
|---|---|---|
display_name | str | — |
ExhaustVentKitchenHood
Exhaust ventilation device representing a kitchen range hood.
Inherits from: _ExhaustVentilatorBase
Attributes
| Attribute | Type | Description |
|---|---|---|
display_name | str | — |
ExhaustVentUserDefined
Exhaust ventilation device with user-defined parameters.
Inherits from: _ExhaustVentilatorBase
Attributes
| Attribute | Type | Description |
|---|---|---|
display_name | str | — |
PhExhaustDeviceBuilder
Constructor class for HBPH-Exhaust Ventilation Devices