honeybee_energy.properties.room module

Room Energy Properties.

class honeybee_energy.properties.room.RoomEnergyProperties(host, program_type=None, construction_set=None, hvac=None, shw=None)[source]

Bases: object

Energy Properties for Honeybee Room.

Parameters
  • host – A honeybee_core Room object that hosts these properties.

  • program_type – A honeybee ProgramType object to specify all default schedules and loads for the Room. If None, the Room will have a Plenum program (with no loads or setpoints). Default: None.

  • construction_set – A honeybee ConstructionSet object to specify all default constructions for the Faces of the Room. If None, the Room will use the honeybee default construction set, which is not representative of a particular building code or climate zone. Default: None.

  • hvac – A honeybee HVAC object (such as an IdealAirSystem) that specifies how the Room is conditioned. If None, it will be assumed that the Room is not conditioned. Default: None.

Properties:
  • host

  • program_type

  • construction_set

  • hvac

  • shw

  • people

  • lighting

  • electric_equipment

  • gas_equipment

  • service_hot_water

  • infiltration

  • ventilation

  • setpoint

  • daylighting_control

  • window_vent_control

  • fans

  • process_loads

  • total_process_load

  • internal_masses

  • is_conditioned

  • has_overridden_loads

ToString()[source]
absolute_electric_equipment(watts, conversion=1)[source]

Set the absolute wattage of electric equipment in the Room.

This overwrites the RoomEnergyProperties’s electric equipment per area but preserves all schedules and other properties. If the Room has no electric equipment definition, a new one with an Always On schedule will be created. Note that, if the host Room has no floors, the electric equipment load will be zero.

Parameters
  • watts – Number for the installed wattage of electric equipment in the room.

  • conversion – Factor to account for the case where host Room geometry is not in meters. This will be multiplied by the floor area so it should be 0.001 for millimeters, 0.305 for feet, etc. (Default: 1).

absolute_gas_equipment(watts, conversion=1)[source]

Set the absolute wattage of gas equipment in the Room.

This overwrites the RoomEnergyProperties’s gas equipment per area but preserves all schedules and other properties. If the Room has no gas equipment definition, a new one with an Always On schedule will be created. Note that, if the host Room has no floors, the gas equipment load will be zero.

Parameters
  • watts – Number for the installed wattage of gas equipment in the room.

  • conversion – Factor to account for the case where host Room geometry is not in meters. This will be multiplied by the floor area so it should be 0.001 for millimeters, 0.305 for feet, etc. (Default: 1).

absolute_infiltration(flow_rate, conversion=1)[source]

Set the absolute flow rate of infiltration for the Room in m3/s.

This overwrites the RoomEnergyProperties’s infiltration flow per exterior area but preserves all schedules and other properties. If the Room has no infiltration definition, a new one with an Always On schedule will be created. Note that, if the host Room has no exterior faces, the infiltration load will be zero.

Parameters
  • flow_rate – Number for the infiltration flow rate in m3/s.

  • conversion – Factor to account for the case where host Room geometry is not in meters. This will be multiplied by the floor area so it should be 0.001 for millimeters, 0.305 for feet, etc. (Default: 1).

absolute_infiltration_ach(air_changes_per_hour, conversion=1)[source]

Set the absolute flow rate of infiltration for the Room in ACH.

This overwrites the RoomEnergyProperties’s infiltration flow per exterior area but preserves all schedules and other properties. If the Room has no infiltration definition, a new one with an Always On schedule will be created. Note that, if the host Room has no exterior faces, the infiltration load will be zero.

Parameters
  • air_changes_per_hour – Number for the infiltration flow rate in ACH.

  • conversion – Factor to account for the case where host Room geometry is not in meters. This will be multiplied by the floor area so it should be 0.001 for millimeters, 0.305 for feet, etc. (Default: 1).

absolute_lighting(watts, conversion=1)[source]

Set the absolute wattage of lighting in the Room.

