qumat 0.0.1__tar.gz → 0.5.0__tar.gz

qumat-0.5.0/.gitignore

@@ -0,0 +1,54 @@
+
+output-asf-email-examples/
+.checkstyle
+.ruleset
+.pmd
+.classpath
+.project
+.settings/
+.idea/
+.DS_Store
+.cache
+*.iml
+target/
+examples/bin/tmp
+output
+community/mr/build/
+community/mr/input/
+community/mr/output/
+community/mr/testdata/
+community/mr/temp
+temp
+foo
+math-tests/
+metastore_db/*
+bin/derby.log
+bin/metastore_db
+*.jar
+*.log
+
+# Jekyll (legacy)
+website/_site
+website/Gemfile.lock
+website/.bundle
+website/.sass-cache
+
+# Docusaurus build artifacts (synced from /docs)
+website/blog/
+website-new/
+
+*.iml
+.idea
+
+
+# Python environments
+venv/
+.venv/
+
+# Python cache and compiled files
+__pycache__/
+*.pyc
+*.pyo
+
+# Testing and type checking (project uses these)
+.pytest_cache/

{qumat-0.0.1 → qumat-0.5.0}/LICENSE

@@ -202,77 +202,6 @@
    limitations under the License.
 
 
-==========================================================
-CERN Colt Java Library
-==========================================================
-Copyright © 1999 CERN - European Organization for Nuclear Research.<br/><br/>
-
-Permission to use, copy, modify, distribute and sell this software and its documentation for any purpose
-is hereby granted without fee, provided that the above copyright notice appear in all copies and
-that both that copyright notice and this permission notice appear in supporting documentation.
-CERN makes no representations about the suitability of this software for any purpose.
-It is provided "as is" without expressed or implied warranty.
-
-[Mahout note:  We have included, as source, parts of the CERN Colt Java Matrix library as a Module
-in the Mahout source tree. The parts included are those in cern.colt* , cern.jet*, cern.clhep.
-We have excluded the hep.aida* packages.]
-
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/Arrays.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/OldQRDecomposition.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/PersistentObject.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/QRDecomposition.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/SingularValueDecomposition.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/Swapper.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/collections/Arithmetic.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/collections/Constants.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/function/DoubleDoubleFunction.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/function/DoubleFunction.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/function/Functions.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/function/IntFunction.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/function/IntIntDoubleFunction.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/function/Mult.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/function/ObjectProcedure.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/function/PlusMult.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/jet/math/Arithmetic.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/jet/math/Constants.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/jet/math/Polynomial.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/jet/random/AbstractContinuousDistribution.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/jet/random/AbstractDiscreteDistribution.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/jet/random/AbstractDistribution.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/jet/random/Exponential.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/jet/random/Gamma.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/jet/random/NegativeBinomial.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/jet/random/Normal.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/jet/random/Poisson.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/jet/random/Uniform.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/jet/random/engine/MersenneTwister.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/jet/random/engine/RandomEngine.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/jet/random/sampling/RandomSampler.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/jet/stat/Gamma.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/jet/stat/Probability.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/list/AbstractList.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/list/AbstractObjectList.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/list/ObjectArrayList.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/list/SimpleLongArrayList.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/map/HashFunctions.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/map/OpenHashMap.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/map/QuickOpenIntIntHashMap.java
-  apache-mahout-14.1/core/src/main/java/org/apache/mahout/math/set/AbstractSet.java
-  apache-mahout-14.1/core/src/main/java-templates/org/apache/mahout/math/buffer/ValueTypeBufferConsumer.java.t
-  apache-mahout-14.1/core/src/main/java-templates/org/apache/mahout/math/function/KeyTypeObjectProcedure.java.t
-  apache-mahout-14.1/core/src/main/java-templates/org/apache/mahout/math/function/KeyTypeProcedure.java.t
-  apache-mahout-14.1/core/src/main/java-templates/org/apache/mahout/math/function/KeyTypeProcedure.java.t
-  apache-mahout-14.1/core/src/main/java-templates/org/apache/mahout/math/function/ObjectValueTypeProcedure.java.t
-  apache-mahout-14.1/core/src/main/java-templates/org/apache/mahout/math/function/ObjectValueTypeProcedure.java.t
-  apache-mahout-14.1/core/src/main/java-templates/org/apache/mahout/math/list/AbstractValueTypeList.java.t
-  apache-mahout-14.1/core/src/main/java-templates/org/apache/mahout/math/list/ValueTypeArrayList.java.t
-  apache-mahout-14.1/core/src/main/java-templates/org/apache/mahout/math/map/AbstractKeyTypeObjectMap.java.t
-  apache-mahout-14.1/core/src/main/java-templates/org/apache/mahout/math/map/AbstractKeyTypeValueTypeMap.java.t
-  apache-mahout-14.1/core/src/main/java-templates/org/apache/mahout/math/map/AbstractObjectValueTypeMap.java.t
-  apache-mahout-14.1/core/src/main/java-templates/org/apache/mahout/math/map/OpenKeyTypeObjectHashMap.java.t
-  apache-mahout-14.1/core/src/main/java-templates/org/apache/mahout/math/map/OpenKeyTypeValueTypeHashMap.java.t
-  apache-mahout-14.1/core/src/main/java-templates/org/apache/mahout/math/map/OpenObjectValueTypeHashMap.java.t
-
 ================================================================
 Austin Appleby's C algorithm implemented by Yonik Seeley under public domain
 ================================================================
@@ -303,44 +232,3 @@ Proper
 Files in the directory: website/assets/vendor/propper
 Are copied from the Propper project (https://popper.js.org/)
 which is licensed under the MIT license.
-
-================================================================
-The following applies to the ViennaCL library and files in the mahout-native-viennacl module
-================================================================
-
-   Copyright (c) 2010-2016 Institute for Microelectronics,
-                           Institute for Analysis and Scientific Computing, TU Wien.
-   Portions of this software are copyright by UChicago Argonne, LLC.
-   Argonne National Laboratory, with facilities in the state of Illinois,
-   is owned by The United States Government, and operated by UChicago Argonne, LLC
-   under provision of a contract with the Department of Energy.
-
-   Permission is hereby granted, free of charge, to any person obtaining a copy
-   of this software and associated documentation files (the "Software"), to deal
-   in the Software without restriction, including without limitation the rights
-   to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-   copies of the Software, and to permit persons to whom the Software is
-   furnished to do so, subject to the following conditions:
-
-   The above copyright notice and this permission notice shall be included in
-   all copies or substantial portions of the Software.
-
-   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-   IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-   FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-   AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-   LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-   OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-   THE SOFTWARE.
-
-  ===============================================================================
-  The following applies to the bydeco/javacpp code and module
-  ===============================================================================
-  You may use this work under the terms of either the Apache License,
-  Version 2.0, or the GNU General Public License (GPL), either version 2,
-  or any later version, with "Classpath" exception (details below).
-
-  You don't have to do anything special to choose one license or the other
-  and you don't have to notify anyone which license you are using. You are
-  free to use this work in any project (even commercial projects) as long
-  as the copyright header is left intact.

qumat-0.5.0/NOTICE

@@ -0,0 +1,5 @@
+Apache Mahout
+Copyright 2009-2026 The Apache Software Foundation
+
+This product includes software developed at
+The Apache Software Foundation (https://www.apache.org/).

qumat-0.5.0/PKG-INFO

@@ -0,0 +1,111 @@
+Metadata-Version: 2.4
+Name: qumat
+Version: 0.5.0
+Summary: A library for composing quantum machine learning.
+Author-email: Apache Mahout <dev@mahout.apache.org>
+License-Expression: Apache-2.0
+License-File: LICENSE
+License-File: NOTICE
+Requires-Python: <3.13,>=3.10
+Requires-Dist: amazon-braket-sdk<2.0,>=1.108.0
+Requires-Dist: cirq<1.6.0,>=1.5.0
+Requires-Dist: qiskit-aer<0.18.0,>=0.17.2
+Requires-Dist: qiskit<3.0.0,>=2.2.0
+Requires-Dist: sympy<2.0,>=1.14.0
+Provides-Extra: qdp
+Requires-Dist: qumat-qdp; extra == 'qdp'
+Description-Content-Type: text/markdown
+
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You 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.
+-->
+
+# Apache Mahout
+
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0)
+[![Python](https://img.shields.io/badge/Python-3.10--3.12-blue.svg)](https://www.python.org/)
+[![GitHub Stars](https://img.shields.io/github/stars/apache/mahout.svg)](https://github.com/apache/mahout/stargazers)
+[![GitHub Contributors](https://img.shields.io/github/contributors/apache/mahout.svg)](https://github.com/apache/mahout/graphs/contributors)
+
+The goal of the Apache Mahout™ project is to build an environment for quickly creating scalable, performant machine learning applications.\
+For additional information about Mahout, visit the [Mahout Home Page](http://mahout.apache.org/)
+
+## Qumat
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/apache/mahout/refs/heads/main/docs/assets/mascot_with_text.png" width="400" alt="Apache Mahout">
+</p>
+
+Qumat is a high-level Python library for quantum computing that provides:
+
+- **Quantum Circuit Abstraction** - Build quantum circuits with standard gates (Hadamard, CNOT, Pauli, etc.) and run them on Qiskit, Cirq, or Amazon Braket with a single unified API. Write once, execute anywhere. Check out [basic gates](docs/basic_gates.md) for a quick introduction to the basic gates supported across all backends.
+- **QDP (Quantum Data Plane)** - Encode classical data into quantum states using GPU-accelerated kernels. Zero-copy tensor transfer via DLPack lets you move data between PyTorch, NumPy, and TensorFlow without overhead.
+
+## Quick Start
+
+```bash
+git clone https://github.com/apache/mahout.git
+cd mahout
+pip install uv
+uv sync                     # Core Qumat
+uv sync --extra qdp         # With QDP (requires CUDA GPU)
+```
+
+### Qumat: Run a Quantum Circuit
+
+```python
+from qumat import QuMat
+
+qumat = QuMat({"backend_name": "qiskit", "backend_options": {"simulator_type": "aer_simulator"}})
+qumat.create_empty_circuit(num_qubits=2)
+qumat.apply_hadamard_gate(0)
+qumat.apply_cnot_gate(0, 1)
+qumat.execute_circuit()
+```
+
+### QDP: Encode data for Quantum ML
+
+```python
+import qumat.qdp as qdp
+
+engine = qdp.QdpEngine(device_id=0)
+qtensor = engine.encode([1.0, 2.0, 3.0, 4.0], num_qubits=2, encoding_method="amplitude")
+```
+
+## Roadmap
+
+### 2024
+- [x] Transition of Classic to maintenance mode
+- [x] Integration of Qumat with hardened (tests, docs, CI/CD) Cirq, Qiskit, and Braket backends
+- [x] Integration with Amazon Braket
+- [x] [Public talk about Qumat](https://2024.fossy.us/schedule/presentation/265/)
+
+### 2025
+- [x] [FOSDEM talk](https://fosdem.org/2025/schedule/event/fosdem-2025-5298-introducing-qumat-an-apache-mahout-joint-/)
+- [x] QDP: Foundation & Infrastructure (Rust workspace, build configuration)
+- [x] QDP: Core Implementation (CUDA kernels, CPU preprocessing, GPU memory management)
+- [x] QDP: Zero-copy and Safety (DLManagedTensor, DLPack structures)
+- [x] QDP: Python Binding (PyO3 wrapping, DLPack protocol)
+
+### Q1 2026
+- [ ] QDP: Input Format Support (PyTorch, NumPy, TensorFlow integration)
+- [ ] QDP: Verification and Testing (device testing, benchmarking)
+- [ ] QDP: Additional Encoders (angle/basis encoding, multi-GPU optimization)
+- [ ] QDP: Integration & Release (documentation, example notebooks, PyPI publishing)
+
+## Legal
+Please see the `NOTICE.txt` included in this directory for more information.

qumat-0.5.0/README.md

@@ -0,0 +1,93 @@
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You 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.
+-->
+
+# Apache Mahout
+
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0)
+[![Python](https://img.shields.io/badge/Python-3.10--3.12-blue.svg)](https://www.python.org/)
+[![GitHub Stars](https://img.shields.io/github/stars/apache/mahout.svg)](https://github.com/apache/mahout/stargazers)
+[![GitHub Contributors](https://img.shields.io/github/contributors/apache/mahout.svg)](https://github.com/apache/mahout/graphs/contributors)
+
+The goal of the Apache Mahout™ project is to build an environment for quickly creating scalable, performant machine learning applications.\
+For additional information about Mahout, visit the [Mahout Home Page](http://mahout.apache.org/)
+
+## Qumat
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/apache/mahout/refs/heads/main/docs/assets/mascot_with_text.png" width="400" alt="Apache Mahout">
+</p>
+
+Qumat is a high-level Python library for quantum computing that provides:
+
+- **Quantum Circuit Abstraction** - Build quantum circuits with standard gates (Hadamard, CNOT, Pauli, etc.) and run them on Qiskit, Cirq, or Amazon Braket with a single unified API. Write once, execute anywhere. Check out [basic gates](docs/basic_gates.md) for a quick introduction to the basic gates supported across all backends.
+- **QDP (Quantum Data Plane)** - Encode classical data into quantum states using GPU-accelerated kernels. Zero-copy tensor transfer via DLPack lets you move data between PyTorch, NumPy, and TensorFlow without overhead.
+
+## Quick Start
+
+```bash
+git clone https://github.com/apache/mahout.git
+cd mahout
+pip install uv
+uv sync                     # Core Qumat
+uv sync --extra qdp         # With QDP (requires CUDA GPU)
+```
+
+### Qumat: Run a Quantum Circuit
+
+```python
+from qumat import QuMat
+
+qumat = QuMat({"backend_name": "qiskit", "backend_options": {"simulator_type": "aer_simulator"}})
+qumat.create_empty_circuit(num_qubits=2)
+qumat.apply_hadamard_gate(0)
+qumat.apply_cnot_gate(0, 1)
+qumat.execute_circuit()
+```
+
+### QDP: Encode data for Quantum ML
+
+```python
+import qumat.qdp as qdp
+
+engine = qdp.QdpEngine(device_id=0)
+qtensor = engine.encode([1.0, 2.0, 3.0, 4.0], num_qubits=2, encoding_method="amplitude")
+```
+
+## Roadmap
+
+### 2024
+- [x] Transition of Classic to maintenance mode
+- [x] Integration of Qumat with hardened (tests, docs, CI/CD) Cirq, Qiskit, and Braket backends
+- [x] Integration with Amazon Braket
+- [x] [Public talk about Qumat](https://2024.fossy.us/schedule/presentation/265/)
+
+### 2025
+- [x] [FOSDEM talk](https://fosdem.org/2025/schedule/event/fosdem-2025-5298-introducing-qumat-an-apache-mahout-joint-/)
+- [x] QDP: Foundation & Infrastructure (Rust workspace, build configuration)
+- [x] QDP: Core Implementation (CUDA kernels, CPU preprocessing, GPU memory management)
+- [x] QDP: Zero-copy and Safety (DLManagedTensor, DLPack structures)
+- [x] QDP: Python Binding (PyO3 wrapping, DLPack protocol)
+
+### Q1 2026
+- [ ] QDP: Input Format Support (PyTorch, NumPy, TensorFlow integration)
+- [ ] QDP: Verification and Testing (device testing, benchmarking)
+- [ ] QDP: Additional Encoders (angle/basis encoding, multi-GPU optimization)
+- [ ] QDP: Integration & Release (documentation, example notebooks, PyPI publishing)
+
+## Legal
+Please see the `NOTICE.txt` included in this directory for more information.

qumat-0.5.0/pyproject.toml

@@ -0,0 +1,78 @@
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You 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.
+
+[project]
+name = "qumat"
+version = "0.5.0"
+description = "A library for composing quantum machine learning."
+authors = [{ name = "Apache Mahout", email = "dev@mahout.apache.org" }]
+license = "Apache-2.0"
+requires-python = ">=3.10,<3.13"
+readme = "README.md"
+dependencies = [
+    "qiskit>=2.2.0,<3.0.0",
+    "qiskit-aer>=0.17.2,<0.18.0",
+    "cirq>=1.5.0,<1.6.0",
+    "amazon-braket-sdk>=1.108.0,<2.0",
+    "sympy>=1.14.0,<2.0",
+]
+
+[project.optional-dependencies]
+qdp = ["qumat-qdp"]
+
+[dependency-groups]
+dev = [
+    "pytest>=9.0.1",
+    "ruff>=0.13.1",
+    "pre-commit>=3.0.0",
+    "maturin>=1.10.2",
+    "patchelf>=0.17.2.4",
+    "torch>=2.2,<=2.9.0",
+    "numpy>=1.24,<2.0",
+    "setuptools>=80.9.0",
+    "tensorflow>=2.20",
+]
+
+[tool.uv]
+# Override to fix amazon-braket-default-simulator dependency on old numba/llvmlite
+# The simulator v1.32.1 requires numba 0.53.1 which doesn't support Python 3.10+
+override-dependencies = [
+    "numba>=0.60.0",
+    "llvmlite>=0.43.0",
+]
+
+[tool.uv.sources]
+qumat-qdp = { path = "qdp/qdp-python", editable = true }
+
+[tool.pytest.ini_options]
+testpaths = ["testing"]
+python_files = "test_*.py"
+python_functions = "test_*"
+addopts = ["-v", "--tb=short", "-rs"]
+markers = [
+    "gpu: marks tests as requiring GPU and _qdp extension (auto-skipped if unavailable)",
+    "slow: marks tests as slow running",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.sdist]
+only-include = [
+  "qumat",
+  "LICENSE",
+  "README.md",
+]

qumat-0.5.0/qumat/__init__.py

@@ -0,0 +1,20 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You 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.
+
+from .qumat import QuMat
+from . import qdp
+
+__all__ = ["QuMat", "qdp"]