# aeos_qcd

**Repository Path**: ppcfans/aeos_qcd

## Basic Information

- **Project Name**: aeos_qcd
- **Description**: AEOS-QCD: An OS-like, AI-assisted Lattice QCD platform developed by Xie Baoyu.
特此感谢从事有限温度格点QCD 研究的叶凯帆博士对本项目的贡献。
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-26
- **Last Updated**: 2026-01-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: lattice-qcd, scientific-computing, AI-for-Science, Python, HPC

## README

Author: Xie Baoyu (谢宝玉) | Academic Use Only
AEOS-QCD v11.0 本项目为学术演示原型，用于展示新型科研计算范式，非生产级工具

OS-like Trustworthy Lattice QCD Research Platform | 类操作系统的可信赖格点QCD研究平台学术演示版 (Academic Demo)

---

 📋 一句话摘要

English: AEOS-QCD is an OS-like, AI-assisted Lattice QCD platform for automated and trustworthy scientific discovery.

中文: AEOS-QCD 是一个类操作系统的可信赖格点QCD研究平台，致力于加速科学发现，提供自动化工作流管理和实时物理感知洞察。

---

 🚀 核心亮点

🔧 OS-like Architecture | 类操作系统架构
- Workflow as Process Management | 工作流即进程管理
- Resource Scheduling & Allocation | 资源调度与分配
- Plug-in Module System | 插件式模块系统
- Configuration Management | 配置管理

🔬 Physics-Aware Computing | 物理感知计算
- Real-time Phase Analysis | 实时相结构分析
- Automated Interpretation | 自动物理解释
- Error Propagation Tracking | 误差传播追踪
- Theoretical Comparison | 理论值比较

🏭 Production-Ready Infrastructure | 生产就绪基础生产级架构设计
- Comprehensive Error Analysis | 完整误差分析
- Configuration Persistence | 配置持久化
- Automated Report Generation | 自动报告生成
- Data Version Control | 数据版本控制

⚡ Rapid Prototyping Framework | 快速原型框架
- AI-assisted Optimization | 支持AI扩展的框架
- Parallel Computing | 并行计算
- Algorithm Benchmarking | 算法基准测试
- Modern Development Paradigms | 现代开发范式

---
 🎯 版本定位
AEOS-QCD v11.0 是 AEOS 思想在格点量子色动力学中的概念验证演示版。本版本主要目标是验证"类操作系统"架构在科学计算领域的可行性，为后续开发奠定核心框架基础。





 🎯 快速开始

安装依赖
```bash
基础依赖
pip install numpy scipy matplotlib

增强功能（推荐）
pip install tqdm colorama psutil
```

运行演示
```bash
快速演示模式 (2-3分钟)
python AEOS-QCD+v11.0_DEMO.py --fast

标准演示模式 (5-8分钟)
python AEOS-QCD+v11.0_DEMO.py

生产模式 (10-15分钟)
python AEOS-QCD+v11.0_DEMO.py --lattice 8 --threads 4
```

命令行参数
```bash
--lattice N      格点尺寸 (4,6,8,12,16)
--beta VALUE     逆耦合常数 (5.7-6.4)
--threads N      并行线程数
--thermal N      热化步数
--configs N      配置数量
--fast           快速演示模式
--benchmark      性能测试模式
--help           显示帮助信息
```

---

 📊 物理研究案例

案例1: 相变研究
```bash
扫描β值，研究禁闭-去禁闭相变
for beta in 5.9 6.0 6.1 6.2
do
    python AEOS-QCD+v11.0_DEMO.py --beta $beta --configs 15
done
```

案例2: 有限体积效应
```bash
研究不同格点尺寸的影响
for lattice in 4 6 8 12
do
    python AEOS-QCD+v11.0_DEMO.py --lattice $lattice
done
```

案例3: 算法比较
```bash
比较不同更新算法的效率
python AEOS-QCD+v11.0_DEMO.py --algorithm heatbath
python AEOS-QCD+v11.0_DEMO.py --algorithm overrelaxation
```

---

 🗂️ 输出文件结构

```
aeos_qcd_results_20240101_120000/
├── 📄 aeos_config.json          完整模拟配置
├── 📊 aeos_results.json         物理结果和误差分析
├── 📈 aeos_raw_data.json        原始测量数据
├── 🔥 aeos_thermalization.json  热化过程数据
├── 📘 AEOS_ACADEMIC_REPORT.md   学术研究报告
├── 🎨 aeos_performance.log      性能监控日志
└── 📁 plots/                    可视化图表
    ├── thermalization.png       热化过程图
    ├── observable_history.png   观测量历史
    ├── error_analysis.png       误差分析图
    └── phase_diagram.png        相结构图
```

---

 🔬 物理可观测量

Plaquette (P)
- 物理意义: 规范场涨落强度
- 范围: 0.01-0.65 (取决于β值)
- 计算公式: ⟨P⟩ = (1/Nₚ) Σ Tr(Uᵨ)/3

Polyakov Loop (L)
- 物理意义: QCD相变序参量
- 禁闭相: ⟨|L|⟩ ≈ 0
- 去禁闭相: ⟨|L|⟩ > 0

