EasyCrystal 项目结构说明

目录结构

项目根目录/
├── main.py              # 演示运行入口，启动图形界面
├── environment.py       # 环境记录（项目根、数据库路径等）
├── readme.md            # 本说明
├── utils/               # 不好分类的独立代码
│   └── __init__.py
├── EC/                  # 图检与匹配（含 filter 子模块）
│   ├── __init__.py
│   ├── core.py          # 核心匹配逻辑（原 EC.py）
│   ├── cal.py
│   ├── meta_handle.py
│   ├── shape.py
│   ├── unit.py
│   ├── seek.py
│   └── filter/          # 比例尺与图像预处理
│       ├── __init__.py
│       ├── scale_handle.py
│       ├── scale_bar_filter.py
│       ├── zd.py
│       └── example.py
├── DB/                  # 数据库及接口（cif→data, 查询→cif）
│   ├── __init__.py
│   ├── data_base.py     # 晶体数据库管理
│   └── cif_handle.py    # CIF 解析（文件→数据字典）
├── UI/                  # 用户交互界面
│   ├── __init__.py
│   ├── app.py           # 主界面（原 ui_new 逻辑）
│   └── periodic_table.py
└── img_generate/        # 生成模拟图（输入 cif + 晶向 → 参考图）
    ├── __init__.py      # 预留接口 generate_reference_image(cif, orientation)
    ├── create_image.py
    ├── simulate.py
    └── meta.py

运行方式

在项目根目录下执行 python main.py，支持以下参数：

# 启动图形界面（默认）
python main.py
python main.py open

# 启动命令行工具
python main.py run [run.py的参数]

# 启动MCP服务
python main.py mcp        # 默认端口 8000
python main.py mcp 9000   # 指定端口 9000

或直接运行界面模块：

python ui_new.py

数据库文件默认使用 database 文件夹下的 crystal_data.db。

模块说明

• EC：图检与匹配，包含斑点提取、向量基分析、与 CIF 比对及比例尺过滤（filter）。
• DB：提供 CrystalDatabaseManager（cif 编号 → 晶体数据）及搜索/导出（得到 cif 列表）；cif_handle 提供 CIF 文件解析（cif 文件 → 数据字典）。
• UI：Tkinter 图形界面，元素周期表筛选、运行比对、标定图展示与保存。
• img_generate：按 CIF 与晶向生成参考图，当前为预留接口，具体实现仍在开发中。