This overwrites the RoomEnergyProperties’s lighting per area but preserves all schedules and other lighting properties. If the Room has no lighting definition, a new one with an Always On schedule will be created. Note that, if the host Room has no floors, the lighting load will be zero.

Parameters
  • watts – Number for the installed wattage of lighting in the room.

  • conversion – Factor to account for the case where host Room geometry is not in meters. This will be multiplied by the floor area so it should be 0.001 for millimeters, 0.305 for feet, etc. (Default: 1).

absolute_people(person_count, conversion=1)[source]

Set the absolute number of people in the Room.

This overwrites the RoomEnergyProperties’s people per area but preserves all schedules and other people properties. If the Room has no people definition, a new one with an Always On schedule will be created. Note that, if the host Room has no floors, the people load will be zero.

Parameters
  • person_count – Number for the maximum quantity of people in the room.

  • conversion – Factor to account for the case where host Room geometry is not in meters. This will be multiplied by the floor area so it should be 0.001 for millimeters, 0.305 for feet, etc. (Default: 1).

absolute_service_hot_water(flow, conversion=1)[source]

Set the absolute flow rate of service hot water use in the Room.

This overwrites the RoomEnergyProperties’s hot water flow per area but preserves all schedules and other properties. If the Room has no service hot water definition, a new one with an Always On schedule will be created. Note that, if the host Room has no floors, the service hot water flow will be zero.

Parameters
  • flow – Number for the peak flow rate of service hot water in the room.

  • conversion – Factor to account for the case where host Room geometry is not in meters. This will be multiplied by the floor area so it should be 0.001 for millimeters, 0.305 for feet, etc. (Default: 1).

absolute_ventilation(flow_rate)[source]

Set the absolute flow rate of outdoor air ventilation for the Room in m3/s.

This overwrites all values of the RoomEnergyProperties’s ventilation flow but preserves the schedule. If the Room has no ventilation definition, a new one with an Always On schedule will be created.

Parameters

flow_rate – A number for the absolute of flow of outdoor air ventilation for the room in cubic meters per second (m3/s). Note that inputting a value here will overwrite all specification of outdoor air ventilation currently on the room (per_floor, per_person, ach).

add_daylight_control_to_center(distance_from_floor, illuminance_setpoint=300, control_fraction=1, min_power_input=0.3, min_light_output=0.2, off_at_minimum=False, tolerance=0.01)[source]

Try to assign a DaylightingControl object to the center of the Room.

If the Room is too concave and the center point does not lie within the Room volume, the pole of inaccessibility across the floor geometry will be used. If the concave Room has no floors or the pole of inaccessibility does not exist inside the Room, this method wil return None and no daylighting control will be assigned.

Parameters
  • distance_from_floor – A number for the distance that the daylight sensor is from the floor. Typical values are around 0.8 meters.

  • illuminance_setpoint – A number for the illuminance setpoint in lux beyond which electric lights are dimmed if there is sufficient daylight. (Default: 300 lux).

  • control_fraction – A number between 0 and 1 that represents the fraction of the Room lights that are dimmed when the illuminance at the sensor position is at the specified illuminance. 1 indicates that all lights are dim-able while 0 indicates that no lights are dim-able. Deeper rooms should have lower control fractions to account for the face that the lights in the back of the space do not dim in response to suitable daylight at the front of the room. (Default: 1).

  • min_power_input – A number between 0 and 1 for the the lowest power the lighting system can dim down to, expressed as a fraction of maximum input power. (Default: 0.3).

  • min_light_output – A number between 0 and 1 the lowest lighting output the lighting system can dim down to, expressed as a fraction of maximum light output. (Default: 0.2).

  • off_at_minimum – Boolean to note whether lights should switch off completely when they get to the minimum power input. (Default: False).

  • tolerance – The maximum difference between x, y, and z values at which vertices are considered equivalent. (Default: 0.01, suitable for objects in meters).

Returns

A DaylightingControl object if the sensor was successfully assigned to the Room. Will be None if the Room was too short or so concave that a sensor could not be assigned.

add_default_ideal_air()[source]

Add a default IdealAirSystem to this Room.

