Skip to main content

A Python script that processes Multiwfn spectral data and plots various spectra.

Project description


KimariDraw 是一款开源的 Python 脚本,旨在绘制各种光谱图形,特别适用于处理著名的波函数分析程序 Multiwfn 生成的光谱数据。它能够将 Multiwfn 生成的数据以美观、清晰的方式重新绘制成单曲线单子图、多曲线单子图、单曲线多子图以及多曲线多子图。

当你使用 KimariDraw 时,你可以享受到以下的功能:

  • 支持多种光谱类型:KimariDraw 支持使用 Multiwfn 绘制 NMR、IR 等光谱导出的数据,即 Multiwfn 生成的文本文件。

  • 支持多子图绘制:KimariDraw 不仅支持一单子图的绘制,同时也支持多子图的绘制(多子图的绘制功能在 2.5.1 版本之后就不存在了,但是在 2.4.0 版本还保留)。

  • 支持多种文件格式:KimariDraw 支持将图片导出为多种文件格式,如 PNG、JPG、PDF、SVG 等。

  • 易于安装和配置:KimariDraw 的安装和配置十分简单,您只需要按照项目 README 文件中的说明进行操作即可。

  • 自定义功能强大:KimariDraw 可以根据需要自定义曲线的颜色、图例以及格式,可以达到科研论文要求。

Multiwfn 是一个非常强大的波函数分析程序。Multiwfn 免费、开源、高效、灵活,它支持几乎所有最重要的波函数分析方法。目前,Multiwfn 是量子化学领域的常用工具之一,得到了广泛的应用和认可。

如果您对 Multiwfn 还不熟悉,请访问 Multiwfn 官网了解更多信息。

安装

推荐! 我们推荐使用 anaconda 虚拟环境进行安装,方便对包进行管理,同时也不会影响其他项目的环境。

  1. 如果没有安装 Python,可以不用安装 Python,直接前往 anaconda 官网下载 anaconda 最新版本。安装并配置好以后,使用 anaconda 新建一个环境。
conda create -n KimariDraw python=3.8.13
  1. 激活名为 kimaridraw 的 conda 环境:
conda activate KimariDraw
  1. 使用 pip 工具安装 kimaridraw
pip install KimariDraw
  1. 安装 kimaridraw 所需要的包和库:
pip install pandas==1.4.3 -i https://pypi.tuna.tsinghua.edu.cn/simple
pip install numpy==1.23.5 -i https://pypi.tuna.tsinghua.edu.cn/simple
pip install proplot==0.9.5 -i https://pypi.tuna.tsinghua.edu.cn/simple
pip install matplotlib==3.4.3 -i https://pypi.tuna.tsinghua.edu.cn/simple
pip install toml==0.10.2 -i https://pypi.tuna.tsinghua.edu.cn/simple
pip install setuptools==68.0.0 -i https://pypi.tuna.tsinghua.edu.cn/simple
pip install wxpython==4.2.1 -i https://pypi.tuna.tsinghua.edu.cn/simple
pip install openpyxl==3.1.2 -i https://pypi.tuna.tsinghua.edu.cn/simple

这将安装 KimariDraw 所需的 pandas、matplotlib 和 proplot 等依赖项。同时,由于激活的 conda 环境,因此 pip 安装的包只会在 kimaridraw 环境下使用,如果不激活就不会被使用。这样就很好的避免了不同任务依赖的环境不同,所导致的版本冲突。

使用

在使用 KimariDraw 之前,必须使用 Multiwfn 自行根据量子化学计算程序生产的各种光谱计算产生的 .out 文件得到光谱的数据。如果不了解如何使用 Multiwfn 绘制各类光谱,可以浏览 Sob 的 使用Multiwfn绘制红外、拉曼、UV-Vis、ECD、VCD和ROA光谱图

请注意:在正式运行前,请确保已经安装了 KimariDraw 所需要的模块和包,以免程序报错!

准备环境:如果使用 pip 安装了 KimariDraw,可以直接在终端中输入 KimariDraw 命令运行 KimariDraw 程序。

KimariDraw

准备 toml 文件:接着程序显示程序头以及提示你要你选择一个 toml 文件,所有的指令和提示非常清晰,比如输入 q 可以直接退出,按空格可以使用 GUI 选择 toml 文件。

KimariDraw --  A Python script that processes Multiwfn spectral data and plots various spectra.
Version: 2.5.2, release date: Sep-02-2023
Developer: Kimariyb, Ryan Hsiun
Address: XiaMen University, School of Electronic Science and Engineering
KimariDraw home website: https://github.com/kimariyb/kimariDraw

(Copyright (C) 2023 Kimariyb. Currently timeline: Sep-02-2023, 00:45:45)

Input toml file path, for example E:\Hello\World.toml
Hint: Press ENTER button directly can select file in a GUI window. If you want to exit the program, simply type the letter "q" and press Enter.

输入 toml 文件之后就可以进入主程序页面,接着可以输入命令,每一个命令的含义都在屏幕上显示的非常清楚。假如想直接看看默认的绘图效果,可以输入 0。当然大部分情况下,默认的设置都不太可能满足用户的需求,这时候可以输入其他命令修改绘图的设置。最后可以使用命令 1 保存图片。

 "q": Exit program gracefully    "r": Load a new file
