get_air_exchanges () -> list
Get the room's air exchanges.
Returns:
List of RoomAirExchange objects.
get_apache_systems () -> dictionary
Gets the system data.
Returns:
Dictionary with the following information, including whether values are from template:
- Systems: HVAC system ID; methodology and whether the space is conditioned; auxiliary ventilation system ID and whether it matches the HVAC system; DHW system ID and whether is matches the HVAC system
- Heating: size (kW), radiant fraction and whether the heating capacity is unlimited. If the capacity is not unlimited then the capacity and its units are included.
- Cooling: size (kW), radiant fraction and whether the cooling capacity is unlimited. If the capacity is not unlimited then the capacity and its units are included.
- Outside air supply: flow rate and units, free cooling flow capacity and units, and variation profile ID.
- Ventilation & extract: whether room has local mechanical exhaust. If it does then also included are: the extract flow rate and units, SFP (W/l/s) and whether the extract fan is remote from the room.
Additional data is provided for HVAC mode
get_general () -> dictionary
Gets the general Space Data.
Returns:
Dictionary with the following information:
- Body name & ID
- General and thermal templates assigned to the body
- Room volume (m3) and floor area (m2)
- Lettable percentage, circulation percentage, whether or not the floor area is included in the building floor area, and whether these values are from template.
Additional data is provided for HVAC mode
get_internal_gains () -> list
Get the room's internal gains.
Returns:
get_room_conditions () -> dictionary
Gets the room conditions.
Returns:
Dictionary with the following information, including whether values are from template:
- Heating: profile ID, whether setpoint is timed/constant, and either setpoint value (°C) or setpoint profile ID
- Cooling: profile ID, whether setpoint is timed/constant, and either setpoint value (°C) or setpoint profile ID
- DHW: value and units, whether DHW is linked to occupancy or an independent profile and a usage profile ID if relevant
- Plant (auxiliary energy): profile type and profile ID.
- Solar reflected fraction
- Furniture mass factor
- Humidity control: percentage saturation lower/upper limits and max heating (+ humidification) and max dehumidification (+ cooling), in kW.
Additional data is provided for HVAC mode
set_general (data)
Sets general Space Data from the provided dictionary.
Dictionary keys are:
|
circ_perc
|
|
circ_perc_from_template
|
|
included_in_building_floor_area
|
|
included_in_building_floor_area_from_template
|
|
lettable_perc
|
|
lettable_perc_from_template
|
|
name
|
set_room_conditions (data)
Sets room conditions data from the provided dictionary.
Dictionary keys are:
|
cooling_profile
|
|
cooling_profile_from_template
|
|
cooling_setpoint
|
|
cooling_setpoint_constant
|
|
cooling_setpoint_from_template
|
|
cooling_setpoint_profile
|
|
dhw
|
|
dhw_from_template
|
|
dhw_linked_to_occupancy
|
|
dhw_linked_to_occupancy_from_template
|
|
dhw_profile
|
|
dhw_profile_from_template
|
|
dhw_room_level_setting
|
|
dhw_room_level_setting_from_template
|
|
furniture_mass_factor
|
|
furniture_mass_factor_from_template
|
|
heating_profile
|
|
heating_profile_from_template
|
|
heating_setpoint
|
|
heating_setpoint_constant
|
|
heating_setpoint_from_template
|
|
heating_setpoint_profile
|
|
plant_profile
|
|
plant_profile_from_template
|
|
plant_profile_type
|
|
sat_perc_lower
|
|
sat_perc_lower_from_template
|
|
sat_perc_upper
|
|
sat_perc_upper_from_template
|
|
solar_reflected_fraction
|
|
solar_reflected_fraction_from_template
|
set_apache_systems (data)
Sets system data from the provided dictionary.
Dictionary keys are:
|
associated_return_air_plenum
|
|
associated_supply_air_plenum
|
|
auto_associate_adjacent_plenums
|
|
aux_vent_system
|
|
aux_vent_system_from_template
|
|
aux_vent_system_same
|
|
cooling_capacity_unit
|
|
cooling_capacity_unlimited
|
|
cooling_capacity_unlimited_from_template
|
|
cooling_capacity_value
|
|
cooling_plant_radiant_fraction
|
|
cooling_plant_radiant_fraction_from_template
|
|
cooling_unit_size
|
|
dhw_system
|
|
dhw_system_from_template
|
|
dhw_system_same
|
|
extract_fan_is_remote
|
|
extract_flow_rate
|
|
extract_flow_rate_unit
|
|
has_mech_exhaust
|
|
heating_capacity_unit
|
|
heating_capacity_unlimited
|
|
heating_capacity_unlimited_from_template
|
|
heating_capacity_value
|
|
heating_plant_radiant_fraction
|
|
heating_plant_radiant_fraction_from_template
|
|
heating_unit_size
|
|
HVAC_system
|
|
HVAC_system_from_template
|
|
HVAC_methodology
|
|
HVAC_methodology_from_template
|
|
*** not available *** include_in_room_zone_loads_analysis
|
|
*** not available *** include_in_room_zone_loads_analysis_template
|
|
*** not available *** supply_condition
|
|
*** not available *** supply_condition_profile
|
|
*** not available *** supply_condition_template
|
|
system_air_free_cooling
|
|
system_air_free_cooling_from_template
|
|
system_air_minimum_flowrate
|
|
system_air_minimum_flowrate_from_template
|
|
system_air_variation_profile
|
|
system_air_variation_profile_from_template
|
set_all (general_data, room_conditions_data, systems_data)
Sets all Space Data using the provided dictionaries.
See set_general(), set_room_conditions() and set_apache_systems()
for dictionary keys.
