topologicpy 0.7.61__py3-none-any.whl → 0.7.63__py3-none-any.whl

topologicpy/Cluster.py

@@ -165,29 +165,50 @@ class Cluster():
         from topologicpy.Dictionary import Dictionary
         from topologicpy.Topology import Topology
         from topologicpy.Helper import Helper
+        import inspect
 
         if len(args) == 0:
-            print("Cluster.ByTopologies - Error: The input topologies parameter is an empty list. Returning None.")
+            if not silent:
+                print("Cluster.ByTopologies - Error: The input topologies parameter is an empty list. Returning None.")
+                curframe = inspect.currentframe()
+                calframe = inspect.getouterframes(curframe, 2)
+                print('caller name:', calframe[1][3])
             return None
         if len(args) == 1:
             topologies = args[0]
             if isinstance(topologies, list):
                 if len(topologies) == 0:
-                    print("Cluster.ByTopologies - Error: The input topologies parameter is an empty list. Returning None.")
+                    if not silent:
+                        print("Cluster.ByTopologies - Error: The input topologies parameter is an empty list. Returning None.")
+                        curframe = inspect.currentframe()
+                        calframe = inspect.getouterframes(curframe, 2)
+                        print('caller name:', calframe[1][3])
                     return None
                 else:
                     topologyList = [x for x in topologies if Topology.IsInstance(x, "Topology")]
                     if len(topologies) == 0:
-                        print("Cluster.ByTopologies - Error: The input topologies parameter does not contain any valid topologies. Returning None.")
+                        if not silent:
+                            print("Cluster.ByTopologies - Error: The input topologies parameter does not contain any valid topologies. Returning None.")
+                            curframe = inspect.currentframe()
+                            calframe = inspect.getouterframes(curframe, 2)
+                            print('caller name:', calframe[1][3])
                         return None
             else:
-                print("Cluster.ByTopologies - Warning: The input topologies parameter contains only one topology. Returning the same topology.")
+                if not silent:
+                    print("Cluster.ByTopologies - Warning: The input topologies parameter contains only one topology. Returning the same topology.")
+                    curframe = inspect.currentframe()
+                    calframe = inspect.getouterframes(curframe, 2)
+                    print('caller name:', calframe[1][3])
                 return topologies
         else:
             topologyList = Helper.Flatten(list(args))
             topologyList = [x for x in topologyList if Topology.IsInstance(x, "Topology")]
         if len(topologyList) == 0:
-            print("Cluster.ByTopologies - Error: The input parameters do not contain any valid topologies. Returning None.")
+            if not silent:
+                print("Cluster.ByTopologies - Error: The input parameters do not contain any valid topologies. Returning None.")
+                curframe = inspect.currentframe()
+                calframe = inspect.getouterframes(curframe, 2)
+                print('caller name:', calframe[1][3])
             return None
         cluster = topologic.Cluster.ByTopologies(topologyList, False) # Hook to Core
         dictionaries = []

topologicpy/Edge.py

@@ -293,7 +293,8 @@ class Edge():
         import inspect
 
         if len(args) == 0:
-            print("Edge.ByVertices - Error: The input vertices parameter is an empty list. Returning None.")
+            if not silent:
+                print("Edge.ByVertices - Error: The input vertices parameter is an empty list. Returning None.")
             return None
         if len(args) == 1:
             vertices = args[0]
@@ -1107,7 +1108,7 @@ class Edge():
         return Edge.Direction(normal_edge)
 
     @staticmethod
