Skip to content

Schemas for Material Properties

We present throughout this page a list of JSON schemas and example representations concerning properties. The reader is referred to their respective documentation pages, accessible by clicking the headers below, for a review of their underlying physical significance.

Scalar Properties

Total Energy

Total energy contains the total energy of the unit cell.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
{
    "$schema": "http://json-schema.org/draft-04/schema#", 
    "allOf": [
        {
            "required": [
                "name", 
                "units"
            ], 
            "allOf": [
                {
                    "required": [
                        "value"
                    ], 
                    "type": "object", 
                    "properties": {
                        "value": {
                            "type": "number"
                        }
                    }, 
                    "title": "scalar schema"
                }
            ], 
            "properties": {
                "units": {
                    "enum": [
                        "kJ/mol", 
                        "eV", 
                        "J/mol", 
                        "hartree", 
                        "cm-1", 
                        "rydberg", 
                        "eV/atom"
                    ]
                }, 
                "name": {
                    "type": "string"
                }
            }, 
            "title": "energy schema"
        }
    ], 
    "properties": {
        "name": {
            "enum": [
                "total_energy"
            ]
        }
    }, 
    "title": "total energy schema"
}
1
2
3
4
5
{
    "units": "eV", 
    "name": "total_energy", 
    "value": -123.43573079
}

Zero Point Energy

Some residual thermal vibrational energy is left at zero temperature due to quantum effects, and is referred to as Zero Point Energy.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
{
    "$schema": "http://json-schema.org/draft-04/schema#", 
    "allOf": [
        {
            "required": [
                "name", 
                "units"
            ], 
            "allOf": [
                {
                    "required": [
                        "value"
                    ], 
                    "type": "object", 
                    "properties": {
                        "value": {
                            "type": "number"
                        }
                    }, 
                    "title": "scalar schema"
                }
            ], 
            "properties": {
                "units": {
                    "enum": [
                        "kJ/mol", 
                        "eV", 
                        "J/mol", 
                        "hartree", 
                        "cm-1", 
                        "rydberg", 
                        "eV/atom"
                    ]
                }, 
                "name": {
                    "type": "string"
                }
            }, 
            "title": "energy schema"
        }
    ], 
    "properties": {
        "name": {
            "enum": [
                "zero_point_energy"
            ]
        }
    }, 
    "title": "zero point energy schema"
}
1
2
3
4
5
{
    "units": "eV", 
    "name": "zero_point_energy", 
    "value": -123.43573079
}

Fermi Energy

The Fermi energy marks the highest occupied energy level in a solid.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
{
    "$schema": "http://json-schema.org/draft-04/schema#", 
    "allOf": [
        {
            "required": [
                "name", 
                "units"
            ], 
            "allOf": [
                {
                    "required": [
                        "value"
                    ], 
                    "type": "object", 
                    "properties": {
                        "value": {
                            "type": "number"
                        }
                    }, 
                    "title": "scalar schema"
                }
            ], 
            "properties": {
                "units": {
                    "enum": [
                        "kJ/mol", 
                        "eV", 
                        "J/mol", 
                        "hartree", 
                        "cm-1", 
                        "rydberg", 
                        "eV/atom"
                    ]
                }, 
                "name": {
                    "type": "string"
                }
            }, 
            "title": "energy schema"
        }
    ], 
    "properties": {
        "name": {
            "enum": [
                "fermi_energy"
            ]
        }
    }, 
    "title": "fermi energy schema"
}
1
2
3
4
5
{
    "units": "eV", 
    "name": "fermi_energy", 
    "value": -1.2
}

Total Energy Contributions

Total energy contributions contains information about the components in the total energy of the unit cell. The contributions available will depend on the type of method and software used.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
{
    "$schema": "http://json-schema.org/draft-04/schema#", 
    "type": "object", 
    "properties": {
        "PAWDoubleCounting2": {
            "properties": {
                "name": {
                    "enum": [
                        "PAW_double-counting_correction_2"
                    ]
                }
            }, 
            "description": "double counting correction 2", 
            "allOf": [
                {
                    "required": [
                        "value"
                    ], 
                    "type": "object", 
                    "properties": {
                        "value": {
                            "type": "number"
                        }
                    }, 
                    "title": "scalar schema"
                }
            ]
        }, 
        "PAWDoubleCounting3": {
            "properties": {
                "name": {
                    "enum": [
                        "PAW_double-counting_correction_3"
                    ]
                }
            }, 
            "description": "double counting correction 3", 
            "allOf": [
                {
                    "required": [
                        "value"
                    ], 
                    "type": "object", 
                    "properties": {
                        "value": {
                            "type": "number"
                        }
                    }, 
                    "title": "scalar schema"
                }
            ]
        }, 
        "harrisFoulkes": {
            "properties": {
                "name": {
                    "enum": [
                        "harris_foulkes"
                    ]
                }
            }, 
            "description": "non self-consitent energy based on an input charge density", 
            "allOf": [
                {
                    "required": [
                        "value"
                    ], 
                    "type": "object", 
                    "properties": {
                        "value": {
                            "type": "number"
                        }
                    }, 
                    "title": "scalar schema"
                }
            ]
        }, 
        "ewald": {
            "properties": {
                "name": {
                    "enum": [
                        "ewald"
                    ]
                }
            }, 
            "description": "summation of interaction energies at long length scales due to coloumbic interactions", 
            "allOf": [
                {
                    "required": [
                        "value"
                    ], 
                    "type": "object", 
                    "properties": {
                        "value": {
                            "type": "number"
                        }
                    }, 
                    "title": "scalar schema"
                }
            ]
        }, 
        "hartreeFock": {
            "properties": {
                "name": {
                    "enum": [
                        "hartree_fock"
                    ]
                }
            }, 
            "description": "hartree-fock contribution", 
            "allOf": [
                {
                    "required": [
                        "value"
                    ], 
                    "type": "object", 
                    "properties": {
                        "value": {
                            "type": "number"
                        }
                    }, 
                    "title": "scalar schema"
                }
            ]
        }, 
        "exchange": {
            "properties": {
                "name": {
                    "enum": [
                        "exchange"
                    ]
                }
            }, 
            "description": "exchange energy", 
            "allOf": [
                {
                    "required": [
                        "value"
                    ], 
                    "type": "object", 
                    "properties": {
                        "value": {
                            "type": "number"
                        }
                    }, 
                    "title": "scalar schema"
                }
            ]
        }, 
        "alphaZ": {
            "properties": {
                "name": {
                    "enum": [
                        "alphaZ"
                    ]
                }
            }, 
            "description": "divergent electrostatic ion interaction in compensating electron gas", 
            "allOf": [
                {
                    "required": [
                        "value"
                    ], 
                    "type": "object", 
                    "properties": {
                        "value": {
                            "type": "number"
                        }
                    }, 
                    "title": "scalar schema"
                }
            ]
        }, 
        "oneElectron": {
            "properties": {
                "name": {
                    "enum": [
                        "one_electron"
                    ]
                }
            }, 
            "description": "kinetic + pseudopotential energy", 
            "allOf": [
                {
                    "required": [
                        "value"
                    ], 
                    "type": "object", 
                    "properties": {
                        "value": {
                            "type": "number"
                        }
                    }, 
                    "title": "scalar schema"
                }
            ]
        }, 
        "atomicEnergy": {
            "properties": {
                "name": {
                    "enum": [
                        "atomic_energy"
                    ]
                }
            }, 
            "description": "kinetic energy of wavefunctions in the atomic limit", 
            "allOf": [
                {
                    "required": [
                        "value"
                    ], 
                    "type": "object", 
                    "properties": {
                        "value": {
                            "type": "number"
                        }
                    }, 
                    "title": "scalar schema"
                }
            ]
        }, 
        "units": {
            "enum": [
                "kJ/mol", 
                "eV", 
                "J/mol", 
                "hartree", 
                "cm-1", 
                "rydberg", 
                "eV/atom"
            ]
        }, 
        "eigenvalues": {
            "properties": {
                "name": {
                    "enum": [
                        "eigenvalues"
                    ]
                }
            }, 
            "description": "sum of one electron energies of kinetic, electrostatic, and exchange correlation", 
            "allOf": [
                {
                    "required": [
                        "value"
                    ], 
                    "type": "object", 
                    "properties": {
                        "value": {
                            "type": "number"
                        }
                    }, 
                    "title": "scalar schema"
                }
            ]
        }, 
        "hartree": {
            "properties": {
                "name": {
                    "enum": [
                        "hartree"
                    ]
                }
            }, 
            "description": "energy due to coulomb potential", 
            "allOf": [
                {
                    "required": [
                        "value"
                    ], 
                    "type": "object", 
                    "properties": {
                        "value": {
                            "type": "number"
                        }
                    }, 
                    "title": "scalar schema"
                }
            ]
        }, 
        "temperatureEntropy": {
            "properties": {
                "name": {
                    "enum": [
                        "temperature_entropy"
                    ]
                }
            }, 
            "description": "product of temperature and configurational entropy", 
            "allOf": [
                {
                    "required": [
                        "value"
                    ], 
                    "type": "object", 
                    "properties": {
                        "value": {
                            "type": "number"
                        }
                    }, 
                    "title": "scalar schema"
                }
            ]
        }, 
        "exchangeCorrelation": {
            "properties": {
                "name": {
                    "enum": [
                        "exchange_correlation"
                    ]
                }
            }, 
            "description": "exchange and correlation energy per particle", 
            "allOf": [
                {
                    "required": [
                        "value"
                    ], 
                    "type": "object", 
                    "properties": {
                        "value": {
                            "type": "number"
                        }
                    }, 
                    "title": "scalar schema"
                }
            ]
        }, 
        "name": {
            "enum": [
                "total_energy_contributions"
            ]
        }
    }, 
    "title": "total energy contributions schema"
}
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
{
    "PAWDoubleCounting2": {
        "name": "PAW_double-counting_correction_2", 
        "value": 12658.30538857
    }, 
    "PAWDoubleCounting3": {
        "name": "PAW_double-counting_correction_3", 
        "value": -12074.85364512
    }, 
    "ewald": {
        "name": "ewald", 
        "value": 128376.45871064
    }, 
    "name": "total_energy_contributions", 
    "exchange": {
        "name": "exchange", 
        "value": 0
    }, 
    "alphaZ": {
        "name": "alphaZ", 
        "value": 1056.91493097
    }, 
    "atomicEnergy": {
        "name": "atomic_energy", 
        "value": 15740.5725788
    }, 
    "units": "eV", 
    "eigenvalues": {
        "name": "eigenvalues", 
        "value": -577.80127102
    }, 
    "hartree": {
        "name": "hartree", 
        "value": -145344.66902862
    }, 
    "temperatureEntropy": {
        "name": "temperature_entropy", 
        "value": -0.00032545
    }, 
    "exchangeCorrelation": {
        "name": "exchange_correlation", 
        "value": 41.63693035
    }
}

Formation Energy

The Formation energy represents the energy required to create a defect in an otherwise perfect solid structure.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
{
    "$schema": "http://json-schema.org/draft-04/schema#", 
    "allOf": [
        {
            "required": [
                "name", 
                "units"
            ], 
            "allOf": [
                {
                    "required": [
                        "value"
                    ], 
                    "type": "object", 
                    "properties": {
                        "value": {
                            "type": "number"
                        }
                    }, 
                    "title": "scalar schema"
                }
            ], 
            "properties": {
                "units": {
                    "enum": [
                        "kJ/mol", 
                        "eV", 
                        "J/mol", 
                        "hartree", 
                        "cm-1", 
                        "rydberg", 
                        "eV/atom"
                    ]
                }, 
                "name": {
                    "type": "string"
                }
            }, 
            "title": "energy schema"
        }
    ], 
    "properties": {
        "name": {
            "enum": [
                "formation_energy"
            ]
        }
    }, 
    "title": "formation energy schema"
}
1
2
3
4
5
{
    "units": "eV", 
    "name": "formation_energy", 
    "value": -123.43573079
}

Surface Energy

The energy of a surface can also be computed.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
{
    "$schema": "http://json-schema.org/draft-04/schema#", 
    "allOf": [
        {
            "required": [
                "name", 
                "units"
            ], 
            "allOf": [
                {
                    "required": [
                        "value"
                    ], 
                    "type": "object", 
                    "properties": {
                        "value": {
                            "type": "number"
                        }
                    }, 
                    "title": "scalar schema"
                }
            ], 
            "properties": {
                "units": {
                    "enum": [
                        "eV/A^2"
                    ]
                }, 
                "name": {
                    "type": "string"
                }
            }, 
            "title": "surface energy schema"
        }
    ], 
    "properties": {
        "name": {
            "enum": [
                "surface_energy"
            ]
        }
    }, 
    "title": "surface energy schema"
}
1
2
3
4
5
{
    "units": "eV/A^2", 
    "name": "surface_energy", 
    "value": 0.02
}

Pressure

Pressure contains the average internal pressure of the unit cell.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
{
    "$schema": "http://json-schema.org/draft-04/schema#", 
    "allOf": [
        {
            "required": [
                "value"
            ], 
            "type": "object", 
            "properties": {
                "value": {
                    "type": "number"
                }
            }, 
            "title": "scalar schema"
        }
    ], 
    "properties": {
        "units": {
            "enum": [
                "kbar", 
                "pa"
            ]
        }, 
        "name": {
            "enum": [
                "pressure"
            ]
        }
    }, 
    "description": "average pressure in unit cell", 
    "title": "pressure"
}
1
2
3
4
5
{
    "units": "kbar", 
    "name": "pressure", 
    "value": -27.345
}

Total Force

This is the total average force present within the crystal structure.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
{
    "$schema": "http://json-schema.org/draft-04/schema#", 
    "allOf": [
        {
            "required": [
                "value"
            ], 
            "type": "object", 
            "properties": {
                "value": {
                    "type": "number"
                }
            }, 
            "title": "scalar schema"
        }
    ], 
    "properties": {
        "units": {
            "enum": [
                "eV/bohr", 
                "eV/angstrom", 
                "rydberg/a.u.", 
                "newton", 
                "kg*m/s^2", 
                "eV/a.u."
            ]
        }, 
        "name": {
            "enum": [
                "total_force"
            ]
        }
    }, 
    "title": "total forces schema"
}
1
2
3
4
5
{
    "units": "eV/angstrom", 
    "name": "total_force", 
    "value": 1e-06
}

Non-Scalar Properties

Bandstructure

Band structure shows the energy of electronic states (bands) as a function of k-point position throughout the cell.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
{
    "$schema": "http://json-schema.org/draft-04/schema#", 
    "allOf": [
        {
            "required": [
                "xAxis", 
                "yAxis"
            ], 
            "allOf": [
                {
                    "required": [
                        "xDataArray", 
                        "yDataSeries"
                    ], 
                    "type": "object", 
                    "properties": {
                        "xDataArray": {
                            "type": "array", 
                            "description": "array containing values of x Axis"
                        }, 
                        "yDataSeries": {
                            "items": {
                                "minItems": 1, 
                                "items": {
                                    "type": [
                                        "number", 
                                        "string"
                                    ]
                                }, 
                                "type": "array"
                            }, 
                            "type": "array", 
                            "title": "1 dimension data series schema"
                        }
                    }, 
                    "title": "2 dimension data schema"
                }
            ], 
            "properties": {
                "legend": {
                    "minItems": 1, 
                    "type": "array", 
                    "description": "Legend of y Axis data series"
                }, 
                "xAxis": {
                    "properties": {
                        "units": {
                            "type": "string", 
                            "description": "units for an axis"
                        }, 
                        "label": {
                            "type": "string", 
                            "description": "label of an axis object"
                        }
                    }, 
                    "required": [
                        "label"
                    ], 
                    "description": "x Axis object", 
                    "title": "axis schema"
                }, 
                "yAxis": {
                    "properties": {
                        "units": {
                            "type": "string", 
                            "description": "units for an axis"
                        }, 
                        "label": {
                            "type": "string", 
                            "description": "label of an axis object"
                        }
                    }, 
                    "required": [
                        "label"
                    ], 
                    "description": "y Axis object", 
                    "title": "axis schema"
                }
            }, 
            "title": "2 dimension plot schema"
        }
    ], 
    "properties": {
        "spin": {
            "items": {
                "enum": [
                    0.5, 
                    -0.5
                ], 
                "type": "number"
            }, 
            "type": "array", 
            "description": "spin of each band"
        }, 
        "name": {
            "enum": [
                "band_structure"
            ]
        }, 
        "xAxis": {
            "properties": {
                "units": {
                    "enum": [
                        "km", 
                        "m", 
                        "pm", 
                        "nm", 
                        "angstrom", 
                        "a.u.", 
                        "bohr", 
                        "fractional", 
                        "crystal", 
                        "cartesian", 
                        "alat"
                    ]
                }, 
                "label": {
                    "enum": [
                        "kpoints"
                    ]
                }
            }
        }, 
        "yAxis": {
            "properties": {
                "units": {
                    "enum": [
                        "kJ/mol", 
                        "eV", 
                        "J/mol", 
                        "hartree", 
                        "cm-1", 
                        "rydberg", 
                        "eV/atom"
                    ]
                }, 
                "label": {
                    "enum": [
                        "energy"
                    ]
                }
            }
        }
    }, 
    "title": "band structure schema"
}
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
{
    "yDataSeries": [
        [
            12.1, 
            12.5
        ], 
        [
            11.1, 
            11.5
        ], 
        [
            10.1, 
            10.5
        ], 
        [
            9.5, 
            8.5
        ]
    ], 
    "yAxis": {
        "units": "eV", 
        "label": "energy"
    }, 
    "xDataArray": [
        [
            0, 
            0, 
            0
        ], 
        [
            0.5, 
            0.5, 
            0.5
        ]
    ], 
    "xAxis": {
        "units": "crystal", 
        "label": "kpoints"
    }, 
    "spin": [
        0.5, 
        0.5, 
        0.5, 
        0.5
    ], 
    "name": "band_structure"
}

Band Gaps

Band gap is the difference in energy from the highest occupied electronic state (Fermi energy at 0K) to the lowest unoccupied state.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
{
    "$schema": "http://json-schema.org/draft-04/schema#", 
    "required": [
        "name"
    ], 
    "properties": {
        "eigenvalues": {
            "items": {
                "properties": {
                    "kpoint": {
                        "minItems": 3, 
                        "items": {
                            "type": "number"
                        }, 
                        "type": "array", 
                        "maxItems": 3, 
                        "title": "vector schema"
                    }, 
                    "weight": {
                        "type": "number"
                    }, 
                    "eigenvalues": {
                        "items": {
                            "properties": {
                                "energies": {
                                    "type": "array"
                                }, 
                                "spin": {
                                    "type": "number"
                                }, 
                                "occupations": {
                                    "type": "array"
                                }
                            }
                        }, 
                        "type": "array"
                    }
                }
            }, 
            "type": "array"
        }, 
        "values": {
            "items": {
                "required": [
                    "type"
                ], 
                "allOf": [
                    {
                        "required": [
                            "value"
                        ], 
                        "type": "object", 
                        "properties": {
                            "value": {
                                "type": "number"
                            }
                        }, 
                        "title": "scalar schema"
                    }
                ], 
                "properties": {
                    "units": {
                        "enum": [
                            "kJ/mol", 
                            "eV", 
                            "J/mol", 
                            "hartree", 
                            "cm-1", 
                            "rydberg", 
                            "eV/atom"
                        ]
                    }, 
                    "kpointConduction": {
                        "description": "kpoint inside conduction band in crystal coordinates", 
                        "title": "vector schema", 
                        "minItems": 3, 
                        "items": {
                            "type": "number"
                        }, 
                        "maxItems": 3, 
                        "type": "array"
                    }, 
                    "kpointValence": {
                        "description": "kpoint inside valence band in crystal coordinates", 
                        "title": "vector schema", 
                        "minItems": 3, 
                        "items": {
                            "type": "number"
                        }, 
                        "maxItems": 3, 
                        "type": "array"
                    }, 
                    "type": {
                        "enum": [
                            "direct", 
                            "indirect"
                        ], 
                        "type": "string"
                    }
                }, 
                "title": "band gap schema"
            }, 
            "type": "array"
        }, 
        "name": {
            "enum": [
                "band_gaps"
            ]
        }
    }, 
    "description": "contains band gap values", 
    "title": "band gaps schema"
}
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
    "values": [
        {
            "units": "rydberg", 
            "kpointConduction": [
                0, 
                0, 
                0
            ], 
            "kpointValence": [
                0, 
                0, 
                0
            ], 
            "value": 0.0947, 
            "type": "direct"
        }, 
        {
            "units": "rydberg", 
            "type": "indirect", 
            "value": 0.0
        }
    ], 
    "name": "band_gaps"
}

Electronic Density of States

Density of states contains information on the number of electronic states as a function of energy. It may include the atom resolved partial density of states and electron states in some cases. In addition it may also contain information about each atom’s spin state as well.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
{
    "$schema": "http://json-schema.org/draft-04/schema#", 
    "allOf": [
        {
            "required": [
                "xAxis", 
                "yAxis"
            ], 
            "allOf": [
                {
                    "required": [
                        "xDataArray", 
                        "yDataSeries"
                    ], 
                    "type": "object", 
                    "properties": {
                        "xDataArray": {
                            "type": "array", 
                            "description": "array containing values of x Axis"
                        }, 
                        "yDataSeries": {
                            "items": {
                                "minItems": 1, 
                                "items": {
                                    "type": [
                                        "number", 
                                        "string"
                                    ]
                                }, 
                                "type": "array"
                            }, 
                            "type": "array", 
                            "title": "1 dimension data series schema"
                        }
                    }, 
                    "title": "2 dimension data schema"
                }
            ], 
            "properties": {
                "legend": {
                    "minItems": 1, 
                    "type": "array", 
                    "description": "Legend of y Axis data series"
                }, 
                "xAxis": {
                    "properties": {
                        "units": {
                            "type": "string", 
                            "description": "units for an axis"
                        }, 
                        "label": {
                            "type": "string", 
                            "description": "label of an axis object"
                        }
                    }, 
                    "required": [
                        "label"
                    ], 
                    "description": "x Axis object", 
                    "title": "axis schema"
                }, 
                "yAxis": {
                    "properties": {
                        "units": {
                            "type": "string", 
                            "description": "units for an axis"
                        }, 
                        "label": {
                            "type": "string", 
                            "description": "label of an axis object"
                        }
                    }, 
                    "required": [
                        "label"
                    ], 
                    "description": "y Axis object", 
                    "title": "axis schema"
                }
            }, 
            "title": "2 dimension plot schema"
        }
    ], 
    "type": "object", 
    "properties": {
        "legend": {
            "items": {
                "type": "object", 
                "properties": {
                    "index": {
                        "type": "integer", 
                        "description": "index inside sub-array of atoms of the same element type"
                    }, 
                    "electronicState": {
                        "pattern": "^([1-5]{1})?(s|p|d|f|g).*$", 
                        "type": "string", 
                        "description": "electronic character and shell of PDOS, such as `1s` or `s`, or `total`"
                    }, 
                    "spin": {
                        "enum": [
                            0.5, 
                            -0.5
                        ], 
                        "type": "number", 
                        "description": "spin of the electronic state"
                    }, 
                    "element": {
                        "type": "string", 
                        "description": "chemical element"
                    }
                }
            }
        }, 
        "name": {
            "enum": [
                "density_of_states"
            ]
        }, 
        "xAxis": {
            "properties": {
                "units": {
                    "enum": [
                        "kJ/mol", 
                        "eV", 
                        "J/mol", 
                        "hartree", 
                        "cm-1", 
                        "rydberg", 
                        "eV/atom"
                    ]
                }, 
                "label": {
                    "enum": [
                        "energy"
                    ]
                }
            }
        }, 
        "yAxis": {
            "properties": {
                "units": {
                    "enum": [
                        "states/unitcell"
                    ]
                }, 
                "label": {
                    "enum": [
                        "density of states"
                    ]
                }
            }
        }
    }, 
    "title": "density of states schema"
}
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
{
    "yDataSeries": [
        [
            12.1, 
            12.5
        ], 
        [
            11.1, 
            11.5
        ], 
        [
            10.1, 
            10.5
        ], 
        [
            9.5, 
            8.5
        ]
    ], 
    "yAxis": {
        "units": "states/unitcell", 
        "label": "density of states"
    }, 
    "name": "density_of_states", 
    "xAxis": {
        "units": "eV", 
        "label": "energy"
    }, 
    "legend": [
        {
            "index": 1, 
            "electronicState": "2s", 
            "spin": 0.5, 
            "element": "C"
        }, 
        {
            "index": 2, 
            "electronicState": "2p", 
            "spin": 0.5, 
            "element": "C"
        }
    ], 
    "xDataArray": [
        [
            0, 
            0, 
            0
        ], 
        [
            0.5, 
            0.5, 
            0.5
        ]
    ]
}

Phonon Dispersions

