honeybee_energy.baseline.create module

Module for creating baseline buildings conforming to standards.

honeybee_energy.baseline.create.model_constructions_to_baseline(model, climate_zone)[source]

Convert a Model’s constructions to be conformant with ASHRAE 90.1 appendix G.

This includes assigning a ConstructionSet that is compliant with Table G3.4 to all rooms in the model, accounting for the fenestration ratios in the process.

Note that not all versions of ASHRAE 90.1 use this exact definition of baseline constructions but version 2016 and onward conform to it. It is essentially an adjusted version of the 90.1-2004 methods.

Parameters

  • model – A Honeybee Model that will have its constructions adjusted to conform to the baseline.

  • climate_zone – Text indicating the ASHRAE climate zone. This can be a single integer (in which case it is interpreted as A) or it can include the A, B, or C qualifier (eg. 3C).

honeybee_energy.baseline.create.model_geometry_to_baseline(model, building_type='NonResidential')[source]

Convert a Model’s geometry to be conformant with ASHRAE 90.1 appendix G.

This includes stripping out all attached shades (leaving detached shade as context), reducing the vertical glazing ratio to a level conformant to the building_type (or 40% if the building type is unknown and the model is above this value), and reducing the skylight ratio to 3% if it’s above this value.

Note that not all versions of ASHRAE 90.1 use this exact definition of baseline geometry but version 2016 and onward conform to it. It is essentially an adjusted version of the 90.1-2004 methods.

Parameters

  • model – A Honeybee Model that will have its geometry adjusted to conform to the baseline.

  • building_type –

    Text for the building type that the Model represents. This is used to set the maximum window ratio for the model. If the type is not recognized or is “Unknown”, a maximum of 40% shall be used. The following have specified ratios per the standard.

    • LargeOffice

    • MediumOffice

    • SmallOffice

    • Retail

    • StripMall

    • PrimarySchool

    • SecondarySchool

    • SmallHotel

    • LargeHotel

    • Hospital

    • Outpatient

    • Warehouse

    • SuperMarket

    • FullServiceRestaurant

    • QuickServiceRestaurant

honeybee_energy.baseline.create.model_hvac_to_baseline(model, climate_zone, building_type='NonResidential', floor_area=None, story_count=None)[source]

Convert a Model’s HVAC to be conformant with ASHRAE 90.1 appendix G.

This includes the selection of the correct Appendix G template HVAC based on the inputs and the application of this HVAC to all conditioned spaces in the model.

Note that not all versions of ASHRAE 90.1 use this exact definition of baseline HVAC but version 2016 and onward conform to it. It is essentially an adjusted version of the 90.1-2004 methods.

Parameters

  • model – A Honeybee Model that will have its HVAC adjusted to conform to the baseline.

  • climate_zone – Text indicating the ASHRAE climate zone. This can be a single integer (in which case it is interpreted as A) or it can include the A, B, or C qualifier (eg. 3C).

  • building_type –

    Text for the building type that the Model represents. This is used to determine the baseline system. If the type is not recognized or is “Unknown”, it will be assumed that the building is a generic NonResidential. The following have specified systems per the standard.

    • NonResidential

    • Residential

    • MidriseApartment

    • HighriseApartment

    • LargeOffice

    • MediumOffice

    • SmallOffice

    • Retail

    • StripMall

    • PrimarySchool

    • SecondarySchool

    • SmallHotel

    • LargeHotel

    • Hospital

    • Outpatient

    • Warehouse

    • SuperMarket

    • FullServiceRestaurant

    • QuickServiceRestaurant

    • Laboratory

  • floor_area – A number for the floor area of the building that the model is a part of in m2. If None, the model floor area will be used. (Default: None).

  • story_count – An integer for the number of stories of the building that the model is a part of. If None, the model stories will be used. (Default: None).

honeybee_energy.baseline.create.model_lighting_to_baseline(model)[source]

Convert a Model’s lighting to be conformant with ASHRAE 90.1-2004 appendix G.

This includes determining whether an ASHRAE 2004 equivalent exists for each program type in the model. If none is found, the baseline_watts_per_area on the room’s program’s lighting will be used, which will default to a typical office if none has been specified.

Parameters

model – A Honeybee Model that will have its lighting power adjusted to conform to the baseline.

honeybee_energy.baseline.create.model_lighting_to_baseline_building(model, building_type='NonResidential')[source]

Convert a Model’s lighting to be conformant with ASHRAE 90.1-2004 appendix G.

This includes looking up the building type’s average lighting power density and assigning it to all Rooms in the model.

Parameters

  • model – A Honeybee Model that will have its lighting power adjusted to conform to the baseline.

  • building_type –

    Text for the building type that the Model represents. If the type is not recognized or is “Unknown”, it will be assumed that the building is a generic NonResidential (aka. an office). The following have specified meaning per the standard.

    • NonResidential

    • Residential

    • MidriseApartment

    • HighriseApartment

    • LargeOffice

    • MediumOffice

    • SmallOffice

    • Retail

    • StripMall

    • PrimarySchool

    • SecondarySchool

    • SmallHotel

    • LargeHotel

    • Hospital

    • Outpatient

    • Warehouse

    • SuperMarket

    • FullServiceRestaurant

    • QuickServiceRestaurant

    • Laboratory

    • Courthouse

honeybee_energy.baseline.create.model_remove_ecms(model)[source]

Remove energy conservation strategies (ECMs) not associated with baseline models.

This includes removing the opening behavior of all operable windows, daylight controls, etc.

Parameters

model – A Honeybee Model that will have its lighting power adjusted to conform to the baseline.

honeybee_energy.baseline.create.model_shw_to_baseline(model, building_type='NonResidential')[source]

Convert a Model’s SHW systems to be conformant with ASHRAE 90.1-2004 appendix G.

This includes looking up the building type’s baseline heating method and assigning it to all Rooms with a SHW system in the model.

Parameters

  • model – A Honeybee Model that will have its Service Hot Water (SHW) systems adjusted to conform to the baseline.

  • building_type –

    Text for the building type that the Model represents. If the type is not recognized or is “Unknown”, it will be assumed that the building is a generic NonResidential (aka. an office). The following have specified meaning per the standard.

    • NonResidential

    • Residential

    • MidriseApartment

    • HighriseApartment

    • LargeOffice

    • MediumOffice

    • SmallOffice

    • Retail

    • StripMall

    • PrimarySchool

    • SecondarySchool

    • SmallHotel

    • LargeHotel

    • Hospital

    • Outpatient

    • Warehouse

    • SuperMarket

    • FullServiceRestaurant

    • QuickServiceRestaurant

    • Laboratory

    • Courthouse

honeybee_energy.baseline.create.model_to_baseline(model, climate_zone, building_type='NonResidential', floor_area=None, story_count=None, lighting_by_building=False)[source]

Convert a Model to be conformant with ASHRAE 90.1 appendix G.

This includes running all other functions contained within this group to adjust the geometry, constructions, lighting, HVAC, SHW, and remove any clearly-defined energy conservation measures like daylight controls. Note that all schedules are essentially unchanged, meaning that additional post-processing of setpoints may be necessary to account for energy conservation strategies like expanded comfort ranges, ceiling fans, and personal thermal comfort devices. It may also be necessary to adjust electric equipment loads in cases where such equipment qualifies as an energy conservation strategy or hot water loads in cases where low-flow fixtures are implemented.

Note that not all versions of ASHRAE 90.1 use this exact definition of a baseline model but version 2016 and onward conform to it. It is essentially an adjusted version of the 90.1-2004 methods.

Parameters

  • model – A Honeybee Model that will be converted to conform to the ASHRAE 90.1 appendix G baseline.

  • climate_zone – Text indicating the ASHRAE climate zone. This can be a single integer (in which case it is interpreted as A) or it can include the A, B, or C qualifier (eg. 3C).

  • building_type –

    Text for the building type that the Model represents. This is used to determine the baseline window-to-wall ratio and HVAC system. If the type is not recognized or is “Unknown”, it will be assumed that the building is a generic NonResidential. The following have specified meaning per the standard.

    • NonResidential

    • Residential

    • MidriseApartment

    • HighriseApartment

    • LargeOffice

    • MediumOffice

    • SmallOffice

    • Retail

    • StripMall

    • PrimarySchool

    • SecondarySchool

    • SmallHotel

    • LargeHotel

    • Hospital

    • Outpatient

    • Warehouse

    • SuperMarket

    • FullServiceRestaurant

    • QuickServiceRestaurant

    • Laboratory

    • Courthouse

  • floor_area – A number for the floor area of the building that the model is a part of in m2. If None, the model floor area will be used. (Default: None).

  • story_count – An integer for the number of stories of the building that the model is a part of. If None, the model stories will be used. (Default: None).

  • lighting_by_building – A boolean to note whether the building_type should be used to assign the baseline lighting power density (True), which will use the same value for all Rooms in the model, or a space-by-space method should be used (False). To use the space-by-space method, the model should either be built with the programs that ship with Ladybug Tools in honeybee-energy-standards or the baseline_watts_per_area should be correctly assigned for all Rooms. (Default: False).