Add repository documentation
Browse files
README.md
ADDED
|
@@ -0,0 +1,64 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# NucleusDiff
|
| 2 |
+
|
| 3 |
+
Official model and data artifacts for **NucleusDiff: Manifold-Constrained Nucleus-Level Denoising Diffusion Model for Structure-Based Drug Design**.
|
| 4 |
+
|
| 5 |
+
- [Source code](https://github.com/yanliang3612/NucleusDiff)
|
| 6 |
+
- [Project page](https://yanliang3612.github.io/NucleusDiff/)
|
| 7 |
+
- [PNAS paper](https://www.pnas.org/doi/10.1073/pnas.2415666122)
|
| 8 |
+
- [arXiv](https://arxiv.org/abs/2409.10584)
|
| 9 |
+
|
| 10 |
+
## Repository structure
|
| 11 |
+
|
| 12 |
+
### `model/`
|
| 13 |
+
|
| 14 |
+
- `nucleusdiff_pretrained_model.pt` — pretrained NucleusDiff checkpoint.
|
| 15 |
+
|
| 16 |
+
### `data/`
|
| 17 |
+
|
| 18 |
+
- `crossdocked_v1.1_rmsd1.0_pocket10_processed_w_manifold_data_version.lmdb` — preprocessed CrossDocked manifold dataset.
|
| 19 |
+
- `crossdocked_pocket10_pose_w_manifold_data_split.pt` — train/validation/test split used by NucleusDiff.
|
| 20 |
+
- `crossdocked_v1.1_rmsd1.0.tar.gz` — filtered CrossDocked data.
|
| 21 |
+
- `split_by_name.pt` — reference CrossDocked split.
|
| 22 |
+
- `test_set.zip` — protein test set used for docking evaluation.
|
| 23 |
+
- `real_world.zip` — therapeutic-target evaluation data.
|
| 24 |
+
- `affinity_info.pkl` — affinity metadata.
|
| 25 |
+
- `test_vina_crossdock_dict.pkl` — CrossDocked Vina evaluation metadata.
|
| 26 |
+
|
| 27 |
+
## Download
|
| 28 |
+
|
| 29 |
+
Download only the pretrained model:
|
| 30 |
+
|
| 31 |
+
```bash
|
| 32 |
+
hf download LiangYan3612/NucleusDiff \
|
| 33 |
+
--include "model/*" \
|
| 34 |
+
--local-dir ./NucleusDiff_artifacts
|
| 35 |
+
```
|
| 36 |
+
|
| 37 |
+
Download all data files:
|
| 38 |
+
|
| 39 |
+
```bash
|
| 40 |
+
hf download LiangYan3612/NucleusDiff \
|
| 41 |
+
--include "data/*" \
|
| 42 |
+
--local-dir ./NucleusDiff_artifacts
|
| 43 |
+
```
|
| 44 |
+
|
| 45 |
+
See the [GitHub README](https://github.com/yanliang3612/NucleusDiff#readme) for installation, training, inference, and evaluation instructions.
|
| 46 |
+
|
| 47 |
+
## License and data provenance
|
| 48 |
+
|
| 49 |
+
The NucleusDiff source code is released under the MIT License. Included data artifacts are mirrors of the files used by the project and may remain subject to the terms of their original data sources.
|
| 50 |
+
|
| 51 |
+
## Citation
|
| 52 |
+
|
| 53 |
+
```bibtex
|
| 54 |
+
@article{liu2025manifold,
|
| 55 |
+
title={Manifold-constrained nucleus-level denoising diffusion model for structure-based drug design},
|
| 56 |
+
author={Liu, Shengchao and Yan, Liang and Du, Weitao and Liu, Weiyang and Li, Zhuoxinran and Guo, Hongyu and Borgs, Christian and Chayes, Jennifer and Anandkumar, Anima},
|
| 57 |
+
journal={Proceedings of the National Academy of Sciences},
|
| 58 |
+
volume={122},
|
| 59 |
+
number={41},
|
| 60 |
+
pages={e2415666122},
|
| 61 |
+
year={2025},
|
| 62 |
+
publisher={National Academy of Sciences}
|
| 63 |
+
}
|
| 64 |
+
```
|