WaveCraft v4.0 · 量子化学波函数可视化分析平台
WaveCraft v4.0 是对原 PyQt5/Python v3.1 版本(已修复并归档至 legacy_python/)进行的底层全栈重构版本。系统底层采用 Rust(Tokio 异步引擎 + Axum HTTP 服务 + 原生 Gaussian Cube/Marching Cubes 算法 + GBK 编解码管道),前端采用 React 19 + TypeScript + TailwindCSS + Three.js (WebGL),打造 Quantum Obsidian 现代暗黑科研工作台。
核心技术栈
- Rust 核心引擎 (
crates/wavecraft-core)config.rs: 自动探测本地Multiwfn.exe与官方examples/波函数示例库,持久化保存配置与历史记录。engine.rs: 基于 Tokio 的隔离目录异步 Multiwfn 进程池(GBK 编解码、防目录污染、超时保护、任务队列审计)。cube.rs: 高性能 Gaussian.cub/.cube解析器、任意平面 2D 切面提取、以及纯 Rust 原生 3D Marching Cubes 双相等值面网格提取引擎。parser.rs: 内置 1–86 号元素周期表、共价半径自动成键算法、轨道能级/HOMO-LUMO Gap 解析、16 种原子电荷与 10 种键级解析、QTAIM 临界点、NCI/IGM 散点、Gaussian TDDFT/IR/Raman 谱峰与连续高斯/洛伦兹展宽。commands.rs&menu_catalog.rs: 针对 Multiwfn 3.8 (2026-Jan-7) 实测校准后的命令序列生成器与完整功能目录。
- Rust 应用服务 (
crates/wavecraft-app)- 提供全套
/api/*REST 接口、文件上传与下载、并自动托管frontend/dist静态产物,支持以 Edge/Chrome--app独立桌面窗口模式运行。
- 提供全套
- 现代化前端 (
frontend/)- Three.js 3D 分子与轨道视口:支持球棍/空间填充/线框切换、电荷静电映射着色、点击原子实时测量距离与键角、正负双相 3D 等值面透明度/网格控制、AIM 临界点 3D 标注、PNG 高清截图。
- HTML5 Canvas 2D 热图:支持 XY/XZ/YZ 切面滑块、Viridis/Plasma/Inferno/Coolwarm/RdBu 5 种科学色板、等高线与原子投影、鼠标十字准星读取坐标与数值。
- 11 大全功能工作台 +
Ctrl+K全局命令调色板。
快速启动
方式一:PyPI 安装(推荐 Windows 用户)
pip install wavecraft-gui
wavecraft
方式二:npm / npx 启动
npx @yangdw2024/wavecraft
方式三:从源码构建
:: 1. 构建前端
cd frontend
pnpm build
cd ..
:: 2. 编译 Rust Release 版本并启动桌面应用
cargo build --release
start_wavecraft.bat
服务默认监听 http://127.0.0.1:18420,支持传入 --port 18420 与 --no-open 参数。
发布地址
Metadata
Release files for wavecraft-gui 4.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| wavecraft_gui-4.0.1.tar.gz | 3.4 MB | Without provenance | Details for wavecraft_gui-4.0.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| wavecraft_gui-4.0.1-py3-none-any.whl | Python 3 | none | any | Details for wavecraft_gui-4.0.1-py3-none-any.whl |
Total release size: 6.9 MB
Release files / wavecraft_gui-4.0.1.tar.gz
| Download URL | wavecraft_gui-4.0.1.tar.gz |
|---|---|
| Size | 3.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
742d45f593ed355cdf38064c15ac9ac6bdcfd113c4ee2c533972f8e1b362db5e
|
|
BLAKE2b-256 checksum How to use checksums |
a1335e100a06c9f352ca8a3609d573b1f570b28b934bb61b1d4f9742a412ae87
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.13
|
Release files / wavecraft_gui-4.0.1-py3-none-any.whl
| Download URL | wavecraft_gui-4.0.1-py3-none-any.whl |
|---|---|
| Size | 3.5 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ea8a8b40a47679010be3ee6044bc6d3ee23e2148dcf747f0ecf38024b7da5296
|
|
BLAKE2b-256 checksum How to use checksums |
9d6cfd439a37a0e25af43e454cda17d4c7bd1353dcce364dc0852cd6f9036f06
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.13
|
Security for wavecraft-gui 4.0.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.