python-graphblas 2023.5.0__tar.gz → 2023.7.0__tar.gz

{python-graphblas-2023.5.0 → python-graphblas-2023.7.0}/LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2020 Anaconda, Inc
+   Copyright 2020-2023 Anaconda, Inc. and contributors
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

{python-graphblas-2023.5.0 → python-graphblas-2023.7.0}/MANIFEST.in

@@ -2,11 +2,9 @@ recursive-include graphblas *.py
 prune docs
 prune scripts
 include setup.py
+include conftest.py
 include README.md
 include LICENSE
 include MANIFEST.in
 include graphblas/graphblas.yaml
 include graphblas/tests/pickle*.pkl
-include docs/_static/img/logo-name-medium.svg
-include docs/_static/img/draw-example.png
-include docs/_static/img/repr-matrix.png

{python-graphblas-2023.5.0/python_graphblas.egg-info → python-graphblas-2023.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: python-graphblas
-Version: 2023.5.0
+Version: 2023.7.0
 Summary: Python library for GraphBLAS: high-performance sparse linear algebra for scalable graph analytics
 Author: Jim Kitchen, Python-graphblas contributors
 Author-email: Erik Welch <erik.n.welch@gmail.com>
@@ -193,7 +193,7 @@ License:                                  Apache License
               same "printed page" as the copyright notice for easier
               identification within third-party archives.
         
-           Copyright 2020 Anaconda, Inc
+           Copyright 2020-2023 Anaconda, Inc. and contributors
         
            Licensed under the Apache License, Version 2.0 (the "License");
            you may not use this file except in compliance with the License.
@@ -248,7 +248,7 @@ Provides-Extra: default
 Provides-Extra: all
 License-File: LICENSE
 
-![Python-graphblas](docs/_static/img/logo-name-medium.svg)
+![Python-graphblas](https://raw.githubusercontent.com/python-graphblas/python-graphblas/main/docs/_static/img/logo-name-medium.svg)
 
 [![conda-forge](https://img.shields.io/conda/vn/conda-forge/python-graphblas.svg)](https://anaconda.org/conda-forge/python-graphblas)
 [![pypi](https://img.shields.io/pypi/v/python-graphblas.svg)](https://pypi.python.org/pypi/python-graphblas/)
@@ -278,8 +278,8 @@ For algorithms, see
 - **Chat via Discord:** [https://discord.com/invite/vur45CbwMz](https://discord.com/invite/vur45CbwMz) in the [#graphblas channel](https://discord.com/channels/786703927705862175/1024732940233605190)
 
 <p float="left">
-  <img src="docs/_static/img/draw-example.png" width="231" align="top" alt="Directed graph", title="Directed graph"/>
-  <img src="docs/_static/img/repr-matrix.png" width="231" align="top" alt="Adjacency matrix" title="Adjacency matrix"/>
+  <img src="https://raw.githubusercontent.com/python-graphblas/python-graphblas/main/docs/_static/img/draw-example.png" width="231" align="top" alt="Directed graph", title="Directed graph"/>
+  <img src="https://raw.githubusercontent.com/python-graphblas/python-graphblas/main/docs/_static/img/repr-matrix.png" width="231" align="top" alt="Adjacency matrix" title="Adjacency matrix"/>
 </p>
 
 ## Install
@@ -426,8 +426,9 @@ use as well as the blocking/non-blocking mode. If the context is not initialized
 be performed automatically.
 ```python
 import graphblas as gb
+
 # Context initialization must happen before any other imports
-gb.init('suitesparse', blocking=True)
+gb.init("suitesparse", blocking=True)
 
 # Now we can import other items from graphblas
 from graphblas import binary, semiring
@@ -445,7 +446,7 @@ def force_odd_func(x):
         return x + 1
     return x
 
-unary.register_new('force_odd', force_odd_func)
+unary.register_new("force_odd", force_odd_func)
 
 v = Vector.from_coo([0, 1, 3], [1, 2, 3])
 w = v.apply(unary.force_odd).new()
@@ -453,6 +454,22 @@ w  # indexes=[0, 1, 3], values=[1, 3, 3]
 ```
 Similar methods exist for BinaryOp, Monoid, and Semiring.
 
+## Relation to other network analysis libraries
+Python-graphblas aims to provide an efficient and consistent expression
+of graph operations using linear algebra. This allows the development of
+high-performance implementations of existing and new graph algorithms
+(also see [`graphblas-algorithms`](https://github.com/python-graphblas/graphblas-algorithms)).
+
+While end-to-end analysis can be done using `python-graphblas`, users
+might find that other libraries in the Python ecosystem provide a more
+convenient high-level interface for data pre-processing and transformation
+(e.g. `pandas`, `scipy.sparse`), visualization (e.g. `networkx`, `igraph`),
+interactive exploration and analysis (e.g. `networkx`, `igraph`) or for
+algorithms that are not (yet) implemented in `graphblas-algorithms` (e.g.
+`networkx`, `igraph`, `scipy.sparse.csgraph`). To facilitate communication with
+other libraries, `graphblas.io` contains multiple connectors, see the
+following section.
+
 ## Import/Export connectors to the Python ecosystem
 `graphblas.io` contains functions for converting to and from:
 ```python
@@ -460,7 +477,7 @@ import graphblas as gb
 
 # scipy.sparse matrices
 A = gb.io.from_scipy_sparse(m)
-m = gb.io.to_scipy_sparse(m, format='csr')
+m = gb.io.to_scipy_sparse(m, format="csr")
 
 # networkx graphs
 A = gb.io.from_networkx(g)

{python-graphblas-2023.5.0 → python-graphblas-2023.7.0}/README.md

@@ -1,4 +1,4 @@
-![Python-graphblas](docs/_static/img/logo-name-medium.svg)
+![Python-graphblas](https://raw.githubusercontent.com/python-graphblas/python-graphblas/main/docs/_static/img/logo-name-medium.svg)
 
 [![conda-forge](https://img.shields.io/conda/vn/conda-forge/python-graphblas.svg)](https://anaconda.org/conda-forge/python-graphblas)
 [![pypi](https://img.shields.io/pypi/v/python-graphblas.svg)](https://pypi.python.org/pypi/python-graphblas/)
@@ -28,8 +28,8 @@ For algorithms, see
 - **Chat via Discord:** [https://discord.com/invite/vur45CbwMz](https://discord.com/invite/vur45CbwMz) in the [#graphblas channel](https://discord.com/channels/786703927705862175/1024732940233605190)
 
 <p float="left">
-  <img src="docs/_static/img/draw-example.png" width="231" align="top" alt="Directed graph", title="Directed graph"/>
-  <img src="docs/_static/img/repr-matrix.png" width="231" align="top" alt="Adjacency matrix" title="Adjacency matrix"/>
+  <img src="https://raw.githubusercontent.com/python-graphblas/python-graphblas/main/docs/_static/img/draw-example.png" width="231" align="top" alt="Directed graph", title="Directed graph"/>
+  <img src="https://raw.githubusercontent.com/python-graphblas/python-graphblas/main/docs/_static/img/repr-matrix.png" width="231" align="top" alt="Adjacency matrix" title="Adjacency matrix"/>
 </p>
 
 ## Install
@@ -176,8 +176,9 @@ use as well as the blocking/non-blocking mode. If the context is not initialized
 be performed automatically.
 ```python
 import graphblas as gb
+
 # Context initialization must happen before any other imports
-gb.init('suitesparse', blocking=True)
+gb.init("suitesparse", blocking=True)
 
 # Now we can import other items from graphblas
 from graphblas import binary, semiring
@@ -195,7 +196,7 @@ def force_odd_func(x):
         return x + 1
     return x
 
-unary.register_new('force_odd', force_odd_func)
+unary.register_new("force_odd", force_odd_func)
 
 v = Vector.from_coo([0, 1, 3], [1, 2, 3])
 w = v.apply(unary.force_odd).new()
@@ -203,6 +204,22 @@ w  # indexes=[0, 1, 3], values=[1, 3, 3]
 ```
 Similar methods exist for BinaryOp, Monoid, and Semiring.
 
+## Relation to other network analysis libraries
+Python-graphblas aims to provide an efficient and consistent expression
+of graph operations using linear algebra. This allows the development of
+high-performance implementations of existing and new graph algorithms
+(also see [`graphblas-algorithms`](https://github.com/python-graphblas/graphblas-algorithms)).
+
+While end-to-end analysis can be done using `python-graphblas`, users
+might find that other libraries in the Python ecosystem provide a more
+convenient high-level interface for data pre-processing and transformation
+(e.g. `pandas`, `scipy.sparse`), visualization (e.g. `networkx`, `igraph`),
+interactive exploration and analysis (e.g. `networkx`, `igraph`) or for
+algorithms that are not (yet) implemented in `graphblas-algorithms` (e.g.
+`networkx`, `igraph`, `scipy.sparse.csgraph`). To facilitate communication with
+other libraries, `graphblas.io` contains multiple connectors, see the
+following section.
+
 ## Import/Export connectors to the Python ecosystem
 `graphblas.io` contains functions for converting to and from:
 ```python
@@ -210,7 +227,7 @@ import graphblas as gb
 
 # scipy.sparse matrices
 A = gb.io.from_scipy_sparse(m)
-m = gb.io.to_scipy_sparse(m, format='csr')
+m = gb.io.to_scipy_sparse(m, format="csr")
 
 # networkx graphs
 A = gb.io.from_networkx(g)

python-graphblas-2023.7.0/conftest.py

@@ -0,0 +1,42 @@
+def pytest_addoption(parser):
+    parser.addoption(
+        "--backend",
+        action="store",
+        default=None,
+        help="name of a graphblas backend",
+    )
+    parser.addoption("--runslow", default=None, action="store_true", help="run slow tests")
+    parser.addoption(
+        "--blocking",
+        dest="blocking",
+        default=None,
+        action="store_true",
+        help="run in blocking mode",
+    )
+    parser.addoption(
+        "--nonblocking",
+        "--no-blocking",
+        "--noblocking",
+        "--non-blocking",
+        dest="blocking",
+        action="store_false",
+        help="run in non-blocking mode",
+    )
+    parser.addoption(
+        "--record",
+        dest="record",
+        default=None,
+        action="store_true",
+        help="Record GraphBLAS C calls and save to 'record.txt'",
+    )
+    parser.addoption(
+        "--mapnumpy", action="store_true", default=None, help="map numpy ops to GraphBLAS ops"
+    )
+    parser.addoption(
+        "--nomapnumpy",
+        "--no-mapnumpy",
+        dest="mapnumpy",
+        action="store_false",
+        help="don't map numpy ops to GraphBLAS ops",
+    )
+    parser.addoption("--randomly", action="store_true", help="run random test config")

{python-graphblas-2023.5.0 → python-graphblas-2023.7.0}/graphblas/agg/__init__.py

@@ -1,4 +1,4 @@
-"""`graphblas.agg` is an experimental module for exploring Aggregators.
+"""``graphblas.agg`` is an experimental module for exploring Aggregators.
 
 Aggregators may be used in reduce methods:
     - Matrix.reduce_rowwise
@@ -59,9 +59,9 @@ Custom recipes (specific to SuiteSparse:GraphBLAS):
     - ss.argmax
 
 .. deprecated:: 2023.1.0
-    Aggregators `first`, `last`, `first_index`, `last_index`, `argmin`, and `argmax` are
-    deprecated in the `agg` namespace such as `agg.first`. Use them from `agg.ss` namespace
-    instead such as `agg.ss.first`. Will be removed in version 2023.9.0 or later.
+    Aggregators ``first``, ``last``, ``first_index``, ``last_index``, ``argmin``, and ``argmax``
+    are deprecated in the ``agg`` namespace such as ``agg.first``. Use them from ``agg.ss``
+    namespace instead such as ``agg.ss.first``. Will be removed in version 2023.9.0 or later.
 
 # Possible aggregators:
 #   - absolute_deviation, sum(abs(x - mean(x))),  sum_absminus(x, mean(x))

python-graphblas-2023.7.0/graphblas/binary/ss.py

@@ -0,0 +1,6 @@
+from ..core import operator
+from ..core.ss.binary import register_new  # noqa: F401
+
+_delayed = {}
+
+del operator

{python-graphblas-2023.5.0 → python-graphblas-2023.7.0}/graphblas/core/agg.py

@@ -1,8 +1,8 @@
 """graphblas.core.agg namespace is deprecated; please use graphblas.core.operator.agg instead.
 
 .. deprecated:: 2023.3.0
-`graphblas.core.agg` will be removed in a future release.
-Use `graphblas.core.operator.agg` instead.
+``graphblas.core.agg`` will be removed in a future release.
+Use ``graphblas.core.operator.agg`` instead.
 Will be removed in version 2023.11.0 or later.
 
 """

{python-graphblas-2023.5.0 → python-graphblas-2023.7.0}/graphblas/core/automethods.py

@@ -1,6 +1,6 @@
 """Define functions to use as property methods on expressions.
 
-These will automatically compute the value and avoid the need for `.new()`.
+These will automatically compute the value and avoid the need for ``.new()``.
 
 To automatically create the functions, run:
 

{python-graphblas-2023.5.0 → python-graphblas-2023.7.0}/graphblas/core/base.py

@@ -348,7 +348,7 @@ class BaseType:
                         return
                     if opts:
                         # Ignore opts for now
-                        descriptor_lookup(**opts)
+                        desc = descriptor_lookup(**opts)
                     self.value = expr
                     return
 
@@ -371,7 +371,7 @@ class BaseType:
                 else:
                     if opts:
                         # Ignore opts for now
-                        descriptor_lookup(**opts)
+                        desc = descriptor_lookup(**opts)
                     self.value = expr
                     return
             else:
@@ -571,7 +571,7 @@ class BaseExpression:
         ):
             if opts:
                 # Ignore opts for now
-                descriptor_lookup(**opts)
+                desc = descriptor_lookup(**opts)  # noqa: F841 (keep desc in scope for context)
             if self._is_scalar and self._value._is_cscalar != is_cscalar:
                 return self._value.dup(is_cscalar=is_cscalar, name=name)
             rv = self._value

{python-graphblas-2023.5.0 → python-graphblas-2023.7.0}/graphblas/core/descriptor.py

@@ -26,6 +26,7 @@ class Descriptor:
         self.mask_structure = mask_structure
         self.transpose_first = transpose_first
         self.transpose_second = transpose_second
+        self._context = None  # Used by SuiteSparse:GraphBLAS 8
 
     @property
     def _carg(self):