The identifier of this system will be derived from the room identifier and will align with the naming convention that EnergyPlus uses for templates Ideal Air systems.

add_fan(fan)[source]

Add a VentilationFan to this Room.

Parameters

fan – A VentilationFan to add to this Room.

add_internal_mass(internal_mass)[source]

Add an InternalMass to this Room.

Parameters

internal_mass – An InternalMass to add to this Room.

add_process_load(process_load)[source]

Add a Process load to this Room.

Parameters

process_load – A Process load to add to this Room.

apply_properties_from_dict(abridged_data, construction_sets, program_types, hvacs, shws, schedules, constructions)[source]

Apply properties from a RoomEnergyPropertiesAbridged dictionary.

Parameters
  • abridged_data – A RoomEnergyPropertiesAbridged dictionary (typically coming from a Model).

  • construction_sets – A dictionary of ConstructionSets with identifiers of the sets as keys, which will be used to re-assign construction_sets.

  • program_types – A dictionary of ProgramTypes with identifiers of the types as keys, which will be used to re-assign program_types.

  • hvacs – A dictionary of HVACSystems with the identifiers of the systems as keys, which will be used to re-assign hvac to the Room.

  • shws – A dictionary of SHWSystems with the identifiers of the systems as keys, which will be used to re-assign shw to the Room.

  • schedules – A dictionary of Schedules with identifiers of the schedules as keys, which will be used to re-assign schedules.

  • constructions – A dictionary with construction identifiers as keys and honeybee construction objects as values.

assign_ideal_air_equivalent()[source]

Convert any HVAC assigned to this Room to be an equivalent IdealAirSystem.

Relevant properties will be transferred to the resulting ideal air such as economizer_type, sensible_heat_recovery, latent_heat_recovery, and demand_controlled_ventilation.

For HeatCool systems that cannot supply ventilation, this Room’s ventilation specification will be overridden to zero. For DOAS systems with a doas_availability_schedule, this schedule will be applied with the Room’s ventilation schedule.

assign_ventilation_opening(vent_opening)[source]

Assign a VentilationOpening object to all operable Apertures on this Room.

This method will handle the duplication of the VentilationOpening object to ensure that each aperture gets a unique object that can export the correct area and height properties of its parent.

Parameters

vent_opening – A VentilationOpening object to be duplicated and assigned to all of the operable apertures of the Room.

Returns

A list of Apertures for which ventilation opening properties were set. This can be used to perform additional operations on the apertures, such as changing their construction.

duplicate(new_host=None)[source]

Get a copy of this object.

Parameters

new_host – A new Room object that hosts these properties. If None, the properties will be duplicated with the same host.

envelope_components_by_type()[source]

Get groups for room envelope components by boundary condition and type.

The groups created by this function correspond to the structure of the crack template data used to generate the AirflowNetwork but can be useful for other purposes. However, any parts of the envelope with a boundary condition other than Outdoors and Surface will be excluded (eg. Ground or Adiabatic).

Returns

A tuple with five groups of exterior envelope types

  • ext_walls - A list of exterior Wall type Face objects.

  • ext_roofs - A list of exterior RoofCeiling type Face objects.

  • ext_floors - A list of exterior Floor type Face objects, like you would find in a cantilevered Room.

  • ext_apertures - A list of exterior Aperture Face objects.

  • ext_doors - A list of exterior Door Face objects.

A tuple with four groups of interior faces types

  • int_walls: List of interior Wall type Face objects.

  • int_floorceilings: List of interior RoofCeiling and Floor type Face objects.

  • int_apertures: List of interior Aperture Face objects.

  • int_doors: List of interior Door Face objects.

  • int_air: List of interior Faces with AirBoundary face type.

exterior_afn_from_infiltration_load(exterior_face_groups, air_density=1.2041, delta_pressure=4)[source]

Assign AirflowNetwork parameters using the room’s infiltration rate.