-    def NormalEdge(edge, length: float = 1.0, u: float = 0.5, angle: float = 0.0):
+    def NormalEdge(edge, length: float = 1.0, u: float = 0.5, angle: float = 0.0, tolerance: float = 0.0001, silent: bool = False):
         """
         Returns the normal (perpendicular) vector to the input edge as an edge.
 
@@ -1125,7 +1126,11 @@ class Edge():
         angle : float , optional
             The desired rotational offset angle in degrees for the normal edge. This rotates the normal edge
             by the angle value around the axis defined by the input edge. The default is 0.0.
-
+        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
         -------
         topologic_core.Edge
@@ -1153,8 +1158,13 @@ class Edge():
                 # Otherwise, calculate the normal by crossing with the Z-axis
                 z_axis = np.array([0, 0, 1])
                 normal_vector = np.cross(direction_vector, z_axis)
+
+            # Check if the normal vector is effectively zero before normalization
+            if np.isclose(norm(normal_vector), 0):
+                return normal_vector
             
-            normal_vector /= norm(normal_vector)  # Normalize the normal vector
+            # Normalize the normal vector
+            normal_vector /= norm(normal_vector)  
             return normal_vector
 
         def calculate_normal_line(start_vertex, end_vertex):
@@ -1168,10 +1178,12 @@ class Edge():
             return start_vertex, normal_end_vertex
 
         if not Topology.IsInstance(edge, "Edge"):
-            print("Edge.NormalEdge - Error: The input edge parameter is not a valid edge. Returning None.")
+            if not silent:
+                print("Edge.NormalEdge - Error: The input edge parameter is not a valid edge. Returning None.")
             return None
         if length <= 0.0:
-            print("Edge.NormalEdge - Error: The input length parameter is not a positive number greater than zero. Returning None.")
+            if not silent:
+                print("Edge.NormalEdge - Error: The input length parameter is not a positive number greater than zero. Returning None.")
             return None
 
         # Get start and end vertex coordinates
@@ -1186,10 +1198,13 @@ class Edge():
         ev = Vertex.ByCoordinates(list(normal_line_end))
         
         # Create an edge from the start to the end of the normal vector
-        normal_edge = Edge.ByVertices([sv, ev])
-
+        normal_edge = Edge.ByVertices([sv, ev], tolerance=tolerance, silent=silent)
+        if normal_edge == None:
+            if not silent:
+                print("Edge.NormalEdge - Error: Could not create edge. Returning None.")
+            return None
         # Set the length of the normal edge
-        normal_edge = Edge.SetLength(normal_edge, length, bothSides=False)
+        normal_edge = Edge.SetLength(normal_edge, length, bothSides=False, tolerance=tolerance)
 
         # Rotate the normal edge around the input edge by the specified angle
         edge_direction = Edge.Direction(edge)

topologicpy/Face.py

@@ -665,7 +665,7 @@ class Face():
         from topologicpy.Cluster import Cluster
         from topologicpy.Topology import Topology
         from topologicpy.Dictionary import Dictionary
-        import random
+        import inspect
 
         def triangulateWire(wire):
             wire = Topology.RemoveCollinearEdges(wire)
@@ -678,10 +678,16 @@ class Face():
         if not Topology.IsInstance(wire, "Wire"):
             if not silent:
                 print("Face.ByWire - Error: The input wire parameter is not a valid topologic wire. Returning None.")
+                curframe = inspect.currentframe()
+                calframe = inspect.getouterframes(curframe, 2)
+                print('caller name:', calframe[1][3])
             return None
         if not Wire.IsClosed(wire):
             if not silent:
                 print("Face.ByWire - Error: The input wire parameter is not a closed topologic wire. Returning None.")
+                curframe = inspect.currentframe()
+                calframe = inspect.getouterframes(curframe, 2)
+                print('caller name:', calframe[1][3])
             return None
         
         edges = Wire.Edges(wire)

topologicpy/Graph.py

@@ -8119,7 +8119,8 @@ class Graph:
              camera=[-1.25, -1.25, 1.25],
              center=[0, 0, 0], up=[0, 0, 1],
              projection="perspective",
-             tolerance=0.0001):
+             tolerance=0.0001,
+             silent=False):
         """
         Shows the graph using Plotly.
 
@@ -8218,9 +8219,10 @@ class Graph:
             The desired up vector. The default is [0, 0, 1].
         projection : str , optional
             The desired type of projection. The options are "orthographic" or "perspective". It is case insensitive. The default is "perspective"
-
         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
         -------
@@ -8234,7 +8236,7 @@ class Graph:
             print("Graph.Show - Error: The input graph is not a valid graph. Returning None.")
             return None
         
-        data= Plotly.DataByGraph(graph, sagitta=sagitta, absolute=absolute, sides=sides, vertexColor=vertexColor, vertexSize=vertexSize, vertexLabelKey=vertexLabelKey, vertexGroupKey=vertexGroupKey, vertexGroups=vertexGroups, showVertices=showVertices, showVertexLabels=showVertexLabels, showVertexLegend=showVertexLegend, edgeColor=edgeColor, edgeWidth=edgeWidth, edgeLabelKey=edgeLabelKey, edgeGroupKey=edgeGroupKey, edgeGroups=edgeGroups, showEdges=showEdges, showEdgeLabels=showEdgeLabels, showEdgeLegend=showEdgeLegend, colorScale=colorScale)
+        data= Plotly.DataByGraph(graph, sagitta=sagitta, absolute=absolute, sides=sides, vertexColor=vertexColor, vertexSize=vertexSize, vertexLabelKey=vertexLabelKey, vertexGroupKey=vertexGroupKey, vertexGroups=vertexGroups, showVertices=showVertices, showVertexLabels=showVertexLabels, showVertexLegend=showVertexLegend, edgeColor=edgeColor, edgeWidth=edgeWidth, edgeLabelKey=edgeLabelKey, edgeGroupKey=edgeGroupKey, edgeGroups=edgeGroups, showEdges=showEdges, showEdgeLabels=showEdgeLabels, showEdgeLegend=showEdgeLegend, colorScale=colorScale, silent=silent)
         fig = Plotly.FigureByData(data, width=width, height=height, xAxis=xAxis, yAxis=yAxis, zAxis=zAxis, axisSize=axisSize, backgroundColor=backgroundColor,
                                   marginLeft=marginLeft, marginRight=marginRight, marginTop=marginTop, marginBottom=marginBottom, tolerance=tolerance)
         Plotly.Show(fig, renderer=renderer, camera=camera, center=center, up=up, projection=projection)

topologicpy/Neo4j.py

@@ -42,8 +42,8 @@ class Neo4j:
 
         Parameters
         ----------
