gimbal-regression 0.1.3__tar.gz

gimbal_regression-0.1.3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yuichiro Otani
+
+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.

gimbal_regression-0.1.3/PKG-INFO

@@ -0,0 +1,200 @@
+Metadata-Version: 2.4
+Name: gimbal-regression
+Version: 0.1.3
+Summary: A Python package for Gimbal Regression, a deterministic local linear regression framework with explicit diagnostics.
+Author: Yuichiro Otani
+License: MIT License
+Project-URL: Homepage, https://github.com/yuichiro-otani/gimbal-regression
+Project-URL: Repository, https://github.com/yuichiro-otani/gimbal-regression
+Project-URL: Issues, https://github.com/yuichiro-otani/gimbal-regressionissues
+Keywords: spatial statistics,local regression,gimbal regression,anisotropy,geographically weighted regression
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.24
+Requires-Dist: pandas>=2.0
+Requires-Dist: scikit-learn>=1.3
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: twine>=5.0; extra == "dev"
+Provides-Extra: plot
+Requires-Dist: matplotlib>=3.7; extra == "plot"
+Requires-Dist: geopandas>=0.14; extra == "plot"
+Requires-Dist: contextily>=1.5; extra == "plot"
+Provides-Extra: benchmark
+Requires-Dist: statsmodels>=0.14; extra == "benchmark"
+Requires-Dist: mgwr>=2.1; extra == "benchmark"
+Requires-Dist: pykrige>=1.7; extra == "benchmark"
+Requires-Dist: pyproj>=3.6; extra == "benchmark"
+Provides-Extra: all
+Requires-Dist: pytest>=7.0; extra == "all"
+Requires-Dist: build>=1.0; extra == "all"
+Requires-Dist: twine>=5.0; extra == "all"
+Requires-Dist: matplotlib>=3.7; extra == "all"
+Requires-Dist: geopandas>=0.14; extra == "all"
+Requires-Dist: contextily>=1.5; extra == "all"
+Requires-Dist: statsmodels>=0.14; extra == "all"
+Requires-Dist: mgwr>=2.1; extra == "all"
+Requires-Dist: pykrige>=1.7; extra == "all"
+Requires-Dist: pyproj>=3.6; extra == "all"
+Dynamic: license-file
+
+# gimbal-regression
+
+`gimbal-regression` is a Python package for **Gimbal Regression (GR)** —  
+a deterministic local linear regression framework for **stable and reproducible estimation under anisotropic neighborhood geometry**.
+
+The package is designed with a focus on:
+
+- **Deterministic estimation** (no iterative optimization)
+- **Numerical stability** under irregular spatial sampling
+- **Explicit diagnostics** (conditioning, effective sample size, fallback)
+- **Reproducibility** via a single-pass estimator
+
+Unlike conventional local regression methods (e.g., GWR/MGWR), `gimbal-regression` exposes both **estimates and their numerical reliability** as first-class outputs.
+
+The package is distributed on PyPI as `gimbal-regression` and imported in Python as `grpy`.
+
+---
+
+## Installation
+
+### Basic installation
+
+```bash
+pip install gimbal-regression
+```
+
+### Install from source (development mode)
+
+```bash
+git clone https://github.com/yuichiro-otani/gimbal-regression.git
+cd gimbal-regression
+pip install -e .
+```
+
+### Optional Dependencies
+
+Some features require additional packages.
+Install as needed:
+
+```bash
+# plotting utilities
+pip install gimbal-regression[plot]
+
+# benchmarking and comparison methods
+pip install gimbal-regression[benchmark]
+
+# development tools
+pip install gimbal-regression[dev]
+
+# everything
+pip install gimbal-regression[all]
+```
+
+## Quick Example
+
+```python
+import numpy as np
+from grpy import GimbalRegression
+
+rng = np.random.default_rng(42)
+n = 100
+
+lat = 35.0 + 0.02 * rng.random(n)
+lon = 139.0 + 0.02 * rng.random(n)
+
+x = rng.normal(size=n)
+y = 1.0 + 2.0 * x + 0.1 * rng.normal(size=n)
+
+model = GimbalRegression(
+    K=20,
+    h_m=2000.0,
+    gamma=1.0,
+)
+
+model.fit(
+    y=y,
+    x=x,
+    lat=lat,
+    lon=lon,
+)
+
+yhat = model.predict()
+diag = model.diagnostics()
+summary = model.summary()
+
+print(summary)
+```
+## Map Visualization
+
+Requires plot extras:
+```bash
+pip install gimbal-regression[plot]
+```
+Example:
+```python
+fig, ax = model.draw_map(
+    column="B1",
+    title="Local coefficient B1",
+    basemap=True,
+)
+```
+## Diagnostics
+`grpy` returns diagnostic quantities alongside estimates:
+- Condition numbers of local normal matrices
+- Effective sample size (ESS)
+- Fallback indicators (uniform weighting)
+
+```python
+diag = model.diagnostics()
+print(diag.head())
+```
+These diagnostics allow users to directly assess numerical reliability of local estimates, not just predictive accuracy.
+
+## Reproducibility
+
+The estimator is:
+- deterministic
+- single-pass
+- free from stochastic components
+
+This ensures that results are exactly reproducible given identical inputs.
+
+## Project Structure
+```
+gimbal-regression/
+├── src/grpy/
+├── tests/
+├── examples/
+```
+
+- `src/grpy` – core implementation
+- `tests/` – unit tests
+- `examples/` – usage examples
+
+## Citation
+
+If you use this package, please cite:
+```bibtex
+@article{Otani2026GR,
+  author  = {Otani, Yuichiro},
+  title   = {Gimbal Regression: A Geometry-Aware Framework for Stable Local Linear Estimation under Anisotropic Sampling},
+  journal = {arXiv preprint arXiv:2603.10382},
+  year    = {2026},
+  doi     = {10.48550/arXiv.2603.10382}
+}
+```
+
+## License
+MIT License

