core.components.calculate.relaxation_runner

core.components.calculate.relaxation_runner#

Copyright (c) Meta Platforms, Inc. and affiliates.

This source code is licensed under the MIT license found in the LICENSE file in the root directory of this source tree.

Classes#

RelaxationRunner

Relax a sequence of several structures/molecules.

Module Contents#

class core.components.calculate.relaxation_runner.RelaxationRunner(calculator: ase.calculators.calculator.Calculator, input_data: fairchem.core.datasets.AseDBDataset, calculate_properties: collections.abc.Sequence[str], save_relaxed_atoms: bool = True, normalize_properties_by: dict[str, str] | None = None, save_target_properties: collections.abc.Sequence[str] | None = None, **relax_kwargs)#

Bases: fairchem.core.components.calculate.CalculateRunner

Relax a sequence of several structures/molecules.

This class handles the relaxation of atomic structures using a specified calculator, processes the input data in chunks, and saves the results.

result_glob_pattern: ClassVar[str] = 'relaxation_*-*.json.gz'#
_calculate_properties#
_save_relaxed_atoms#
_normalize_properties_by#
_save_target_properties#
_relax_kwargs#
calculate(job_num: int = 0, num_jobs: int = 1) → list[dict[str, Any]]#

Perform relaxation calculations on a subset of structures.

Splits the input data into chunks and processes the chunk corresponding to job_num.

Parameters:

  • job_num (int, optional) – Current job number in array job. Defaults to 0.

  • num_jobs (int, optional) – Total number of jobs in array. Defaults to 1.

Returns:

list[dict[str, Any]] - List of dictionaries containing calculation results

write_results(results: list[dict[str, Any]], results_dir: str, job_num: int = 0, num_jobs: int = 1) → None#

Write calculation results to a compressed JSON file.

Parameters:

  • results – List of dictionaries containing elastic properties

  • results_dir – Directory path where results will be saved

  • job_num – Index of the current job

  • num_jobs – Total number of jobs

save_state(checkpoint_location: str, is_preemption: bool = False) → bool#

Save the current state of the calculation to a checkpoint.

Parameters:

  • checkpoint_location (str) – Location to save the checkpoint

  • is_preemption (bool, optional) – Whether this save is due to preemption. Defaults to False.

Returns:

True if state was successfully saved, False otherwise

Return type:

bool

load_state(checkpoint_location: str | None) → None#

Load a previously saved state from a checkpoint.

Parameters:

checkpoint_location (str | None) – Location of the checkpoint to load, or None if no checkpoint

Contents