The low-level functions and classes described here are part of the hiPhive core components and not intended to be used directly during normal operation.
Clusters and orbits¶
The following functions and classes provide functionality for handling clusters and the symmetry relations among them.
A collection for handling a set of clusters.
See the AtomList for details since the functionality is the basically the same
Append a cluster.
Parameters: cluster (list of ints) – cluster to be added
Return index of given cluster.
Parameters: cluster (list of ints) – cluster of interest Returns: index of given cluster Return type: int
orientation_family module contains the OrientationFamily class, which
acts like a struct that contains information about a set of equal clusters of
equal orientation in space.
A container for storing information for a “family of orientations”.
An orbit contains many clusters. Some of the clusters can be tranlsated onto each other and other must first be rotated. A set of clusters in the orbit which can all be translated onto each other are oriented in the same way and belongs to the same orientation family. The family is haracterized by the symmetry (rotation) which relates it to the prototype structure of the orbit.
Since the clusters are generally stored sorted the permutation information must also be stored.
Parameters: symmetry_index (int) – The index of the symmetry corresponding to spglibs symmetry
int – The index of the symmetry corresponding to spglibs symmetry
list of ints – The indices of the clusters belonging to this family
list of ints – The indices of the permutation vector
Load a OrientationFamily object from a pickle file.
Parameters: f (str or file object) – name of input file (str) or stream to load from (file object) Returns: Return type: OrientationFamily object
Write the object to file.
Parameters: f (str or file object) – name of input file (str) or stream to write to (file object)