Lattice vibrations can be plotted in the form of phonon frequency dispersion plots across the reciprocal k-space of the crystal structure.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
{
    "$schema": "http://json-schema.org/draft-04/schema#", 
    "allOf": [
        {
            "required": [
                "xAxis", 
                "yAxis"
            ], 
            "allOf": [
                {
                    "required": [
                        "xDataArray", 
                        "yDataSeries"
                    ], 
                    "type": "object", 
                    "properties": {
                        "xDataArray": {
                            "type": "array", 
                            "description": "array containing values of x Axis"
                        }, 
                        "yDataSeries": {
                            "items": {
                                "minItems": 1, 
                                "items": {
                                    "type": [
                                        "number", 
                                        "string"
                                    ]
                                }, 
                                "type": "array"
                            }, 
                            "type": "array", 
                            "title": "1 dimension data series schema"
                        }
                    }, 
                    "title": "2 dimension data schema"
                }
            ], 
            "properties": {
                "legend": {
                    "minItems": 1, 
                    "type": "array", 
                    "description": "Legend of y Axis data series"
                }, 
                "xAxis": {
                    "properties": {
                        "units": {
                            "type": "string", 
                            "description": "units for an axis"
                        }, 
                        "label": {
                            "type": "string", 
                            "description": "label of an axis object"
                        }
                    }, 
                    "required": [
                        "label"
                    ], 
                    "description": "x Axis object", 
                    "title": "axis schema"
                }, 
                "yAxis": {
                    "properties": {
                        "units": {
                            "type": "string", 
                            "description": "units for an axis"
                        }, 
                        "label": {
                            "type": "string", 
                            "description": "label of an axis object"
                        }
                    }, 
                    "required": [
                        "label"
                    ], 
                    "description": "y Axis object", 
                    "title": "axis schema"
                }
            }, 
            "title": "2 dimension plot schema"
        }
    ], 
    "properties": {
        "name": {
            "enum": [
                "phonon_dispersions"
            ]
        }, 
        "xAxis": {
            "properties": {
                "units": {
                    "enum": [
                        "km", 
                        "m", 
                        "pm", 
                        "nm", 
                        "angstrom", 
                        "a.u.", 
                        "bohr", 
                        "fractional", 
                        "crystal", 
                        "cartesian", 
                        "alat"
                    ]
                }, 
                "label": {
                    "enum": [
                        "qpoints"
                    ]
                }
            }
        }, 
        "yAxis": {
            "properties": {
                "units": {
                    "enum": [
                        "cm-1", 
                        "THz", 
                        "meV"
                    ]
                }, 
                "label": {
                    "enum": [
                        "frequency"
                    ]
                }
            }
        }
    }, 
    "title": "phonon band structure schema"
}
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
{
    "yDataSeries": [
        [
            -6e-06, 
            -6e-06, 
            -5e-06, 
            734.596987, 
            734.618837, 
            734.618837
        ], 
        [
            -6.859784, 
            -6.859784, 
            36.443014, 
            730.782803, 
            731.143013, 
            731.143013
        ]
    ], 
    "yAxis": {
        "units": "cm-1", 
        "label": "frequency"
    }, 
    "name": "phonon_dispersions", 
    "xAxis": {
        "units": "crystal", 
        "label": "qpoints"
    }, 
    "xDataArray": [
        [
            0, 
            0, 
            0
        ], 
        [
            0.5, 
            0.05, 
            0.05
        ]
    ]
}

Phonon Density of States

The Density of States for phonons can also be computed.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
{
    "$schema": "http://json-schema.org/draft-04/schema#", 
    "allOf": [
        {
            "required": [
                "xAxis", 
                "yAxis"
            ], 
            "allOf": [
                {
                    "required": [
                        "xDataArray", 
                        "yDataSeries"
                    ], 
                    "type": "object", 
                    "properties": {
                        "xDataArray": {
                            "type": "array", 
                            "description": "array containing values of x Axis"
                        }, 
                        "yDataSeries": {
                            "items": {
                                "minItems": 1, 
                                "items": {
                                    "type": [
                                        "number", 
                                        "string"
                                    ]
                                }, 
                                "type": "array"
                            }, 
                            "type": "array", 
                            "title": "1 dimension data series schema"
                        }
                    }, 
                    "title": "2 dimension data schema"
                }
            ], 
            "properties": {
                "legend": {
                    "minItems": 1, 
                    "type": "array", 
                    "description": "Legend of y Axis data series"
                }, 
                "xAxis": {
                    "properties": {
                        "units": {
                            "type": "string", 
                            "description": "units for an axis"
                        }, 
                        "label": {
                            "type": "string", 
                            "description": "label of an axis object"
                        }
                    }, 
                    "required": [
                        "label"
                    ], 
                    "description": "x Axis object", 
                    "title": "axis schema"
                }, 
                "yAxis": {
                    "properties": {
                        "units": {
                            "type": "string", 
                            "description": "units for an axis"
                        }, 
                        "label": {
                            "type": "string", 
                            "description": "label of an axis object"
                        }
                    }, 
                    "required": [
                        "label"
                    ], 
                    "description": "y Axis object", 
                    "title": "axis schema"
                }
            }, 
            "title": "2 dimension plot schema"
        }
    ], 
    "type": "object", 
    "properties": {
        "name": {
            "enum": [
                "phonon_dos"
            ]
        }, 
        "xAxis": {
            "properties": {
                "units": {
                    "enum": [
                        "cm-1", 
                        "THz", 
                        "meV"
                    ]
                }, 
                "label": {
                    "enum": [
                        "frequency"
                    ]
                }
            }
        }, 
        "yAxis": {
            "properties": {
                "units": {
                    "enum": [
                        "states/cm-1", 
                        "states/THz", 
                        "states/meV"
                    ]
                }, 
                "label": {
                    "enum": [
                        "Phonon DOS"
                    ]
                }
            }
        }
    }, 
    "title": "Phonon density of states schema"
}
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
{
    "yDataSeries": [
        [
            0.0001433, 
            0.00011382, 
            8.7721e-05, 
            6.502e-05, 
            4.5713e-05, 
            2.9799e-05, 
            1.7279e-05, 
            8.1527e-06, 
            2.4197e-06
        ]
    ], 
    "yAxis": {
        "units": "states/cm-1", 
        "label": "Phonon DOS"
    }, 
    "name": "phonon_dos", 
    "xAxis": {
        "units": "cm-1", 
        "label": "frequency"
    }, 
    "xDataArray": [
        [
            565.0, 
            566.0, 
            567.0, 
            568.0, 
            569.0, 
            570.0, 
            571.0, 
            572.0, 
            573.0
        ]
    ]
}

Stress Tensor

Stress tensor contains a 3x3 matrix of the stress components of the unit cell.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
{
    "$schema": "http://json-schema.org/draft-04/schema#", 
    "properties": {
        "units": {
            "enum": [
                "kbar", 
                "pa"
            ]
        }, 
        "name": {
            "enum": [
                "stress_tensor"
            ]
        }, 
        "value": {
            "minItems": 3, 
            "items": {
                "minItems": 3, 
                "items": {
                    "type": "number"
                }, 
                "type": "array", 
                "maxItems": 3, 
                "title": "vector schema"
            }, 
            "type": "array", 
            "maxItems": 3, 
            "title": "3 dimensional tensor schema"
        }
    }, 
    "title": "stress tensor schema"
}
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
{
    "units": "kbar", 
    "name": "stress_tensor", 
    "value": [
        [
            3, 
            0, 
            0
        ], 
        [
            0, 
            3, 
            0
        ], 
        [
            0, 
            0, 
            3
        ]
    ]
}

