Skip to main content

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.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for wavecraft-gui 4.0.5
File Size Uploaded Provenance Actions
wavecraft_gui-4.0.5.tar.gz 3.4 MB Without provenance Details for wavecraft_gui-4.0.5.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for wavecraft-gui 4.0.5
File Interpreter ABI Platform Actions
wavecraft_gui-4.0.5-py3-none-any.whl Python 3 none any Details for wavecraft_gui-4.0.5-py3-none-any.whl

Total release size: 6.9 MB

Release files / wavecraft_gui-4.0.5.tar.gz

Download URL wavecraft_gui-4.0.5.tar.gz
Size 3.4 MB
Tags Source
SHA-256 checksum
How to use checksums
834ab893f2f73883db6b6f73f770de3e892adba0ebda17ba2a1b9a0ef8406fea
BLAKE2b-256 checksum
How to use checksums
638400239bd823c2498e4f963462c580023b558f9460f9443c9da3d1764b9f2b
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.5-py3-none-any.whl

Download URL wavecraft_gui-4.0.5-py3-none-any.whl
Size 3.5 MB
Tags Python 3
SHA-256 checksum
How to use checksums
0b3c692b6aa70a9c84c81ada86be367bee90e01f1bc907d3e7f020b4de534a00
BLAKE2b-256 checksum
How to use checksums
a622f18f899a8ff2de9b6175051674e9e7374a71f1597ce7773ea196898f4f5e
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.5

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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page