honeybee-core 1.61.18__tar.gz → 1.64.7__tar.gz

{honeybee_core-1.61.18 → honeybee_core-1.64.7}/.github/workflows/ci.yaml

@@ -55,7 +55,7 @@ jobs:
         run: |
           nextRelease="`npx semantic-release@^23.1.1 --dryRun | grep -oP 'Published release \K.*? ' || true`"
           npx semantic-release@^23.1.1
-          echo "::set-output name=tag::$nextRelease"
+          echo "tag=$nextRelease" >> $GITHUB_OUTPUT
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           PYPI_PASSWORD: ${{ secrets.PYPI_PASSWORD }}

{honeybee_core-1.61.18/honeybee_core.egg-info → honeybee_core-1.64.7}/PKG-INFO

@@ -1,22 +1,36 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: honeybee-core
-Version: 1.61.18
+Version: 1.64.7
 Summary: A library to create 3D building geometry for various types of environmental simulation.
 Home-page: https://github.com/ladybug-tools/honeybee-core
 Author: Ladybug Tools
 Author-email: info@ladybug.tools
 License: AGPL-3.0
 Classifier: Programming Language :: Python :: 2.7
-Classifier: Programming Language :: Python :: 3.6
 Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: Implementation :: CPython
-Classifier: License :: OSI Approved :: GNU Affero General Public License v3
+Classifier: Programming Language :: Python :: Implementation :: IronPython
 Classifier: Operating System :: OS Independent
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: ladybug-core==0.44.12
-Requires-Dist: ladybug-geometry-polyskel==1.7.25
-Requires-Dist: honeybee-schema==1.59.0; python_version >= "3.7"
+Requires-Dist: ladybug-core==0.44.28
+Requires-Dist: ladybug-geometry-polyskel==1.7.35
+Requires-Dist: honeybee-schema==1.59.1; python_version >= "3.7"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: summary
 
 ![Honeybee](https://www.ladybug.tools/assets/img/honeybee.png)
 

{honeybee_core-1.61.18 → honeybee_core-1.64.7}/deploy.sh

@@ -1,6 +1,6 @@
 #!/bin/sh
 
 echo "Building distribution"
-python setup.py sdist bdist_wheel
+python -m build
 echo "Pushing new version to PyPi"
 twine upload dist/* -u $PYPI_USERNAME -p $PYPI_PASSWORD 

{honeybee_core-1.61.18 → honeybee_core-1.64.7}/dev-requirements.txt

@@ -4,10 +4,10 @@ sphinx-bootstrap-theme==0.8.1
 sphinxcontrib-fulltoc==1.2.0
 sphinxcontrib-websupport==2.0.0;python_version>='3.6'
 sphinx-click==6.0.0;python_version>='3.6'
-twine==5.1.1;python_version>='3.6'
-wheel==0.44.0;python_version>='3.6'
-setuptools==75.1.0;python_version>='3.6'
-importlib-metadata==8.5.0;python_version>='3.6'
+twine==6.1.0;python_version>='3.6'
+wheel==0.45.1;python_version>='3.6'
+setuptools==80.9.0;python_version>='3.6'
+build==1.3.0;python_version>='3.6'
 pytest==4.6.9;python_version<'3.0'
 Sphinx==1.8.5;python_version<'3.0'
 sphinxcontrib-websupport==1.1.2;python_version<'3.0'
@@ -15,4 +15,5 @@ sphinx-click==4.4.0;python_version<'3.0'
 twine==1.13.0;python_version<'3.0'
 wheel==0.38.1;python_version<'3.0'
 setuptools==44.1.0;python_version<'3.0'
+build==0.1.0;python_version<'3.0'
 importlib-metadata==2.0.0;python_version<'3.0'

{honeybee_core-1.61.18 → honeybee_core-1.64.7}/honeybee/aperture.py

@@ -2,16 +2,18 @@
 """Honeybee Aperture."""
 from __future__ import division
 import math
+import re
 
-from ladybug_geometry.geometry2d.pointvector import Vector2D
-from ladybug_geometry.geometry3d.pointvector import Point3D
-from ladybug_geometry.geometry3d.face import Face3D
+from ladybug_geometry.geometry2d import Vector2D
+from ladybug_geometry.geometry3d import Point3D, Face3D
 from ladybug.color import Color
 
 from ._basewithshade import _BaseWithShade
 from .typing import clean_string
+from .search import get_attr_nested
 from .properties import ApertureProperties
 from .boundarycondition import boundary_conditions, Outdoors, Surface
+from .facetype import RoofCeiling
 from .shade import Shade
 import honeybee.writer.aperture as writer
 
@@ -276,6 +278,23 @@ class Aperture(_BaseWithShade):
         """
         return isinstance(self.boundary_condition, Outdoors)
 
+    @property
+    def gbxml_type(self):
+        """Get text for the type of object this is in gbXML schema.
+
+        This will always be one of the following.
+
+            * FixedWindow
+            * OperableWindow
+            * FixedSkylight
+            * OperableSkylight
+        """
+        base_type = 'Window'
+        if self.has_parent and isinstance(self.parent.type, RoofCeiling):
+            base_type = 'Skylight'
+        win_type = 'Fixed' if not self.is_operable else 'Operable'
+        return win_type + base_type
+
     @property
     def type_color(self):
         """Get a Color to be used in visualizations by type."""
@@ -298,16 +317,23 @@ class Aperture(_BaseWithShade):
         return math.degrees(
             north_vector.angle_clockwise(Vector2D(self.normal.x, self.normal.y)))
 
-    def cardinal_direction(self, north_vector=Vector2D(0, 1)):
+    def cardinal_direction(self, north_vector=Vector2D(0, 1), angle_tolerance=1):
         """Get text description for the cardinal direction that the aperture is pointing.
 
         Will be one of the following: ('North', 'NorthEast', 'East', 'SouthEast',
-        'South', 'SouthWest', 'West', 'NorthWest').
+        'South', 'SouthWest', 'West', 'NorthWest', 'Up', 'Down').
 
         Args:
             north_vector: A ladybug_geometry Vector2D for the north direction.
                 Default is the Y-axis (0, 1).
-        """
+            angle_tolerance: The angle tolerance in degrees used to determine if
+                the geometry is perfectly Up or Down. (Default: 1).
+        """
+        tilt = self.tilt
+        if tilt < angle_tolerance:
+            return 'Up'
+        elif tilt > 180 - angle_tolerance:
+            return 'Down'
         orient = self.horizontal_orientation(north_vector)
         orient_text = ('North', 'NorthEast', 'East', 'SouthEast', 'South',
                        'SouthWest', 'West', 'NorthWest')
@@ -317,6 +343,31 @@ class Aperture(_BaseWithShade):
                 return orient_text[i]
         return orient_text[0]
 
+    def cardinal_abbrev(self, north_vector=Vector2D(0, 1), angle_tolerance=1):
+        """Get text abbreviation for the cardinal direction that the aperture is pointing.
+
+        Will be one of the following: ('N', 'NE', 'E', 'SE', 'S', 'SW', 'W', 'NW',
+        'Up', 'Down').
+
+        Args:
+            north_vector: A ladybug_geometry Vector2D for the north direction.
+                Default is the Y-axis (0, 1).
+            angle_tolerance: The angle tolerance in degrees used to determine if
+                the aperture is perfectly Up or Down. (Default: 1).
+        """
+        tilt = self.tilt
+        if tilt < angle_tolerance:
+            return 'Up'
+        elif tilt > 180 - angle_tolerance:
+            return 'Down'
+        orient = self.horizontal_orientation(north_vector)
+        orient_text = ('N', 'NE', 'E', 'SE', 'S', 'SW', 'W', 'NW')
+        angles = (22.5, 67.5, 112.5, 157.5, 202.5, 247.5, 292.5, 337.5)
+        for i, ang in enumerate(angles):
+            if orient < ang:
+                return orient_text[i]
+        return orient_text[0]
+
     def add_prefix(self, prefix):
         """Change the identifier of this object and child objects by inserting a prefix.
 
@@ -340,6 +391,28 @@ class Aperture(_BaseWithShade):
                            in self._boundary_condition._boundary_condition_objects)
             self._boundary_condition = Surface(new_bc_objs, True)
 
+    def rename_by_attribute(
+        self,
+        format_str='{parent.parent.display_name} - {gbxml_type} - {cardinal_direction}'
+    ):
+        """Set the display name of this Aperture using a format string with attributes.
+
+        Args:
+            format_str: Text string for the pattern with which the Aperture will be
+                renamed. Any property on this class may be used (eg. gbxml_str)
+                and each property should be put in curly brackets. Nested
+                properties can be specified by using "." to denote nesting levels
+                (eg. properties.energy.construction.display_name). Functions that
+                return string outputs can also be passed here as long as these
+                functions defaults specified for all arguments.
+        """
+        matches = re.findall(r'{([^}]*)}', format_str)
+        attributes = [get_attr_nested(self, m, decimal_count=2) for m in matches]
+        for attr_name, attr_val in zip(matches, attributes):
+            format_str = format_str.replace('{{{}}}'.format(attr_name), attr_val)
+        self.display_name = format_str
+        return format_str
+
     def set_adjacency(self, other_aperture):
         """Set this aperture to be adjacent to another.
 

{honeybee_core-1.61.18 → honeybee_core-1.64.7}/honeybee/cli/edit.py

@@ -104,7 +104,8 @@ def solve_adjacency(model_file, no_merge, no_intersect, no_overwrite,
         air_boundary = not wall
         adiabatic = not surface
         parsed_model.solve_adjacency(
-            merge_coplanar, intersect, overwrite, air_boundary, adiabatic)
+            merge_coplanar, intersect, overwrite,
+            air_boundary=air_boundary, adiabatic=adiabatic)
 
         # write the new model out to the file or stdout
         output_file.write(json.dumps(parsed_model.to_dict()))

{honeybee_core-1.61.18 → honeybee_core-1.64.7}/honeybee/cli/validate.py

@@ -21,10 +21,13 @@ def validate():
     '--extension', '-e', help='Text for the name of the extension to be checked. '
     'The value input is case-insensitive such that "radiance" and "Radiance" will '
     'both result in the model being checked for validity with honeybee-radiance. '
-    'This value can also be set to "All" in order to run checks for all installed '
-    'extensions. Some common honeybee extension names that can be input here include: '
-    'Radiance, EnergyPlus, DOE2, IES, IDAICE',
-    type=str, default='All', show_default=True)
+    'This value can also be set to "Generic" in order to run checks for all installed '
+    'extensions. Using "Generic" will run all except the most limiting of checks '
+    '(eg. the DOE2 lack of support for courtyards) with the goal of producing a model '
+    'that can be exported to multiple engines (albeit with a little extra '
+    'postprocessing for particularly limited engines). Some common honeybee extension '
+    'names that can be input here include: Radiance, EnergyPlus, DOE2, IES, IDAICE',
+    type=str, default='Generic', show_default=True)
 @click.option(
     '--plain-text/--json', ' /-j', help='Flag to note whether the output validation '
     'report should be formatted as a JSON object instead of plain text. If set to JSON, '
@@ -82,7 +85,7 @@ def validate_model_cli(model_file, extension, plain_text, room_overlaps, output_
         sys.exit(0)
 
 
-def validate_model(model_file, extension='All', json=False, output_file=None,
+def validate_model(model_file, extension='Generic', json=False, output_file=None,
                    plain_text=True):
     """Validate all properties of a Model file against the Honeybee schema.
 
@@ -95,8 +98,12 @@ def validate_model(model_file, extension='All', json=False, output_file=None,
             The value input here is case-insensitive such that "radiance"
             and "Radiance" will both result in the model being checked for
             validity with honeybee-radiance. This value can also be set to
-            "All" in order to run checks for all installed extensions. Some
-            common honeybee extension names that can be input here if they
+            "Generic" in order to run checks for all installed extensions.
+            Using "Generic" will run all except the most limiting of checks
+            (eg. DOE2's lack of support for courtyards) with the goal of
+            producing a model that is export-able to multiple engines (albeit
+            with a little extra postprocessing for particularly limited engines).
+            Some common dragonfly extension names that can be input here if they
             are installed include:
 
             * Radiance

{honeybee_core-1.61.18 → honeybee_core-1.64.7}/honeybee/door.py

@@ -2,14 +2,15 @@
 """Honeybee Door."""
 from __future__ import division
 import math
+import re
 
-from ladybug_geometry.geometry2d.pointvector import Vector2D
-from ladybug_geometry.geometry3d.pointvector import Point3D
-from ladybug_geometry.geometry3d.face import Face3D
+from ladybug_geometry.geometry2d import Vector2D
+from ladybug_geometry.geometry3d import Point3D, Face3D
 from ladybug.color import Color
 
 from ._basewithshade import _BaseWithShade
 from .typing import clean_string
+from .search import get_attr_nested
 from .properties import DoorProperties
 from .boundarycondition import boundary_conditions, Outdoors, Surface
 from .shade import Shade
@@ -278,6 +279,16 @@ class Door(_BaseWithShade):
         """
         return isinstance(self.boundary_condition, Outdoors)
 
+    @property
+    def gbxml_type(self):
+        """Get text for the type of object this is in gbXML schema."""
+        return 'NonSlidingDoor'
+
+    @property
+    def energyplus_type(self):
+        """Get text for the type of object this is in IDF schema."""
+        return 'GlassDoor' if self.is_glass else 'Door'
+
     @property
     def type_color(self):
         """Get a Color to be used in visualizations by type."""
@@ -300,16 +311,23 @@ class Door(_BaseWithShade):
         return math.degrees(
             north_vector.angle_clockwise(Vector2D(self.normal.x, self.normal.y)))
 
-    def cardinal_direction(self, north_vector=Vector2D(0, 1)):
+    def cardinal_direction(self, north_vector=Vector2D(0, 1), angle_tolerance=1):
         """Get text description for the cardinal direction that the door is pointing.
 
         Will be one of the following: ('North', 'NorthEast', 'East', 'SouthEast',
-        'South', 'SouthWest', 'West', 'NorthWest').
+        'South', 'SouthWest', 'West', 'NorthWest', 'Up', 'Down').
 
         Args:
             north_vector: A ladybug_geometry Vector2D for the north direction.
                 Default is the Y-axis (0, 1).
+            angle_tolerance: The angle tolerance in degrees used to determine if
+                the geometry is perfectly Up or Down. (Default: 1).
         """
+        tilt = self.tilt
+        if tilt < angle_tolerance:
+            return 'Up'
+        elif tilt > 180 - angle_tolerance:
+            return 'Down'
         orient = self.horizontal_orientation(north_vector)
         orient_text = ('North', 'NorthEast', 'East', 'SouthEast', 'South',
                        'SouthWest', 'West', 'NorthWest')
@@ -319,6 +337,31 @@ class Door(_BaseWithShade):
                 return orient_text[i]
         return orient_text[0]
 
+    def cardinal_abbrev(self, north_vector=Vector2D(0, 1), angle_tolerance=1):
+        """Get text abbreviation for the cardinal direction that the door is pointing.
+
+        Will be one of the following: ('N', 'NE', 'E', 'SE', 'S', 'SW', 'W', 'NW',
+        'Up', 'Down').
+
+        Args:
+            north_vector: A ladybug_geometry Vector2D for the north direction.
+                Default is the Y-axis (0, 1).
+            angle_tolerance: The angle tolerance in degrees used to determine if
+                the door is perfectly Up or Down. (Default: 1).
+        """
+        tilt = self.tilt
+        if tilt < angle_tolerance:
+            return 'Up'
+        elif tilt > 180 - angle_tolerance:
+            return 'Down'
+        orient = self.horizontal_orientation(north_vector)
+        orient_text = ('N', 'NE', 'E', 'SE', 'S', 'SW', 'W', 'NW')
+        angles = (22.5, 67.5, 112.5, 157.5, 202.5, 247.5, 292.5, 337.5)
+        for i, ang in enumerate(angles):
+            if orient < ang:
+                return orient_text[i]
+        return orient_text[0]
+
     def add_prefix(self, prefix):
         """Change the identifier of this object and child objects by inserting a prefix.
 
@@ -342,6 +385,28 @@ class Door(_BaseWithShade):
                            in self._boundary_condition._boundary_condition_objects)
             self._boundary_condition = Surface(new_bc_objs, True)
 
+    def rename_by_attribute(
+        self,
+        format_str='{parent.parent.display_name} - {energyplus_type} - {cardinal_direction}'
+    ):
+        """Set the display name of this Door using a format string with attributes.
+
+        Args:
+            format_str: Text string for the pattern with which the Door will be
+                renamed. Any property on this class may be used (eg. energyplus_type)
+                and each property should be put in curly brackets. Nested
+                properties can be specified by using "." to denote nesting levels
+                (eg. properties.energy.construction.display_name). Functions that
+                return string outputs can also be passed here as long as these
+                functions defaults specified for all arguments.
+        """
+        matches = re.findall(r'{([^}]*)}', format_str)
+        attributes = [get_attr_nested(self, m, decimal_count=2) for m in matches]
+        for attr_name, attr_val in zip(matches, attributes):
+            format_str = format_str.replace('{{{}}}'.format(attr_name), attr_val)
+        self.display_name = format_str
+        return format_str
+
     def set_adjacency(self, other_door):
         """Set this door to be adjacent to another (and vice versa).
 

{honeybee_core-1.61.18 → honeybee_core-1.64.7}/honeybee/face.py

@@ -2,6 +2,7 @@
 """Honeybee Face."""
 from __future__ import division
 import math
+import re
 
 from ladybug_geometry.geometry2d import Vector2D, Point2D, Polygon2D, Mesh2D
 from ladybug_geometry.geometry3d import Vector3D, Point3D, Plane, Face3D
@@ -9,8 +10,10 @@ from ladybug.color import Color
 
 from ._basewithshade import _BaseWithShade
 from .typing import clean_string, invalid_dict_error
+from .search import get_attr_nested
 from .properties import FaceProperties
-from .facetype import face_types, get_type_from_normal, AirBoundary, Floor, RoofCeiling
+from .facetype import face_types, get_type_from_normal, AirBoundary, Wall, \
+    Floor, RoofCeiling
 from .boundarycondition import boundary_conditions, get_bc_from_position, \
     _BoundaryCondition, Outdoors, Surface, Ground
 from .shade import Shade
@@ -130,13 +133,6 @@ class Face(_BaseWithShade):
             assert data['type'] == 'Face', 'Expected Face dictionary. ' \
                 'Got {}.'.format(data['type'])
 
-            # remove any invalid holes from the geometry
-            geo_dict = data['geometry']
-            if 'holes' in geo_dict and geo_dict['holes'] is not None:
-                for i, hole_list in enumerate(geo_dict['holes']):
-                    if len(hole_list) < 3:
-                        geo_dict['holes'].pop(i)
-
             # first serialize it with an outdoor boundary condition
             face_type = face_types.by_name(data['face_type'])
             face = cls(data['identifier'], Face3D.from_dict(data['geometry']),
@@ -398,6 +394,52 @@ class Face(_BaseWithShade):
         """
         return isinstance(self.boundary_condition, Outdoors)
 
+    @property
+    def gbxml_type(self):
+        """Get text for the type of object this is in gbXML schema.
+
+        This will always be one of the following.
+
+            * InteriorWall
+            * ExteriorWall
+            * UndergroundWall
+            * Roof
+            * Ceiling
+            * UndergroundCeiling
+            * InteriorFloor
+            * ExposedFloor
+            * UndergroundSlab
+            * SlabOnGrade
+            * Air
+        """
+        if isinstance(self.type, AirBoundary):
+            return 'Air'
+        elif isinstance(self.type, Wall):
+            bc_type = 'Interior'
+            if isinstance(self.boundary_condition, Outdoors):
+                bc_type = 'Exterior'
+            elif isinstance(self.boundary_condition, Ground):
+                bc_type = 'Underground'
+            return bc_type + 'Wall'
+        elif isinstance(self.type, Floor):
+            if isinstance(self.boundary_condition, Ground):
+                if self.has_parent:
+                    for f in self.parent.faces:
+                        if isinstance(f.type, Wall) and \
+                                isinstance(f.boundary_condition, Outdoors):
+                            return 'SlabOnGrade'
+                return 'UndergroundSlab'
+            elif isinstance(self.boundary_condition, Outdoors):
+                return 'ExposedFloor'
+            else:
+                return 'InteriorFloor'
+        else:
+            if isinstance(self.boundary_condition, Outdoors):
+                return 'Roof'
+            elif isinstance(self.boundary_condition, Ground):
+                return 'UndergroundCeiling'
+            return 'Ceiling'
+
     @property
     def type_color(self):
         """Get a Color to be used in visualizations by type."""
@@ -425,16 +467,23 @@ class Face(_BaseWithShade):
         return math.degrees(
             north_vector.angle_clockwise(Vector2D(self.normal.x, self.normal.y)))
 
-    def cardinal_direction(self, north_vector=Vector2D(0, 1)):
+    def cardinal_direction(self, north_vector=Vector2D(0, 1), angle_tolerance=1):
         """Get text description for the cardinal direction that the face is pointing.
 
         Will be one of the following: ('North', 'NorthEast', 'East', 'SouthEast',
-        'South', 'SouthWest', 'West', 'NorthWest').
+        'South', 'SouthWest', 'West', 'NorthWest', 'Up', 'Down').
 
         Args:
             north_vector: A ladybug_geometry Vector2D for the north direction.
                 Default is the Y-axis (0, 1).
+            angle_tolerance: The angle tolerance in degrees used to determine if
+                the Face is perfectly Up or Down. (Default: 1).
         """
+        tilt = self.tilt
+        if tilt < angle_tolerance:
+            return 'Up'
+        elif tilt > 180 - angle_tolerance:
+            return 'Down'
         orient = self.horizontal_orientation(north_vector)
         orient_text = ('North', 'NorthEast', 'East', 'SouthEast', 'South',
                        'SouthWest', 'West', 'NorthWest')
@@ -444,6 +493,31 @@ class Face(_BaseWithShade):
                 return orient_text[i]
         return orient_text[0]
 
+    def cardinal_abbrev(self, north_vector=Vector2D(0, 1), angle_tolerance=1):
+        """Get text abbreviation for the cardinal direction that the face is pointing.
+
+        Will be one of the following: ('N', 'NE', 'E', 'SE', 'S', 'SW', 'W', 'NW',
+        'Up', 'Down').
+
+        Args:
+            north_vector: A ladybug_geometry Vector2D for the north direction.
+                Default is the Y-axis (0, 1).
+            angle_tolerance: The angle tolerance in degrees used to determine if
+                the Face is perfectly Up or Down. (Default: 1).
+        """
+        tilt = self.tilt
+        if tilt < angle_tolerance:
+            return 'Up'
+        elif tilt > 180 - angle_tolerance:
+            return 'Down'
+        orient = self.horizontal_orientation(north_vector)
+        orient_text = ('N', 'NE', 'E', 'SE', 'S', 'SW', 'W', 'NW')
+        angles = (22.5, 67.5, 112.5, 157.5, 202.5, 247.5, 292.5, 337.5)
+        for i, ang in enumerate(angles):
+            if orient < ang:
+                return orient_text[i]
+        return orient_text[0]
+
     def add_prefix(self, prefix):
         """Change the identifier of this object and child objects by inserting a prefix.
 
@@ -471,6 +545,28 @@ class Face(_BaseWithShade):
                            in self._boundary_condition._boundary_condition_objects)
             self._boundary_condition = Surface(new_bc_objs, False)
 
+    def rename_by_attribute(
+        self,
+        format_str='{parent.display_name} - {gbxml_type} - {cardinal_direction}'
+    ):
+        """Set the display name of this Face using a format string with Face attributes.
+
+        Args:
+            format_str: Text string for the pattern with which the Face will be
+                renamed. Any property on this class may be used (eg. gbxml_str)
+                and each property should be put in curly brackets. Nested
+                properties can be specified by using "." to denote nesting levels
+                (eg. properties.energy.construction.display_name). Functions that
+                return string outputs can also be passed here as long as these
+                functions defaults specified for all arguments.
+        """
+        matches = re.findall(r'{([^}]*)}', format_str)
+        attributes = [get_attr_nested(self, m, decimal_count=2) for m in matches]
+        for attr_name, attr_val in zip(matches, attributes):
+            format_str = format_str.replace('{{{}}}'.format(attr_name), attr_val)
+        self.display_name = format_str
+        return format_str
+
     def remove_sub_faces(self):
         """Remove all apertures and doors from the face."""
         self.remove_apertures()
@@ -740,6 +836,8 @@ class Face(_BaseWithShade):
                     if len(joined_bounds) == 1:  # can be represented with a single Face3D
                         verts3d = tuple(ref_plane.xy_to_xyz(_v) for _v in joined_bounds[0])
                         non_rect_geos = [Face3D(verts3d, plane=ref_plane)]
+                    elif len(joined_bounds) == 0:  # everything was invalid
+                        non_rect_geos = []
                     else:  # need to separate holes from distinct Face3Ds
                         bound_faces = []
                         for poly in joined_bounds:
@@ -1749,16 +1847,24 @@ class Face(_BaseWithShade):
                 at which point the vertex is considered colinear. Default: 0.01,
                 suitable for objects in meters.
         """
+        # set up lists to track sub-faces to remove
+        del_ap_i, del_dr_i = [], []
+        # remove degenerate apertures
         for i, ap in enumerate(self._apertures):
             try:
                 ap.remove_colinear_vertices(tolerance)
             except ValueError:
-                self._apertures.pop(i)
+                del_ap_i.append(i)
+        for del_i in reversed(del_ap_i):
+            self._apertures.pop(del_i)
+        # remove degenerate doors
         for i, dr in enumerate(self._doors):
             try:
                 dr.remove_colinear_vertices(tolerance)
             except ValueError:
-                self._apertures.pop(i)
+                del_dr_i.append(i)
+        for del_i in reversed(del_dr_i):
+            self._doors.pop(del_i)
 
     def is_geo_equivalent(self, face, tolerance=0.01):
         """Get a boolean for whether this object is geometrically equivalent to another.