-        neo4jGraph : neo4j._sync.driver.BoltDriver
-            The input neo4j bolt driver.
+        neo4jGraph : neo4j._sync.driver.BoltDriver or neo4jGraph, neo4j._sync.driver.Neo4jDriver
+            The input neo4j driver.
         cypher : str, optional
             If set to a non-empty string, a Cypher query will be run on the neo4j graph database to return a sub-graph. Default is None.
         xMin : float, optional
@@ -164,8 +164,8 @@ class Neo4j:
 
         Returns
         -------
-        neo4j._sync.driver.BoltDriver
-            The returned neo4j bolt driver.
+        neo4j._sync.driver.BoltDriver or neo4jGraph, neo4j._sync.driver.Neo4jDriver
+            The returned neo4j driver.
 
         """
         return GraphDatabase.driver(url, auth=(username, password))
@@ -177,13 +177,13 @@ class Neo4j:
 
         Parameters
         ----------
-        neo4jGraph : neo4j._sync.driver.BoltDriver
-            The input neo4j bolt driver.
+        neo4jGraph : neo4j._sync.driver.BoltDriver or neo4jGraph, neo4j._sync.driver.Neo4jDriver
+            The input neo4j driver.
 
         Returns
         -------
-        neo4j._sync.driver.BoltDriver
-            The returned neo4j bolt driver.
+        neo4j._sync.driver.BoltDriver or neo4jGraph, neo4j._sync.driver.Neo4jDriver
+            The returned neo4j driver.
 
         """
         with neo4jGraph.session() as session:
@@ -223,8 +223,8 @@ class Neo4j:
 
         Parameters
         ----------
-        neo4jGraph : neo4j._sync.driver.BoltDriver
-            The input neo4j bolt driver.
+        neo4jGraph : neo4j._sync.driver.BoltDriver or neo4jGraph, neo4j._sync.driver.Neo4jDriver
+            The input neo4j driver.
         vertexLabelKey : str , optional
             The returned vertices are labelled according to the dictionary values stored under this key.
             If the vertexLabelKey does not exist, it will be created and the vertices are labelled numerically using the format defaultVertexLabel_XXX. The default is "label".
@@ -254,8 +254,8 @@ class Neo4j:
         
         Returns
         -------
-        neo4j._sync.driver.BoltDriver
-            The returned neo4j bolt driver.
+        neo4j._sync.driver.BoltDriver or neo4jGraph, neo4j._sync.driver.Neo4jDriver
+            The returned neo4j driver.
         
         """
         from topologicpy.Vertex import Vertex
@@ -279,7 +279,7 @@ class Neo4j:
 
             return sanitized
         
-        if not isinstance(neo4jGraph, neo4j._sync.driver.BoltDriver):
+        if not isinstance(neo4jGraph, neo4j._sync.driver.BoltDriver) and not isinstance(neo4jGraph, neo4j._sync.driver.Neo4jDriver):
             if not silent:
                 print("Neo4j.ByGraph - Error: The input neo4jGraph is not a valid neo4j graph. Returning None.")
             return None

topologicpy/Plotly.py

@@ -293,7 +293,8 @@ class Plotly:
                     showEdgeLabels: bool = False,
                     showEdgeLegend: bool = False,
                     colorScale: str = "viridis",
-                    mantissa: int = 6):
+                    mantissa: int = 6,
+                    silent: bool = False):
         """
         Creates plotly vertex and edge data from the input graph.
 
@@ -354,6 +355,9 @@ class Plotly:
             If set to True the edge legend will be drawn. Otherwise, it will not be drawn. The default is False.
         colorScale : str , optional
             The desired type of plotly color scales to use (e.g. "Viridis", "Plasma"). The default is "Viridis". For a full list of names, see https://plotly.com/python/builtin-colorscales/.
+        silent : bool , optional
+            If set to True, no error and warning messages are printed. Otherwise, they are. The default is False.
+        
         Returns
         -------
         list
@@ -446,11 +450,11 @@ class Plotly:
             if sagitta > 0:
                 for edge in edges:
                     d = Topology.Dictionary(edge)
-                    arc = Wire.ArcByEdge(edge, sagitta=sagitta, absolute=absolute, sides=sides, close=False)
+                    arc = Wire.ArcByEdge(edge, sagitta=sagitta, absolute=absolute, sides=sides, close=False, silent=silent)
                     if Topology.IsInstance(arc, "Wire"):
                         arc_edges = Topology.Edges(arc)
                         for arc_edge in arc_edges:
-                            arc_edge = Topology.SetDictionary(arc_edge, d)
+                            arc_edge = Topology.SetDictionary(arc_edge, d, silent=silent)
                             new_edges.append(arc_edge)
                     else:
                         new_edges.append(edge)

topologicpy/Topology.py

@@ -6252,7 +6252,7 @@ class Topology():
         return newTopology
 
     @staticmethod
-    def RemoveCollinearEdges(topology, angTolerance=0.1, tolerance=0.0001):
+    def RemoveCollinearEdges(topology, angTolerance: float = 0.1, tolerance: float = 0.0001, silent: bool = False):
         """
         Removes the collinear edges of the input topology
 
@@ -6264,6 +6264,8 @@ class Topology():
             The desired angular tolerance. The default is 0.1.
         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
         -------
@@ -6284,7 +6286,7 @@ class Topology():
         if Topology.IsInstance(topology, "Vertex") or Topology.IsInstance(topology, "Edge"): #Vertex or Edge or Cluster, return the original topology
             return return_topology
         elif Topology.IsInstance(topology, "Wire"):
-            return_topology = Wire.RemoveCollinearEdges(topology, angTolerance=angTolerance, tolerance=tolerance)
+            return_topology = Wire.RemoveCollinearEdges(topology, angTolerance=angTolerance, tolerance=tolerance, silent=silent)
             return return_topology
         elif Topology.IsInstance(topology, "Face"):
             return_topology = Face.RemoveCollinearEdges(topology, angTolerance=angTolerance, tolerance=tolerance)

topologicpy/Wire.py

@@ -206,7 +206,11 @@ class Wire():
             length = sagitta
         else:
             length = Edge.Length(edge)*sagitta
-        norm = Edge.NormalEdge(edge, length=length)
+        norm = Edge.NormalEdge(edge, length=length, silent=silent)
+        if norm == None:
+            if not silent:
+                print("Wire.ArcByEdge - Warning: Could not create an arc. Returning the original edge.")
+            return edge
         cv = Edge.EndVertex(norm)
         return Wire.Arc(sv, cv, ev, sides=sides, close=close)
     
@@ -467,15 +471,15 @@ class Wire():
                 print("Wire.ByOffset - Error: The input wire parameter is not a valid wire. Returning None.")
                 return None
         
-        temp_face = Face.ByWire(wire)
-        original_area = Face.Area(temp_face)
+        #temp_face = Face.ByWire(wire)
+        #original_area = Face.Area(temp_face)
         if reverse == True:
             fac = -1
         else:
             fac = 1
         origin = Topology.Centroid(wire)
         temp_vertices = [Topology.Vertices(wire)[0], Topology.Vertices(wire)[1], Topology.Centroid(wire)]
-        temp_face = Face.ByWire(Wire.ByVertices(temp_vertices, close=True))
+        temp_face = Face.ByWire(Wire.ByVertices(temp_vertices, close=True), silent=silent)
         temp_normal = Face.Normal(temp_face)
         flat_wire = Topology.Flatten(wire, direction=temp_normal, origin=origin)
         normal = Face.Normal(temp_face)
@@ -644,38 +648,204 @@ class Wire():
             if not Wire.IsManifold(return_wire) and bisectors == False:
                 if not silent:
                     print("Wire.ByOffset - Warning: The resulting wire is non-manifold, please check your offsets.")
-                    print("Wire.ByOffset - Warning: Pursuing a workaround, but it might take a longer to complete.")
+                    print("Wire.ByOffset - Warning: Pursuing a workaround, but it might take longer to complete.")
                 
                 #cycles = Wire.Cycles(return_wire, maxVertices = len(final_vertices))
                 temp_wire = Topology.SelfMerge(Cluster.ByTopologies(wire_edges))
                 cycles = Wire.Cycles(temp_wire, maxVertices = len(final_vertices))
-                distances = []
-                for cycle in cycles:
-                    cycle_centroid = Topology.Centroid(cycle)
-                    distance = Vertex.Distance(origin, cycle_centroid)
-                    distances.append(distance)
-                cycles = Helper.Sort(cycles, distances)
-                # Get the top three or less
-                cycles = cycles[:min(3, len(cycles))]
-                areas = [Face.Area(Face.ByWire(cycle)) for cycle in cycles]
-                cycles = Helper.Sort(cycles, areas)
-                return_cycle = Wire.Reverse(cycles[-1])
-                return_cycle = Wire.Simplify(return_cycle, tolerance=epsilon)
-                return_cycle = Wire.RemoveCollinearEdges(return_cycle)
-                sel_edges = []
-                for temp_edge in wire_edges:
-                    x = Topology.Centroid(temp_edge)
-                    d = Topology.Dictionary(temp_edge)
-                    x = Topology.SetDictionary(x, d, silent=True)
-                    sel_edges.append(x)
-                return_cycle = Topology.TransferDictionariesBySelectors(return_cycle, Topology.Vertices(return_wire), tranVertices=True, tolerance=tolerance, numWorkers=numWorkers)
-                return_cycle = Topology.TransferDictionariesBySelectors(return_cycle, sel_edges, tranEdges=True, tolerance=tolerance, numWorkers=numWorkers)
-                return_wire = return_cycle
+                if len(cycles) > 0:
+                    distances = []
+                    for cycle in cycles:
+                        cycle_centroid = Topology.Centroid(cycle)
+                        distance = Vertex.Distance(origin, cycle_centroid)
+                        distances.append(distance)
+                    cycles = Helper.Sort(cycles, distances)
+                    # Get the top three or less
+                    cycles = cycles[:min(3, len(cycles))]
+                    areas = [Face.Area(Face.ByWire(cycle)) for cycle in cycles]
+                    cycles = Helper.Sort(cycles, areas)
+                    return_cycle = Wire.Reverse(cycles[-1])
+                    test_cycle = Wire.Simplify(return_cycle, tolerance=epsilon)
+                    if Topology.IsInstance(test_cycle, "Wire"):
+                        return_cycle = test_cycle
+                    return_cycle = Wire.RemoveCollinearEdges(return_cycle, silent=silent)
+                    sel_edges = []
+                    for temp_edge in wire_edges:
+                        x = Topology.Centroid(temp_edge)
+                        d = Topology.Dictionary(temp_edge)
+                        x = Topology.SetDictionary(x, d, silent=True)
+                        sel_edges.append(x)
+                    return_cycle = Topology.TransferDictionariesBySelectors(return_cycle, Topology.Vertices(return_wire), tranVertices=True, tolerance=tolerance, numWorkers=numWorkers)
+                    return_cycle = Topology.TransferDictionariesBySelectors(return_cycle, sel_edges, tranEdges=True, tolerance=tolerance, numWorkers=numWorkers)
+                    return_wire = return_cycle
+
         return_wire = Topology.Unflatten(return_wire, direction=normal, origin=origin)
         if transferDictionaries == True:
             return_wire = Topology.SetDictionary(return_wire, Topology.Dictionary(wire), silent=True)
         return return_wire
 
+    @staticmethod
+    def ByOffsetArea(wire,
+                    area,
+                    offsetKey="offset",
+                    minOffsetKey="minOffset",
+                    maxOffsetKey="maxOffset",
+                    defaultMinOffset=0,
+                    defaultMaxOffset=1,
+                    maxIterations = 1,
+                    tolerance=0.0001,
+                    silent = False):
+        """
+        Creates an offset wire from the input wire based on the input area.
+
+        Parameters
+        ----------
+        wire : topologic_core.Wire
+            The input wire.
+        area : float
+            The desired area of the created wire.
+        offsetKey : str , optional
+            The edge dictionary key under which to store the offset value. The default is "offset".
+        minOffsetKey : str , optional
+            The edge dictionary key under which to find the desired minimum edge offset value. If a value cannot be found, the defaultMinOffset input parameter value is used instead. The default is "minOffset".
+        maxOffsetKey : str , optional
+            The edge dictionary key under which to find the desired maximum edge offset value. If a value cannot be found, the defaultMaxOffset input parameter value is used instead. The default is "maxOffset".
+        defaultMinOffset : float , optional
+            The desired minimum edge offset distance. The default is 0.
+        defaultMaxOffset : float , optional
+            The desired maximum edge offset distance. The default is 1.
+        maxIterations: int , optional
+            The desired maximum number of iterations to attempt to converge on a solution. The default is 1.
+        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
+        -------
+        topologic_core.Wire
+            The created wire.
+
+        """
+        from topologicpy.Wire import Wire
+        from topologicpy.Face import Face
+        from topologicpy.Topology import Topology
+        from topologicpy.Dictionary import Dictionary
+        import numpy as np
+        from scipy.optimize import minimize
+
+        def compute_offset_amounts(wire,
+                                area,
+                                offsetKey="offset",
+                                minOffsetKey="minOffset",
+                                maxOffsetKey="maxOffset",
+                                defaultMinOffset=0,
+                                defaultMaxOffset=1,
+                                maxIterations = 10000,
+                                maxTime = 10,
+                                tolerance=0.0001):
+            
+            initial_offsets = []
+            bounds = []
+            for edge in edges:
+                d = Topology.Dictionary(edge)
+                minOffset = Dictionary.ValueAtKey(d, minOffsetKey) or defaultMinOffset
+                maxOffset = Dictionary.ValueAtKey(d, maxOffsetKey) or defaultMaxOffset
+                # Initial guess: small negative offsets to shrink the polygon, within the constraints
+                initial_offsets.append((minOffset + maxOffset) / 2)
+                # Bounds based on the constraints for each edge
+                bounds.append((minOffset, maxOffset))
+
+            # Convert initial_offsets to np.array for efficiency
+            initial_offsets = np.array(initial_offsets)
+            iteration_count = [0]  # List to act as a mutable counter
+
+            def objective_function(offsets):
+                for i, edge in enumerate(edges):
+                    d = Topology.Dictionary(edge)
+                    d = Dictionary.SetValueAtKey(d, offsetKey, offsets[i])
+                    edge = Topology.SetDictionary(edge, d)
+                
+                # Offset the wire
+                new_wire = Wire.ByOffset(wire, offsetKey=offsetKey, silent=silent)
+                # Check for an illegal wire. In that case, return a very large loss value.
+                if not Topology.IsInstance(new_wire, "Wire"):
+                    return (float("inf"))
+                if not Wire.IsManifold(new_wire):
+                    return (float("inf"))
+                if not Wire.IsClosed(new_wire):
+                    return (float("inf"))
+                new_face = Face.ByWire(new_wire)
+                # Calculate the area of the new wire/face
+                new_area = Face.Area(new_face)
+                
+                # The objective is the difference between the target hole area and the actual hole area
+                # We want this difference to be as close to 0 as possible
+                loss = (new_area - area) ** 2
+                # If the loss is less than the tolerance, accept the result and return a loss of 0.
+                if loss < tolerance:
+                    return 0
+                # Otherwise, return the actual loss value.
+                return loss 
+            
+            # Callback function to track and display iteration number
+            def iteration_callback(xk):
+                iteration_count[0] += 1  # Increment the counter
+                if not silent:
+                    print(f"Wire.ByOffsetArea - Information: Iteration {iteration_count[0]}")
+            
+            # Use scipy optimization/minimize to find the correct offsets, respecting the min/max bounds
+            result = minimize(objective_function,
+                            initial_offsets,
+                            method = "Powell",
+                            bounds=bounds,
+                            options={ 'maxiter': maxIterations},
+                            callback=iteration_callback
+                            )
+
+            # Return the offsets
+            return result.x
+        
+        if not Topology.IsInstance(wire, "Wire"):
+            if not silent:
+                print("Wire.OffsetByArea - Error: The input wire parameter is not a valid wire. Returning None.")
+            return None
+        
+        if not Wire.IsManifold(wire):
+            if not silent:
+                print("Wire.OffsetByArea - Error: The input wire parameter is not a manifold wire. Returning None.")
+            return None
+        
+        if not Wire.IsClosed(wire):
+            if not silent:
+                print("Wire.OffsetByArea - Error: The input wire parameter is not a closed wire. Returning None.")
+            return None
+        
+        edges = Topology.Edges(wire)
+        # Compute the offset amounts
+        offsets = compute_offset_amounts(wire,
+                                area = area,
+                                offsetKey = offsetKey,
+                                minOffsetKey = minOffsetKey,
+                                maxOffsetKey = maxOffsetKey,
+                                defaultMinOffset = defaultMinOffset,
+                                defaultMaxOffset = defaultMaxOffset,
+                                maxIterations = maxIterations,
+                                tolerance = tolerance)
+        # Set the edge dictionaries correctly according to the specified offsetKey
+        for i, edge in enumerate(edges):
+            d = Topology.Dictionary(edge)
+            d = Dictionary.SetValueAtKey(d, offsetKey, offsets[i])
+            edge = Topology.SetDictionary(edge, d)
+                
+        # Offset the wire
+        return_wire = Wire.ByOffset(wire, offsetKey=offsetKey, silent=silent)
+        if not Topology.IsInstance(wire, "Wire"):
+            if not silent:
+                print("Wire.OffsetByArea - Error: Could not create the offset wire. Returning None.")
+            return None
+        return return_wire
+
     @staticmethod
     def ByVertices(vertices: list, close: bool = True, tolerance: float = 0.0001):
         """
