arrowspace 0.24.7__cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

arrowspace/__init__.py

@@ -0,0 +1,5 @@
+from .arrowspace import *
+
+__doc__ = arrowspace.__doc__
+if hasattr(arrowspace, "__all__"):
+    __all__ = arrowspace.__all__

arrowspace-0.24.7.dist-info/METADATA

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: arrowspace
+Version: 0.24.7
+Classifier: Programming Language :: Rust
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Database :: Front-Ends
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Rust
+Classifier: Operating System :: OS Independent
+License-File: LICENSE
+Summary: Python bindings for ArrowSpace (Rust) providing graph-based similarity search, signal graphs, and spectral methods for vector data.
+Keywords: vector-search,spectral-analysis,graph-signal,similarity-search,machine-learning
+Home-Page: https://github.com/tuned-org-uk/pyarrowspace
+License-Expression: MIT OR Apache-2.0
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Homepage, https://github.com/tuned-org-uk/pyarrowspace
+Project-URL: Repository, https://github.com/tuned-org-uk/pyarrowspace.git
+
+# pyarrowspace
+
+Python bindings for [`arrowspace-rs`](https://github.com/Mec-iS/arrowspace-rs). This is experimental software meant for research at current state.
+
+This is the starting repository for `arrowspace`, it is made public as a showcase for the Python interface, to collect feedback and make public some results of the tests run. To run needs the `arrowspace-rs` Rust module in a sibling directory.
+
+For labs and tests please see [tests/](https://github.com/tuned-org-uk/pyarrowspace/tree/main/tests)
+
+## Installation
+From PyPi:
+```
+pip install arrowspace
+```
+or any other way of installing a Python library.
+
+If you have cargo installed, to compile the libraries involved (from crates.io): 
+```
+pip install maturin[patchelf]
+maturin develop
+```
+
+## Tests
+Simple test:
+```
+python tests/test_0.py
+```
+Test with public QA dataset:
+```
+python tests/test_1_quora_questions.py
+```
+There are other tests but they require downloadin a dataset separately or fine-tuning the embeddings on a given dataset. Give it a try and let me know!
+
+## Simplest Example
+
+```python
+from arrowspace import ArrowSpaceBuilder
+import numpy as np
+
+items: np.array = np.array(
+    [[0.1, 0.2, 0.3], [0.0, 0.5, 0.1], [0.9, 0.1, 0.0]],
+    dtype = np.float64
+)
+
+graph_params: dict = {
+    "eps": 1.0,
+    "k": 6,
+    "topk": 3,
+    "p": 2.0,
+    "sigma": 1.0,
+}
+
+# Create an ArrowSpace instance, returning the computed
+# signal graph and lambdas
+aspace, gl = ArrowSpaceBuilder.build(graph_params, items)
+
+# Search comparable items
+# defaults: k = nitems, alpha = 0.9, beta = 0.1
+query: np.array = np.array(
+    [0.05, 0.2, 0.25],
+    dtype = np.float64
+)
+
+tau: float = 1.0
+hits: list = aspace.search(query, gl, tau)
+
+# Search returns a list of `(index, score`) tuples, where
+# expected value from the code above show the first index
+# having the top score, i.e., being nearest.
+
+print(hits)
+# [ (0, 0.989743318610787), (1, 0.7565344158360029), (2, 0.22151940739207396) ]
+```
+

arrowspace-0.24.7.dist-info/RECORD

@@ -0,0 +1,6 @@
+arrowspace/__init__.py,sha256=jspivnl2iF9Hv5mFfJCt-SsKYyP2J5blPMb4EJ3paWY,123
+arrowspace/arrowspace.cpython-312-aarch64-linux-gnu.so,sha256=3iM6IrulPUm6ckDFKlRKjaInCWq8SjfOq47rqTjbtYw,14424816
+arrowspace-0.24.7.dist-info/METADATA,sha256=D3Hda3oFDVoqjyauSVi17yTxZDhrQzGVPvWH6Vt_-hg,3700
+arrowspace-0.24.7.dist-info/WHEEL,sha256=KcEHwgAOZpA9KJU2GQ8nSDlv3GY4rKutl6LoPPnipro,149
+arrowspace-0.24.7.dist-info/licenses/LICENSE,sha256=WvNgHrGIDgEKWptL6-w8Gf1PTNBHPManklmdOk_dnF4,592
+arrowspace-0.24.7.dist-info/RECORD,,

arrowspace-0.24.7.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: maturin (1.11.4)
+Root-Is-Purelib: false
+Tag: cp312-cp312-manylinux_2_17_aarch64
+Tag: cp312-cp312-manylinux2014_aarch64

arrowspace-0.24.7.dist-info/licenses/LICENSE

@@ -0,0 +1,13 @@
+   Copyright [2025] tuned.org.uk, Mec-iS
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.