MatPermute#

Creates a new matrix with rows and columns permuted from the original.

Synopsis#

#include "petscmat.h" 
PetscErrorCode MatPermute(Mat mat, IS row, IS col, Mat *B)

Collective

Input Parameters#

mat - the matrix to permute
row - row permutation, each processor supplies only the permutation for its rows
col - column permutation, each processor supplies only the permutation for its columns

Output Parameter#

B - the permuted matrix

Note#

The index sets map from row/col of permuted matrix to row/col of original matrix. The index sets should be on the same communicator as mat and have the same local sizes.

Developer Note#

If you want to implement MatPermute() for a matrix type, and your approach doesn’t exploit the fact that row and col are permutations, consider implementing the more general MatCreateSubMatrix() instead.