![logo](GCTL_logo.jpg)

> **注意**: 本文档由 Cursor AI 自动生成。文档中的函数名称、参数和用法说明可能存在错误，请以头文件（`.h`）中的实际函数声明为准。如发现任何不一致，请以源代码为准。

# GCTL Potential

GCTL Potential 是地球物理计算工具与库（Geophysical Computational Tools & Library, GCTL）的重力和磁力场正演模拟模块。该模块提供了一系列用于计算重力场和磁场的核心功能。

## 功能特性

### 重力场计算 (G-Kernel)
- 2D模型计算
  - `gkernel_triangle2d`: 二维三角形体
  - `gkernel_rectangle2d`: 二维矩形体
  - `gkernel_polygon`: 二维多边形体

- 3D模型计算
  - `gkernel_triangle`: 三维三角形体
  - `gkernel_sphere`: 球体
  - `gkernel_block`: 长方体
  - `gkernel_tetrahedron`: 四面体
  - `gkernel_tricone`: 三锥体
  - `gkernel_tesseroid`: 曲面格网体（需要 GCTL_POTENTIAL_TESS 选项）

### 磁场计算 (M-Kernel)
- `mkernel_dipole`: 偶极子
- `mkernel_block`: 长方体
- `mkernel_triangle`: 三角形体
- `mkernel_tricone`: 三锥体
- `mkernel_tetrahedron`: 四面体
  - 标准实现
  - Ren2017 实现方法
- `mkernel_tesseroid`: 曲面格网体（需要 GCTL_POTENTIAL_MAGTESS 选项）

### 网格与数据结构
- `gm_data`: 基础数据结构
- `gm_regular_grid`: 规则网格
- `gm_regular_mesh_2d`: 二维规则网格
- `gm_regular_mesh_3d`: 三维规则网格
- `gm_regular_mesh_sph_3d`: 三维球面规则网格
- `gm_tet_mesh`: 四面体网格

## 依赖
- Eigen (矩阵运算库)
- autodiff (自动微分库，用于梯度计算)

## 许可证
GCTL Potential 采用双重许可证方案：
1. GNU Lesser General Public License v2 或更高版本
2. 商业许可证（需单独购买）

## 作者
- Yi Zhang (yizhang-geo@zju.edu.cn)

## 安装
使用 CMake 构建系统：
```bash
mkdir build
cd build
cmake ..
make
make install
```

## 示例
`example` 目录下提供了丰富的示例代码，展示了各种计算功能的使用方法：

### 重力场计算示例
- `gobser_tri2d_ex.cpp`: 二维三角形体重力场计算
  - 演示了如何读取 GMSH 格式的网格文件
  - 计算重力位、重力分量和重力梯度张量
  - 结果输出为 DSV 格式
- `gobser_tri2d_sph_ex.cpp`: 球面坐标系下的二维三角形体重力场计算

### 磁场计算示例
- `mobser_tetra_ex.cpp`: 四面体磁场计算
  - 展示了标准实现和 Ren2017 方法的对比
  - 包含磁位、磁场分量和 ΔT 异常计算
  - 支持 NetCDF 格式输出
- `mobser_tetra_ex2.cpp`: 四面体磁场计算的另一个示例
- `mobser_block_ex.cpp`: 长方体磁场计算
- `mobser_tricone_ex.cpp`: 三锥体磁场计算
- `mobser_tesseroid_ex.cpp`: 曲面格网体磁场计算
- `mobser_dipole_ex.cpp`: 偶极子磁场计算
- `mobser_tri_ex.cpp`: 三角形体磁场计算
- `mobser_tri_sph_ex.cpp`: 球面坐标系下的三角形体磁场计算

### 特殊功能示例
- `power_spectrum_ex.cpp`: 功率谱计算示例
- `read_IGRF_ex.cpp`: IGRF 地磁场模型数据读取示例
- `mobser_block_gradient_ex.cpp`: 长方体磁场梯度计算

### 数据格式支持
- 网格文件格式：
  - GMSH 格式 (.msh)
  - Tetgen 格式 (.node, .ele)
- 输出格式：
  - DSV (Delimiter-Separated Values)
  - NetCDF
  - 文本格式

所有示例代码都包含详细的注释，并提供了完整的数据输入输出流程。用户可以根据需要修改示例代码中的参数来适应自己的应用场景。

## 注意事项
- 某些功能（如 tesseroid 计算）需要在编译时启用特定选项
- 商业用途请联系作者获取商业许可证