netweavex 1.1.0__tar.gz

netweavex-1.1.0/PKG-INFO

@@ -0,0 +1,36 @@
+Metadata-Version: 2.4
+Name: netweavex
+Version: 1.1.0
+Summary: Python package for creating and manipulating graphs and networks
+License-Expression: BSD-3-Clause
+Project-URL: Documentation, https://networkx.org/documentation/stable/
+Keywords: Networks,Graph Theory,Mathematics,network,graph,discrete mathematics,math
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Classifier: Topic :: Scientific/Engineering :: Physics
+Requires-Python: !=3.14.1,>=3.12
+Provides-Extra: default
+Requires-Dist: numpy>=2.2; extra == "default"
+Requires-Dist: scipy>=1.15; extra == "default"
+Requires-Dist: matplotlib>=3.10; extra == "default"
+Requires-Dist: pandas>=2.3; extra == "default"
+Provides-Extra: extra
+Requires-Dist: lxml>=4.6; extra == "extra"
+Requires-Dist: pygraphviz>=2.0; extra == "extra"
+Requires-Dist: pydot>=3.0.1; extra == "extra"
+Requires-Dist: sympy>=1.10; extra == "extra"
+Provides-Extra: test
+Requires-Dist: pytest>=7.2; extra == "test"
+Requires-Dist: pytest-cov>=4.0; extra == "test"
+Requires-Dist: pytest-xdist>=3.0; extra == "test"

netweavex-1.1.0/netweavex/__init__.py

@@ -0,0 +1,65 @@
+"""
+NetWeaveX
+=========
+
+NetWeaveX is a Python package for the creation, manipulation, and study of the
+structure, dynamics, and functions of complex networks.
+
+Use ``import netweavex as nx``. Classes, functions, and algorithms match
+NetworkX, including the ``"networkx"`` backend name.
+
+See https://networkx.org for complete documentation.
+"""
+
+__version__ = "1.1.0"
+
+
+# These are imported in order as listed
+from netweavex.lazy_imports import _lazy_import
+
+from netweavex.exception import *
+
+from netweavex import utils
+from netweavex.utils import _clear_cache, _dispatchable
+
+# load_and_call entry_points, set configs
+config = utils.backends._set_configs_from_environment()
+utils.config = utils.configs.config = config  # type: ignore[attr-defined]
+
+from netweavex import classes
+from netweavex.classes import filters
+from netweavex.classes import *
+
+from netweavex import convert
+from netweavex.convert import *
+
+from netweavex import convert_matrix
+from netweavex.convert_matrix import *
+
+from netweavex import relabel
+from netweavex.relabel import *
+
+from netweavex import generators
+from netweavex.generators import *
+
+from netweavex import readwrite
+from netweavex.readwrite import *
+
+# Need to test with SciPy, when available
+from netweavex import algorithms
+from netweavex.algorithms import *
+
+from netweavex import linalg
+from netweavex.linalg import *
+
+from netweavex import drawing
+from netweavex.drawing import *
+
+
+def __getattr__(name):
+    if name == "random_tree":
+        raise AttributeError(
+            "nx.random_tree was removed in version 3.4. Use `nx.random_labeled_tree` instead.\n"
+            "See: https://networkx.org/documentation/latest/release/release_3.4.html"
+        )
+    raise AttributeError(f"module 'netweavex' has no attribute '{name}'")

netweavex-1.1.0/netweavex/algorithms/__init__.py

@@ -0,0 +1,134 @@
+from netweavex.algorithms.assortativity import *
+from netweavex.algorithms.asteroidal import *
+from netweavex.algorithms.boundary import *
+from netweavex.algorithms.broadcasting import *
+from netweavex.algorithms.bridges import *
+from netweavex.algorithms.chains import *
+from netweavex.algorithms.centrality import *
+from netweavex.algorithms.chordal import *
+from netweavex.algorithms.cluster import *
+from netweavex.algorithms.clique import *
+from netweavex.algorithms.communicability_alg import *
+from netweavex.algorithms.components import *
+from netweavex.algorithms.coloring import *
+from netweavex.algorithms.core import *
+from netweavex.algorithms.covering import *
+from netweavex.algorithms.cycles import *
+from netweavex.algorithms.cuts import *
+from netweavex.algorithms.d_separation import *
+from netweavex.algorithms.dag import *
+from netweavex.algorithms.distance_measures import *
+from netweavex.algorithms.distance_regular import *
+from netweavex.algorithms.dominance import *
+from netweavex.algorithms.dominating import *
+from netweavex.algorithms.efficiency_measures import *
+from netweavex.algorithms.euler import *
+from netweavex.algorithms.graphical import *
+from netweavex.algorithms.hierarchy import *
+from netweavex.algorithms.hybrid import *
+from netweavex.algorithms.link_analysis import *
+from netweavex.algorithms.link_prediction import *
+from netweavex.algorithms.lowest_common_ancestors import *
+from netweavex.algorithms.isolate import *
+from netweavex.algorithms.matching import *
+from netweavex.algorithms.minors import *
+from netweavex.algorithms.mis import *
+from netweavex.algorithms.moral import *
+from netweavex.algorithms.non_randomness import *
+from netweavex.algorithms.operators import *
+from netweavex.algorithms.planarity import *
+from netweavex.algorithms.planar_drawing import *
+from netweavex.algorithms.polynomials import *
+from netweavex.algorithms.perfect_graph import *
+from netweavex.algorithms.reciprocity import *
+from netweavex.algorithms.regular import *
+from netweavex.algorithms.richclub import *
+from netweavex.algorithms.shortest_paths import *
+from netweavex.algorithms.similarity import *
+from netweavex.algorithms.graph_hashing import *
+from netweavex.algorithms.simple_paths import *
+from netweavex.algorithms.smallworld import *
+from netweavex.algorithms.smetric import *
+from netweavex.algorithms.structuralholes import *
+from netweavex.algorithms.sparsifiers import *
+from netweavex.algorithms.summarization import *
+from netweavex.algorithms.swap import *
+from netweavex.algorithms.time_dependent import *
+from netweavex.algorithms.traversal import *
+from netweavex.algorithms.triads import *
+from netweavex.algorithms.vitality import *
+from netweavex.algorithms.voronoi import *
+from netweavex.algorithms.walks import *
+from netweavex.algorithms.wiener import *
+
+# Make certain subpackages available to the user as direct imports from
+# the `networkx` namespace.
+from netweavex.algorithms import approximation
+from netweavex.algorithms import assortativity
+from netweavex.algorithms import bipartite
+from netweavex.algorithms import node_classification
+from netweavex.algorithms import centrality
+from netweavex.algorithms import chordal
+from netweavex.algorithms import cluster
+from netweavex.algorithms import clique
+from netweavex.algorithms import components
+from netweavex.algorithms import connectivity
+from netweavex.algorithms import community
+from netweavex.algorithms import coloring
+from netweavex.algorithms import flow
+from netweavex.algorithms import isomorphism
+from netweavex.algorithms import link_analysis
+from netweavex.algorithms import lowest_common_ancestors
+from netweavex.algorithms import operators
+from netweavex.algorithms import shortest_paths
+from netweavex.algorithms import tournament
+from netweavex.algorithms import traversal
+from netweavex.algorithms import tree
+
+# Make certain functions from some of the previous subpackages available
+# to the user as direct imports from the `networkx` namespace.
+from netweavex.algorithms.bipartite import complete_bipartite_graph
+from netweavex.algorithms.bipartite import is_bipartite
+from netweavex.algorithms.bipartite import projected_graph
+from netweavex.algorithms.connectivity import all_pairs_node_connectivity
+from netweavex.algorithms.connectivity import all_node_cuts
+from netweavex.algorithms.connectivity import average_node_connectivity
+from netweavex.algorithms.connectivity import edge_connectivity
+from netweavex.algorithms.connectivity import edge_disjoint_paths
+from netweavex.algorithms.connectivity import k_components
+from netweavex.algorithms.connectivity import k_edge_components
+from netweavex.algorithms.connectivity import k_edge_subgraphs
+from netweavex.algorithms.connectivity import k_edge_augmentation
+from netweavex.algorithms.connectivity import is_k_edge_connected
+from netweavex.algorithms.connectivity import minimum_edge_cut
+from netweavex.algorithms.connectivity import minimum_node_cut
+from netweavex.algorithms.connectivity import node_connectivity
+from netweavex.algorithms.connectivity import node_disjoint_paths
+from netweavex.algorithms.connectivity import stoer_wagner
+from netweavex.algorithms.flow import capacity_scaling
+from netweavex.algorithms.flow import cost_of_flow
+from netweavex.algorithms.flow import gomory_hu_tree
+from netweavex.algorithms.flow import max_flow_min_cost
+from netweavex.algorithms.flow import maximum_flow
+from netweavex.algorithms.flow import maximum_flow_value
+from netweavex.algorithms.flow import min_cost_flow
+from netweavex.algorithms.flow import min_cost_flow_cost
+from netweavex.algorithms.flow import minimum_cut
+from netweavex.algorithms.flow import minimum_cut_value
+from netweavex.algorithms.flow import network_simplex
+from netweavex.algorithms.isomorphism import could_be_isomorphic
+from netweavex.algorithms.isomorphism import fast_could_be_isomorphic
+from netweavex.algorithms.isomorphism import faster_could_be_isomorphic
+from netweavex.algorithms.isomorphism import is_isomorphic
+from netweavex.algorithms.isomorphism.vf2pp import *
+from netweavex.algorithms.tree.branchings import maximum_branching
+from netweavex.algorithms.tree.branchings import maximum_spanning_arborescence
+from netweavex.algorithms.tree.branchings import minimum_branching
+from netweavex.algorithms.tree.branchings import minimum_spanning_arborescence
+from netweavex.algorithms.tree.branchings import ArborescenceIterator
+from netweavex.algorithms.tree.coding import *
+from netweavex.algorithms.tree.decomposition import *
+from netweavex.algorithms.tree.mst import *
+from netweavex.algorithms.tree.operations import *
+from netweavex.algorithms.tree.recognition import *
+from netweavex.algorithms.tournament import is_tournament

