Skip to content

v1.0.0 · 首个正式版(iOS 风格 GUI)

Choose a tag to compare

@moyulyy moyulyy released this 03 Oct 15:26
· 13 commits to main since this release

🎉 plot-CONTCAR v1.0.0 · 首个正式版

把 VASP 的 CONTCAR / POSCAR 一键变成漂亮的「俯视图 + 侧视图」结构图,并自动整理进 PPT + 原子图例页。

✨ 亮点

  • 🖥️ iOS 风格 GUI(PySide6):无边框圆角窗口、卡片阴影、滑动开关、胶囊按钮,支持高 DPI
  • 🗂️ 按目录检索:给一个根目录,递归找出所有 CONTCAR,勾选需要处理的项
  • 🌳 保持相对路径:导出的图片与 .vesta 完全镜像输入目录结构
  • 🔭 俯视图 / 侧视图:通过 SCENE 视角矩阵精确控制(俯视沿 c 轴、侧视 c 轴竖直)
  • 🧬 原子样式自动:读取结构元素去重,填入默认半径与颜色(Jmol 配色)
  • 📊 一键生成 PPT:标题页 + 每个结构一页(俯视 / 侧视对照)
  • 🔵 原子图例页:用真实原子颜色渲染带高光的 3D 小球 + 元素标签
  • 🎛️ 参数全界面化:坐标轴 / 晶胞边界 / 化学键 / 显示边界 / 缩放平移 / 半径颜色 / 视角 / 画质 / 超时
  • 🕶️ 免黑框启动:启动GUI.lnk / .vbs / .bat
  • 🐍 同时提供命令行(vesta_tools.py)与 Python API

📦 安装

pip install -r requirements.txt

需要 Windows + VESTA 64 位(默认 D:\software\VESTA-win64\VESTA-win64\VESTA.exe)。

🚀 快速开始

:: GUI(推荐,双击即可,无命令行黑框)
启动GUI.lnk

:: 或命令行
pythonw gui_launcher.pyw

🖼️ 输出结构

output/
├── structures.pptx          # 汇总 PPT
├── images/                  # 俯视 / 侧视图(保持相对路径)
│   └── <子目录>/CONTCAR_top.png / CONTCAR_side.png
└── vesta/                   # 转换后的 .vesta(保持相对路径)
    └── <子目录>/CONTCAR.vesta