# kimariDraw **Repository Path**: Kimariyb/kimariDraw ## Basic Information - **Project Name**: kimariDraw - **Description**: A Python script that processes Multiwfn spectral data and plots various spectra. - **Primary Language**: Python - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2023-09-05 - **Last Updated**: 2023-10-31 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README


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 官网](http://sobereva.com/multiwfn/)了解更多信息。** ## 安装 **推荐！** 我们推荐使用 anaconda 虚拟环境进行安装，方便对包进行管理，同时也不会影响其他项目的环境。 1. 如果没有安装 Python，可以不用安装 Python，直接前往 [anaconda 官网](https://www.anaconda.com/)下载 anaconda 最新版本。安装并配置好以后，使用 anaconda 新建一个环境。 ```shell conda create -n KimariDraw python=3.8.13 ``` 2. 激活名为 kimaridraw 的 conda 环境： ```shell conda activate KimariDraw ``` 3. 使用 pip 工具安装 kimaridraw ```shell pip install KimariDraw ``` 4. 安装 kimaridraw 所需要的包和库： ```shell 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光谱图](http://sobereva.com/224)。 **请注意：在正式运行前，请确保已经安装了 KimariDraw 所需要的模块和包，以免程序报错！** **准备环境**：如果使用 pip 安装了 KimariDraw，可以直接在终端中输入 KimariDraw 命令运行 KimariDraw 程序。 ```shell KimariDraw ``` **准备 toml 文件**：接着程序显示程序头以及提示你要你选择一个 toml 文件，所有的指令和提示非常清晰，比如输入 `q` 可以直接退出，按空格可以使用 GUI 选择 toml 文件。 ```shell 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` 保存图片。 ```shell "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 了解详情**。 ```shell 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...]`, 这个属性指定了直线的颜色主题。 ```toml [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 开源模组，在这里对开发这些模组的工作人员表示感谢。 - **numpy**, https://numpy.org/ - **pandas**, https://pandas.pydata.org/ - **matplotlib**, https://matplotlib.org/ - **proplot**, https://proplot.readthedocs.io/en/latest/ - **wxpython**, https://www.wxpython.org/ - **toml**, https://github.com/uiri/toml - **setuptools**, https://github.com/pypa/setuptools - **openpyxl**, https://openpyxl.readthedocs.io/en/stable/ ## 许可证 KimariDraw 基于 MIT 许可证开源。这意味着您可以自由地使用、修改和分发代码。 ## 如何使用老版本 由于 2.5.1 版本以及以后的所有版本，都不会保留绘制多子图功能，因此对于想要绘制多子图的同学比较难受。如果非要使用 KimariDraw 绘制多子图，可以选择老版本也就是 2.4.0 版本。 直接 clone 本项目后，就可以在 `v2.4 (old version)` 压缩包里找到具体的安装以及使用方法。 ```shell git clone https://github.com/kimariyb/kimariDraw.git ```