@@ -1865,7 +2035,7 @@ class Wire():
         return status
     
     @staticmethod
-    def IsManifold(wire) -> bool:
+    def IsManifold(wire, silent: bool = False) -> bool:
         """
         Returns True if the input wire is manifold. Returns False otherwise. A manifold wire is one where its vertices have a degree of 1 or 2.
 
@@ -1873,6 +2043,8 @@ class Wire():
         ----------
         wire : topologic_core.Wire
             The input wire.
+        silent : bool , optional
+            If set to True, no error and warning messages are printed. Otherwise, they are. The default is False.
 
         Returns
         -------
@@ -1881,9 +2053,14 @@ class Wire():
         
         """
         from topologicpy.Vertex import Vertex
+        import inspect
 
         if not Topology.IsInstance(wire, "Wire"):
-            print("Wire.IsManifold - Error: The input wire parameter is not a valid topologic wire. Returning None.")
+            if not silent:
+                print("Wire.IsManifold - Error: The input wire parameter is not a valid topologic wire. Returning None.")
+                curframe = inspect.currentframe()
+                calframe = inspect.getouterframes(curframe, 2)
+                print('caller name:', calframe[1][3])
             return None
         
         vertices = Wire.Vertices(wire)
@@ -2574,7 +2751,7 @@ class Wire():
         return baseWire
     
     @staticmethod