Elemental Properties

Atomic Radius

The atomic radius represents the average distance between the nucleus of an atom and the edges of its surrounding electron cloud.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
{
    "$schema": "http://json-schema.org/draft-04/schema#", 
    "allOf": [
        {
            "required": [
                "value"
            ], 
            "type": "object", 
            "properties": {
                "value": {
                    "type": "number"
                }
            }, 
            "title": "scalar schema"
        }
    ], 
    "properties": {
        "units": {
            "enum": [
                "km", 
                "m", 
                "pm", 
                "nm", 
                "angstrom", 
                "a.u.", 
                "bohr", 
                "fractional", 
                "crystal", 
                "cartesian", 
                "alat"
            ]
        }, 
        "name": {
            "enum": [
                "atomic_radius"
            ]
        }
    }, 
    "description": "atomic radius", 
    "title": "atomic radius"
}
1
2
3
4
{
    "name": "atomic_radius", 
    "value": 4
}

Electronegativity

The electronegativity describes the capacity of an atom to attract the electrons involved in chemical bonding.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
{
    "$schema": "http://json-schema.org/draft-04/schema#", 
    "allOf": [
        {
            "required": [
                "value"
            ], 
            "type": "object", 
            "properties": {
                "value": {
                    "type": "number"
                }
            }, 
            "title": "scalar schema"
        }
    ], 
    "properties": {
        "name": {
            "enum": [
                "electronegativity"
            ]
        }
    }, 
    "description": "electronegativity for the element (Pauling scale)", 
    "title": "electronegativity"
}
1
2
3
4
{
    "name": "electronegativity", 
    "value": 1.1
}

Ionization Potential

The ionization energy (or potential) measures the energy required to strip an atom from its most loosely bound valence electron.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
{
    "$schema": "http://json-schema.org/draft-04/schema#", 
    "allOf": [
        {
            "required": [
                "value"
            ], 
            "type": "object", 
            "properties": {
                "value": {
                    "type": "number"
                }
            }, 
            "title": "scalar schema"
        }
    ], 
    "properties": {
        "units": {
            "enum": [
                "kJ/mol", 
                "eV", 
                "J/mol", 
                "hartree", 
                "cm-1", 
                "rydberg", 
                "eV/atom"
            ]
        }, 
        "name": {
            "enum": [
                "ionization_potential"
            ]
        }
    }, 
    "description": "ionization potential for the element", 
    "title": "ionization potential"
}
1
2
3
4
{
    "name": "ionization_potential", 
    "value": 7.7
}

Structural Properties

Atomic Forces

Forces may exist between atoms in a crystal structure if they are displaced away from their equilibrium configuration.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
{
    "$schema": "http://json-schema.org/draft-04/schema#", 
    "properties": {
        "units": {
            "enum": [
                "eV/bohr", 
                "eV/angstrom", 
                "rydberg/a.u.", 
                "newton", 
                "kg*m/s^2", 
                "eV/a.u."
            ]
        }, 
        "values": {
            "items": {
                "properties": {
                    "value": {
                        "minItems": 3, 
                        "items": {
                            "type": "number"
                        }, 
                        "type": "array", 
                        "maxItems": 3, 
                        "title": "vector schema"
                    }
                }
            }, 
            "allOf": [
                {
                    "items": {
                        "uniqueItems": true, 
                        "type": "object", 
                        "properties": {
                            "id": {
                                "type": "integer", 
                                "description": "integer id of this entry"
                            }
                        }
                    }, 
                    "type": "array", 
                    "description": "array of objects containing integer id each", 
                    "title": "atomic ids"
                }
            ], 
            "title": "atomic vectors schema"
        }, 
        "name": {
            "enum": [
                "atomic_forces"
            ]
        }
    }, 
    "description": "coordinates of atoms by ids, vector, unitless", 
    "title": "atomic forces"
}
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
{
    "units": "eV/bohr", 
    "values": [
        {
            "id": 1, 
            "value": [
                -3.9e-07, 
                -2.4e-07, 
                0.0
            ]
        }, 
        {
            "id": 2, 
            "value": [
                3.9e-07, 
                2.4e-07, 
                0.0
            ]
        }
    ], 
    "name": "atomic_forces"
}

Atomic Coordinates

Contains information about the coordinates of atoms within the unit cell by id.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
{
    "$schema": "http://json-schema.org/draft-04/schema#", 
    "properties": {
        "units": {
            "enum": [
                "km", 
                "m", 
                "pm", 
                "nm", 
                "angstrom", 
                "a.u.", 
                "bohr", 
                "fractional", 
                "crystal", 
                "cartesian", 
                "alat"
            ]
        }, 
        "values": {
            "items": {
                "properties": {
                    "value": {
                        "minItems": 3, 
                        "items": {
                            "type": "number"
                        }, 
                        "type": "array", 
                        "maxItems": 3, 
                        "title": "vector schema"
                    }
                }
            }, 
            "allOf": [
                {
                    "items": {
                        "uniqueItems": true, 
                        "type": "object", 
                        "properties": {
                            "id": {
                                "type": "integer", 
                                "description": "integer id of this entry"
                            }
                        }
                    }, 
                    "type": "array", 
                    "description": "array of objects containing integer id each", 
                    "title": "atomic ids"
                }
            ], 
            "title": "atomic vectors schema"
        }, 
        "name": {
            "enum": [
                "atomic_coordinates"
            ]
        }
    }, 
    "description": "coordinates of atoms by ids, vector, unitless", 
    "title": "atomic coordinates"
}
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
{
    "values": [
        {
            "id": 1, 
            "value": [
                0, 
                0, 
                0
            ]
        }, 
        {
            "id": 2, 
            "value": [
                0.25, 
                0.25, 
                0.25
            ]
        }
    ], 
    "name": "atomic_coordinates"
}

Atomic Elements

