.TH BSmain_perm 3 "1/11/1996" " " "BlockSolve95"
.SH NAME
BSmain_perm \- Permute the matrix for efficient parallel execution

.SH INPUT PARAMETERS
.PD 0
.TP
.B procinfo 
- the usual processor context information
.PD 1
.PD 0
.TP
.B A 
- the sparse matrix
.PD 1

.SH RETURNS
the sparse matrix permuted into an efficient structure

.SH NOTES
.br
  (1) The sparse matrix must be symmetric in structure
.br
  (2) The graph associated with the sparse matrix must be connected
.br
  (3) max_inode_size and max_clique_size should usually be set to
.br
      INT_MAX (they are kept in the context)
.br
  (4) see the manual for more details on what algorithms BSmain_perm uses
.br
  (5) the context variable "retain" will indicate whether or not 
.br
      some extra data should be kept around to allow for fast permutation
.br
      of a matrix with the same structure in the future

.SH SYNOPSIS
.nf
BSpar_mat *BSmain_perm(BSprocinfo *procinfo, BSspmat *A)

.fi

.SH LOCATION
 BlockSolve95/src/BSmain_perm.c