iplotx 0.2.0__tar.gz → 0.3.0__tar.gz

{iplotx-0.2.0 → iplotx-0.3.0}/.github/workflows/publish.yml

@@ -19,18 +19,31 @@ jobs:
   release-build:
     runs-on: ubuntu-latest
 
+    strategy:
+      matrix:
+        python-version: ["3.11"]
+
     steps:
       - uses: actions/checkout@v4
 
-      - uses: actions/setup-python@v5
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
         with:
-          python-version: "3.x"
+          python-version: ${{ matrix.python-version }}
 
-      - name: Build release distributions
+      - name: Install the project
         run: |
-          # NOTE: put your own distribution build steps here.
-          python -m pip install build
-          python -m build
+          # Make sure you are in the right environment
+          uv sync
+          # Clean dist/
+          rm -f dist/*
+          # Build into dist/
+          uv build
 
       - name: Upload distributions
         uses: actions/upload-artifact@v4
@@ -51,7 +64,7 @@ jobs:
     environment:
       name: pypi
       # OPTIONAL: uncomment and update to include your PyPI project URL in the deployment status:
-      # url: https://pypi.org/p/YOURPROJECT
+      url: https://pypi.org/p/iplotx
       #
       # ALTERNATIVE: if your GitHub Release name is the PyPI project version string
       # ALTERNATIVE: exactly, uncomment the following line instead:

{iplotx-0.2.0 → iplotx-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: iplotx
-Version: 0.2.0
+Version: 0.3.0
 Summary: Plot networkx from igraph and networkx.
 Project-URL: Homepage, https://github.com/fabilab/iplotx
 Project-URL: Documentation, https://readthedocs.org/iplotx
@@ -11,12 +11,20 @@ Author-email: Fabio Zanini <fabio.zanini@unsw.edu.au>
 Maintainer-email: Fabio Zanini <fabio.zanini@unsw.edu.au>
 License: MIT
 Keywords: graph,network,plotting,visualisation
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Science/Research
 Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Classifier: Topic :: System :: Networking
+Classifier: Typing :: Typed
 Requires-Python: >=3.11
 Requires-Dist: matplotlib>=2.0.0
 Requires-Dist: numpy>=2.0.0
@@ -31,11 +39,12 @@ Description-Content-Type: text/markdown
 ![Github Actions](https://github.com/fabilab/iplotx/actions/workflows/test.yml/badge.svg)
 ![PyPI - Version](https://img.shields.io/pypi/v/iplotx)
 ![RTD](https://readthedocs.org/projects/iplotx/badge/?version=latest)
+![pylint](assets/pylint.svg)
 
 # iplotx
 Plotting networks from igraph and networkx.
 
-**NOTE**: This is currently alpha quality software. The API and functionality will break constantly, so use at your own risk. That said, if you have things you would like to see improved, please open a GitHub issue.
+**NOTE**: This is currently beta quality software. The API and functionality are settling in and might break occasionally.
 
 ## Installation
 ```bash
@@ -68,9 +77,13 @@ See [gallery](https://iplotx.readthedocs.io/en/latest/gallery/index.html).
 - Support storing the plot to disk thanks to the many matplotlib backends (SVG, PNG, PDF, etc.). ✅
 - Support flexible yet easy styling. ✅
 - Efficient plotting of large graphs using matplotlib's collection functionality. ✅
+- Support editing plotting elements after the plot is created, e.g. changing node colors, labels, etc. ✅
+- Support animations, e.g. showing the evolution of a network over time. ✅
+- Support mouse interaction, e.g. hovering over or clicking on nodes and edges to get information about them. ✅
 - Support trees from special libraries such as ete3, biopython, etc. This will need a dedicated function and layouting. ✅
-- Support animations, e.g. showing the evolution of a network over time. 🏗️
 - Support uni- and bi-directional communication between graph object and plot object.🏗️
 
+**NOTE:** The last item can probably be achieved already by using `matplotlib`'s existing callback functionality. It is currently untested, but if you manage to get it to work on your graph let me know and I'll add it to the examples (with credit).
+
 ## Authors
 Fabio Zanini (https://fabilab.org)

{iplotx-0.2.0 → iplotx-0.3.0}/README.md

@@ -1,11 +1,12 @@
 ![Github Actions](https://github.com/fabilab/iplotx/actions/workflows/test.yml/badge.svg)
 ![PyPI - Version](https://img.shields.io/pypi/v/iplotx)
 ![RTD](https://readthedocs.org/projects/iplotx/badge/?version=latest)
+![pylint](assets/pylint.svg)
 
 # iplotx
 Plotting networks from igraph and networkx.
 
-**NOTE**: This is currently alpha quality software. The API and functionality will break constantly, so use at your own risk. That said, if you have things you would like to see improved, please open a GitHub issue.
+**NOTE**: This is currently beta quality software. The API and functionality are settling in and might break occasionally.
 
 ## Installation
 ```bash
@@ -38,9 +39,13 @@ See [gallery](https://iplotx.readthedocs.io/en/latest/gallery/index.html).
 - Support storing the plot to disk thanks to the many matplotlib backends (SVG, PNG, PDF, etc.). ✅
 - Support flexible yet easy styling. ✅
 - Efficient plotting of large graphs using matplotlib's collection functionality. ✅
+- Support editing plotting elements after the plot is created, e.g. changing node colors, labels, etc. ✅
+- Support animations, e.g. showing the evolution of a network over time. ✅
+- Support mouse interaction, e.g. hovering over or clicking on nodes and edges to get information about them. ✅
 - Support trees from special libraries such as ete3, biopython, etc. This will need a dedicated function and layouting. ✅
-- Support animations, e.g. showing the evolution of a network over time. 🏗️
 - Support uni- and bi-directional communication between graph object and plot object.🏗️
 
+**NOTE:** The last item can probably be achieved already by using `matplotlib`'s existing callback functionality. It is currently untested, but if you manage to get it to work on your graph let me know and I'll add it to the examples (with credit).
+
 ## Authors
 Fabio Zanini (https://fabilab.org)

iplotx-0.3.0/assets/pylint.svg

@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" width="80" height="20">
+    <linearGradient id="b" x2="0" y2="100%">
+        <stop offset="0" stop-color="#bbb" stop-opacity=".1"/>
+        <stop offset="1" stop-opacity=".1"/>
+    </linearGradient>
+    <mask id="anybadge_1">
+        <rect width="80" height="20" rx="3" fill="#fff"/>
+    </mask>
+    <g mask="url(#anybadge_1)">
+        <path fill="#555" d="M0 0h44v20H0z"/>
+        <path fill="#4C1" d="M44 0h36v20H44z"/>
+        <path fill="url(#b)" d="M0 0h80v20H0z"/>
+    </g>
+    <g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="11">
+        <text x="23.0" y="15" fill="#010101" fill-opacity=".3">pylint</text>
+        <text x="22.0" y="14">pylint</text>
+    </g>
+    <g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="11">
+        <text x="63.0" y="15" fill="#010101" fill-opacity=".3">9.13</text>
+        <text x="62.0" y="14">9.13</text>
+    </g>
+</svg>

{iplotx-0.2.0 → iplotx-0.3.0}/docs/source/conf.py

@@ -49,6 +49,8 @@ myst_enable_extensions = ["colon_fence"]
 sphinx_gallery_conf = {
     "examples_dirs": "../../gallery",  # path to your example scripts
     "gallery_dirs": "./gallery",  # path to where to save gallery generated output
+    #'matplotlib_animations': (True, 'mp4'),
+    "matplotlib_animations": True,
 }
 
 source_suffix = {

{iplotx-0.2.0 → iplotx-0.3.0}/docs/source/index.md

@@ -74,13 +74,15 @@ See <project:gallery/index.rst> for examples of plots made with `iplotx`. Feel f
 - compatibility with many GUI frameworks (e.g. Qt, GTK, Tkinter) thanks to `matplotlib`
 - data-driven axes autoscaling
 - consistent behaviour upon zooming and panning
-- correct HiDPI scaling (e.g. retina screens)
+- correct HiDPI scaling (e.g. retina screens) including for vertex sizes, arrow sizes, and edge offsets
 - a consistent `matplotlib` artist hierarchy
 - post-plot editability (e.g. for animations)
 - plays well with other charting tools (e.g. `seaborn`)
 - chainable style contexts
 - vertex clusterings and covers with convex hulls and rounding
 - a plugin mechanism for additional libraries (WIP)
+- animations (see <project:gallery/plot_animation.rst>)
+- mouse/keyboard interaction and events (e.g. hover, click, see <project:gallery/plot_mouse_hover.rst>)
 - ... and probably more by the time you read this.
 
 ## Styles

{iplotx-0.2.0 → iplotx-0.3.0}/docs/source/sg_execution_times.rst

@@ -6,7 +6,7 @@
 
 Computation times
 =================
-**00:00.061** total execution time for 30 files **from all galleries**:
+**00:01.212** total execution time for 36 files **from all galleries**:
 
 .. container::
 
@@ -32,8 +32,11 @@ Computation times
    * - Example
      - Time
      - Mem (MB)
-   * - :ref:`sphx_glr_gallery_plot_ports.py` (``../../gallery/plot_ports.py``)
-     - 00:00.061
+   * - :ref:`sphx_glr_gallery_plot_ete4.py` (``../../gallery/plot_ete4.py``)
+     - 00:01.212
+     - 0.0
+   * - :ref:`sphx_glr_gallery_plot_animation.py` (``../../gallery/plot_animation.py``)
+     - 00:00.000
      - 0.0
    * - :ref:`sphx_glr_gallery_plot_basic.py` (``../../gallery/plot_basic.py``)
      - 00:00.000
@@ -56,6 +59,9 @@ Computation times
    * - :ref:`sphx_glr_gallery_plot_cogent3_tree.py` (``../../gallery/plot_cogent3_tree.py``)
      - 00:00.000
      - 0.0
+   * - :ref:`sphx_glr_gallery_plot_company_structure.py` (``../../gallery/plot_company_structure.py``)
+     - 00:00.000
+     - 0.0
    * - :ref:`sphx_glr_gallery_plot_complex.py` (``../../gallery/plot_complex.py``)
      - 00:00.000
      - 0.0
@@ -65,7 +71,7 @@ Computation times
    * - :ref:`sphx_glr_gallery_plot_directed.py` (``../../gallery/plot_directed.py``)
      - 00:00.000
      - 0.0
-   * - :ref:`sphx_glr_gallery_plot_ete4.py` (``../../gallery/plot_ete4.py``)
+   * - :ref:`sphx_glr_gallery_plot_edit_artists.py` (``../../gallery/plot_edit_artists.py``)
      - 00:00.000
      - 0.0
    * - :ref:`sphx_glr_gallery_plot_four_grids.py` (``../../gallery/plot_four_grids.py``)
@@ -92,12 +98,18 @@ Computation times
    * - :ref:`sphx_glr_gallery_plot_minimum_spanning_trees.py` (``../../gallery/plot_minimum_spanning_trees.py``)
      - 00:00.000
      - 0.0
+   * - :ref:`sphx_glr_gallery_plot_mouse_hover.py` (``../../gallery/plot_mouse_hover.py``)
+     - 00:00.000
+     - 0.0
    * - :ref:`sphx_glr_gallery_plot_multipartite_layout.py` (``../../gallery/plot_multipartite_layout.py``)
      - 00:00.000
      - 0.0
    * - :ref:`sphx_glr_gallery_plot_parallel_igraph_networkx.py` (``../../gallery/plot_parallel_igraph_networkx.py``)
      - 00:00.000
      - 0.0
+   * - :ref:`sphx_glr_gallery_plot_ports.py` (``../../gallery/plot_ports.py``)
+     - 00:00.000
+     - 0.0
    * - :ref:`sphx_glr_gallery_plot_shortest_path.py` (``../../gallery/plot_shortest_path.py``)
      - 00:00.000
      - 0.0
@@ -116,6 +128,12 @@ Computation times
    * - :ref:`sphx_glr_gallery_plot_traveling_salesman.py` (``../../gallery/plot_traveling_salesman.py``)
      - 00:00.000
      - 0.0
+   * - :ref:`sphx_glr_gallery_plot_tree_node_background.py` (``../../gallery/plot_tree_node_background.py``)
+     - 00:00.000
+     - 0.0
+   * - :ref:`sphx_glr_gallery_plot_trees_of_trees.py` (``../../gallery/plot_trees_of_trees.py``)
+     - 00:00.000
+     - 0.0
    * - :ref:`sphx_glr_gallery_plot_voronoi.py` (``../../gallery/plot_voronoi.py``)
      - 00:00.000
      - 0.0

iplotx-0.3.0/gallery/plot_animation.py

@@ -0,0 +1,61 @@
+"""
+Animations
+==========
+
+This tutorial shows how to animate `iplotx` visualizations using `matplotlib.animation.FuncAnimation`.
+
+For illustration purposes, we will animate a simple directed graph, rotating it around its center. We also modify the opacity of the vertices and edges, just for fun.
+"""
+
+import matplotlib.pyplot as plt
+import numpy as np
+import matplotlib.animation as animation
+import igraph as ig
+import iplotx as ipx
+
+g = ig.Graph.Ring(3, directed=True)
+layout = np.asarray(g.layout("circle").coords)
+
+# The animation will rotate the layout of the graph
+thetas = np.linspace(0, 2 * np.pi, 101)[:-1]
+
+fig, ax = plt.subplots()
+art = ipx.network(g, ax=ax, layout=layout, aspect=1)[0]
+ax.set(xlim=[-2, 2], ylim=[-2, 2])
+
+
+def rotate(vector, theta):
+    """Rotate a 2D vector by an angle theta (in radians) clockwise."""
+    return vector @ np.array(
+        [
+            [np.cos(theta), -np.sin(theta)],
+            [np.sin(theta), np.cos(theta)],
+        ],
+    )
+
+
+def update(frame):
+    # for each frame, update the vertex positions
+    theta = thetas[frame]
+
+    # The new layout is the old layout rotated by theta, clockwise
+    layout_new = rotate(layout, theta)
+
+    # Also change transparency, slower
+    alpha_vertices = 1 - np.abs(np.sin(theta / 2))
+    alpha_edges = 0.25 + 0.75 * np.abs(np.sin(theta / 2))
+
+    # Edit the vertices' positions
+    art.get_vertices().set_offsets(layout_new)
+    art.get_vertices().set_alpha(alpha_vertices)
+    art.get_edges().set_alpha(alpha_edges)
+    return (art.get_vertices(), art.get_edges())
+
+
+# Run the animation
+ani = animation.FuncAnimation(
+    fig=fig,
+    func=update,
+    frames=len(thetas),
+    interval=30,
+)

{iplotx-0.2.0 → iplotx-0.3.0}/gallery/plot_biopython_tree.py

@@ -28,6 +28,7 @@ ipx.plotting.tree(
 # Moreover, the plot can be customised further using hmargin (horizontal label margin)
 # and some `matplotlib` settings.
 
+# sphinx_gallery_thumbnail_number = 2
 leaf_labels = {leaf: f"Species {i+1}" for i, leaf in enumerate(tree.get_terminals())}
 fig, ax = plt.subplots(figsize=(4, 4))
 ipx.plotting.tree(

iplotx-0.3.0/gallery/plot_company_structure.py

@@ -0,0 +1,72 @@
+"""
+Company structure
+=================
+
+This example shows how to use `iplotx` to visualise simple logical relationships, for instance the organisational chart of a company.
+"""
+
+import networkx as nx
+import matplotlib.pyplot as plt
+import iplotx as ipx
+
+g = nx.DiGraph()
+g.add_edges_from(
+    [
+        ("CEO", "Manager 1"),
+        ("CEO", "Manager 2"),
+        ("CEO", "Manager 3"),
+        ("Manager 1", "Employee 1"),
+        ("Manager 1", "Employee 2"),
+        ("Manager 2", "Employee 3"),
+        ("Manager 2", "Employee 4"),
+        ("Manager 3", "Employee 4"),
+    ]
+)
+layout = {
+    "CEO": [0, 0],
+    "Manager 1": [1, -1],
+    "Manager 2": [1, 0],
+    "Manager 3": [1, 1],
+    "Employee 1": [2, -1],
+    "Employee 2": [2, -0.5],
+    "Employee 3": [2, 0],
+    "Employee 4": [2, 0.5],
+}
+fig, ax = plt.subplots()
+ipx.network(
+    g,
+    layout=layout,
+    ax=ax,
+    vertex_labels=True,
+    style="hollow",
+    vertex_marker="r",
+    edge_ports=[("e", "w")] * 8,
+    edge_curved=True,
+    edge_tension=[0.65] * 3 + [0.6] * 5,
+    margins=(0.08, 0.05),
+)
+# Show the layout top to bottom for clarity
+ax.invert_yaxis()
+
+# %%
+# If you prefer a more squared look, you can use S-style waypoints with per-edge offsets:
+
+fig, ax = plt.subplots()
+ipx.network(
+    g,
+    layout=layout,
+    ax=ax,
+    vertex_labels=True,
+    style="hollow",
+    vertex_marker="r",
+    edge_ports=[("e", "w")] * 8,
+    edge_waypoints="xmidy0,xmidy1",
+    edge_offset=[(0, 0)] * 7 + [(0, -6)],
+    margins=(0.08, 0.05),
+    edge_linestyle=["-"] * 7 + ["--"],
+)
+ax.invert_yaxis()
+
+# %%
+# The `offset` edge style bypasses any layout coordinate system and acts in figure points directly.
+# Combining edge offsets with noncartesian layout coordinate systems (e.g. `polar`) can lead to unexpected results.

iplotx-0.3.0/gallery/plot_edit_artists.py

@@ -0,0 +1,60 @@
+"""
+Editing artists after plotting
+==============================
+
+One of the strengths of `iplotx` is the support for editing artists after they have been plotted the first time without making a whole new figure.
+
+In this example, we will change vertices, edges, arrows, etc. and check out how they look like.
+"""
+
+# %%
+# This is the vanilla version, taken from the "Ports" gallery example:
+
+import igraph as ig
+import numpy as np
+import matplotlib.pyplot as plt
+import iplotx as ipx
+
+g = ig.Graph.Ring(3, directed=True)
+
+artist = ipx.network(
+    g,
+    layout="circle",
+    edge_curved=True,
+    edge_ports=[
+        ("n", "w"),  # exit from the top, enter from the left
+        ("e", "s"),  # exit from the right, enter from the bottom
+        ("n", "s"),  # exit from the top, enter from the bottom
+    ],
+    edge_tension=[1.5, 1.8, 0.8],
+    edge_color=["tomato", "steelblue", "purple"],
+)[0]
+
+# %%
+# Now we can change the vertex sizes:
+
+# sphinx_gallery_thumbnail_number = 2
+# SAME BLOCK AS BEFORE, ONLY NEEDED TO MAKE A NEW FIGURE
+artist = ipx.network(
+    g,
+    layout="circle",
+    edge_curved=True,
+    edge_ports=[
+        ("n", "w"),  # exit from the top, enter from the left
+        ("e", "s"),  # exit from the right, enter from the bottom
+        ("n", "s"),  # exit from the top, enter from the bottom
+    ],
+    edge_tension=[1.5, 1.8, 0.8],
+    edge_color=["tomato", "steelblue", "purple"],
+)[0]
+# END OF SAME BLOCK
+
+artist.get_vertices().set_sizes([5, 5, 40])
+artist.get_edges().set_ports(
+    [
+        ("n", "n"),
+        ("w", None),
+        ("e", "s"),
+    ]
+)
+artist.get_edges().set_tension([1.3, 0.3, 0.5])

{iplotx-0.2.0 → iplotx-0.3.0}/gallery/plot_ete4.py

@@ -21,19 +21,32 @@ ipx.plotting.tree(
 
 # %%
 # `iplotx` can compute a radial tree layout as well, and usual style modifications
-# work for trees same as networks:
+# work for trees same as networks. Moreover, trees have a layout style option to
+# choose the starting angle and angular span of the radial layout.
 
+# sphinx_gallery_thumbnail_number = 2
 ipx.plotting.tree(
     tree,
     layout="radial",
+    orientation="right",
     style=[
         "tree",
         {
             "edge": {
-                "color": "black",
+                "color": "deeppink",
                 "linewidth": 4,
             },
+            "layout": {
+                "start": -180,
+                "span": 180,
+            },
+            "vertex": {
+                "label": {
+                    "hmargin": 15,
+                }
+            },
         },
     ],
+    vertex_labels={leaf: str(i + 1) for i, leaf in enumerate(tree.leaves())},
     aspect=1,
 )

{iplotx-0.2.0 → iplotx-0.3.0}/gallery/plot_loops.py

@@ -37,7 +37,7 @@ ipx.plot(
         },
         "edge": {
             "linestyle": linestyle,
-            "offset": 0,
+            "paralleloffset": 0,
             "looptension": 3.5,
             "arrow": {
                 "marker": "|>",
@@ -61,7 +61,7 @@ ipx.plot(
         vertex_edgecolor="none",
         vertex_label_color="black",
         edge_linestyle=linestyle,
-        edge_offset=0,
+        edge_paralleloffset=0,
         edge_looptension=3.5,
         edge_arrow_marker="|>",
     ),
@@ -80,7 +80,7 @@ ipx.plot(
     vertex_edgecolor="none",
     vertex_label_color="black",
     edge_linestyle=linestyle,
-    edge_offset=0,
+    edge_paralleloffset=0,
     edge_looptension=3.5,
     edge_arrow_marker="|>",
 )
@@ -94,7 +94,7 @@ with ipx.style.context(
     vertex_edgecolor="none",
     vertex_label_color="black",
     edge_linestyle=linestyle,
-    edge_offset=0,
+    edge_paralleloffset=0,
     edge_looptension=3.5,
     edge_arrow_marker="|>",
 ):

iplotx-0.3.0/gallery/plot_mouse_hover.py

@@ -0,0 +1,67 @@
+"""
+Mouse event handling
+====================
+
+This example shows how to interact with mouse events (e.g. hovering) in `iplotx`.
+
+.. warning::
+  This example will run in a Python, IPython, or Jupyter session, however the
+  interactive functionality is not visible on the HTML page. Download the code
+  at the end of this page and run it in a local Python environment to see
+  the results.
+"""
+
+import matplotlib.pyplot as plt
+import numpy as np
+import igraph as ig
+import iplotx as ipx
+
+g = ig.Graph.Ring(3, directed=True)
+
+fig, ax = plt.subplots()
+art = ipx.network(
+    g,
+    layout="circle",
+    ax=ax,
+    aspect=1,
+)[0]
+vertex_artist = art.get_vertices()
+
+# Prepare an invisible annotation for hovering
+annot = ax.annotate(
+    "",
+    xy=(0, 0),
+    xytext=(20, 20),
+    textcoords="offset points",
+    bbox=dict(boxstyle="round", fc=(0, 0, 0, 0.2)),
+    arrowprops=dict(arrowstyle="->"),
+)
+annot.set_visible(False)
+
+
+def hover_callback(event):
+    """React to mouse hovering over vertices."""
+    if event.inaxes == ax:
+        vc = art.get_vertices()
+        cont, ind = vc.contains(event)
+        # If mouse is over a vertex, show the buble
+        if cont:
+            i = ind["ind"][0]
+            annot.xy = vc.get_offsets()[i]
+            annot.set_text(f"{i+1}")
+            annot.set_visible(True)
+        # Otherwise, hide the bubble
+        elif annot.get_visible():
+            annot.set_visible(False)
+        # If nothing changed, no need to redraw
+        else:
+            return
+
+        # Redraw to show/hide the bubble
+        fig.canvas.draw_idle()
+
+
+fig.canvas.mpl_connect(
+    "motion_notify_event",
+    hover_callback,
+)

{iplotx-0.2.0 → iplotx-0.3.0}/gallery/plot_simple_path.py

@@ -10,12 +10,12 @@ import iplotx as ipx
 
 G = nx.path_graph(8)
 pos = nx.spring_layout(G, seed=47)  # Seed layout for reproducibility
-ipx.plot(G, layout=pos)
+ipx.network(G, layout=pos)
 
 # %%
 # We can change the color of the vertices and edges with a touch of style:
 
-ipx.plot(
+ipx.network(
     G,
     layout=pos,
     style={

iplotx-0.3.0/gallery/plot_tree_node_background.py

@@ -0,0 +1,55 @@
+"""
+Tree cascades
+=============
+
+This example shows how to use `iplotx` to add cascading backgrounds to trees.
+"Cascading" here means that each patch (rectangle/wedge/etc.) will cover a node
+and all descendants, down to the leaves.
+"""
+
+from Bio import Phylo
+from io import StringIO
+import matplotlib.pyplot as plt
+import iplotx as ipx
+
+# Make a tree from a string in Newick format
+tree = next(
+    Phylo.NewickIO.parse(
+        StringIO(
+            "(()(()((()())(()()))))",
+        )
+    )
+)
+
+backgrounds = {
+    tree.get_nonterminals()[3]: "turquoise",
+    tree.get_terminals()[0]: "tomato",
+    tree.get_terminals()[1]: "purple",
+}
+
+ipx.plotting.tree(
+    tree,
+    vertex_cascade_facecolor=backgrounds,
+)
+
+# %%
+# Cascading patches have a style option "extend" which affects whether the patches extend to the end of the deepest leaf:
+
+ipx.plotting.tree(
+    tree,
+    layout="vertical",
+    vertex_cascade_facecolor=backgrounds,
+    vertex_cascade_extend=True,
+)
+
+# %%
+# Cascading patches work with radial layouts as well:
+
+# sphinx_gallery_thumbnail_number = 3
+ipx.plotting.tree(
+    tree,
+    layout="radial",
+    vertex_cascade_facecolor=backgrounds,
+    vertex_cascade_extend=True,
+    aspect=1,
+)