Contains an array of the elements in the unit cell and the atom id’s association with each atom.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
{
    "$schema": "http://json-schema.org/draft-04/schema#", 
    "properties": {
        "values": {
            "items": {
                "properties": {
                    "value": {
                        "type": "string"
                    }
                }
            }, 
            "allOf": [
                {
                    "items": {
                        "uniqueItems": true, 
                        "type": "object", 
                        "properties": {
                            "id": {
                                "type": "integer", 
                                "description": "integer id of this entry"
                            }
                        }
                    }, 
                    "type": "array", 
                    "description": "array of objects containing integer id each", 
                    "title": "atomic ids"
                }
            ], 
            "title": "atomic vectors schema"
        }, 
        "name": {
            "enum": [
                "atomic_elements"
            ]
        }
    }, 
    "description": "elements of atoms by ids, string, unitless", 
    "title": "atomic elements"
}
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
[
    {
        "id": 1, 
        "value": "Si"
    }, 
    {
        "id": 2, 
        "value": "Si"
    }
]

Basis

Basis defines elemental and geometrical constitution of the unit cell.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
{
    "$schema": "http://json-schema.org/draft-04/schema#", 
    "required": [
        "elements", 
        "coordinates"
    ], 
    "type": "object", 
    "properties": {
        "elements": {
            "properties": {
                "values": {
                    "items": {
                        "properties": {
                            "value": {
                                "type": "string"
                            }
                        }
                    }, 
                    "allOf": [
                        {
                            "items": {
                                "uniqueItems": true, 
                                "type": "object", 
                                "properties": {
                                    "id": {
                                        "type": "integer", 
                                        "description": "integer id of this entry"
                                    }
                                }
                            }, 
                            "type": "array", 
                            "description": "array of objects containing integer id each", 
                            "title": "atomic ids"
                        }
                    ], 
                    "title": "atomic vectors schema"
                }, 
                "name": {
                    "enum": [
                        "atomic_elements"
                    ]
                }
            }, 
            "description": "elements of atoms by ids, string, unitless", 
            "title": "atomic elements"
        }, 
        "coordinates": {
            "properties": {
                "units": {
                    "enum": [
                        "km", 
                        "m", 
                        "pm", 
                        "nm", 
                        "angstrom", 
                        "a.u.", 
                        "bohr", 
                        "fractional", 
                        "crystal", 
                        "cartesian", 
                        "alat"
                    ]
                }, 
                "values": {
                    "items": {
                        "properties": {
                            "value": {
                                "minItems": 3, 
                                "items": {
                                    "type": "number"
                                }, 
                                "type": "array", 
                                "maxItems": 3, 
                                "title": "vector schema"
                            }
                        }
                    }, 
                    "allOf": [
                        {
                            "items": {
                                "uniqueItems": true, 
                                "type": "object", 
                                "properties": {
                                    "id": {
                                        "type": "integer", 
                                        "description": "integer id of this entry"
                                    }
                                }
                            }, 
                            "type": "array", 
                            "description": "array of objects containing integer id each", 
                            "title": "atomic ids"
                        }
                    ], 
                    "title": "atomic vectors schema"
                }, 
                "name": {
                    "enum": [
                        "atomic_coordinates"
                    ]
                }
            }, 
            "description": "coordinates of atoms by ids, vector, unitless", 
            "title": "atomic coordinates"
        }
    }, 
    "title": "basis schema"
}
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
{
    "units": "crystal", 
    "elements": [
        {
            "id": "value"
        }
    ], 
    "name": "basis", 
    "coordinates": {
        "values": [
            {
                "id": 1, 
                "value": [
                    0, 
                    0, 
                    0
                ]
            }, 
            {
                "id": 2, 
                "value": [
                    0.25, 
                    0.25, 
                    0.25
                ]
            }
        ], 
        "name": "atomic_coordinates"
    }
}

Bravais Lattice

Lattice Bravais holds information about the three-dimensional periodic structure specified implicitly through lengths and angles between lattice vectors, and their units.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
{
    "required": [
        "type"
    ], 
    "$schema": "http://json-schema.org/draft-04/schema#", 
    "allOf": [
        {
            "required": [
                "a", 
                "b", 
                "c", 
                "alpha", 
                "beta", 
                "gamma"
            ], 
            "type": "object", 
            "properties": {
                "a": {
                    "type": "number", 
                    "description": "length of the first lattice vector"
                }, 
                "c": {
                    "type": "number", 
                    "description": "length of the third lattice vector"
                }, 
                "b": {
                    "type": "number", 
                    "description": "length of the second lattice vector"
                }, 
                "beta": {
                    "type": "number", 
                    "description": "angle between second and third lattice vector"
                }, 
                "alpha": {
                    "type": "number", 
                    "description": "angle between first and second lattice vector"
                }, 
                "gamma": {
                    "type": "number", 
                    "description": "angle between first and third lattice vector"
                }
            }, 
            "title": "3 dimensional lattice schema"
        }
    ], 
    "properties": {
        "units": {
            "type": "object", 
            "properties": {
                "length": {
                    "enum": [
                        "angstrom", 
                        "bohr"
                    ], 
                    "type": "string"
                }, 
                "angle": {
                    "enum": [
                        "degree", 
                        "radian"
                    ], 
                    "type": "string"
                }
            }
        }, 
        "type": {
            "enum": [
                "CUB", 
                "BCC", 
                "FCC", 
                "TET", 
                "MCL", 
                "ORC", 
                "ORCC", 
                "ORCF", 
                "ORCI", 
                "HEX", 
                "BCT", 
                "TRI", 
                "MCLC", 
                "RHL"
            ], 
            "type": "string", 
            "description": "Bravais lattice type in short notation"
        }
    }, 
    "title": "lattice implicit schema"
}
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
{
    "a": 5.14, 
    "c": 5.14, 
    "b": 5.14, 
    "beta": 90.0, 
    "units": {
        "length": "angstrom", 
        "angle": "degree"
    }, 
    "alpha": 90.0, 
    "type": "CUB", 
    "gamma": 90.0
}

Lattice Vectors

