nvalchemi.dynamics.mep.prepare_idpp_targets#

nvalchemi.dynamics.mep.prepare_idpp_targets(paths)[source]#

Build full pairwise IDPP target distances for a batch of reaction paths.

IDPP (image dependent pair potential) initialization needs a target interatomic distance for every atom pair in every image. This function replaces whatever edge/neighbor list paths currently has with a complete upper-triangle pair list per image, and assigns each pair a target distance linearly interpolated between that pair’s distance in the path’s first image and its distance in the path’s last image.

paths is a Batch of one or more reaction paths, where each path is a group of images (group_layout) and each image is one graph in that group. All images within a path must share the same atoms and ordering (enforced by validate_paths()) so that pair (i, j) refers to the same atoms across every image of the path.

Parameters:

paths (Batch) – Grouped reaction paths, where each group is a path and each graph within a group is one image along that path, with corresponding atoms in every image.

Returns:

paths, mutated in place: its edge storage now holds the full pair neighbor_list and the interpolated idpp_target_distances for every image.

Return type:

Batch