********************************************************
****************** Main function menu ******************
********************************************************
-1 Set font family of the spectrum, current: Arial
-2 Set font size of the spectrum, current: [10.5, 12, 14]
-3 Set title/xlabel/ylabel of the spectrum
-4 Set format of saving spectrum file, current: png
-5 Set dpi of saving spectrum, current: 400.0
-6 Set figure size of spectrum file, current: (6, 5)
0 Save graphical file of the spectrum in current folder!
1 Set lower and upper limit of X-axis, current: [120.0, 280.0, 20.0]
2 Set lower and upper limit of left Y-axis, current: [-100.0, 100.0, 20.0]
3 Set lower and upper limit of right Y-axis, current: [-64.0, 64.0, 16.0]
4 Toggle showing legend text, current: False
5 Toggle showing the zero axis, current: True
6 Toggle showing discrete lines, current: False

KimariDraw 还可以通过命令行参数运行,可以在终端中输入 KimariDraw -h 了解详情

KimariDraw xxx.toml

有关 toml 文件

Toml(Tom's Obvious, Minimal Language)是一种易于阅读和编写的配置文件格式。它的设计目标是提供一个简单、直观且易于理解的配置语法,适用于各种应用程序和工具。

想要运行 KimariDraw 必须准备一个 toml 文件。KimariDraw 的 toml 文件必须遵守程序要求的配置内容,KimariDraw 可以配置以下键值对。

  • [curve] 必须配置,这是 toml 文件中表的标志。该标识代表 [curve] 以下的内容都为这个表的属性。
    • path string,这个属性指定了绘制曲线图所需数据的文件路径。
    • color string, list[string...], 这个属性指定了曲线的颜色主题。
    • legend string, list[string...], 这个属性制定了曲线的图例文本。只有 [curve] 才能配置这个属性!
    • style string, list[string...], 这个属性制定了曲线的样式风格。只有 [curve] 才能配置这个属性!
  • [line] 可选择配置,这是 toml 文件中表的标志。
    • path string,这个属性指定了绘制直线所需数据的文件路径。
    • color string, list[string...], 这个属性指定了直线的颜色主题。
[curve]
path = "uv_curve.txt"
color = ["black", "red", "orange", "green", "blue"]
legend = ["total", "S0 to S2", "S0 to S5", "S0 to S11", "S0 to S13"]
style = ["-", "--", "--", "--", "--"]

[line]
path = "uv_line.txt"
color = "black"

请注意! 最好把 toml 文件以及 txt 文件放在一个目录下,同时 path 只用写上 txt 文件的名字,这样能很好的避免 bug。

Toml 文件中可以配置的颜色可以为常规的 red、blue 等文本,也可以是 16 进制的颜色代号。同时由于 KimariDraw 基于 Proplot 和 Matplotlib 开发,因此也可以直接使用 Proplot 和 Matplotlib 内置的颜色主题。

绘制效果

示例文件example/uv.toml

双 Y 轴绘制效果 单 Y 轴绘制效果

示例文件example/ecd.toml

双 Y 轴绘制效果 单 Y 轴绘制效果

使用脚本批量生成光谱

KimariDraw 程序中自带了一个用 KimariDraw 程序批量绘制光谱的脚本。如果需要批量绘制光谱,可以在 script 文件夹中找到这个脚本。由于绘制光谱通常在 Windows 系统下进行,所以只提供了能在 Windows 下运行的 batch 脚本 SpecDraw.exe。 想要使用 SpecDraw.exe 脚本必须同时提供一个 draw.txt 文件,该文件记录了运行 KimariDraw 所需要使用到的命令。

有关 SpecDraw.exe 的详细信息可以浏览 SpecDraw 的主页 https://github.com/kimariyb/SpecDraw

使用脚本批量产生光谱数据

KimariDraw 程序中自带了一个用来批量产生 Multiwfn 光谱数据的脚本。如果想要批量产生绘制光谱的数据,可以在 script 文件夹中找到这个脚本。其中 GenData.sh 为 Linux 系统下的脚本,GenData.bat 为 Windows 系统下的脚本。

GenData.sh 以及 GenData.bat 都需要一个名为 commands.txt 的文件。commands.txt 文件包含了执行 Multiwfn 生成数据所需要的命令,如果想要使用这个脚本,则必须对 Multiwfn 有一定的了解。

鸣谢

在开发 KimariDraw 时,主要使用了以下 Python 开源模组,在这里对开发这些模组的工作人员表示感谢。

许可证

KimariDraw 基于 MIT 许可证开源。这意味着您可以自由地使用、修改和分发代码。

如何使用老版本

由于 2.5.1 版本以及以后的所有版本,都不会保留绘制多子图功能,因此对于想要绘制多子图的同学比较难受。如果非要使用 KimariDraw 绘制多子图,可以选择老版本也就是 2.4.0 版本。

直接 clone 本项目后,就可以在 v2.4 (old version) 压缩包里找到具体的安装以及使用方法。

git clone https://github.com/kimariyb/kimariDraw.git

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kimaridraw-2.5.2.3.tar.gz (15.7 kB view hashes)

Uploaded Source

Built Distribution

kimaridraw-2.5.2.3-py3-none-any.whl (16.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page