This will assign air leakage parameters to the Room’s exterior Faces that produce a total air flow rate equivalent to the room infiltration rate at an envelope pressure difference of 4 Pa. However, the individual flow air leakage parameters are not meant to be representative of real values, since the infiltration flow rate is an average of the actual, variable surface flow dynamics.

VentilationOpening objects will be added to Aperture and Door objects if not already defined, with the fraction_area_operable set to 0. If VentilationOpening objects are already defined, only the parameters defining leakage when the openings are closed will be overwritten. AFNCrack objects will be added to all external and internal Face objects, and any existing AFNCrack objects will be overwritten.

Parameters
  • exterior_face_groups

    A tuple with five types of the exterior room envelope

    • ext_walls - A list of exterior Wall type Face objects.

    • ext_roofs - A list of exterior RoofCeiling type Face objects.

    • ext_floors - A list of exterior Floor type Face objects, like you would find in a cantilevered Room.

    • ext_apertures - A list of exterior Aperture Face objects.

    • ext_doors - A list of exterior Door Face objects.

  • air_density – Air density in kg/m3. (Default: 1.2041 represents air density at a temperature of 20 C and 101325 Pa).

  • delta_pressure

    Reference air pressure difference across the building envelope orifice in Pascals used to calculate infiltration crack flow coefficients. The resulting average simulated air pressure difference will roughly equal this delta_pressure times the nth root of the ratio between the simulated and target room infiltration rates:

    dP_sim = (Q_sim / Q_target)^(1/n) * dP_ref
    
    where:
        dP: delta_pressure, the reference air pressure difference [Pa]
        dP_sim: Simulated air pressure difference [Pa]
        Q_sim: Simulated volumetric air flow rate per area [m3/s/m2]
        Q_target: Target volumetric air flow rate per area [m3/s/m2]
        n: Air mass flow exponent [-]
    

    If attempting to replicate the room infiltration rate per exterior area, delta_pressure should be set to an approximation of the simulated air pressure difference described in the above formula. Default 4 represents typical building pressures.

floor_area_with_constructions(geometry_units, destination_units='Meters', tolerance=0.01)[source]

Get the floor area of the Room accounting for wall constructions.

Parameters
  • geometry_units – The units in which the Room geometry exists.

  • destination_units – The “squared” units that the output value will be in. (Default: Meters).

  • tolerance – The maximum difference between values at which point vertices are considered to be the same. (Default: 0.01, suitable for objects in meters).

classmethod from_dict(data, host)[source]

Create RoomEnergyProperties from a dictionary.

Note that the dictionary must be a non-abridged version for this classmethod to work.

Parameters
  • data – A dictionary representation of RoomEnergyProperties with the format below.

  • host – A Room object that hosts these properties.

{
"type": 'RoomEnergyProperties',
"construction_set": {},  # A ConstructionSet dictionary
"program_type": {},  # A ProgramType dictionary
"hvac": {}, # A HVACSystem dictionary
"shw": {}, # A SHWSystem dictionary
"people":{},  # A People dictionary
"lighting": {},  # A Lighting dictionary
"electric_equipment": {},  # A ElectricEquipment dictionary
"gas_equipment": {},  # A GasEquipment dictionary
"service_hot_water": {},  # A ServiceHotWater dictionary
"infiltration": {},  # A Infiltration dictionary
"ventilation": {},  # A Ventilation dictionary
"setpoint": {},  # A Setpoint dictionary
"daylighting_control": {},  # A DaylightingControl dictionary
"window_vent_control": {},  # A VentilationControl dictionary
"fans": [],  # An array of VentilationFan dictionaries
"process_loads": [],  # An array of Process dictionaries
"internal_masses": []  # An array of InternalMass dictionaries
}
is_equivalent(other)[source]

Check to see if these energy properties are equivalent to another object.

This will only be True if all properties match (except for the host) and will otherwise be False.

make_ground(soil_construction, include_floor_area=False)[source]

Change the properties of the host Room to reflect those of a ground surface.

This is particularly useful for setting up outdoor thermal comfort maps to account for the surface temperature of the ground. Modeling the ground as a room this way will ensure that shadows other objects cast upon it are accounted for along with the storage of heat in the ground surface.

