3.12.11. horton.part.symmetry – Symmetry analysis of atoms-in-molecules results

horton.part.symmetry.symmetry_analysis(coordinates, cell, symmetry, aim_results)

Compute averages and standard deviations on AIM results of equivalent atoms

Arguments:

coordinates
An (N, 3) array of atomic coordinates that adhere (with some minor deviation) to this symmetry.
cell
A Cell instance describing the periodic boundary conditions
symmetry
The symmetry descriptor that is used to find the equivalent atoms.
aim_results
A dictionary with AIM results. The following fields are supported (and the rest gets ignored): ‘charges’, ‘populations’, ‘pseudo_populations’, ‘cartesian_multipoles’, ‘radial_moments’, ‘volumes’, ‘volume_ratios’, ‘c6s’. (See partitioning schemes for more details about these fields.)

Returns: a dictionary with the above keys but where each item is an array with the corresponding statistical analysis. The dimension of this array is one higher:

  • first dimension: number if unique atoms in the primitive unit, instead of the number of atoms in the full molecule
  • second dimension: index can be 0 or 1. 0 refers to the mean over all equivalent atoms. 1 refers to the standard deviation
  • remaining dimensions are borrowed from the origin data in aim_results.