_base
Base jobs for espresso.
prepare_atoms ¶
prepare_atoms(
atoms: Atoms | None = None,
preset: str | None = None,
template: EspressoTemplate | None = None,
profile: EspressoProfile | None = None,
calc_defaults: dict[str, Any] | None = None,
calc_swaps: dict[str, Any] | None = None,
parallel_info: dict[str, Any] | None = None,
) -> Atoms
Commonly used preparation function to merge parameters and attach an Espresso calculator accordingly.
Parameters:
-
atoms
(Atoms | None
, default:None
) –Atoms object
-
preset
(str | None
, default:None
) –Name of the preset to use
-
template
(EspressoTemplate | None
, default:None
) –EspressoTemplate to use
-
profile
(EspressoProfile | None
, default:None
) –EspressoProfile to use
-
calc_defaults
(dict[str, Any] | None
, default:None
) –The default calculator parameters.
-
calc_swaps
(dict[str, Any] | None
, default:None
) –Custom kwargs for the espresso calculator. Set a value to
quacc.Remove
to remove a pre-existing key entirely. For a list of available keys, refer to the ase.calculators.espresso.Espresso calculator. -
parallel_info
(dict[str, Any] | None
, default:None
) –Dictionary of parallelization information.
Returns:
-
Atoms
–Atoms object with attached Espresso calculator.
Source code in quacc/recipes/espresso/_base.py
prepare_copy ¶
prepare_copy(
copy_files: (
SourceDirectory
| list[SourceDirectory]
| dict[SourceDirectory, Filenames]
| None
) = None,
calc_params: dict[str, Any] | None = None,
binary: str = "pw",
) -> dict[SourceDirectory, Filenames] | None
Function that will prepare the files to copy.
Parameters:
-
copy_files
(SourceDirectory | list[SourceDirectory] | dict[SourceDirectory, Filenames] | None
, default:None
) –Files to copy (and decompress) from source to the runtime directory.
-
calc_params
(dict[str, Any] | None
, default:None
) –The calculator parameters.
-
binary
(str
, default:'pw'
) –The binary to use.
Returns:
-
dict
–Dictionary of files to copy.
Source code in quacc/recipes/espresso/_base.py
run_and_summarize ¶
run_and_summarize(
atoms: Atoms | None = None,
preset: str | None = None,
template: EspressoTemplate | None = None,
profile: EspressoProfile | None = None,
calc_defaults: dict[str, Any] | None = None,
calc_swaps: dict[str, Any] | None = None,
parallel_info: dict[str, Any] | None = None,
additional_fields: dict[str, Any] | None = None,
copy_files: (
SourceDirectory
| list[SourceDirectory]
| dict[SourceDirectory, Filenames]
| None
) = None,
) -> RunSchema
Base function to carry out espresso recipes.
Parameters:
-
atoms
(Atoms | None
, default:None
) –Atoms object
-
preset
(str | None
, default:None
) –Name of the preset to use
-
template
(EspressoTemplate | None
, default:None
) –EspressoTemplate to use
-
profile
(EspressoProfile | None
, default:None
) –EspressoProfile to use
-
calc_defaults
(dict[str, Any] | None
, default:None
) –The default calculator parameters.
-
calc_swaps
(dict[str, Any] | None
, default:None
) –Custom kwargs for the espresso calculator. Set a value to
quacc.Remove
to remove a pre-existing key entirely. For a list of available keys, refer to the ase.calculators.espresso.Espresso calculator. -
parallel_info
(dict[str, Any] | None
, default:None
) –Dictionary of parallelization information.
-
additional_fields
(dict[str, Any] | None
, default:None
) –Any additional fields to supply to the summarizer.
-
copy_files
(SourceDirectory | list[SourceDirectory] | dict[SourceDirectory, Filenames] | None
, default:None
) –Files to copy (and decompress) from source to the runtime directory.
Returns:
-
RunSchema
–Dictionary of results from quacc.schemas.ase.summarize_run
Source code in quacc/recipes/espresso/_base.py
run_and_summarize_opt ¶
run_and_summarize_opt(
atoms: Atoms | None = None,
preset: str | None = None,
template: EspressoTemplate | None = None,
profile: EspressoProfile | None = None,
calc_defaults: dict[str, Any] | None = None,
calc_swaps: dict[str, Any] | None = None,
opt_defaults: dict[str, Any] | None = None,
opt_params: OptParams | None = None,
parallel_info: dict[str, Any] | None = None,
additional_fields: dict[str, Any] | None = None,
copy_files: (
SourceDirectory
| list[SourceDirectory]
| dict[SourceDirectory, Filenames]
| None
) = None,
) -> RunSchema
Base function to carry out espresso recipes with ASE optimizers.
Parameters:
-
atoms
(Atoms | None
, default:None
) –Atoms object
-
preset
(str | None
, default:None
) –Name of the preset to use
-
template
(EspressoTemplate | None
, default:None
) –EspressoTemplate to use
-
profile
(EspressoProfile | None
, default:None
) –EspressoProfile to use
-
calc_defaults
(dict[str, Any] | None
, default:None
) –The default calculator parameters.
-
calc_swaps
(dict[str, Any] | None
, default:None
) –Custom kwargs for the espresso calculator. Set a value to
quacc.Remove
to remove a pre-existing key entirely. For a list of available keys, refer to the ase.calculators.espresso.Espresso calculator. -
opt_defaults
(dict[str, Any] | None
, default:None
) –The default optimization parameters.
-
opt_params
(OptParams | None
, default:None
) –Dictionary of parameters to pass to the optimizer. pass "optimizer" to change the optimizer being used. "fmax" and "max_steps" are commonly used keywords. See the ASE documentation for more information.
-
parallel_info
(dict[str, Any] | None
, default:None
) –Dictionary of parallelization information.
-
additional_fields
(dict[str, Any] | None
, default:None
) –Any additional fields to supply to the summarizer.
-
copy_files
(SourceDirectory | list[SourceDirectory] | dict[SourceDirectory, Filenames] | None
, default:None
) –Files to copy (and decompress) from source to the runtime directory.
Returns:
-
RunSchema
–Dictionary of results from quacc.schemas.ase.summarize_run
Source code in quacc/recipes/espresso/_base.py
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 |
|