flkit 0.1.0__tar.gz

flkit-0.1.0/.python-version

@@ -0,0 +1 @@
+3.13

flkit-0.1.0/PKG-INFO

@@ -0,0 +1,186 @@
+Metadata-Version: 2.4
+Name: flkit
+Version: 0.1.0
+Summary: 一个功能强大的 Python 工具包，提供空间分析、数据插值、数据库操作、命令行工具等多种功能
+Requires-Python: >=3.13
+Requires-Dist: click>=8.1.0
+Requires-Dist: duckdb>=1.5.1
+Requires-Dist: fastapi>=0.135.2
+Requires-Dist: matplotlib>=3.10.8
+Requires-Dist: numpy>=2.4.4
+Requires-Dist: opencv-python>=4.13.0.92
+Requires-Dist: pandas>=3.0.1
+Requires-Dist: pexpect>=4.8.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pykrige>=1.7.3
+Requires-Dist: pymongo>=4.16.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: pyvista>=0.47.1
+Requires-Dist: pyvistaqt>=0.11.3
+Requires-Dist: pywebview>=6.1
+Requires-Dist: requests>=2.31.0
+Requires-Dist: scikit-learn>=1.3.0
+Requires-Dist: scipy>=1.17.1
+Requires-Dist: triangle>=20250106
+Description-Content-Type: text/markdown
+
+# flkit
+
+一个功能强大的 Python 工具包，提供空间分析、数据插值、数据库操作、命令行工具等多种功能。
+
+## 功能特性
+
+### 空间分析算法 (flkit.alg)
+- **三角剖分**: Delaunay 三角剖分算法
+- **点与几何体关系**: 点在三角形内、点在多边形内、点在体积内等判断
+- **距离计算**: 有限平面距离、点到三角形距离等
+- **追踪算法**: 曲线追踪和方向计算
+- **索引构建**: 空间索引构建和查询
+
+### 数据插值方法 (flkit.alg.inter)
+- **IDW**: 反距离加权插值（2D/3D）
+- **Kriging**: 克里金插值（普通克里金、泛克里金）
+- **RBF**: 径向基函数插值
+- **最近邻**: 最近邻插值
+- **三线性**: 三线性插值
+- **MIDW**: 改进的 IDW 插值方法
+
+### 数据库操作 (flkit.db)
+- **MongoDB**: MongoDB 数据库连接和操作
+- **DuckDB**: DuckDB 嵌入式数据库支持
+- **文件数据库**: 文件对象数据库管理
+- **路径工具**: 路径处理和压缩工具
+
+### 命令行工具 (flkit.mtcli)
+- **命令解析**: 灵活的命令行参数解析
+- **命令组**: 支持命令分组和嵌套
+- **上下文管理**: 命令执行上下文管理
+
+### 实用工具 (flkit.tools)
+- **MongoDB 管理**: MongoDB 进程管理
+- **区域查询**: 地理区域查询
+- **数据转换**: 字典与列表转换
+- **MongoDB 客户端**: 命令行 MongoDB 客户端
+
+### 类型系统 (flkit.typr)
+- **结果处理**: 统一的结果处理和错误管理
+- **控制台**: 控制台命令执行
+- **网格系统**: 2D/3D 网格管理
+- **Web 视图**: 桌面应用 Web 视图
+- **环境变量**: 环境变量管理
+- **验证**: 数据验证工具
+- **WebSocket**: WebSocket 任务处理
+
+## 安装
+
+### 环境要求
+- Python >= 3.13
+
+### 安装依赖
+
+```bash
+pip install numpy scipy pandas pykrige triangle pymongo duckdb pyvista pyvistaqt matplotlib opencv-python fastapi requests pywebview click pexpect pydantic python-dotenv scikit-learn
+```
+
+或使用版本约束：
+
+```bash
+pip install "numpy>=1.24.0" "scipy>=1.10.0" "pandas>=2.0.0" "pykrige>=1.7.0" "triangle>=20230923" "pymongo>=4.0.0" "duckdb>=0.9.0" "pyvista>=0.40.0" "pyvistaqt>=0.10.0" "matplotlib>=3.7.0" "opencv-python>=4.8.0" "fastapi>=0.100.0" "requests>=2.31.0" "pywebview>=4.0.0" "click>=8.1.0" "pexpect>=4.8.0" "pydantic>=2.0.0" "python-dotenv>=1.0.0" "scikit-learn>=1.3.0"
+```
+
+### 安装 flkit
+
+```bash
+pip install -e .
+```
+
+## 快速开始
+
+### 空间插值示例
+
+```python
+import numpy as np
+from flkit.alg.inter import Kriging2D, IDW2D
+
+# 创建已知点数据
+points = np.array([
+    [0, 0, 10],
+    [1, 0, 15],
+    [0, 1, 12],
+    [1, 1, 18]
+])
+
+# 使用克里金插值
+kriging = Kriging2D(variogram_model="spherical")
+kriging.fit(points)
+
+# 预测新点的值
+new_point = np.array([0.5, 0.5])
+predicted_value = kriging.predict(new_point)
+print(f"预测值: {predicted_value}")
+```
+
+### 数据库操作示例
+
+```python
+from flkit.db import MongoDBConnector
+
+# 连接 MongoDB
+connector = MongoDBConnector("mongodb://localhost:27017", "mydb")
+
+# 插入数据
+collection = connector.get_collection("users")
+collection.insert_one({"name": "张三", "age": 25})
+```
+
+### 命令行工具示例
+
+```python
+from flkit.typr import command, run_cmd
+from typing import Optional
+
+@command
+def greet(name: str, count: int = 1):
+    """问候命令"""
+    for _ in range(count):
+        print(f"你好, {name}!")
+
+if __name__ == "__main__":
+    run_cmd(greet)
+```
+
+## 项目结构
+
+```
+flkit/
+├── alg/           # 空间分析算法
+│   ├── inter/     # 插值方法
+│   └── ...
+├── db/            # 数据库操作
+├── mtcli/         # 命令行工具
+├── tools/         # 实用工具
+└── typr/          # 类型系统和工具
+```
+
+## 依赖库
+
+### 核心依赖
+- numpy, scipy, pandas - 数据科学基础
+- pykrige - 克里金插值
+- triangle - 三角剖分
+- pymongo, duckdb - 数据库
+- pyvista, pyvistaqt - 3D 可视化
+- matplotlib - 2D 绘图
+- opencv-python - 图像处理
+- fastapi, requests, pywebview - Web 和网络
+- click, pexpect - 命令行工具
+- pydantic, python-dotenv - 数据验证和配置
+- scikit-learn - 机器学习
+
+## 许可证
+
+请查看项目许可证文件。
+
+## 贡献
+
+欢迎提交 Issue 和 Pull Request！

