topologicpy 0.8.23__py3-none-any.whl → 0.8.25__py3-none-any.whl

topologicpy/Graph.py

@@ -65,6 +65,20 @@ except:
     except:
         warnings.warn("Graph - Error: Could not import tqdm.")
 
+try:
+    from graphviz import Digraph
+except:
+    print("Graph - Installing required graphviz library.")
+    try:
+        os.system("pip install graphviz")
+    except:
+        os.system("pip install graphviz --user")
+    try:
+        from graphviz import Digraph
+        print("Graph - graphviz library installed correctly.")
+    except:
+        warnings.warn("Graph - Error: Could not import graphviz.")
+    
 GraphQueueItem = namedtuple('GraphQueueItem', ['edges'])
 
 class WorkerProcessPool(object):
@@ -264,6 +278,93 @@ class _DrawTree(object):
         return self.__str__()
 
 class Graph:
+
+    @staticmethod
+    def AccessibilityCentrality(graph, step: int = 2, normalize: bool = False, key: str = "accessibility_centrality", colorKey: str = "ac_color", colorScale: str = "viridis", mantissa: int = 6, tolerance: float = 0.0001, silent: bool = False):
+        """
+        Computes the accessibility centrality of each vertex in the graph using random walks of fixed step length.
+
+        Parameters
+        ----------
+        graph : topologic_core.Graph
+            The input graph.
+        step : int, optional
+            The length of the random walk (number of steps). Default is 2.
+        normalize : bool, optional
+            If True, normalize the output to the range 0 to 1. Default is False.
+        key : str, optional
+            Dictionary key to store the accessibility centrality value. Default is "accessibility_centrality".
+        colorKey : str, optional
+            Dictionary key to store the color value. Default is "ac_color".
+        colorScale : str, optional
+            Name of the Plotly color scale to use. Default is "viridis".
+        mantissa : int, optional
+            Decimal precision. Default is 6.
+        tolerance : float, optional
+            The desired Tolerance. Not used here but included for API compatibility. Default is 0.0001.
+        silent : bool, optional
+            If True, suppresses error/warning messages. Default is False.
+
+        Returns
+        -------
+        list
+            A list of accessibility centrality values for each vertex in the graph.
+        """
+        import numpy as np
+        from topologicpy.Graph import Graph
+        from topologicpy.Topology import Topology
+        from topologicpy.Dictionary import Dictionary
+        from topologicpy.Color import Color
+        from topologicpy.Helper import Helper
+
+        if not Topology.IsInstance(graph, "graph"):
+            if not silent:
+                print("Graph.AccessibilityCentrality - Error: The input graph paramter is not a valid Topologic Graph. Returning None.")
+            return None
+        vertices = Graph.Vertices(graph)
+        n = len(vertices)
+        if n == 0:
+            return []
+
+        # Step 1: get transition matrix (row-normalized adjacency matrix)
+        A = np.array(Graph.AdjacencyMatrix(graph), dtype=float)
+        row_sums = A.sum(axis=1, keepdims=True)
+        row_sums[row_sums == 0] = 1  # prevent division by zero
+        P = A / row_sums
+
+        # Step 2: walk matrix of length `step`
+        P_h = np.linalg.matrix_power(P, step)
+
+        # Step 3: compute entropy-based accessibility for each vertex
+        values = []
+        for i in range(n):
+            probs = P_h[i]
+            probs = probs[probs > 0]
+            entropy = -np.sum(probs * np.log(probs))
+            acc = np.exp(entropy)
+            values.append(float(acc))
+
+        # Optional normalization
+        if normalize == True:
+            if mantissa > 0: # We cannot round numbers from 0 to 1 with a mantissa = 0.
+                values = [round(v, mantissa) for v in Helper.Normalize(values)]
+            else:
+                values = Helper.Normalize(values)
+            min_value = 0
+            max_value = 1
+        else:
+            min_value = min(values)
+            max_value = max(values)
+        
+        # Assign Values and Colors to Dictionaries
+        for i, value in enumerate(values):
+            d = Topology.Dictionary(vertices[i])
+            color = Color.AnyToHex(Color.ByValueInRange(value, minValue=min_value, maxValue=max_value, colorScale=colorScale))
+            d = Dictionary.SetValuesAtKeys(d, [key, colorKey], [value, color])
+            vertices[i] = Topology.SetDictionary(vertices[i], d)
+
+        return values
+
     @staticmethod
     def AddEdge(graph, edge, transferVertexDictionaries: bool = False, transferEdgeDictionaries: bool = False, tolerance: float = 0.0001, silent: bool = False):
         """
@@ -1417,7 +1518,7 @@ class Graph:
         from topologicpy.Helper import Helper
 
         if weightKey:
-            if "len" in weightKey.lower() or "dis" in wireightKey.lower():
+            if "len" in weightKey.lower() or "dis" in weightKey.lower():
                 weightKey = "length"
         nx_graph = Graph.NetworkXGraph(graph)
         if "vert" in method.lower():
@@ -4379,12 +4480,14 @@ class Graph:
     
     @staticmethod
     def Compare(graphA, graphB,
+                weightAccessibilityCentrality: float = 0.0,
                 weightAttributes: float = 0.0,
                 weightGeometry: float = 0.0,
                 weightBetwennessCentrality: float = 0.0,
                 weightClosenessCentrality: float = 0.0,
                 weightDegreeCentrality: float = 0.0,
                 weightDiameter: float = 0.0,
+                weightEigenCentrality: float = 0.0,
                 weightGlobalClusteringCoefficient: float = 0.0,
                 weightPageRank: float = 0.0,
                 weightStructure: float = 0.0,
@@ -4406,6 +4509,8 @@ class Graph:
             The first input graph.
         graphB : topologic Graph
             The second input graph.
+        weightAccessibilityCentrality : float , optional
+            The desired weight for degree accessibility similarity (graph-level and node-level). Default is 0.0.
         weightAttributes : float , optional
             The desired weight for attribute similarity (dictionary key overlap at vertices). Default is 0.0.
         weightBetwennessCentrality : float , optional
@@ -4416,6 +4521,8 @@ class Graph:
             The desired weight for degree centrality similarity (graph-level and node-level). Default is 0.0.
         weightDiameter : float , optional
             The desired weight for diameter similarity (graph-level and node-level). Default is 0.0.
+        weightEigenCentrality : float , optional
+            The desired weight for eigen centrality similarity (graph-level and node-level). Default is 0.0.
         weightGeometry : float , optional
             The desired weight for geometric similarity (vertex positions). Default is 0.0.
         weightGlobalClusteringCoefficient : float , optional
@@ -4447,10 +4554,12 @@ class Graph:
         dict
             A dictionary of similarity scores between 0 (completely dissimilar) and 1 (identical), based on weighted components.
             The keys in the dictionary are:
+            "accessibility_centrality"
             "attribute"
             "betwenness_centrality"
             "closeness_centrality"
             "degree_centrality"
+            "eigen_centrality"
             "geometry"
             "global_clustering_coefficient"
             "jaccard"
@@ -4573,6 +4682,14 @@ class Graph:
         def safe_mean(lst):
                 return sum(lst)/len(lst) if lst else 0
         
+        def accessibility_centrality_similarity(graphA, graphB, mantissa=6):
+            v1 = safe_mean(Graph.AccessibilityCentrality(graphA))
+            v2 = safe_mean(Graph.AccessibilityCentrality(graphB))
+            if v1 == 0 and v2 == 0:
+                return 1
+            diff = abs(v1 - v2) / max(abs(v1), abs(v2), 1e-6)
+            return round((1 - diff), mantissa)
+        
         def betweenness_centrality_similarity(graphA, graphB, mantissa=6):
             v1 = safe_mean(Graph.BetweennessCentrality(graphA))
             v2 = safe_mean(Graph.BetweennessCentrality(graphB))
@@ -4605,6 +4722,14 @@ class Graph:
             diff = abs(v1 - v2) / max(abs(v1), abs(v2), 1e-6)
             return round((1 - diff), mantissa)
         
+        def eigen_centrality_similarity(graphA, graphB, mantissa=6):
+            v1 = safe_mean(Graph.EigenCentrality(graphA))
+            v2 = safe_mean(Graph.EigenCentrality(graphB))
+            if v1 == 0 and v2 == 0:
+                return 1
+            diff = abs(v1 - v2) / max(abs(v1), abs(v2), 1e-6)
+            return round((1 - diff), mantissa)
+        
         def global_clustering_coefficient_similarity(graphA, graphB, mantissa=6):
             v1 = Graph.GlobalClusteringCoefficient(graphA)
             v2 = Graph.GlobalClusteringCoefficient(graphB)
@@ -4675,23 +4800,26 @@ class Graph:
                 print("Graph.Compare - Error: The graphB input parameter is not a valid topologic graph. Returning None.")
             return 
         
-        total_weight = sum([weightAttributes,
+        total_weight = sum([weightAccessibilityCentrality,
+                            weightAttributes,
                             weightGeometry,
                             weightBetwennessCentrality,
                             weightClosenessCentrality,
                             weightDegreeCentrality,
                             weightDiameter,
+                            weightEigenCentrality,
                             weightGlobalClusteringCoefficient,
                             weightPageRank,
                             weightStructure,
                             weightWeisfeilerLehman,
                             weightJaccard])
-
+        accessibility_centrality_score = accessibility_centrality_similarity(graphA, graphB, mantissa=mantissa) if weightAccessibilityCentrality else 0
         attribute_score = attribute_similarity(graphA, graphB, mantissa=mantissa) if weightAttributes else 0
         betweenness_centrality_score = betweenness_centrality_similarity(graphA, graphB, mantissa=mantissa) if weightBetwennessCentrality else 0
         closeness_centrality_score = closeness_centrality_similarity(graphA, graphB, mantissa=mantissa) if weightClosenessCentrality else 0
         degree_centrality_score = degree_centrality_similarity(graphA, graphB, mantissa=mantissa) if weightDegreeCentrality else 0
         diameter_score = diameter_similarity(graphA, graphB, mantissa=mantissa) if weightDiameter else 0
+        eigen_centrality_score = eigen_centrality_similarity(graphA, graphB, mantissa=mantissa) if weightEigenCentrality else 0
         global_clustering_coefficient_score = global_clustering_coefficient_similarity(graphA, graphB, mantissa=mantissa) if weightGlobalClusteringCoefficient else 0
         geometry_score = geometry_similarity(graphA, graphB, mantissa=mantissa) if weightGeometry else 0
         jaccard_score = weighted_jaccard_similarity(graphA, graphB, vertexIDKey=vertexIDKey, edgeWeightKey=edgeWeightKey, mantissa=mantissa) if weightJaccard else 0
@@ -4700,11 +4828,13 @@ class Graph:
         weisfeiler_lehman_score = weisfeiler_lehman_similarity(graphA, graphB, iterations, mantissa=mantissa) if weightWeisfeilerLehman else 0
 
         weighted_sum = (
+            accessibility_centrality_score * weightAccessibilityCentrality +
             attribute_score * weightAttributes +
             betweenness_centrality_score * weightBetwennessCentrality +
             closeness_centrality_score * weightClosenessCentrality +
             degree_centrality_score * weightDegreeCentrality +
             diameter_score * weightDiameter +
+            eigen_centrality_score * weightEigenCentrality +
             geometry_score * weightGeometry +
             global_clustering_coefficient_score * weightGlobalClusteringCoefficient +
             jaccard_score * weightJaccard +
@@ -4719,10 +4849,12 @@ class Graph:
             overall_score = weighted_sum / total_weight
         
         return  {
+                 "accessibility_centrality": round(accessibility_centrality_score, mantissa),
                  "attribute": round(attribute_score, mantissa),
                  "betwenness_centrality": round(betweenness_centrality_score, mantissa),
                  "closeness_centrality": round(closeness_centrality_score, mantissa),
                  "degree_centrality": round(degree_centrality_score, mantissa),
+                 "eigen_centrality": round(eigen_centrality_score, mantissa),
                  "geometry": round(geometry_score, mantissa),
                  "global_clustering_coefficient": round(global_clustering_coefficient_score, mantissa),
                  "jaccard": round(jaccard_score, mantissa),
@@ -5073,7 +5205,7 @@ class Graph:
         Returns
         -------
         list
-            The betweenness centrality of the input list of vertices within the input graph. The values are in the range 0 to 1.
+            The closeness centrality of the input list of vertices within the input graph. The values are in the range 0 to 1.
 
         """
         import warnings