gimbal_regression-0.1.3/README.md

@@ -0,0 +1,149 @@
+# gimbal-regression
+
+`gimbal-regression` is a Python package for **Gimbal Regression (GR)** —  
+a deterministic local linear regression framework for **stable and reproducible estimation under anisotropic neighborhood geometry**.
+
+The package is designed with a focus on:
+
+- **Deterministic estimation** (no iterative optimization)
+- **Numerical stability** under irregular spatial sampling
+- **Explicit diagnostics** (conditioning, effective sample size, fallback)
+- **Reproducibility** via a single-pass estimator
+
+Unlike conventional local regression methods (e.g., GWR/MGWR), `gimbal-regression` exposes both **estimates and their numerical reliability** as first-class outputs.
+
+The package is distributed on PyPI as `gimbal-regression` and imported in Python as `grpy`.
+
+---
+
+## Installation
+
+### Basic installation
+
+```bash
+pip install gimbal-regression
+```
+
+### Install from source (development mode)
+
+```bash
+git clone https://github.com/yuichiro-otani/gimbal-regression.git
+cd gimbal-regression
+pip install -e .
+```
+
+### Optional Dependencies
+
+Some features require additional packages.
+Install as needed:
+
+```bash
+# plotting utilities
+pip install gimbal-regression[plot]
+
+# benchmarking and comparison methods
+pip install gimbal-regression[benchmark]
+
+# development tools
+pip install gimbal-regression[dev]
+
+# everything
+pip install gimbal-regression[all]
+```
+
+## Quick Example
+
+```python
+import numpy as np
+from grpy import GimbalRegression
+
+rng = np.random.default_rng(42)
+n = 100
+
+lat = 35.0 + 0.02 * rng.random(n)
+lon = 139.0 + 0.02 * rng.random(n)
+
+x = rng.normal(size=n)
+y = 1.0 + 2.0 * x + 0.1 * rng.normal(size=n)
+
+model = GimbalRegression(
+    K=20,
+    h_m=2000.0,
+    gamma=1.0,
+)
+
+model.fit(
+    y=y,
+    x=x,
+    lat=lat,
+    lon=lon,
+)
+
+yhat = model.predict()
+diag = model.diagnostics()
+summary = model.summary()
+
+print(summary)
+```
+## Map Visualization
+
+Requires plot extras:
+```bash
+pip install gimbal-regression[plot]
+```
+Example:
+```python
+fig, ax = model.draw_map(
+    column="B1",
+    title="Local coefficient B1",
+    basemap=True,
+)
+```
+## Diagnostics
+`grpy` returns diagnostic quantities alongside estimates:
+- Condition numbers of local normal matrices
+- Effective sample size (ESS)
+- Fallback indicators (uniform weighting)
+
+```python
+diag = model.diagnostics()
+print(diag.head())
+```
+These diagnostics allow users to directly assess numerical reliability of local estimates, not just predictive accuracy.
+
+## Reproducibility
+
+The estimator is:
+- deterministic
+- single-pass
+- free from stochastic components
+
+This ensures that results are exactly reproducible given identical inputs.
+
+## Project Structure
+```
+gimbal-regression/
+├── src/grpy/
+├── tests/
+├── examples/
+```
+
+- `src/grpy` – core implementation
+- `tests/` – unit tests
+- `examples/` – usage examples
+
+## Citation
+
+If you use this package, please cite:
+```bibtex
+@article{Otani2026GR,
+  author  = {Otani, Yuichiro},
+  title   = {Gimbal Regression: A Geometry-Aware Framework for Stable Local Linear Estimation under Anisotropic Sampling},
+  journal = {arXiv preprint arXiv:2603.10382},
+  year    = {2026},
+  doi     = {10.48550/arXiv.2603.10382}
+}
+```
+
+## License
+MIT License