β值物理解释
- β=6.0: 去禁闭相 (高温)
- β=6.2: 禁闭相 (低温)
- β=5.9-6.4: 相变区域

---

 ⚡ 性能特征

硬件要求
| 配置 | CPU核心 | 内存 | 格点尺寸 | 预计时间 |
|------|---------|------|----------|----------|
| 最低 | 2核心 | 4GB | 4^4 | 3-5分钟 |
| 推荐 | 4核心 | 8GB | 6^4 | 5-8分钟 |
| 高性能 | 8核心 | 16GB | 8^4 | 10-15分钟 |
| 研究级 | 16核心 | 32GB | 12^4 | 20-30分钟 |

并行加速
```
线程数   加速比   效率
1        1.0x     100%
2        1.8x     90%
4        3.2x     80%
8        5.6x     70%
16       9.6x     60%
```

---

 🛠️ 技术架构

```
AEOS-QCD v11.0
├── 核心层 (Kernel)
│   ├── SU(3)代数运算
│   ├── 格点规范场
│   └── 更新算法引擎
├── 管理层 (Management)
│   ├── 工作流调度
│   ├── 资源配置
│   └── 错误处理
├── 分析层 (Analysis)
│   ├── 误差分析
│   ├── 统计分析
│   └── 物理解释
└── 接口层 (Interface)
    ├── 命令行接口
    ├── 配置文件
    └── 报告生成
```

---

 📚 学术使用

引用格式
```bibtex
@software{aeos_qcd_2026,
  author = {[谢宝玉]},
  title = {AEOS-QCD v11.0: An OS-like Trustworthy Lattice QCD Research Platform},
  year = {2026},
  url = {https://gitee.com/ppcfans/aeos_qcd},
  note = {Academic Use Only}
}
```

研究领域
- QCD相变研究
- 禁闭-去禁闭转变
- 有限温度QCD
- 格点算法开发
- 高性能计算应用

---

 🔍 质量保证

验证测试
- ✅ SU(3)矩阵性质验证
- ✅ 统计收敛性检查
- ✅ 误差传播分析
- ✅ 理论值比较
- ✅ 数值稳定性测试

性能监控
- 实时接受率监控
- 内存使用追踪
- CPU利用率优化
- I/O性能分析

---

 🆘 故障排除

常见问题
1. 内存不足: 减小格点尺寸 (`--lattice 4`)
2. 运行缓慢: 使用快速模式 (`--fast`)
3. 依赖缺失: `pip install numpy scipy matplotlib`
4. 结果异常: 检查β值设置，增加热化步数

调试模式
```bash
详细日志输出
python AEOS-QCD+v11.0_DEMO.py --debug

性能分析
python -m cProfile AEOS-QCD+v11.0_DEMO.py --fast
```

---

 🤝 贡献与支持

开发贡献
1. Fork项目仓库
2. 创建功能分支 (`git checkout -b feature/new-feature`)
3. 提交更改 (`git commit -m 'Add new feature'`)
4. 推送到分支 (`git push origin feature/new-feature`)
5. 创建Pull Request

问题反馈
- GitHub Issues: https://gitee.com/ppcfans/aeos_qcd
- 学术讨论: 通过GitHub Discussions
- 紧急联系: 提交Issue并标记为"urgent"

社区资源
- 📖 文档: https://gitee.com/ppcfans/aeos_qcd
- 💬 论坛: https://gitee.com/ppcfans/aeos_qcd
- 🎓 教程: `examples/` 目录

---

 📄 许可证信息
本项目采用 MIT 许可证。  
- 英文原文（法律有效）：[LICENSE](LICENSE)  
- 中文说明（便于理解）：[LICENSE.zh-CN.md](LICENSE.zh-CN.md)

- Purpose: 用于验证 AEOS 思想在格点QCD中的可行性
- Note: 仅用于学术交流，未经许可不得转载或用于商业用途。
```

使用条款
1. 学术使用: 允许用于教育、研究和学术交流
2. 非商业用途: 禁止任何形式的商业使用
3. 引用要求: 使用成果必须引用本软件
4. 修改限制: 修改版本必须保留版权声明

---

 🌟 版本历史

| 版本 | 日期 | 主要特性 |
|------|------|----------|
| v1.0 | 2024 | 基础格点QCD模拟 |
| v5.0 | 2025 | 并行计算支持 |
| v10.0 | 2025 | 生产级优化 |
| v11.0 | 2026 | OS-like架构，物理感知计算 |

---

 📞 联系信息

项目维护: [谢宝玉]  
学术咨询: 通过GitHub Issues  
合作邀请: 提交Research Proposal  
技术支持: 社区驱动支持  

---

 🎉 开始探索

```bash
开启你的格点QCD研究之旅
python AEOS-QCD+v11.0_DEMO.py

查看实时物理分析
监控并行计算性能
生成学术研究报告
```

探索强相互作用的奥秘，加速科学发现进程！

---

*最后更新: 2026年1月*  
*版本: AEOS-QCD v11.0*  
*© 2026 [谢宝玉]. 学术使用许可.*