mat3ra-esse 2025.7.1.post0__py3-none-any.whl → 2025.7.29.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 (99) 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/core/abstract/vector_2d.py +13 -0
  5. mat3ra/esse/models/core/primitive/array_of_2_numbers.py +13 -0
  6. mat3ra/esse/models/core/reusable/energy.py +2 -2
  7. mat3ra/esse/models/element.py +6 -6
  8. mat3ra/esse/models/job/__init__.py +8 -0
  9. mat3ra/esse/models/material/__init__.py +14 -14
  10. mat3ra/esse/models/materials_category/compound_pristine_structures/two_dimensional/interface/__init__.py +3 -0
  11. mat3ra/esse/models/materials_category/compound_pristine_structures/two_dimensional/interface/configuration.py +6039 -0
  12. mat3ra/esse/models/materials_category/defective_structures/one_dimensional/grain_boundary_linear/__init__.py +3 -0
  13. mat3ra/esse/models/materials_category/defective_structures/one_dimensional/grain_boundary_linear/configuration.py +6043 -0
  14. mat3ra/esse/models/materials_category/defective_structures/two_dimensional/__init__.py +3 -0
  15. mat3ra/esse/models/materials_category/defective_structures/two_dimensional/adatom/__init__.py +3 -0
  16. mat3ra/esse/models/materials_category/defective_structures/two_dimensional/adatom/configuration.py +2116 -0
  17. mat3ra/esse/models/materials_category/defective_structures/two_dimensional/base_configuration.py +1561 -0
  18. mat3ra/esse/models/materials_category/defective_structures/two_dimensional/grain_boundary_planar/__init__.py +3 -0
  19. mat3ra/esse/models/materials_category/defective_structures/two_dimensional/grain_boundary_planar/configuration.py +6039 -0
  20. mat3ra/esse/models/materials_category/defective_structures/two_dimensional/island/__init__.py +3 -0
  21. mat3ra/esse/models/materials_category/defective_structures/two_dimensional/island/configuration.py +2888 -0
  22. mat3ra/esse/models/materials_category/defective_structures/two_dimensional/terrace/__init__.py +3 -0
  23. mat3ra/esse/models/materials_category/defective_structures/two_dimensional/terrace/configuration.py +2892 -0
  24. mat3ra/esse/models/materials_category/defective_structures/zero_dimensional/point_defect/__init__.py +3 -0
  25. mat3ra/esse/models/materials_category/defective_structures/zero_dimensional/point_defect/base_configuration.py +544 -0
  26. mat3ra/esse/models/materials_category/defective_structures/zero_dimensional/point_defect/interstitial.py +1099 -0
  27. mat3ra/esse/models/materials_category/defective_structures/zero_dimensional/point_defect/substitutional.py +1099 -0
  28. mat3ra/esse/models/materials_category/defective_structures/zero_dimensional/point_defect/vacancy.py +556 -0
  29. mat3ra/esse/models/materials_category/pristine_structures/three_dimensional/ideal_crystal.py +14 -14
  30. mat3ra/esse/models/materials_category/pristine_structures/two_dimensional/nanoribbon.py +1582 -0
  31. mat3ra/esse/models/materials_category/pristine_structures/two_dimensional/nanotape.py +1148 -0
  32. mat3ra/esse/models/materials_category/pristine_structures/two_dimensional/slab.py +78 -94
  33. mat3ra/esse/models/materials_category/pristine_structures/two_dimensional/slab_strained_supercell.py +1147 -0
  34. mat3ra/esse/models/materials_category/pristine_structures/two_dimensional/slab_strained_supercell_with_gap.py +1151 -0
  35. mat3ra/esse/models/materials_category/processed_structures/two_dimensional/passivation/__init__.py +3 -0
  36. mat3ra/esse/models/materials_category/processed_structures/two_dimensional/passivation/configuration.py +1232 -0
  37. mat3ra/esse/models/materials_category_components/entities/auxiliary/one_dimensional/__init__.py +3 -0
  38. mat3ra/esse/models/materials_category_components/entities/auxiliary/one_dimensional/miller_indices_2d.py +16 -0
  39. mat3ra/esse/models/materials_category_components/entities/auxiliary/zero_dimensional/crystal_site.py +527 -2
  40. mat3ra/esse/models/materials_category_components/entities/auxiliary/zero_dimensional/point_defect_site.py +676 -0
  41. mat3ra/esse/models/materials_category_components/entities/auxiliary/zero_dimensional/void_region.py +555 -0
  42. mat3ra/esse/models/materials_category_components/entities/auxiliary/zero_dimensional/void_site.py +1576 -0
  43. mat3ra/esse/models/materials_category_components/entities/core/three_dimensional/crystal.py +14 -14
  44. mat3ra/esse/models/materials_category_components/entities/core/two_dimensional/vacuum.py +14 -14
  45. mat3ra/esse/models/materials_category_components/entities/core/zero_dimensional/vacancy.py +22 -0
  46. mat3ra/esse/models/materials_category_components/entities/reusable/one_dimensional/__init__.py +3 -0
  47. mat3ra/esse/models/materials_category_components/entities/reusable/one_dimensional/crystal_lattice_base.py +541 -0
  48. mat3ra/esse/models/materials_category_components/entities/reusable/one_dimensional/crystal_lattice_lines.py +545 -0
  49. mat3ra/esse/models/materials_category_components/entities/reusable/one_dimensional/crystal_lattice_lines_unique_repeated.py +708 -0
  50. mat3ra/esse/models/materials_category_components/entities/reusable/three_dimensional/crystal_lattice_base.py +541 -0
  51. mat3ra/esse/models/materials_category_components/entities/reusable/three_dimensional/strained_non_uniform.py +14 -14
  52. mat3ra/esse/models/materials_category_components/entities/reusable/three_dimensional/strained_uniform.py +14 -14
  53. mat3ra/esse/models/materials_category_components/entities/reusable/three_dimensional/supercell.py +14 -14
  54. mat3ra/esse/models/materials_category_components/entities/reusable/two_dimensional/atomic_layers.py +4 -4
  55. mat3ra/esse/models/materials_category_components/entities/reusable/two_dimensional/atomic_layers_unique.py +4 -4
  56. mat3ra/esse/models/materials_category_components/entities/reusable/two_dimensional/atomic_layers_unique_repeated.py +4 -4
  57. mat3ra/esse/models/materials_category_components/entities/reusable/two_dimensional/crystal_lattice_planes.py +18 -18
  58. mat3ra/esse/models/materials_category_components/entities/reusable/two_dimensional/slab_stack_configuration.py +1561 -0
  59. mat3ra/esse/models/materials_category_components/entities/reusable/two_dimensional/slab_unit_cell.py +74 -77
  60. mat3ra/esse/models/materials_category_components/operations/core/combinations/enums.py +13 -0
  61. mat3ra/esse/models/materials_category_components/operations/core/combinations/merge.py +9 -981
  62. mat3ra/esse/models/materials_category_components/operations/core/combinations/stack.py +3 -947
  63. mat3ra/esse/models/materials_category_components/operations/core/modifications/perturb.py +538 -0
  64. mat3ra/esse/models/properties_directory/derived_properties.py +11 -11
  65. mat3ra/esse/models/properties_directory/non_scalar/density_of_states.py +2 -2
  66. mat3ra/esse/models/properties_directory/non_scalar/phonon_dispersions.py +2 -2
  67. mat3ra/esse/models/properties_directory/non_scalar/phonon_dos.py +2 -2
  68. mat3ra/esse/models/properties_directory/non_scalar/total_energy_contributions.py +50 -50
  69. mat3ra/esse/models/properties_directory/non_scalar/vibrational_spectrum.py +2 -2
  70. mat3ra/esse/models/properties_directory/scalar/electron_affinity.py +2 -2
  71. mat3ra/esse/models/properties_directory/scalar/fermi_energy.py +2 -2
  72. mat3ra/esse/models/properties_directory/scalar/formation_energy.py +2 -2
  73. mat3ra/esse/models/properties_directory/scalar/ionization_potential.py +2 -2
  74. mat3ra/esse/models/properties_directory/scalar/reaction_energy_barrier.py +2 -2
  75. mat3ra/esse/models/properties_directory/scalar/surface_energy.py +2 -2
  76. mat3ra/esse/models/properties_directory/scalar/total_energy.py +2 -2
  77. mat3ra/esse/models/properties_directory/scalar/valence_band_offset.py +2 -2
  78. mat3ra/esse/models/properties_directory/scalar/zero_point_energy.py +2 -2
  79. mat3ra/esse/models/properties_directory/structural/basis/__init__.py +2 -2
  80. mat3ra/esse/models/properties_directory/structural/molecular_pattern.py +4 -4
  81. mat3ra/esse/models/properties_directory/workflow/convergence/ionic.py +2 -2
  82. mat3ra/esse/models/software/flavor.py +4 -0
  83. mat3ra/esse/models/software_directory/ml/unit/execution/__init__.py +16 -0
  84. mat3ra/esse/models/software_directory/ml/unit/execution/evaluate/cross_validate.py +4 -0
  85. mat3ra/esse/models/software_directory/ml/unit/execution/initialize.py +4 -0
  86. mat3ra/esse/models/software_directory/ml/unit/execution/score.py +4 -0
  87. mat3ra/esse/models/software_directory/ml/unit/execution/train.py +4 -0
  88. mat3ra/esse/models/software_directory/modeling/unit/execution.py +4 -0
  89. mat3ra/esse/models/software_directory/scripting/unit/execution.py +4 -0
  90. mat3ra/esse/models/workflow/__init__.py +8 -0
  91. mat3ra/esse/models/workflow/subworkflow/__init__.py +4 -0
  92. mat3ra/esse/models/workflow/subworkflow/unit.py +4 -0
  93. mat3ra/esse/models/workflow/unit/__init__.py +4 -0
  94. mat3ra/esse/models/workflow/unit/execution.py +4 -0
  95. {mat3ra_esse-2025.7.1.post0.dist-info → mat3ra_esse-2025.7.29.post0.dist-info}/METADATA +5 -5
  96. {mat3ra_esse-2025.7.1.post0.dist-info → mat3ra_esse-2025.7.29.post0.dist-info}/RECORD +99 -58
  97. {mat3ra_esse-2025.7.1.post0.dist-info → mat3ra_esse-2025.7.29.post0.dist-info}/WHEEL +0 -0
  98. {mat3ra_esse-2025.7.1.post0.dist-info → mat3ra_esse-2025.7.29.post0.dist-info}/licenses/LICENSE.md +0 -0
  99. {mat3ra_esse-2025.7.1.post0.dist-info → mat3ra_esse-2025.7.29.post0.dist-info}/top_level.txt +0 -0