gimbal_regression-0.1.3/pyproject.toml

@@ -0,0 +1,82 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "gimbal-regression"
+version = "0.1.3"
+description = "A Python package for Gimbal Regression, a deterministic local linear regression framework with explicit diagnostics."
+readme = "README.md"
+license = { text = "MIT License" }
+authors = [
+  { name = "Yuichiro Otani" }
+]
+requires-python = ">=3.10"
+dependencies = [
+  "numpy>=1.24",
+  "pandas>=2.0",
+  "scikit-learn>=1.3"
+]
+keywords = [
+  "spatial statistics",
+  "local regression",
+  "gimbal regression",
+  "anisotropy",
+  "geographically weighted regression"
+]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Science/Research",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Scientific/Engineering",
+  "Topic :: Scientific/Engineering :: Mathematics"
+]
+
+[project.optional-dependencies]
+dev = [
+  "pytest>=7.0",
+  "build>=1.0",
+  "twine>=5.0"
+]
+plot = [
+  "matplotlib>=3.7",
+  "geopandas>=0.14",
+  "contextily>=1.5"
+]
+benchmark = [
+  "statsmodels>=0.14",
+  "mgwr>=2.1",
+  "pykrige>=1.7",
+  "pyproj>=3.6"
+]
+all = [
+  "pytest>=7.0",
+  "build>=1.0",
+  "twine>=5.0",
+  "matplotlib>=3.7",
+  "geopandas>=0.14",
+  "contextily>=1.5",
+  "statsmodels>=0.14",
+  "mgwr>=2.1",
+  "pykrige>=1.7",
+  "pyproj>=3.6"
+]
+
+[project.urls]
+Homepage = "https://github.com/yuichiro-otani/gimbal-regression"
+Repository = "https://github.com/yuichiro-otani/gimbal-regression"
+Issues = "https://github.com/yuichiro-otani/gimbal-regressionissues"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]

gimbal_regression-0.1.3/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

gimbal_regression-0.1.3/src/gimbal_regression.egg-info/PKG-INFO

