# 任务书：OpenFOAM 二维圆柱绕流 Re=100——网格收敛、Strouhal 数与阻力系数，并与文献基准对照

## 1. 背景

二维圆柱绕流是计算流体力学最经典的验证算例。雷诺数 Re=100 时流动进入周期性脱涡状态，形成卡门涡街，升力系数做周期振荡、阻力系数在均值附近小幅波动。因为有大量公开的实验与数值基准值，它常被用来检验一套 CFD 流程是否可信：网格够不够密、时间步够不够小、计算域边界离圆柱够不够远、后处理取值方式对不对。

很多人第一次用 OpenFOAM 会卡在这些地方：算例目录结构（`0/`、`constant/`、`system/`）怎么组织、`blockMeshDict` 怎么写出围绕圆柱的网格、边界条件怎么设、选哪个求解器、时间步长和库朗数怎么定、残差收敛怎么看、力系数怎么算出来、没有图形界面怎么出图和动画。本任务要求从零搭出这个算例，做一次像样的网格收敛验证，并把结果和公开文献对照。

## 2. 研究问题

1. 在 Re=100 下，二维圆柱绕流的 Strouhal 数 St、平均阻力系数 Cd、升力系数振幅 Cl,rms（或峰值）各是多少？
2. 这些量随网格加密如何变化？网格收敛了吗？用什么判据说明已经收敛？
3. 计算域尺寸（上下游长度、阻塞比）和时间步长分别对结果有多大影响？
4. 本次结果与公开文献的基准值相差多少？差异能否由网格、计算域、时间离散或后处理方式解释？

## 3. 计算设置

- **软件**：使用云电脑预装的 OpenFOAM。先确认版本号与可用求解器，写进运行记录。配套的 ParaView 用于出图，必须用无界面（离屏）方式渲染。不要自行编译或安装另一套 OpenFOAM。
- **物理设置**：不可压缩层流，二维。圆柱直径 D，来流速度 U，取 Re = U·D/ν = 100。自行选定一组量纲（建议 D=1、U=1，由 Re 反推 ν），并在报告中写明。
- **计算域与网格**：自行设计。要写明上游长度、下游长度、横向宽度（或阻塞比）、圆柱近壁第一层网格尺寸与增长率，并说明选择理由。推荐用 `blockMesh` 生成结构化 O 型或 C 型网格；若改用其他方式，说明原因。
- **网格收敛**：至少三套系统加密的网格（例如总网格量按约 2 倍逐级增加），对每套网格报告 St、Cd、Cl。说明判断收敛的依据（例如相邻两套网格的相对变化小于某个阈值，或用 Richardson 外推估计离散误差）。
- **时间推进**：选择合适的求解器（如 `pisoFoam` 或 `icoFoam`）并说明理由。报告时间步长、最大库朗数、总物理时间。必须跑到流动进入稳定的周期状态，并说明如何判断「已经稳定」，统计量只在稳定段上取。
- **力系数**：用 OpenFOAM 自带的 `forceCoeffs` 功能对象输出升阻力系数，写明参考面积、参考长度与参考速度的取法（二维算例注意展向厚度）。
- **敏感性**：在最终网格上，至少再做两次对照——一次改计算域尺寸，一次改时间步长——说明各自对 St 和 Cd 的影响量级。

## 4. 验证与对照

- 查 3 篇以上公开文献或标准基准（例如 Re=100 圆柱绕流的经典数值与实验结果），列出各自报告的 St、Cd、Cl 及其计算条件（网格、计算域、方法）。写明文献出处（DOI 或链接）与查阅日期。
- 把本次结果与文献值放在同一张表里对照，给出相对偏差。
- 差异超出文献之间的离散范围时，分析原因并说明。不要为了贴近文献值反过来调参数；参数先定、再算、再比。

## 5. 出图要求

全部用无界面方式生成，300 dpi PNG，另存矢量版：

1. 网格图：整体计算域与圆柱近壁局部放大。
2. 升力与阻力系数随时间的曲线，标出用于统计的稳定段。
3. 升力系数的频谱（FFT），标出主频与对应的 St。
4. 瞬时涡量云图（至少一个相位），能看清卡门涡街。
5. 网格收敛图：St 与 Cd 随网格量的变化。
6. **涡量动画**：一个周期以上的涡量演化，输出 mp4 或 gif。这是本任务的重点素材，优先保证它能生成；若渲染遇到困难，记录尝试过程与报错，再考虑退而求其次的方案（例如输出图片序列）。

## 6. 交付物

全部放在工作区的 `openfoam_cylinder/` 目录下：

| 文件或目录 | 内容 |
| --- | --- |
| `report.pdf` | 中文研究报告：背景、计算设置、网格与收敛性、结果、敏感性分析、与文献对照、误差来源与局限。正文每个数字都能在表格或日志中找到出处 |
| `figures/` | 上述图表，300 dpi PNG 并附矢量版；涡量动画单独放 `figures/animation/` |
| `tables/` | 每套网格的网格量、St、Cd、Cl 及统计区间；敏感性结果；文献对照表。csv 与 xlsx |
| `case/` | 完整的 OpenFOAM 算例目录（`0/`、`constant/`、`system/`），每套网格一份或用脚本参数化生成 |
| `code/` | 网格生成、批量运行、力系数后处理、频谱分析、出图与动画脚本，以及一键复现入口 |
| `methods_notes.md` | 中文操作说明，写给第一次用 OpenFOAM 的研究生：算例目录结构、`blockMeshDict` 怎么写圆柱网格、边界条件怎么设、求解器怎么选、时间步与库朗数怎么定、`forceCoeffs` 怎么配、怎么判断进入周期状态、怎么做 FFT 求 St、没有图形界面怎么用 ParaView 出图和动画、常见报错与解决办法 |
| `run_log.md` | 运行记录：每一步做了什么、用时、报错原文与解决办法、每个决策的理由；OpenFOAM 与 ParaView 版本、CPU 核数、每套网格的墙钟时间与峰值内存 |
| `comparison.md` | 与已发表结果的对照表和差异解释 |
| `data_manifest.csv` | 文献来源 URL、查阅时间；若下载了外部算例或数据，记录来源与 SHA256 |

## 7. 工作方式

- 请独立完成全部步骤。遇到问题先自己查文档、尝试解决，并记录在 `run_log.md`；不要因为可以自行判断的问题停下来等待确认。只有在确实无法继续时才提问。
- 所有数字必须来自实际运行的输出，不得估计或编造。结果与文献差距大时，如实报告并分析原因。
- **本任务用云电脑的 CPU 即可完成，不需要租用 GPU。** 如果判断确有必要租用算力，先在对话里说明理由；租用后按平台指南选配置，用完立即释放，并在 `run_log.md` 写明起止时间与费用。能重新下载或重新生成的内容不必保留，本次计算产生的结果（算例、场数据、力系数时序、图与动画）要完整保留。
- 长时间计算期间不要反复汇报没有变化的进度；在同一轮里继续等待，有实质进展再说。
- 保留全部中间结果，包括没有采用的网格和失败的尝试。
- 完成后，在对话中用简短的中文总结主要结果（St、Cd、Cl 与文献对照），并列出交付物清单与路径。
