iplotx 0.0.1__py3-none-any.whl → 0.2.0__py3-none-any.whl

iplotx/heuristics.py

@@ -1,114 +0,0 @@
-from collections import defaultdict
-import numpy as np
-import pandas as pd
-
-from .importing import igraph, networkx
-from .typing import GraphType, GroupingType, LayoutType
-
-
-def network_library(
-    network: GraphType,
-) -> str:
-    if igraph is not None and isinstance(network, igraph.Graph):
-        return "igraph"
-    if networkx is not None:
-        if isinstance(network, networkx.Graph):
-            return "networkx"
-        if isinstance(network, networkx.DiGraph):
-            return "networkx"
-        if isinstance(network, networkx.MultiGraph):
-            return "networkx"
-        if isinstance(network, networkx.MultiDiGraph):
-            return "networkx"
-    raise TypeError("Unsupported graph type. Supported types are igraph and networkx.")
-
-
-def detect_directedness(
-    network: GraphType,
-) -> np.ndarray:
-    """Detect if the network is directed or not."""
-    if network_library(network) == "igraph":
-        return network.is_directed()
-    if isinstance(network, (networkx.DiGraph, networkx.MultiDiGraph)):
-        return True
-    return False
-
-
-def normalise_layout(layout):
-    """Normalise the layout to a pandas.DataFrame."""
-    if layout is None:
-        return None
-    if isinstance(layout, dict):
-        layout = pd.DataFrame(layout).T
-    if isinstance(layout, str):
-        raise NotImplementedError("Layout as a string is not supported yet.")
-    if isinstance(layout, (list, tuple)):
-        return pd.DataFrame(np.array(layout))
-    if isinstance(layout, pd.DataFrame):
-        return layout
-    if isinstance(layout, np.ndarray):
-        return pd.DataFrame(layout)
-    raise TypeError(
-        "Layout must be a string, list, tuple, numpy array or pandas DataFrame."
-    )
-
-
-def normalise_grouping(
-    grouping: GroupingType,
-    layout: LayoutType,
-) -> dict[set]:
-
-    if len(grouping) == 0:
-        return {}
-
-    if isinstance(grouping, dict):
-        val0 = next(iter(grouping.values()))
-        # If already the right data type or compatible, leave as is
-        if isinstance(val0, (set, frozenset)):
-            return grouping
-
-        # If a dict of integers or strings, assume each key is a vertex id and each value is a
-        # group, convert (i.e. invert the dict)
-        if isinstance(val0, (int, str)):
-            group_dic = defaultdict(set)
-            for key, val in grouping.items():
-                group_dic[val].add(key)
-            return group_dic
-
-    # If an igraph object, convert to a dict of sets
-    if igraph is not None:
-        if isinstance(grouping, igraph.clustering.Clustering):
-            layout = normalise_layout(layout)
-            group_dic = defaultdict(set)
-            for i, member in enumerate(grouping.membership):
-                group_dic[member].add(i)
-            return group_dic
-
-        if isinstance(grouping, igraph.clustering.Cover):
-            layout = normalise_layout(layout)
-            group_dic = defaultdict(set)
-            for i, members in enumerate(grouping.membership):
-                for member in members:
-                    group_dic[member].add(i)
-            return group_dic
-
-    # Assume it's a sequence, so convert to list
-    grouping = list(grouping)
-
-    # If the values are already sets, assume group indices are integers
-    # and values are as is
-    if isinstance(grouping[0], set):
-        group_dic = {i: val for i, val in enumerate(grouping)}
-        return group_dic
-
-    # If the values are integers or strings, assume each key is a vertex id and each value is a
-    # group, convert to dict of sets
-    if isinstance(grouping[0], (int, str)):
-        group_dic = defaultdict(set)
-        for i, val in enumerate(grouping):
-            group_dic[val].add(i)
-        return group_dic
-
-    raise TypeError(
-        "Could not standardise grouping from object.",
-    )

iplotx/importing.py

@@ -1,13 +0,0 @@
-try:
-    import igraph
-except ImportError:
-    igraph = None
-
-try:
-    import networkx
-except ImportError:
-    networkx = None
-
-if igraph is None and networkx is None:
-    raise ImportError("At least one of igraph or networkx must be installed to use this module.")
-

iplotx/styles.py

@@ -1,186 +0,0 @@
-from typing import Union, Sequence, Hashable
-from copy import deepcopy
-from contextlib import contextmanager
-import numpy as np
-import pandas as pd
-
-
-style_leaves = (
-    "edgecolor",
-    "facecolor",
-    "linewidth",
-    "linestyle",
-    "alpha",
-    "zorder",
-)
-
-
-default = {
-    "vertex": {
-        "size": 20,
-        "facecolor": "black",
-        "marker": "o",
-        "label": {
-            "horizontalalignment": "center",
-            "verticalalignment": "center",
-            "hpadding": 18,
-            "vpadding": 12,
-        },
-    },
-    "edge": {
-        "linewidth": 1.5,
-        "linestyle": "-",
-        "color": "black",
-        "curved": False,
-        "offset": 3,
-        "tension": 1,
-        "label": {
-            "horizontalalignment": "center",
-            "verticalalignment": "center",
-        },
-    },
-    "arrow": {
-        "marker": "|>",
-        "width": 8,
-        "color": "black",
-    },
-    "grouping": {
-        "facecolor": ["grey", "steelblue", "tomato"],
-        "edgecolor": "black",
-        "linewidth": 1.5,
-        "alpha": 0.5,
-        "vertexpadding": 25,
-    },
-}
-
-hollow = deepcopy(default)
-hollow["vertex"]["color"] = None
-hollow["vertex"]["facecolor"] = "none"
-hollow["vertex"]["edgecolor"] = "black"
-hollow["vertex"]["linewidth"] = 1.5
-hollow["vertex"]["marker"] = "r"
-hollow["vertex"]["size"] = "label"
-
-
-styles = {
-    "default": default,
-    "hollow": hollow,
-}
-
-
-stylename = "default"
-
-
-current = deepcopy(styles["default"])
-
-
-def get_stylename():
-    """Return the name of the current iplotx style."""
-    return str(stylename)
-
-
-def get_style(name: str = ""):
-    namelist = name.split(".")
-    style = styles
-    for i, namei in enumerate(namelist):
-        if (i == 0) and (namei == ""):
-            style = current
-        else:
-            try:
-                style = style[namei]
-            except KeyError:
-                raise KeyError(f"Style not found: {name}")
-
-    style = deepcopy(style)
-    return style
-
-
-# The following is inspired by matplotlib's style library
-# https://github.com/matplotlib/matplotlib/blob/v3.10.3/lib/matplotlib/style/core.py#L45
-def use(style: Union[str, dict, Sequence]):
-    """Use iplotx style setting for a style specification.
-
-    The style name of 'default' is reserved for reverting back to
-    the default style settings.
-
-    Parameters:
-        style: A style specification, currently either a name of an existing style
-            or a dict with specific parts of the style to override. The string
-            "default" resets the style to the default one. If this is a sequence,
-            each style is applied in order.
-    """
-    global current
-
-    def _update(style: dict, current: dict):
-        for key, value in style.items():
-            if key not in current:
-                current[key] = value
-                continue
-
-            # Style leaves are by definition not to be recurred into
-            if isinstance(value, dict) and (key not in style_leaves):
-                _update(value, current[key])
-            elif value is None:
-                del current[key]
-            else:
-                current[key] = value
-
-    if isinstance(style, (dict, str)):
-        styles = [style]
-    else:
-        styles = style
-
-    for style in styles:
-        if style == "default":
-            reset()
-        else:
-            if isinstance(style, str):
-                current = get_style(style)
-            else:
-                _update(style, current)
-
-
-def reset():
-    """Reset to default style."""
-    global current
-    current = deepcopy(styles["default"])
-
-
-@contextmanager
-def stylecontext(style: Union[str, dict, Sequence]):
-    current = get_style()
-    try:
-        use(style)
-        yield
-    finally:
-        use(current)
-
-
-def rotate_style(
-    style,
-    index: Union[int, None] = None,
-    id: Union[Hashable, None] = None,
-    props=style_leaves,
-):
-    if (index is None) and (id is None):
-        raise ValueError(
-            "At least one of 'index' or 'id' must be provided to rotate_style."
-        )
-
-    style = deepcopy(style)
-
-    for prop in props:
-        val = style.get(prop, None)
-        if val is None:
-            continue
-        # NOTE: this assumes that these properties are leaves of the style tree
-        # Btw: dict includes defaultdict, Couter, etc.
-        if (id is not None) and isinstance(val, (dict, pd.Series)):
-            # This works on both dict-like and Series
-            style[prop] = val[id]
-        elif (index is not None) and isinstance(
-            val, (tuple, list, np.ndarray, pd.Index, pd.Series)
-        ):
-            style[prop] = np.asarray(val)[index % len(val)]
-
-    return style

iplotx-0.0.1.dist-info/METADATA