flkit-0.1.0/README.md

@@ -0,0 +1,160 @@
+# flkit
+
+一个功能强大的 Python 工具包，提供空间分析、数据插值、数据库操作、命令行工具等多种功能。
+
+## 功能特性
+
+### 空间分析算法 (flkit.alg)
+- **三角剖分**: Delaunay 三角剖分算法
+- **点与几何体关系**: 点在三角形内、点在多边形内、点在体积内等判断
+- **距离计算**: 有限平面距离、点到三角形距离等
+- **追踪算法**: 曲线追踪和方向计算
+- **索引构建**: 空间索引构建和查询
+
+### 数据插值方法 (flkit.alg.inter)
+- **IDW**: 反距离加权插值（2D/3D）
+- **Kriging**: 克里金插值（普通克里金、泛克里金）
+- **RBF**: 径向基函数插值
+- **最近邻**: 最近邻插值
+- **三线性**: 三线性插值
+- **MIDW**: 改进的 IDW 插值方法
+
+### 数据库操作 (flkit.db)
+- **MongoDB**: MongoDB 数据库连接和操作
+- **DuckDB**: DuckDB 嵌入式数据库支持
+- **文件数据库**: 文件对象数据库管理
+- **路径工具**: 路径处理和压缩工具
+
+### 命令行工具 (flkit.mtcli)
+- **命令解析**: 灵活的命令行参数解析
+- **命令组**: 支持命令分组和嵌套
+- **上下文管理**: 命令执行上下文管理
+
+### 实用工具 (flkit.tools)
+- **MongoDB 管理**: MongoDB 进程管理
+- **区域查询**: 地理区域查询
+- **数据转换**: 字典与列表转换
+- **MongoDB 客户端**: 命令行 MongoDB 客户端
+
+### 类型系统 (flkit.typr)
+- **结果处理**: 统一的结果处理和错误管理
+- **控制台**: 控制台命令执行
+- **网格系统**: 2D/3D 网格管理
+- **Web 视图**: 桌面应用 Web 视图
+- **环境变量**: 环境变量管理
+- **验证**: 数据验证工具
+- **WebSocket**: WebSocket 任务处理
+
+## 安装
+
+### 环境要求
+- Python >= 3.13
+
+### 安装依赖
+
+```bash
+pip install numpy scipy pandas pykrige triangle pymongo duckdb pyvista pyvistaqt matplotlib opencv-python fastapi requests pywebview click pexpect pydantic python-dotenv scikit-learn
+```
+
+或使用版本约束：
+
+```bash
+pip install "numpy>=1.24.0" "scipy>=1.10.0" "pandas>=2.0.0" "pykrige>=1.7.0" "triangle>=20230923" "pymongo>=4.0.0" "duckdb>=0.9.0" "pyvista>=0.40.0" "pyvistaqt>=0.10.0" "matplotlib>=3.7.0" "opencv-python>=4.8.0" "fastapi>=0.100.0" "requests>=2.31.0" "pywebview>=4.0.0" "click>=8.1.0" "pexpect>=4.8.0" "pydantic>=2.0.0" "python-dotenv>=1.0.0" "scikit-learn>=1.3.0"
+```
+
+### 安装 flkit
+
+```bash
+pip install -e .
+```
+
+## 快速开始
+
+### 空间插值示例
+
+```python
+import numpy as np
+from flkit.alg.inter import Kriging2D, IDW2D
+
+# 创建已知点数据
+points = np.array([
+    [0, 0, 10],
+    [1, 0, 15],
+    [0, 1, 12],
+    [1, 1, 18]
+])
+
+# 使用克里金插值
+kriging = Kriging2D(variogram_model="spherical")
+kriging.fit(points)
+
+# 预测新点的值
+new_point = np.array([0.5, 0.5])
+predicted_value = kriging.predict(new_point)
+print(f"预测值: {predicted_value}")
+```
+
+### 数据库操作示例
+
+```python
+from flkit.db import MongoDBConnector
+
+# 连接 MongoDB
+connector = MongoDBConnector("mongodb://localhost:27017", "mydb")
+
+# 插入数据
+collection = connector.get_collection("users")
+collection.insert_one({"name": "张三", "age": 25})
+```
+
+### 命令行工具示例
+
+```python
+from flkit.typr import command, run_cmd
+from typing import Optional
+
+@command
+def greet(name: str, count: int = 1):
+    """问候命令"""
+    for _ in range(count):
+        print(f"你好, {name}!")
+
+if __name__ == "__main__":
+    run_cmd(greet)
+```
+
+## 项目结构
+
+```
+flkit/
+├── alg/           # 空间分析算法
+│   ├── inter/     # 插值方法
+│   └── ...
+├── db/            # 数据库操作
+├── mtcli/         # 命令行工具
+├── tools/         # 实用工具
+└── typr/          # 类型系统和工具
+```
+
+## 依赖库
+
+### 核心依赖
+- numpy, scipy, pandas - 数据科学基础
+- pykrige - 克里金插值
+- triangle - 三角剖分
+- pymongo, duckdb - 数据库
+- pyvista, pyvistaqt - 3D 可视化
+- matplotlib - 2D 绘图
+- opencv-python - 图像处理
+- fastapi, requests, pywebview - Web 和网络
+- click, pexpect - 命令行工具
+- pydantic, python-dotenv - 数据验证和配置
+- scikit-learn - 机器学习
+
+## 许可证
+
+请查看项目许可证文件。
+
+## 贡献
+
+欢迎提交 Issue 和 Pull Request！

