biotite.structure.index_dihedral¶

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

Measure the dihedral angle between quadruples of atoms.

The triples refer to indices of a given atom array, whose quadruplewise dihedral 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 quadruplewise dihedral angles are calculated for these pairs. Alternatively, the atom coordinates can be directly provided as ndarray.
indicesndarray, shape=(k,4): Quadruples 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

dihedralndarray, shape=(k,) or shape=(m,k): The quadruplewise dihedral 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.