From 9e1b096f29acb947364e7f2bae3612f11b7ba6a3 Mon Sep 17 00:00:00 2001
From: Ashton-Sidhu <ashton.sidhu1994@gmail.com>
Date: Fri, 27 Mar 2020 21:58:47 -0400
Subject: [PATCH] added MG, DG and edge properties

---
 README.md                  |  56 +++++++++-
 docs/images/dg.png         | Bin 0 -> 28603 bytes
 docs/images/mg.png         | Bin 0 -> 16970 bytes
 examples/DiGraphs.ipynb    |  80 ++++++++++++++
 examples/Multigraphs.ipynb |  54 ++++++++++
 examples/tutorial.ipynb    |  18 +---
 igviz/igviz.py             | 208 ++++++++++++++++++++++++-------------
 igviz/tests/test_plot.py   |  44 +++++++-
 setup.py                   |   2 +-
 9 files changed, 368 insertions(+), 94 deletions(-)
 create mode 100644 docs/images/dg.png
 create mode 100644 docs/images/mg.png
 create mode 100644 examples/DiGraphs.ipynb
 create mode 100644 examples/Multigraphs.ipynb

diff --git a/README.md b/README.md
index 50a7c00..5b6aaad 100644
--- a/README.md
+++ b/README.md
@@ -21,6 +21,8 @@ Interactive Graph Visualization (igviz) is a library to help visualize graphs in
 
 ## Usage
 