@@ -5566,7 +5698,7 @@ class Graph:
 
         """
         import numpy as np
-        adj_matrix = Graph.AdjacencyMatrix(g)
+        adj_matrix = Graph.AdjacencyMatrix(graph)
         np_adj_matrix = np.array(adj_matrix)
         degree_matrix = np.diag(np_adj_matrix.sum(axis=1))
         return degree_matrix.tolist()
@@ -5918,6 +6050,87 @@ class Graph:
         _ = graph.Edges(vertices, tolerance, edges) # Hook to Core
         return list(dict.fromkeys(edges)) # remove duplicates
     
+    @staticmethod
+    def EigenCentrality(graph, normalize: bool = False, key: str = "eigen_centrality", colorKey: str = "ec_color", colorScale: str = "viridis", mantissa: int = 6, tolerance: float = 0.0001, silent: bool = False):
+        """
+        Returns the eigenvector centrality of the input graph. The order of the returned list is the same as the order of vertices.
+
+        Parameters
+        ----------
+        graph : topologic_core.Graph
+            The input graph.
+        weightKey : str, optional
+            Ignored in this implementation. Reserved for future use if weighted adjacency matrix is desired.
+        normalize : bool, optional
+            If set to True, the centrality values are normalized to be in the range 0 to 1. The default is False.
+        key : str, optional
+            The desired dictionary key under which to store the eigenvector centrality score. The default is "eigen_centrality".
+        colorKey : str, optional
+            The desired dictionary key under which to store the eigenvector centrality color. The default is "ec_color".
+        colorScale : str, optional
+            The desired type of Plotly color scale to use (e.g., "viridis", "plasma"). Default is "viridis".
+            For a full list of names, see https://plotly.com/python/builtin-colorscales/.
+            Also supports color-blind friendly scales: "protanopia", "deuteranopia", "tritanopia".
+        mantissa : int, optional
+            The desired length of the mantissa. Default is 6.
+        tolerance : float, optional
+            The convergence tolerance for the power method. Default is 0.0001.
+        silent : bool, optional
+            If set to True, suppresses all messaging and warnings. Default is False.
+
+        Returns
+        -------
+        list
+            A list of eigenvector centrality values corresponding to the vertices in the input graph.
+        """
+        import numpy as np
+        from topologicpy.Graph import Graph
+        from topologicpy.Topology import Topology
+        from topologicpy.Dictionary import Dictionary
+        from topologicpy.Color import Color
+        from topologicpy.Helper import Helper
+
+        if not Topology.IsInstance(graph, "graph"):
+            if not silent:
+                print("Graph.EigenCentrality - Error: The input graph is not a valie Topologic Graph. Returning None.")
+            return None
+        adjacency_matrix = Graph.AdjacencyMatrix(graph)
+        vertices = Graph.Vertices(graph)
+        n = len(vertices)
+        if n == 0:
+            return []
+
+        values = np.ones(n)
+        for _ in range(100):
+            x_new = np.dot(adjacency_matrix, values)
+            norm = np.linalg.norm(x_new)
+            if norm == 0:
+                break
+            x_new = x_new / norm
+            if np.linalg.norm(values - x_new) < tolerance:
+                break
+            values = x_new
+        values = [float(x) for x in values]
+        if normalize == True:
+            if mantissa > 0: # We cannot round numbers from 0 to 1 with a mantissa = 0.
+                values = [round(v, mantissa) for v in Helper.Normalize(values)]
+            else:
+                values = Helper.Normalize(values)
+            min_value = 0
+            max_value = 1
+        else:
+            values = [round(v, mantissa) for v in values]
+            min_value = min(values)
+            max_value = max(values)
+
+        for i, value in enumerate(values):
+            d = Topology.Dictionary(vertices[i])
+            color = Color.AnyToHex(Color.ByValueInRange(value, minValue=min_value, maxValue=max_value, colorScale=colorScale))
+            d = Dictionary.SetValuesAtKeys(d, [key, colorKey], [value, color])
+            vertices[i] = Topology.SetDictionary(vertices[i], d)
+
+        return values
+
     @staticmethod
     def ExportToAdjacencyMatrixCSV(adjacencyMatrix, path):
         """
