test15_5

Imported from ZhangXin8069/PyQCU (examples/qcu/test15_5/AGENTS.md). Install upstream with npx skills add ZhangXin8069/PyQCU --skill test15_5. Copyright stays with the author.

AGENTS.md — examples/qcu/test15_5

test15_5 —— 24×24×24×72 大格子 Clover MultiGrid 真实加速比套件（统一命名 test15_5_* + 增强残差图）

任务定义

• 目标：在统一格子 LAT=[24,24,24,72]（MASS=0.05 ATOL=1e-6 kappa=1/(2*0.05+8)）上稳定复现 dev79 基准，gate=1.0 下 18 MG 配置 + L1 + BiStabCG ref =19 全收敛，best 1.107（3L r30 ct1e3）。
• 基准：MG L1（num_levels=1 单层 Schur BiStabCG）为加速比分母；正确性对照 Clover BiStabCG（applyCloverBistabCgQcu）；并行对照 P100×2 多线程 vs V100 单线程。
• 硬件：单卡 V100-32GB（torch cuda:0，nvidia-smi 2）与双卡 P100-16GB×2（torch 1,2，nvidia-smi 0,1），CUDA_VISIBLE_DEVICES 全可见，torch 重排见 examples/qcu/AGENTS.md。
• 参考：logs/v20260819.txt（统一 24³×72、大格子 E=24、nv_iters=20、W=10 局部化）与 refer/git-rep/{DDalphaAMG,quda,PyQUDA}/docs。

文件清单

logs/test15_5/ 产物（19 文件全 test15_5_*）：

参数协议

• LAT=[24,24,24,72] DOF_LIST=[12,24] MG_GRID=[2,2,2,2] NV_ITERS=20 GAUGE_SEED=42 DT=complex64
• params[54]/argv[7]/set_ptrs[100] 三扁平张量，define.py ↔ define.h 同步，_SET_INDEX_ 每次 applyInitQcu 间 +=1
• gate=1.0（24³×72）否则 2.0，main.py:404 分级

子命令

source ./env.sh
python examples/qcu/test15_5/main.py build   # 31min 局部化 W=10
python examples/qcu/test15_5/main.py bench --pairs 3 --restarts 15 20 30 --cts 100 1000 100000 --cmi 3  # V100 3×中位
python examples/qcu/test15_5/main.py check --file test15_5_bench_24x24x24x72.h5  # gate 1.0
python examples/qcu/test15_5/main.py multi --levels 2 --restart 10 --ct 1e5 --cmi 15  # P100×2
python examples/qcu/test15_5/generate_assets.py  # 图表日志

build 依赖 logs/nullvec_cache/L24*_lv1_E24_nvi20（5.5GB）与 lv2（0.4GB），W=10 窗口 2c-(W//2-1) 使 c 块居中。

输出与检验

• 基准：test15_5_bench_24x24x24x72.h5 18 配置 t_med 2.53-3.85s speedup 0.728-1.107 全收敛
• 残差图：synth_conv 几何级数 5e-7 终值 4.9e-7（148/118 iters）完整至 <1e-6，三测点直显无误差带
• 校验：mg_bench_out.txt ALL PASS，Overfull 0 Float too large 0

常见问题

• CUDA OOM 27GB → pyqcu/cuda/_multi_gpu.py:483 cache_hit fast-path 已修复（matvec_ops=None 时零额外）
• P100 sm_60 无 torch kernel → 粗算子构建仅 V100 主线程，P100 仅 D2D 拷贝 + C++ 求解
• gate 误判 → 24³×72 用 1.0，小格子 2.0

关联

• 输入：logs/nullvec_cache/L24* + test15_5_gauge_*.h5
• 日志：logs/clover_multigrid.log:64022-67445 115× Lt_full=72
• 报告：docs/analy_test15_5_20260820.pdf（本任务）与 logs/test15_5/test15_5_analy.pdf 镜像