ladybug-core 0.44.31__py3-none-any.whl → 0.44.33__py3-none-any.whl

ladybug/legend.py

@@ -9,11 +9,8 @@ import sys
 if (sys.version_info > (3, 0)):  # python 3
     xrange = range
 
-from ladybug_geometry.geometry3d.pointvector import Point3D, Vector3D
-from ladybug_geometry.geometry3d.plane import Plane
-from ladybug_geometry.geometry3d.mesh import Mesh3D
-from ladybug_geometry.geometry2d.pointvector import Point2D
-from ladybug_geometry.geometry2d.mesh import Mesh2D
+from ladybug_geometry.geometry2d import Point2D, Mesh2D
+from ladybug_geometry.geometry3d import Point3D, Vector3D, Polyline3D, Plane, Mesh3D
 
 from .color import Color, Colorset, ColorRange
 
@@ -441,6 +438,79 @@ class Legend(object):
                 color_mtx.append([black] * total_w)
         return color_mtx
 
+    def mesh_contours(self, mesh, tolerance):
+        """Get Polyline3Ds for contours of a Mesh3D associated with this legend's values.
+
+        Args:
+            mesh: A ladybug-geometry Mesh3D for which contours will be derived.
+                The number of faces or the number of vertices must match the
+                number of values associated with this Legend.
+            tolerance: The minimum difference between mesh vertices at which point
+                they are considered equivalent.
+
+        Returns:
+            A tuple with two elements.
+
+            -   contours -- A list of lists where each sub-list represents
+                contours associated with a specific threshold. Contours are
+                composed of Polyline3D and LineSegment3D.
+
+            -   thresholds -- list of numbers for the threshold value associated
+                with each contour. The length of this list matches the contours.
+        """
+        # check the input values and provide defaults
+        val_count = len(self.values)
+        face_match = val_count == len(mesh.faces)
+        assert face_match or val_count == len(mesh.vertices), \
+            'Number of values ({}) must match the number of mesh faces ({}) or ' \
+            'the number of mesh vertices ({}).'.format(
+                val_count, len(mesh.faces), len(mesh.vertices))
+
+        # figure out the thresholds to be used for the contour lines
+        min_val, max_val = self.legend_parameters.min, self.legend_parameters.max
+        if min_val == max_val:
+            return [], []  # no contours to be generated
+        thresholds = list(self.segment_numbers)
+        if self.is_max_default:
+            thresholds.pop(-1)  # no need to make a contour
+        if self.is_min_default:
+            thresholds.pop(0)  # no need to make a contour
+        if len(thresholds) == 0:  # ensure there is at least one threshold
+            thresholds = [(max_val + min_val) / 2]
+
+        # loop through the thresholds and generate contour lines
+        contours = []
+        init_naked_edges = mesh.naked_edges
+        for abs_thresh in thresholds:
+            # remove faces below the threshold
+            pattern = [val > abs_thresh for val in self.values]
+            if all(v for v in pattern):
+                contours.append([])
+                continue  # full mesh in contour; not a useful line
+            elif all(not v for v in pattern):
+                contours.append([])
+                continue  # none of the mesh lies in the contour; not a useful line
+            sub_mesh, _ = mesh.remove_faces(pattern) if face_match else \
+                mesh.remove_vertices(pattern)
+
+            # create the contour lines
+            contour_segs = []
+            for seg in sub_mesh.naked_edges:
+                for i_seg in init_naked_edges:
+                    if seg.p1.is_equivalent(i_seg.p1, tolerance) and \
+                            seg.p2.is_equivalent(i_seg.p2, tolerance):
+                        break
+                else:  # we have found a new segment for contouring
+                    contour_segs.append(seg)
+            polylines = Polyline3D.join_segments(contour_segs, tolerance)
+            final_contours = []
+            for cont in polylines:
+                if isinstance(cont, Polyline3D):
+                    cont = Polyline3D(cont.vertices, True)
+                final_contours.append(cont)
+            contours.append(final_contours)
+        return contours, thresholds
+
     def duplicate(self):
         """Return a copy of the current legend."""
         return self.__copy__()

{ladybug_core-0.44.31.dist-info → ladybug_core-0.44.33.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ladybug-core
-Version: 0.44.31
+Version: 0.44.33
 Summary: Python library to load, analyze and modify EnergyPlus Weather files (epw).
 Home-page: https://github.com/ladybug-tools/ladybug
 Author: Ladybug Tools
@@ -18,7 +18,7 @@ Classifier: Programming Language :: Python :: Implementation :: IronPython
 Classifier: Operating System :: OS Independent
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: ladybug-geometry==1.34.15
+Requires-Dist: ladybug-geometry==1.34.16
 Requires-Dist: click==7.1.2; python_version < "3.8"
 Requires-Dist: click==8.1.7; python_version >= "3.8"
 Dynamic: author

{ladybug_core-0.44.31.dist-info → ladybug_core-0.44.33.dist-info}/RECORD

@@ -20,7 +20,7 @@ ladybug/futil.py,sha256=S3ZuWu709AV7Q4k-giC-3xnlGkmrOEUcrz66f_hwAUI,11767
 ladybug/graphic.py,sha256=XaYKDk6BkffcCT_M3GC0Y7KJVLQ_CQk2EW7NOwg3Duw,11197
 ladybug/header.py,sha256=BuS7Ckw9pyUu3ybJrL8B3XY8UlZcclod3CewtqxEEjA,6730
 ladybug/hourlyplot.py,sha256=t9ZY3kR8JqbG80hNBRamg6VX_gc7oGEhKbG8rC0Nl4I,25737
-ladybug/legend.py,sha256=4D8n-T9G0CN2quHFU7ycQayFhKMF1VMohN1iWIGKl9w,84135
+ladybug/legend.py,sha256=bOd3mtZbYJ72yHZ_yXwPjgtHLg5181Kh2pBR4TbfZHM,87470
 ladybug/location.py,sha256=GroocAGIShURzvcnht4q9OMQ17fHFd5jNLV4BfUwwAQ,9122
 ladybug/logutil.py,sha256=xZe1x3QiJEfNtqFxx8bzQHXtONVyHHKhfQh-Hf9hifQ,2362
 ladybug/monthlychart.py,sha256=VO92IOMgjGoOk27WlThxMi3DOzLjifkOgI0cJ09srEw,54087
@@ -78,9 +78,9 @@ ladybug/datatype/volume.py,sha256=JIRBSgo7gx5GekZWffAchQJrCBjNKIRh5yBRVlCL2FE,29
 ladybug/datatype/volumeflowrate.py,sha256=3opIJ4UxTMVCmN9tjNONvTRDSkz7fJuRKOOr1f_6mfc,2982
 ladybug/datatype/volumeflowrateintensity.py,sha256=MuFwp7BHZP8Vh75ej_3-G1QYxBqDWtwIxvOd4Ub9iPI,2380
 ladybug/datatype/volumeheatcapacity.py,sha256=FYMFUkY36hytdz5nPpVCeiBL4q5LWEjyKwd4ZnjfWzM,2170
-ladybug_core-0.44.31.dist-info/licenses/LICENSE,sha256=hIahDEOTzuHCU5J2nd07LWwkLW7Hko4UFO__ffsvB-8,34523
-ladybug_core-0.44.31.dist-info/METADATA,sha256=MhMYze3DDnieRxGPZbYSKv7IqytgxvmVmVOfmI6UJSY,4354
-ladybug_core-0.44.31.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-ladybug_core-0.44.31.dist-info/entry_points.txt,sha256=FOtz9JWVLwG3LoBz-G7bIQmL1A-WDRoa2Ebbihq-gOg,45
-ladybug_core-0.44.31.dist-info/top_level.txt,sha256=A9J55WsdwQSng_Qf_6zf7N19flFS_DW4UrLzmFDPUuw,8
-ladybug_core-0.44.31.dist-info/RECORD,,
+ladybug_core-0.44.33.dist-info/licenses/LICENSE,sha256=hIahDEOTzuHCU5J2nd07LWwkLW7Hko4UFO__ffsvB-8,34523
+ladybug_core-0.44.33.dist-info/METADATA,sha256=1RYll8145yRALU5S2p_XFYSEVhwQYC-2Vg8nhqvoYDE,4354
+ladybug_core-0.44.33.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+ladybug_core-0.44.33.dist-info/entry_points.txt,sha256=FOtz9JWVLwG3LoBz-G7bIQmL1A-WDRoa2Ebbihq-gOg,45
+ladybug_core-0.44.33.dist-info/top_level.txt,sha256=A9J55WsdwQSng_Qf_6zf7N19flFS_DW4UrLzmFDPUuw,8
+ladybug_core-0.44.33.dist-info/RECORD,,