Add model card and pipeline tag

#5
by nielsr HF Staff - opened
Files changed (1) hide show
  1. README.md +80 -0
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
+ ```