@@ -131,13 +131,13 @@ class Value(Enum):
131
131
  Og = "Og"
132
132
 
133
133
 
134
- class Value51(Enum):
134
+ class Value191(Enum):
135
135
  X = "X"
136
136
  Vac = "Vac"
137
137
 
138
138
 
139
139
  class AtomicElementSchema(BaseModel):
140
- value: Union[Value, Value51]
140
+ value: Union[Value, Value191]
141
141
  """
142
142
  All elements, including extra elements
143
143
  """
@@ -285,30 +285,30 @@ class VolumeSchema(BaseModel):
285
285
  value: float
286
286
 
287
287
 
288
- class Name206(Enum):
288
+ class Name766(Enum):
289
289
  density = "density"
290
290
 
291
291
 
292
- class Units99(Enum):
292
+ class Units309(Enum):
293
293
  g_cm_3 = "g/cm^3"
294
294
 
295
295
 
296
296
  class DensitySchema(BaseModel):
297
297
  name: Literal["1#-datamodel-code-generator-#-object-#-special-#"]
298
- units: Optional[Units99] = None
298
+ units: Optional[Units309] = None
299
299
  value: float
300
300
 
301
301
 
302
- class Units100(Enum):
302
+ class Units310(Enum):
303
303
  angstrom = "angstrom"
