Skip to content

Repository files navigation

BaneWfn 1.5.5

BaneWfn 是一个面向 Multiwfn 的工作流脚本器,用来把重复、固定、容易出错的菜单操作整理成可复用的脚本。它不替代 Multiwfn,也不额外实现量子化学分析算法,而是把输入文件、模块配置和后处理命令组织在一起,让常见分析流程更容易复用、共享和批量执行。

在使用方式上,BaneWfn 以两类文本文件为核心:输入文件负责描述任务顺序、变量和批处理逻辑,配置文件负责封装常见的 Multiwfn 菜单路径。如果模块化流程还不够用,也可以直接在脚本里插入原始输入序列,或者直接执行bash/cmd脚本。

BaneWfn 适合这几类工作:同一套分析要在很多波函数文件上反复执行;组内已有较稳定的分析路径,希望沉淀成模板;Multiwfn 结束后还需要继续做文件整理或调用外部脚本;同一份脚本里需要把多个阶段的分析串成一个完整流程。

Software Page: BaneWfn

Manual: BaneWfn_Manual

Wiki

构建

如果使用 CMake,可以采用下面的方式构建:

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j

默认会生成 banewfnbwpack 两个可执行文件。

如果更习惯直接使用 Makefile,可以执行:

make linux
make windows
make both

在 Linux 环境下,如需安装到系统路径,可以继续执行:

make install

如果需要编译测试,可使用:

cmake -S . -B build -DBANEWFN_BUILD_TESTS=ON
cmake --build build
ctest --test-dir build --output-on-failure

快速开始

准备好 Multiwfn 后,先在运行目录或用户配置目录中放置 banewfn.rc。一个最小可用配置如下:

Multiwfn_exec=Multiwfn
confpath=~/.bane/wfn
cores=8

然后编写一份最小脚本,例如:

wfn=test.fchk

[fmo]
%process
    orb index h
    orb index l
end

最常见的运行方式是:

banewfn demo.bw

如果脚本中没有写 wfn=,也可以在命令行里显式指定输入文件:

banewfn demo.bw -w test.fchk

这份脚本会加载 fmo.conf,按模块配置展开对应的 Multiwfn 输入序列,并顺序执行整个任务。

更新历史

详见UPDATE_HISTORY

About

BaneWfn 是一个面向 Multiwfn 的工作流脚本器,用来把重复、固定、容易出错的菜单操作整理成可复用的脚本。

Resources

Contributing

Stars

12 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages