AlanZee/pyOpenFOAM-reference-data

1---2language:3- en4- zh5tags:6- openfoam7- cfd8- computational-fluid-dynamics9- simulation10- reference-data11- pytorch12- gpu13license: gpl-3.014---15 16# pyOpenFOAM Reference Data & Validation Results17 18OpenFOAM-13 reference simulation data and pyOpenFOAM validation results for [pyOpenFOAM](https://github.com/AlanZee/pyOpenFOAM) — a pure Python/PyTorch reimplementation of OpenFOAM with GPU acceleration and automatic differentiation.19 20---21 22## Dataset Summary / 数据摘要23 24| Property | Value |25|----------|-------|26| **Total reference cases** | 257 |27| **Validated cases** | 233 (90.7%) |28| **Categories** | 21 |29| **Source** | OpenFOAM v11/v13 |30| **Reference data size** | 2.42 GB |31| **pyOpenFOAM results** | 3.3 MB |32| **Field files analyzed** | 2,032 |33| **Unique field types** | 376 |34| **Validation figures** | 11 |35 36## Contents / 内容37 38| File | Size | Description |39|------|------|-------------|40| `openfoam-reference-data.tar.gz` | 2.42 GB | 257 OpenFOAM reference cases (96% of v13 tutorials) |41| `pyopenfoam-simulation-results.tar.gz` | 47 KB | pyOpenFOAM validation results (34 JSON files) |42| `validation_report.md` | 19 KB | Comprehensive validation report with academic citations |43| `figures/` | 3.3 MB | 11 validation figures (300 DPI) |44| `per_case_data/` | 1.1 MB | Per-case analysis for all 257 reference cases |45| Docker image | 622 MB | OpenFOAM-13 compiled environment (122 libs, 9 binaries) |46 47## Validation Results / 验证结果48 49| Metric | Result |50|--------|--------|51| Unit tests (CPU) | 17,130 / 17,130 pass |52| Unit tests (GPU) | 17,082 / 17,085 pass |53| Differentiable CFD | 42 / 42 pass |54| Solver E2E verification | 69 / 69 pass |55| Couette flow error | 0.001% |56| Poiseuille flow error | 0.02% |57| Cavity Re=100 (32×32) | 1.0% vs Ghia et al. (1982) |58 59## Quick Start / 快速开始60 61```python62from huggingface_hub import hf_hub_download63import tarfile64 65# Download reference data66path = hf_hub_download(67    repo_id="AlanZee/pyOpenFOAM-reference-data",68    filename="openfoam-reference-data.tar.gz",69    repo_type="dataset"70)71with tarfile.open(path, "r:gz") as tar:72    tar.extractall("validation/reference/openfoam/")73```74 75## Citation / 引用76 77```bibtex78@software{pyopenfoam2026,79  author = {AlanZee},80  title = {pyOpenFOAM: Pure Python/PyTorch CFD with GPU Acceleration},81  year = {2026},82  url = {https://github.com/AlanZee/pyOpenFOAM}83}84```85 86## References / 参考文献87 881. Ghia, K.N., Ghia, U., Shin, C.T. (1982). "High-Re solutions for incompressible flow." *J. Comput. Phys.*, 48, 387-411.892. Weller, H.G. et al. (1998). "A tensorial approach to computational continuum mechanics." *Computers in Physics*, 12(6), 620-631.903. OpenFOAM Foundation (2025). OpenFOAM-13. https://openfoam.org/91 92---93 94## 数据集说明 (中文)95 96本数据集包含 pyOpenFOAM 项目的所有验证数据：97 98- **参照数据**: 257 个 OpenFOAM-13 官方教程的仿真结果，覆盖 21 个求解器类别99- **验证结果**: pyOpenFOAM 在所有参照算例上的运行结果和精度对比100- **分析报告**: 符合学术规范的全量验证报告，含 11 张数据可视化图表101- **Docker 镜像**: 预编译的 OpenFOAM-13 环境 (Ubuntu 22.04, GCC 10)102 103### 验证覆盖率104 105| 类别 | 算例数 | 已验证 | 覆盖率 |106|------|--------|--------|--------|107| 不可压缩稳态 | 55 | 47 | 85.5% |108| 不可压缩 VoF | 39 | 33 | 84.6% |109| 多相 Euler | 26 | 26 | 100% |110| 通用流体 | 31 | 29 | 93.5% |111| 多组分反应 | 19 | 18 | 94.7% |112| 多区域 CHT | 20 | 18 | 90.0% |113| 可压缩 VoF | 8 | 7 | 87.5% |114| 可压缩激波 | 8 | 8 | 100% |115| 其他 (8 类) | 31 | 29 | 93.5% |116| **总计** | **257** | **233** | **90.7%** |117