netweavex-1.1.0/netweavex/algorithms/approximation/__init__.py

@@ -0,0 +1,26 @@
+"""Approximations of graph properties and Heuristic methods for optimization.
+
+The functions in this class are not imported into the top-level ``networkx``
+namespace so the easiest way to use them is with::
+
+    >>> from netweavex.algorithms import approximation
+
+Another option is to import the specific function with
+``from netweavex.algorithms.approximation import function_name``.
+
+"""
+
+from netweavex.algorithms.approximation.clustering_coefficient import *
+from netweavex.algorithms.approximation.clique import *
+from netweavex.algorithms.approximation.connectivity import *
+from netweavex.algorithms.approximation.distance_measures import *
+from netweavex.algorithms.approximation.dominating_set import *
+from netweavex.algorithms.approximation.kcomponents import *
+from netweavex.algorithms.approximation.matching import *
+from netweavex.algorithms.approximation.ramsey import *
+from netweavex.algorithms.approximation.steinertree import *
+from netweavex.algorithms.approximation.traveling_salesman import *
+from netweavex.algorithms.approximation.treewidth import *
+from netweavex.algorithms.approximation.vertex_cover import *
+from netweavex.algorithms.approximation.maxcut import *
+from netweavex.algorithms.approximation.density import *

netweavex-1.1.0/netweavex/algorithms/approximation/clique.py