304
304
 
305
305
 
306
306
  class ScalarSchema(BaseModel):
307
- units: Optional[Units100] = None
307
+ units: Optional[Units310] = None
308
308
  value: float
309
309
 
310
310
 
311
- class Name207(Enum):
311
+ class Name767(Enum):
312
312
  symmetry = "symmetry"
313
313
 
314
314
 
@@ -328,7 +328,7 @@ class SymmetrySchema(BaseModel):
328
328
  name: Literal["2#-datamodel-code-generator-#-object-#-special-#"]
329
329
 
330
330
 
331
- class Name208(Enum):
331
+ class Name768(Enum):
332
332
  elemental_ratio = "elemental_ratio"
333
333
 
334
334
 
@@ -341,7 +341,7 @@ class ElementalRatio(BaseModel):
341
341
  """
342
342
 
343
343
 
344
- class Name209(Enum):
344
+ class Name769(Enum):
345
345
  p_norm = "p-norm"
346
346
 
347
347
 
@@ -354,7 +354,7 @@ class PNorm(BaseModel):
354
354
  value: float
355
355
 
356
356
 
357
- class Name210(Enum):
357
+ class Name770(Enum):
358
358
  inchi = "inchi"
359
359
 
360
360
 
@@ -363,7 +363,7 @@ class InChIRepresentationSchema(BaseModel):
363
363
  value: str
364
364
 
365
365
 
366
- class Name211(Enum):
366
+ class Name771(Enum):
367
367
  inchi_key = "inchi_key"
368
368
 
369
369
 
@@ -442,7 +442,7 @@ class FileSourceSchema(BaseModel):
442
442
  """
