Add 1.11 docs

Author: jarrodmillman

pygraphviz-1.11/_downloads/07fcc19ba03226cd3d83d4e40ec44385/auto_examples_python.zip

@@ -0,0 +1,43 @@
+{
+  "cells": [
+    {
+      "cell_type": "markdown",
+      "metadata": {},
+      "source": [
+        "\n# Subgraph\n\nSpecify a subgraph in pygraphviz.\n"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "collapsed": false
+      },
+      "outputs": [],
+      "source": [
+        "import pygraphviz as pgv\n\nA = pgv.AGraph()\n# add some edges\nA.add_edge(1, 2)\nA.add_edge(2, 3)\nA.add_edge(1, 3)\nA.add_edge(3, 4)\nA.add_edge(3, 5)\nA.add_edge(3, 6)\nA.add_edge(4, 6)\n# make a subgraph with rank='same'\nB = A.add_subgraph([4, 5, 6], name=\"s1\", rank=\"same\")\nB.graph_attr[\"rank\"] = \"same\"\nprint(A.string())  # print dot file to standard output\nA.draw(\"subgraph.png\", prog=\"neato\")"
+      ]
+    }
+  ],
+  "metadata": {
+    "kernelspec": {
+      "display_name": "Python 3",
+      "language": "python",
+      "name": "python3"
+    },
+    "language_info": {
+      "codemirror_mode": {
+        "name": "ipython",
+        "version": 3
+      },
+      "file_extension": ".py",
+      "mimetype": "text/x-python",
+      "name": "python",
+      "nbconvert_exporter": "python",
+      "pygments_lexer": "ipython3",
+      "version": "3.10.11"
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 0
+}

pygraphviz-1.11/_downloads/1046f06794863c5971e6de6c6cbc7461/plot_subgraph.ipynb

@@ -0,0 +1,97 @@
+"""
+Knuth Miles
+===========
+
+An example that shows how to add your own positions to nodes
+and have graphviz "neato" position the edges.
+
+miles_graph() returns an undirected graph over the 128 US cities from
+the datafile miles_dat.txt.
+
+This example is described in Section 1.1 in Knuth's book [1]_ [2]_.
+
+The data used in this example is copied from [2]_.  The filename and
+header have been modified to adhere to the request of the author to
+not corrupt the original source file content and name.
+
+References.
+-----------
+.. [1] Donald E. Knuth,
+   "The Stanford GraphBase: A Platform for Combinatorial Computing",
+   ACM Press, New York, 1993.
+.. [2] http://www-cs-faculty.stanford.edu/~knuth/sgb.html
+"""
+
+__author__ = """Aric Hagberg (aric.hagberg@gmail.com)"""
+
+
+def miles_graph():
+    """Return a graph from the data in miles_dat.txt.
+
+    Edges are made between cities that are less then 300 miles apart.
+    """
+    import math
+    import re
+    import gzip
+
+    G = pgv.AGraph(name="miles_dat")
+    G.node_attr["shape"] = "circle"
+    G.node_attr["fixedsize"] = "true"
+    G.node_attr["fontsize"] = "8"
+    G.node_attr["style"] = "filled"
+    G.graph_attr["outputorder"] = "edgesfirst"
+    G.graph_attr["label"] = "miles_dat"
+    G.graph_attr["ratio"] = "1.0"
+    G.edge_attr["color"] = "#1100FF"
+    G.edge_attr["style"] = "setlinewidth(2)"
+
+    cities = []
+    for line in gzip.open("miles_dat.txt.gz", "rt"):
+        if line.startswith("*"):  # skip comments
+            continue
+        numfind = re.compile(r"^\d+")
+
+        if numfind.match(line):  # this line is distances
+            dist = line.split()
+            for d in dist:
+                if float(d) < 300:  # connect if closer then 300 miles
+                    G.add_edge(city, cities[i])
+                i = i + 1
+        else:  # this line is a city, position, population
+            i = 1
+            (city, coordpop) = line.split("[")
+            cities.insert(0, city)
+            (coord, pop) = coordpop.split("]")
+            (y, x) = coord.split(",")
+            G.add_node(city)
+            n = G.get_node(city)
+            # assign positions, scale to be something reasonable in points
+            n.attr[
+                "pos"
+            ] = f"{-(float(x) - 7000) / 10.0:f},{(float(y) - 2000) / 10.0:f}"
+            # assign node size, in sqrt of 1,000,000's of people
+            d = math.sqrt(float(pop) / 1000000.0)
+            n.attr["height"] = f"{d / 2}"
+            n.attr["width"] = f"{d / 2}"
+            # assign node color
+            n.attr["fillcolor"] = f"#0000{int(d * 256):2x}"
+            # empty labels
+            n.attr["label"] = " "
+
+    return G
+
+
+if __name__ == "__main__":
+    import warnings
+    import pygraphviz as pgv
+
+    # ignore Graphviz warning messages
+    warnings.simplefilter("ignore", RuntimeWarning)
+
+    G = miles_graph()
+    print("Loaded miles_dat.txt containing 128 cities.")
+
+    G.write("miles.dot")
+    print("Wrote miles.dot")
+    G.draw("miles.png", prog="neato", args="-n2")
+    print("Wrote miles.png")

pygraphviz-1.11/_downloads/3184e92a37f50733f4d8eda3ab5447d1/plot_miles.py

@@ -0,0 +1,37 @@
+"""
+Star
+====
+
+Create and draw a star with varying node properties.
+"""
+#    Copyright (C) 2006 by
+#    Aric Hagberg <hagberg@lanl.gov>
+#    Dan Schult <dschult@colgate.edu>
+#    Manos Renieris, http://www.cs.brown.edu/~er/
+#    Distributed with BSD license.
+#    All rights reserved, see LICENSE for details.
+
+
+__author__ = """Aric Hagberg (hagberg@lanl.gov)"""
+
+from pygraphviz import *
+
+A = AGraph()
+
+# set some default node attributes
+A.node_attr["style"] = "filled"
+A.node_attr["shape"] = "circle"
+A.node_attr["fixedsize"] = "true"
+A.node_attr["fontcolor"] = "#FFFFFF"
+
+# make a star in shades of red
+for i in range(1, 16):
+    A.add_edge(0, i)
+    n = A.get_node(i)
+    n.attr["fillcolor"] = f"#{i * 16:2x}0000"
+    n.attr["height"] = f"{i / 16.0 + 0.5}"
+    n.attr["width"] = f"{i / 16.0 + 0.5}"
+
+print(A.string())  # print to screen
+A.write("star.dot")  # write to simple.dot
+A.draw("star.png", prog="circo")  # draw to png using circo layout

pygraphviz-1.11/_downloads/3eec82731466697b60c961133f801483/plot_star.py

@@ -0,0 +1,43 @@
+{
+  "cells": [
+    {
+      "cell_type": "markdown",
+      "metadata": {},
+      "source": [
+        "\n# Star\n\nCreate and draw a star with varying node properties.\n"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "collapsed": false
+      },
+      "outputs": [],
+      "source": [
+        "#    Copyright (C) 2006 by\n#    Aric Hagberg <hagberg@lanl.gov>\n#    Dan Schult <dschult@colgate.edu>\n#    Manos Renieris, http://www.cs.brown.edu/~er/\n#    Distributed with BSD license.\n#    All rights reserved, see LICENSE for details.\n\n\n__author__ = \"\"\"Aric Hagberg (hagberg@lanl.gov)\"\"\"\n\nfrom pygraphviz import *\n\nA = AGraph()\n\n# set some default node attributes\nA.node_attr[\"style\"] = \"filled\"\nA.node_attr[\"shape\"] = \"circle\"\nA.node_attr[\"fixedsize\"] = \"true\"\nA.node_attr[\"fontcolor\"] = \"#FFFFFF\"\n\n# make a star in shades of red\nfor i in range(1, 16):\n    A.add_edge(0, i)\n    n = A.get_node(i)\n    n.attr[\"fillcolor\"] = f\"#{i * 16:2x}0000\"\n    n.attr[\"height\"] = f\"{i / 16.0 + 0.5}\"\n    n.attr[\"width\"] = f\"{i / 16.0 + 0.5}\"\n\nprint(A.string())  # print to screen\nA.write(\"star.dot\")  # write to simple.dot\nA.draw(\"star.png\", prog=\"circo\")  # draw to png using circo layout"
+      ]
+    }
+  ],
+  "metadata": {
+    "kernelspec": {
+      "display_name": "Python 3",
+      "language": "python",
+      "name": "python3"
+    },
+    "language_info": {
+      "codemirror_mode": {
+        "name": "ipython",
+        "version": 3
+      },
+      "file_extension": ".py",
+      "mimetype": "text/x-python",
+      "name": "python",
+      "nbconvert_exporter": "python",
+      "pygments_lexer": "ipython3",
+      "version": "3.10.11"
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 0
+}

pygraphviz-1.11/_downloads/4e83e39a7d255093d0acd5faad5cd483/plot_star.ipynb

@@ -0,0 +1,43 @@
+{
+  "cells": [
+    {
+      "cell_type": "markdown",
+      "metadata": {},
+      "source": [
+        "\n# Basic\n\nA simple example to create a graphviz dot file and draw a graph.\n"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "collapsed": false
+      },
+      "outputs": [],
+      "source": [
+        "#    Copyright (C) 2006 by\n#    Aric Hagberg <hagberg@lanl.gov>\n#    Dan Schult <dschult@colgate.edu>\n#    Manos Renieris, http://www.cs.brown.edu/~er/\n#    Distributed with BSD license.\n#    All rights reserved, see LICENSE for details.\n\n\n__author__ = \"\"\"Aric Hagberg (hagberg@lanl.gov)\"\"\"\n\nimport pygraphviz as pgv\n\nA = pgv.AGraph()\n\nA.add_edge(1, 2)\nA.add_edge(2, 3)\nA.add_edge(1, 3)\n\nprint(A.string())  # print to screen\nA.write(\"simple.dot\")  # write to simple.dot\n\nB = pgv.AGraph(\"simple.dot\")  # create a new graph from file\nB.layout()  # layout with default (neato)\nB.draw(\"simple.png\")  # draw png"
+      ]
+    }
+  ],
+  "metadata": {
+    "kernelspec": {
+      "display_name": "Python 3",
+      "language": "python",
+      "name": "python3"
+    },
+    "language_info": {
+      "codemirror_mode": {
+        "name": "ipython",
+        "version": 3
+      },
+      "file_extension": ".py",
+      "mimetype": "text/x-python",
+      "name": "python",
+      "nbconvert_exporter": "python",
+      "pygments_lexer": "ipython3",
+      "version": "3.10.11"
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 0
+}

pygraphviz-1.11/_downloads/51891f3e62ffa1afbb2166aec79de121/plot_simple.ipynb

@@ -0,0 +1,43 @@
+{
+  "cells": [
+    {
+      "cell_type": "markdown",
+      "metadata": {},
+      "source": [
+        "\n# Attributes\n\nExample illustrating how to set node, edge, and graph attributes for\nvisualization.\n"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "execution_count": null,
+      "metadata": {
+        "collapsed": false
+      },
+      "outputs": [],
+      "source": [
+        "import pygraphviz as pgv\n\n# strict (no parallel edges)\n# digraph\n# with attribute rankdir set to 'LR'\nA = pgv.AGraph(directed=True, strict=True, rankdir=\"LR\")\n# add node 1 with color red\nA.add_node(1, color=\"red\")\nA.add_node(5, color=\"blue\")\n# add some edges\nA.add_edge(1, 2, color=\"green\")\nA.add_edge(2, 3)\nA.add_edge(1, 3)\nA.add_edge(3, 4)\nA.add_edge(3, 5)\nA.add_edge(3, 6)\nA.add_edge(4, 6)\n# adjust a graph parameter\nA.graph_attr[\"epsilon\"] = \"0.001\"\nprint(A.string())  # print dot file to standard output\nA.layout(\"dot\")  # layout with dot\nA.draw(\"foo.png\")  # write to file"
+      ]
+    }
+  ],
+  "metadata": {
+    "kernelspec": {
+      "display_name": "Python 3",
+      "language": "python",
+      "name": "python3"
+    },
+    "language_info": {
+      "codemirror_mode": {
+        "name": "ipython",
+        "version": 3
+      },
+      "file_extension": ".py",
+      "mimetype": "text/x-python",
+      "name": "python",
+      "nbconvert_exporter": "python",
+      "pygments_lexer": "ipython3",
+      "version": "3.10.11"
+    }
+  },
+  "nbformat": 4,
+  "nbformat_minor": 0
+}

pygraphviz-1.11/_downloads/6f1e7a639e0699d6164445b55e6c116d/auto_examples_jupyter.zip

@@ -0,0 +1,30 @@
+"""
+Attributes
+----------
+
+Example illustrating how to set node, edge, and graph attributes for
+visualization.
+"""
+
+import pygraphviz as pgv
+
+# strict (no parallel edges)
+# digraph
+# with attribute rankdir set to 'LR'
+A = pgv.AGraph(directed=True, strict=True, rankdir="LR")
+# add node 1 with color red
+A.add_node(1, color="red")
+A.add_node(5, color="blue")
+# add some edges
+A.add_edge(1, 2, color="green")
+A.add_edge(2, 3)
+A.add_edge(1, 3)
+A.add_edge(3, 4)
+A.add_edge(3, 5)
+A.add_edge(3, 6)
+A.add_edge(4, 6)
+# adjust a graph parameter
+A.graph_attr["epsilon"] = "0.001"
+print(A.string())  # print dot file to standard output
+A.layout("dot")  # layout with dot
+A.draw("foo.png")  # write to file

pygraphviz-1.11/_downloads/8d1b42cb8500b07a1ffe1d61d124333a/plot_attributes.ipynb

@@ -0,0 +1,23 @@
+"""
+Subgraph
+========
+
+Specify a subgraph in pygraphviz.
+"""
+
+import pygraphviz as pgv
+
+A = pgv.AGraph()
+# add some edges
+A.add_edge(1, 2)
+A.add_edge(2, 3)
+A.add_edge(1, 3)
+A.add_edge(3, 4)
+A.add_edge(3, 5)
+A.add_edge(3, 6)
+A.add_edge(4, 6)
+# make a subgraph with rank='same'
+B = A.add_subgraph([4, 5, 6], name="s1", rank="same")
+B.graph_attr["rank"] = "same"
+print(A.string())  # print dot file to standard output
+A.draw("subgraph.png", prog="neato")