+Example notebooks can be found [here](https://github.com/Ashton-Sidhu/plotly-graph/tree/master/examples).
+
 ### Basic
 
 ```python
@@ -43,7 +45,7 @@ The default plot colors and sizes the nodes by the Degree but it is configurable
 ig.plot(
     G, # Your graph
     title="My Graph",
-    sizing_method="static", # Makes node sizes the same
+    size_method="static", # Makes node sizes the same
     color_method="##ffcccb", # Makes all the node colours black,
     node_text=["prop"], # Adds the 'prop' property to the hover text of the node
     annotation_text="Visualization made by <a href='https://github.com/Ashton-Sidhu/plotly-graph'>igviz</a> & plotly.", # Adds a text annotation to the graph
@@ -55,7 +57,7 @@ ig.plot(
 ig.plot(
     G,
     title="My Graph",
-    sizing_method="prop", # Makes node sizes the size of the "prop" property
+    size_method="prop", # Makes node sizes the size of the "prop" property
     color_method="prop", # Colors the nodes based off the "prop" property and a color scale,
     node_text=["prop"], # Adds the 'prop' property to the hover text of the node
 )
@@ -65,7 +67,7 @@ ig.plot(
 
 #### How to add your own custom sizing method and colour method
 
-To add your own custom sizing and color method, just pass a list to the `sizing_method` and `color_method`.
+To add your own custom sizing and color method, just pass a list to the `size_method` and `color_method`.
 
 ```python
 color_list = []
@@ -80,7 +82,7 @@ for node in G.nodes():
 ig.plot(
     G,
     title="My Graph",
-    sizing_method=sizing_list, # Makes node sizes the size of the "prop" property
+    size_method=sizing_list, # Makes node sizes the size of the "prop" property
     color_method=color_list, # Colors the nodes based off the "prop" property and a color scale,
     node_text=["prop"], # Adds the 'prop' property to the hover text of the node
 )
@@ -118,6 +120,52 @@ ig.plot(
 )
 ```
 
+#### Directed & Multi Graphs
+
+Igviz also plots Directed and Multigraphs with no configuration chages. For Directed Graphs the arrows are shown from node to node. For Multi Graphs only one edge is shown and it is recommended to set `show_edgetext=True` to display the weights of all edges between 2 Multi Graph nodes.
+
+Note: `show_edgetext=True` also works for vanilla and Directed Graphs.
+
+##### Directed Graph
+
+```python
+def createDiGraph():
+    # Create a directed graph (digraph) object; i.e., a graph in which the edges
+    # have a direction associated with them.
+    G = nx.DiGraph()
+
+    # Add nodes:
+    nodes = ['A', 'B', 'C', 'D', 'E']
+    G.add_nodes_from(nodes)
+
+    # Add edges or links between the nodes:
+    edges = [('A','B'), ('B','C'), ('B', 'D'), ('D', 'E')]
+    G.add_edges_from(edges)
+    return G
+
+DG = createDiGraph()
+
+ig.plot(DG, size_method="static")
+```
+![](docs/images/dg.png)
+
+##### Multi Graph
+
+```python
+MG = nx.MultiGraph()
+MG.add_weighted_edges_from([(1, 2, 0.5), (1, 2, 0.75), (2, 3, 0.5)])
+
+ig.plot(
+    MG,
+    layout="spring",
+    size_method="static",
+    show_edgetext=True,
+    colorscale="Rainbow"
+)
+```
+
+![](docs/images/mg.png)
+
 ## Installation
 
 `pip install igviz`
diff --git a/docs/images/dg.png b/docs/images/dg.png
new file mode 100644
index 0000000000000000000000000000000000000000..e62656831f9ef98ceed9b358ff9a3422a3f7ae48
GIT binary patch
literal 28603
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
AbN~PV

literal 0
HcmV?d00001

diff --git a/docs/images/mg.png b/docs/images/mg.png
new file mode 100644
index 0000000000000000000000000000000000000000..8d608f241b8ac2995914e5ef556093c4ad812af6
GIT binary patch
literal 16970
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
Q$b@OBpFWX&%<}jD1*PW#5dZ)H

literal 0
HcmV?d00001

diff --git a/examples/DiGraphs.ipynb b/examples/DiGraphs.ipynb
new file mode 100644
index 0000000..d60dc46
--- /dev/null
+++ b/examples/DiGraphs.ipynb
@@ -0,0 +1,80 @@
+{
+ "cells": [
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import networkx as nx\n",
+    "import igviz"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "ename": "NameError",
+     "evalue": "name 'nx' is not defined",
+     "output_type": "error",
+     "traceback": [
+      "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m",
+      "\u001b[0;31mNameError\u001b[0m                                 Traceback (most recent call last)",
+      "\u001b[0;32m<ipython-input-2-81a9d21988fb>\u001b[0m in \u001b[0;36m<module>\u001b[0;34m\u001b[0m\n\u001b[1;32m     13\u001b[0m     \u001b[0;32mreturn\u001b[0m \u001b[0mG\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m     14\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m---> 15\u001b[0;31m \u001b[0mDG\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mcreateDiGraph\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m",
+      "\u001b[0;32m<ipython-input-2-81a9d21988fb>\u001b[0m in \u001b[0;36mcreateDiGraph\u001b[0;34m()\u001b[0m\n\u001b[1;32m      2\u001b[0m     \u001b[0;31m# Create a directed graph (digraph) object; i.e., a graph in which the edges\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m      3\u001b[0m     \u001b[0;31m# have a direction associated with them.\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m----> 4\u001b[0;31m     \u001b[0mG\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mnx\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mDiGraph\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m      5\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m      6\u001b[0m     \u001b[0;31m# Add nodes:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
+      "\u001b[0;31mNameError\u001b[0m: name 'nx' is not defined"
+     ]
+    }
+   ],
+   "source": [
+    "def createDiGraph():\n",
+    "    # Create a directed graph (digraph) object; i.e., a graph in which the edges\n",
+    "    # have a direction associated with them.\n",
+    "    G = nx.DiGraph()\n",
+    "\n",
+    "    # Add nodes:\n",
+    "    nodes = ['A', 'B', 'C', 'D', 'E']\n",
+    "    G.add_nodes_from(nodes)\n",
+    "\n",
+    "    # Add edges or links between the nodes:\n",
+    "    edges = [('A','B'), ('B','C'), ('B', 'D'), ('D', 'E')]\n",
+    "    G.add_edges_from(edges)\n",
+    "    return G\n",
+    "\n",
+    "DG = createDiGraph()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "ig.plot(DG, size_method=\"static\")"
+   ]
+  }
+ ],
+ "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.6.9"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}
diff --git a/examples/Multigraphs.ipynb b/examples/Multigraphs.ipynb
new file mode 100644
index 0000000..500573f
--- /dev/null
+++ b/examples/Multigraphs.ipynb
@@ -0,0 +1,54 @@
+{
+ "cells": [
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import networkx as nx\n",
+    "import igviz"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "MG = nx.MultiGraph()\n",
+    "MG.add_weighted_edges_from([(1, 2, 0.5), (1, 2, 0.75), (2, 3, 0.5)])"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "ig.plot(MG, layout=\"spring\", size_method=\"static\", show_edgetext=True)"
+   ]
+  }
+ ],
+ "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.6.9"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}
diff --git a/examples/tutorial.ipynb b/examples/tutorial.ipynb
index 660dc7f..cff7b3c 100644
--- a/examples/tutorial.ipynb
+++ b/examples/tutorial.ipynb
@@ -1,15 +1,5 @@
 {
  "cells": [
-  {
-   "cell_type": "code",
-   "execution_count": 1,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "%load_ext autoreload\n",
-    "%autoreload 2"
-   ]
-  },
   {
    "cell_type": "code",
    "execution_count": 2,
@@ -7513,7 +7503,7 @@
     }
    ],
    "source": [
-    "ig.plot(G, layout=\"kamada\")"
+    "ig.plot(G)"
    ]
   },
   {
@@ -14486,7 +14476,7 @@
     "ig.plot(\n",
     "    G, # Your graph\n",
     "    title=\"My Graph\",\n",
-    "    sizing_method=\"static\", # Makes node sizes the same\n",
+    "    size_method=\"static\", # Makes node sizes the same\n",
     "    color_method=\"#ffcccb\", # Makes all the node colours black,\n",
     "    node_text=[\"prop\"], # Adds the 'prop' property to the hover text of the node\n",
     "    annotation_text=\"Visualization made by <a href='https://github.com/Ashton-Sidhu/plotly-graph'>igviz</a> & plotly.\", # Adds a text annotation to the graph\n",
@@ -21607,7 +21597,7 @@
     "ig.plot(\n",
     "    G,\n",
     "    title=\"My Graph\",\n",
-    "    sizing_method=\"prop\", # Makes node sizes the size of the \"prop\" property\n",
+    "    size_method=\"prop\", # Makes node sizes the size of the \"prop\" property\n",
     "    color_method=\"prop\", # Colors the nodes based off the \"prop\" property and a color scale,\n",
     "    node_text=[\"prop\"], # Adds the 'prop' property to the hover text of the node\n",
     ")"
@@ -28736,7 +28726,7 @@
     "ig.plot(\n",
     "    G,\n",
     "    title=\"My Graph\",\n",
-    "    sizing_method=sizing_list, # Makes node sizes the size of the \"prop\" property\n",
+    "    size_method=sizing_list, # Makes node sizes the size of the \"prop\" property\n",
     "    color_method=color_list, # Colors the nodes based off the \"prop\" property and a color scale,\n",
     "    node_text=[\"prop\"], # Adds the 'prop' property to the hover text of the node\n",
     ")"
diff --git a/igviz/igviz.py b/igviz/igviz.py
index 5b1e9fd..3270609 100644
--- a/igviz/igviz.py
+++ b/igviz/igviz.py
@@ -7,12 +7,14 @@ def plot(
     G,
     title="Graph",
     layout=None,
-    sizing_method="degree",
+    size_method="degree",
     color_method="degree",
     node_text=[],
+    show_edgetext=False,
     titlefont_size=16,
     showlegend=False,
     annotation_text="",
+    colorscale="YlGnBu",
     colorbar_title="",
 ):
     """
@@ -44,7 +46,7 @@ def plot(
             
             spiral: Position nodes in a spiral layout.
             
-    sizing_method : {'degree', 'static'}, node property or a list, optional
+    size_method : {'degree', 'static'}, node property or a list, optional
         How to size the nodes., by default "degree"
 
             degree: The larger the degree, the larger the node.
@@ -69,6 +71,9 @@ def plot(
     node_text : list, optional
         A list of node properties to display when hovering over the node.
 
+    show_edgetext : bool, optional
+        True to display the edge properties on hover.
+
     titlefont_size : int, optional
         Font size of the title, by default 16
 
@@ -78,6 +83,9 @@ def plot(
     annotation_text : str, optional
         Graph annotation text, by default ""
 
+    colorscale : {'Greys', 'YlGnBu', 'Greens', 'YlOrRd', 'Bluered', 'RdBu', 'Reds', 'Blues', 'Picnic', 'Rainbow', 'Portland', 'Jet', 'Hot', 'Blackbody', 'Earth', 'Electric', 'Viridis'}
+        Scale of the color bar
+
     colorbar_title : str, optional
         Color bar axis title, by default ""
     
@@ -92,17 +100,21 @@ def plot(
     elif not nx.get_node_attributes(G, "pos"):
         _apply_layout(G, "random")
 
-    node_trace, edge_trace = _generate_scatter_trace(
+    node_trace, edge_trace, middle_node_trace = _generate_scatter_trace(
         G,
-        sizing_method=sizing_method,
+        size_method=size_method,
         color_method=color_method,
+        colorscale=colorscale,
         colorbar_title=colorbar_title,
         node_text=node_text,
+        show_edgetext=show_edgetext,
     )
 
     fig = _generate_figure(
+        G,
         node_trace,
         edge_trace,
+        middle_node_trace,
         title=title,
         titlefont_size=titlefont_size,
         showlegend=showlegend,
@@ -114,126 +126,178 @@ def plot(
 
 def _generate_scatter_trace(
     G,
-    sizing_method: Union[str, list],
+    size_method: Union[str, list],
     color_method: Union[str, list],
+    colorscale: str,
     colorbar_title: str,
     node_text: list,
+    show_edgetext: bool,
 ):
     """
     Helper function to generate Scatter plot traces for the graph.
     """
 
-    edge_x = []
-    edge_y = []
-    node_x = []
-    node_y = []
-    node_size = []
-    color = []
-    node_text_list = []
+    edge_text_list = []
+    edge_properties = {}
+
+    edge_trace = go.Scatter(
+        x=[], y=[], line=dict(width=1, color="#888"), hoverinfo="text", mode="lines",
+    )
+
+    # NOTE: This is a hack because Plotly does not allow you to have hover text on a line
+    # Were adding an invisible node to the edges that will display the edge properties
+    middle_node_trace = go.Scatter(
+        x=[], y=[], text=[], mode="markers", hoverinfo="text", marker=dict(opacity=0)
+    )
 
-    for edge in G.edges():
+    node_trace = go.Scatter(
+        x=[],
+        y=[],
+        mode="markers",
+        text=[],
+        hoverinfo="text",
+        marker=dict(
+            showscale=True,
+            colorscale=colorscale,
+            reversescale=True,
+            size=[],
+            color=[],
+            colorbar=dict(
+                thickness=15, title=colorbar_title, xanchor="left", titleside="right"
+            ),
+            line_width=2,
+        ),
+    )
+
+    for edge in G.edges(data=True):
         x0, y0 = G.nodes[edge[0]]["pos"]
         x1, y1 = G.nodes[edge[1]]["pos"]
-        edge_x.append(x0)
-        edge_x.append(x1)
-        edge_x.append(None)
-        edge_y.append(y0)
-        edge_y.append(y1)
-        edge_y.append(None)
+        edge_trace["x"] += tuple([x0, x1, None])
+        edge_trace["y"] += tuple([y0, y1, None])
 
-    edge_trace = go.Scatter(
-        x=edge_x,
-        y=edge_y,
-        line=dict(width=0.5, color="#888"),
-        hoverinfo="none",
-        mode="lines",
-    )
+        if show_edgetext:
+            # Now we can add the text
+            # First we need to aggregate all the properties for each edge
+            edge_pair = (edge[0], edge[1])
+            # if an edge property for an edge hasn't been tracked, add an entry
+            if edge_pair not in edge_properties:
+                edge_properties[edge_pair] = {}
+
+                # Since we haven't seen this node combination before also add it to the trace
+                middle_node_trace["x"] += tuple([(x0 + x1) / 2])
+                middle_node_trace["y"] += tuple([(y0 + y1) / 2])
+
+            # For each edge property, create an entry for that edge, keeping track of the property name and its values
+            # If it doesn't exist, add an entry
+            for k, v in edge[2].items():
+                if k not in edge_properties[edge_pair]:
+                    edge_properties[edge_pair][k] = []
+
+                edge_properties[edge_pair][k] += [v]
 
     for node in G.nodes():
-        text = f"Degree: {G.degree(node)}"
+        text = f"Node: {node}<br>Degree: {G.degree(node)}"
 
         x, y = G.nodes[node]["pos"]
-        node_x.append(x)
-        node_y.append(y)
+        node_trace["x"] += tuple([x])
+        node_trace["y"] += tuple([y])
 
         if node_text:
 
             for prop in node_text:
                 text += f"<br></br>{prop}: {G.nodes[node][prop]}"
 
-        node_text_list.append(text.strip())
+        node_trace["text"] += tuple([text.strip()])
 
-        if isinstance(sizing_method, list):
-            node_size = sizing_method
+        if isinstance(size_method, list):
+            node_trace["marker"]["size"] = size_method
         else:
-            if sizing_method == "degree":
-                node_size.append(G.degree(node) * 2)
-            elif sizing_method == "static":
-                node_size.append(12)
+            if size_method == "degree":
+                node_trace["marker"]["size"] += tuple([G.degree(node) * 2])
+            elif size_method == "static":
+                node_trace["marker"]["size"] += tuple([12])
             else:
-                node_size.append(G.nodes[node][sizing_method])
+                node_trace["marker"]["size"] += tuple([G.nodes[node][size_method]])
 
         if isinstance(color_method, list):
-            color = color_method
+            node_trace["marker"]["color"] = color_method
         else:
             if color_method == "degree":
-                color.append(G.degree(node))
+                node_trace["marker"]["color"] += tuple([G.degree(node)])
             else:
                 # Look for the property, otherwise look for a color code
                 # If none exist, throw an error
                 if color_method in G.nodes[node]:
-                    color.append(G.nodes[node][color_method])
+                    node_trace["marker"]["color"] += tuple(
+                        [G.nodes[node][color_method]]
+                    )
                 else:
-                    color.append(color_method)
+                    node_trace["marker"]["color"] += tuple([color_method])
 
-    node_trace = go.Scatter(
-        x=node_x,
-        y=node_y,
-        mode="markers",
-        hoverinfo="text",
-        marker=dict(
-            showscale=True,
-            colorscale="YlGnBu",
-            reversescale=True,
-            size=node_size,
-            colorbar=dict(
-                thickness=15, title=colorbar_title, xanchor="left", titleside="right"
-            ),
-            line_width=2,
-        ),
-    )
+    if show_edgetext:
+
+        edge_text_list = [
+            "\n".join(f"{k}: {v}" for k, v in vals.items())
+            for _, vals in edge_properties.items()
+        ]
 
-    node_trace.marker.color = color
-    node_trace.text = node_text_list
+        middle_node_trace["text"] = edge_text_list
 
-    return node_trace, edge_trace
+    return node_trace, edge_trace, middle_node_trace
 
 
 def _generate_figure(
-    node_trace, edge_trace, title, titlefont_size, showlegend, annotation_text
+    G,
+    node_trace,
+    edge_trace,
+    middle_node_trace,
+    title,
+    titlefont_size,
+    showlegend,
+    annotation_text,
 ):
     """
     Helper function to generate the figure for the Graph.
     """
 
+    annotations = [
+        dict(
+            text=annotation_text,
+            showarrow=False,
+            xref="paper",
+            yref="paper",
+            x=0.005,
+            y=-0.002,
+        )
+    ]
+
+    if isinstance(G, (nx.DiGraph, nx.MultiDiGraph)):
+
+        for edge in G.edges():
+            annotations.append(
+                dict(
+                    ax=G.nodes[edge[0]]["pos"][0],
+                    ay=G.nodes[edge[0]]["pos"][1],
+                    axref="x",
+                    ayref="y",
+                    x=G.nodes[edge[1]]["pos"][0],
+                    y=G.nodes[edge[1]]["pos"][1],
+                    xref="x",
+                    yref="y",
+                    showarrow=True,
+                    arrowhead=1,
+                )
+            )
+
     fig = go.Figure(
-        data=[edge_trace, node_trace],
+        data=[edge_trace, node_trace, middle_node_trace],
         layout=go.Layout(
             title=title,
             titlefont_size=titlefont_size,
             showlegend=showlegend,
             hovermode="closest",
             margin=dict(b=20, l=5, r=5, t=40),
-            annotations=[
-                dict(
-                    text=annotation_text,
-                    showarrow=False,
-                    xref="paper",
-                    yref="paper",
-                    x=0.005,
-                    y=-0.002,
-                )
-            ],
+            annotations=annotations,
             xaxis=dict(showgrid=False, zeroline=False, showticklabels=False),
             yaxis=dict(showgrid=False, zeroline=False, showticklabels=False),
         ),
diff --git a/igviz/tests/test_plot.py b/igviz/tests/test_plot.py
index d049186..13190a7 100644
--- a/igviz/tests/test_plot.py
+++ b/igviz/tests/test_plot.py
@@ -11,6 +11,30 @@ def G():
     return G
 
 
+@pytest.fixture(scope="function")
+def DG():
+    # Create a directed graph (digraph) object; i.e., a graph in which the edges
+    # have a direction associated with them.
+    G = nx.DiGraph()
+
+    # Add nodes:
+    nodes = ["A", "B", "C", "D", "E"]
+    G.add_nodes_from(nodes)
+
+    # Add edges or links between the nodes:
+    edges = [("A", "B"), ("B", "C"), ("B", "D"), ("D", "E")]
+    G.add_edges_from(edges)
+    return G
+
+
+@pytest.fixture(scope="function")
+def MG():
+    G = nx.MultiGraph()
+    G.add_weighted_edges_from([(1, 2, 0.5), (1, 2, 0.75), (2, 3, 0.5)])
+
+    return G
+
+
 def test_plot(G):
 
     ig.plot(G)
@@ -20,14 +44,14 @@ def test_plot(G):
 
 def test_plot_fixed_size_color(G):
 
-    ig.plot(G, sizing_method="static", color_method="#ffffff")
+    ig.plot(G, show_edgetext=True, size_method="static", color_method="#ffffff")
 
     assert True
 
 
 def test_plot_property(G):
 
-    ig.plot(G, sizing_method="prop", color_method="prop")
+    ig.plot(G, size_method="prop", color_method="prop")
 
     assert True
 
@@ -46,7 +70,7 @@ def test_plot_size_list(G):
     for node in G.nodes():
         size.append(3)
 
-    ig.plot(G, sizing_method=size)
+    ig.plot(G, size_method=size)
 
     assert True
 
@@ -73,3 +97,17 @@ def test_plot_layout(G):
     ig.plot(G, layout="kamada")
 
     assert True
+
+
+def test_digraph(DG):
+
+    ig.plot(DG)
+
+    assert True
+
+
+def test_multigraph(MG):
+
+    ig.plot(MG)
+
+    assert True
diff --git a/setup.py b/setup.py
index dc7f272..ecb2b47 100644
--- a/setup.py
+++ b/setup.py
@@ -1,7 +1,7 @@
 from setuptools import find_packages, setup
 from setuptools.command.install import install
 
-VERSION = "0.2.0"
+VERSION = "0.3.0"
 
 pkgs = [
     "networkx==2.4",