mat3ra-esse 2025.5.17.post2__py3-none-any.whl → 2025.6.5.post0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of mat3ra-esse might be problematic. Click here for more details.

Files changed (72) hide show
  1. mat3ra/esse/data/examples.py +1 -1
  2. mat3ra/esse/data/schemas.py +1 -1
  3. mat3ra/esse/models/apse/file/applications/espresso/7.2/pw_x.py +6 -6
  4. mat3ra/esse/models/apse/materials/builders/slab/pymatgen/parameters.py +3 -3
  5. mat3ra/esse/models/core/primitive/array_of_3_integers.py +13 -0
  6. mat3ra/esse/models/core/reusable/coordinate_conditions/__init__.py +29 -1
  7. mat3ra/esse/models/core/reusable/energy.py +2 -2
  8. mat3ra/esse/models/element.py +6 -6
  9. mat3ra/esse/models/material/__init__.py +14 -14
  10. mat3ra/esse/models/materials_category/pristine_structures/three_dimensional/__init__.py +3 -0
  11. mat3ra/esse/models/materials_category/pristine_structures/three_dimensional/ideal_crystal.py +530 -0
  12. mat3ra/esse/models/materials_category/pristine_structures/two_dimensional/__init__.py +3 -0
  13. mat3ra/esse/models/materials_category/pristine_structures/two_dimensional/slab.py +730 -0
  14. mat3ra/esse/models/materials_category_components/entities/auxiliary/three_dimensional/__init__.py +3 -0
  15. mat3ra/esse/models/materials_category_components/entities/auxiliary/three_dimensional/supercell_matrix_3d.py +27 -0
  16. mat3ra/esse/models/materials_category_components/entities/auxiliary/two_dimensional/__init__.py +3 -0
  17. mat3ra/esse/models/materials_category_components/entities/auxiliary/two_dimensional/miller_indices.py +16 -0
  18. mat3ra/esse/models/materials_category_components/entities/auxiliary/two_dimensional/supercell_matrix_2d.py +25 -0
  19. mat3ra/esse/models/materials_category_components/entities/auxiliary/two_dimensional/termination.py +144 -0
  20. mat3ra/esse/models/materials_category_components/entities/auxiliary/zero_dimensional/__init__.py +3 -0
  21. mat3ra/esse/models/materials_category_components/entities/auxiliary/zero_dimensional/crystal_site.py +13 -0
  22. mat3ra/esse/models/materials_category_components/entities/core/three_dimensional/__init__.py +3 -0
  23. mat3ra/esse/models/materials_category_components/entities/core/three_dimensional/crystal.py +530 -0
  24. mat3ra/esse/models/materials_category_components/entities/core/three_dimensional/void.py +32 -0
  25. mat3ra/esse/models/materials_category_components/entities/core/two_dimensional/__init__.py +3 -0
  26. mat3ra/esse/models/materials_category_components/entities/core/two_dimensional/vacuum.py +27 -0
  27. mat3ra/esse/models/materials_category_components/entities/core/zero_dimensional/__init__.py +3 -0
  28. mat3ra/esse/models/materials_category_components/entities/core/zero_dimensional/atom.py +134 -0
  29. mat3ra/esse/models/materials_category_components/entities/reusable/__init__.py +3 -0
  30. mat3ra/esse/models/materials_category_components/entities/reusable/repetitions.py +25 -0
  31. mat3ra/esse/models/materials_category_components/entities/reusable/three_dimensional/__init__.py +3 -0
  32. mat3ra/esse/models/materials_category_components/entities/reusable/three_dimensional/strained_non_uniform.py +544 -0
  33. mat3ra/esse/models/materials_category_components/entities/reusable/three_dimensional/strained_uniform.py +541 -0
  34. mat3ra/esse/models/materials_category_components/entities/reusable/three_dimensional/supercell.py +542 -0
  35. mat3ra/esse/models/materials_category_components/entities/reusable/two_dimensional/__init__.py +3 -0
  36. mat3ra/esse/models/materials_category_components/entities/reusable/two_dimensional/atomic_layers.py +683 -0
  37. mat3ra/esse/models/materials_category_components/entities/reusable/two_dimensional/atomic_layers_unique.py +683 -0
  38. mat3ra/esse/models/materials_category_components/entities/reusable/two_dimensional/atomic_layers_unique_repeated.py +687 -0
  39. mat3ra/esse/models/materials_category_components/entities/reusable/two_dimensional/crystal_lattice_planes.py +545 -0
  40. mat3ra/esse/models/materials_category_components/entities/reusable/two_dimensional/slab_unit_cell.py +717 -0
  41. mat3ra/esse/models/materials_category_components/operations/core/combinations/__init__.py +3 -0
  42. mat3ra/esse/models/materials_category_components/operations/core/combinations/merge.py +583 -0
  43. mat3ra/esse/models/materials_category_components/operations/core/combinations/stack.py +555 -0
  44. mat3ra/esse/models/materials_category_components/operations/core/combinations/stack_component.py +554 -0
  45. mat3ra/esse/models/materials_category_components/operations/core/modifications/__init__.py +3 -0
  46. mat3ra/esse/models/materials_category_components/operations/core/modifications/repeat.py +27 -0
  47. mat3ra/esse/models/materials_category_components/operations/core/modifications/strain.py +19 -0
  48. mat3ra/esse/models/properties_directory/derived_properties.py +11 -11
  49. mat3ra/esse/models/properties_directory/non_scalar/average_potential_profile.py +2 -2
  50. mat3ra/esse/models/properties_directory/non_scalar/band_structure.py +2 -2
  51. mat3ra/esse/models/properties_directory/non_scalar/density_of_states.py +2 -2
  52. mat3ra/esse/models/properties_directory/non_scalar/phonon_dispersions.py +2 -2
  53. mat3ra/esse/models/properties_directory/non_scalar/phonon_dos.py +2 -2
  54. mat3ra/esse/models/properties_directory/non_scalar/total_energy_contributions.py +50 -50
  55. mat3ra/esse/models/properties_directory/non_scalar/vibrational_spectrum.py +2 -2
  56. mat3ra/esse/models/properties_directory/scalar/electron_affinity.py +2 -2
  57. mat3ra/esse/models/properties_directory/scalar/fermi_energy.py +2 -2
  58. mat3ra/esse/models/properties_directory/scalar/formation_energy.py +2 -2
  59. mat3ra/esse/models/properties_directory/scalar/ionization_potential.py +2 -2
  60. mat3ra/esse/models/properties_directory/scalar/reaction_energy_barrier.py +2 -2
  61. mat3ra/esse/models/properties_directory/scalar/surface_energy.py +2 -2
  62. mat3ra/esse/models/properties_directory/scalar/total_energy.py +2 -2
  63. mat3ra/esse/models/properties_directory/scalar/valence_band_offset.py +2 -2
  64. mat3ra/esse/models/properties_directory/scalar/zero_point_energy.py +2 -2
  65. mat3ra/esse/models/properties_directory/structural/basis/__init__.py +2 -2
  66. mat3ra/esse/models/properties_directory/structural/molecular_pattern.py +4 -4
  67. mat3ra/esse/models/properties_directory/workflow/convergence/ionic.py +2 -2
  68. {mat3ra_esse-2025.5.17.post2.dist-info → mat3ra_esse-2025.6.5.post0.dist-info}/METADATA +1 -1
  69. {mat3ra_esse-2025.5.17.post2.dist-info → mat3ra_esse-2025.6.5.post0.dist-info}/RECORD +72 -33
  70. {mat3ra_esse-2025.5.17.post2.dist-info → mat3ra_esse-2025.6.5.post0.dist-info}/WHEEL +1 -1
  71. {mat3ra_esse-2025.5.17.post2.dist-info → mat3ra_esse-2025.6.5.post0.dist-info}/licenses/LICENSE.md +0 -0
  72. {mat3ra_esse-2025.5.17.post2.dist-info → mat3ra_esse-2025.6.5.post0.dist-info}/top_level.txt +0 -0
