From 6e65152a655ef37d482dd9d4fbd5f6bf0a6a3e32 Mon Sep 17 00:00:00 2001
From: GAO_HYP_XYJ <1901110358@pku.edu.cn>
Date: Tue, 23 Mar 2021 18:50:41 +0800
Subject: [PATCH] update model_zoo/research/hpc/sponge/README.md.

---
 model_zoo/research/hpc/sponge/README.md | 108 +++++++++++++++++++++++-
 1 file changed, 107 insertions(+), 1 deletion(-)

diff --git a/model_zoo/research/hpc/sponge/README.md b/model_zoo/research/hpc/sponge/README.md
index 31a9fe20c3..67893ed2dc 100644
--- a/model_zoo/research/hpc/sponge/README.md
+++ b/model_zoo/research/hpc/sponge/README.md
@@ -1 +1,107 @@
-# Contents
\ No newline at end of file
+# SPONGE Example
+
+- [Description](#Description)
+- [Dataset](#Dataset)
+- [Environment Requirements](#Environment-Requirements)
+- [Quick Start](#Quick-Start)
+- [Script Description](#Script-Description)
+    - [Script and Sample Code](#Script-and-Sample-Code)
+    - [Training Process](#Training-Process)
+- [Model Description](#Model-Description)
+    - [Evaluation Performance](#Evaluation-Performance)
+- [Result](#Result)
+- [ModelZoo Homepage](#ModelZoo-Homepage)
+
+## Description
+
+SPONGE in MindSpore is a high-performance and modularized molecular dynamics simulation library developed by `Yiqin Gao` group (`Peking University` and `Shenzhen Bay Laboratory`) and `MindSpore` team at `Huawei` Company. It can efficiently simulate traditional molecular dynamics tasks based on the “graph-kernel-fusion” and “automatic parallelization” features of MindSpore. In the meanwhile, it utilizes the automatic differentiation feature of MindSpore, and introduces machine learning methods, such as neural network, into traditional molecular simulation, achieving methodological inventions.
+
+This example demonstrates how to perform high-performance molecular dynamics simulations with the built-in SPONGE module of MindSpore on GPU.
+
+## Dataset
+
+There are three inputs for the example, property file`NVT_290_10ns.in`, topology file `ala.parm7` and coordinates file `ala_NVT_290_10ns.out`, respectivelly.
+
+![ALA Aqueous System](https://images.gitee.com/uploads/images/2021/0323/184453_4bd9b1a6_8142020.png "图片1.png")
+
+Topology file and coordinates file can be generated by `tleap` in `AmberTools` ([link](<http://ambermd.org/GetAmber.php>)). For more details, please refer to:
+
+- [SPONGE Tutorial](https://gitee.com/mindspore/docs/blob/master/tutorials/training/source_zh_cn/advanced_use/hpc_sponge.md)
+
+## Environment Requirements
+
+- Hardware: GPU
+    - Prepare hardware environment with GPU processor.
+- Framework
+    - [MindSpore](https://www.mindspore.cn/install/en)
+- For more information, please check the resources below:
+    - [MindSpore Tutorials](https://www.mindspore.cn/tutorial/training/en/master/index.html)
+    - [MindSpore Python API](https://www.mindspore.cn/doc/api_python/en/master/index.html)
+
+## Quick Start
+
+After installing MindSpore via the official website, you can start running as follows:
+
+```shell
+python main.py --i NVT_290_10ns.in --amber_parm ala.parm7 --c ala_350_cool_290.rst7 --o ala_NVT_290_10ns.out
+```
+
+## Script Description
+
+### Script and Sample Code
+
+```shell
+├── sponge
+    ├── README.md
+    ├── main.py                                  # launch Simulation for SPONGE
+    ├── src
+        ├── bond.py                              # bond module in SPONGE
+        ├── angle.py                             # angle module in SPONGE
+        ├── dihedral.py                          # dihedral module in SPONGE
+        ├── nb14.py                              # nb14 module in SPONGE
+        ├── Langevin_Liujian_md.py               # Langevin_Liujian_md module in SPONGE
+        ├── lennard_jones.py                     # lennard_jones module in SPONGE
+        ├── md_information.py                    # save md information module in SPONGE
+        ├── neighbor_list.py                     # neighbor_list module in SPONGE
+        ├── particle_mesh_ewald.py               # particle_mesh_ewald module in SPONGE
+        ├── simulation_initial.py                # SPONGE simulation
+```
+
+### Training Process
+
+```shell
+python main.py --i NVT_290_10ns.in --amber_parm ala.parm7 --c ala_350_cool_290.rst7 --o ala_NVT_290_10ns.out
+```
+
+Training result will be stored in the specified file, which ends with ".out".
+
+## Result
+
+After training，the results in `ala_NVT_290_10ns.out` are：
+
+```text
+_steps_ _TEMP_ _TOT_POT_ENE_ _BOND_ENE_ _ANGLE_ENE_ _DIHEDRAL_ENE_ _14LJ_ENE_ _14CF_ENE_ _LJ_ENE_ _CF_PME_ENE_
+      1 293.105   -6117.709   1204.406       7.096          4.491      3.456     44.018 1372.488    -8753.664
+   ...
+```
+
+There are sorts of energy in the output, steps (_steps_), temperature (_TEMP_), total energy (_TOT_POT_E_), bond energy (_BOND_ENE_), angle energy (_ANGLE_ENE_), dihedral energy (_DIHEDRAL_ENE_), non bond enrgy, includes Coulomb force (_14CF_ENE_) and Leonard-Jones energy (_14LJ_ENE_), Van der Waals energy (_LJ_ENE_) and Coulomb force in PME (_CF_PME_ENE_).
+
+## Model Description
+
+### Evaluation Performance
+
+| Parameters                 |   GPU |
+| -------------------------- |---------------------------------- |
+| Resource                   | GPU(Tesla V100 SXM2), Memory 16G
+| uploaded Date              |
+| MindSpore Version          | 1.2
+| Training Parameters        | step=1
+| Outputs                    | numpy file
+| Speed                      | 0.47 s/step
+| Total time                 | 4.57 s
+| Scripts                    | [Link](https://gitee.com/mindspore/mindspore/tree/master/model_zoo/research/hpc/sponge)
+
+## ModelZoo HomePage
+
+ Please check the official [homepage](https://gitee.com/mindspore/mindspore/tree/master/model_zoo).