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
pathscurrently 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.pathsis aBatchof 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 byvalidate_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 pairneighbor_listand the interpolatedidpp_target_distancesfor every image.- Return type: