欢迎来到REST开发团队！

REST（Rust-based Electronic Structure Toolkit）是基于革命性Rust语言构建的新一代电子结构计算平台。REST平台致力于推动量子力学和材料科学的前沿计算研究，适用于从催化研究（如Cu团簇CO吸附）到先进电子结构建模等多种应用场景，确保数值稳定性、精确性和并行计算效率。我们以极致性能为基石，以无限扩展为羽翼，为您提供从基础计算到前沿研究的全栈解决方案。

	🌟 诚邀您体验REST的强大能力！每一个[Star]都是对我们创新的认可，每一条反馈都是推动科学计算变革的动力。让我们携手，共同绘制电子结构计算的未来图景！

REST核心特性

• 高性能基组运算：支持高效的RI近似方法，可在保持精度的同时，高效实现四中心项积分计算
• 主流密度泛函方法：包含LDA、(meta)-GGA和杂化泛函等主流密度泛函近似，支持Grimme经验色散校正，支持基于解析力的构型优化功能
• 第五阶高精度DFT方法：提供XYG3/XGYJOS/xDH-PBE0/ZRPS等双杂化泛函、随机相位近似(RPA)与自旋对分离的RPA方法（scs-RPA)，支持基于数值力的构型优化功能
• 机器学习融合：集成DL-xDH23和R-xDH7-SCC等机器学习增强型双杂化泛函，提升计算效率与精度，支持基于数值力的构型优化功能
• 激发态性质计算方法：匹配所有密度泛函方法的$\Delta$SCF通用策略、基于格林函数的GW和BSE方法等
• PyREST交互工作流：为开发者和终端用户提供兼具直观性与实用性的交互界面

可用程序模块

• rest：执行电子结构计算的主程序
• rest_docker：用于构建Docker镜像和容器化环境的工具
• rest_regression：功能验证与基准测试套件
• rest_tensors：高效张量运算数学库
• rest_libcint：C语言libcint库的Rust封装接口
• rstsr：原生Rust实现的科学计算张量工具库（类似Python的Numpy）

安装指南

• 推荐通过Docker镜像安装以获得最佳可移植性（详见rest_docker说明）
• 在超算服务器上，一般不会允许用户日常使用docker命令，推荐使用singularity（详见rest_docker说明）
• 本地环境编译需预先安装必要的编译工具链及相关库（详见rest_workspace说明或Dockerfile安装步骤）

使用指南

• 使用Dokcer镜像安装生成的镜像，比如rest:v1.0，则可以通过docker调用该镜像进行REST计算：
  • docker run --rm -v $(pwd):/data -w /data rest:v1.0 /bin/bash -c "rest"
• 由于docker的使用存在系统风险，在超算服务器上，一般不会允许用户日常使用docker命令，推荐使用singularity。假设已经存在singularity的容器镜像为rest_v1.0.sif，则可以通过如下命令进行REST计算：
  • singularity exec --bind $(pwd):/data rest_v1.0.sif bash -c "rest"
• 为方便用户使用，我们提供了可用于生成REST程序输入卡的系统提示词（详见rest说明）。
• 用户可在任意LLM网页界面（比如DeepSeek，Tongyi)上传提示词文件（rest/README.md)，通过询问大语言模型获得REST程序的关键词使用说明，甚至直接获得输入卡。
  1. 以XYGJ-OS方法计算CuO分子的能量为例：
     
  2. 可以咨询提示词相关问题：
     

开发者贡献

REST程序由复旦大学化学理论研究中心开发，在徐昕教授(@xxchem)的领导下，由张颖教授（@igor1982）担任首席开发者完成。

核心组织团队

贡献者

• 大致按参与项目的时间顺序、持续更新中
• 我们衷心感谢所有为REST项目付出过努力的贡献者，并热切期望有更多的人加入我们的项目。
• 如果您发现贡献未被正确记录，请通过 issues 或联系 igor_zhangying@fudan.edu.cn 告知我们，我们将在第一时间补充更正。