interpn 0.6.2__tar.gz → 0.6.3__tar.gz

{interpn-0.6.2 → interpn-0.6.3}/.github/workflows/release-python.yml

@@ -6,18 +6,14 @@
 name: release-python
 
 on:
-  push:
-    branches:
-      - main
   workflow_dispatch:
 
 permissions:
   contents: read
 
 jobs:
-  release_rust:
-    uses: ./.github/workflows/release-rust.yml
-    secrets: inherit
+  test_python:
+    uses: ./.github/workflows/test-python.yml
 
   linux:
     runs-on: ${{ matrix.platform.runner }}
@@ -124,7 +120,7 @@ jobs:
     strategy:
       matrix:
         platform:
-          - runner: macos-13
+          - runner: macos-15-intel
             target: x86_64
           - runner: macos-14
             target: aarch64
@@ -163,7 +159,7 @@ jobs:
     name: Release
     runs-on: ubuntu-latest
     # if: ${{ startsWith(github.ref, 'refs/tags/') || github.event_name == 'workflow_dispatch' }}
-    needs: [release_rust, linux, musllinux, windows, macos, sdist]
+    needs: [test_python, linux, musllinux, windows, macos, sdist]
     permissions:
       # Use to sign the release artifacts
       id-token: write

{interpn-0.6.2 → interpn-0.6.3}/.github/workflows/release-rust.yml

@@ -4,7 +4,6 @@ permissions:
   contents: read
 
 on:
-  workflow_call:
   workflow_dispatch:
 
 jobs:

{interpn-0.6.2 → interpn-0.6.3}/.github/workflows/test-python.yml

@@ -11,7 +11,13 @@ jobs:
     strategy:
       matrix:
         target: [x86_64]
-        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+        python-version:
+          - "3.9"
+          - "3.10"
+          - "3.11"
+          - "3.12"
+          - "3.13"
+          - "3.14"
     steps:
     - uses: actions/checkout@v3
     - name: Install uv
@@ -42,7 +48,7 @@ jobs:
           - runner: windows-latest
           - runner: ubuntu-latest
           - runner: ubuntu-24.04-arm  # aarch64
-          - runner: macos-13  # x86_64
+          - runner: macos-15-intel  # x86_64
           - runner: macos-14  # aarch64
         python-version: ["3.9"]
     steps:

