unwrap_edge

mdcraft.algorithm.topology.unwrap_edge(group: AtomGroup = None, *, positions: ndarray[float] = None, bonds: ndarray[int] = None, dimensions: ndarray[float] = None, thresholds: ndarray[float] = None, masses: ndarray[float] = None) → ndarray[float]

Locally unwraps the positions of molecules at the edge of the simulation box.

Parameters:

groupMDAnalysis.AtomGroup, optional

Atom group. If not provided, the atom positions, bonds, and system dimensions must be provided in positions, bonds, and dimensions, respectively.

positionsnumpy.ndarray, keyword-only, optional

Atom positions.

Shape: \((N,\,3)\).

Reference unit: \(\mathrm{nm}\).

bondsnumpy.ndarray, keyword-only, optional

Pairs of all bonded atom indices in reference to positions.

Shape: \((N_\mathrm{bonds},\,2)\).

dimensionsnumpy.ndarray, keyword-only, optional

System dimensions and, optionally, angles.

Shape: \((3,)\) or \((6,)\).

Reference unit: \(\mathrm{nm}\) (lengths) and \(^\circ\) (angles).

thresholdsnumpy.ndarray, keyword-only, optional

Maximum distances in each direction an atom can move before it is considered to have crossed a boundary.

Shape: \((3,)\).

Reference unit: \(\mathrm{nm}\).

massesnumpy.ndarray, keyword-only, optional

Atom masses. If not specified, all atoms are assumed to have the same mass.

Shape: \((N,)\).

Reference unit: \(\mathrm{g/mol}\).

Returns:

positionsnumpy.ndarray

Unwrapped atom positions.

Shape: \((N,\,3)\).

Reference unit: \(\mathrm{nm}\).