core
Core recipes for universal machine-learned interatomic potentials.
relax_job ¶
relax_job(
atoms: Atoms,
method: Literal["mace-mp-0", "m3gnet", "chgnet"],
relax_cell: bool = False,
opt_params: OptParams | None = None,
**calc_kwargs
) -> OptSchema
Relax a structure.
Parameters:
-
atoms
(Atoms
) –Atoms object
-
method
(Literal['mace-mp-0', 'm3gnet', 'chgnet']
) –Universal ML interatomic potential method to use
-
relax_cell
(bool
, default:False
) –Whether to relax the cell.
-
opt_params
(OptParams | None
, default:None
) –Dictionary of custom kwargs for the optimization process. For a list of available keys, refer to quacc.runners.ase.run_opt.
-
**calc_kwargs
–Custom kwargs for the underlying calculator. Set a value to
quacc.Remove
to remove a pre-existing key entirely. For a list of available keys, refer to themace.calculators.mace_mp
,chgnet.model.dynamics.CHGNetCalculator
, ormatgl.ext.ase.M3GNetCalculator
calculators.
Returns:
-
OptSchema
–Dictionary of results from quacc.schemas.ase.summarize_opt_run. See the type-hint for the data structure.
Source code in quacc/recipes/mlp/core.py
static_job ¶
static_job(
atoms: Atoms,
method: Literal["mace-mp-0", "m3gnet", "chgnet"],
**calc_kwargs
) -> RunSchema
Carry out a single-point calculation.
Parameters:
-
atoms
(Atoms
) –Atoms object
-
method
(Literal['mace-mp-0', 'm3gnet', 'chgnet']
) –Universal ML interatomic potential method to use
-
**calc_kwargs
–Custom kwargs for the underlying calculator. Set a value to
quacc.Remove
to remove a pre-existing key entirely. For a list of available keys, refer to themace.calculators.mace_mp
,chgnet.model.dynamics.CHGNetCalculator
, ormatgl.ext.ase.M3GNetCalculator
calculators.
Returns:
-
RunSchema
–Dictionary of results from quacc.schemas.ase.summarize_run. See the type-hint for the data structure.