@@ -6125,7 +6338,7 @@ class Graph:
             format = "turtle"
             ext = ".ttl"
         n = len(ext)
-        # Make sure the file extension is .brep
+        # Make sure the file extension is .bot
         ext = path[len(path)-n:len(path)]
         if ext.lower() != ext:
             path = path+ext
@@ -6674,7 +6887,7 @@ class Graph:
         if not isinstance(path, str):
             print("Graph.ExportToGEXF - Error: the input path parameter is not a valid string. Returning None.")
             return None
-        # Make sure the file extension is .brep
+        # Make sure the file extension is .gexf
         ext = path[len(path)-5:len(path)]
         if ext.lower() != ".gexf":
             path = path+".gexf"
@@ -6869,6 +7082,243 @@ class Graph:
         create_gexf_file(nodes, edges, defaultEdgeType, node_attributes, edge_attributes, path)
         return True
 
+    @staticmethod
+    def ExportToGraphVizGraph(graph,
+                              path,
+                              device = 'svg_inline', deviceKey=None,
+                              scale = 1, scaleKey=None,
+                              directed=False, directedKey=None,
+        layout = 'dot', # or circo fdp neato nop nop1 nop2 osage patchwork sfdp twopi
+        layoutKey=None,
+        rankDir='TB', rankDirKey=None, # or LR, RL, BT
+        bgColor='white', bgColorKey=None,
+        fontName='Arial', fontNameKey=None,
+        fontSize= 12, fontSizeKey=None,
+        vertexSep= 0.5, vertexSepKey=None,
+        rankSep= 0.5, rankSepKey=None,
+        splines='True', splinesKey=None,
+        showGraphLabel = False,
+        graphLabel='', graphLabelKey=None,
+        graphLabelLoc='t', graphLabelLocKey=None,
+        showVertexLabel = False,
+        vertexLabelPrefix='' , vertexLabelKey=None,
+        vertexWidth=0.5, vertexWidthKey=None,
+        vertexHeight=0.5, vertexHeightKey=None,
+        vertexFixedSize=False, vertexFixedSizeKey=None,
+        vertexShape='circle', vertexShapeKey=None,
+        vertexStyle='filled', vertexStyleKey=None,
+        vertexFillColor='lightgray', vertexFillColorKey=None,
+        vertexColor='black', vertexColorKey=None,
+        vertexFontColor='black', vertexFontColorKey=None,
+        showEdgeLabel = False,
+        edgeLabelPrefix='', edgeLabelKey=None,
+        edgeColor='black', edgeColorKey=None,
+        edgeWidth=1, edgeWidthKey=None,
+        edgeStyle='solid', edgeStyleKey=None,
+        edgeArrowhead='normal', edgeArrowheadKey=None,
+        edgeFontColor='black', edgeFontColorKey=None,
+        overwrite=False,
+        silent=False):
+        """
+        Exports the input graph to a GraphViz `.gv` (dot) file.
+
+        Parameters
+        ----------
+        graph : topologic_core.Graph
+            The input graph.
+        path : str
+            The path to the output file (e.g., "output.gv").
+        device : str, optional
+            The output format device, such as 'svg_inline', 'pdf', or 'png'. The default is 'svg_inline'.
+        deviceKey : str, optional
+            Dictionary key to override the `device` value. Default is None.
+        scale : float, optional
+            Global scaling factor. Default is 1.
+        scaleKey : str, optional
+            Dictionary key to override the `scale` per-graph. Default is None.
+        directed : bool, optional
+            Whether to treat the graph as directed. Default is False.
+        directedKey : str, optional
+            Dictionary key to override the `directed` flag per-graph. Default is None.
+        layout : str, optional
+            Layout engine to use. Options include 'dot', 'circo', 'fdp', 'neato', 'osage', 'sfdp', etc. Default is 'dot'.
+        layoutKey : str, optional
+            Dictionary key to override the `layout` per-graph. Default is None.
+        rankDir : str, optional
+            Direction of graph ranking. Options: 'TB' (top-bottom), 'LR' (left-right), 'RL', 'BT'. Default is 'TB'.
+        rankDirKey : str, optional
+            Dictionary key to override `rankDir` per-graph. Default is None.
+        bgColor : str, optional
+            Background color. Default is 'white'.
+        bgColorKey : str, optional
+            Dictionary key to override `bgColor`. Default is None.
+        fontName : str, optional
+            Name of the font to use for all text. Default is 'Arial'.
+        fontNameKey : str, optional
+            Dictionary key to override `fontName`. Default is None.
+        fontSize : int or float, optional
+            Size of font in points. Default is 12.
+        fontSizeKey : str, optional
+            Dictionary key to override `fontSize`. Default is None.
+        vertexSep : float, optional
+            Minimum separation between vertices. Default is 0.5.
+        vertexSepKey : str, optional
+            Dictionary key to override `vertexSep`. Default is None.
+        rankSep : float, optional
+            Separation between ranks. Default is 0.5.
+        rankSepKey : str, optional
+            Dictionary key to override `rankSep`. Default is None.
+        splines : str, optional
+            Whether to use spline edges. Can be 'true', 'false', or 'polyline'. Default is 'True'.
+        splinesKey : str, optional
+            Dictionary key to override `splines`. Default is None.
+        showGraphLabel : bool, optional
+            Whether to show a label for the whole graph. Default is False.
+        graphLabel : str, optional
+            Text for the graph label. Default is an empty string.
+        graphLabelKey : str, optional
+            Dictionary key to override `graphLabel`. Default is None.
+        graphLabelLoc : str, optional
+            Position of the graph label: 't' (top), 'b' (bottom), 'c' (center). Default is 't'.
+        graphLabelLocKey : str, optional
+            Dictionary key to override `graphLabelLoc`. Default is None.
+        showVertexLabel : bool, optional
+            Whether to display vertex labels. Default is False.
+        vertexLabelPrefix : str, optional
+            Text prefix for vertex labels. Default is empty string.
+        vertexLabelKey : str, optional
+            Dictionary key used to retrieve label text from vertex dictionary. Default is None.
+        vertexWidth : float, optional
+            Width of each vertex. Default is 0.5.
+        vertexWidthKey : str, optional
+            Dictionary key to override `vertexWidth`. Default is None.
+        vertexHeight : float, optional
+            Height of each vertex. Default is 0.5.
+        vertexHeightKey : str, optional
+            Dictionary key to override `vertexHeight`. Default is None.
+        vertexFixedSize : bool, optional
+            Whether vertices should be fixed in size. Default is False.
+        vertexFixedSizeKey : str, optional
+            Dictionary key to override `vertexFixedSize`. Default is None.
+        vertexShape : str, optional
+            Shape of the vertex ('circle', 'ellipse', 'box', etc.). Default is 'circle'.
+        vertexShapeKey : str, optional
+            Dictionary key to override `vertexShape`. Default is None.
+        vertexStyle : str, optional
+            Style of vertex (e.g., 'filled', 'dashed'). Default is 'filled'.
+        vertexStyleKey : str, optional
+            Dictionary key to override `vertexStyle`. Default is None.
+        vertexFillColor : str, optional
+            Fill color for vertices. Default is 'lightgray'.
+        vertexFillColorKey : str, optional
+            Dictionary key to override `vertexFillColor`. Default is None.
+        vertexColor : str, optional
+            Border color for vertices. Default is 'black'.
+        vertexColorKey : str, optional
+            Dictionary key to override `vertexColor`. Default is None.
+        vertexFontColor : str, optional
+            Font color for vertex labels. Default is 'black'.
+        vertexFontColorKey : str, optional
+            Dictionary key to override `vertexFontColor`. Default is None.
+        showEdgeLabel : bool, optional
+            Whether to display edge labels. Default is False.
+        edgeLabelPrefix : str, optional
+            Text prefix for edge labels. Default is empty string.
+        edgeLabelKey : str, optional
+            Dictionary key used to retrieve label text from edge dictionary. Default is None.
+        edgeColor : str, optional
+            Color of edges. Default is 'black'.
+        edgeColorKey : str, optional
+            Dictionary key to override `edgeColor`. Default is None.
+        edgeWidth : float, optional
+            Width (thickness) of edges. Default is 1.
+        edgeWidthKey : str, optional
+            Dictionary key to override `edgeWidth`. Default is None.
+        edgeStyle : str, optional
+            Style of the edge line (e.g., 'solid', 'dashed'). Default is 'solid'.
+        edgeStyleKey : str, optional
+            Dictionary key to override `edgeStyle`. Default is None.
+        edgeArrowhead : str, optional
+            Arrowhead style for directed edges. Default is 'normal'.
+        edgeArrowheadKey : str, optional
+            Dictionary key to override `edgeArrowhead`. Default is None.
+        edgeFontColor : str, optional
+            Font color for edge labels. Default is 'black'.
+        edgeFontColorKey : str, optional
+            Dictionary key to override `edgeFontColor`. Default is None.
+        overwrite : bool, optional
+            If True, overwrites existing files at the given path. Default is False.
+        silent : bool, optional
+            If True, suppresses console output. Default is False.
+
+        Returns
+        -------
+        bool
+            True if the graph was successfully exported. False otherwise.
+        """
+
+        from topologicpy.Topology import Topology
+        from os.path import exists
+        dot = Graph.GraphVizGraph(
+        graph,
+        device = device, deviceKey = deviceKey,
+        scale = scale, scaleKey = scaleKey,
+        directed = directed, directedKey = directedKey,
+        layout = layout,
+        layoutKey = layoutKey,
+        rankDir= rankDir, rankDirKey = rankDirKey,
+        bgColor=bgColor, bgColorKey=bgColorKey,
+        fontName=fontName, fontNameKey=fontNameKey,
+        fontSize= fontSize, fontSizeKey=fontSizeKey,
+        vertexSep= vertexSep, vertexSepKey=vertexSepKey,
+        rankSep= rankSep, rankSepKey=rankSepKey,
+        splines=splines, splinesKey=splinesKey,
+        showGraphLabel = showGraphLabel,
+        graphLabel=graphLabel, graphLabelKey=graphLabelKey,
+        graphLabelLoc=graphLabelLoc, graphLabelLocKey=graphLabelLocKey,
+
+        showVertexLabel = showVertexLabel,
+        vertexLabelPrefix=vertexLabelPrefix , vertexLabelKey=vertexLabelKey,
+        vertexWidth=vertexWidth, vertexWidthKey=vertexWidthKey,
+        vertexHeight=vertexHeight, vertexHeightKey=vertexHeightKey,
+        vertexFixedSize=vertexFixedSize, vertexFixedSizeKey=vertexFixedSizeKey,
+        vertexShape=vertexShape, vertexShapeKey=vertexShapeKey,
+        vertexStyle=vertexStyle, vertexStyleKey=vertexStyleKey,
+        vertexFillColor=vertexFillColor, vertexFillColorKey=vertexFillColorKey,
+        vertexColor=vertexColor, vertexColorKey=vertexColorKey,
+        vertexFontColor=vertexFontColor, vertexFontColorKey=vertexFontColorKey,
+
+        showEdgeLabel = showEdgeLabel,
+        edgeLabelPrefix=edgeLabelPrefix, edgeLabelKey=edgeLabelKey,
+        edgeColor=edgeColor, edgeColorKey=edgeColorKey,
+        edgeWidth=edgeWidth, edgeWidthKey=edgeWidthKey,
+        edgeStyle=edgeStyle, edgeStyleKey=edgeStyleKey,
+        edgeArrowhead=edgeArrowhead, edgeArrowheadKey=edgeArrowheadKey,
+        edgeFontColor=edgeFontColor, edgeFontColorKey=edgeFontColorKey,
+        silent=silent)
+
+        if not Topology.IsInstance(graph, "Graph"):
+            if not silent:
+                print("Graph.ExportToGraphVizGraph - Error: the input graph parameter is not a valid graph. Returning None.")
+            return None
+        if not isinstance(path, str):
+            if not silent:
+                print("Graph.ExportToGraphVizGraph - Error: the input path parameter is not a valid string. Returning None.")
+            return None
+        # Make sure the file extension is .gv
+        ext = path[len(path)-3:len(path)]
+        if ext.lower() != ".gv":
+            path = path+".gv"
+        if not overwrite and exists(path):
+            if not silent:
+                print("Graph.ExportToGraphVizGraph - Error: a file already exists at the specified path and overwrite is set to False. Returning None.")
+            return None
+        try:
+            dot.save(filename=path)
+            return True
+        except:
+            return False
+
     @staticmethod
     def ExportToJSON(graph, path, verticesKey="vertices", edgesKey="edges", vertexLabelKey="", edgeLabelKey="", xKey="x", yKey="y", zKey="z", indent=4, sortKeys=False, mantissa=6, overwrite=False):
         """
@@ -8187,6 +8637,287 @@ class Graph:
         adjacency_matrix = Graph.AdjacencyMatrix(graph)
         return global_clustering_coefficient(adjacency_matrix)
     
+    @staticmethod
+    def GraphVizGraph(
+        graph,
+        device = 'svg_inline', deviceKey=None,
+        scale = 1, scaleKey=None,
+        directed=False, directedKey=None,
+        layout = 'dot', # or circo fdp neato nop nop1 nop2 osage patchwork sfdp twopi
+        layoutKey=None,
+        rankDir='TB', rankDirKey=None, # or LR, RL, BT
+        bgColor='white', bgColorKey=None,
+        fontName='Arial', fontNameKey=None,
+        fontSize= 12, fontSizeKey=None,
+        vertexSep= 0.5, vertexSepKey=None,
+        rankSep= 0.5, rankSepKey=None,
+        splines='true', splinesKey=None,
+        showGraphLabel = False,
+        graphLabel='', graphLabelKey=None,
+        graphLabelLoc='t', graphLabelLocKey=None,
+
+        showVertexLabel = False,
+        vertexLabelPrefix='' , vertexLabelKey=None,
+        vertexWidth=0.5, vertexWidthKey=None,
+        vertexHeight=0.5, vertexHeightKey=None,
+        vertexFixedSize=False, vertexFixedSizeKey=None,
+        vertexShape='circle', vertexShapeKey=None,
+        vertexStyle='filled', vertexStyleKey=None,
+        vertexFillColor='lightgray', vertexFillColorKey=None,
+        vertexColor='black', vertexColorKey=None,
+        vertexFontColor='black', vertexFontColorKey=None,
+
+        showEdgeLabel = False,
+        edgeLabelPrefix='', edgeLabelKey=None,
+        edgeColor='black', edgeColorKey=None,
+        edgeWidth=1, edgeWidthKey=None,
+        edgeStyle='solid', edgeStyleKey=None,
+        edgeArrowhead='normal', edgeArrowheadKey=None,
+        edgeFontColor='black', edgeFontColorKey=None,
+        silent=False
+    ):
+        """
+        Converts the input graph to a GraphViz graph. GraphViz should be installed separately, using your system's package manager.
+
+        Parameters
+        ----------
+        graph : topologic_core.Graph
+            The input graph.
+        device : str, optional
+            The output format device, such as 'svg_inline', 'pdf', or 'png'. The default is 'svg_inline'.
+        deviceKey : str, optional
+            Dictionary key to override the `device` value. Default is None.
+        scale : float, optional
+            Global scaling factor. Default is 1.
+        scaleKey : str, optional
+            Dictionary key to override the `scale` per-graph. Default is None.
+        directed : bool, optional
+            Whether to treat the graph as directed. Default is False.
+        directedKey : str, optional
+            Dictionary key to override the `directed` flag per-graph. Default is None.
+        layout : str, optional
+            Layout engine to use. Options include 'dot', 'circo', 'fdp', 'neato', 'osage', 'sfdp', etc. Default is 'dot'.
+        layoutKey : str, optional
+            Dictionary key to override the `layout` per-graph. Default is None.
+        rankDir : str, optional
+            Direction of graph ranking. Options: 'TB' (top-bottom), 'LR' (left-right), 'RL', 'BT'. Default is 'TB'.
+        rankDirKey : str, optional
+            Dictionary key to override `rankDir` per-graph. Default is None.
+        bgColor : str, optional
+            Background color. Default is 'white'.
+        bgColorKey : str, optional
+            Dictionary key to override `bgColor`. Default is None.
+        fontName : str, optional
+            Name of the font to use for all text. Default is 'Arial'.
+        fontNameKey : str, optional
+            Dictionary key to override `fontName`. Default is None.
+        fontSize : int or float, optional
+            Size of font in points. Default is 12.
+        fontSizeKey : str, optional
+            Dictionary key to override `fontSize`. Default is None.
+        vertexSep : float, optional
+            Minimum separation between vertices. Default is 0.5.
+        vertexSepKey : str, optional
+            Dictionary key to override `vertexSep`. Default is None.
+        rankSep : float, optional
+            Separation between ranks. Default is 0.5.
+        rankSepKey : str, optional
+            Dictionary key to override `rankSep`. Default is None.
+        splines : str, optional
+            Whether to use spline edges. Can be 'true', 'false', or 'polyline'. Default is 'True'.
+        splinesKey : str, optional
+            Dictionary key to override `splines`. Default is None.
+        showGraphLabel : bool, optional
+            Whether to show a label for the whole graph. Default is False.
+        graphLabel : str, optional
+            Text for the graph label. Default is an empty string.
+        graphLabelKey : str, optional
+            Dictionary key to override `graphLabel`. Default is None.
+        graphLabelLoc : str, optional
+            Position of the graph label: 't' (top), 'b' (bottom), 'c' (center). Default is 't'.
+        graphLabelLocKey : str, optional
+            Dictionary key to override `graphLabelLoc`. Default is None.
+        showVertexLabel : bool, optional
+            Whether to display vertex labels. Default is False.
+        vertexLabelPrefix : str, optional
+            Text prefix for vertex labels. Default is empty string.
+        vertexLabelKey : str, optional
+            Dictionary key used to retrieve label text from vertex dictionary. Default is None.
+        vertexWidth : float, optional
+            Width of each vertex. Default is 0.5.
+        vertexWidthKey : str, optional
+            Dictionary key to override `vertexWidth`. Default is None.
+        vertexHeight : float, optional
+            Height of each vertex. Default is 0.5.
+        vertexHeightKey : str, optional
+            Dictionary key to override `vertexHeight`. Default is None.
+        vertexFixedSize : bool, optional
+            Whether vertices should be fixed in size. Default is False.
+        vertexFixedSizeKey : str, optional
+            Dictionary key to override `vertexFixedSize`. Default is None.
+        vertexShape : str, optional
+            Shape of the vertex ('circle', 'ellipse', 'box', etc.). Default is 'circle'.
+        vertexShapeKey : str, optional
+            Dictionary key to override `vertexShape`. Default is None.
+        vertexStyle : str, optional
+            Style of vertex (e.g., 'filled', 'dashed'). Default is 'filled'.
+        vertexStyleKey : str, optional
+            Dictionary key to override `vertexStyle`. Default is None.
+        vertexFillColor : str, optional
+            Fill color for vertices. Default is 'lightgray'.
+        vertexFillColorKey : str, optional
+            Dictionary key to override `vertexFillColor`. Default is None.
+        vertexColor : str, optional
+            Border color for vertices. Default is 'black'.
+        vertexColorKey : str, optional
+            Dictionary key to override `vertexColor`. Default is None.
+        vertexFontColor : str, optional
+            Font color for vertex labels. Default is 'black'.
+        vertexFontColorKey : str, optional
+            Dictionary key to override `vertexFontColor`. Default is None.
+        showEdgeLabel : bool, optional
+            Whether to display edge labels. Default is False.
+        edgeLabelPrefix : str, optional
+            Text prefix for edge labels. Default is empty string.
+        edgeLabelKey : str, optional
+            Dictionary key used to retrieve label text from edge dictionary. Default is None.
+        edgeColor : str, optional
+            Color of edges. Default is 'black'.
+        edgeColorKey : str, optional
+            Dictionary key to override `edgeColor`. Default is None.
+        edgeWidth : float, optional
+            Width (thickness) of edges. Default is 1.
+        edgeWidthKey : str, optional
+            Dictionary key to override `edgeWidth`. Default is None.
+        edgeStyle : str, optional
+            Style of the edge line (e.g., 'solid', 'dashed'). Default is 'solid'.
+        edgeStyleKey : str, optional
+            Dictionary key to override `edgeStyle`. Default is None.
+        edgeArrowhead : str, optional
+            Arrowhead style for directed edges. Default is 'normal'.
+        edgeArrowheadKey : str, optional
+            Dictionary key to override `edgeArrowhead`. Default is None.
+        edgeFontColor : str, optional
+            Font color for edge labels. Default is 'black'.
+        edgeFontColorKey : str, optional
+            Dictionary key to override `edgeFontColor`. Default is None.
+        overwrite : bool, optional
+            If True, overwrites existing files at the given path. Default is False.
+        silent : bool, optional
+            If True, suppresses console output. Default is False.
+
+        Returns
+        -------
+        graphviz.graphs.Graph
+            The created GraphViz graph.
+        """
+
+        from graphviz import Digraph
+        from graphviz import Graph as Udgraph
+        from topologicpy.Graph import Graph
+        from topologicpy.Topology import Topology
+        from topologicpy.Dictionary import Dictionary
+
+        if not Topology.IsInstance(graph, "Graph"):
+            if not silent:
+                print("Graph.GraphVizGraph - Error: the input graph parameter is not a valid graph. Returning None.")
+            return None
+        # Set Graph-level attributes
+        def get_attr(dict, keyName, default):
+            if keyName:
+                return Dictionary.ValueAtKey(dict, keyName, default)
+            return default
+
+        graph_dict = Topology.Dictionary(graph)
+
+        is_directed =  get_attr(graph_dict, directedKey, directed)
+        if is_directed:
+            gv_graph = Digraph()
+        else:
+            gv_graph = Udgraph()
+        
+        if showGraphLabel:
+            label_value = get_attr(graph_dict, graphLabelKey, graphLabel)
+        else:
+            label_value = ''
+        gv_graph.attr(
+            layout = get_attr(graph_dict, layoutKey, layout),
+            rankdir=get_attr(graph_dict, rankDirKey, rankDir),
+            bgcolor=get_attr(graph_dict, bgColorKey, bgColor),
+            fontname=get_attr(graph_dict, fontNameKey, fontName),
+            fontsize=get_attr(graph_dict, fontSizeKey, str(fontSize)),
+            vertexsep=get_attr(graph_dict, vertexSepKey, str(vertexSep)),
+            ranksep=get_attr(graph_dict, rankSepKey, str(rankSep)),
+            splines=get_attr(graph_dict, splinesKey, splines),
+            label=label_value,
+            labelloc=get_attr(graph_dict, graphLabelLocKey, graphLabelLoc),
+            device = get_attr(graph_dict, deviceKey, device)
+        )
+
+        # Get the Vertices and Edges from the Topologic Graph
+        mesh_data = Graph.MeshData(graph)
+
+        # Set Vertex Attributes
+        verts = mesh_data['vertices']
+        vert_dicts = mesh_data['vertexDictionaries']
+        for i, v in enumerate(verts):
+            v_dict = vert_dicts[i]
+            if showVertexLabel:
+                label_value = get_attr(v_dict, vertexLabelKey, f"{vertexLabelPrefix}{i}")
+            else:
+                label_value = ''
+            
+            fixed_size_value = get_attr(v_dict, vertexFixedSizeKey, vertexFixedSize)
+
+            if fixed_size_value:
+                fixed_size_value = "True"
+            else:
+                fixed_size_value = "False"
+            
+            if "nop" in get_attr(graph_dict, layoutKey, layout):
+                pos_value = f"{v[0]*scale},{v[1]*scale}!"
+            else:
+                pos_value = ""
+            gv_graph.node(
+                str(i),
+                pos = pos_value,
+                label= label_value,
+                shape=get_attr(v_dict, vertexShapeKey, vertexShape),
+                width=str(get_attr(v_dict, vertexWidthKey, vertexWidth)),
+                height=str(get_attr(v_dict, vertexHeightKey, vertexHeight)),
+                fixedSize=fixed_size_value,
+                style=get_attr(v_dict, vertexStyleKey, vertexStyle),
+                fillcolor=get_attr(v_dict, vertexFillColorKey, vertexFillColor),
+                color=get_attr(v_dict, vertexColorKey, vertexColor),
+                fontcolor=get_attr(v_dict, vertexFontColorKey, vertexFontColor)
+            )
+        
+        # Set Edge attributes
+        edges = mesh_data['edges']
+        edge_dicts = mesh_data['edgeDictionaries']
+        for i, e in enumerate(edges):
+            sid = e[0]
+            eid = e[1]
+
+            e_dict = edge_dicts[i]
+            if showEdgeLabel:
+                label_value = get_attr(e_dict, edgeLabelKey, f"{edgeLabelPrefix}{i}")
+            else:
+                label_value = ''
+
+            gv_graph.edge(
+                str(sid),
+                str(eid),
+                label= label_value,
+                color= get_attr(e_dict, edgeColorKey, edgeColor),
+                penwidth=str(get_attr(e_dict, edgeWidthKey, edgeWidth)),
+                style= get_attr(e_dict, edgeStyleKey, edgeStyle),
+                arrowhead= get_attr(e_dict, edgeArrowheadKey, edgeArrowhead),
+                fontcolor= get_attr(e_dict, edgeFontColorKey, edgeFontColor),
+            )
+
+        return gv_graph
+
     @staticmethod
     def Guid(graph):
         """
@@ -10544,36 +11275,36 @@ class Graph:
         data = []
         for graph in new_graphs:
             data += Plotly.DataByGraph(graph,
-                                       sagitta=sagitta,
-                                       absolute=absolute,
-                                       sides=sides,
-                                       angle=angle,
-                                       vertexColor=vertexColor,
-                                       vertexColorKey=vertexColorKey,
-                                       vertexSize=vertexSize,
-                                       vertexSizeKey=vertexSizeKey,
-                                       vertexLabelKey=vertexLabelKey,
-                                       vertexGroupKey=vertexGroupKey,
-                                       vertexGroups=vertexGroups,
-                                       vertexMinGroup=vertexMinGroup,
-                                       vertexMaxGroup=vertexMaxGroup,
-                                       showVertices=showVertices,
-                                       showVertexLabel=showVertexLabel,
-                                       showVertexLegend=showVertexLegend,
-                                       edgeColor=edgeColor,
-                                       edgeColorKey=edgeColorKey,
-                                       edgeWidth=edgeWidth,
-                                       edgeWidthKey=edgeWidthKey,
-                                       edgeLabelKey=edgeLabelKey,
-                                       edgeGroupKey=edgeGroupKey,
-                                       edgeGroups=edgeGroups,
-                                       edgeMinGroup=edgeMinGroup,
-                                       edgeMaxGroup=edgeMaxGroup,
-                                       showEdges=showEdges,
-                                       showEdgeLabel=showEdgeLabel,
-                                       showEdgeLegend=showEdgeLegend,
-                                       colorScale=colorScale,
-                                       silent=silent)
+                                    sagitta=sagitta,
+                                    absolute=absolute,
+                                    sides=sides,
+                                    angle=angle,
+                                    vertexColor=vertexColor,
+                                    vertexColorKey=vertexColorKey,
+                                    vertexSize=vertexSize,
+                                    vertexSizeKey=vertexSizeKey,
+                                    vertexLabelKey=vertexLabelKey,
+                                    vertexGroupKey=vertexGroupKey,
+                                    vertexGroups=vertexGroups,
+                                    vertexMinGroup=vertexMinGroup,
+                                    vertexMaxGroup=vertexMaxGroup,
+                                    showVertices=showVertices,
+                                    showVertexLabel=showVertexLabel,
+                                    showVertexLegend=showVertexLegend,
+                                    edgeColor=edgeColor,
+                                    edgeColorKey=edgeColorKey,
+                                    edgeWidth=edgeWidth,
+                                    edgeWidthKey=edgeWidthKey,
+                                    edgeLabelKey=edgeLabelKey,
+                                    edgeGroupKey=edgeGroupKey,
+                                    edgeGroups=edgeGroups,
+                                    edgeMinGroup=edgeMinGroup,
+                                    edgeMaxGroup=edgeMaxGroup,
+                                    showEdges=showEdges,
+                                    showEdgeLabel=showEdgeLabel,
+                                    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/version.py

