obvaekernel 0.1.0__tar.gz

obvaekernel-0.1.0/.gitignore

@@ -0,0 +1,20 @@
+# Python caches
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.pytest_cache/
+.ruff_cache/
+
+# Build artifacts
+dist/
+build/
+*.egg-info/
+
+# Virtual environments
+.venv/
+venv/
+
+# Benchmark outputs
+benchmark_outputs*/
+

obvaekernel-0.1.0/LICENSE

@@ -0,0 +1,30 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, Sweet
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+

obvaekernel-0.1.0/PKG-INFO

@@ -0,0 +1,121 @@
+Metadata-Version: 2.4
+Name: obvaekernel
+Version: 0.1.0
+Summary: Portable NumPy-first OBVAE kernel features for PCA/kernel workflows.
+Project-URL: Homepage, https://github.com/sweet00000/OvercompleteBetaVariationalAutoEncoderKernel
+Project-URL: Repository, https://github.com/sweet00000/OvercompleteBetaVariationalAutoEncoderKernel
+Author: Sweet
+License: BSD 3-Clause License
+        
+        Copyright (c) 2026, Sweet
+        All rights reserved.
+        
+        Redistribution and use in source and binary forms, with or without
+        modification, are permitted provided that the following conditions are met:
+        
+        1. Redistributions of source code must retain the above copyright notice, this
+           list of conditions and the following disclaimer.
+        
+        2. Redistributions in binary form must reproduce the above copyright notice,
+           this list of conditions and the following disclaimer in the documentation
+           and/or other materials provided with the distribution.
+        
+        3. Neither the name of the copyright holder nor the names of its
+           contributors may be used to endorse or promote products derived from
+           this software without specific prior written permission.
+        
+        THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+        AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+        IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+        DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+        FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+        DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+        SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+        CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+        OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+        OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+        
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Requires-Dist: numpy>=1.23
+Provides-Extra: benchmark
+Requires-Dist: matplotlib>=3.7; extra == 'benchmark'
+Requires-Dist: pandas>=1.5; extra == 'benchmark'
+Requires-Dist: requests>=2.31; extra == 'benchmark'
+Requires-Dist: scikit-learn>=1.2; extra == 'benchmark'
+Requires-Dist: scipy>=1.9; extra == 'benchmark'
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Requires-Dist: twine>=5; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# obvaekernel
+
+`obvaekernel` is a NumPy-first implementation of an overcomplete beta-VAE kernel feature map designed for PCA and kernel-method workflows.
+
+## Install
+
+```bash
+pip install .
+```
+
+Benchmark/data extras:
+
+```bash
+pip install .[benchmark]
+```
+
+Development/build extras:
+
+```bash
+pip install .[dev]
+```
+
+## Quick Usage
+
+```python
+import numpy as np
+from obvaekernel import OBVAEKernel
+
+X = np.random.randn(256, 12).astype("float32")
+model = OBVAEKernel(latent_dim="auto", epochs=25, random_state=42)
+Z = model.fit_transform(X)
+K = model.kernel_matrix(X)
+```
+
+## Benchmark Scripts
+
+Run the root benchmark harness:
+
+```bash
+python main.py --mode quick --no-plots
+```
+
+Run the examples copy:
+
+```bash
+python examples/benchmark_main.py --mode full --include-weather
+```
+
+## Build and Publish Checks
+
+Build wheel + sdist:
+
+```bash
+python -m build
+```
+
+Validate distribution metadata:
+
+```bash
+python -m twine check dist/*
+```
+

obvaekernel-0.1.0/README.md

@@ -0,0 +1,62 @@
+# obvaekernel
+
+`obvaekernel` is a NumPy-first implementation of an overcomplete beta-VAE kernel feature map designed for PCA and kernel-method workflows.
+
+## Install
+
+```bash
+pip install .
+```
+
+Benchmark/data extras:
+
+```bash
+pip install .[benchmark]
+```
+
+Development/build extras:
+
+```bash
+pip install .[dev]
+```
+
+## Quick Usage
+
+```python
+import numpy as np
+from obvaekernel import OBVAEKernel
+
+X = np.random.randn(256, 12).astype("float32")
+model = OBVAEKernel(latent_dim="auto", epochs=25, random_state=42)
+Z = model.fit_transform(X)
+K = model.kernel_matrix(X)
+```
+
+## Benchmark Scripts
+
+Run the root benchmark harness:
+
+```bash
+python main.py --mode quick --no-plots
+```
+
+Run the examples copy:
+
+```bash
+python examples/benchmark_main.py --mode full --include-weather
+```
+
+## Build and Publish Checks
+
+Build wheel + sdist:
+
+```bash
+python -m build
+```
+
+Validate distribution metadata:
+
+```bash
+python -m twine check dist/*
+```
+