                   readme for sparse/order directory
/*D
    SpOrderIntro - SpOrder routines take a matrix and return an ordering.
    They all have the same argument list, allowing them to be used
    interchangably.

    Description:
    These routines serve as interfaces to the routines from George and
    Liu's book "Computer Solution of Large Sparse Positive Definite Systems",
    The Fortran routines here are from the book (not the SparsePak
    library) and are available from netlib (that's where these came from).

$ -----------------------Sample Calling Sequences-----------------

$   SpMat *mat,factor;
$   int   rowperm[10],iperm[10],colperm[10];
$   double x[10],b[10];
$   mat = SpCreate(10,10,0);

$   .... fill matrix 

$   SpOrder(mat,rowperm,colperm,iperm);

$   factor = SpCreateSplit(10,10,0);
$   SpSetMappings(factor->factor,rowperm,colperm,iperm);
$   SpComputeFill(mat,factor);

$   ... set right hand side 

$   SpSolve(factor,b,x);

$   A simplified routine SpQuickFactor() does the ordering and factoring
     more easily for the beginner.
  
D*/