@@ -1 +1 @@
-__version__ = '0.8.23'
+__version__ = '0.8.25'

{topologicpy-0.8.23.dist-info → topologicpy-0.8.25.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: topologicpy
-Version: 0.8.23
+Version: 0.8.25
 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

{topologicpy-0.8.23.dist-info → topologicpy-0.8.25.dist-info}/RECORD

@@ -12,7 +12,7 @@ topologicpy/Dictionary.py,sha256=Lf24WHW8q_RCq0l8VpT3XJTn6UuStY66JI4Lb4W08jI,341
 topologicpy/Edge.py,sha256=pu4tZbRbK8qx2oqRbwHAeKuwU2X8JFGPSJjJMTJw8Q0,71418
 topologicpy/EnergyModel.py,sha256=Pyb28gDDwhzlQIH0xqAygqS0P3SJxWyyV7OWS_AAfRs,53856
 topologicpy/Face.py,sha256=7K46gB_UIKjKEKyzyY0JqGarqjwjH0ggS-JQTpDtWC4,184847
-topologicpy/Graph.py,sha256=29oDBceDUoZVbwZ4ajBJWfQD4JIPYGUgDeEqmm7CBX0,527640
+topologicpy/Graph.py,sha256=v9iFyHVs-dlcH9Pdj4uT4ELgS2VIygfDKAMDoSnSAtI,562010
 topologicpy/Grid.py,sha256=qRnFUvs079zMOZ6COWzBX6408niI7HyNz-BM0VRguXY,18245
 topologicpy/Helper.py,sha256=JdvC30WMrla46mTj5TdwCV_bRv-6y8vK5Bkx0prluy4,29100
 topologicpy/Honeybee.py,sha256=yctkwfdupKnp7bAOjP1Z4YaYpRrWoMEb4gz9Z5zaWwE,21751
@@ -29,9 +29,9 @@ topologicpy/Vector.py,sha256=mx7fgABdioikPWM9HzXKzmqfx3u_XBcU_jlLD4qK2x8,42407
 topologicpy/Vertex.py,sha256=PIwfbA7_TxK_dSGlSeM5mson97TRr4dYrfZyOLgO150,80913
 topologicpy/Wire.py,sha256=eRs4PM7h4yU5v6umPh0oBJR4cN8BwsqlVroaFdnvK4w,228499
 topologicpy/__init__.py,sha256=RMftibjgAnHB1vdL-muo71RwMS4972JCxHuRHOlU428,928
-topologicpy/version.py,sha256=x1ObPzSnRGxtlZbyDdxO7Th6BX-tC0y4aFEdmCRhvqg,23
-topologicpy-0.8.23.dist-info/licenses/LICENSE,sha256=FK0vJ73LuE8PYJAn7LutsReWR47-Ooovw2dnRe5yV6Q,681
-topologicpy-0.8.23.dist-info/METADATA,sha256=vQCjkz3HxMfw9u7K87Q8eiY5cvWggKY1QuZWIgm8fBE,10535
-topologicpy-0.8.23.dist-info/WHEEL,sha256=wXxTzcEDnjrTwFYjLPcsW_7_XihufBwmpiBeiXNBGEA,91
-topologicpy-0.8.23.dist-info/top_level.txt,sha256=J30bDzW92Ob7hw3zA8V34Jlp-vvsfIkGzkr8sqvb4Uw,12
-topologicpy-0.8.23.dist-info/RECORD,,
+topologicpy/version.py,sha256=RQuvvS5_gUL4CXqswj954OcBx7QfBRLpwl789EByiZc,23
+topologicpy-0.8.25.dist-info/licenses/LICENSE,sha256=FK0vJ73LuE8PYJAn7LutsReWR47-Ooovw2dnRe5yV6Q,681
+topologicpy-0.8.25.dist-info/METADATA,sha256=AZ8ca3QxNZAkqzohr2VAyEi_30MSXsfnm1v_v523aJ8,10535
+topologicpy-0.8.25.dist-info/WHEEL,sha256=DnLRTWE75wApRYVsjgc6wsVswC54sMSJhAEd4xhDpBk,91
+topologicpy-0.8.25.dist-info/top_level.txt,sha256=J30bDzW92Ob7hw3zA8V34Jlp-vvsfIkGzkr8sqvb4Uw,12
+topologicpy-0.8.25.dist-info/RECORD,,

{topologicpy-0.8.23.dist-info → topologicpy-0.8.25.dist-info}/WHEEL

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