interpies-lite 0.1.0__tar.gz

interpies_lite-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,28 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write  # required for OIDC trusted publishing
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.x"
+
+      - name: Install build tools
+        run: python -m pip install --upgrade build
+
+      - name: Build sdist and wheel
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

interpies_lite-0.1.0/.gitignore

@@ -0,0 +1,29 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+build/
+dist/
+*.egg-info/
+*.egg
+
+# Jupyter
+.ipynb_checkpoints/
+
+# Editors
+.vscode/
+.idea/
+*.swp
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Test/cache outputs
+.pytest_cache/
+.mypy_cache/
+*.tif
+*.png
+!docs/*.png

interpies_lite-0.1.0/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, interpies-lite contributors
+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.

interpies_lite-0.1.0/PKG-INFO

@@ -0,0 +1,189 @@
+Metadata-Version: 2.5
+Name: interpies-lite
+Version: 0.1.0
+Summary: Lightweight reimplementation of interpies: potential-field grid transforms and plotting (derivatives, ISVD, upward continuation, edge enhancement).
+Project-URL: Homepage, https://github.com/xyt556/interpies-lite
+Project-URL: Repository, https://github.com/xyt556/interpies-lite
+Project-URL: Issues, https://github.com/xyt556/interpies-lite/issues
+Author-email: Yantao XI <xyt556@gmail.com>
+License: BSD 3-Clause License
+        
+        Copyright (c) 2026, interpies-lite contributors
+        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
+Keywords: derivatives,edge-detection,geophysics,gravity,isvd,magnetics,potential-field,raster,remote-sensing,tilt,upward-continuation
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: OS Independent
+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 :: GIS
+Classifier: Topic :: Scientific/Engineering :: Physics
+Requires-Python: >=3.10
+Requires-Dist: matplotlib>=3.7
+Requires-Dist: numpy>=1.24
+Requires-Dist: scikit-learn>=1.2
+Requires-Dist: scipy>=1.10
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: twine>=5.0; extra == 'dev'
+Provides-Extra: geo
+Requires-Dist: pyproj>=3.5; extra == 'geo'
+Requires-Dist: rasterio>=1.3; extra == 'geo'
+Description-Content-Type: text/markdown
+
+# interpies_lite
+
+对原 `interpies` 库的轻量重实现。目标：解决原库依赖钉死（`gdal==3.8.4`）、久未更新的问题，保留核心功能与 API 习惯。
+
+## 与原库的差异
+
+| 维度 | 原 interpies | interpies_lite |
+| --- | --- | --- |
+| 栅格读写 | rasterio + 钉死 gdal==3.8.4 | rasterio>=1.3（可选，未装时只能用 `Grid.from_array`） |
+| SEGY 模块 | obspy 依赖 | 砍掉 |
+| 色表数据 | 35 KB 硬编码 LUT | 内置 Geosoft clra / parula 近似色表，其他直接用 matplotlib 色表 |
+| Grid 实现 | 普通类 + 手写属性 | `@dataclass` + property，类型注解完整 |
+| 依赖 | numpy/scipy/matplotlib/rasterio/gdal/scikit-image/scikit-learn | numpy/scipy/matplotlib/scikit-learn（rasterio/pyproj 可选） |
+| Python | >=3.10 | >=3.10 |
+
+## 模块
+
+```
+interpies_lite/
+├── __init__.py     # open() / Grid
+├── grid.py         # Grid 类：IO、几何、预处理、全部位场方法
+├── transforms.py   # 纯算法：导数、ISVD、傅里叶变换、延拓、平滑
+├── graphics.py     # show / save_image：晕渲、色图、等值线
+├── colors.py       # 内置色表
+├── spatial.py      # pyproj 点投影（可选）
+└── io.py           # rasterio 封装
+```
+
+## 快速开始
+
+```python
+import interpies_lite as ip
+
+# 从文件加载（需要 rasterio）
+g = ip.open("data/brtpgrd.gxf")
+g.info()
+
+# 从 numpy 数组构造（无任何重依赖）
+import numpy as np
+data = np.random.randn(100, 100)
+g = ip.Grid.from_array(data, west=0, north=0, cellsize=100, crs="EPSG:32633")
+
+# 链式调用：去趋势 → 平滑 → 边界识别
+out = g.detrend(degree=1).smooth(win=5).tilt()
+out.show()
+
+# 可用变换（全部返回新 Grid）：
+#   dx / dy / dx2 / dy2 / dxdy / dz / isvd / vi
+#   hgm / tilt / tg / lw / tahg
+#   up(z) / hp_filter_uc(z) / laplacian
+#   clip / resample / scale / detrend / fill_nodata / smooth
+```
+
+## 安装
+
+本包暂未发布到 PyPI，可通过以下任一方式安装：
+
+### 方式 1：从 GitHub 直接安装（推荐）
+
+公开仓库，无需下载，pip 自动拉取最新代码：
+
+```bash
+pip install git+https://github.com/xyt556/interpies-lite.git
+```
+
+指定版本/分支：
+
+```bash
+pip install git+https://github.com/xyt556/interpies-lite.git@main
+```
+
+### 方式 2：从本地目录安装
+
+```bash
+cd path/to/interpies_lite
+pip install .
+```
+
+### 方式 3：从 wheel 文件安装
+
+```bash
+pip install dist/interpies_lite-0.1.0-py3-none-any.whl
+```
+
+### 方式 4：开发模式（可编辑，改代码即时生效）
+
+```bash
+cd path/to/interpies_lite
+pip install -e .
+```
+
+### 可选依赖（读写 GeoTIFF/GXF）
+
+```bash
+pip install "interpies-lite[geo]"
+# 等价于
+pip install rasterio pyproj
+```
+
+核心依赖（必装）：numpy、scipy、matplotlib、scikit-learn。
+
+## 示例
+
+仓库自带两个 notebook：
+
+| Notebook | 数据 | 内容 |
+| --- | --- | --- |
+| `notebooks/interpies_lite_demo.ipynb` | 合成数据 | 快速上手，无需 rasterio，开箱即跑 |
+| `notebooks/interpies_lite_brtpgrd_demo.ipynb` | `data/brtpgrd.gxf`（真实航磁） | 课堂版完整教程，含算法原理与公式 |
+
+克隆仓库后：
+
+```bash
+cd interpies_lite
+pip install -e .[geo]
+jupyter notebook notebooks/
+```
+
+`data/brtpgrd.gxf` 为 Colorado 地区航磁数据（707×629，50 m，NAD27/UTM13N），来自原 interpies 项目示例。
+
+## 冒烟测试
+
+```bash
+python smoke_test.py
+# 在合成网格上跑通全部变换，输出 smoke_test_output.png
+```

interpies_lite-0.1.0/README.md

@@ -0,0 +1,126 @@
+# interpies_lite
+
+对原 `interpies` 库的轻量重实现。目标：解决原库依赖钉死（`gdal==3.8.4`）、久未更新的问题，保留核心功能与 API 习惯。
+
+## 与原库的差异
+
+| 维度 | 原 interpies | interpies_lite |
+| --- | --- | --- |
+| 栅格读写 | rasterio + 钉死 gdal==3.8.4 | rasterio>=1.3（可选，未装时只能用 `Grid.from_array`） |
+| SEGY 模块 | obspy 依赖 | 砍掉 |
+| 色表数据 | 35 KB 硬编码 LUT | 内置 Geosoft clra / parula 近似色表，其他直接用 matplotlib 色表 |
+| Grid 实现 | 普通类 + 手写属性 | `@dataclass` + property，类型注解完整 |
+| 依赖 | numpy/scipy/matplotlib/rasterio/gdal/scikit-image/scikit-learn | numpy/scipy/matplotlib/scikit-learn（rasterio/pyproj 可选） |
+| Python | >=3.10 | >=3.10 |
+
+## 模块
+
+```
+interpies_lite/
+├── __init__.py     # open() / Grid
+├── grid.py         # Grid 类：IO、几何、预处理、全部位场方法
+├── transforms.py   # 纯算法：导数、ISVD、傅里叶变换、延拓、平滑
+├── graphics.py     # show / save_image：晕渲、色图、等值线
+├── colors.py       # 内置色表
+├── spatial.py      # pyproj 点投影（可选）
+└── io.py           # rasterio 封装
+```
+
+## 快速开始
+
+```python
+import interpies_lite as ip
+
+# 从文件加载（需要 rasterio）
+g = ip.open("data/brtpgrd.gxf")
+g.info()
+
+# 从 numpy 数组构造（无任何重依赖）
+import numpy as np
+data = np.random.randn(100, 100)
+g = ip.Grid.from_array(data, west=0, north=0, cellsize=100, crs="EPSG:32633")
+
+# 链式调用：去趋势 → 平滑 → 边界识别
+out = g.detrend(degree=1).smooth(win=5).tilt()
+out.show()
+
+# 可用变换（全部返回新 Grid）：
+#   dx / dy / dx2 / dy2 / dxdy / dz / isvd / vi
+#   hgm / tilt / tg / lw / tahg
+#   up(z) / hp_filter_uc(z) / laplacian
+#   clip / resample / scale / detrend / fill_nodata / smooth
+```
+
+## 安装
+
+本包暂未发布到 PyPI，可通过以下任一方式安装：
+
+### 方式 1：从 GitHub 直接安装（推荐）
+
+公开仓库，无需下载，pip 自动拉取最新代码：
+
+```bash
+pip install git+https://github.com/xyt556/interpies-lite.git
+```
+
+指定版本/分支：
+
+```bash
+pip install git+https://github.com/xyt556/interpies-lite.git@main
+```
+
+### 方式 2：从本地目录安装
+
+```bash
+cd path/to/interpies_lite
+pip install .
+```
+
+### 方式 3：从 wheel 文件安装
+
+```bash
+pip install dist/interpies_lite-0.1.0-py3-none-any.whl
+```
+
+### 方式 4：开发模式（可编辑，改代码即时生效）
+
+```bash
+cd path/to/interpies_lite
+pip install -e .
+```
+
+### 可选依赖（读写 GeoTIFF/GXF）
+
+```bash
+pip install "interpies-lite[geo]"
+# 等价于
+pip install rasterio pyproj
+```
+
+核心依赖（必装）：numpy、scipy、matplotlib、scikit-learn。
+
+## 示例
+
+仓库自带两个 notebook：
+
+| Notebook | 数据 | 内容 |
+| --- | --- | --- |
+| `notebooks/interpies_lite_demo.ipynb` | 合成数据 | 快速上手，无需 rasterio，开箱即跑 |
+| `notebooks/interpies_lite_brtpgrd_demo.ipynb` | `data/brtpgrd.gxf`（真实航磁） | 课堂版完整教程，含算法原理与公式 |
+
+克隆仓库后：
+
+```bash
+cd interpies_lite
+pip install -e .[geo]
+jupyter notebook notebooks/
+```
+
+`data/brtpgrd.gxf` 为 Colorado 地区航磁数据（707×629，50 m，NAD27/UTM13N），来自原 interpies 项目示例。
+
+## 冒烟测试
+
+```bash
+python smoke_test.py
+# 在合成网格上跑通全部变换，输出 smoke_test_output.png
+```