@@ -1,39 +0,0 @@
-Metadata-Version: 2.4
-Name: iplotx
-Version: 0.0.1
-Summary: Plot networkx from igraph and networkx.
-Project-URL: Homepage, https://github.com/fabilab/iplotx
-Project-URL: Documentation, https://readthedocs.org/iplotx
-Project-URL: Repository, https://github.com/fabilab/iplotx.git
-Project-URL: Bug Tracker, https://github.com/fabilab/iplotx/issues
-Project-URL: Changelog, https://github.com/fabilab/iplotx/blob/main/CHANGELOG.md
-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: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Requires-Dist: matplotlib>=2.0.0
-Requires-Dist: pandas>=2.0.0
-Description-Content-Type: text/markdown
-
-# iplotx
-Plotting networks from igraph and networkx.
-
-**NOTE**: This is currently pre-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.
-
-## Roadmap
-- Plot networks from igraph and networkx interchangeably, using matplotlib as a backend. ✅
-- Support interactive plotting, e.g. zooming and panning after the plot is created. ✅
-- Support storing the plot to disk thanks to the many matplotlib backends (SVG, PNG, PDF, etc.).
-- Efficient plotting of large graphs using matplotlib's collection functionality. ✅ (partially)
-- Support animations, e.g. showing the evolution of a network over time. 🏗️
-- Support uni- and bi-directional communication between graph object and plot object.🏗️
-
-## Authors
-Fabio Zanini (https://fabilab.org)

iplotx-0.0.1.dist-info/RECORD

@@ -1,20 +0,0 @@
-iplotx/__init__.py,sha256=VrbOJwPlhb_wEeyCU0OcfiNde_SJqYmHwa1Qh2trHvE,60
-iplotx/groups.py,sha256=PplZgemEEg7b285fwV--08yIIomRTgg0xxyvvHeoBp8,4289
-iplotx/heuristics.py,sha256=bnfetQRxZA-Ii2V61XH7VYnvvG6DyKqiH2iOsA5la9o,3810
-iplotx/importing.py,sha256=GCzbQ4X8BAk0Cv9Nue-B-3vHiCmGHmF6pVPIVRUhGI8,267
-iplotx/network.py,sha256=jipKjV6NtVteUoqeSTRc1kfkmRfTT0L8uEPCLt_ipJ4,18070
-iplotx/plotting.py,sha256=Isdvxb8tAGhWPNHiEC-KG9TQb5C1_5s_F9C7NGP-p5Y,3389
-iplotx/styles.py,sha256=lHn-NRQ0CkG7dWe-J1wuGa-rH8ut4dqBa8rLGbqk1Ig,4679
-iplotx/typing.py,sha256=0RrZqEKsC9rSnPQIKg-br1g2w5wDVpTzrlx04rKnN0Y,1304
-iplotx/version.py,sha256=sXLh7g3KC4QCFxcZGBTpG2scR7hmmBsMjq6LqRptkRg,22
-iplotx/vertex.py,sha256=qP6V9eAoC6zb9uD00sxUlIWnEPbMxLeQRJoiKVCubLU,3485
-iplotx/edge/arrow.py,sha256=gUvTXVFG8e9G0qeztljqHVTZwYSCrhIDj0HGq3anenk,3876
-iplotx/edge/common.py,sha256=62CCsA_1z9qhKIgSEbnfxzj9elKxPDv0REbLewKnnqo,1445
-iplotx/edge/directed.py,sha256=zUU0vJApasNcvIApNGYy_x0NDnVyStgCKJn5J6U3tW4,5059
-iplotx/edge/label.py,sha256=rutePN_WEIT8IR7FSRrvsoIJw2WoFWDSHCh0dmHeJTI,1407
-iplotx/edge/undirected.py,sha256=LfDHqUP5zEBuf69lyOhUU_tk5ZGCJyw5xL3eZnTk7OU,14799
-iplotx/utils/geometry.py,sha256=3HIsH_Nek_m41vL7twvgmDYfhlJURYd5TbMaa15nyt8,7804
-iplotx/utils/matplotlib.py,sha256=I4Lw6vMPIgKMyqcR6RQBiRPKnmi5ko_GAtG04cT5XPw,3972
-iplotx-0.0.1.dist-info/METADATA,sha256=xG3Y-FukA2CGxLHBB5t33kxnT56rbxlpDpsfvZQ-J1A,1932
-iplotx-0.0.1.dist-info/WHEEL,sha256=tkmg4JIqwd9H8mL30xA7crRmoStyCtGp0VWshokd1Jc,105
-iplotx-0.0.1.dist-info/RECORD,,