@@ -0,0 +1,3 @@
1
+ # generated by datamodel-codegen:
2
+ # filename: schema
3
+ # version: 0.28.5
@@ -0,0 +1,27 @@
1
+ # generated by datamodel-codegen:
2
+ # filename: materials_category_components/entities/auxiliary/three_dimensional/supercell_matrix_3d.json
3
+ # version: 0.28.5
4
+
5
+ from __future__ import annotations
6
+
7
+ from typing import List, Optional
8
+
9
+ from pydantic import Field, RootModel
10
+
11
+
12
+ class ArrayOf3IntegerElementsSchema(RootModel[List[int]]):
13
+ root: List[int] = Field(..., title="array of 3 integer elements schema")
14
+
15
+
16
+ class SupercellMatrix3DSchema(RootModel[Optional[List[ArrayOf3IntegerElementsSchema]]]):
17
+ root: Optional[List[ArrayOf3IntegerElementsSchema]] = Field(
18
+ default_factory=lambda: [
19
+ ArrayOf3IntegerElementsSchema.model_validate(v) for v in [[1, 0, 0], [0, 1, 0], [0, 0, 1]]
20
+ ],
21
+ max_length=3,
22
+ min_length=3,
23
+ title="Supercell Matrix 3D Schema",
24
+ )
25
+ """
26
+ 3x3 matrix of integers for transforming a unit cell into a supercell
27
+ """
@@ -0,0 +1,3 @@
1
+ # generated by datamodel-codegen:
2
+ # filename: schema
3
+ # version: 0.28.5
@@ -0,0 +1,16 @@
1
+ # generated by datamodel-codegen:
2
+ # filename: materials_category_components/entities/auxiliary/two_dimensional/miller_indices.json
3
+ # version: 0.28.5
4
+
5
+ from __future__ import annotations
6
+
7
+ from typing import List, Optional
8
+
9
+ from pydantic import Field, RootModel
10
+
11
+
12
+ class MillerIndicesSchema(RootModel[Optional[List[int]]]):
13
+ root: Optional[List[int]] = Field([0, 0, 1], max_length=3, min_length=3, title="Miller Indices Schema")
14
+ """
15
+ Miller indices [h, k, l] defining crystallographic planes
16
+ """
@@ -0,0 +1,25 @@
1
+ # generated by datamodel-codegen:
2
+ # filename: materials_category_components/entities/auxiliary/two_dimensional/supercell_matrix_2d.json
3
+ # version: 0.28.5
4
+
5
+ from __future__ import annotations
6
+
7
+ from typing import List, Optional
8
+
9
+ from pydantic import Field, RootModel
10
+
11
+
12
+ class SupercellMatrix2DSchemaItem(RootModel[List[int]]):
13
+ root: List[int]
14
+
15
+
16
+ class SupercellMatrix2DSchema(RootModel[Optional[List[SupercellMatrix2DSchemaItem]]]):
17
+ root: Optional[List[SupercellMatrix2DSchemaItem]] = Field(
18
+ default_factory=lambda: [SupercellMatrix2DSchemaItem.model_validate(v) for v in [[1, 0], [0, 1]]],
19
+ max_length=2,
20
+ min_length=2,
21
+ title="Supercell Matrix 2D Schema",
22
+ )
23
+ """
24
+ Supercell matrix for xy plane transformations
25
+ """
@@ -0,0 +1,144 @@
1
+ # generated by datamodel-codegen:
2
+ # filename: materials_category_components/entities/auxiliary/two_dimensional/termination.json
3
+ # version: 0.28.5
4
+
5
+ from __future__ import annotations
6
+
7
+ from enum import Enum
8
+ from typing import Union
9
+
10
+ from pydantic import BaseModel, Field, constr
11
+
12
+
13
+ class ChemicalElements(Enum):
14
+ H = "H"
15
+ He = "He"
16
+ Li = "Li"
17
+ Be = "Be"
18
+ B = "B"
19
+ C = "C"
20
+ N = "N"
21
+ O = "O"
22
+ F = "F"
23
+ Ne = "Ne"
24
+ Na = "Na"
25
+ Mg = "Mg"
26
+ Al = "Al"
27
+ Si = "Si"
28
+ P = "P"
29
+ S = "S"
30
+ Cl = "Cl"
31
+ Ar = "Ar"
32
+ K = "K"
33
+ Ca = "Ca"
34
+ Sc = "Sc"
35
+ Ti = "Ti"
36
+ V = "V"
37
+ Cr = "Cr"
38
+ Mn = "Mn"
39
+ Fe = "Fe"
40
+ Co = "Co"
41
+ Ni = "Ni"
42
+ Cu = "Cu"
43
+ Zn = "Zn"
44
+ Ga = "Ga"
45
+ Ge = "Ge"
46
+ As = "As"
47
+ Se = "Se"
48
+ Br = "Br"
49
+ Kr = "Kr"
50
+ Rb = "Rb"
51
+ Sr = "Sr"
52
+ Y = "Y"
53
+ Zr = "Zr"
54
+ Nb = "Nb"
55
+ Mo = "Mo"
56
+ Tc = "Tc"
57
+ Ru = "Ru"
58
+ Rh = "Rh"
59
+ Pd = "Pd"
60
+ Ag = "Ag"
61
+ Cd = "Cd"
62
+ In = "In"
63
+ Sn = "Sn"
64
+ Sb = "Sb"
65
+ Te = "Te"
66
+ I = "I"
67
+ Xe = "Xe"
68
+ Cs = "Cs"
69
+ Ba = "Ba"
70
+ La = "La"
71
+ Ce = "Ce"
72
+ Pr = "Pr"
73
+ Nd = "Nd"
74
+ Pm = "Pm"
75
+ Sm = "Sm"
76
+ Eu = "Eu"
77
+ Gd = "Gd"
78
+ Tb = "Tb"
79
+ Dy = "Dy"
80
+ Ho = "Ho"
81
+ Er = "Er"
82
+ Tm = "Tm"
83
+ Yb = "Yb"
84
+ Lu = "Lu"
85
+ Hf = "Hf"
86
+ Ta = "Ta"
87
+ W = "W"
88
+ Re = "Re"
89
+ Os = "Os"
90
+ Ir = "Ir"
91
+ Pt = "Pt"
92
+ Au = "Au"
93
+ Hg = "Hg"
94
+ Tl = "Tl"
95
+ Pb = "Pb"
96
+ Bi = "Bi"
97
+ Po = "Po"
98
+ At = "At"
99
+ Rn = "Rn"
100
+ Fr = "Fr"
101
+ Ra = "Ra"
102
+ Ac = "Ac"
103
+ Th = "Th"
104
+ Pa = "Pa"
105
+ U = "U"
106
+ Np = "Np"
107
+ Pu = "Pu"
108
+ Am = "Am"
109
+ Cm = "Cm"
110
+ Bk = "Bk"
111
+ Cf = "Cf"
112
+ Es = "Es"
113
+ Fm = "Fm"
114
+ Md = "Md"
115
+ No = "No"
116
+ Lr = "Lr"
117
+ Rf = "Rf"
118
+ Db = "Db"
119
+ Sg = "Sg"
120
+ Bh = "Bh"
121
+ Hs = "Hs"
122
+ Mt = "Mt"
123
+ Ds = "Ds"
124
+ Rg = "Rg"
125
+ Cn = "Cn"
126
+ Nh = "Nh"
127
+ Fl = "Fl"
128
+ Mc = "Mc"
129
+ Lv = "Lv"
130
+ Ts = "Ts"
131
+ Og = "Og"
132
+
133
+
134
+ class TerminationSchema(BaseModel):
135
+ chemical_elements: Union[ChemicalElements, constr(pattern=r"^[A-Z][a-z]?([A-Z][a-z]?)*$")] = Field(
136
+ ..., title="Chemical Elements"
137
+ )
138
+ """
139
+ Chemical elements at the termination. Can be a single element (e.g. 'Si') or a compound (e.g. 'SiO')
140
+ """
141
+ space_group_symmetry_label: str = Field(..., title="Space Group Symmetry Label")
142
+ """
143
+ Space group symmetry designation for the termination
144
+ """
@@ -0,0 +1,3 @@
1
+ # generated by datamodel-codegen:
2
+ # filename: schema
3
+ # version: 0.28.5
@@ -0,0 +1,13 @@
1
+ # generated by datamodel-codegen:
2
+ # filename: materials_category_components/entities/auxiliary/zero_dimensional/crystal_site.json
3
+ # version: 0.28.5
4
+
5
+ from __future__ import annotations
6
+
7
+ from typing import List
8
+
9
+ from pydantic import BaseModel, Field
10
+
11
+
12
+ class CrystalSiteSchema(BaseModel):
13
+ coordinate: List[float] = Field(..., max_length=3, min_length=3, title="coordinate 3d schema")
@@ -0,0 +1,3 @@
1
+ # generated by datamodel-codegen:
2
+ # filename: schema
3
+ # version: 0.28.5