@@ -0,0 +1,200 @@
+Metadata-Version: 2.4
+Name: gimbal-regression
+Version: 0.1.3
+Summary: A Python package for Gimbal Regression, a deterministic local linear regression framework with explicit diagnostics.
+Author: Yuichiro Otani
+License: MIT License
+Project-URL: Homepage, https://github.com/yuichiro-otani/gimbal-regression
+Project-URL: Repository, https://github.com/yuichiro-otani/gimbal-regression
+Project-URL: Issues, https://github.com/yuichiro-otani/gimbal-regressionissues
+Keywords: spatial statistics,local regression,gimbal regression,anisotropy,geographically weighted regression
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.24
+Requires-Dist: pandas>=2.0
+Requires-Dist: scikit-learn>=1.3
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: twine>=5.0; extra == "dev"
+Provides-Extra: plot
+Requires-Dist: matplotlib>=3.7; extra == "plot"
+Requires-Dist: geopandas>=0.14; extra == "plot"
+Requires-Dist: contextily>=1.5; extra == "plot"
+Provides-Extra: benchmark
+Requires-Dist: statsmodels>=0.14; extra == "benchmark"
+Requires-Dist: mgwr>=2.1; extra == "benchmark"
+Requires-Dist: pykrige>=1.7; extra == "benchmark"
+Requires-Dist: pyproj>=3.6; extra == "benchmark"
+Provides-Extra: all
+Requires-Dist: pytest>=7.0; extra == "all"
+Requires-Dist: build>=1.0; extra == "all"
+Requires-Dist: twine>=5.0; extra == "all"
+Requires-Dist: matplotlib>=3.7; extra == "all"
+Requires-Dist: geopandas>=0.14; extra == "all"
+Requires-Dist: contextily>=1.5; extra == "all"
+Requires-Dist: statsmodels>=0.14; extra == "all"
+Requires-Dist: mgwr>=2.1; extra == "all"
+Requires-Dist: pykrige>=1.7; extra == "all"
+Requires-Dist: pyproj>=3.6; extra == "all"
+Dynamic: license-file
+
+# gimbal-regression
+
+`gimbal-regression` is a Python package for **Gimbal Regression (GR)** —  
+a deterministic local linear regression framework for **stable and reproducible estimation under anisotropic neighborhood geometry**.
+
+The package is designed with a focus on:
+
+- **Deterministic estimation** (no iterative optimization)
+- **Numerical stability** under irregular spatial sampling
+- **Explicit diagnostics** (conditioning, effective sample size, fallback)
+- **Reproducibility** via a single-pass estimator
+
+Unlike conventional local regression methods (e.g., GWR/MGWR), `gimbal-regression` exposes both **estimates and their numerical reliability** as first-class outputs.
+
+The package is distributed on PyPI as `gimbal-regression` and imported in Python as `grpy`.
+
+---
+
+## Installation
+
+### Basic installation
+
+```bash
+pip install gimbal-regression
+```
+
+### Install from source (development mode)
+
+```bash
+git clone https://github.com/yuichiro-otani/gimbal-regression.git
+cd gimbal-regression
+pip install -e .
+```
+
+### Optional Dependencies
+
+Some features require additional packages.
+Install as needed:
+
+```bash
+# plotting utilities
+pip install gimbal-regression[plot]
+
+# benchmarking and comparison methods
+pip install gimbal-regression[benchmark]
+
+# development tools
+pip install gimbal-regression[dev]
+
+# everything
+pip install gimbal-regression[all]
+```
+
+## Quick Example
+
+```python
+import numpy as np
+from grpy import GimbalRegression
+
+rng = np.random.default_rng(42)
+n = 100
+
+lat = 35.0 + 0.02 * rng.random(n)
+lon = 139.0 + 0.02 * rng.random(n)
+
+x = rng.normal(size=n)
+y = 1.0 + 2.0 * x + 0.1 * rng.normal(size=n)
+
+model = GimbalRegression(
+    K=20,
+    h_m=2000.0,
+    gamma=1.0,
+)
+
+model.fit(
+    y=y,
+    x=x,
+    lat=lat,
+    lon=lon,
+)
+
+yhat = model.predict()
+diag = model.diagnostics()
+summary = model.summary()
+
+print(summary)
+```
+## Map Visualization
+
+Requires plot extras:
+```bash
+pip install gimbal-regression[plot]
+```
+Example:
+```python
+fig, ax = model.draw_map(
+    column="B1",
+    title="Local coefficient B1",
+    basemap=True,
+)
+```
+## Diagnostics
+`grpy` returns diagnostic quantities alongside estimates:
+- Condition numbers of local normal matrices
+- Effective sample size (ESS)
+- Fallback indicators (uniform weighting)
+
+```python
+diag = model.diagnostics()
+print(diag.head())
+```
+These diagnostics allow users to directly assess numerical reliability of local estimates, not just predictive accuracy.
+
+## Reproducibility
+
+The estimator is:
+- deterministic
+- single-pass
+- free from stochastic components
+
+This ensures that results are exactly reproducible given identical inputs.
+
+## Project Structure
+```
+gimbal-regression/
+├── src/grpy/
+├── tests/
+├── examples/
+```
+
+- `src/grpy` – core implementation
+- `tests/` – unit tests
+- `examples/` – usage examples
+
+## Citation
+
+If you use this package, please cite:
+```bibtex
+@article{Otani2026GR,
+  author  = {Otani, Yuichiro},
+  title   = {Gimbal Regression: A Geometry-Aware Framework for Stable Local Linear Estimation under Anisotropic Sampling},
+  journal = {arXiv preprint arXiv:2603.10382},
+  year    = {2026},
+  doi     = {10.48550/arXiv.2603.10382}
+}
+```
+
+## License
+MIT License

gimbal_regression-0.1.3/src/gimbal_regression.egg-info/SOURCES.txt

@@ -0,0 +1,23 @@
+LICENSE
+README.md
+pyproject.toml
+src/gimbal_regression.egg-info/PKG-INFO
+src/gimbal_regression.egg-info/SOURCES.txt
+src/gimbal_regression.egg-info/dependency_links.txt
+src/gimbal_regression.egg-info/requires.txt
+src/gimbal_regression.egg-info/top_level.txt
+src/grpy/__init__.py
+src/grpy/diagnostics.py
+src/grpy/model.py
+src/grpy/neighbors.py
+src/grpy/plotting.py
+src/grpy/solver.py
+src/grpy/utils.py
+src/grpy/weights.py
+tests/test_diagnostics.py
+tests/test_model.py
+tests/test_neighbors.py
+tests/test_plotting.py
+tests/test_solver.py
+tests/test_utils.py
+tests/test_weights.py

gimbal_regression-0.1.3/src/gimbal_regression.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+