@@ -0,0 +1,259 @@
+"""Functions for computing large cliques and maximum independent sets."""
+
+import netweavex as nx
+from netweavex.algorithms.approximation import ramsey
+from netweavex.utils import not_implemented_for
+
+__all__ = [
+    "clique_removal",
+    "max_clique",
+    "large_clique_size",
+    "maximum_independent_set",
+]
+
+
+@not_implemented_for("directed")
+@not_implemented_for("multigraph")
+@nx._dispatchable
+def maximum_independent_set(G):
+    """Returns an approximate maximum independent set.
+
+    Independent set or stable set is a set of vertices in a graph, no two of
+    which are adjacent. That is, it is a set I of vertices such that for every
+    two vertices in I, there is no edge connecting the two. Equivalently, each
+    edge in the graph has at most one endpoint in I. The size of an independent
+    set is the number of vertices it contains [1]_.
+
+    A maximum independent set is a largest independent set for a given graph G
+    and its size is denoted $\\alpha(G)$. The problem of finding such a set is called
+    the maximum independent set problem and is an NP-hard optimization problem.
+    As such, it is unlikely that there exists an efficient algorithm for finding
+    a maximum independent set of a graph.
+
+    The Independent Set algorithm is based on [2]_.
+
+    Parameters
+    ----------
+    G : NetworkX graph
+        Undirected graph
+
+    Returns
+    -------
+    iset : Set
+        The apx-maximum independent set
+
+    Examples
+    --------
+    >>> G = nx.path_graph(10)
+    >>> nx.approximation.maximum_independent_set(G)
+    {0, 2, 4, 6, 9}
+
+    Raises
+    ------
+    NetworkXNotImplemented
+        If the graph is directed or is a multigraph.
+
+    Notes
+    -----
+    Finds the $O(|V|/(log|V|)^2)$ apx of independent set in the worst case.
+
+    References
+    ----------
+    .. [1] `Wikipedia: Independent set
+        <https://en.wikipedia.org/wiki/Independent_set_(graph_theory)>`_
+    .. [2] Boppana, R., & Halldórsson, M. M. (1992).
+       Approximating maximum independent sets by excluding subgraphs.
+       BIT Numerical Mathematics, 32(2), 180–196. Springer.
+    """
+    iset, _ = clique_removal(G)
+    return iset
+
+
+@not_implemented_for("directed")
+@not_implemented_for("multigraph")
+@nx._dispatchable
+def max_clique(G):
+    r"""Find the Maximum Clique
+
+    Finds the $O(|V|/(log|V|)^2)$ apx of maximum clique/independent set
+    in the worst case.
+
+    Parameters
+    ----------
+    G : NetworkX graph
+        Undirected graph
+
+    Returns
+    -------
+    clique : set
+        The apx-maximum clique of the graph
+
+    Examples
+    --------
+    >>> G = nx.path_graph(10)
+    >>> nx.approximation.max_clique(G)
+    {8, 9}
+
+    Raises
+    ------
+    NetworkXNotImplemented
+        If the graph is directed or is a multigraph.
+
+    Notes
+    -----
+    A clique in an undirected graph G = (V, E) is a subset of the vertex set
+    `C \subseteq V` such that for every two vertices in C there exists an edge
+    connecting the two. This is equivalent to saying that the subgraph
+    induced by C is complete (in some cases, the term clique may also refer
+    to the subgraph).
+
+    A maximum clique is a clique of the largest possible size in a given graph.
+    The clique number `\omega(G)` of a graph G is the number of
+    vertices in a maximum clique in G. The intersection number of
+    G is the smallest number of cliques that together cover all edges of G.
+
+    https://en.wikipedia.org/wiki/Maximum_clique
+
+    References
+    ----------
+    .. [1] Boppana, R., & Halldórsson, M. M. (1992).
+        Approximating maximum independent sets by excluding subgraphs.
+        BIT Numerical Mathematics, 32(2), 180–196. Springer.
+        doi:10.1007/BF01994876
+    """
+    # finding the maximum clique in a graph is equivalent to finding
+    # the independent set in the complementary graph
+    cgraph = nx.complement(G)
+    iset, _ = clique_removal(cgraph)
+    return iset
+
+
+@not_implemented_for("directed")
+@not_implemented_for("multigraph")
+@nx._dispatchable
+def clique_removal(G):
+    r"""Repeatedly remove cliques from the graph.
+
+    Results in a $O(|V|/(\log |V|)^2)$ approximation of maximum clique
+    and independent set. Returns the largest independent set found, along
+    with found maximal cliques.
+
+    Parameters
+    ----------
+    G : NetworkX graph
+        Undirected graph
+
+    Returns
+    -------
+    max_ind_cliques : (set, list) tuple
+        2-tuple of Maximal Independent Set and list of maximal cliques (sets).
+
+    Examples
+    --------
+    >>> G = nx.path_graph(10)
+    >>> nx.approximation.clique_removal(G)
+    ({0, 2, 4, 6, 9}, [{0, 1}, {2, 3}, {4, 5}, {6, 7}, {8, 9}])
+
+    Raises
+    ------
+    NetworkXNotImplemented
+        If the graph is directed or is a multigraph.
+
+    References
+    ----------
+    .. [1] Boppana, R., & Halldórsson, M. M. (1992).
+        Approximating maximum independent sets by excluding subgraphs.
+        BIT Numerical Mathematics, 32(2), 180–196. Springer.
+    """
+    graph = G.copy()
+    c_i, i_i = ramsey.ramsey_R2(graph)
+    cliques = [c_i]
+    isets = [i_i]
+    while graph:
+        graph.remove_nodes_from(c_i)
+        c_i, i_i = ramsey.ramsey_R2(graph)
+        if c_i:
+            cliques.append(c_i)
+        if i_i:
+            isets.append(i_i)
+    # Determine the largest independent set as measured by cardinality.
+    maxiset = max(isets, key=len)
+    return maxiset, cliques
+
+
+@not_implemented_for("directed")
+@not_implemented_for("multigraph")
+@nx._dispatchable
+def large_clique_size(G):
+    """Find the size of a large clique in a graph.
+
+    A *clique* is a subset of nodes in which each pair of nodes is
+    adjacent. This function is a heuristic for finding the size of a
+    large clique in the graph.
+
+    Parameters
+    ----------
+    G : NetworkX graph
+
+    Returns
+    -------
+    k: integer
+       The size of a large clique in the graph.
+
+    Examples
+    --------
+    >>> G = nx.path_graph(10)
+    >>> nx.approximation.large_clique_size(G)
+    2
+
+    Raises
+    ------
+    NetworkXNotImplemented
+        If the graph is directed or is a multigraph.
+
+    Notes
+    -----
+    This implementation is from [1]_. Its worst case time complexity is
+    :math:`O(n d^2)`, where *n* is the number of nodes in the graph and
+    *d* is the maximum degree.
+
+    This function is a heuristic, which means it may work well in
+    practice, but there is no rigorous mathematical guarantee on the
+    ratio between the returned number and the actual largest clique size
+    in the graph.
+
+    References
+    ----------
+    .. [1] Pattabiraman, Bharath, et al.
+       "Fast Algorithms for the Maximum Clique Problem on Massive Graphs
+       with Applications to Overlapping Community Detection."
+       *Internet Mathematics* 11.4-5 (2015): 421--448.
+       <https://doi.org/10.1080/15427951.2014.986778>
+
+    See also
+    --------
+
+    :func:`netweavex.algorithms.approximation.clique.max_clique`
+        A function that returns an approximate maximum clique with a
+        guarantee on the approximation ratio.
+
+    :mod:`netweavex.algorithms.clique`
+        Functions for finding the exact maximum clique in a graph.
+
+    """
+    degrees = G.degree
+
+    def _clique_heuristic(G, U, size, best_size):
+        if not U:
+            return max(best_size, size)
+        u = max(U, key=degrees)
+        U.remove(u)
+        N_prime = {v for v in G[u] if degrees[v] >= best_size}
+        return _clique_heuristic(G, U & N_prime, size + 1, best_size)
+
+    best_size = 0
+    nodes = (u for u in G if degrees[u] >= best_size)
+    for u in nodes:
+        neighbors = {v for v in G[u] if degrees[v] >= best_size}
+        best_size = _clique_heuristic(G, neighbors, 1, best_size)
+    return best_size

