井中三分量磁测数据处理与可视化软件

概述

井中三分量磁测数据处理与可视化软件是一套专业的地球物理数据处理工具，专门用于处理井中三分量磁测数据并生成专业图表。该软件结合了磁法勘探和测井勘探技术，用于在钻井中测量岩石和矿物的磁性特征。

主要功能

• 数据处理：处理井中三分量磁测原始数据，计算12种不同的磁异常参数
• 图表生成：
  • 生成专业的DXF格式图纸，可使用CAD软件打开
  • 生成通用的PNG格式图表，便于查看和分享
• 数据可视化：
  • 绘制ΔZ、ΔH、ΔT曲线图
  • 绘制磁场矢量图
  • 整合多种图表类型
• 图形界面：提供直观的图形用户界面，便于操作

应用领域

该软件主要应用于矿产勘探，特别是在铁矿勘探中，能够有效处理井中三分量磁测数据，绘制相关图件，为地质解释提供支持。

系统要求

• 操作系统：Linux (Ubuntu推荐)、Windows、macOS
• Python版本：3.6或更高版本
• 内存：至少1GB RAM
• 存储空间：至少100MB可用空间

安装

1. 克隆仓库

git clone https://github.com/yourusername/MagSlot.git
cd MagSlot

2. 安装依赖

pip install -r requirements.txt

或者在Ubuntu系统中：

sudo apt install python3-numpy python3-matplotlib python3-tkinter

快速开始

图形界面使用（推荐）

python main.py
# 或
python main.py gui

1. 点击"浏览"按钮选择数据文件（如shu1.txt）
2. 根据实际工区情况设置地磁场参数（H0, Z0, A）
3. 点击"处理数据"按钮处理数据
4. 点击"生成DXF图纸"或"生成PNG图表"按钮生成相应格式的图表

命令行使用

处理数据并生成DXF图纸

python main.py process

生成PNG图表

python main.py visualize

数据文件格式

输入数据文件应包含以下列：

深度 剖面方位角 顶角 X分量 Y分量 Z分量

示例数据格式：

   0.00     0.00     0.00  25100.00  24900.00  35100.00
   0.50     0.00     0.00  25150.00  24850.00  35050.00
   1.00     0.00     0.00  25200.00  24800.00  35000.00

地磁场参数说明

• H₀：正常地磁场水平分量（nT）
• Z₀：正常地磁场垂直分量（nT）
• A：剖面方位角（度）

这些参数需要根据实际工区的地磁场特征进行设置。

输出文件

DXF格式图纸（专业图纸）

• delta_Z_curve.dxf：ΔZ曲线图
• delta_H_curve.dxf：ΔH曲线图
• combined_plot.dxf：整合图（包含所有曲线和矢量图）

PNG格式图表（通用图像）

• combined_curves.png：整合曲线图（ΔZ、ΔH、ΔT）
• vector_diagram.png：矢量图（ΔT和ΔT'）

技术原理

井中三分量磁测原理

井中三分量磁测是在钻井中测量岩石和矿物的磁性特征的一种方法。通过测量磁场的三个分量（X、Y、Z），结合地质参数（深度、顶角、剖面方位角），可以计算出各种磁异常参数。

磁异常参数计算

软件计算的磁异常参数包括：

1. ΔX、ΔY、ΔZ：磁异常的三个分量
2. ΔH：磁异常水平分量
3. φ：磁异常方向角
4. ΔH⊥、ΔH∥：磁异常水平分量在横、纵剖面中的投影
5. ΔT：磁异常总矢量
6. ΔT⊥、ΔT∥：磁异常总矢量在横、纵剖面中的投影
7. ΔH'、ΔT'：直孔处理情况下的参数

项目结构

MagSlot/
├── main.py                      # 主程序入口
├── MagLogPlot.py                # 数据处理和DXF生成模块
├── visualize_data.py            # PNG图表生成模块
├── maglog_gui.py                # 图形用户界面
├── gui_app.py                   # 高级图形界面
├── simple_gui.py                # 简化图形界面
├── shu1.txt                     # 示例数据文件
├── build_executable.py          # 可执行文件构建脚本
├── install.sh                   # 安装脚本
├── requirements.txt             # Python依赖列表
├── technical_documentation.md   # 技术文档
└── README_EXECUTABLE.md         # 可执行文件版本说明

开发

环境设置

python -m venv venv
source venv/bin/activate  # Linux/Mac
# 或
venv\Scripts\activate     # Windows

pip install -r requirements.txt

构建可执行文件

python build_executable.py

运行测试

# 测试数据处理
python MagLogPlot.py

# 测试可视化
python visualize_data.py

# 测试图形界面
python main.py

贡献

欢迎提交Issue和Pull Request！

1. Fork 项目
2. 创建功能分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 打开Pull Request

许可证

本项目采用MIT许可证 - 查看 LICENSE 文件了解详情。

技术支持

如在使用过程中遇到问题，请：

1. 查看技术文档
2. 提交Issue描述问题
3. 联系开发者

致谢

感谢所有参与本软件开发和测试的人员，特别感谢实际应用中提供宝贵反馈的用户。

---

版本：1.0
最后更新：2025年7月