The turning of a Room into a ground entails:

  • Setting all constructions to be indicative of a certain soil type.

  • Setting all Faces except the roof to have a Ground boundary condition.

  • Removing all loads and schedules assigned to the Room.

Parameters
  • soil_construction – An OpaqueConstruction that reflects the soil type of the ground. If a multi-layered construction is input, the multiple layers will only be used for the roof Face of the Room and all other Faces will get a construction with the inner-most layer assigned. If the outer-most material is an EnergyMaterialVegetation and there are no other layers in the construction, the vegetation’s soil material will be used for all other Faces.

  • include_floor_area – Boolean to indicate whether the floor area of the ground room contributes to the Model that it is a part of. Note that this will not affect the floor_area property of this Room but it will ensure the Room’s floor area is excluded from any calculations when the Room is part of a Model and when it is simulated in EnergyPlus. (Default: False).

make_plenum(conditioned=False, remove_infiltration=False, include_floor_area=False)[source]

Turn the host Room into a plenum with no internal loads.

This includes removing all people, lighting, equipment, hot water, and mechanical ventilation. By default, the heating/cooling system and setpoints will also be removed but they can optionally be kept. Infiltration is kept by default but can optionally be removed as well.

This is useful to appropriately assign properties for closets, underfloor spaces, and drop ceilings.

Parameters
  • conditioned – Boolean to indicate whether the plenum is conditioned with a heating/cooling system. If True, the setpoints of the Room will also be kept in addition to the heating/cooling system (Default: False).

  • remove_infiltration – Boolean to indicate whether infiltration should be removed from the Rooms. (Default: False).

  • include_floor_area – Boolean to indicate whether the floor area of the plenum contributes to the Model that it is a part of. Note that this will not affect the floor_area property of this Room but it will ensure the Room’s floor area is excluded from any calculations when the Room is part of a Model and when it is simulated in EnergyPlus. (Default: False).

move(moving_vec)[source]

Move this object along a vector.

Parameters

moving_vec – A ladybug_geometry Vector3D with the direction and distance to move the object.

reflect(plane)[source]

Reflect this object across a plane.

Parameters

plane – A ladybug_geometry Plane across which the object will be reflected.

remove_child_constructions()[source]

Remove constructions assigned to the Room’s Faces, Apertures, Doors and Shades.

This means that all constructions of the Room will be assigned by the Room’s construction_set (or the Honeybee default ConstructionSet if the Room has no construction set).

remove_fans()[source]

Remove all VentilationFans from the Room.

remove_internal_masses()[source]

Remove all internal masses from the Room.

remove_process_loads()[source]

Remove all Process loads from the Room.

remove_ventilation_opening()[source]

Remove all VentilationOpening objects assigned to the Room’s Apertures.

reset_constructions_to_set()[source]

Reset all constructions on the Room to be assigned from the ConstructionSet.

This will erase any constructions that have been assigned to individual Faces, Apertures, Doors, and Shades.

reset_loads_to_program()[source]

Reset all loads on the Room to be assigned from the ProgramType.

This will erase any loads that have been overridden specifically for this Room.

reset_to_default()[source]

Reset all of the energy properties assigned to this Room to the default.

This includes resetting all loads, the program, all constructions and the constructions set, and all other energy properties.

rotate(angle, axis, origin)[source]

Rotate this object by a certain angle around an axis and origin.

Parameters
  • angle – An angle for rotation in degrees.

  • axis – Rotation axis as a Vector3D.

  • origin – A ladybug_geometry Point3D for the origin around which the object will be rotated.

rotate_xy(angle, origin)[source]

Rotate this object counterclockwise in the world XY plane by a certain angle.

Parameters
  • angle – An angle in degrees.

  • origin – A ladybug_geometry Point3D for the origin around which the object will be rotated.

scale(factor, origin=None)[source]

Scale this object by a factor from an origin point.