netweavex-1.1.0/netweavex/algorithms/approximation/clustering_coefficient.py

@@ -0,0 +1,71 @@
+import netweavex as nx
+from netweavex.utils import not_implemented_for, py_random_state
+
+__all__ = ["average_clustering"]
+
+
+@not_implemented_for("directed")
+@py_random_state(2)
+@nx._dispatchable(name="approximate_average_clustering")
+def average_clustering(G, trials=1000, seed=None):
+    r"""Estimates the average clustering coefficient of G.
+
+    The local clustering of each node in `G` is the fraction of triangles
+    that actually exist over all possible triangles in its neighborhood.
+    The average clustering coefficient of a graph `G` is the mean of
+    local clusterings.
+
+    This function finds an approximate average clustering coefficient
+    for G by repeating `n` times (defined in `trials`) the following
+    experiment: choose a node at random, choose two of its neighbors
+    at random, and check if they are connected. The approximate
+    coefficient is the fraction of triangles found over the number
+    of trials [1]_.
+
+    Parameters
+    ----------
+    G : NetworkX graph
+
+    trials : integer
+        Number of trials to perform (default 1000).
+
+    seed : integer, random_state, or None (default)
+        Indicator of random number generation state.
+        See :ref:`Randomness<randomness>`.
+
+    Returns
+    -------
+    c : float
+        Approximated average clustering coefficient.
+
+    Examples
+    --------
+    >>> from netweavex.algorithms import approximation
+    >>> G = nx.erdos_renyi_graph(10, 0.2, seed=10)
+    >>> approximation.average_clustering(G, trials=1000, seed=10)
+    0.214
+
+    Raises
+    ------
+    NetworkXNotImplemented
+        If G is directed.
+
+    References
+    ----------
+    .. [1] Schank, Thomas, and Dorothea Wagner. Approximating clustering
+       coefficient and transitivity. Universität Karlsruhe, Fakultät für
+       Informatik, 2004.
+       https://doi.org/10.5445/IR/1000001239
+
+    """
+    n = len(G)
+    triangles = 0
+    nodes = list(G)
+    for i in [int(seed.random() * n) for i in range(trials)]:
+        nbrs = list(G[nodes[i]])
+        if len(nbrs) < 2:
+            continue
+        u, v = seed.sample(nbrs, 2)
+        if u in G[v]:
+            triangles += 1
+    return triangles / trials