Package: kimaridraw
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 虚拟环境进行安装，方便对包进行管理，同时也不会影响其他项目的环境。如果没有安装 Python，可以不用安装 Python，直接前往anaconda 官网下载 anaconda 最新版本。安装并配置好以后，使用 anaconda 新建一个环境。condacreate-nKimariDrawpython=3.8.13激活名为 kimaridraw 的 conda 环境：condaactivateKimariDraw使用 pip 工具安装 kimaridrawpipinstallKimariDraw安装 kimaridraw 所需要的包和库：pipinstallpandas==1.4.3-ihttps://pypi.tuna.tsinghua.edu.cn/simple
pipinstallnumpy==1.23.5-ihttps://pypi.tuna.tsinghua.edu.cn/simple
pipinstallproplot==0.9.5-ihttps://pypi.tuna.tsinghua.edu.cn/simple
pipinstallmatplotlib==3.4.3-ihttps://pypi.tuna.tsinghua.edu.cn/simple
pipinstalltoml==0.10.2-ihttps://pypi.tuna.tsinghua.edu.cn/simple
pipinstallsetuptools==68.0.0-ihttps://pypi.tuna.tsinghua.edu.cn/simple
pipinstallwxpython==4.2.1-ihttps://pypi.tuna.tsinghua.edu.cn/simple
pipinstallopenpyxl==3.1.2-ihttps://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--APythonscriptthatprocessesMultiwfnspectraldataandplotsvariousspectra.
Version:2.5.2,releasedate:Sep-02-2023
Developer:Kimariyb,RyanHsiun
Address:XiaMenUniversity,SchoolofElectronicScienceandEngineering
KimariDrawhomewebsite:https://github.com/kimariyb/kimariDraw(Copyright(C)2023Kimariyb.Currentlytimeline:Sep-02-2023,00:45:45)Inputtomlfilepath,forexampleE:\Hello\World.toml
Hint:PressENTERbuttondirectlycanselectfileinaGUIwindow.Ifyouwanttoexittheprogram,simplytypetheletter"q"andpressEnter.输入 toml 文件之后就可以进入主程序页面，接着可以输入命令，每一个命令的含义都在屏幕上显示的非常清楚。假如想直接看看默认的绘图效果，可以输入0。当然大部分情况下，默认的设置都不太可能满足用户的需求，这时候可以输入其他命令修改绘图的设置。最后可以使用命令1保存图片。"q":Exitprogramgracefully"r":Loadanewfile
********************************************************
******************Mainfunctionmenu******************
********************************************************
-1Setfontfamilyofthespectrum,current:Arial
-2Setfontsizeofthespectrum,current:[10.5,12,14]-3Settitle/xlabel/ylabelofthespectrum
-4Setformatofsavingspectrumfile,current:png
-5Setdpiofsavingspectrum,current:400.0
-6Setfiguresizeofspectrumfile,current:(6,5)0Savegraphicalfileofthespectrumincurrentfolder!1SetlowerandupperlimitofX-axis,current:[120.0,280.0,20.0]2SetlowerandupperlimitofleftY-axis,current:[-100.0,100.0,20.0]3SetlowerandupperlimitofrightY-axis,current:[-64.0,64.0,16.0]4Toggleshowinglegendtext,current:False5Toggleshowingthezeroaxis,current:True6Toggleshowingdiscretelines,current:FalseKimariDraw 还可以通过命令行参数运行，可以在终端中输入 KimariDraw -h 了解详情。KimariDrawxxx.toml有关 toml 文件Toml（Tom's Obvious, Minimal Language）是一种易于阅读和编写的配置文件格式。它的设计目标是提供一个简单、直观且易于理解的配置语法，适用于各种应用程序和工具。想要运行 KimariDraw 必须准备一个 toml 文件。KimariDraw 的 toml 文件必须遵守程序要求的配置内容，KimariDraw 可以配置以下键值对。[curve]必须配置，这是 toml 文件中表的标志。该标识代表[curve]以下的内容都为这个表的属性。pathstring，这个属性指定了绘制曲线图所需数据的文件路径。colorstring, list[string...], 这个属性指定了曲线的颜色主题。legendstring, list[string...], 这个属性制定了曲线的图例文本。只有[curve]才能配置这个属性！stylestring, list[string...], 这个属性制定了曲线的样式风格。只有[curve]才能配置这个属性！[line]可选择配置，这是 toml 文件中表的标志。pathstring，这个属性指定了绘制直线所需数据的文件路径。colorstring, 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 开源模组，在这里对开发这些模组的工作人员表示感谢。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/tomlsetuptools,https://github.com/pypa/setuptoolsopenpyxl,https://openpyxl.readthedocs.io/en/stable/许可证KimariDraw 基于 MIT 许可证开源。这意味着您可以自由地使用、修改和分发代码。如何使用老版本由于 2.5.1 版本以及以后的所有版本，都不会保留绘制多子图功能，因此对于想要绘制多子图的同学比较难受。如果非要使用 KimariDraw 绘制多子图，可以选择老版本也就是 2.4.0 版本。直接 clone 本项目后，就可以在v2.4 (old version)压缩包里找到具体的安装以及使用方法。gitclonehttps://github.com/kimariyb/kimariDraw.git