SU2-Quantum

SU2-Quantum 是 SU2 8.3.0 "Harrier" 的一个分支。它给上游加了一个 FT 频域滤波器（每步隐式求解后对守恒量增量做 3-D 实数 FFT、按需截断/施扰再逆变换），用来为「用量子算法做 CFD」做端到端资源估计——测定要保留多少谱模态、能容忍多大噪声/有限比特精度。参考算例是三维 Taylor–Green Vortex (TGV)。完整简介 / 目的 / 许可见文档站首页。

📖 完整文档在 MkDocs 文档站，不在本 README。 本地 / 开发机上用 poe docs 启动（→ http://<host>:8888），或直接读 docs/ 下的 Markdown 源文件。 本 README 刻意保持精简——请不要在这里堆章节，新内容写到 docs/。

快速开始

前置依赖：C/C++ 编译器、Python ≥ 3.12、uv、 MPI（OpenMPI / MPICH）、OpenMP、FFTW3（硬依赖）。完整参考见 docs/install.md。

uv sync          # Python 依赖
poe setup        # 配置构建（本地 = -O3 -march=native + MKL）
poe build        # 编译 → ./bin/
poe run          # 冒烟测试：8 MPI × 4 OMP，16³ 网格，8 步迭代
poe test         # pytest（Python）+ meson test（C++）
poe docs         # 在 :8888 启动文档站

⚠️ poe 已经管理好 Python 环境——不要在命令前加 uv run。

更多文档

所有内容都在文档站（docs/）：相对上游的改动、FT 滤波器机制、命令参考、运行 单算例、HyperQueue 扫描、端到端工作流、后处理出图，以及有出处的实验经验。设备绑定的 会话笔记（HQ job ID、机器路径、实验日志）在设备层 private/（结构说明见文档站 设备层指南）。

许可与上游

LGPL-2.1（沿用上游 SU2，见 COPYING），基于 SU2 8.3.0 "Harrier"。完整说明见 文档站首页「许可与上游」（项目身份的唯一权威出处）。