Lattice vectors holds information about the three-dimensional periodic structure explicitly, by specifying the three lattice vectors and their units.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
{
    "$schema": "http://json-schema.org/draft-04/schema#", 
    "allOf": [
        {
            "required": [
                "a", 
                "b", 
                "c"
            ], 
            "type": "object", 
            "properties": {
                "a": {
                    "description": "first vector", 
                    "title": "vector schema", 
                    "minItems": 3, 
                    "items": {
                        "type": "number"
                    }, 
                    "maxItems": 3, 
                    "type": "array"
                }, 
                "c": {
                    "description": "third vector", 
                    "title": "vector schema", 
                    "minItems": 3, 
                    "items": {
                        "type": "number"
                    }, 
                    "maxItems": 3, 
                    "type": "array"
                }, 
                "b": {
                    "description": "second vector", 
                    "title": "vector schema", 
                    "minItems": 3, 
                    "items": {
                        "type": "number"
                    }, 
                    "maxItems": 3, 
                    "type": "array"
                }
            }, 
            "title": "3 dimensional vector basis"
        }
    ], 
    "properties": {
        "units": {
            "enum": [
                "km", 
                "m", 
                "pm", 
                "nm", 
                "angstrom", 
                "a.u.", 
                "bohr", 
                "fractional", 
                "crystal", 
                "cartesian", 
                "alat"
            ]
        }, 
        "alat": {
            "default": 1.0, 
            "type": "number", 
            "description": "lattice parameter for fractional coordinates"
        }
    }, 
    "title": "lattice explicit unit"
}
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
{
    "a": [
        5.0, 
        0.000121312, 
        0.000131415
    ], 
    "units": "angstrom", 
    "c": [
        0.000121313, 
        0.000121312, 
        5.0
    ], 
    "b": [
        0.000121312, 
        5.0, 
        0.000121314
    ], 
    "alat": 1.0
}

Density

The Density of the material is defined by the sum of the atomic masses within the unit cell, divided by its volume.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
{
    "$schema": "http://json-schema.org/draft-04/schema#", 
    "allOf": [
        {
            "required": [
                "value"
            ], 
            "type": "object", 
            "properties": {
                "value": {
                    "type": "number"
                }
            }, 
            "title": "scalar schema"
        }
    ], 
    "properties": {
        "units": {
            "enum": [
                "g/cm^3"
            ]
        }, 
        "name": {
            "enum": [
                "density"
            ]
        }
    }, 
    "title": "density schema"
}
1
2
3
4
5
{
    "units": "g/cm^3", 
    "name": "density", 
    "value": 2.33
}

Elemental Ratio

The elemental ratio is given by the fraction of all atoms in a crystal which are composed of a certain element.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
{
    "$schema": "http://json-schema.org/draft-04/schema#", 
    "allOf": [
        {
            "required": [
                "value"
            ], 
            "type": "object", 
            "properties": {
                "value": {
                    "type": "number"
                }
            }, 
            "title": "scalar schema"
        }
    ], 
    "properties": {
        "name": {
            "enum": [
                "elemental_ratio"
            ]
        }, 
        "value": {
            "max": 1, 
            "min": 0
        }, 
        "element": {
            "type": "string", 
            "description": "the element this ratio is for"
        }
    }, 
    "description": "ration of this element in the compound", 
    "title": "p_norm"
}
1
2
3
4
5
{
    "name": "elemental_ratio", 
    "value": 0.71, 
    "element": "Si"
}

Magnetic Moments

The magnetic moment of ferromagnetic materials can also be computed.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
{
    "$schema": "http://json-schema.org/draft-04/schema#", 
    "properties": {
        "units": {
            "enum": [
                "uB"
            ]
        }, 
        "values": {
            "items": {
                "properties": {
                    "value": {
                        "minItems": 3, 
                        "items": {
                            "type": "number"
                        }, 
                        "type": "array", 
                        "maxItems": 3, 
                        "title": "vector schema"
                    }
                }
            }, 
            "allOf": [
                {
                    "items": {
                        "uniqueItems": true, 
                        "type": "object", 
                        "properties": {
                            "id": {
                                "type": "integer", 
                                "description": "integer id of this entry"
                            }
                        }
                    }, 
                    "type": "array", 
                    "description": "array of objects containing integer id each", 
                    "title": "atomic ids"
                }
            ], 
            "title": "atomic vectors schema"
        }, 
        "name": {
            "enum": [
                "magnetic_moments"
            ]
        }
    }, 
    "description": "magnetization on each ion", 
    "title": "magnetic moments"
}
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
{
    "units": "uB", 
    "values": [
        {
            "id": 1, 
            "value": [
                0.0, 
                0.0, 
                1.235
            ]
        }, 
        {
            "id": 2, 
            "value": [
                0.0, 
                0.0, 
                -1.235
            ]
        }
    ], 
    "name": "magnetic_moments"
}

P Norm

The P norm measures how homogeneous a material is in terms of its chemical composition.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
{
    "$schema": "http://json-schema.org/draft-04/schema#", 
    "allOf": [
        {
            "required": [
                "value"
            ], 
            "type": "object", 
            "properties": {
                "value": {
                    "type": "number"
                }
            }, 
            "title": "scalar schema"
        }
    ], 
    "properties": {
        "name": {
            "enum": [
                "p-norm"
            ]
        }, 
        "degree": {
            "type": "integer", 
            "description": "degree of the dimensionality of the norm"
        }
    }, 
    "description": "https://en.wikipedia.org/wiki/Norm_(mathematics)#p-norm", 
    "title": "p_norm"
}
1
2
3
4
5
{
    "value": 0.71, 
    "name": "p-norm", 
    "degree": 10
}

Symmetry

The Space Group of the crystal structure, indicating the symmetry elements that it contains, is also available.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
{
    "$schema": "http://json-schema.org/draft-04/schema#", 
    "properties": {
        "tolerance": {
            "properties": {
                "units": {
                    "enum": [
                        "angstrom"
                    ]
                }
            }, 
            "description": "tolerance used for symmetry calculation", 
            "allOf": [
                {
                    "required": [
                        "value"
                    ], 
                    "type": "object", 
                    "properties": {
                        "value": {
                            "type": "number"
                        }
                    }, 
                    "title": "scalar schema"
                }
            ]
        }, 
        "name": {
            "enum": [
                "symmetry"
            ]
        }, 
        "spaceGroupSymbol": {
            "type": "string", 
            "description": "space group symbol in Hermann\u2013Mauguin notation"
        }
    }, 
    "title": "symmetry schema"
}
1
2
3
4
5
6
7
8
{
    "tolerance": {
        "units": "angstrom", 
        "value": 0.3
    }, 
    "name": "symmetry", 
    "spaceGroupSymbol": "Fd-3m"
}

Volume

The volume of the unit cell is given by the scalar triple product of the lattice vectors.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
{
    "$schema": "http://json-schema.org/draft-04/schema#", 
    "allOf": [
        {
            "required": [
                "value"
            ], 
            "type": "object", 
            "properties": {
                "value": {
                    "type": "number"
                }
            }, 
            "title": "scalar schema"
        }
    ], 
    "properties": {
        "units": {
            "enum": [
                "angstrom^3"
            ]
        }, 
        "name": {
            "enum": [
                "volume"
            ]
        }
    }, 
    "title": "volume schema"
}
1
2
3
4
5
{
    "units": "angstrom^3", 
    "name": "volume", 
    "value": 131.1
}