Add model card and pipeline tag
#5
by nielsr HF Staff - opened
README.md
ADDED
|
@@ -0,0 +1,80 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
pipeline_tag: other
|
| 3 |
+
---
|
| 4 |
+
|
| 5 |
+
# DyneTrion: Spatiotemporally Coherent Generative Emulation of Protein Dynamics Across Timescales
|
| 6 |
+
|
| 7 |
+
This repository contains the pretrained weights for **DyneTrion**, a generative protein dynamics emulator that jointly enforces geometric symmetry, structural consistency, and temporal coherence within a single framework.
|
| 8 |
+
|
| 9 |
+
- **Paper:** [DyneTrion: A Spatio-temporally Coherent Generative Emulator for Protein Dynamics Across Timescales](https://huggingface.co/papers/2607.15309)
|
| 10 |
+
- **GitHub Repository:** [fudan-generative-vision/DyneTrion](https://github.com/fudan-generative-vision/DyneTrion)
|
| 11 |
+
|
| 12 |
+
<table class="center">
|
| 13 |
+
<tr>
|
| 14 |
+
<td style="text-align: center"><b>1ail_A</b></td>
|
| 15 |
+
<td style="text-align: center"><b>1ifg_A</b></td>
|
| 16 |
+
<td style="text-align: center"><b>2kxl_A</b></td>
|
| 17 |
+
<td style="text-align: center"><b>2rcs_H</b></td>
|
| 18 |
+
</tr>
|
| 19 |
+
<tr>
|
| 20 |
+
<td style="text-align: center">
|
| 21 |
+
<img src="https://raw.githubusercontent.com/fudan-generative-vision/DyneTrion/main/assets/1ail_A.gif" width="100%">
|
| 22 |
+
</td>
|
| 23 |
+
<td style="text-align: center">
|
| 24 |
+
<img src="https://raw.githubusercontent.com/fudan-generative-vision/DyneTrion/main/assets/1ifg_A.gif" width="100%">
|
| 25 |
+
</td>
|
| 26 |
+
<td style="text-align: center">
|
| 27 |
+
<img src="https://raw.githubusercontent.com/fudan-generative-vision/DyneTrion/main/assets/2kxl_A.gif" width="100%">
|
| 28 |
+
</td>
|
| 29 |
+
<td style="text-align: center">
|
| 30 |
+
<img src="https://raw.githubusercontent.com/fudan-generative-vision/DyneTrion/main/assets/2rcs_H.gif" width="100%">
|
| 31 |
+
</td>
|
| 32 |
+
</tr>
|
| 33 |
+
</table>
|
| 34 |
+
|
| 35 |
+
## Installation
|
| 36 |
+
|
| 37 |
+
```bash
|
| 38 |
+
# Create virtual environment (Python 3.10.12 is recommended)
|
| 39 |
+
python -m venv .venv
|
| 40 |
+
source .venv/bin/activate
|
| 41 |
+
|
| 42 |
+
# Install PyTorch (CUDA 12.4)
|
| 43 |
+
pip install torch==2.4.0 --index-url https://download.pytorch.org/whl/cu124
|
| 44 |
+
|
| 45 |
+
# Install other dependencies
|
| 46 |
+
pip install -r requirements.txt
|
| 47 |
+
```
|
| 48 |
+
|
| 49 |
+
## Inference
|
| 50 |
+
|
| 51 |
+
Run inference using:
|
| 52 |
+
|
| 53 |
+
```bash
|
| 54 |
+
bash inference.sh
|
| 55 |
+
```
|
| 56 |
+
|
| 57 |
+
- Model checkpoint: `step_400000.pth`
|
| 58 |
+
- Input CSV: `datasets/inference/inference_data.csv`
|
| 59 |
+
- Frame number: `n_frame = 16`
|
| 60 |
+
- Motion number: `n_motion = 2`
|
| 61 |
+
- Frame sampling step: `sample_step = 40`
|
| 62 |
+
- Extrapolation time: `extrapolation_time = 16`
|
| 63 |
+
- Noise scale: `noise_scale = 1.0`
|
| 64 |
+
|
| 65 |
+
Inference results will be saved to `save_root` (default: `./test/inference/`).
|
| 66 |
+
|
| 67 |
+
For more details, please check the [GitHub Repository](https://github.com/fudan-generative-vision/DyneTrion).
|
| 68 |
+
|
| 69 |
+
## Citation
|
| 70 |
+
|
| 71 |
+
If you find DyneTrion useful for your research, please cite the paper:
|
| 72 |
+
|
| 73 |
+
```bibtex
|
| 74 |
+
@article{cheng2025dynetrion,
|
| 75 |
+
title={DyneTrion: A Spatio-temporally Coherent Generative Emulator for Protein Dynamics Across Timescales},
|
| 76 |
+
author={Cheng, Kaihui and Cai, Zhiqiang and Tu, Peng and Yao, Yisong and Han, Limei and Wu, Libo and Zhu, Siyu and Yang, Tzuhsiung and Qi, Yuan},
|
| 77 |
+
journal={arXiv preprint arXiv:2607.15309},
|
| 78 |
+
year={2026}
|
| 79 |
+
}
|
| 80 |
+
```
|