topologicpy 0.8.3__py3-none-any.whl → 0.8.4__py3-none-any.whl

topologicpy/Plotly.py

@@ -714,15 +714,6 @@ class Plotly:
             traces.append(trace)
         return traces
 
-
-
-
-
-
-
-
-
-
     @staticmethod
     def DataByTopology(topology,
                        showVertices=True,
@@ -1106,9 +1097,10 @@ class Plotly:
                 faceColor = Dictionary.ValueAtKey(d, key=faceColorKey) or faceColor
             if not faceOpacityKey == None:
                 d = Topology.Dictionary(topology)
-                d_opacity = Dictionary.ValueAtKey(d, key=faceOpacityKey) or faceOpacity
-                if 0 < d_opacity < 1:
-                    faceOpacity = d_opacity
+                d_opacity = Dictionary.ValueAtKey(d, key=faceOpacityKey)
+                if not d_opacity == None:
+                    if 0 <= d_opacity <= 1:
+                        faceOpacity = d_opacity
             if Topology.IsInstance(topology, "Face"):
                 tp_faces = [topology]
             else:

topologicpy/Topology.py

@@ -6602,9 +6602,9 @@ class Topology():
             return None
         return topologic.Topology.IsSame(topologyA, topologyB)
     
-    def IsVertexMatched(topologyA, topologyB, mantissa: int = 6, tolerance=0.0001, silent : bool = False):
+    def IsVertexCongruent(topologyA, topologyB, mantissa: int = 6, tolerance=0.0001, silent : bool = False):
         """
-        Returns True if the input topologies are vertex matched (have same number of vertices and all vertices are coincedent within a tolerance). Returns False otherwise.
+        Returns True if the input topologies are vertex matched (have same number of vertices and all vertices are congruent within a tolerance). Returns False otherwise.
 
         Parameters
         ----------
@@ -6622,7 +6622,7 @@ class Topology():
         Returns
         -------
         bool
-            True of the input topologies are vertex matched. False otherwise.
+            True of the input topologies are vertex congruent. False otherwise.
 
         """
         from topologicpy.Vertex import Vertex
@@ -6683,6 +6683,104 @@ class Topology():
         coords_b = [Vertex.Coordinates(v, mantissa=mantissa) for v in vertices_b]
         return coordinates_match(coords_a, coords_b, tolerance=tolerance)
 
+    @staticmethod
+    def LargestFaces(topology, removeCoplanarFaces: bool = False, epsilon: float = 0.001, tolerance: float = 0.0001, silent: bool = False):
+        """
+        Returns the list of the largest faces found in the input topology.
+
+        Parameters
+        ----------
+        topology : topologic_core.Topology
+            The input topology.
+        removeCoplanarFaces : bool , optional
+            If set to True, coplanar faces are removed to find the true largest faces. Otherwise they are not. The default is False.
+        epsilon : float , optional
+            The desired epsilon (another form of tolerance) for finding if two faces are coplanar. The default is 0.01.
+        tolerance : float , optional
+            The desired tolerance. The default is 0.0001.
+        silent : bool , optional
+            If set to True, no error and warning messages are printed. Otherwise, they are. The default is False.
+        Returns
+        -------
+        list
+            The list of the largest faces found in the input topology.
+        
+        """
+        from topologicpy.Face import Face
+
+        if not Topology.IsInstance(topology, "topology"):
+            if not silent:
+                print("Topology.LaregestFaces - Error: The input topology parameter is not a valid topology. Returning None.")
+            return None
+        faces = Topology.Faces(topology)
+        if len(faces) == 0:
+            if not silent:
+                print("Topology.LargestFaces - Error: The input topology parameter does not contain any faces. Returning None.")
+            return None
+        if len(faces) == 1:
+            return faces
+        
+        if removeCoplanarFaces == True:
+            simple_topology = Topology.RemoveCoplanarFaces(topology)
+            simple_topology = Topology.RemoveCollinearEdges(simple_topology)
+            faces = Topology.Faces(simple_topology)
+        face_areas = [Face.Area(face) for face in faces]
+        max_area = max(face_areas)
+        max_faces = []
+        for i, face_area in enumerate(face_areas):
+            if abs(max_area - face_area) < tolerance:
+                max_faces.append(faces[i])
+        return max_faces
+
+    @staticmethod
+    def LongestEdges(topology, removeCoplanarFaces: bool = False, epsilon: float = 0.001, tolerance: float = 0.0001, silent: bool = False):
+        """
+        Returns the list of the longest edges found in the input topology.
+
+        Parameters
+        ----------
+        topology : topologic_core.Topology
+            The input topology.
+        removeCoplanarFaces : bool , optional
+            If set to True, coplanar faces are removed to find the true longest straight edges. Otherwise they are not. The default is False.
+        epsilon : float , optional
+            The desired epsilon (another form of tolerance) for finding if two faces are coplanar. The default is 0.01.
+        tolerance : float , optional
+            The desired tolerance. The default is 0.0001.
+        silent : bool , optional
+            If set to True, no error and warning messages are printed. Otherwise, they are. The default is False.
+        Returns
+        -------
+        list
+            The list of of the longest edges found in the input topology.
+        
+        """
+        from topologicpy.Edge import Edge
+
+        if not Topology.IsInstance(topology, "topology"):
+            if not silent:
+                print("Topology.LongestEdges - Error: The input topology parameter is not a valid topology. Returning None.")
+            return None
+        edges = Topology.Edges(topology)
+        if len(edges) == 0:
+            if not silent:
+                print("Topology.LongestEdges - Error: The input topology parameter does not contain any edges. Returning None.")
+            return None
+        if len(edges) == 1:
+            return edges
+        
+        if removeCoplanarFaces == True:
+            simple_topology = Topology.RemoveCoplanarFaces(topology)
+            simple_topology = Topology.RemoveCollinearEdges(simple_topology)
+            edges = Topology.Edges(simple_topology)
+        edge_lengths = [Edge.Length(edge) for edge in edges]
+        max_length = max(edge_lengths)
+        max_edges = []
+        for i, edge_length in enumerate(edge_lengths):
+            if abs(max_length - edge_length) < tolerance:
+                max_edges.append(edges[i])
+        return max_edges
+
     @staticmethod
     def MergeAll(topologies, tolerance=0.0001):
         """
@@ -8172,7 +8270,6 @@ class Topology():
                 l = None
         return l
     
-    
     @staticmethod
     def SharedFaces(topologyA, topologyB):
         """
@@ -8199,7 +8296,56 @@ class Topology():
             except:
                 l = None
         return l
-    
+
+    @staticmethod
+    def ShortestEdges(topology, removeCoplanarFaces: bool = False, epsilon: float = 0.001, tolerance: float = 0.0001, silent: bool = False):
+        """
+        Returns the list of the shortest edges found in the input topology.
+
+        Parameters
+        ----------
+        topology : topologic_core.Topology
+            The input topology.
+        removeCoplanarFaces : bool , optional
+            If set to True, coplanar faces are removed to find the true shortest straight edges. Otherwise they are not. The default is False.
+        epsilon : float , optional
+            The desired epsilon (another form of tolerance) for finding if two faces are coplanar. The default is 0.01.
+        tolerance : float , optional
+            The desired tolerance. The default is 0.0001.
+        silent : bool , optional
+            If set to True, no error and warning messages are printed. Otherwise, they are. The default is False.
+        Returns
+        -------
+        list
+            The list of the shortest edges found in the input topology.
+        
+        """
+        from topologicpy.Edge import Edge
+
+        if not Topology.IsInstance(topology, "topology"):
+            if not silent:
+                print("Topology.ShortestEdges - Error: The input topology parameter is not a valid topology. Returning None.")
+            return None
+        edges = Topology.Edges(topology)
+        if len(edges) == 0:
+            if not silent:
+                print("Topology.ShortestEdges - Error: The input topology parameter does not contain any edges. Returning None.")
+            return None
+        if len(edges) == 1:
+            return edges[0]
+        
+        if removeCoplanarFaces == True:
+            simple_topology = Topology.RemoveCoplanarFaces(topology)
+            simple_topology = Topology.RemoveCollinearEdges(simple_topology)
+            edges = Topology.Edges(simple_topology)
+        edge_lengths = [Edge.Length(edge) for edge in edges]
+        min_length = min(edge_lengths)
+        min_edges = []
+        for i, edge_length in enumerate(edge_lengths):
+            if abs(min_length - edge_length) < tolerance:
+                min_edges.append(edges[i])
+        return min_edges
+
     @staticmethod
     def Show(*topologies,
              nameKey = "name",
@@ -8618,6 +8764,55 @@ class Topology():
             figure = Plotly.AddColorBar(figure, values=cbValues, nTicks=cbTicks, xPosition=cbX, width=cbWidth, outlineWidth=cbOutlineWidth, title=cbTitle, subTitle=cbSubTitle, units=cbUnits, colorScale=colorScale, mantissa=mantissa)
         Plotly.Show(figure=figure, renderer=renderer, camera=camera, center=center, up=up, projection=projection)
 
+    @staticmethod
+    def SmallestFaces(topology, removeCoplanarFaces: bool = False, epsilon: float = 0.001, tolerance: float = 0.0001, silent: bool = False):
+        """
+        Returns the list of the smallest faces found in the input topology.
+
+        Parameters
+        ----------
+        topology : topologic_core.Topology
+            The input topology.
+        removeCoplanarFaces : bool , optional
+            If set to True, coplanar faces are removed to find the true smallest faces. Otherwise they are not. The default is False.
+        epsilon : float , optional
+            The desired epsilon (another form of tolerance) for finding if two faces are coplanar. The default is 0.01.
+        tolerance : float , optional
+            The desired tolerance. The default is 0.0001.
+        silent : bool , optional
+            If set to True, no error and warning messages are printed. Otherwise, they are. The default is False.
+        Returns
+        -------
+        list
+            The list of the smallest faces found in the input topology.
+        
+        """
+        from topologicpy.Face import Face
+
+        if not Topology.IsInstance(topology, "topology"):
+            if not silent:
+                print("Topology.SmallestFaces - Error: The input topology parameter is not a valid topology. Returning None.")
+            return None
+        faces = Topology.Faces(topology)
+        if len(faces) == 0:
+            if not silent:
+                print("Topology.SmallestFaces - Error: The input topology parameter does not contain any faces. Returning None.")
+            return None
+        if len(faces) == 1:
+            return faces
+        
+        if removeCoplanarFaces == True:
+            simple_topology = Topology.RemoveCoplanarFaces(topology)
+            simple_topology = Topology.RemoveCollinearEdges(simple_topology)
+            faces = Topology.Faces(simple_topology)
+        face_areas = [Face.Area(face) for face in faces]
+        min_area = min(face_areas)
+        min_faces = []
+        for i, face_area in enumerate(face_areas):
+            if abs(min_area - face_area) < tolerance:
+                min_faces.append(faces[i])
+        return min_faces
+
     @staticmethod
     def SortBySelectors(topologies, selectors, exclusive=False, tolerance=0.0001):
         """

topologicpy/version.py

@@ -1 +1 @@
-__version__ = '0.8.3'
+__version__ = '0.8.4'

{topologicpy-0.8.3.dist-info → topologicpy-0.8.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: topologicpy
-Version: 0.8.3
+Version: 0.8.4
 Summary: An AI-Powered Spatial Modelling and Analysis Software Library for Architecture, Engineering, and Construction.
 Author-email: Wassim Jabi <wassim.jabi@gmail.com>
 License: AGPL v3 License
@@ -115,12 +115,12 @@ To cite one of the main papers that defines topologicpy, you can use:
 
 Or you can import the following .bib formatted references into your favourite reference manager
 ```
-@misc{Jabi2024,
+@misc{Jabi2025,
    author = {Wassim Jabi},
    doi = {https://doi.org/10.5281/zenodo.11555173},
    title = {topologicpy},
    url = {http://pypi.org/projects/topologicpy},
-   year = {2024},
+   year = {2025},
 }
 ```
 ```
@@ -140,6 +140,6 @@ Or you can import the following .bib formatted references into your favourite re
 }
 ```
 
-topologicpy: © 2024 Wassim Jabi
+topologicpy: © 2025 Wassim Jabi
 
-Topologic: © 2024 Cardiff University and UCL
+Topologic: © 2025 Cardiff University and UCL

{topologicpy-0.8.3.dist-info → topologicpy-0.8.4.dist-info}/RECORD

@@ -17,20 +17,20 @@ topologicpy/Helper.py,sha256=DAAE_Ie_ekeMnCvcW08xXRwSAGCkjrS4lbz-o3ELuY4,27172
 topologicpy/Honeybee.py,sha256=Y_El6M8x3ixvvIe_VcRiwj_4C89ZZg5_WlT7adbCkpw,21849
 topologicpy/Matrix.py,sha256=ydw0EH4rZcGBFeLmBHPIyuk57DVKKL3M1GcArkFsYxM,10941
 topologicpy/Neo4j.py,sha256=BKOF29fRgXmdpMGkrNzuYbyqgCJ6ElPPMYlfTxXiVbc,22392
-topologicpy/Plotly.py,sha256=Tvo0_zKVEHtPhsMNNvLy5G0HIys5FPAOyp_o4QN_I_A,115760
+topologicpy/Plotly.py,sha256=xfd_c2Mcam5KP-gDD-esl42RVXW5TSJsUCCqhUg1VFk,115788
 topologicpy/Polyskel.py,sha256=EFsuh2EwQJGPLiFUjvtXmAwdX-A4r_DxP5hF7Qd3PaU,19829
 topologicpy/PyG.py,sha256=LU9LCCzjxGPUM31qbaJXZsTvniTtgugxJY7y612t4A4,109757
 topologicpy/Shell.py,sha256=fLRnQ79vtdBDRW1Xn8Gaap34XheGbw7UBFd-ALJ2Y1g,87978
 topologicpy/Speckle.py,sha256=AlsGlSDuKRtX5jhVsPNSSjjbZis079HbUchDH_5RJmE,18187
 topologicpy/Sun.py,sha256=42tDWMYpwRG7Z2Qjtp94eRgBuqySq7k8TgNUZDK7QxQ,36837
-topologicpy/Topology.py,sha256=xbiMgnRrO_My5cHVMajsIuQYU81zsDy6C-7ZQgF5OFU,454552
+topologicpy/Topology.py,sha256=IHLJxh0TQ7P8Git4qfFDlvas81JXaKQGjxwgBzIX1T0,463367
 topologicpy/Vector.py,sha256=Cl7besf20cAGmyNPh-9gbFAHnRU5ZWSMChJ3VyFIDs4,35416
 topologicpy/Vertex.py,sha256=tv6C-rbuNgXHDGgVLT5fbalynLdXqlUuiCDKtkeQ0vk,77814
 topologicpy/Wire.py,sha256=Gl3Jpygwp8775SG57ua5r5ffTHcN4FOAkeI87yP1cok,234001
 topologicpy/__init__.py,sha256=vlPCanUbxe5NifC4pHcnhSzkmmYcs_UrZrTlVMsxcFs,928
-topologicpy/version.py,sha256=LokQdkRCwhhLh0zOp7jizhyDgbtAU-IWRIObrz2zLjA,22
-topologicpy-0.8.3.dist-info/LICENSE,sha256=FK0vJ73LuE8PYJAn7LutsReWR47-Ooovw2dnRe5yV6Q,681
-topologicpy-0.8.3.dist-info/METADATA,sha256=Alf593hRuyD3EdVldbGvB1qklfCWf2sDcSvktEhmHn8,10512
-topologicpy-0.8.3.dist-info/WHEEL,sha256=A3WOREP4zgxI0fKrHUG8DC8013e3dK3n7a6HDbcEIwE,91
-topologicpy-0.8.3.dist-info/top_level.txt,sha256=J30bDzW92Ob7hw3zA8V34Jlp-vvsfIkGzkr8sqvb4Uw,12
-topologicpy-0.8.3.dist-info/RECORD,,
+topologicpy/version.py,sha256=PtH7P3DXedvpK4LWSSxCTW38cmEXvmG6EvUpXZC-eLo,22
+topologicpy-0.8.4.dist-info/LICENSE,sha256=FK0vJ73LuE8PYJAn7LutsReWR47-Ooovw2dnRe5yV6Q,681
+topologicpy-0.8.4.dist-info/METADATA,sha256=WsO5JswYFeodLDlAb5Jv9TnaIhSl0z2ge2fhH-3hLpw,10512
+topologicpy-0.8.4.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+topologicpy-0.8.4.dist-info/top_level.txt,sha256=J30bDzW92Ob7hw3zA8V34Jlp-vvsfIkGzkr8sqvb4Uw,12
+topologicpy-0.8.4.dist-info/RECORD,,

{topologicpy-0.8.3.dist-info → topologicpy-0.8.4.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.7.0)
+Generator: setuptools (75.8.0)
 Root-Is-Purelib: true
 Tag: py3-none-any