Parameters
  • factor – A number representing how much the object should be scaled.

  • origin – A ladybug_geometry Point3D representing the origin from which to scale. If None, it will be scaled from the World origin (0, 0, 0).

static solve_norm_area_flow_coefficient(flow_per_exterior_area, flow_exponent=0.65, air_density=1.2041, delta_pressure=4)[source]

Get normalized mass flow coefficient [kg/(m2 s P^n)] from infiltration per area.

The normalized area air mass flow coefficient is derived from a zone’s infiltration flow rate using the power law relationship between pressure and air flow:

Qva * d = Cqa * dP^n

where:
    Cqa: Air mass flow coefficient per unit meter at 1 Pa [kg/m2/s/P^n]
    Qva: Volumetric air flow rate per area [m3/s/m2]
    d: Air density [kg/m3]
    dP: Change in pressure across building envelope orifice [Pa]
    n: Air mass flow exponent [-]

Rearranged to solve for Cqa

Cqa = (Qva * d) / dP^n

The resulting value has units of kg/(m2-s-P^n) @ <delta_pressure> Pa, while the EnergyPlus AirflowNetwork requires this value to be in kg/(s-Pa) @ 1 Pa. Thus this value needs to be multiplied by its corresponding exposed surface area. Since the actual ratio between mass infiltration and pressure difference (raised by n) is constant, we assume solving for the flow coefficient at the delta_pressure value is equivalent to solving it at the required 1 Pa.

Parameters
  • flow_per_exterior_area – A numerical value for the intensity of infiltration in m3/s per square meter of exterior surface area.

  • air_density – Air density in kg/m3. (Default: 1.2041 represents air density at a temperature of 20 C and 101325 Pa).

  • flow_exponent – A numerical value for the air mass flow exponent. (Default: 0.65).

  • delta_pressure – Reference air pressure difference across building envelope orifice in Pascals. Default 4 represents typical building pressures.

Returns

Air mass flow coefficient per unit meter at 1 Pa [kg/m2/s/P^n]

static solve_norm_perimeter_flow_coefficient(norm_area_flow_coefficient, face_area, face_perimeter)[source]

Get mass flow coefficient [kg/(s m P^n)] from a normalized one and geometry.

This parameter is used to derive air flow for the four cracks around the perimeter of a closed window or door: one along the bottom, one along the top, and one on each side. Since this value is derived from the infiltration flow rate per exterior area, which represents an average over many types of air leakage rates, this value is not intended to be representative of actual opening edges flow coefficients. The normalized perimeter air mass flow coefficient is derived from its infiltration flow rate using the following formula:

Qva * d * A = Cql * L * dP^n

where:
    Cql: Air mass flow coefficient per unit length at 1 Pa [kg/m/s/P^n]
    Qva: Volumetric air flow rate per length [m3/s/m]
    d: Air density [kg/m3]
    A: Surface area of opening [m2]
    L: Surface perimeter of opening [m]
    dP: Change in pressure across building envelope [Pa]
    n: Air mass flow exponent [-]

Since (Qva * d) / dP^n equals Cqa the normalized area flow coefficient, this can be simplified and rearranged to solve for Cql with the following formula:

(Cqa * dP^n) * A = Cql * L * dP^n
Cql = ((Cqa * dP^n) * A) / (L * dP^n)
    = Cqa * A / L

The resulting value has units of kg/(m-s-P^n) @ <delta_pressure> Pa, while the EnergyPlus AirflowNetwork requires this value to be in kg/(s-Pa) @ 1 Pa. Thus unlike the surface area flow_coefficient, this coefficient is normalized per unit length. Since the actual ratio between mass infiltration and pressure difference (raised by n) is constant, we assume solving for the flow coefficient at the delta_pressure value is equivalent to solving it at the required 1 Pa.

Parameters
  • norm_area_flow_coefficient – Air mass flow coefficient per unit meter at 1 Pa [kg/m2/s/P^n]

  • face_area – A numerical value for the total exterior area in m2.

  • face_perimeter – A numerical value for the total exterior perimeter in meters.

Returns