flkit-0.1.0/pyproject.toml

@@ -0,0 +1,31 @@
+[project]
+name = "flkit"
+version = "0.1.0"
+description = "一个功能强大的 Python 工具包，提供空间分析、数据插值、数据库操作、命令行工具等多种功能"
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = [
+    "duckdb>=1.5.1",
+    "fastapi>=0.135.2",
+    "matplotlib>=3.10.8",
+    "numpy>=2.4.4",
+    "opencv-python>=4.13.0.92",
+    "pandas>=3.0.1",
+    "pykrige>=1.7.3",
+    "pymongo>=4.16.0",
+    "pyvista>=0.47.1",
+    "pyvistaqt>=0.11.3",
+    "pywebview>=6.1",
+    "scipy>=1.17.1",
+    "triangle>=20250106",
+    "click>=8.1.0",
+    "pexpect>=4.8.0",
+    "pydantic>=2.0.0",
+    "python-dotenv>=1.0.0",
+    "scikit-learn>=1.3.0",
+    "requests>=2.31.0",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"

flkit-0.1.0/src/flkit/__init__.py

@@ -0,0 +1,2 @@
+def hello() -> str:
+    return "Hello from flkit!"

flkit-0.1.0/src/flkit/alg/__init__.py

@@ -0,0 +1,68 @@
+"""
+算法库
+
+- c_next_point: 计算钻孔轨迹的下一个拐点坐标
+- get_up_low: 获取钻孔轨迹的上、下点坐标
+- finite_plane_distance: 计算点到有限平面的距离
+- inter: 插值算法
+"""
+
+from .c_track import c_next_point, comp_towards, comp_towards_batch
+from .get_up_low import get_up_low, linear_interpolation
+from .finite_plane_distance import comp_sliding_diff, finite_plane_distance
+from . import inter
+from .in_tin import (
+    is_point_in_triangle,
+    is_point_in_triangles,
+    point_to_triangle_distance,
+)
+from .point_in_polygon import PointInPolygon
+from .rotated_rect import RotatedRect
+from .index import list_index
+from .point_to_triangle_mesh import PointToTriangleMesh
+from .delaunay_triangulation import (
+    DelaunayTriangulation,
+    OptimizedDelaunayTriangulation,
+    TriangleLibTriangulation,
+    point_in_polygon,
+    bound_triangulation,
+    interpolate_delaunary_z,
+    convex_hull_boundary,
+)
+from .point_to_triangle import PointInTriangle
+from .point_to_triangle_rs import PointInTriangle as PointInTriangleRs
+from .point_in_volume import PointInVolume
+from .point_in_volume_rs import PointInVolume as PointInVolumeRs
+
+from .build_idx import build_idx
+
+
+__all__ = [
+    "c_next_point",
+    "comp_towards",
+    "comp_towards_batch",
+    "get_up_low",
+    "linear_interpolation",
+    "comp_sliding_diff",
+    "finite_plane_distance",
+    "inter",
+    "is_point_in_triangle",
+    "is_point_in_triangles",
+    "point_to_triangle_distance",
+    "PointInPolygon",
+    "RotatedRect",
+    "list_index",
+    "PointToTriangleMesh",
+    "DelaunayTriangulation",
+    "OptimizedDelaunayTriangulation",
+    "TriangleLibTriangulation",
+    "point_in_polygon",
+    "bound_triangulation",
+    "interpolate_delaunary_z",
+    "convex_hull_boundary",
+    "PointInTriangle",
+    "PointInTriangleRs",
+    "PointInVolume",
+    "PointInVolumeRs",
+    "build_idx",
+]

flkit-0.1.0/src/flkit/alg/build_idx.py

@@ -0,0 +1,9 @@
+import pandas as pd
+
+def build_idx(df: pd.DataFrame, idx_col: str, include_cols: list[str]) -> list:
+    """
+    构建索引
+    """
+    df[idx_col] = df[include_cols].astype(str).agg(":", sep="").tolist()
+    idxs = df[idx_col].unique().tolist()
+    return idxs

flkit-0.1.0/src/flkit/alg/c_track.py

@@ -0,0 +1,88 @@
+import math
+from typing import Any, Dict, List
+
+
+def c_next_point(start_point, length, inclination, azimuth):
+    """
+    计算钻孔轨迹的下一个拐点坐标
+
+    参数:
+        start_point: 起点坐标 (x, y, z) 元组
+        length: 钻孔长度 (必须为正数)
+        inclination: 倾角/倾斜角 (度，-90到90度，负值表示向上)
+        azimuth: 方位角 (度，0-360度)
+
+    返回:
+        下一个拐点的三维坐标 (x, y, z) 元组
+
+    坐标系约定:
+        - X轴：东西方向（东为正）
+        - Y轴：南北方向（北为正）
+        - Z轴：垂直方向（向下为正，符合钻孔深度增加的习惯）
+
+    倾角约定:
+        - 0度：水平
+        - 90度：垂直向下
+        - -90度：垂直向上
+    """
+    if length < 0:
+        raise ValueError(f"钻孔长度必须为正数{length}")
+
+    # 倾角范围检查（允许负值）
+    if not -90 <= inclination <= 90:
+        raise ValueError("倾角必须在-90到90度之间")
+
+    if not 0 <= azimuth <= 360:
+        raise ValueError("方位角必须在0-360度之间")
+
+    # 转换为弧度
+    inclination_rad = math.radians(inclination)
+    azimuth_rad = math.radians(azimuth)
+
+    # 计算坐标增量
+    # 水平分量（在XY平面上的投影）
+    horizontal_component = length * math.cos(inclination_rad)
+    # 垂直分量（Z方向）
+    vertical_component = length * math.sin(inclination_rad)
+
+    # 分解水平分量到X和Y方向
+    delta_x = horizontal_component * math.sin(azimuth_rad)
+    delta_y = horizontal_component * math.cos(azimuth_rad)
+    delta_z = vertical_component
+
+    # 计算新坐标
+    x = start_point[0] + delta_x
+    y = start_point[1] + delta_y
+    z = start_point[2] + delta_z
+
+    return (x, y, z)
+
+
+def comp_towards(start: dict, end: dict) -> float:
+    """计算从起点指向终点的方向角度（顺时针，以正北为0度）"""
+    if "x" not in start or "y" not in start or "x" not in end or "y" not in end:
+        raise ValueError("点必须包含x和y坐标")
+    dx = end["x"] - start["x"]
+    dy = end["y"] - start["y"]
+    angle = math.acos(dy / math.sqrt(dx**2 + dy**2))
+    return round(math.degrees(angle), 3)
+
+
+def comp_towards_batch(points: List[Dict[str, Any]]) -> List[Dict[str, Any]]:
+    """批量计算从起点指向终点的方向角度（顺时针，以正北为0度）"""
+    if len(points) < 2:
+        raise ValueError("点列表长度必须大于等于2")
+
+    blocks = []
+    for i in range(len(points) - 1):
+        block = {
+            "start": points[i],
+            "end": points[i + 1],
+        }
+        blocks.append(block)
+
+    for block in blocks:
+        angle = comp_towards(block["start"], block["end"])
+        block["angle"] = angle
+
+    return blocks