443
443
 
444
444
 
445
- class Name212(Enum):
445
+ class Name772(Enum):
446
446
  default = "default"
447
447
  atomsTooClose = "atomsTooClose"
448
448
  atomsOverlap = "atomsOverlap"
@@ -455,7 +455,7 @@ class Severity(Enum):
455
455
 
456
456
 
457
457
  class MaterialConsistencyCheckSchema(BaseModel):
458
- name: Name212
458
+ name: Name772
459
459
  """
460
460
  Name of the consistency check that is performed, which is listed in an enum.
461
461
  """
@@ -131,13 +131,13 @@ class Value(Enum):
131
131
  Og = "Og"
132
132
 
133
133
 
134
- class Value53(Enum):
134
+ class Value197(Enum):
135
135
  X = "X"
136
136
  Vac = "Vac"
137
137
 
138
138
 
139
139
  class AtomicElementSchema(BaseModel):
140
- value: Union[Value, Value53]
140
+ value: Union[Value, Value197]
141
141
  """
142
142
  All elements, including extra elements
143
143
  """
@@ -285,30 +285,30 @@ class VolumeSchema(BaseModel):
285
285
  value: float
286
286
 
287
287
 
288
- class Name215(Enum):
288
+ class Name791(Enum):
289
289
  density = "density"
290
290
 
291
291
 
292
- class Units103(Enum):
292
+ class Units319(Enum):
293
293
  g_cm_3 = "g/cm^3"
294
294
 
295
295
 
296
296
  class DensitySchema(BaseModel):
297
297
  name: Literal["1#-datamodel-code-generator-#-object-#-special-#"]
298
- units: Optional[Units103] = None
298
+ units: Optional[Units319] = None
299
299
  value: float
300
300
 
301
301
 
302
- class Units104(Enum):
302
+ class Units320(Enum):
303
303
  angstrom = "angstrom"
304
304
 
305
305
 
306
306
  class ScalarSchema(BaseModel):
307
- units: Optional[Units104] = None
307
+ units: Optional[Units320] = None
308
308
  value: float
309
309
 
310
310
 
311
- class Name216(Enum):
311
+ class Name792(Enum):
312
312
  symmetry = "symmetry"
313
313
 
314
314
 
@@ -328,7 +328,7 @@ class SymmetrySchema(BaseModel):
328
328
  name: Literal["2#-datamodel-code-generator-#-object-#-special-#"]
329
329
 
330
330
 
331
- class Name217(Enum):
331
+ class Name793(Enum):
332
332
  elemental_ratio = "elemental_ratio"
333
333
 
334
334
 
@@ -341,7 +341,7 @@ class ElementalRatio(BaseModel):
341
341
  """
342
342
 
343
343
 
344
- class Name218(Enum):
344
+ class Name794(Enum):
345
345
  p_norm = "p-norm"
346
346
 
347
347
 
@@ -354,7 +354,7 @@ class PNorm(BaseModel):
354
354
  value: float
355
355
 
356
356
 
357
- class Name219(Enum):
357
+ class Name795(Enum):
358
358
  inchi = "inchi"
359
359
 
360
360
 
@@ -363,7 +363,7 @@ class InChIRepresentationSchema(BaseModel):
363
363
  value: str
364
364
 
365
365
 
366
- class Name220(Enum):
366
+ class Name796(Enum):
367
367
  inchi_key = "inchi_key"
368
368
 
369
369
 
@@ -442,7 +442,7 @@ class FileSourceSchema(BaseModel):
442
442
  """
443
443
 
444
444
 
445
- class Name221(Enum):
445
+ class Name797(Enum):
446
446
  default = "default"
447
447
  atomsTooClose = "atomsTooClose"
448
448
  atomsOverlap = "atomsOverlap"
@@ -455,7 +455,7 @@ class Severity(Enum):
455
455
 
456
456
 
457
457
  class MaterialConsistencyCheckSchema(BaseModel):
458
- name: Name221
458
+ name: Name797
459
459
  """
460
460
  Name of the consistency check that is performed, which is listed in an enum.
461
461
  """
@@ -669,14 +669,14 @@ class AtomicLayersSchema(BaseModel):
669
669
  """
670
670
  All possible terminations for this orientation.
671
671
  """
672
- crystal: CrystalSchema = Field(..., title="Crystal Schema")
673
- """
674
- A crystal structure, referencing the base material schema
675
- """
676
672
  miller_indices: Optional[List[int]] = Field([0, 0, 1], max_length=3, min_length=3, title="Miller Indices Schema")
677
673
  """
678
674
  Miller indices [h, k, l] defining crystallographic planes
679
675
  """
676
+ crystal: CrystalSchema = Field(..., title="Crystal Schema")
677
+ """
678
+ A crystal structure, referencing the base material schema
679
+ """
680
680
  use_conventional_cell: Optional[bool] = True
681
681
  """
682
682
  Use the conventional cell for the crystal structure
@@ -669,14 +669,14 @@ class AtomicLayersUniqueSchema(BaseModel):
669
669
  """
670
670
  All possible terminations for this orientation.
671
671
  """
672
- crystal: CrystalSchema = Field(..., title="Crystal Schema")
673
- """
674
- A crystal structure, referencing the base material schema
675
- """
676
672
  miller_indices: Optional[List[int]] = Field([0, 0, 1], max_length=3, min_length=3, title="Miller Indices Schema")
677
673
  """
678
674
  Miller indices [h, k, l] defining crystallographic planes
679
675
  """
676
+ crystal: CrystalSchema = Field(..., title="Crystal Schema")
677
+ """
678
+ A crystal structure, referencing the base material schema
679
+ """
680
680
  use_conventional_cell: Optional[bool] = True
681
681
  """
682
682
  Use the conventional cell for the crystal structure
@@ -673,14 +673,14 @@ class AtomicLayersUniqueRepeatedSchema(BaseModel):
673
673
  """
674
674
  Number of repetitions of the unique atomic layers
675
675
  """
676
- crystal: CrystalSchema = Field(..., title="Crystal Schema")
677
- """
678
- A crystal structure, referencing the base material schema
679
- """
680
676
  miller_indices: Optional[List[int]] = Field([0, 0, 1], max_length=3, min_length=3, title="Miller Indices Schema")
681
677
  """
682
678
  Miller indices [h, k, l] defining crystallographic planes
683
679
  """
680
+ crystal: CrystalSchema = Field(..., title="Crystal Schema")
681
+ """
682
+ A crystal structure, referencing the base material schema
683
+ """
684
684
  use_conventional_cell: Optional[bool] = True
685
685
  """
686
686
  Use the conventional cell for the crystal structure
@@ -131,13 +131,13 @@ class Value(Enum):
131
131
  Og = "Og"
132
132
 
133
133
 
134
- class Value17(Enum):
134
+ class Value139(Enum):
135
135
  X = "X"
136
136
  Vac = "Vac"
137
137
 
138
138
 
139
139
  class AtomicElementSchema(BaseModel):
140
- value: Union[Value, Value17]
140
+ value: Union[Value, Value139]
141
141
  """
142
142
  All elements, including extra elements
143
143
  """
@@ -285,30 +285,30 @@ class VolumeSchema(BaseModel):
285
285
  value: float
286
286
 
287
287
 
288
- class Name41(Enum):
288
+ class Name529(Enum):
289
289
  density = "density"
290
290
 
291
291
 
292
- class Units22(Enum):
292
+ class Units205(Enum):
293
293
  g_cm_3 = "g/cm^3"
294
294
 
295
295
 
296
296
  class DensitySchema(BaseModel):
297
297
  name: Literal["1#-datamodel-code-generator-#-object-#-special-#"]
298
- units: Optional[Units22] = None
298
+ units: Optional[Units205] = None
299
299
  value: float
300
300
 
301
301
 
302
- class Units23(Enum):
302
+ class Units206(Enum):
303
303
  angstrom = "angstrom"
304
304
 
305
305
 
306
306
  class ScalarSchema(BaseModel):
307
- units: Optional[Units23] = None
307
+ units: Optional[Units206] = None
308
308
  value: float
309
309
 
310
310
 
311
- class Name42(Enum):
311
+ class Name530(Enum):
312
312
  symmetry = "symmetry"
313
313
 
314
314
 
@@ -328,7 +328,7 @@ class SymmetrySchema(BaseModel):
328
328
  name: Literal["2#-datamodel-code-generator-#-object-#-special-#"]
329
329
 
330
330
 
331
- class Name43(Enum):
331
+ class Name531(Enum):
332
332
  elemental_ratio = "elemental_ratio"
333
333
 
334
334
 
@@ -341,7 +341,7 @@ class ElementalRatio(BaseModel):
341
341
  """
342
342
 
343
343
 
344
- class Name44(Enum):
344
+ class Name532(Enum):
345
345
  p_norm = "p-norm"
346
346
 
347
347
 
@@ -354,7 +354,7 @@ class PNorm(BaseModel):
354
354
  value: float
355
355
 
356
356
 
357
- class Name45(Enum):
357
+ class Name533(Enum):
358
358
  inchi = "inchi"
359
359
 
360
360
 
@@ -363,7 +363,7 @@ class InChIRepresentationSchema(BaseModel):
363
363
  value: str
364
364
 
365
365
 
366
- class Name46(Enum):
366
+ class Name534(Enum):
367
367
  inchi_key = "inchi_key"
368
368
 
369
369
 
@@ -442,7 +442,7 @@ class FileSourceSchema(BaseModel):
442
442
  """
443
443
 
444
444
 
445
- class Name47(Enum):
445
+ class Name535(Enum):
446
446
  default = "default"
447
447
  atomsTooClose = "atomsTooClose"
448
448
  atomsOverlap = "atomsOverlap"
@@ -455,7 +455,7 @@ class Severity(Enum):
455
455
 
456
456
 
457
457
  class MaterialConsistencyCheckSchema(BaseModel):
458
- name: Name47
458
+ name: Name535
459
459
  """
460
460
  Name of the consistency check that is performed, which is listed in an enum.
461
461
  """
@@ -531,14 +531,14 @@ class CrystalSchema(BaseModel):
531
531
 
532
532
 
533
533
  class CrystalLatticePlanesSchema(BaseModel):
534
- crystal: CrystalSchema = Field(..., title="Crystal Schema")
535
- """
536
- A crystal structure, referencing the base material schema
537
- """
538
534
  miller_indices: Optional[List[int]] = Field([0, 0, 1], max_length=3, min_length=3, title="Miller Indices Schema")
539
535
  """
540
536
  Miller indices [h, k, l] defining crystallographic planes
541
537
  """
538
+ crystal: CrystalSchema = Field(..., title="Crystal Schema")
539
+ """
540
+ A crystal structure, referencing the base material schema
541
+ """
542
542
  use_conventional_cell: Optional[bool] = True
543
543
  """
544
544
  Use the conventional cell for the crystal structure