-    def RemoveCollinearEdges(wire, angTolerance: float = 0.1, tolerance: float = 0.0001):
+    def RemoveCollinearEdges(wire, angTolerance: float = 0.1, tolerance: float = 0.0001, silent: bool = False):
         """
         Removes any collinear edges in the input wire.
 
@@ -2586,6 +2763,8 @@ class Wire():
             The desired angular tolerance. The default is 0.1.
         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
         -------
@@ -2598,6 +2777,7 @@ class Wire():
         from topologicpy.Wire import Wire
         from topologicpy.Cluster import Cluster
         from topologicpy.Topology import Topology
+        import inspect
         
         def cleanup(wire, tolerance):
             vertices = Topology.Vertices(wire)
@@ -2611,8 +2791,9 @@ class Wire():
                 ev = vertices[Vertex.Index(ev, vertices, tolerance=tolerance)]
                 if Vertex.Distance(sv, ev) > tolerance:
                     new_edges.append(Edge.ByVertices([sv,ev]))
-            new_wire = Topology.SelfMerge(Cluster.ByTopologies(new_edges), tolerance=tolerance)
-            return new_wire
+            if len(new_edges) > 0:
+                return Topology.SelfMerge(Cluster.ByTopologies(new_edges, silent=silent), tolerance=tolerance)
+            return wire
         
         def rce(wire, angTolerance=0.1):
             if not Topology.IsInstance(wire, "Wire"):
@@ -2641,6 +2822,13 @@ class Wire():
                 final_wire = Edge.ByStartVertexEndVertex(wire_verts[0], wire_verts[1], tolerance=tolerance, silent=True)
             return final_wire
         
+        if not Topology.IsInstance(wire, "Wire"):
+            if not silent:
+                print("Wire.RemoveCollinearEdges - Error: The input wire parameter is not a valid wire. Returning None.")
+                curframe = inspect.currentframe()
+                calframe = inspect.getouterframes(curframe, 2)
+                print('caller name:', calframe[1][3])
+            return None
         new_wire = cleanup(wire, tolerance=tolerance)
         if not Wire.IsManifold(new_wire):
             wires = Wire.Split(new_wire)
@@ -2661,7 +2849,7 @@ class Wire():
             else:
                 return wire
         elif len(returnWires) > 1:
-            returnWire = Topology.SelfMerge(Cluster.ByTopologies(returnWires))
+            returnWire = Topology.SelfMerge(Cluster.ByTopologies(returnWires, silent=silent))
             if Topology.IsInstance(returnWire, "Edge"):
                 return Wire.ByEdges([returnWire], tolerance=tolerance)
             elif Topology.IsInstance(returnWire, "Wire"):

topologicpy/version.py

@@ -1 +1 @@
-__version__ = '0.7.61'
+__version__ = '0.7.63'

{topologicpy-0.7.61.dist-info → topologicpy-0.7.63.dist-info}/METADATA

@@ -1,7 +1,7 @@
 Metadata-Version: 2.1
 Name: topologicpy
-Version: 0.7.61
-Summary: An Advanced Spatial Modelling and Analysis Software Library for Architecture, Engineering, and Construction.
+Version: 0.7.63
+Summary: An AI-Powered Spatial Modelling and Analysis Software Library for Architecture, Engineering, and Construction.
 Author-email: Wassim Jabi <wassim.jabi@gmail.com>
 License: MIT License
         

{topologicpy-0.7.61.dist-info → topologicpy-0.7.63.dist-info}/RECORD

@@ -3,34 +3,34 @@ topologicpy/Aperture.py,sha256=p9pUzTQSBWoUaDiug1V1R1hnEIEwYSXFg2t7iRAmNRY,2723
 topologicpy/BVH.py,sha256=dfVQyn5OPN1_50nusS0AxAcmUfqTzpl0vWT7RBEz-WM,12870
 topologicpy/Cell.py,sha256=_vEYx1kNc3JZJUCCS8nhLM_j8EV4SyZYt3DjNHNRoDw,107707
 topologicpy/CellComplex.py,sha256=YNmNkH6IUplM9f7agZQd6IL2xnHf5ds3JkGQk4jiSXQ,48029
-topologicpy/Cluster.py,sha256=TZXuxzdaUr6OHSWnjWpjCOMlVj6YHBH8aUVbDVsncVA,54999
+topologicpy/Cluster.py,sha256=P9hAtZQjPugnIRJcviQNFBbdDqpMFADJK87_tR0CIAI,56108
 topologicpy/Color.py,sha256=FrxX2yILqWvYrqD8kBaknfMfOR_phJOmhvTvFc07bY4,18065
 topologicpy/Context.py,sha256=ppApYKngZZCQBFWaxIMi2z2dokY23c935IDCBosxDAE,3055
 topologicpy/DGL.py,sha256=Dd6O08D-vSxpjHYgKm45JpKiaeGvWlg1BRMzYMAXGNc,138991
 topologicpy/Dictionary.py,sha256=cURg452wwk2WeSxWY46ncgAUo5XD1c2c5EtO6ESZHaY,27304
-topologicpy/Edge.py,sha256=7Mxu9w9AY8uEk-xJpwMlWkuAgK96YIvUo0jtS5xuPq0,66123
+topologicpy/Edge.py,sha256=FACD8Bm2nL2uTHIeRMVXfRF0cYeqhZ-lCZPHAfjAIPg,66927
 topologicpy/EnergyModel.py,sha256=NM3_nAdY9_YDtbp9CaEZ0x0xVsetTqVDzm_VSjmq_mI,53746
-topologicpy/Face.py,sha256=YjU6TxxW2Mf5InumMvzXUXVVRdtjxyRGauRIhGXzkao,116411
-topologicpy/Graph.py,sha256=NoHGYCCoCFP2nDLrzkM7x4hpemo6KiVeOq5Cm0BR78c,411204
+topologicpy/Face.py,sha256=OyzEWdXl8yScHlyG3jDqcI31d_QlAt3SDma8AtkLQFs,116746
+topologicpy/Graph.py,sha256=4b8bzlyXmh0Ef9rjiEjl8wmh_9vAxoE5xiSiGvGjG9Q,411392
 topologicpy/Grid.py,sha256=3-sn7CHWGcXk18XCnHjsUttNJTWwmN63g_Insj__p04,18218
 topologicpy/Helper.py,sha256=i-AfI29NMsZXBaymjilfvxQbuS3wpYbpPw4RWu1YCHs,16358
 topologicpy/Honeybee.py,sha256=Oc8mfGBNSjs6wxkPzCKmEw1ZPQPbp9XtiYWaAF62oSk,21893
 topologicpy/Matrix.py,sha256=umgR7An919-wGInXJ1wpqnoQ2jCPdyMe2rcWTZ16upk,8079
-topologicpy/Neo4j.py,sha256=BezQ-sdpU8B0W4X_kaF7alZrlN0-h4779HFrB3Fsn-w,22033
-topologicpy/Plotly.py,sha256=FeRneK3QfMdWZzwnr2lLWvFLQIjwuyq9ms-DghvuZnI,108134
+topologicpy/Neo4j.py,sha256=t52hgE9cVsqkGc7m7fjRsLnyfRHakVHwdvF4ms7ow78,22342
+topologicpy/Plotly.py,sha256=k-gluqX4Na3zlYCDl_6A0gqeFoGR-0Oy6fLiT-Zqlyk,108362
 topologicpy/Polyskel.py,sha256=EFsuh2EwQJGPLiFUjvtXmAwdX-A4r_DxP5hF7Qd3PaU,19829
 topologicpy/PyG.py,sha256=LU9LCCzjxGPUM31qbaJXZsTvniTtgugxJY7y612t4A4,109757
 topologicpy/Shell.py,sha256=joahFtpRQTWJpQOmi3qU4Xe0Sx2XXeayHlXTNx8CzMk,87610
 topologicpy/Speckle.py,sha256=rUS6PCaxIjEF5_fUruxvMH47FMKg-ohcoU0qAUb-yNM,14267
 topologicpy/Sun.py,sha256=42tDWMYpwRG7Z2Qjtp94eRgBuqySq7k8TgNUZDK7QxQ,36837
-topologicpy/Topology.py,sha256=5Vnn9oMEQ__ta_ew9XhnZExMPbHsj9QN91v-6pxdrJg,397934
+topologicpy/Topology.py,sha256=DsRPV0iWUY2NIlxdvLLDBkkDY3xw8oYvmzQEEfJUusQ,398136
 topologicpy/Vector.py,sha256=A1g83zDHep58iVPY8WQ8iHNrSOfGWFEzvVeDuMnjDNY,33078
 topologicpy/Vertex.py,sha256=bLY60YWoMsgCgHk7F7k9F93Sq2FJ6AzUcTfJ83NZfHA,71107
-topologicpy/Wire.py,sha256=rGLAwjd5p80rxvkOkcrE1MPXkU9oZ1iRK7n_wOTLbd0,162382
+topologicpy/Wire.py,sha256=x2ut3Pej3fTBv1nPzQMsJ8asWFy4WKIjrAUPA0boesU,171628
 topologicpy/__init__.py,sha256=D7ky87CAQMiS2KE6YLvcTLkTgA2PY7rASe6Z23pjp9k,872
-topologicpy/version.py,sha256=tiB10UwHe_W_etMVnPuXlVWgr8S2BBgwOuFocOXK4Nk,23
-topologicpy-0.7.61.dist-info/LICENSE,sha256=BRNw73R2WdDBICtwhI3wm3cxsaVqLTAGuRwrTltcfxs,1068
-topologicpy-0.7.61.dist-info/METADATA,sha256=Dcv499yRgltilHs2CTCeo3Ktv7lA4HOZWL8wsVT5Tpg,10918
-topologicpy-0.7.61.dist-info/WHEEL,sha256=GV9aMThwP_4oNCtvEC2ec3qUYutgWeAzklro_0m4WJQ,91
-topologicpy-0.7.61.dist-info/top_level.txt,sha256=J30bDzW92Ob7hw3zA8V34Jlp-vvsfIkGzkr8sqvb4Uw,12
-topologicpy-0.7.61.dist-info/RECORD,,
+topologicpy/version.py,sha256=MZJ0DcglO3LqgTS4xIW_NWvmDzvvzxd1VdjKOHudVIk,23
+topologicpy-0.7.63.dist-info/LICENSE,sha256=BRNw73R2WdDBICtwhI3wm3cxsaVqLTAGuRwrTltcfxs,1068
+topologicpy-0.7.63.dist-info/METADATA,sha256=EsGaYJ2wOBoqKTUUzAmNE_G0taxa5TW-Eg7UJzZqyYs,10920
+topologicpy-0.7.63.dist-info/WHEEL,sha256=GV9aMThwP_4oNCtvEC2ec3qUYutgWeAzklro_0m4WJQ,91
+topologicpy-0.7.63.dist-info/top_level.txt,sha256=J30bDzW92Ob7hw3zA8V34Jlp-vvsfIkGzkr8sqvb4Uw,12
+topologicpy-0.7.63.dist-info/RECORD,,