Skip to content

【Hackathon 10th Spring No.10】为PaddleMaterials新增ECFormer模型家族相关RFC文档#1214

Open
PlumBlossomMaid wants to merge 10 commits intoPaddlePaddle:masterfrom
PlumBlossomMaid:ECDFormer
Open

【Hackathon 10th Spring No.10】为PaddleMaterials新增ECFormer模型家族相关RFC文档#1214
PlumBlossomMaid wants to merge 10 commits intoPaddlePaddle:masterfrom
PlumBlossomMaid:ECDFormer

Conversation

@PlumBlossomMaid
Copy link
Copy Markdown
Contributor

@PlumBlossomMaid PlumBlossomMaid commented Feb 13, 2026

为PaddleMaterials新增ECFormer模型家族相关RFC文档

📌 概述

本PR为PaddleMaterials项目新增ECFormer模型家族(原ECDFormer,Nature Computational Science 2025)的完整RFC设计文档。ECFormer是一个用于谱图预测的Transformer-GNN混合架构,支持ECD(电子圆二色谱)和IR(红外光谱)预测任务。

📚 新增文档列表

1. 项目总览

2. 模型层设计

  • [rfcs/PaddleMaterials/【Hackathon 10th Spring No.10】ECDFormer模型复现/Models/ECFormers.md](rfcs/PaddleMaterials/【Hackathon 10th Spring No.10】ECDFormer模型复现/Models/ECFormers.md):ECFormerBase基类、ECFormerECDECFormerIR的高层API设计
  • [rfcs/PaddleMaterials/【Hackathon 10th Spring No.10】ECDFormer模型复现/Models/Layers.md](rfcs/PaddleMaterials/【Hackathon 10th Spring No.10】ECDFormer模型复现/Models/Layers.md):底层组件(GINConv、AtomEncoder等)的设计说明

3. 数据集设计

  • [rfcs/PaddleMaterials/【Hackathon 10th Spring No.10】ECDFormer模型复现/Dataset/README.md](rfcs/PaddleMaterials/【Hackathon 10th Spring No.10】ECDFormer模型复现/Dataset/README.md):数据集模块“模块自治”设计哲学总览
  • [rfcs/PaddleMaterials/【Hackathon 10th Spring No.10】ECDFormer模型复现/Dataset/ECDFormerDataset.md](rfcs/PaddleMaterials/【Hackathon 10th Spring No.10】ECDFormer模型复现/Dataset/ECDFormerDataset.md):ECDFormerDataset(ECD光谱)详细设计
  • [rfcs/PaddleMaterials/【Hackathon 10th Spring No.10】ECDFormer模型复现/Dataset/IRDataset.md](rfcs/PaddleMaterials/【Hackathon 10th Spring No.10】ECDFormer模型复现/Dataset/IRDataset.md):IRDataset(IR光谱)详细设计

4. 训练流程设计

  • [rfcs/PaddleMaterials/【Hackathon 10th Spring No.10】ECDFormer模型复现/Train/README.md](rfcs/PaddleMaterials/【Hackathon 10th Spring No.10】ECDFormer模型复现/Train/README.md):独立训练脚本设计说明

🎯 设计核心亮点

模块 设计哲学 核心创新
模型层 基类继承 + 子类特化 模板方法模式固化流程,代码复用率提升70%
数据集 模块自治 + 类级别缓存 按需读取优化,二次加载提速36000倍
训练 独立目录 + 隔离运行 与DiffNMR解耦,自由演进

🔗 相关链接

✅ 自测情况

  • 所有文档格式正确,Markdown渲染正常
  • 内部链接跳转有效
  • 符合RFC模板规范

山海寻梦,不觉其远;前路迢迢,阔步而行。期待与社区共建PaddleMaterials!

@paddle-bot
Copy link
Copy Markdown

paddle-bot bot commented Feb 13, 2026

你的PR提交成功,感谢你对开源项目的贡献!
请检查PR提交格式和内容是否完备,具体请参考示例模版
Your PR has been submitted. Thanks for your contribution!
Please check its format and content. For this, you can refer to Template and Demo.

Revise font of conclusion section in README.md
Removed the development mode section from the README.
Remove duplicate references and update list
Fix references
Removed redundant sentence about the project's design philosophy and clarified the innovative space provided by the current implementation.
原计划自定义实现Transformer,后来发现paddle框架原生Transformer是可以实现在float64下的精度对齐的,于是改用为paddle原生Transformer。同时优化了一下文档
由于底层已经更换为paddle框架原生实现的Transformer,所以移除Transformer的自定义实现。
@PlumBlossomMaid
Copy link
Copy Markdown
Contributor Author

我已根据本RFC的设计思路,初步提交了核心代码实现PR 245。在实际开发过程中,发现部分设计细节与官方期望的代码风格和框架集成方式存在出入,目前最新的具体开发进度和待办清单已在PR 245的描述中详细说明。

为确保沟通效率,如果对本RFC中某部分的设计有改进建议,或发现实现与设计有偏差,恳请直接在对应的代码仓库PR 245中进行反馈和讨论。本RFC文档将在所有代码实现稳定、并通过评审后,进行一次系统性的最终修订和总结,以使其与最终合入的代码完全一致。

Copy link
Copy Markdown

@leeleolay leeleolay left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Image辛苦评估下是否可以使用套件内已有功能,有些工具类的可以放在utils里

@PlumBlossomMaid
Copy link
Copy Markdown
Contributor Author

PlumBlossomMaid commented Mar 30, 2026

Image辛苦评估下是否可以使用套件内已有功能,有些工具类的可以放在utils里

由于我本人最近学业稍微紧张了一些,所以并没有太多时间使RFC与代码保持同步。目前代码仍旧处于高频修改阶段,而RFC只和最最最原始的代码是对齐的,所以恳请去看代码PR中的结构~~ @leeleolay

目前reviewer指出的这个目录已经被我重构并放入ppmat的utils目录下了。个别套件内已有的功能已经进行了复用,其余的特有的工具均已按照要求放入utils目录中。

等代码结构稳定了,我会对此RFC进行及时的更新。(* ̄︶ ̄)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants