yury-lysogorskiy commited on
Commit
39128e1
Β·
verified Β·
1 Parent(s): 59e2ae4

model card: add UQ and Kokkos columns to model tables

Browse files
Files changed (1) hide show
  1. README.md +40 -34
README.md CHANGED
@@ -20,6 +20,12 @@ The model tables and usage notes below are adapted from the
20
 
21
  > **Use the "Full Name" column** to refer to a model in LAMMPS and ASE.
22
 
 
 
 
 
 
 
23
  ## License
24
 
25
  **All GRACE models distributed in this repository are released under the Academic Software
@@ -46,19 +52,19 @@ They offer the best balance of structural robustness (from SMAX) and high-precis
46
 
47
  #### Single-layer, local models
48
 
49
- | Model Name | Full Name | Size | ΞΊ_SRME | Description |
50
- | :---- | :---- | :---- | :---- | :---- |
51
- | GRACE-1L-SMAX-L | GRACE-1L-SMAX-large | large | 0.696 | Single-layer local (SMAX) |
52
- | **GRACE-1L-SMAX-OMAT-L** | **GRACE-1L-SMAX-OMAT-large** | **large** | 0.338 | **Single-layer local (SMAX + OMat24)** |
53
 
54
  #### Two-layer, semilocal models
55
 
56
- | Model Name | Full Name | Size | ΞΊ_SRME | Description |
57
- | :---- | :---- | :---- | :---- | :---- |
58
- | GRACE-2L-SMAX-M | GRACE-2L-SMAX-medium | medium | 0.469 | Two-layer semi-local (SMAX) |
59
- | GRACE-2L-SMAX-L | GRACE-2L-SMAX-large | large | 0.444 | Two-layer semi-local (SMAX) |
60
- | **GRACE-2L-SMAX-OMAT-M** | **GRACE-2L-SMAX-OMAT-medium** | **medium** | 0.197 | **Two-layer semi-local (SMAX + OMat24)** |
61
- | **GRACE-2L-SMAX-OMAT-L** | **GRACE-2L-SMAX-OMAT-large** | **large** | 0.191 | **Two-layer semi-local (SMAX + OMat24)** |
62
 
63
  ## OMAT models
64
 
@@ -70,23 +76,23 @@ All models listed use a fixed **6 Γ… cutoff**.
70
 
71
  #### Single-layer, local models
72
 
73
- | Model Name | Full Name | Size | ΞΊ_SRME | Description |
74
- |:---|:---|:---|:---|:---|
75
- | **GRACE-1L-OMAT** | GRACE-1L-OMAT | small | 0.398 | Single-layer local |
76
- | GRACE-1L-OMAT-M-base | GRACE-1L-OMAT-medium-base | medium | 0.380 | Single-layer local (base) |
77
- | **GRACE-1L-OMAT-M** | GRACE-1L-OMAT-medium-ft-E | medium | 0.417 | Single-layer local (finetuned on energy) |
78
- | GRACE-1L-OMAT-L-base | GRACE-1L-OMAT-large-base | large | **0.354** | Single-layer local (base) |
79
- | **GRACE-1L-OMAT-L** | GRACE-1L-OMAT-large-ft-E | large | 0.383 | Single-layer local (finetuned on energy) |
80
 
81
  #### Two-layer, semilocal models
82
 
83
- | Model Name | Full Name | Size | ΞΊ_SRME | Description |
84
- |:---|:---|:---|:---|:---|
85
- | **GRACE-2L-OMAT** | GRACE-2L-OMAT | small | 0.288 | Two-layer semi-local |
86
- | GRACE-2L-OMAT-M-base | GRACE-2L-OMAT-medium-base | medium | 0.212 | Two-layer semi-local (base) |
87
- | **GRACE-2L-OMAT-M** | GRACE-2L-OMAT-medium-ft-E | medium | 0.217 | Two-layer semi-local (finetuned on energy) |
88
- | GRACE-2L-OMAT-L-base | GRACE-2L-OMAT-large-base | large | **0.165** | Two-layer semi-local (base) |
89
- | **GRACE-2L-OMAT-L** | GRACE-2L-OMAT-large-ft-E | large | 0.186 | Two-layer semi-local (finetuned on energy) |
90
 
91
  ## OAM models
92
 
@@ -96,19 +102,19 @@ These models are first pre-trained on **OMat24** and then fine-tuned on a combin
96
 
97
  #### Single-layer, local models
98
 
99
- | Model Name | Full Name | Size | F1 | ΞΊ_SRME | Description |
100
- | :--- |:---| :--- |:---|:---| :--- |
101
- | GRACE-1L-OAM | GRACE-1L-OAM | small | 0.824 | 0.516 | Single-layer local |
102
- | GRACE-1L-OAM-M | GRACE-1L-OMAT-medium-ft-AM | medium | 0.800 | 0.411 | Single-layer local |
103
- | GRACE-1L-OAM-L | GRACE-1L-OMAT-large-ft-AM | large | 0.815 | **0.377** | Single-layer local |
104
 
105
  #### Two-layer, semilocal models
106
 
107
- | Model Name | Full Name | Size | F1 | ΞΊ_SRME | Description |
108
- | :--- |:--- | :--- |:---| :--- | :--- |
109
- | GRACE-2L-OAM | GRACE-2L-OAM | small | 0.880 | 0.294 | Two-layer semi-local |
110
- | GRACE-2L-OAM-M | GRACE-2L-OMAT-medium-ft-AM | medium | 0.881 | 0.200 | Two-layer semi-local |
111
- | GRACE-2L-OAM-L | GRACE-2L-OMAT-large-ft-AM | large | 0.889 | **0.168** | Two-layer semi-local |
112
 
113
  ---
114
 
 
20
 
21
  > **Use the "Full Name" column** to refer to a model in LAMMPS and ASE.
22
 
23
+ The **UQ** and **Kokkos** columns indicate, per model:
24
+
25
+ - **UQ** β€” the distributed SavedModel ships with an uncertainty-quantification head
26
+ (and the checkpoint includes `gmm_artifacts.npz`).
27
+ - **Kokkos** β€” the model archive bundles `kokkos.npz` for LAMMPS-Kokkos deployment.
28
+
29
  ## License
30
 
31
  **All GRACE models distributed in this repository are released under the Academic Software
 
52
 
53
  #### Single-layer, local models
54
 
55
+ | Model Name | Full Name | Size | ΞΊ_SRME | UQ | Kokkos | Description |
56
+ | :---- | :---- | :---- | :---- | :---- | :---- | :---- |
57
+ | GRACE-1L-SMAX-L | GRACE-1L-SMAX-large | large | 0.696 | β€” | β€” | Single-layer local (SMAX) |
58
+ | **GRACE-1L-SMAX-OMAT-L** | **GRACE-1L-SMAX-OMAT-large** | **large** | 0.338 | β€” | β€” | **Single-layer local (SMAX + OMat24)** |
59
 
60
  #### Two-layer, semilocal models
61
 
62
+ | Model Name | Full Name | Size | ΞΊ_SRME | UQ | Kokkos | Description |
63
+ | :---- | :---- | :---- | :---- | :---- | :---- | :---- |
64
+ | GRACE-2L-SMAX-M | GRACE-2L-SMAX-medium | medium | 0.469 | β€” | βœ“ | Two-layer semi-local (SMAX) |
65
+ | GRACE-2L-SMAX-L | GRACE-2L-SMAX-large | large | 0.444 | β€” | βœ“ | Two-layer semi-local (SMAX) |
66
+ | **GRACE-2L-SMAX-OMAT-M** | **GRACE-2L-SMAX-OMAT-medium** | **medium** | 0.197 | β€” | βœ“ | **Two-layer semi-local (SMAX + OMat24)** |
67
+ | **GRACE-2L-SMAX-OMAT-L** | **GRACE-2L-SMAX-OMAT-large** | **large** | 0.191 | β€” | βœ“ | **Two-layer semi-local (SMAX + OMat24)** |
68
 
69
  ## OMAT models
70
 
 
76
 
77
  #### Single-layer, local models
78
 
79
+ | Model Name | Full Name | Size | ΞΊ_SRME | UQ | Kokkos | Description |
80
+ |:---|:---|:---|:---|:---|:---|:---|
81
+ | **GRACE-1L-OMAT** | GRACE-1L-OMAT | small | 0.398 | β€” | β€” | Single-layer local |
82
+ | GRACE-1L-OMAT-M-base | GRACE-1L-OMAT-medium-base | medium | 0.380 | βœ“ | βœ“ | Single-layer local (base) |
83
+ | **GRACE-1L-OMAT-M** | GRACE-1L-OMAT-medium-ft-E | medium | 0.417 | βœ“ | βœ“ | Single-layer local (finetuned on energy) |
84
+ | GRACE-1L-OMAT-L-base | GRACE-1L-OMAT-large-base | large | **0.354** | βœ“ | βœ“ | Single-layer local (base) |
85
+ | **GRACE-1L-OMAT-L** | GRACE-1L-OMAT-large-ft-E | large | 0.383 | βœ“ | βœ“ | Single-layer local (finetuned on energy) |
86
 
87
  #### Two-layer, semilocal models
88
 
89
+ | Model Name | Full Name | Size | ΞΊ_SRME | UQ | Kokkos | Description |
90
+ |:---|:---|:---|:---|:---|:---|:---|
91
+ | **GRACE-2L-OMAT** | GRACE-2L-OMAT | small | 0.288 | β€” | β€” | Two-layer semi-local |
92
+ | GRACE-2L-OMAT-M-base | GRACE-2L-OMAT-medium-base | medium | 0.212 | βœ“ | βœ“ | Two-layer semi-local (base) |
93
+ | **GRACE-2L-OMAT-M** | GRACE-2L-OMAT-medium-ft-E | medium | 0.217 | βœ“ | βœ“ | Two-layer semi-local (finetuned on energy) |
94
+ | GRACE-2L-OMAT-L-base | GRACE-2L-OMAT-large-base | large | **0.165** | βœ“ | βœ“ | Two-layer semi-local (base) |
95
+ | **GRACE-2L-OMAT-L** | GRACE-2L-OMAT-large-ft-E | large | 0.186 | βœ“ | βœ“ | Two-layer semi-local (finetuned on energy) |
96
 
97
  ## OAM models
98
 
 
102
 
103
  #### Single-layer, local models
104
 
105
+ | Model Name | Full Name | Size | F1 | ΞΊ_SRME | UQ | Kokkos | Description |
106
+ | :--- |:---| :--- |:---|:---|:---|:---| :--- |
107
+ | GRACE-1L-OAM | GRACE-1L-OAM | small | 0.824 | 0.516 | β€” | β€” | Single-layer local |
108
+ | GRACE-1L-OAM-M | GRACE-1L-OMAT-medium-ft-AM | medium | 0.800 | 0.411 | β€” | βœ“ | Single-layer local |
109
+ | GRACE-1L-OAM-L | GRACE-1L-OMAT-large-ft-AM | large | 0.815 | **0.377** | β€” | βœ“ | Single-layer local |
110
 
111
  #### Two-layer, semilocal models
112
 
113
+ | Model Name | Full Name | Size | F1 | ΞΊ_SRME | UQ | Kokkos | Description |
114
+ | :--- |:--- | :--- |:---|:---|:---|:---| :--- |
115
+ | GRACE-2L-OAM | GRACE-2L-OAM | small | 0.880 | 0.294 | β€” | β€” | Two-layer semi-local |
116
+ | GRACE-2L-OAM-M | GRACE-2L-OMAT-medium-ft-AM | medium | 0.881 | 0.200 | β€” | βœ“ | Two-layer semi-local |
117
+ | GRACE-2L-OAM-L | GRACE-2L-OMAT-large-ft-AM | large | 0.889 | **0.168** | β€” | βœ“ | Two-layer semi-local |
118
 
119
  ---
120