index_angle#

biotite.structure.index_angle(atoms, indices, periodic=False, box=None)[source]#

Measure the angle between triples of atoms.

The triples refer to indices of a given atom array, whose triplewise angles should be calculated. If an atom array stack is provided, the distances are calculated for each frame/model.

Parameters:
atomsAtomArray or AtomArrayStack or ndarray, shape=(n,3) or shape=(m,n,3)

The atoms the indices parameter refers to. The triplewise distances are calculated for these pairs. Alternatively, the atom coordinates can be directly provided as ndarray.

indicesndarray, shape=(k,3)

Triples of indices that point to atoms.

periodicbool, optional

If set to true, periodic boundary conditions are taken into account (minimum-image convention). The box attribute of the atoms parameter is used for calculation. An alternative box can be provided via the box parameter. By default, periodicity is ignored.

boxndarray, shape=(3,3) or shape=(m,3,3), optional

If this parameter is set, the given box is used instead of the box attribute of atoms.

Returns:
anglendarray, shape=(k,) or shape=(m,k)

The triplewise angles. If atoms is an atom array stack, The distances are calculated for each model.

Warning

In case periodic is set to true and if the box is not orthorhombic (at least one angle deviates from 90 degrees), the calculation requires approximately 8 times as long as in the orthorhombic case. Furthermore, it is not guaranteed, that the lowest-distance periodic copy is found for non-orthorhombic boxes; this is especially true for heavily skewed boxes.

See also

angle