honeybee-core 1.64.1__tar.gz → 1.64.3__tar.gz

{honeybee_core-1.64.1/honeybee_core.egg-info → honeybee_core-1.64.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: honeybee-core
-Version: 1.64.1
+Version: 1.64.3
 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

{honeybee_core-1.64.1 → honeybee_core-1.64.3}/honeybee/model.py

@@ -13,7 +13,9 @@ try:  # check if we are in IronPython
 except ImportError:  # wea are in cPython
     import pickle
 
-from ladybug_geometry.geometry3d import Vector3D, Point3D, Plane, Face3D, Mesh3D
+from ladybug_geometry.geometry2d import Polygon2D
+from ladybug_geometry.geometry3d import Vector3D, Point3D, Plane, Face3D, \
+    Mesh3D, Polyface3D
 from ladybug_geometry.interop.stl import STL
 
 from ._base import _Base
@@ -1476,7 +1478,7 @@ class Model(_Base):
             )
         return shades
 
-    def classified_envelope_edges(self, tolerance=None, exclude_coplanar=False):
+    def classified_envelope_edges(self, tolerance=None, exclude_coplanar=True):
         """Get classified edges of this Model's envelope based on Faces they adjoin.
 
         The edges returned by this method will only exist along the exterior
@@ -1488,7 +1490,7 @@ class Model(_Base):
                 considered equivalent. If None, the Model's tolerance will be used.
             exclude_coplanar: Boolean to note whether edges falling between two
                 coplanar Faces in the building envelope should be included
-                in the result (False) or excluded from it (True). (Default: False).
+                in the result (False) or excluded from it (True). (Default: True).
 
         Returns:
             A tuple with eight items where each item is a list containing
@@ -1533,6 +1535,89 @@ class Model(_Base):
         return roof_to_exterior, slab_to_exterior, exposed_floor_to_exterior_wall, \
             exterior_wall_to_wall, roof_ridge, exposed_floor_to_floor, underground
 
+    def classified_sub_face_edges(
+        self, mullion_thickness=None, tolerance=None, angle_tolerance=None
+    ):
+        """Get classified edges around this Model's Apertures and Doors.
+
+        The edges returned by this method will only exist along the exterior
+        sub-faces.
+
+        Args:
+            mullion_thickness: The maximum difference that apertures can be from
+                one another for the edges to be considered a mullion rather than
+                a frame. If None, the Model's tolerance will be used.
+            tolerance: The maximum difference between point values for them to be
+                considered equivalent. If None, the Model's tolerance will be used.
+            angle_tolerance: The max angle difference in degrees where sub-face
+                normals are no longer considered coplanar. If None, the Model
+                angle_tolerance will be used. (Default: None).
+
+        Returns:
+            A tuple with three items where each item is a list containing
+            LineSegment3D surrounding different sub-face conditions.
+
+            -   window_frames - Apertures meet their parent exterior wall or roof.
+
+            -   window_mullions - Apertures meet one another.
+
+            -   door_frames - Doors meet their parent exterior wall or roof.
+
+            -   door_mullions - Doors meet one another.
+        """
+        # set up variables to be used for all sub_faces
+        tol = tolerance if tolerance is not None else self.tolerance
+        a_tol = math.radians(angle_tolerance) if angle_tolerance is not None else \
+            math.radians(self.angle_tolerance)
+        mul_thick = tol if mullion_thickness is None else mullion_thickness
+
+        # get the edges of the sub_faces
+        window_frames, window_mullions = \
+            self._classify_mullions(self.apertures, mul_thick, tol, a_tol)
+        door_frames, door_mullions = \
+            self._classify_mullions(self.doors, mul_thick, tol, a_tol)
+        return window_frames, window_mullions, door_frames, door_mullions
+
+    @staticmethod
+    def _classify_mullions(sub_faces, mul_thick, tol, a_tol):
+        """Organize subface edges depending on whether they are frames or mullions."""
+        sub_face_frames, sub_face_mullions = [], []
+        # group the apertures by the plane in which they exist
+        coplanar_dict = {}
+        sub_faces = [sf for sf in sub_faces
+                     if isinstance(sf.boundary_condition, Outdoors)]
+        if len(sub_faces) != 0:
+            coplanar_dict = {sub_faces[0].geometry.plane: [sub_faces[0]]}
+            for sf in sub_faces[1:]:
+                for pln, f_list in coplanar_dict.items():
+                    if sf.geometry.plane.is_coplanar_tolerance(pln, tol, a_tol):
+                        f_list.append(sf)
+                        break
+                else:  # the first face with this type of plane
+                    coplanar_dict[sf.geometry.plane] = [sf]
+
+        # for each group, intersect their edges and extract edges from a Polyface3D
+        for plane, sfs in coplanar_dict.items():
+            # intersect edges that are close enough to one another within thickness
+            polygons = []
+            for sf in sfs:
+                pts_2d = [plane.xyz_to_xy(pt) for pt in sf.geometry.boundary]
+                try:
+                    poly = Polygon2D(pts_2d).remove_colinear_vertices(mul_thick)
+                    polygons.append(poly)
+                except AssertionError:
+                    pass  # too small of a geometry
+            polygons = Polygon2D.intersect_polygon_segments(polygons, mul_thick)
+            faces = []
+            for poly in polygons:
+                faces.append(Face3D([plane.xy_to_xyz(pt) for pt in poly], plane))
+            # create a joined Polyface3D and classify the edges
+            ap_polyface = Polyface3D.from_faces(faces, mul_thick)
+            sub_face_frames.extend(ap_polyface.naked_edges)
+            sub_face_mullions.extend(ap_polyface.internal_edges)
+
+        return sub_face_frames, sub_face_mullions
+
     def add_prefix(self, prefix):
         """Change the identifier of this object and child objects by inserting a prefix.
 
@@ -1650,7 +1735,7 @@ class Model(_Base):
 
         Args:
             start_integer: The starting integer that will be used to set a lower
-                limit on the 
+                limit on the integers assigned to the geometry elements.
             repair_surface_bcs: A Boolean to note whether all Surface boundary
                 conditions across the model should be updated with the new
                 identifiers that were generated from the display names. (Default: True).

{honeybee_core-1.64.1 → honeybee_core-1.64.3/honeybee_core.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: honeybee-core
-Version: 1.64.1
+Version: 1.64.3
 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