Air mass flow coefficient per unit length at 1 Pa [kg/m/s/P^n]

to_dict(abridged=False)[source]

Return Room energy properties as a dictionary.

Parameters

abridged – Boolean for whether the full dictionary of the Room should be written (False) or just the identifier of the the individual properties (True). Default: False.

window_construction_by_orientation(construction, orientation=0, offset=45, north_vector=Vector2D(0.0, 1.0))[source]

Set the construction of exterior Apertures in Walls facing a given orientation.

This is useful for testing orientation-specific energy conservation strategies or creating ASHRAE baseline buildings.

Parameters
  • construction – A WindowConstruction that will be assigned to all of the room’s Apertures in Walls that are facing a certain orientation.

  • orientation – A number between 0 and 360 that represents the orientation in degrees to which the construction will be assigned. 0 = North, 90 = East, 180 = South, 270 = West. (Default: 0 for North).

  • offset – A number between 0 and 180 that represents the offset from the orientation in degrees for which the construction will be assigned. For example, a value of 45 indicates that any Apertures falling in the 90 degree range around the orientation will get the input construction. (Default: 45).

  • north_vector – A ladybug_geometry Vector3D for the north direction. Default is the Y-axis (0, 1).

property construction_set

Get or set the Room ConstructionSet object.

If not set, it will be the Honeybee default generic ConstructionSet.

property daylighting_control

Get or set a DaylightingControl object to dictate the dimming of lights.

If None, the lighting will respond only to the schedule and not the daylight conditions within the room.

property electric_equipment

Get or set an ElectricEquipment object to describe the equipment usage.

property fans

Get or set an array of VentilationFan objects for fans within the room.

Note that these fans are not connected to the heating or cooling system and are meant to represent the intentional circulation of unconditioned outdoor air for the purposes of keeping a space cooler, drier or free of indoor pollutants (as in the case of kitchen or bathroom exhaust fans).

For the specification of mechanical ventilation of conditioned outdoor air, the Room.ventilation property should be used and the Room should be given a HVAC that can meet this specification.

property gas_equipment

Get or set a GasEquipment object to describe the equipment usage.

property has_overridden_loads

Boolean to note whether the Room has any loads that override the Program.

This will happen if any of the absolute methods are used or if any of the individual Room load objects have been set.

property host

Get the Room object hosting these properties.

property hvac

Get or set the HVAC object for the Room.

If None, it will be assumed that the Room is not conditioned.

property infiltration

Get or set a Infiltration object to to describe the outdoor air leakage.

property internal_masses

Get or set an array of InternalMass objects for mass exposed to Room air.

Note that internal masses assigned this way cannot “see” solar radiation that may potentially hit them and, as such, caution should be taken when using this component with internal mass objects that are not always in shade. Masses are factored into the the thermal calculations of the Room by undergoing heat transfer with the indoor air.

property is_conditioned

Boolean to note whether the Room is conditioned.

property lighting

Get or set a Lighting object to describe the lighting usage of the Room.

property people

Get or set a People object to describe the occupancy of the Room.

property process_loads

Get or set an array of Process objects for process loads within the room.

property program_type

Get or set the ProgramType object for the Room.

If not set, it will default to a plenum ProgramType (with no loads assigned).

property service_hot_water

Get or set a ServiceHotWater object to describe the hot water usage.

property setpoint

Get or set a Setpoint object for the temperature setpoints of the Room.

property shw

Get or set the SHWSystem object for the Room.

If None, all hot water loads will be met with a system that doesn’t compute fuel or electricity usage.

property total_fan_flow

Get a number for the total process load in m3/s within the room.

property total_process_load

Get a number for the total process load in W within the room.

property ventilation

Get or set a Ventilation object for the minimum outdoor air requirement.

Note that setting the ventilation here will only affect the conditioned outdoor air that is brought through a HVAC system. For mechanical ventilation of outdoor air that is not connected to any heating or cooling system the Room.fans property should be used.

property window_vent_control

Get or set a VentilationControl object to dictate the opening of windows.

If None, the windows will never open.