skbio.stats.distance.DistanceMatrix.permute

DistanceMatrix.permute(condensed=False)[source]

Randomly permute both rows and columns in the matrix.

State: Experimental as of 0.4.0.

Randomly permutes the ordering of rows and columns in the matrix. The same permutation is applied to both rows and columns in order to maintain symmetry and hollowness. Only the rows/columns in the distance matrix are permuted; the IDs are not permuted.

Parameters:condensed (bool, optional) – If True, return the permuted distance matrix in condensed format. Otherwise, return the permuted distance matrix as a new DistanceMatrix instance.
Returns:Permuted distances as a new DistanceMatrix or as a ndarray in condensed format.
Return type:DistanceMatrix or ndarray

See also

condensed_form()

Notes

This method does not modify the distance matrix that it is called on. It is more efficient to pass condensed=True than permuting the distance matrix and then converting to condensed format.