{interpn-0.6.2 → interpn-0.6.3}/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 0.6.3 2025-10-22
+
+Unpin max supported python version due to use of stable ABI3,
+along with a host of other improvements to packaging and actions workflows.
+
+### New Contributors
+
+* [Clément Robert](https://github.com/neutrinoceros) contributed PRs 30,32,33,36 making up all the substantial changes in this release. Thanks, Clément!
+
+### Changed
+
+* Python
+  * Unpin max python version
+  * Roll forward pydantic version for python 3.14 compatibility
+  * Update package metadata
+  * Add python 3.14 to test matrix
+* Workflows
+  * Reconfigure from single-contributor to commons-project by segmenting release workflows to be dispatched manually only
+  * Update python release workflow to depend on test-python instead of release-rust to support separate releases
+
 ## 0.6.2 2025-10-20
 
 Add optional use of fused multiply-add, enabled for python distributions.

interpn-0.6.3/PKG-INFO

@@ -0,0 +1,227 @@
+Metadata-Version: 2.4
+Name: interpn
+Version: 0.6.3
+Classifier: Programming Language :: Rust
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Requires-Dist: numpy>=2
+Requires-Dist: pydantic>=2.12
+Requires-Dist: pytest>=8.4.2 ; extra == 'test'
+Requires-Dist: pytest-cov>=7.0.0 ; extra == 'test'
+Requires-Dist: ruff>=0.13.3 ; extra == 'test'
+Requires-Dist: pyright==1.1.337 ; extra == 'test'
+Requires-Dist: mktestdocs>=0.2.1 ; extra == 'test'
+Requires-Dist: scipy>=1.11.4 ; extra == 'test'
+Requires-Dist: matplotlib>=3.8 ; extra == 'test'
+Requires-Dist: scipy>=1.11.4 ; extra == 'bench'
+Requires-Dist: matplotlib>=3.8 ; extra == 'bench'
+Requires-Dist: memory-profiler>=0.61.0 ; extra == 'bench'
+Requires-Dist: mkdocs>=1.5.3 ; extra == 'doc'
+Requires-Dist: mkdocstrings-python>=1.7.5 ; extra == 'doc'
+Requires-Dist: mkdocs-material>=9.4.10 ; extra == 'doc'
+Provides-Extra: test
+Provides-Extra: bench
+Provides-Extra: doc
+License-File: LICENSE-MIT
+License-File: LICENSE-APACHE
+Summary: N-dimensional interpolation/extrapolation methods
+Home-Page: https://github.com/jlogan03/interpn/
+Author-email: James Logan <jlogan03@gmail.com>
+License-Expression: MIT OR Apache-2.0
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: repository, https://github.com/jlogan03/interpn
+Project-URL: documentation, https://interpn.readthedocs.io/
+
+# InterpN
+
+[Repo](https://github.com/jlogan03/interpn) |
+[Python Docs](https://interpnpy.readthedocs.io/en/latest/) |
+[Rust Docs](https://docs.rs/interpn/latest/interpn/)
+
+N-dimensional interpolation/extrapolation methods, no-std and no-alloc compatible,
+prioritizing correctness, performance, and compatiblity with memory-constrained environments.
+
+Available as a rust crate and python library.
+
+These methods perform zero allocation when evaluated (except, optionally, for the output).
+Because of this, they have minimal per-call overhead, and are particularly
+effective when examining small numbers of observation points. See the
+[performance](https://interpnpy.readthedocs.io/en/latest/perf/) page for detailed benchmarks.
+
+## Features
+
+| Feature →<br>↓ Interpolant Method | Regular<br>Grid | Rectilinear<br>Grid | Json<br>Serialization |
+|-----------------------------------|-----------------|---------------------|-----------------------|
+| Linear                            |   ✅            |     ✅              | ✅                    |
+| Cubic                             |   ✅            |     ✅              | ✅                    |
+
+The methods provided here, while more limited in scope than scipy's,
+
+* are significantly faster under most conditions
+* use almost no RAM (and perform no heap allocations at all)
+* produce significantly improved floating-point error (by several orders of magnitude)
+* are json-serializable using Pydantic
+* can also be used easily in web and embedded applications via the Rust library
+* are permissively licensed
+
+![ND throughput 1000 obs](./docs/throughput_vs_dims_1000_obs.svg)
+
+See [here](https://interpnpy.readthedocs.io/en/latest/perf/) for more info about quality-of-fit, throughput, and memory usage.
+
+## Installation
+
+```bash
+pip install interpn
+```
+
+## Profile-Guided Optimization
+
+To build the extension with profile-guided optimization using pre-built profiles, do `sh ./scripts/pgo_install.sh`.
+You can also generate your own PGO profiles like `sh ./scripts/pgo_profile.sh`.
+after installing these extra compiler dependencies:
+
+```bash
+rustup component add llvm-tools-preview
+```
+
+## Rust Examples
+
+### Regular Grid
+```rust
+use interpn::{multilinear, multicubic};
+
+// Define a grid
+let x = [1.0_f64, 2.0, 3.0, 4.0];
+let y = [0.0_f64, 1.0, 2.0, 3.0];
+
+// Grid input for rectilinear method
+let grids = &[&x[..], &y[..]];
+
+// Grid input for regular grid method
+let dims = [x.len(), y.len()];
+let starts = [x[0], y[0]];
+let steps = [x[1] - x[0], y[1] - y[0]];
+
+// Values at grid points
+let z = [2.0; 16];
+
+// Observation points to interpolate/extrapolate
+let xobs = [0.0_f64, 5.0];
+let yobs = [-1.0, 3.0];
+let obs = [&xobs[..], &yobs[..]];
+
+// Storage for output
+let mut out = [0.0; 2];
+
+// Do interpolation
+multilinear::regular::interpn(&dims, &starts, &steps, &z, &obs, &mut out);
+multicubic::regular::interpn(&dims, &starts, &steps, &z, false, &obs, &mut out);
+```
+
+### Rectilinear Grid
+```rust
+use interpn::{multilinear, multicubic};
+
+// Define a grid
+let x = [1.0_f64, 2.0, 3.0, 4.0];
+let y = [0.0_f64, 1.0, 2.0, 3.0];
+
+// Grid input for rectilinear method
+let grids = &[&x[..], &y[..]];
+
+// Values at grid points
+let z = [2.0; 16];
+
+// Points to interpolate/extrapolate
+let xobs = [0.0_f64, 5.0];
+let yobs = [-1.0, 3.0];
+let obs = [&xobs[..], &yobs[..]];
+
+// Storage for output
+let mut out = [0.0; 2];
+
+// Do interpolation
+multilinear::rectilinear::interpn(grids, &z, &obs, &mut out).unwrap();
+multicubic::rectilinear::interpn(grids, &z, false, &obs, &mut out).unwrap();
+```
+
+## Python Examples
+
+### Available Methods
+
+```python
+import interpn
+import numpy as np
+
+# Build grid
+x = np.linspace(0.0, 10.0, 5)
+y = np.linspace(20.0, 30.0, 4)
+grids = [x, y]
+
+xgrid, ygrid = np.meshgrid(x, y, indexing="ij")
+zgrid = (xgrid + 2.0 * ygrid)  # Values at grid points
+
+# Grid inputs for true regular grid
+dims = [x.size, y.size]
+starts = np.array([x[0], y[0]])
+steps = np.array([x[1] - x[0], y[1] - y[0]])
+
+# Initialize different interpolators
+# Call like `linear_regular.eval([xs, ys])`
+linear_regular = interpn.MultilinearRegular.new(dims, starts, steps, zgrid)
+cubic_regular = interpn.MulticubicRegular.new(dims, starts, steps, zgrid)
+linear_rectilinear = interpn.MultilinearRectilinear.new(grids, zgrid)
+cubic_rectilinear = interpn.MulticubicRectilinear.new(grids, zgrid)
+```
+
+### Multilinear Interpolation
+
+```python
+import interpn
+import numpy as np
+
+# Build grid
+x = np.linspace(0.0, 10.0, 5)
+y = np.linspace(20.0, 30.0, 4)
+
+xgrid, ygrid = np.meshgrid(x, y, indexing="ij")
+zgrid = (xgrid + 2.0 * ygrid)  # Values at grid points
+
+# Grid inputs for true regular grid
+dims = [x.size, y.size]
+starts = np.array([x[0], y[0]])
+steps = np.array([x[1] - x[0], y[1] - y[0]])
+
+# Observation points pointed back at the grid
+obs = [xgrid.flatten(), ygrid.flatten()]
+
+# Initialize
+interpolator = interpn.MultilinearRegular.new(dims, starts, steps, zgrid.flatten())
+
+# Interpolate
+out = interpolator.eval(obs)
+
+# Check result
+assert np.allclose(out, zgrid.flatten(), rtol=1e-13)
+
+# Serialize and deserialize
+roundtrip_interpolator = interpn.MultilinearRegular.model_validate_json(
+    interpolator.model_dump_json()
+)
+out2 = roundtrip_interpolator.eval(obs)
+
+# Check result from roundtrip serialized/deserialized interpolator
+assert np.all(out == out2)
+```
+
+
+# License
+
+Licensed under either of
+
+- Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
+- MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)
+
+at your option.
+

{interpn-0.6.2 → interpn-0.6.3}/pyproject.toml

@@ -4,12 +4,13 @@ build-backend = "maturin"
 
 [project]
 name = "interpn"
-version = "0.6.2"
-repository = "https://github.com/jlogan03/interpn"
-documentation = "https://interpn.readthedocs.io/"
+version = "0.6.3"
 description = "N-dimensional interpolation/extrapolation methods"
 authors = [{ name = "James Logan", email = "jlogan03@gmail.com" }]
-requires-python = ">=3.9, <3.14"
+readme = "README.md"
+license = "MIT OR Apache-2.0"
+license-files = ["LICENSE-MIT", "LICENSE-APACHE"]
+requires-python = ">=3.9"
 classifiers = [
     "Programming Language :: Rust",
     "Programming Language :: Python :: Implementation :: CPython",
@@ -17,9 +18,13 @@ classifiers = [
 ]
 dependencies = [
     "numpy >= 2",
-    "pydantic >= 2.5.2",
+    "pydantic >= 2.12",
 ]
 
+[project.urls]
+repository = "https://github.com/jlogan03/interpn"
+documentation = "https://interpn.readthedocs.io/"
+
 [project.optional-dependencies]
 test = [
     "pytest >= 8.4.2",
@@ -71,9 +76,6 @@ include = [
 [tool.pytest.ini_options]
 addopts = "--cov=interpn --cov-report html --cov-fail-under=94"
 
-[tool.ruff]
-target-version = "py39"
-
 [tool.ruff.lint]
 select = [
     # pycodestyle