psblas3:

docs/html/footnode.html docs/html/img152.png docs/html/img154.png docs/html/img155.png docs/html/img156.png docs/html/img157.png docs/html/img158.png docs/html/img159.png docs/html/img160.png docs/html/img161.png docs/html/img162.png docs/html/img163.png docs/html/img164.png docs/html/img165.png docs/html/img166.png docs/html/index.html docs/html/node1.html docs/html/node10.html docs/html/node100.html docs/html/node101.html docs/html/node102.html docs/html/node103.html docs/html/node104.html docs/html/node105.html docs/html/node106.html docs/html/node107.html docs/html/node108.html docs/html/node109.html docs/html/node11.html docs/html/node110.html docs/html/node111.html docs/html/node112.html docs/html/node113.html docs/html/node114.html docs/html/node115.html docs/html/node116.html docs/html/node117.html docs/html/node118.html docs/html/node119.html docs/html/node12.html docs/html/node120.html docs/html/node121.html docs/html/node122.html docs/html/node123.html docs/html/node124.html docs/html/node125.html docs/html/node126.html docs/html/node127.html docs/html/node128.html docs/html/node13.html docs/html/node14.html docs/html/node15.html docs/html/node16.html docs/html/node17.html docs/html/node18.html docs/html/node19.html docs/html/node2.html docs/html/node20.html docs/html/node21.html docs/html/node22.html docs/html/node23.html docs/html/node24.html docs/html/node25.html docs/html/node26.html docs/html/node27.html docs/html/node28.html docs/html/node29.html docs/html/node3.html docs/html/node30.html docs/html/node31.html docs/html/node32.html docs/html/node33.html docs/html/node34.html docs/html/node35.html docs/html/node36.html docs/html/node37.html docs/html/node38.html docs/html/node39.html docs/html/node4.html docs/html/node40.html docs/html/node41.html docs/html/node42.html docs/html/node43.html docs/html/node44.html docs/html/node45.html docs/html/node46.html docs/html/node47.html docs/html/node48.html docs/html/node49.html docs/html/node5.html docs/html/node50.html docs/html/node51.html docs/html/node52.html docs/html/node53.html docs/html/node54.html docs/html/node55.html docs/html/node56.html docs/html/node57.html docs/html/node58.html docs/html/node59.html docs/html/node6.html docs/html/node60.html docs/html/node61.html docs/html/node62.html docs/html/node63.html docs/html/node64.html docs/html/node65.html docs/html/node66.html docs/html/node67.html docs/html/node68.html docs/html/node69.html docs/html/node7.html docs/html/node70.html docs/html/node71.html docs/html/node72.html docs/html/node73.html docs/html/node74.html docs/html/node75.html docs/html/node76.html docs/html/node77.html docs/html/node78.html docs/html/node79.html docs/html/node8.html docs/html/node80.html docs/html/node81.html docs/html/node82.html docs/html/node83.html docs/html/node84.html docs/html/node85.html docs/html/node86.html docs/html/node87.html docs/html/node88.html docs/html/node89.html docs/html/node9.html docs/html/node90.html docs/html/node91.html docs/html/node92.html docs/html/node93.html docs/html/node94.html docs/html/node95.html docs/html/node96.html docs/html/node97.html docs/html/node98.html docs/html/node99.html docs/html/userhtml.html docs/psblas-3.2.pdf docs/src/util.tex util/psb_c_mmio_impl.f90 util/psb_d_mmio_impl.f90 util/psb_mmio_mod.f90 util/psb_s_mmio_impl.f90 util/psb_z_mmio_impl.f90 New interface for mm_array_read/write and docs update.
2026-10-06 22:55:08 +00:00 · 2014-03-26 17:38:47 +00:00
parent 9f99a6f782
commit 1609ab9ffe
152 changed files with 9119 additions and 8002 deletions
@@ -18,7 +18,7 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <LINK REL="STYLESHEET" HREF="userhtml.css">

-<LINK REL="previous" HREF="node121.html">
+<LINK REL="previous" HREF="node127.html">
 <LINK REL="up" HREF="userhtml.html">
 </HEAD>

@@ -104,8 +104,8 @@ sample scatter/gather routines.
 .
 </PRE>
 </DD>
-<DT><A NAME="foot7420">... follows</A><A
- HREF="node114.html#tex2html30"><SUP>3</SUP></A></DT>
+<DT><A NAME="foot7458">... follows</A><A
+ HREF="node120.html#tex2html30"><SUP>3</SUP></A></DT>
 <DD>The string is case-insensitive

 <PRE>.
@@ -342,36 +342,57 @@ of  a dense vector</A>
  HREF="node111.html">Error handling</A>
 <LI><A NAME="tex2html146"
  HREF="node112.html">Utilities</A>
-<LI><A NAME="tex2html147"
-  HREF="node113.html">Preconditioner routines</A>
 <UL>
+<LI><A NAME="tex2html147"
+  HREF="node113.html">hb_read -- Read a sparse matrix from a file in the
+  Harwell-Boeing format</A>
 <LI><A NAME="tex2html148"
-  HREF="node114.html">psb_precinit -- Initialize a  preconditioner</A>
+  HREF="node114.html">hb_write -- Write a sparse matrix to a  file
+  in the Harwell-Boeing format</A>
 <LI><A NAME="tex2html149"
-  HREF="node115.html">psb_precbld -- Builds a preconditioner</A>
+  HREF="node115.html">mm_mat_read -- Read a sparse matrix from a
+  file in the MatrixMarket format</A>
 <LI><A NAME="tex2html150"
-  HREF="node116.html">psb_precaply -- Preconditioner application
-  routine</A>
+  HREF="node116.html">mm_array_read -- Read a dense array from a
+  file in the MatrixMarket format</A>
 <LI><A NAME="tex2html151"
-  HREF="node117.html">psb_precdescr -- Prints a description of current
-  preconditioner</A>
+  HREF="node117.html">mm_mat_write -- Write a sparse matrix to a
+  file in the MatrixMarket format</A>
 <LI><A NAME="tex2html152"
-  HREF="node118.html">clone -- clone  current
-  preconditioner</A>
+  HREF="node118.html">mm_array_write --  Write a dense array from a
+  file in the MatrixMarket format</A>
 </UL>
 <BR>
 <LI><A NAME="tex2html153"
-  HREF="node119.html">Iterative Methods</A>
+  HREF="node119.html">Preconditioner routines</A>
 <UL>
 <LI><A NAME="tex2html154"
-  HREF="node120.html">psb_krylov  -- Krylov Methods Driver
+  HREF="node120.html">psb_precinit -- Initialize a  preconditioner</A>
+<LI><A NAME="tex2html155"
+  HREF="node121.html">psb_precbld -- Builds a preconditioner</A>
+<LI><A NAME="tex2html156"
+  HREF="node122.html">psb_precaply -- Preconditioner application
+  routine</A>
+<LI><A NAME="tex2html157"
+  HREF="node123.html">psb_precdescr -- Prints a description of current
+  preconditioner</A>
+<LI><A NAME="tex2html158"
+  HREF="node124.html">clone -- clone  current
+  preconditioner</A>
+</UL>
+<BR>
+<LI><A NAME="tex2html159"
+  HREF="node125.html">Iterative Methods</A>
+<UL>
+<LI><A NAME="tex2html160"
+  HREF="node126.html">psb_krylov  -- Krylov Methods Driver
      Routine</A>
 </UL>
 <BR>
-<LI><A NAME="tex2html155"
-  HREF="node121.html">Bibliography</A>
-<LI><A NAME="tex2html156"
-  HREF="node122.html">About this document ...</A>
+<LI><A NAME="tex2html161"
+  HREF="node127.html">Bibliography</A>
+<LI><A NAME="tex2html162"
+  HREF="node128.html">About this document ...</A>
 </UL>
 <!--End of Table of Child-Links-->
 <BR><HR>
@@ -26,21 +26,21 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html165"
+<A NAME="tex2html171"
  HREF="node2.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html163"
+<A NAME="tex2html169"
  HREF="userhtml.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html157"
+<A NAME="tex2html163"
  HREF="userhtml.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>   
 <BR>
-<B> Next:</B> <A NAME="tex2html166"
+<B> Next:</B> <A NAME="tex2html172"
  HREF="node2.html">Introduction</A>
-<B> Up:</B> <A NAME="tex2html164"
+<B> Up:</B> <A NAME="tex2html170"
  HREF="userhtml.html">userhtml</A>
-<B> Previous:</B> <A NAME="tex2html158"
+<B> Previous:</B> <A NAME="tex2html164"
  HREF="userhtml.html">userhtml</A>
 <BR>
 <BR>
@@ -53,52 +53,52 @@ Contents</A>
 <!--Table of Contents-->

 <UL>
-<LI><A NAME="tex2html167"
+<LI><A NAME="tex2html173"
  HREF="node2.html">Introduction</A>
-<LI><A NAME="tex2html168"
+<LI><A NAME="tex2html174"
  HREF="node3.html">General overview</A>
 <UL>
-<LI><A NAME="tex2html169"
+<LI><A NAME="tex2html175"
  HREF="node4.html">Basic Nomenclature</A>
-<LI><A NAME="tex2html170"
+<LI><A NAME="tex2html176"
  HREF="node5.html">Library contents</A>
-<LI><A NAME="tex2html171"
+<LI><A NAME="tex2html177"
  HREF="node6.html">Application structure</A>
-<LI><A NAME="tex2html172"
+<LI><A NAME="tex2html178"
  HREF="node8.html">Programming model</A>
 </UL>
 <BR>
-<LI><A NAME="tex2html173"
+<LI><A NAME="tex2html179"
  HREF="node9.html">Data Structures and Classes</A>
 <UL>
-<LI><A NAME="tex2html174"
+<LI><A NAME="tex2html180"
  HREF="node10.html">Descriptor data structure</A>
-<LI><A NAME="tex2html175"
+<LI><A NAME="tex2html181"
  HREF="node21.html">Sparse Matrix class</A>
-<LI><A NAME="tex2html176"
+<LI><A NAME="tex2html182"
  HREF="node40.html">Dense Vector Data Structure</A>
-<LI><A NAME="tex2html177"
+<LI><A NAME="tex2html183"
  HREF="node46.html">Preconditioner data structure</A>
 </UL>
 <BR>
-<LI><A NAME="tex2html178"
-  HREF="node47.html">Computational routines</A>
-<LI><A NAME="tex2html179"
-  HREF="node61.html">Communication routines</A>
-<LI><A NAME="tex2html180"
-  HREF="node66.html">Data management routines</A>
-<LI><A NAME="tex2html181"
-  HREF="node94.html">Parallel environment routines</A>
-<LI><A NAME="tex2html182"
-  HREF="node111.html">Error handling</A>
-<LI><A NAME="tex2html183"
-  HREF="node112.html">Utilities</A>
 <LI><A NAME="tex2html184"
-  HREF="node113.html">Preconditioner routines</A>
+  HREF="node47.html">Computational routines</A>
 <LI><A NAME="tex2html185"
-  HREF="node119.html">Iterative Methods</A>
+  HREF="node61.html">Communication routines</A>
 <LI><A NAME="tex2html186"
-  HREF="node121.html">Bibliography</A>
+  HREF="node66.html">Data management routines</A>
+<LI><A NAME="tex2html187"
+  HREF="node94.html">Parallel environment routines</A>
+<LI><A NAME="tex2html188"
+  HREF="node111.html">Error handling</A>
+<LI><A NAME="tex2html189"
+  HREF="node112.html">Utilities</A>
+<LI><A NAME="tex2html190"
+  HREF="node119.html">Preconditioner routines</A>
+<LI><A NAME="tex2html191"
+  HREF="node125.html">Iterative Methods</A>
+<LI><A NAME="tex2html192"
+  HREF="node127.html">Bibliography</A>
 </UL>
 <!--End of Table of Contents-->
 <P>
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html332"
+<A NAME="tex2html338"
  HREF="node11.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html328"
+<A NAME="tex2html334"
  HREF="node9.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html322"
+<A NAME="tex2html328"
  HREF="node9.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html330"
+<A NAME="tex2html336"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html333"
+<B> Next:</B> <A NAME="tex2html339"
  HREF="node11.html">Descriptor Methods</A>
-<B> Up:</B> <A NAME="tex2html329"
+<B> Up:</B> <A NAME="tex2html335"
  HREF="node9.html">Data Structures and Classes</A>
-<B> Previous:</B> <A NAME="tex2html323"
+<B> Previous:</B> <A NAME="tex2html329"
  HREF="node9.html">Data Structures and Classes</A>
- &nbsp; <B>  <A NAME="tex2html331"
+ &nbsp; <B>  <A NAME="tex2html337"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -249,52 +249,52 @@ state, which can take the following values:
 <A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>

 <UL>
-<LI><A NAME="tex2html334"
-  HREF="node11.html">Descriptor Methods</A>
-<LI><A NAME="tex2html335"
-  HREF="node12.html">get_local_rows -- Get number of local rows</A>
-<LI><A NAME="tex2html336"
-  HREF="node13.html">get_local_cols -- Get number of local cols</A>
-<LI><A NAME="tex2html337"
-  HREF="node14.html">get_global_rows -- Get number of global rows</A>
-<LI><A NAME="tex2html338"
-  HREF="node15.html">get_global_cols -- Get number of global cols</A>
-<LI><A NAME="tex2html339"
-  HREF="node16.html">get_context -- Get communication context</A>
 <LI><A NAME="tex2html340"
-  HREF="node17.html">Clone -- clone current object</A>
+  HREF="node11.html">Descriptor Methods</A>
 <LI><A NAME="tex2html341"
+  HREF="node12.html">get_local_rows -- Get number of local rows</A>
+<LI><A NAME="tex2html342"
+  HREF="node13.html">get_local_cols -- Get number of local cols</A>
+<LI><A NAME="tex2html343"
+  HREF="node14.html">get_global_rows -- Get number of global rows</A>
+<LI><A NAME="tex2html344"
+  HREF="node15.html">get_global_cols -- Get number of global cols</A>
+<LI><A NAME="tex2html345"
+  HREF="node16.html">get_context -- Get communication context</A>
+<LI><A NAME="tex2html346"
+  HREF="node17.html">Clone -- clone current object</A>
+<LI><A NAME="tex2html347"
  HREF="node18.html">psb_cd_get_large_threshold -- Get threshold for
  index mapping switch</A>
-<LI><A NAME="tex2html342"
+<LI><A NAME="tex2html348"
  HREF="node19.html">psb_cd_set_large_threshold -- Set threshold for
  index mapping switch</A>
-<LI><A NAME="tex2html343"
+<LI><A NAME="tex2html349"
  HREF="node20.html">Named Constants</A>
 </UL>
 <!--End of Table of Child-Links-->
 <HR>
 <!--Navigation Panel-->
-<A NAME="tex2html332"
+<A NAME="tex2html338"
  HREF="node11.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html328"
+<A NAME="tex2html334"
  HREF="node9.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html322"
+<A NAME="tex2html328"
  HREF="node9.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html330"
+<A NAME="tex2html336"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html333"
+<B> Next:</B> <A NAME="tex2html339"
  HREF="node11.html">Descriptor Methods</A>
-<B> Up:</B> <A NAME="tex2html329"
+<B> Up:</B> <A NAME="tex2html335"
  HREF="node9.html">Data Structures and Classes</A>
-<B> Previous:</B> <A NAME="tex2html323"
+<B> Previous:</B> <A NAME="tex2html329"
  HREF="node9.html">Data Structures and Classes</A>
- &nbsp; <B>  <A NAME="tex2html331"
+ &nbsp; <B>  <A NAME="tex2html337"
  HREF="node1.html">Contents</A></B> 
 <!--End of Navigation Panel-->

@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html1491"
+<A NAME="tex2html1497"
  HREF="node101.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html1487"
+<A NAME="tex2html1493"
  HREF="node94.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1481"
+<A NAME="tex2html1487"
  HREF="node99.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1489"
+<A NAME="tex2html1495"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html1492"
+<B> Next:</B> <A NAME="tex2html1498"
  HREF="node101.html">psb_barrier   Sinchronization</A>
-<B> Up:</B> <A NAME="tex2html1488"
+<B> Up:</B> <A NAME="tex2html1494"
  HREF="node94.html">Parallel environment routines</A>
-<B> Previous:</B> <A NAME="tex2html1482"
+<B> Previous:</B> <A NAME="tex2html1488"
  HREF="node99.html">psb_get_rank   Get</A>
- &nbsp; <B>  <A NAME="tex2html1490"
+ &nbsp; <B>  <A NAME="tex2html1496"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html1503"
+<A NAME="tex2html1509"
  HREF="node102.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html1499"
+<A NAME="tex2html1505"
  HREF="node94.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1493"
+<A NAME="tex2html1499"
  HREF="node100.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1501"
+<A NAME="tex2html1507"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html1504"
+<B> Next:</B> <A NAME="tex2html1510"
  HREF="node102.html">psb_abort   Abort</A>
-<B> Up:</B> <A NAME="tex2html1500"
+<B> Up:</B> <A NAME="tex2html1506"
  HREF="node94.html">Parallel environment routines</A>
-<B> Previous:</B> <A NAME="tex2html1494"
+<B> Previous:</B> <A NAME="tex2html1500"
  HREF="node100.html">psb_wtime   Wall</A>
- &nbsp; <B>  <A NAME="tex2html1502"
+ &nbsp; <B>  <A NAME="tex2html1508"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html1515"
+<A NAME="tex2html1521"
  HREF="node103.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html1511"
+<A NAME="tex2html1517"
  HREF="node94.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1505"
+<A NAME="tex2html1511"
  HREF="node101.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1513"
+<A NAME="tex2html1519"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html1516"
+<B> Next:</B> <A NAME="tex2html1522"
  HREF="node103.html">psb_bcast   Broadcast</A>
-<B> Up:</B> <A NAME="tex2html1512"
+<B> Up:</B> <A NAME="tex2html1518"
  HREF="node94.html">Parallel environment routines</A>
-<B> Previous:</B> <A NAME="tex2html1506"
+<B> Previous:</B> <A NAME="tex2html1512"
  HREF="node101.html">psb_barrier   Sinchronization</A>
- &nbsp; <B>  <A NAME="tex2html1514"
+ &nbsp; <B>  <A NAME="tex2html1520"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html1527"
+<A NAME="tex2html1533"
  HREF="node104.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html1523"
+<A NAME="tex2html1529"
  HREF="node94.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1517"
+<A NAME="tex2html1523"
  HREF="node102.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1525"
+<A NAME="tex2html1531"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html1528"
+<B> Next:</B> <A NAME="tex2html1534"
  HREF="node104.html">psb_sum   Global</A>
-<B> Up:</B> <A NAME="tex2html1524"
+<B> Up:</B> <A NAME="tex2html1530"
  HREF="node94.html">Parallel environment routines</A>
-<B> Previous:</B> <A NAME="tex2html1518"
+<B> Previous:</B> <A NAME="tex2html1524"
  HREF="node102.html">psb_abort   Abort</A>
- &nbsp; <B>  <A NAME="tex2html1526"
+ &nbsp; <B>  <A NAME="tex2html1532"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -135,26 +135,26 @@ scalar, or a rank 1 or 2 array, or a character or logical scalar.  Type, kind, r
 <P>
 <HR>
 <!--Navigation Panel-->
-<A NAME="tex2html1527"
+<A NAME="tex2html1533"
  HREF="node104.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html1523"
+<A NAME="tex2html1529"
  HREF="node94.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1517"
+<A NAME="tex2html1523"
  HREF="node102.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1525"
+<A NAME="tex2html1531"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html1528"
+<B> Next:</B> <A NAME="tex2html1534"
  HREF="node104.html">psb_sum   Global</A>
-<B> Up:</B> <A NAME="tex2html1524"
+<B> Up:</B> <A NAME="tex2html1530"
  HREF="node94.html">Parallel environment routines</A>
-<B> Previous:</B> <A NAME="tex2html1518"
+<B> Previous:</B> <A NAME="tex2html1524"
  HREF="node102.html">psb_abort   Abort</A>
- &nbsp; <B>  <A NAME="tex2html1526"
+ &nbsp; <B>  <A NAME="tex2html1532"
  HREF="node1.html">Contents</A></B> 
 <!--End of Navigation Panel-->

@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html1539"
+<A NAME="tex2html1545"
  HREF="node105.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html1535"
+<A NAME="tex2html1541"
  HREF="node94.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1529"
+<A NAME="tex2html1535"
  HREF="node103.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1537"
+<A NAME="tex2html1543"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html1540"
+<B> Next:</B> <A NAME="tex2html1546"
  HREF="node105.html">psb_max   Global</A>
-<B> Up:</B> <A NAME="tex2html1536"
+<B> Up:</B> <A NAME="tex2html1542"
  HREF="node94.html">Parallel environment routines</A>
-<B> Previous:</B> <A NAME="tex2html1530"
+<B> Previous:</B> <A NAME="tex2html1536"
  HREF="node103.html">psb_bcast   Broadcast</A>
- &nbsp; <B>  <A NAME="tex2html1538"
+ &nbsp; <B>  <A NAME="tex2html1544"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -152,26 +152,26 @@ Type, kind, rank and size must agree on all processes.
 <P>
 <HR>
 <!--Navigation Panel-->
-<A NAME="tex2html1539"
+<A NAME="tex2html1545"
  HREF="node105.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html1535"
+<A NAME="tex2html1541"
  HREF="node94.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1529"
+<A NAME="tex2html1535"
  HREF="node103.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1537"
+<A NAME="tex2html1543"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html1540"
+<B> Next:</B> <A NAME="tex2html1546"
  HREF="node105.html">psb_max   Global</A>
-<B> Up:</B> <A NAME="tex2html1536"
+<B> Up:</B> <A NAME="tex2html1542"
  HREF="node94.html">Parallel environment routines</A>
-<B> Previous:</B> <A NAME="tex2html1530"
+<B> Previous:</B> <A NAME="tex2html1536"
  HREF="node103.html">psb_bcast   Broadcast</A>
- &nbsp; <B>  <A NAME="tex2html1538"
+ &nbsp; <B>  <A NAME="tex2html1544"
  HREF="node1.html">Contents</A></B> 
 <!--End of Navigation Panel-->

@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html1551"
+<A NAME="tex2html1557"
  HREF="node106.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html1547"
+<A NAME="tex2html1553"
  HREF="node94.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1541"
+<A NAME="tex2html1547"
  HREF="node104.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1549"
+<A NAME="tex2html1555"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html1552"
+<B> Next:</B> <A NAME="tex2html1558"
  HREF="node106.html">psb_min   Global</A>
-<B> Up:</B> <A NAME="tex2html1548"
+<B> Up:</B> <A NAME="tex2html1554"
  HREF="node94.html">Parallel environment routines</A>
-<B> Previous:</B> <A NAME="tex2html1542"
+<B> Previous:</B> <A NAME="tex2html1548"
  HREF="node104.html">psb_sum   Global</A>
- &nbsp; <B>  <A NAME="tex2html1550"
+ &nbsp; <B>  <A NAME="tex2html1556"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -151,26 +151,26 @@ scalar, or a rank 1 or 2 array.  Type, kind, rank and size must agree on all pro
 <P>
 <HR>
 <!--Navigation Panel-->
-<A NAME="tex2html1551"
+<A NAME="tex2html1557"
  HREF="node106.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html1547"
+<A NAME="tex2html1553"
  HREF="node94.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1541"
+<A NAME="tex2html1547"
  HREF="node104.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1549"
+<A NAME="tex2html1555"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html1552"
+<B> Next:</B> <A NAME="tex2html1558"
  HREF="node106.html">psb_min   Global</A>
-<B> Up:</B> <A NAME="tex2html1548"
+<B> Up:</B> <A NAME="tex2html1554"
  HREF="node94.html">Parallel environment routines</A>
-<B> Previous:</B> <A NAME="tex2html1542"
+<B> Previous:</B> <A NAME="tex2html1548"
  HREF="node104.html">psb_sum   Global</A>
- &nbsp; <B>  <A NAME="tex2html1550"
+ &nbsp; <B>  <A NAME="tex2html1556"
  HREF="node1.html">Contents</A></B> 
 <!--End of Navigation Panel-->

@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html1563"
+<A NAME="tex2html1569"
  HREF="node107.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html1559"
+<A NAME="tex2html1565"
  HREF="node94.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1553"
+<A NAME="tex2html1559"
  HREF="node105.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1561"
+<A NAME="tex2html1567"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html1564"
+<B> Next:</B> <A NAME="tex2html1570"
  HREF="node107.html">psb_amx   Global</A>
-<B> Up:</B> <A NAME="tex2html1560"
+<B> Up:</B> <A NAME="tex2html1566"
  HREF="node94.html">Parallel environment routines</A>
-<B> Previous:</B> <A NAME="tex2html1554"
+<B> Previous:</B> <A NAME="tex2html1560"
  HREF="node105.html">psb_max   Global</A>
- &nbsp; <B>  <A NAME="tex2html1562"
+ &nbsp; <B>  <A NAME="tex2html1568"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -153,26 +153,26 @@ Type, kind, rank and size must agree on all processes.
 <P>
 <HR>
 <!--Navigation Panel-->
-<A NAME="tex2html1563"
+<A NAME="tex2html1569"
  HREF="node107.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html1559"
+<A NAME="tex2html1565"
  HREF="node94.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1553"
+<A NAME="tex2html1559"
  HREF="node105.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1561"
+<A NAME="tex2html1567"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html1564"
+<B> Next:</B> <A NAME="tex2html1570"
  HREF="node107.html">psb_amx   Global</A>
-<B> Up:</B> <A NAME="tex2html1560"
+<B> Up:</B> <A NAME="tex2html1566"
  HREF="node94.html">Parallel environment routines</A>
-<B> Previous:</B> <A NAME="tex2html1554"
+<B> Previous:</B> <A NAME="tex2html1560"
  HREF="node105.html">psb_max   Global</A>
- &nbsp; <B>  <A NAME="tex2html1562"
+ &nbsp; <B>  <A NAME="tex2html1568"
  HREF="node1.html">Contents</A></B> 
 <!--End of Navigation Panel-->

@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html1575"
+<A NAME="tex2html1581"
  HREF="node108.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html1571"
+<A NAME="tex2html1577"
  HREF="node94.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1565"
+<A NAME="tex2html1571"
  HREF="node106.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1573"
+<A NAME="tex2html1579"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html1576"
+<B> Next:</B> <A NAME="tex2html1582"
  HREF="node108.html">psb_amn   Global</A>
-<B> Up:</B> <A NAME="tex2html1572"
+<B> Up:</B> <A NAME="tex2html1578"
  HREF="node94.html">Parallel environment routines</A>
-<B> Previous:</B> <A NAME="tex2html1566"
+<B> Previous:</B> <A NAME="tex2html1572"
  HREF="node106.html">psb_min   Global</A>
- &nbsp; <B>  <A NAME="tex2html1574"
+ &nbsp; <B>  <A NAME="tex2html1580"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -151,26 +151,26 @@ scalar, or a rank 1 or 2 array.  Type, kind, rank and size must agree on all pro
 <P>
 <HR>
 <!--Navigation Panel-->
-<A NAME="tex2html1575"
+<A NAME="tex2html1581"
  HREF="node108.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html1571"
+<A NAME="tex2html1577"
  HREF="node94.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1565"
+<A NAME="tex2html1571"
  HREF="node106.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1573"
+<A NAME="tex2html1579"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html1576"
+<B> Next:</B> <A NAME="tex2html1582"
  HREF="node108.html">psb_amn   Global</A>
-<B> Up:</B> <A NAME="tex2html1572"
+<B> Up:</B> <A NAME="tex2html1578"
  HREF="node94.html">Parallel environment routines</A>
-<B> Previous:</B> <A NAME="tex2html1566"
+<B> Previous:</B> <A NAME="tex2html1572"
  HREF="node106.html">psb_min   Global</A>
- &nbsp; <B>  <A NAME="tex2html1574"
+ &nbsp; <B>  <A NAME="tex2html1580"
  HREF="node1.html">Contents</A></B> 
 <!--End of Navigation Panel-->

@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html1587"
+<A NAME="tex2html1593"
  HREF="node109.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html1583"
+<A NAME="tex2html1589"
  HREF="node94.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1577"
+<A NAME="tex2html1583"
  HREF="node107.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1585"
+<A NAME="tex2html1591"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html1588"
+<B> Next:</B> <A NAME="tex2html1594"
  HREF="node109.html">psb_snd   Send</A>
-<B> Up:</B> <A NAME="tex2html1584"
+<B> Up:</B> <A NAME="tex2html1590"
  HREF="node94.html">Parallel environment routines</A>
-<B> Previous:</B> <A NAME="tex2html1578"
+<B> Previous:</B> <A NAME="tex2html1584"
  HREF="node107.html">psb_amx   Global</A>
- &nbsp; <B>  <A NAME="tex2html1586"
+ &nbsp; <B>  <A NAME="tex2html1592"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -153,26 +153,26 @@ Type, kind, rank and size must agree on all processes.
 <P>
 <HR>
 <!--Navigation Panel-->
-<A NAME="tex2html1587"
+<A NAME="tex2html1593"
  HREF="node109.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html1583"
+<A NAME="tex2html1589"
  HREF="node94.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1577"
+<A NAME="tex2html1583"
  HREF="node107.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1585"
+<A NAME="tex2html1591"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html1588"
+<B> Next:</B> <A NAME="tex2html1594"
  HREF="node109.html">psb_snd   Send</A>
-<B> Up:</B> <A NAME="tex2html1584"
+<B> Up:</B> <A NAME="tex2html1590"
  HREF="node94.html">Parallel environment routines</A>
-<B> Previous:</B> <A NAME="tex2html1578"
+<B> Previous:</B> <A NAME="tex2html1584"
  HREF="node107.html">psb_amx   Global</A>
- &nbsp; <B>  <A NAME="tex2html1586"
+ &nbsp; <B>  <A NAME="tex2html1592"
  HREF="node1.html">Contents</A></B> 
 <!--End of Navigation Panel-->

@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html1599"
+<A NAME="tex2html1605"
  HREF="node110.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html1595"
+<A NAME="tex2html1601"
  HREF="node94.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1589"
+<A NAME="tex2html1595"
  HREF="node108.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1597"
+<A NAME="tex2html1603"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html1600"
+<B> Next:</B> <A NAME="tex2html1606"
  HREF="node110.html">psb_rcv   Receive</A>
-<B> Up:</B> <A NAME="tex2html1596"
+<B> Up:</B> <A NAME="tex2html1602"
  HREF="node94.html">Parallel environment routines</A>
-<B> Previous:</B> <A NAME="tex2html1590"
+<B> Previous:</B> <A NAME="tex2html1596"
  HREF="node108.html">psb_amn   Global</A>
- &nbsp; <B>  <A NAME="tex2html1598"
+ &nbsp; <B>  <A NAME="tex2html1604"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -165,26 +165,26 @@ same value on sending and receiving processes.
 <P>
 <HR>
 <!--Navigation Panel-->
-<A NAME="tex2html1599"
+<A NAME="tex2html1605"
  HREF="node110.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html1595"
+<A NAME="tex2html1601"
  HREF="node94.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1589"
+<A NAME="tex2html1595"
  HREF="node108.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1597"
+<A NAME="tex2html1603"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html1600"
+<B> Next:</B> <A NAME="tex2html1606"
  HREF="node110.html">psb_rcv   Receive</A>
-<B> Up:</B> <A NAME="tex2html1596"
+<B> Up:</B> <A NAME="tex2html1602"
  HREF="node94.html">Parallel environment routines</A>
-<B> Previous:</B> <A NAME="tex2html1590"
+<B> Previous:</B> <A NAME="tex2html1596"
  HREF="node108.html">psb_amn   Global</A>
- &nbsp; <B>  <A NAME="tex2html1598"
+ &nbsp; <B>  <A NAME="tex2html1604"
  HREF="node1.html">Contents</A></B> 
 <!--End of Navigation Panel-->

@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html354"
+<A NAME="tex2html360"
  HREF="node12.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html350"
+<A NAME="tex2html356"
  HREF="node10.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html344"
+<A NAME="tex2html350"
  HREF="node10.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html352"
+<A NAME="tex2html358"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html355"
+<B> Next:</B> <A NAME="tex2html361"
  HREF="node12.html">get_local_rows   Get</A>
-<B> Up:</B> <A NAME="tex2html351"
+<B> Up:</B> <A NAME="tex2html357"
  HREF="node10.html">Descriptor data structure</A>
-<B> Previous:</B> <A NAME="tex2html345"
+<B> Previous:</B> <A NAME="tex2html351"
  HREF="node10.html">Descriptor data structure</A>
- &nbsp; <B>  <A NAME="tex2html353"
+ &nbsp; <B>  <A NAME="tex2html359"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -25,26 +25,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html1609"
+<A NAME="tex2html1615"
  HREF="node111.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html1605"
+<A NAME="tex2html1611"
  HREF="node94.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1601"
+<A NAME="tex2html1607"
  HREF="node109.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1607"
+<A NAME="tex2html1613"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html1610"
+<B> Next:</B> <A NAME="tex2html1616"
  HREF="node111.html">Error handling</A>
-<B> Up:</B> <A NAME="tex2html1606"
+<B> Up:</B> <A NAME="tex2html1612"
  HREF="node94.html">Parallel environment routines</A>
-<B> Previous:</B> <A NAME="tex2html1602"
+<B> Previous:</B> <A NAME="tex2html1608"
  HREF="node109.html">psb_snd   Send</A>
- &nbsp; <B>  <A NAME="tex2html1608"
+ &nbsp; <B>  <A NAME="tex2html1614"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -164,26 +164,26 @@ not specified, size must agree as well.
 <P>
 <HR>
 <!--Navigation Panel-->
-<A NAME="tex2html1609"
+<A NAME="tex2html1615"
  HREF="node111.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html1605"
+<A NAME="tex2html1611"
  HREF="node94.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1601"
+<A NAME="tex2html1607"
  HREF="node109.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1607"
+<A NAME="tex2html1613"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html1610"
+<B> Next:</B> <A NAME="tex2html1616"
  HREF="node111.html">Error handling</A>
-<B> Up:</B> <A NAME="tex2html1606"
+<B> Up:</B> <A NAME="tex2html1612"
  HREF="node94.html">Parallel environment routines</A>
-<B> Previous:</B> <A NAME="tex2html1602"
+<B> Previous:</B> <A NAME="tex2html1608"
  HREF="node109.html">psb_snd   Send</A>
- &nbsp; <B>  <A NAME="tex2html1608"
+ &nbsp; <B>  <A NAME="tex2html1614"
  HREF="node1.html">Contents</A></B> 
 <!--End of Navigation Panel-->

@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html1621"
+<A NAME="tex2html1627"
  HREF="node112.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html1617"
+<A NAME="tex2html1623"
  HREF="userhtml.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1611"
+<A NAME="tex2html1617"
  HREF="node110.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1619"
+<A NAME="tex2html1625"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html1622"
+<B> Next:</B> <A NAME="tex2html1628"
  HREF="node112.html">Utilities</A>
-<B> Up:</B> <A NAME="tex2html1618"
+<B> Up:</B> <A NAME="tex2html1624"
  HREF="userhtml.html">userhtml</A>
-<B> Previous:</B> <A NAME="tex2html1612"
+<B> Previous:</B> <A NAME="tex2html1618"
  HREF="node110.html">psb_rcv   Receive</A>
- &nbsp; <B>  <A NAME="tex2html1620"
+ &nbsp; <B>  <A NAME="tex2html1626"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -317,26 +317,26 @@ Specified as: an integer. Possible values: <code>psb_act_ret</code>,
 <P>
 <HR>
 <!--Navigation Panel-->
-<A NAME="tex2html1621"
+<A NAME="tex2html1627"
  HREF="node112.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html1617"
+<A NAME="tex2html1623"
  HREF="userhtml.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1611"
+<A NAME="tex2html1617"
  HREF="node110.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1619"
+<A NAME="tex2html1625"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html1622"
+<B> Next:</B> <A NAME="tex2html1628"
  HREF="node112.html">Utilities</A>
-<B> Up:</B> <A NAME="tex2html1618"
+<B> Up:</B> <A NAME="tex2html1624"
  HREF="userhtml.html">userhtml</A>
-<B> Previous:</B> <A NAME="tex2html1612"
+<B> Previous:</B> <A NAME="tex2html1618"
  HREF="node110.html">psb_rcv   Receive</A>
- &nbsp; <B>  <A NAME="tex2html1620"
+ &nbsp; <B>  <A NAME="tex2html1626"
  HREF="node1.html">Contents</A></B> 
 <!--End of Navigation Panel-->

@@ -18,7 +18,7 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <LINK REL="STYLESHEET" HREF="userhtml.css">

-<LINK REL="next" HREF="node113.html">
+<LINK REL="next" HREF="node119.html">
 <LINK REL="previous" HREF="node111.html">
 <LINK REL="up" HREF="userhtml.html">
 <LINK REL="next" HREF="node113.html">
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html1633"
+<A NAME="tex2html1639"
  HREF="node113.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html1629"
+<A NAME="tex2html1635"
  HREF="userhtml.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1623"
+<A NAME="tex2html1629"
  HREF="node111.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1631"
+<A NAME="tex2html1637"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html1634"
-  HREF="node113.html">Preconditioner routines</A>
-<B> Up:</B> <A NAME="tex2html1630"
+<B> Next:</B> <A NAME="tex2html1640"
+  HREF="node113.html">hb_read   Read</A>
+<B> Up:</B> <A NAME="tex2html1636"
  HREF="userhtml.html">userhtml</A>
-<B> Previous:</B> <A NAME="tex2html1624"
+<B> Previous:</B> <A NAME="tex2html1630"
  HREF="node111.html">Error handling</A>
- &nbsp; <B>  <A NAME="tex2html1632"
+ &nbsp; <B>  <A NAME="tex2html1638"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -63,384 +63,32 @@ sparsematrices; the interfaces to these routines are available in the
 module <code>psb_util_mod</code>.

 <P>
-ifstarsubroutinesubroutinehb_readRead a sparse matrix from a file in the
-  Harwell-Boeing format
+<BR><HR>
+<!--Table of Child-Links-->
+<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>

-<P>
-<BR>
-<IMG
- WIDTH="461" HEIGHT="16" ALIGN="BOTTOM" BORDER="0"
- SRC="img149.png"
- ALT="\begin{lstlisting}
-call hb_read(a, iret, iunit, filename, b, mtitle)
-\end{lstlisting}">
-<BR>
-
-<P>
-<DL>
-<DT><STRONG>Type:</STRONG></DT>
-<DD>Asynchronous.
-</DD>
-<DT><STRONG><B>On Entry </B></STRONG></DT>
-<DD>
-</DD>
-<DT><STRONG>filename</STRONG></DT>
-<DD>The name of the file to be read.
-<BR>
-Type:<B>optional</B>.
-<BR>
-Specified as: a character variable containing a valid file name, or
-<code>-</code>, in which case the default input unit  5 (i.e. standard input
-in Unix jargon) is used. Default: <code>-</code>. 
-</DD>
-<DT><STRONG>iunit</STRONG></DT>
-<DD>The Fortran file unit number.
-<BR>
-Type:<B>optional</B>.
-<BR>
-Specified as: an integer value. Only meaningful if filename is not <code>-</code>.
-</DD>
-</DL>
-
-<P>
-<DL>
-<DT><STRONG><B>On Return</B></STRONG></DT>
-<DD>
-</DD>
-<DT><STRONG>a</STRONG></DT>
-<DD>the sparse matrix read from file.
-<BR>
-Type:<B>required</B>.
-<BR>
-Specified as: a structured data of type spdata<TT>psb_Tspmat_type</TT>.
-</DD>
-<DT><STRONG>b</STRONG></DT>
-<DD>Rigth hand side(s).
-<BR>
-Type: <B>Optional</B> 
-<BR>
-An  array of type real or complex, rank 2 and having the ALLOCATABLE
-attribute; will be allocated and filled in if the input file contains
-a right hand side, otherwise will be left in the UNALLOCATED state. 
-</DD>
-<DT><STRONG>mtitle</STRONG></DT>
-<DD>Matrix title.
-<BR>
-Type: <B>Optional</B> 
-<BR>
-A charachter variable of length 72 holding a copy of the
-matrix title as specified by the Harwell-Boeing format and contained
-in the input file.
-</DD>
-<DT><STRONG>iret</STRONG></DT>
-<DD>Error code.
-<BR>
-Type: <B>required</B> 
-<BR>
-An integer value; 0 means no error has been detected. 
-</DD>
-</DL>
-
-<P>
-ifstarsubroutinesubroutinehb_writeWrite a sparse matrix to a  file
-  in the Harwell-Boeing format
-
-<P>
-<BR>
-<IMG
- WIDTH="538" HEIGHT="16" ALIGN="BOTTOM" BORDER="0"
- SRC="img150.png"
- ALT="\begin{lstlisting}
-call hb_write(a, iret, iunit, filename, key, rhs, mtitle)
-\end{lstlisting}">
-<BR>
-
-<P>
-<DL>
-<DT><STRONG>Type:</STRONG></DT>
-<DD>Asynchronous.
-</DD>
-<DT><STRONG><B>On Entry </B></STRONG></DT>
-<DD>
-</DD>
-<DT><STRONG>a</STRONG></DT>
-<DD>the sparse matrix to be written.
-<BR>
-Type:<B>required</B>.
-<BR>
-Specified as: a structured data of type spdata<TT>psb_Tspmat_type</TT>.
-</DD>
-<DT><STRONG>b</STRONG></DT>
-<DD>Rigth hand side.
-<BR>
-Type: <B>Optional</B> 
-<BR>
-An  array of type real or complex, rank 1 and having the ALLOCATABLE
-attribute; will be allocated and filled in if the input file contains
-a right hand side. 
-</DD>
-<DT><STRONG>filename</STRONG></DT>
-<DD>The name of the file to be written to.
-<BR>
-Type:<B>optional</B>.
-<BR>
-Specified as: a character variable containing a valid file name, or
-<code>-</code>, in which case the default output unit  6 (i.e. standard output
-in Unix jargon) is used. Default: <code>-</code>. 
-</DD>
-<DT><STRONG>iunit</STRONG></DT>
-<DD>The Fortran file unit number.
-<BR>
-Type:<B>optional</B>.
-<BR>
-Specified as: an integer value. Only meaningful if filename is not <code>-</code>.
-</DD>
-<DT><STRONG>key</STRONG></DT>
-<DD>Matrix key.
-<BR>
-Type: <B>Optional</B> 
-<BR>
-A charachter variable of length 8 holding the
-matrix key as specified by the Harwell-Boeing format and to be
-written to file.
-</DD>
-<DT><STRONG>mtitle</STRONG></DT>
-<DD>Matrix title.
-<BR>
-Type: <B>Optional</B> 
-<BR>
-A charachter variable of length 72 holding the
-matrix title as specified by the Harwell-Boeing format and to be
-written to file.
-</DD>
-</DL>
-
-<P>
-<DL>
-<DT><STRONG><B>On Return</B></STRONG></DT>
-<DD>
-</DD>
-<DT><STRONG>iret</STRONG></DT>
-<DD>Error code.
-<BR>
-Type: <B>required</B> 
-<BR>
-An integer value; 0 means no error has been detected. 
-</DD>
-</DL>
-
-<P>
-ifstarsubroutinesubroutinemm_mat_readRead a sparse matrix from a
-  file in the MatrixMarket format
-
-<P>
-<BR>
-<IMG
- WIDTH="394" HEIGHT="16" ALIGN="BOTTOM" BORDER="0"
- SRC="img151.png"
- ALT="\begin{lstlisting}
-call mm_mat_read(a, iret, iunit, filename)
-\end{lstlisting}">
-<BR>
-
-<P>
-<DL>
-<DT><STRONG>Type:</STRONG></DT>
-<DD>Asynchronous.
-</DD>
-<DT><STRONG><B>On Entry </B></STRONG></DT>
-<DD>
-</DD>
-<DT><STRONG>filename</STRONG></DT>
-<DD>The name of the file to be read.
-<BR>
-Type:<B>optional</B>.
-<BR>
-Specified as: a character variable containing a valid file name, or
-<code>-</code>, in which case the default input unit  5 (i.e. standard input
-in Unix jargon) is used. Default: <code>-</code>. 
-</DD>
-<DT><STRONG>iunit</STRONG></DT>
-<DD>The Fortran file unit number.
-<BR>
-Type:<B>optional</B>.
-<BR>
-Specified as: an integer value. Only meaningful if filename is not <code>-</code>.
-</DD>
-</DL>
-
-<P>
-<DL>
-<DT><STRONG><B>On Return</B></STRONG></DT>
-<DD>
-</DD>
-<DT><STRONG>a</STRONG></DT>
-<DD>the sparse matrix read from file.
-<BR>
-Type:<B>required</B>.
-<BR>
-Specified as: a structured data of type spdata<TT>psb_Tspmat_type</TT>.
-</DD>
-<DT><STRONG>iret</STRONG></DT>
-<DD>Error code.
-<BR>
-Type: <B>required</B> 
-<BR>
-An integer value; 0 means no error has been detected. 
-</DD>
-</DL>
-
-<P>
-ifstarsubroutinesubroutinemm_vet_readRead a dense vector from a
-  file in the MatrixMarket format
-<BR>
-<IMG
- WIDTH="394" HEIGHT="16" ALIGN="BOTTOM" BORDER="0"
- SRC="img152.png"
- ALT="\begin{lstlisting}
-call mm_vet_read(b, iret, iunit, filename)
-\end{lstlisting}">
-<BR>
-
-<P>
-<DL>
-<DT><STRONG>Type:</STRONG></DT>
-<DD>Asynchronous.
-</DD>
-<DT><STRONG><B>On Entry </B></STRONG></DT>
-<DD>
-</DD>
-<DT><STRONG>filename</STRONG></DT>
-<DD>The name of the file to be read.
-<BR>
-Type:<B>optional</B>.
-<BR>
-Specified as: a character variable containing a valid file name, or
-<code>-</code>, in which case the default input unit  5 (i.e. standard input
-in Unix jargon) is used. Default: <code>-</code>. 
-</DD>
-<DT><STRONG>iunit</STRONG></DT>
-<DD>The Fortran file unit number.
-<BR>
-Type:<B>optional</B>.
-<BR>
-Specified as: an integer value. Only meaningful if filename is not <code>-</code>.
-</DD>
-</DL>
-
-<P>
-<DL>
-<DT><STRONG><B>On Return</B></STRONG></DT>
-<DD>
-</DD>
-<DT><STRONG>b</STRONG></DT>
-<DD>Rigth hand side(s).
-<BR>
-Type: <B>required</B> 
-<BR>
-An  array of type real or complex, rank 2 and having the ALLOCATABLE
-attribute; will be allocated and filled in if the input file contains
-a right hand side, otherwise will be left in the UNALLOCATED state. 
-</DD>
-<DT><STRONG>iret</STRONG></DT>
-<DD>Error code.
-<BR>
-Type: <B>required</B> 
-<BR>
-An integer value; 0 means no error has been detected. 
-</DD>
-</DL>
-
-<P>
-ifstarsubroutinesubroutinemm_mat_writeWrite a sparse matrix to a
-  file in the MatrixMarket format
-<BR>
-<IMG
- WIDTH="480" HEIGHT="16" ALIGN="BOTTOM" BORDER="0"
- SRC="img153.png"
- ALT="\begin{lstlisting}
-call mm_mat_write(a, mtitle, iret, iunit, filename)
-\end{lstlisting}">
-<BR>
-<DL>
-<DT><STRONG>Type:</STRONG></DT>
-<DD>Asynchronous.
-</DD>
-<DT><STRONG><B>On Entry </B></STRONG></DT>
-<DD>
-</DD>
-<DT><STRONG>a</STRONG></DT>
-<DD>the sparse matrix to be written.
-<BR>
-Type:<B>required</B>.
-<BR>
-Specified as: a structured data of type spdata<TT>psb_Tspmat_type</TT>.
-</DD>
-<DT><STRONG>mtitle</STRONG></DT>
-<DD>Matrix title.
-<BR>
-Type: <B>required</B> 
-<BR>
-A charachter variable holding a descriptive title for the matrix to be
- written to file.
-</DD>
-<DT><STRONG>filename</STRONG></DT>
-<DD>The name of the file to be written to.
-<BR>
-Type:<B>optional</B>.
-<BR>
-Specified as: a character variable containing a valid file name, or
-<code>-</code>, in which case the default output unit  6 (i.e. standard output
-in Unix jargon) is used. Default: <code>-</code>. 
-</DD>
-<DT><STRONG>iunit</STRONG></DT>
-<DD>The Fortran file unit number.
-<BR>
-Type:<B>optional</B>.
-<BR>
-Specified as: an integer value. Only meaningful if filename is not <code>-</code>.
-</DD>
-</DL>
-
-<P>
-<DL>
-<DT><STRONG><B>On Return</B></STRONG></DT>
-<DD>
-</DD>
-<DT><STRONG>iret</STRONG></DT>
-<DD>Error code.
-<BR>
-Type: <B>required</B> 
-<BR>
-An integer value; 0 means no error has been detected. 
-</DD>
-</DL>
-
-<P>
-<HR>
-<!--Navigation Panel-->
-<A NAME="tex2html1633"
-  HREF="node113.html">
-<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html1629"
-  HREF="userhtml.html">
-<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1623"
-  HREF="node111.html">
-<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1631"
-  HREF="node1.html">
-<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
-<BR>
-<B> Next:</B> <A NAME="tex2html1634"
-  HREF="node113.html">Preconditioner routines</A>
-<B> Up:</B> <A NAME="tex2html1630"
-  HREF="userhtml.html">userhtml</A>
-<B> Previous:</B> <A NAME="tex2html1624"
-  HREF="node111.html">Error handling</A>
- &nbsp; <B>  <A NAME="tex2html1632"
-  HREF="node1.html">Contents</A></B> 
-<!--End of Navigation Panel-->
+<UL>
+<LI><A NAME="tex2html1641"
+  HREF="node113.html">hb_read -- Read a sparse matrix from a file in the
+  Harwell-Boeing format</A>
+<LI><A NAME="tex2html1642"
+  HREF="node114.html">hb_write -- Write a sparse matrix to a  file
+  in the Harwell-Boeing format</A>
+<LI><A NAME="tex2html1643"
+  HREF="node115.html">mm_mat_read -- Read a sparse matrix from a
+  file in the MatrixMarket format</A>
+<LI><A NAME="tex2html1644"
+  HREF="node116.html">mm_array_read -- Read a dense array from a
+  file in the MatrixMarket format</A>
+<LI><A NAME="tex2html1645"
+  HREF="node117.html">mm_mat_write -- Write a sparse matrix to a
+  file in the MatrixMarket format</A>
+<LI><A NAME="tex2html1646"
+  HREF="node118.html">mm_array_write --  Write a dense array from a
+  file in the MatrixMarket format</A>
+</UL>
+<!--End of Table of Child-Links-->
+<BR><HR>

 </BODY>
 </HTML>
@@ -7,8 +7,8 @@ original version by:  Nikos Drakos, CBLU, University of Leeds
  Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
 <HTML>
 <HEAD>
-<TITLE>Preconditioner routines</TITLE>
-<META NAME="description" CONTENT="Preconditioner routines">
+<TITLE>hb_read -- Read a sparse matrix from a file in the Harwell-Boeing format</TITLE>
+<META NAME="description" CONTENT="hb_read -- Read a sparse matrix from a file in the Harwell-Boeing format">
 <META NAME="keywords" CONTENT="userhtml">
 <META NAME="resource-type" CONTENT="document">
 <META NAME="distribution" CONTENT="global">
@@ -18,80 +18,144 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <LINK REL="STYLESHEET" HREF="userhtml.css">

-<LINK REL="next" HREF="node119.html">
+<LINK REL="next" HREF="node114.html">
 <LINK REL="previous" HREF="node112.html">
-<LINK REL="up" HREF="userhtml.html">
+<LINK REL="up" HREF="node112.html">
 <LINK REL="next" HREF="node114.html">
 </HEAD>

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html1645"
+<A NAME="tex2html1657"
  HREF="node114.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html1641"
-  HREF="userhtml.html">
+<A NAME="tex2html1653"
+  HREF="node112.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1635"
+<A NAME="tex2html1647"
  HREF="node112.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1643"
+<A NAME="tex2html1655"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html1646"
-  HREF="node114.html">psb_precinit   Initialize</A>
-<B> Up:</B> <A NAME="tex2html1642"
-  HREF="userhtml.html">userhtml</A>
-<B> Previous:</B> <A NAME="tex2html1636"
+<B> Next:</B> <A NAME="tex2html1658"
+  HREF="node114.html">hb_write   Write</A>
+<B> Up:</B> <A NAME="tex2html1654"
  HREF="node112.html">Utilities</A>
- &nbsp; <B>  <A NAME="tex2html1644"
+<B> Previous:</B> <A NAME="tex2html1648"
+  HREF="node112.html">Utilities</A>
+ &nbsp; <B>  <A NAME="tex2html1656"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
 <!--End of Navigation Panel-->

-<H1><A NAME="SECTION000110000000000000000"></A>
-<A NAME="sec:precs"></A>
+<H2><A NAME="SECTION000101000000000000000">
+ hb_read -- Read a sparse matrix from a file in the
+  Harwell-Boeing format</A>
+</H2>
+
+<P>
+<BR>
+<IMG
+ WIDTH="461" HEIGHT="16" ALIGN="BOTTOM" BORDER="0"
+ SRC="img149.png"
+ ALT="\begin{lstlisting}
+call hb_read(a, iret, iunit, filename, b, mtitle)
+\end{lstlisting}">
 <BR>
-Preconditioner routines
-</H1>

 <P>
-<A NAME="sec:psprecs"></A>The base PSBLAS library  contains the implementation of two simple
-preconditioning techniques:
-
-<UL>
-<LI>Diagonal Scaling
-</LI>
-<LI>Block Jacobi with ILU(0) factorization
-</LI>
-</UL>
-The supporting data type and subroutine interfaces are defined in the
-module  <code>psb_prec_mod</code>.
+<DL>
+<DT><STRONG>Type:</STRONG></DT>
+<DD>Asynchronous.
+</DD>
+<DT><STRONG><B>On Entry </B></STRONG></DT>
+<DD>
+</DD>
+<DT><STRONG>filename</STRONG></DT>
+<DD>The name of the file to be read.
+<BR>
+Type:<B>optional</B>.
+<BR>
+Specified as: a character variable containing a valid file name, or
+<code>-</code>, in which case the default input unit  5 (i.e. standard input
+in Unix jargon) is used. Default: <code>-</code>. 
+</DD>
+<DT><STRONG>iunit</STRONG></DT>
+<DD>The Fortran file unit number.
+<BR>
+Type:<B>optional</B>.
+<BR>
+Specified as: an integer value. Only meaningful if filename is not <code>-</code>.
+</DD>
+</DL>

 <P>
-<BR><HR>
-<!--Table of Child-Links-->
-<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>
+<DL>
+<DT><STRONG><B>On Return</B></STRONG></DT>
+<DD>
+</DD>
+<DT><STRONG>a</STRONG></DT>
+<DD>the sparse matrix read from file.
+<BR>
+Type:<B>required</B>.
+<BR>
+Specified as: a structured data of type spdata<TT>psb_Tspmat_type</TT>.
+</DD>
+<DT><STRONG>b</STRONG></DT>
+<DD>Rigth hand side(s).
+<BR>
+Type: <B>Optional</B> 
+<BR>
+An  array of type real or complex, rank 2 and having the ALLOCATABLE
+attribute; will be allocated and filled in if the input file contains
+a right hand side, otherwise will be left in the UNALLOCATED state. 
+</DD>
+<DT><STRONG>mtitle</STRONG></DT>
+<DD>Matrix title.
+<BR>
+Type: <B>Optional</B> 
+<BR>
+A charachter variable of length 72 holding a copy of the
+matrix title as specified by the Harwell-Boeing format and contained
+in the input file.
+</DD>
+<DT><STRONG>iret</STRONG></DT>
+<DD>Error code.
+<BR>
+Type: <B>required</B> 
+<BR>
+An integer value; 0 means no error has been detected. 
+</DD>
+</DL>

-<UL>
-<LI><A NAME="tex2html1647"
-  HREF="node114.html">psb_precinit -- Initialize a  preconditioner</A>
-<LI><A NAME="tex2html1648"
-  HREF="node115.html">psb_precbld -- Builds a preconditioner</A>
-<LI><A NAME="tex2html1649"
-  HREF="node116.html">psb_precaply -- Preconditioner application
-  routine</A>
-<LI><A NAME="tex2html1650"
-  HREF="node117.html">psb_precdescr -- Prints a description of current
-  preconditioner</A>
-<LI><A NAME="tex2html1651"
-  HREF="node118.html">clone -- clone  current
-  preconditioner</A>
-</UL>
-<!--End of Table of Child-Links-->
-<BR><HR>
+<P>
+<HR>
+<!--Navigation Panel-->
+<A NAME="tex2html1657"
+  HREF="node114.html">
+<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
+<A NAME="tex2html1653"
+  HREF="node112.html">
+<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
+<A NAME="tex2html1647"
+  HREF="node112.html">
+<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
+<A NAME="tex2html1655"
+  HREF="node1.html">
+<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
+<BR>
+<B> Next:</B> <A NAME="tex2html1658"
+  HREF="node114.html">hb_write   Write</A>
+<B> Up:</B> <A NAME="tex2html1654"
+  HREF="node112.html">Utilities</A>
+<B> Previous:</B> <A NAME="tex2html1648"
+  HREF="node112.html">Utilities</A>
+ &nbsp; <B>  <A NAME="tex2html1656"
+  HREF="node1.html">Contents</A></B> 
+<!--End of Navigation Panel-->

 </BODY>
 </HTML>
@@ -7,8 +7,8 @@ original version by:  Nikos Drakos, CBLU, University of Leeds
  Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
 <HTML>
 <HEAD>
-<TITLE>psb_precinit -- Initialize a preconditioner</TITLE>
-<META NAME="description" CONTENT="psb_precinit -- Initialize a preconditioner">
+<TITLE>hb_write -- Write a sparse matrix to a file in the Harwell-Boeing format</TITLE>
+<META NAME="description" CONTENT="hb_write -- Write a sparse matrix to a file in the Harwell-Boeing format">
 <META NAME="keywords" CONTENT="userhtml">
 <META NAME="resource-type" CONTENT="document">
 <META NAME="distribution" CONTENT="global">
@@ -20,123 +20,151 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <LINK REL="next" HREF="node115.html">
 <LINK REL="previous" HREF="node113.html">
-<LINK REL="up" HREF="node113.html">
+<LINK REL="up" HREF="node112.html">
 <LINK REL="next" HREF="node115.html">
 </HEAD>

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html1662"
+<A NAME="tex2html1669"
  HREF="node115.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html1658"
-  HREF="node113.html">
+<A NAME="tex2html1665"
+  HREF="node112.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1652"
+<A NAME="tex2html1659"
  HREF="node113.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1660"
+<A NAME="tex2html1667"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html1663"
-  HREF="node115.html">psb_precbld   Builds</A>
-<B> Up:</B> <A NAME="tex2html1659"
-  HREF="node113.html">Preconditioner routines</A>
-<B> Previous:</B> <A NAME="tex2html1653"
-  HREF="node113.html">Preconditioner routines</A>
- &nbsp; <B>  <A NAME="tex2html1661"
+<B> Next:</B> <A NAME="tex2html1670"
+  HREF="node115.html">mm_mat_read   Read</A>
+<B> Up:</B> <A NAME="tex2html1666"
+  HREF="node112.html">Utilities</A>
+<B> Previous:</B> <A NAME="tex2html1660"
+  HREF="node113.html">hb_read   Read</A>
+ &nbsp; <B>  <A NAME="tex2html1668"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
 <!--End of Navigation Panel-->

-<H2><A NAME="SECTION000111000000000000000">
-psb_precinit -- Initialize a  preconditioner</A>
+<H2><A NAME="SECTION000102000000000000000">
+hb_write -- Write a sparse matrix to a  file
+  in the Harwell-Boeing format</A>
 </H2>

 <P>
-<PRE>
-call psb_precinit(prec, ptype, info)
-</PRE>
+<BR>
+<IMG
+ WIDTH="538" HEIGHT="16" ALIGN="BOTTOM" BORDER="0"
+ SRC="img150.png"
+ ALT="\begin{lstlisting}
+call hb_write(a, iret, iunit, filename, key, rhs, mtitle)
+\end{lstlisting}">
+<BR>

 <P>
 <DL>
 <DT><STRONG>Type:</STRONG></DT>
 <DD>Asynchronous.
 </DD>
-<DT><STRONG><B>On Entry</B></STRONG></DT>
+<DT><STRONG><B>On Entry </B></STRONG></DT>
 <DD>
 </DD>
-<DT><STRONG>ptype</STRONG></DT>
-<DD>the type of preconditioner. 
-Scope: <B>global</B> 
+<DT><STRONG>a</STRONG></DT>
+<DD>the sparse matrix to be written.
 <BR>
-Type: <B>required</B>
+Type:<B>required</B>.
 <BR>
-Intent: <B>in</B>.
-<BR>
-Specified as: a character string, see usage notes.
+Specified as: a structured data of type spdata<TT>psb_Tspmat_type</TT>.
 </DD>
-<DT><STRONG><B>On Exit</B></STRONG></DT>
-<DD><P>
+<DT><STRONG>b</STRONG></DT>
+<DD>Rigth hand side.
+<BR>
+Type: <B>Optional</B> 
+<BR>
+An  array of type real or complex, rank 1 and having the ALLOCATABLE
+attribute; will be allocated and filled in if the input file contains
+a right hand side. 
 </DD>
-<DT><STRONG>prec</STRONG></DT>
-<DD>Scope: <B>local</B> 
+<DT><STRONG>filename</STRONG></DT>
+<DD>The name of the file to be written to.
 <BR>
-Type: <B>required</B>
+Type:<B>optional</B>.
 <BR>
-Intent: <B>inout</B>.
-<BR>
-Specified as: a preconditioner data structure precdata<TT>psb_prec_type</TT>.
+Specified as: a character variable containing a valid file name, or
+<code>-</code>, in which case the default output unit  6 (i.e. standard output
+in Unix jargon) is used. Default: <code>-</code>. 
 </DD>
-<DT><STRONG>info</STRONG></DT>
-<DD>Scope: <B>global</B> 
+<DT><STRONG>iunit</STRONG></DT>
+<DD>The Fortran file unit number.
 <BR>
-Type: <B>required</B>
+Type:<B>optional</B>.
 <BR>
-Intent: <B>out</B>.
+Specified as: an integer value. Only meaningful if filename is not <code>-</code>.
+</DD>
+<DT><STRONG>key</STRONG></DT>
+<DD>Matrix key.
 <BR>
-Error code: if no error, 0 is returned.
+Type: <B>Optional</B> 
+<BR>
+A charachter variable of length 8 holding the
+matrix key as specified by the Harwell-Boeing format and to be
+written to file.
 </DD>
-</DL>
-<FONT SIZE="+1"><B>Notes</B></FONT>
-Legal inputs to this subroutine are interpreted depending on the
-<IMG
- WIDTH="41" HEIGHT="30" ALIGN="MIDDLE" BORDER="0"
- SRC="img154.png"
- ALT="$ptype$"> string as follows<A NAME="tex2html30"
-  HREF="footnode.html#foot7420"><SUP>3</SUP></A>:
-<DL>
-<DT><STRONG>NONE</STRONG></DT>
-<DD>No preconditioning, i.e. the preconditioner is just a copy
-  operator.
-</DD>
-<DT><STRONG>DIAG</STRONG></DT>
-<DD>Diagonal scaling; each entry of the input vector is
-  multiplied by the reciprocal of the sum of the absolute values of
-  the coefficients in the corresponding row of matrix  <IMG
- WIDTH="16" HEIGHT="14" ALIGN="BOTTOM" BORDER="0"
- SRC="img1.png"
- ALT="$A$">;
-</DD>
-<DT><STRONG>BJAC</STRONG></DT>
-<DD>Precondition by a  factorization of the
-  block-diagonal of matrix <IMG
- WIDTH="16" HEIGHT="14" ALIGN="BOTTOM" BORDER="0"
- SRC="img1.png"
- ALT="$A$">, where block boundaries are determined
-  by the data allocation boundaries for each process; requires no
-  communication. Only the incomplete factorization <IMG
- WIDTH="56" HEIGHT="32" ALIGN="MIDDLE" BORDER="0"
- SRC="img155.png"
- ALT="$ILU(0)$"> is
-  currently implemented.  
+<DT><STRONG>mtitle</STRONG></DT>
+<DD>Matrix title.
+<BR>
+Type: <B>Optional</B> 
+<BR>
+A charachter variable of length 72 holding the
+matrix title as specified by the Harwell-Boeing format and to be
+written to file.
 </DD>
 </DL>

 <P>
-<BR><HR>
+<DL>
+<DT><STRONG><B>On Return</B></STRONG></DT>
+<DD>
+</DD>
+<DT><STRONG>iret</STRONG></DT>
+<DD>Error code.
+<BR>
+Type: <B>required</B> 
+<BR>
+An integer value; 0 means no error has been detected. 
+</DD>
+</DL>
+
+<P>
+<HR>
+<!--Navigation Panel-->
+<A NAME="tex2html1669"
+  HREF="node115.html">
+<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
+<A NAME="tex2html1665"
+  HREF="node112.html">
+<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
+<A NAME="tex2html1659"
+  HREF="node113.html">
+<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
+<A NAME="tex2html1667"
+  HREF="node1.html">
+<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
+<BR>
+<B> Next:</B> <A NAME="tex2html1670"
+  HREF="node115.html">mm_mat_read   Read</A>
+<B> Up:</B> <A NAME="tex2html1666"
+  HREF="node112.html">Utilities</A>
+<B> Previous:</B> <A NAME="tex2html1660"
+  HREF="node113.html">hb_read   Read</A>
+ &nbsp; <B>  <A NAME="tex2html1668"
+  HREF="node1.html">Contents</A></B> 
+<!--End of Navigation Panel-->

 </BODY>
 </HTML>
@@ -7,8 +7,8 @@ original version by:  Nikos Drakos, CBLU, University of Leeds
  Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
 <HTML>
 <HEAD>
-<TITLE>psb_precbld -- Builds a preconditioner</TITLE>
-<META NAME="description" CONTENT="psb_precbld -- Builds a preconditioner">
+<TITLE>mm_mat_read -- Read a sparse matrix from a file in the MatrixMarket format</TITLE>
+<META NAME="description" CONTENT="mm_mat_read -- Read a sparse matrix from a file in the MatrixMarket format">
 <META NAME="keywords" CONTENT="userhtml">
 <META NAME="resource-type" CONTENT="document">
 <META NAME="distribution" CONTENT="global">
@@ -20,108 +20,75 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <LINK REL="next" HREF="node116.html">
 <LINK REL="previous" HREF="node114.html">
-<LINK REL="up" HREF="node113.html">
+<LINK REL="up" HREF="node112.html">
 <LINK REL="next" HREF="node116.html">
 </HEAD>

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html1674"
+<A NAME="tex2html1681"
  HREF="node116.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html1670"
-  HREF="node113.html">
+<A NAME="tex2html1677"
+  HREF="node112.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1664"
+<A NAME="tex2html1671"
  HREF="node114.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1672"
+<A NAME="tex2html1679"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html1675"
-  HREF="node116.html">psb_precaply   Preconditioner</A>
-<B> Up:</B> <A NAME="tex2html1671"
-  HREF="node113.html">Preconditioner routines</A>
-<B> Previous:</B> <A NAME="tex2html1665"
-  HREF="node114.html">psb_precinit   Initialize</A>
- &nbsp; <B>  <A NAME="tex2html1673"
+<B> Next:</B> <A NAME="tex2html1682"
+  HREF="node116.html">mm_array_read   Read</A>
+<B> Up:</B> <A NAME="tex2html1678"
+  HREF="node112.html">Utilities</A>
+<B> Previous:</B> <A NAME="tex2html1672"
+  HREF="node114.html">hb_write   Write</A>
+ &nbsp; <B>  <A NAME="tex2html1680"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
 <!--End of Navigation Panel-->

-<H2><A NAME="SECTION000112000000000000000">
-psb_precbld -- Builds a preconditioner</A>
+<H2><A NAME="SECTION000103000000000000000">
+mm_mat_read -- Read a sparse matrix from a
+  file in the MatrixMarket format</A>
 </H2>

 <P>
-<PRE>
-call psb_precbld(a, desc_a, prec, info,amold,vmold)
-</PRE>
+<BR>
+<IMG
+ WIDTH="394" HEIGHT="16" ALIGN="BOTTOM" BORDER="0"
+ SRC="img151.png"
+ ALT="\begin{lstlisting}
+call mm_mat_read(a, iret, iunit, filename)
+\end{lstlisting}">
+<BR>

 <P>
 <DL>
 <DT><STRONG>Type:</STRONG></DT>
-<DD>Synchronous.
+<DD>Asynchronous.
 </DD>
-<DT><STRONG><B>On Entry</B></STRONG></DT>
+<DT><STRONG><B>On Entry </B></STRONG></DT>
 <DD>
 </DD>
-<DT><STRONG>a</STRONG></DT>
-<DD>the system sparse matrix.
-Scope: <B>local</B> 
+<DT><STRONG>filename</STRONG></DT>
+<DD>The name of the file to be read.
 <BR>
-Type: <B>required</B>
+Type:<B>optional</B>.
 <BR>
-Intent: <B>in</B>, target.
-<BR>
-Specified as: a sparse matrix data structure spdata<TT>psb_Tspmat_type</TT>.
+Specified as: a character variable containing a valid file name, or
+<code>-</code>, in which case the default input unit  5 (i.e. standard input
+in Unix jargon) is used. Default: <code>-</code>. 
 </DD>
-<DT><STRONG>prec</STRONG></DT>
-<DD>the preconditioner.
+<DT><STRONG>iunit</STRONG></DT>
+<DD>The Fortran file unit number.
 <BR>
-Scope: <B>local</B> 
+Type:<B>optional</B>.
 <BR>
-Type: <B>required</B>
-<BR>
-Intent: <B>inout</B>.
-<BR>
-Specified as: an already initialized precondtioner data structure precdata<TT>psb_prec_type</TT>
-<BR></DD>
-<DT><STRONG>desc_a</STRONG></DT>
-<DD>the problem communication descriptor. 
-Scope: <B>local</B> 
-<BR>
-Type: <B>required</B>
-<BR>
-Intent: <B>in</B>, target.
-<BR>
-Specified as: a communication descriptor data structure descdata<TT>psb_desc_type</TT>.
-</DD>
-<DT><STRONG>amold</STRONG></DT>
-<DD>The desired dynamic type for the internal matrix storage.
-<BR>
-Scope: <B>local</B>.
-<BR>
-Type: <B>optional</B>.
-<BR>
-Intent: <B>in</B>.
-<BR>
-Specified as: an object of a class derived from spbasedata<TT>psb_T_base_sparse_mat</TT>. 
-</DD>
-<DT><STRONG>vmold</STRONG></DT>
-<DD>The desired dynamic type for the internal vector storage.
-<BR>
-Scope: <B>local</B>.
-<BR>
-Type: <B>optional</B>.
-<BR>
-Intent: <B>in</B>.
-<BR>
-Specified as: an object of a class derived from vbasedata<TT>psb_T_base_vect_type</TT>. 
-
-<P>
+Specified as: an integer value. Only meaningful if filename is not <code>-</code>.
 </DD>
 </DL>

@@ -130,26 +97,18 @@ Specified as: an object of a class derived from vbasedata<TT>psb_T_base_vect_typ
 <DT><STRONG><B>On Return</B></STRONG></DT>
 <DD>
 </DD>
-<DT><STRONG>prec</STRONG></DT>
-<DD>the preconditioner.
+<DT><STRONG>a</STRONG></DT>
+<DD>the sparse matrix read from file.
 <BR>
-Scope: <B>local</B> 
+Type:<B>required</B>.
 <BR>
-Type: <B>required</B>
-<BR>
-Intent: <B>inout</B>.
-<BR>
-Specified as: a precondtioner data structure precdata<TT>psb_prec_type</TT>
-<BR></DD>
-<DT><STRONG>info</STRONG></DT>
+Specified as: a structured data of type spdata<TT>psb_Tspmat_type</TT>.
+</DD>
+<DT><STRONG>iret</STRONG></DT>
 <DD>Error code.
 <BR>
-Scope: <B>local</B> 
-<BR>
 Type: <B>required</B> 
 <BR>
-Intent: <B>out</B>.
-<BR>
 An integer value; 0 means no error has been detected. 
 </DD>
 </DL>
@@ -7,8 +7,8 @@ original version by:  Nikos Drakos, CBLU, University of Leeds
  Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
 <HTML>
 <HEAD>
-<TITLE>psb_precaply -- Preconditioner application routine</TITLE>
-<META NAME="description" CONTENT="psb_precaply -- Preconditioner application routine">
+<TITLE>mm_array_read -- Read a dense array from a file in the MatrixMarket format</TITLE>
+<META NAME="description" CONTENT="mm_array_read -- Read a dense array from a file in the MatrixMarket format">
 <META NAME="keywords" CONTENT="userhtml">
 <META NAME="resource-type" CONTENT="document">
 <META NAME="distribution" CONTENT="global">
@@ -20,104 +20,75 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <LINK REL="next" HREF="node117.html">
 <LINK REL="previous" HREF="node115.html">
-<LINK REL="up" HREF="node113.html">
+<LINK REL="up" HREF="node112.html">
 <LINK REL="next" HREF="node117.html">
 </HEAD>

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html1686"
+<A NAME="tex2html1693"
  HREF="node117.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html1682"
-  HREF="node113.html">
+<A NAME="tex2html1689"
+  HREF="node112.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1676"
+<A NAME="tex2html1683"
  HREF="node115.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1684"
+<A NAME="tex2html1691"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html1687"
-  HREF="node117.html">psb_precdescr   Prints</A>
-<B> Up:</B> <A NAME="tex2html1683"
-  HREF="node113.html">Preconditioner routines</A>
-<B> Previous:</B> <A NAME="tex2html1677"
-  HREF="node115.html">psb_precbld   Builds</A>
- &nbsp; <B>  <A NAME="tex2html1685"
+<B> Next:</B> <A NAME="tex2html1694"
+  HREF="node117.html">mm_mat_write   Write</A>
+<B> Up:</B> <A NAME="tex2html1690"
+  HREF="node112.html">Utilities</A>
+<B> Previous:</B> <A NAME="tex2html1684"
+  HREF="node115.html">mm_mat_read   Read</A>
+ &nbsp; <B>  <A NAME="tex2html1692"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
 <!--End of Navigation Panel-->

-<H2><A NAME="SECTION000113000000000000000">
-psb_precaply -- Preconditioner application
-  routine</A>
+<H2><A NAME="SECTION000104000000000000000">
+mm_array_read -- Read a dense array from a
+  file in the MatrixMarket format</A>
 </H2>

 <P>
-<PRE>
-call psb_precaply(prec,x,y,desc_a,info,trans,work)
-call psb_precaply(prec,x,desc_a,info,trans)
-</PRE>
+<BR>
+<IMG
+ WIDTH="413" HEIGHT="16" ALIGN="BOTTOM" BORDER="0"
+ SRC="img152.png"
+ ALT="\begin{lstlisting}
+call mm_array_read(b, iret, iunit, filename)
+\end{lstlisting}">
+<BR>

 <P>
 <DL>
 <DT><STRONG>Type:</STRONG></DT>
-<DD>Synchronous.
+<DD>Asynchronous.
 </DD>
-<DT><STRONG><B>On Entry</B></STRONG></DT>
+<DT><STRONG><B>On Entry </B></STRONG></DT>
 <DD>
 </DD>
-<DT><STRONG>prec</STRONG></DT>
-<DD>the preconditioner.
-Scope: <B>local</B> 
+<DT><STRONG>filename</STRONG></DT>
+<DD>The name of the file to be read.
 <BR>
-Type: <B>required</B>
+Type:<B>optional</B>.
 <BR>
-Intent: <B>in</B>.
-<BR>
-Specified as: a preconditioner data structure precdata<TT>psb_prec_type</TT>.
+Specified as: a character variable containing a valid file name, or
+<code>-</code>, in which case the default input unit  5 (i.e. standard input
+in Unix jargon) is used. Default: <code>-</code>. 
 </DD>
-<DT><STRONG>x</STRONG></DT>
-<DD>the source vector.
-Scope: <B>local</B> 
+<DT><STRONG>iunit</STRONG></DT>
+<DD>The Fortran file unit number.
 <BR>
-Type: <B>required</B>
+Type:<B>optional</B>.
 <BR>
-Intent: <B>inout</B>.
-<BR>
-Specified as:  a rank one array or an object of type vdata<TT>psb_T_vect_type</TT>. 
-</DD>
-<DT><STRONG>desc_a</STRONG></DT>
-<DD>the problem communication descriptor.
-Scope: <B>local</B> 
-<BR>
-Type: <B>required</B>
-<BR>
-Intent: <B>in</B>.
-<BR>
-Specified as: a communication data structure descdata<TT>psb_desc_type</TT>.
-</DD>
-<DT><STRONG>trans</STRONG></DT>
-<DD>Scope:  
-<BR>
-Type: <B>optional</B>
-<BR>
-Intent: <B>in</B>.
-<BR>
-Specified as: a character.
-</DD>
-<DT><STRONG>work</STRONG></DT>
-<DD>an optional work space
-Scope: <B>local</B> 
-<BR>
-Type: <B>optional</B>
-<BR>
-Intent: <B>inout</B>.
-<BR>
-Specified as: a double precision array.
+Specified as: an integer value. Only meaningful if filename is not <code>-</code>.
 </DD>
 </DL>

@@ -126,24 +97,19 @@ Specified as: a double precision array.
 <DT><STRONG><B>On Return</B></STRONG></DT>
 <DD>
 </DD>
-<DT><STRONG>y</STRONG></DT>
-<DD>the destination vector.
-Scope: <B>local</B> 
-<BR>
-Type: <B>required</B>
-<BR>
-Intent: <B>inout</B>.
-<BR>
-Specified as:  a rank one array or an object of type vdata<TT>psb_T_vect_type</TT>.
-</DD>
-<DT><STRONG>info</STRONG></DT>
-<DD>Error code.
-<BR>
-Scope: <B>local</B> 
+<DT><STRONG>b</STRONG></DT>
+<DD>Rigth hand side(s).
 <BR>
 Type: <B>required</B> 
 <BR>
-Intent: <B>out</B>.
+An  array of type real or complex, rank 1 or 2 and having the ALLOCATABLE
+attribute; will be allocated and filled in if the input file contains
+a right hand side, otherwise will be left in the UNALLOCATED state. 
+</DD>
+<DT><STRONG>iret</STRONG></DT>
+<DD>Error code.
+<BR>
+Type: <B>required</B> 
 <BR>
 An integer value; 0 means no error has been detected. 
 </DD>
@@ -7,8 +7,8 @@ original version by:  Nikos Drakos, CBLU, University of Leeds
  Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
 <HTML>
 <HEAD>
-<TITLE>psb_precdescr -- Prints a description of current preconditioner</TITLE>
-<META NAME="description" CONTENT="psb_precdescr -- Prints a description of current preconditioner">
+<TITLE>mm_mat_write -- Write a sparse matrix to a file in the MatrixMarket format</TITLE>
+<META NAME="description" CONTENT="mm_mat_write -- Write a sparse matrix to a file in the MatrixMarket format">
 <META NAME="keywords" CONTENT="userhtml">
 <META NAME="resource-type" CONTENT="document">
 <META NAME="distribution" CONTENT="global">
@@ -20,75 +20,102 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <LINK REL="next" HREF="node118.html">
 <LINK REL="previous" HREF="node116.html">
-<LINK REL="up" HREF="node113.html">
+<LINK REL="up" HREF="node112.html">
 <LINK REL="next" HREF="node118.html">
 </HEAD>

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html1698"
+<A NAME="tex2html1705"
  HREF="node118.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html1694"
-  HREF="node113.html">
+<A NAME="tex2html1701"
+  HREF="node112.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1688"
+<A NAME="tex2html1695"
  HREF="node116.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1696"
+<A NAME="tex2html1703"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html1699"
-  HREF="node118.html">clone   clone</A>
-<B> Up:</B> <A NAME="tex2html1695"
-  HREF="node113.html">Preconditioner routines</A>
-<B> Previous:</B> <A NAME="tex2html1689"
-  HREF="node116.html">psb_precaply   Preconditioner</A>
- &nbsp; <B>  <A NAME="tex2html1697"
+<B> Next:</B> <A NAME="tex2html1706"
+  HREF="node118.html">mm_array_write   Write</A>
+<B> Up:</B> <A NAME="tex2html1702"
+  HREF="node112.html">Utilities</A>
+<B> Previous:</B> <A NAME="tex2html1696"
+  HREF="node116.html">mm_array_read   Read</A>
+ &nbsp; <B>  <A NAME="tex2html1704"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
 <!--End of Navigation Panel-->

-<H2><A NAME="SECTION000114000000000000000">
-psb_precdescr -- Prints a description of current
-  preconditioner</A>
+<H2><A NAME="SECTION000105000000000000000">
+mm_mat_write -- Write a sparse matrix to a
+  file in the MatrixMarket format</A>
 </H2>

 <P>
-<PRE>
-call psb_precdescr(prec)
-call psb_precdescr(prec, iout)
-</PRE>
-
-<P>
+<BR>
+<IMG
+ WIDTH="480" HEIGHT="16" ALIGN="BOTTOM" BORDER="0"
+ SRC="img153.png"
+ ALT="\begin{lstlisting}
+call mm_mat_write(a, mtitle, iret, iunit, filename)
+\end{lstlisting}">
+<BR>
 <DL>
 <DT><STRONG>Type:</STRONG></DT>
 <DD>Asynchronous.
 </DD>
-<DT><STRONG><B>On Entry</B></STRONG></DT>
+<DT><STRONG><B>On Entry </B></STRONG></DT>
 <DD>
 </DD>
-<DT><STRONG>prec</STRONG></DT>
-<DD>the preconditioner.
-Scope: <B>local</B> 
+<DT><STRONG>a</STRONG></DT>
+<DD>the sparse matrix to be written.
 <BR>
-Type: <B>required</B>
+Type:<B>required</B>.
 <BR>
-Intent: <B>in</B>.
-<BR>
-Specified as: a preconditioner data structure precdata<TT>psb_prec_type</TT>.
+Specified as: a structured data of type spdata<TT>psb_Tspmat_type</TT>.
 </DD>
-<DT><STRONG>iout</STRONG></DT>
-<DD>output unit.
-Scope: <B>local</B> 
+<DT><STRONG>mtitle</STRONG></DT>
+<DD>Matrix title.
 <BR>
-Type: <B>optiona</B>
+Type: <B>required</B> 
 <BR>
-Intent: <B>in</B>.
+A charachter variable holding a descriptive title for the matrix to be
+ written to file.
+</DD>
+<DT><STRONG>filename</STRONG></DT>
+<DD>The name of the file to be written to.
 <BR>
-Specified as: an integer number. 
+Type:<B>optional</B>.
+<BR>
+Specified as: a character variable containing a valid file name, or
+<code>-</code>, in which case the default output unit  6 (i.e. standard output
+in Unix jargon) is used. Default: <code>-</code>. 
+</DD>
+<DT><STRONG>iunit</STRONG></DT>
+<DD>The Fortran file unit number.
+<BR>
+Type:<B>optional</B>.
+<BR>
+Specified as: an integer value. Only meaningful if filename is not <code>-</code>.
+</DD>
+</DL>
+
+<P>
+<DL>
+<DT><STRONG><B>On Return</B></STRONG></DT>
+<DD>
+</DD>
+<DT><STRONG>iret</STRONG></DT>
+<DD>Error code.
+<BR>
+Type: <B>required</B> 
+<BR>
+An integer value; 0 means no error has been detected. 
 </DD>
 </DL>

@@ -7,8 +7,8 @@ original version by:  Nikos Drakos, CBLU, University of Leeds
  Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
 <HTML>
 <HEAD>
-<TITLE>clone -- clone current preconditioner</TITLE>
-<META NAME="description" CONTENT="clone -- clone current preconditioner">
+<TITLE>mm_array_write -- Write a dense array from a file in the MatrixMarket format</TITLE>
+<META NAME="description" CONTENT="mm_array_write -- Write a dense array from a file in the MatrixMarket format">
 <META NAME="keywords" CONTENT="userhtml">
 <META NAME="resource-type" CONTENT="document">
 <META NAME="distribution" CONTENT="global">
@@ -19,59 +19,82 @@ original version by:  Nikos Drakos, CBLU, University of Leeds
 <LINK REL="STYLESHEET" HREF="userhtml.css">

 <LINK REL="previous" HREF="node117.html">
-<LINK REL="up" HREF="node113.html">
+<LINK REL="up" HREF="node112.html">
 <LINK REL="next" HREF="node119.html">
 </HEAD>

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html1708"
+<A NAME="tex2html1715"
  HREF="node119.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html1704"
-  HREF="node113.html">
+<A NAME="tex2html1711"
+  HREF="node112.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1700"
+<A NAME="tex2html1707"
  HREF="node117.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1706"
+<A NAME="tex2html1713"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html1709"
-  HREF="node119.html">Iterative Methods</A>
-<B> Up:</B> <A NAME="tex2html1705"
-  HREF="node113.html">Preconditioner routines</A>
-<B> Previous:</B> <A NAME="tex2html1701"
-  HREF="node117.html">psb_precdescr   Prints</A>
- &nbsp; <B>  <A NAME="tex2html1707"
+<B> Next:</B> <A NAME="tex2html1716"
+  HREF="node119.html">Preconditioner routines</A>
+<B> Up:</B> <A NAME="tex2html1712"
+  HREF="node112.html">Utilities</A>
+<B> Previous:</B> <A NAME="tex2html1708"
+  HREF="node117.html">mm_mat_write   Write</A>
+ &nbsp; <B>  <A NAME="tex2html1714"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
 <!--End of Navigation Panel-->

-<H2><A NAME="SECTION000115000000000000000">
-clone -- clone  current
-  preconditioner</A>
+<H2><A NAME="SECTION000106000000000000000">
+mm_array_write --  Write a dense array from a
+  file in the MatrixMarket format</A>
 </H2>

-<PRE>
-call  prec%clone(precout,info)
-</PRE>
+<P>
+<BR>
+<IMG
+ WIDTH="423" HEIGHT="16" ALIGN="BOTTOM" BORDER="0"
+ SRC="img154.png"
+ ALT="\begin{lstlisting}
+call mm_array_write(b, iret, iunit, filename)
+\end{lstlisting}">
+<BR>

 <P>
 <DL>
 <DT><STRONG>Type:</STRONG></DT>
 <DD>Asynchronous.
 </DD>
-<DT><STRONG><B>On Entry</B></STRONG></DT>
+<DT><STRONG><B>On Entry </B></STRONG></DT>
 <DD>
 </DD>
-<DT><STRONG>prec</STRONG></DT>
-<DD>the preconditioner.
+<DT><STRONG>b</STRONG></DT>
+<DD>Rigth hand side(s).
 <BR>
-Scope: <B>local</B>.
-<BR></DD>
+Type: <B>required</B> 
+<BR>
+An  array of type real or complex, rank 1 or 2; will be written.. </DD>
+<DT><STRONG>filename</STRONG></DT>
+<DD>The name of the file to be written.
+<BR>
+Type:<B>optional</B>.
+<BR>
+Specified as: a character variable containing a valid file name, or
+<code>-</code>, in which case the default input unit  5 (i.e. standard input
+in Unix jargon) is used. Default: <code>-</code>. 
+</DD>
+<DT><STRONG>iunit</STRONG></DT>
+<DD>The Fortran file unit number.
+<BR>
+Type:<B>optional</B>.
+<BR>
+Specified as: an integer value. Only meaningful if filename is not <code>-</code>.
+</DD>
 </DL>

 <P>
@@ -79,11 +102,12 @@ Scope: <B>local</B>.
 <DT><STRONG><B>On Return</B></STRONG></DT>
 <DD>
 </DD>
-<DT><STRONG>precout</STRONG></DT>
-<DD>A copy of the input object.
-</DD>
-<DT><STRONG>info</STRONG></DT>
-<DD>Return code. 
+<DT><STRONG>iret</STRONG></DT>
+<DD>Error code.
+<BR>
+Type: <B>required</B> 
+<BR>
+An integer value; 0 means no error has been detected. 
 </DD>
 </DL>

@@ -7,8 +7,8 @@ original version by:  Nikos Drakos, CBLU, University of Leeds
  Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
 <HTML>
 <HEAD>
-<TITLE>Iterative Methods</TITLE>
-<META NAME="description" CONTENT="Iterative Methods">
+<TITLE>Preconditioner routines</TITLE>
+<META NAME="description" CONTENT="Preconditioner routines">
 <META NAME="keywords" CONTENT="userhtml">
 <META NAME="resource-type" CONTENT="document">
 <META NAME="distribution" CONTENT="global">
@@ -18,49 +18,57 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <LINK REL="STYLESHEET" HREF="userhtml.css">

-<LINK REL="next" HREF="node121.html">
-<LINK REL="previous" HREF="node113.html">
+<LINK REL="next" HREF="node125.html">
+<LINK REL="previous" HREF="node112.html">
 <LINK REL="up" HREF="userhtml.html">
 <LINK REL="next" HREF="node120.html">
 </HEAD>

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html1720"
+<A NAME="tex2html1727"
  HREF="node120.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html1716"
+<A NAME="tex2html1723"
  HREF="userhtml.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1710"
+<A NAME="tex2html1717"
  HREF="node118.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1718"
+<A NAME="tex2html1725"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html1721"
-  HREF="node120.html">psb_krylov   Krylov</A>
-<B> Up:</B> <A NAME="tex2html1717"
+<B> Next:</B> <A NAME="tex2html1728"
+  HREF="node120.html">psb_precinit   Initialize</A>
+<B> Up:</B> <A NAME="tex2html1724"
  HREF="userhtml.html">userhtml</A>
-<B> Previous:</B> <A NAME="tex2html1711"
-  HREF="node118.html">clone   clone</A>
- &nbsp; <B>  <A NAME="tex2html1719"
+<B> Previous:</B> <A NAME="tex2html1718"
+  HREF="node118.html">mm_array_write   Write</A>
+ &nbsp; <B>  <A NAME="tex2html1726"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
 <!--End of Navigation Panel-->

-<H1><A NAME="SECTION000120000000000000000"></A>
-<A NAME="sec:methods"></A>
+<H1><A NAME="SECTION000110000000000000000"></A>
+<A NAME="sec:precs"></A>
 <BR>
-Iterative Methods
+Preconditioner routines
 </H1>

 <P>
-In this chapter we provide routines for preconditioners and iterative
-methods. The interfaces for Krylov subspace methods are available in
-the module <code>psb_krylov_mod</code>.
+<A NAME="sec:psprecs"></A>The base PSBLAS library  contains the implementation of two simple
+preconditioning techniques:
+
+<UL>
+<LI>Diagonal Scaling
+</LI>
+<LI>Block Jacobi with ILU(0) factorization
+</LI>
+</UL>
+The supporting data type and subroutine interfaces are defined in the
+module  <code>psb_prec_mod</code>.

 <P>
 <BR><HR>
@@ -68,9 +76,19 @@ the module <code>psb_krylov_mod</code>.
 <A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>

 <UL>
-<LI><A NAME="tex2html1722"
-  HREF="node120.html">psb_krylov  -- Krylov Methods Driver
-      Routine</A>
+<LI><A NAME="tex2html1729"
+  HREF="node120.html">psb_precinit -- Initialize a  preconditioner</A>
+<LI><A NAME="tex2html1730"
+  HREF="node121.html">psb_precbld -- Builds a preconditioner</A>
+<LI><A NAME="tex2html1731"
+  HREF="node122.html">psb_precaply -- Preconditioner application
+  routine</A>
+<LI><A NAME="tex2html1732"
+  HREF="node123.html">psb_precdescr -- Prints a description of current
+  preconditioner</A>
+<LI><A NAME="tex2html1733"
+  HREF="node124.html">clone -- clone  current
+  preconditioner</A>
 </UL>
 <!--End of Table of Child-Links-->
 <BR><HR>
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html366"
+<A NAME="tex2html372"
  HREF="node13.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html362"
+<A NAME="tex2html368"
  HREF="node10.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html356"
+<A NAME="tex2html362"
  HREF="node11.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html364"
+<A NAME="tex2html370"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html367"
+<B> Next:</B> <A NAME="tex2html373"
  HREF="node13.html">get_local_cols   Get</A>
-<B> Up:</B> <A NAME="tex2html363"
+<B> Up:</B> <A NAME="tex2html369"
  HREF="node10.html">Descriptor data structure</A>
-<B> Previous:</B> <A NAME="tex2html357"
+<B> Previous:</B> <A NAME="tex2html363"
  HREF="node11.html">Descriptor Methods</A>
- &nbsp; <B>  <A NAME="tex2html365"
+ &nbsp; <B>  <A NAME="tex2html371"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -7,8 +7,8 @@ original version by:  Nikos Drakos, CBLU, University of Leeds
  Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
 <HTML>
 <HEAD>
-<TITLE>psb_krylov -- Krylov Methods Driver Routine</TITLE>
-<META NAME="description" CONTENT="psb_krylov -- Krylov Methods Driver Routine">
+<TITLE>psb_precinit -- Initialize a preconditioner</TITLE>
+<META NAME="description" CONTENT="psb_precinit -- Initialize a preconditioner">
 <META NAME="keywords" CONTENT="userhtml">
 <META NAME="resource-type" CONTENT="document">
 <META NAME="distribution" CONTENT="global">
@@ -18,6 +18,7 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <LINK REL="STYLESHEET" HREF="userhtml.css">

+<LINK REL="next" HREF="node121.html">
 <LINK REL="previous" HREF="node119.html">
 <LINK REL="up" HREF="node119.html">
 <LINK REL="next" HREF="node121.html">
@@ -25,370 +26,117 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html1731"
+<A NAME="tex2html1744"
  HREF="node121.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html1727"
+<A NAME="tex2html1740"
  HREF="node119.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1723"
+<A NAME="tex2html1734"
  HREF="node119.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1729"
+<A NAME="tex2html1742"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html1732"
-  HREF="node121.html">Bibliography</A>
-<B> Up:</B> <A NAME="tex2html1728"
-  HREF="node119.html">Iterative Methods</A>
-<B> Previous:</B> <A NAME="tex2html1724"
-  HREF="node119.html">Iterative Methods</A>
- &nbsp; <B>  <A NAME="tex2html1730"
+<B> Next:</B> <A NAME="tex2html1745"
+  HREF="node121.html">psb_precbld   Builds</A>
+<B> Up:</B> <A NAME="tex2html1741"
+  HREF="node119.html">Preconditioner routines</A>
+<B> Previous:</B> <A NAME="tex2html1735"
+  HREF="node119.html">Preconditioner routines</A>
+ &nbsp; <B>  <A NAME="tex2html1743"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
 <!--End of Navigation Panel-->

-<H2><A NAME="SECTION000121000000000000000"></A><A NAME="krylov"></A>
-<BR>
-psb_krylov  -- Krylov Methods Driver
-      Routine
+<H2><A NAME="SECTION000111000000000000000">
+psb_precinit -- Initialize a  preconditioner</A>
 </H2>

 <P>
-This subroutine is a driver that provides a general interface for all
-the Krylov-Subspace family methods implemented in PSBLAS version 2. 
-
-<P>
-The stopping criterion is the normwise backward error, in the infinity
-norm, i.e. the iteration is stopped when 
-<BR><P></P>
-<DIV ALIGN="CENTER">
-<!-- MATH
- \begin{displaymath}
-err = \frac{\|r_i\|}{(\|A\|\|x_i\|+\|b\|)} < eps
-\end{displaymath}
- -->
-
-<IMG
- WIDTH="204" HEIGHT="44" BORDER="0"
- SRC="img156.png"
- ALT="\begin{displaymath}err = \frac{\Vert r_i\Vert}{(\Vert A\Vert\Vert x_i\Vert+\Vert b\Vert)} &lt; eps \end{displaymath}">
-</DIV>
-<BR CLEAR="ALL">
-<P></P>
-or the 2-norm residual reduction
-<BR><P></P>
-<DIV ALIGN="CENTER">
-<!-- MATH
- \begin{displaymath}
-err = \frac{\|r_i\|}{\|b\|_2} < eps
-\end{displaymath}
- -->
-
-<IMG
- WIDTH="121" HEIGHT="44" BORDER="0"
- SRC="img157.png"
- ALT="\begin{displaymath}err = \frac{\Vert r_i\Vert}{\Vert b\Vert _2} &lt; eps \end{displaymath}">
-</DIV>
-<BR CLEAR="ALL">
-<P></P>
-according to the value passed through the  istop argument (see
-later). In the above formulae, <IMG
- WIDTH="18" HEIGHT="30" ALIGN="MIDDLE" BORDER="0"
- SRC="img158.png"
- ALT="$x_i$"> is the tentative solution and
-<IMG
- WIDTH="91" HEIGHT="30" ALIGN="MIDDLE" BORDER="0"
- SRC="img159.png"
- ALT="$r_i=b-Ax_i$"> the corresponding residual at the <IMG
- WIDTH="9" HEIGHT="17" ALIGN="BOTTOM" BORDER="0"
- SRC="img4.png"
- ALT="$i$">-th iteration. 
-
-<P>
-<BR>
-<IMG
- WIDTH="482" HEIGHT="35" ALIGN="BOTTOM" BORDER="0"
- SRC="img160.png"
- ALT="\begin{lstlisting}
-call psb_krylov(method,a,prec,b,x,eps,desc_a,info,&amp;
-&amp; itmax,iter,err,itrace,irst,istop,cond)
-\end{lstlisting}">
-<BR>
+<PRE>
+call psb_precinit(prec, ptype, info)
+</PRE>

 <P>
 <DL>
 <DT><STRONG>Type:</STRONG></DT>
-<DD>Synchronous.
+<DD>Asynchronous.
 </DD>
 <DT><STRONG><B>On Entry</B></STRONG></DT>
 <DD>
 </DD>
-<DT><STRONG>method</STRONG></DT>
-<DD>a string that defines the iterative method to be
-  used. Supported values are:
-  <DL>
-<DT><STRONG>CG:</STRONG></DT>
-<DD>the Conjugate Gradient method;
-  
-</DD>
-<DT><STRONG>CGS:</STRONG></DT>
-<DD>the Conjugate Gradient Stabilized method;
-
-<P>
-</DD>
-<DT><STRONG>BICG:</STRONG></DT>
-<DD>the Bi-Conjugate Gradient method;
-  
-</DD>
-<DT><STRONG>BICGSTAB:</STRONG></DT>
-<DD>the Bi-Conjugate Gradient Stabilized method;
-  
-</DD>
-<DT><STRONG>BICGSTABL:</STRONG></DT>
-<DD>the Bi-Conjugate Gradient Stabilized method with restarting;
-  
-</DD>
-<DT><STRONG>RGMRES:</STRONG></DT>
-<DD>the Generalized Minimal Residual method with restarting.
-  
-</DD>
-</DL>
-</DD>
-<DT><STRONG>a</STRONG></DT>
-<DD>the local portion of global sparse matrix
-<IMG
- WIDTH="16" HEIGHT="14" ALIGN="BOTTOM" BORDER="0"
- SRC="img1.png"
- ALT="$A$">. 
-<BR>
-Scope: <B>local</B> 
+<DT><STRONG>ptype</STRONG></DT>
+<DD>the type of preconditioner. 
+Scope: <B>global</B> 
 <BR>
 Type: <B>required</B>
 <BR>
 Intent: <B>in</B>.
 <BR>
-Specified as: a structured data of type spdata<TT>psb_Tspmat_type</TT>.
+Specified as: a character string, see usage notes.
+</DD>
+<DT><STRONG><B>On Exit</B></STRONG></DT>
+<DD><P>
 </DD>
 <DT><STRONG>prec</STRONG></DT>
-<DD>The data structure containing the preconditioner.
-<BR>
-Scope: <B>local</B> 
-<BR>
-Type: <B>required</B>
-<BR>
-Intent: <B>in</B>.
-<BR>
-Specified as: a structured data of type precdata<TT>psb_prec_type</TT>.
-</DD>
-<DT><STRONG>b</STRONG></DT>
-<DD>The RHS vector. 
-<BR>
-Scope: <B>local</B> 
-<BR>
-Type: <B>required</B>
-<BR>
-Intent: <B>in</B>.
-<BR>
-Specified as:  a rank one array or an object of type vdata<TT>psb_T_vect_type</TT>.
-</DD>
-<DT><STRONG>x</STRONG></DT>
-<DD>The initial guess. 
-<BR>
-Scope: <B>local</B> 
+<DD>Scope: <B>local</B> 
 <BR>
 Type: <B>required</B>
 <BR>
 Intent: <B>inout</B>.
 <BR>
-Specified as:  a rank one array or an object of type vdata<TT>psb_T_vect_type</TT>.
-</DD>
-<DT><STRONG>eps</STRONG></DT>
-<DD>The stopping tolerance. 
-<BR>
-Scope: <B>global</B> 
-<BR>
-Type: <B>required</B>
-<BR>
-Intent: <B>in</B>.
-<BR>
-Specified as: a real number. 
-</DD>
-<DT><STRONG>desc_a</STRONG></DT>
-<DD>contains data structures for communications.
-<BR>
-Scope: <B>local</B> 
-<BR>
-Type: <B>required</B>
-<BR>
-Intent: <B>in</B>.
-<BR>
-Specified as: a structured data of type descdata<TT>psb_desc_type</TT>.
-</DD>
-<DT><STRONG>itmax</STRONG></DT>
-<DD>The maximum number of iterations to perform.
-<BR>
-Scope: <B>global</B> 
-<BR>
-Type: <B>optional</B>
-<BR>
-Intent: <B>in</B>.
-<BR>
-Default: <IMG
- WIDTH="100" HEIGHT="17" ALIGN="BOTTOM" BORDER="0"
- SRC="img161.png"
- ALT="$itmax = 1000$">.
-<BR>
-Specified as: an integer variable <IMG
- WIDTH="75" HEIGHT="29" ALIGN="MIDDLE" BORDER="0"
- SRC="img162.png"
- ALT="$itmax \ge 1$">.
-</DD>
-<DT><STRONG>itrace</STRONG></DT>
-<DD>If <IMG
- WIDTH="28" HEIGHT="30" ALIGN="MIDDLE" BORDER="0"
- SRC="img112.png"
- ALT="$&gt;0$"> print out an informational message about
-  convergence  every <IMG
- WIDTH="46" HEIGHT="17" ALIGN="BOTTOM" BORDER="0"
- SRC="img163.png"
- ALT="$itrace$"> iterations.
-<BR>
-Scope: <B>global</B> 
-<BR>
-Type: <B>optional</B>
-<BR>
-Intent: <B>in</B>.
-<BR></DD>
-<DT><STRONG>irst</STRONG></DT>
-<DD>An integer specifying the restart parameter.
-<BR>
-Scope: <B>global</B> 
-<BR>
-Type: <B>optional</B>.
-<BR>
-Intent: <B>in</B>.
-<BR>
-Values: <IMG
- WIDTH="60" HEIGHT="29" ALIGN="MIDDLE" BORDER="0"
- SRC="img164.png"
- ALT="$irst&gt;0$">. This is employed for the BiCGSTABL or RGMRES
-methods, otherwise it is ignored. 
-
-<P>
-</DD>
-<DT><STRONG>istop</STRONG></DT>
-<DD>An integer specifying the stopping criterion.
-<BR>
-Scope: <B>global</B> 
-<BR>
-Type: <B>optional</B>.
-<BR>
-Intent: <B>in</B>.
-<BR>
-Values: 1: use the normwise backward error, 2: use the scaled 2-norm
-of the residual. Default: 2. 
-</DD>
-<DT><STRONG><B>On Return</B></STRONG></DT>
-<DD>
-</DD>
-<DT><STRONG>x</STRONG></DT>
-<DD>The computed solution. 
-<BR>
-Scope: <B>local</B> 
-<BR>
-Type: <B>required</B>
-<BR>
-Intent: <B>inout</B>.
-<BR>
-Specified as:  a rank one array or an object of type vdata<TT>psb_T_vect_type</TT>.
-</DD>
-<DT><STRONG>iter</STRONG></DT>
-<DD>The number of iterations performed.
-<BR>
-Scope: <B>global</B> 
-<BR>
-Type: <B>optional</B>
-<BR>
-Intent: <B>out</B>.
-<BR>
-Returned  as: an integer variable.
-</DD>
-<DT><STRONG>err</STRONG></DT>
-<DD>The convergence estimate on exit.
-<BR>
-Scope: <B>global</B> 
-<BR>
-Type: <B>optional</B>
-<BR>
-Intent: <B>out</B>.
-<BR>
-Returned  as: a real number.
-</DD>
-<DT><STRONG>cond</STRONG></DT>
-<DD>An estimate of the condition number of matrix <IMG
- WIDTH="16" HEIGHT="14" ALIGN="BOTTOM" BORDER="0"
- SRC="img1.png"
- ALT="$A$">; only
-  available with the <IMG
- WIDTH="29" HEIGHT="14" ALIGN="BOTTOM" BORDER="0"
- SRC="img165.png"
- ALT="$CG$"> method.
-<BR>
-Scope: <B>global</B> 
-<BR>
-Type: <B>optional</B>
-<BR>
-Intent: <B>out</B>.
-<BR>
-Returned  as: a real number.
+Specified as: a preconditioner data structure precdata<TT>psb_prec_type</TT>.
 </DD>
 <DT><STRONG>info</STRONG></DT>
-<DD>Error code.
+<DD>Scope: <B>global</B> 
 <BR>
-Scope: <B>local</B> 
-<BR>
-Type: <B>required</B> 
+Type: <B>required</B>
 <BR>
 Intent: <B>out</B>.
 <BR>
-An integer value; 0 means no error has been detected. 
+Error code: if no error, 0 is returned.
+</DD>
+</DL>
+<FONT SIZE="+1"><B>Notes</B></FONT>
+Legal inputs to this subroutine are interpreted depending on the
+<IMG
+ WIDTH="41" HEIGHT="30" ALIGN="MIDDLE" BORDER="0"
+ SRC="img155.png"
+ ALT="$ptype$"> string as follows<A NAME="tex2html30"
+  HREF="footnode.html#foot7458"><SUP>3</SUP></A>:
+<DL>
+<DT><STRONG>NONE</STRONG></DT>
+<DD>No preconditioning, i.e. the preconditioner is just a copy
+  operator.
+</DD>
+<DT><STRONG>DIAG</STRONG></DT>
+<DD>Diagonal scaling; each entry of the input vector is
+  multiplied by the reciprocal of the sum of the absolute values of
+  the coefficients in the corresponding row of matrix  <IMG
+ WIDTH="16" HEIGHT="14" ALIGN="BOTTOM" BORDER="0"
+ SRC="img1.png"
+ ALT="$A$">;
+</DD>
+<DT><STRONG>BJAC</STRONG></DT>
+<DD>Precondition by a  factorization of the
+  block-diagonal of matrix <IMG
+ WIDTH="16" HEIGHT="14" ALIGN="BOTTOM" BORDER="0"
+ SRC="img1.png"
+ ALT="$A$">, where block boundaries are determined
+  by the data allocation boundaries for each process; requires no
+  communication. Only the incomplete factorization <IMG
+ WIDTH="56" HEIGHT="32" ALIGN="MIDDLE" BORDER="0"
+ SRC="img156.png"
+ ALT="$ILU(0)$"> is
+  currently implemented.  
 </DD>
 </DL>

 <P>
-
-<P>
-
-<P>
-
-<P>
-<HR>
-<!--Navigation Panel-->
-<A NAME="tex2html1731"
-  HREF="node121.html">
-<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html1727"
-  HREF="node119.html">
-<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1723"
-  HREF="node119.html">
-<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1729"
-  HREF="node1.html">
-<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
-<BR>
-<B> Next:</B> <A NAME="tex2html1732"
-  HREF="node121.html">Bibliography</A>
-<B> Up:</B> <A NAME="tex2html1728"
-  HREF="node119.html">Iterative Methods</A>
-<B> Previous:</B> <A NAME="tex2html1724"
-  HREF="node119.html">Iterative Methods</A>
- &nbsp; <B>  <A NAME="tex2html1730"
-  HREF="node1.html">Contents</A></B> 
-<!--End of Navigation Panel-->
+<BR><HR>

 </BODY>
 </HTML>
@@ -7,8 +7,8 @@ original version by:  Nikos Drakos, CBLU, University of Leeds
  Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
 <HTML>
 <HEAD>
-<TITLE>Bibliography</TITLE>
-<META NAME="description" CONTENT="Bibliography">
+<TITLE>psb_precbld -- Builds a preconditioner</TITLE>
+<META NAME="description" CONTENT="psb_precbld -- Builds a preconditioner">
 <META NAME="keywords" CONTENT="userhtml">
 <META NAME="resource-type" CONTENT="document">
 <META NAME="distribution" CONTENT="global">
@@ -19,161 +19,139 @@ original version by:  Nikos Drakos, CBLU, University of Leeds
 <LINK REL="STYLESHEET" HREF="userhtml.css">

 <LINK REL="next" HREF="node122.html">
-<LINK REL="previous" HREF="node119.html">
-<LINK REL="up" HREF="userhtml.html">
+<LINK REL="previous" HREF="node120.html">
+<LINK REL="up" HREF="node119.html">
 <LINK REL="next" HREF="node122.html">
 </HEAD>

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html1743"
+<A NAME="tex2html1756"
  HREF="node122.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html1739"
-  HREF="userhtml.html">
+<A NAME="tex2html1752"
+  HREF="node119.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1733"
+<A NAME="tex2html1746"
  HREF="node120.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1741"
+<A NAME="tex2html1754"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html1744"
-  HREF="node122.html">About this document ...</A>
-<B> Up:</B> <A NAME="tex2html1740"
-  HREF="userhtml.html">userhtml</A>
-<B> Previous:</B> <A NAME="tex2html1734"
-  HREF="node120.html">psb_krylov   Krylov</A>
- &nbsp; <B>  <A NAME="tex2html1742"
+<B> Next:</B> <A NAME="tex2html1757"
+  HREF="node122.html">psb_precaply   Preconditioner</A>
+<B> Up:</B> <A NAME="tex2html1753"
+  HREF="node119.html">Preconditioner routines</A>
+<B> Previous:</B> <A NAME="tex2html1747"
+  HREF="node120.html">psb_precinit   Initialize</A>
+ &nbsp; <B>  <A NAME="tex2html1755"
  HREF="node1.html">Contents</A></B> 
-<BR><BR>
+<BR>
+<BR>
 <!--End of Navigation Panel-->
- 
-<H2><A NAME="SECTION000130000000000000000">
-Bibliography</A>
-</H2><DL COMPACT><DD><P></P><DT><A NAME="DesPat:11">1</A>
-<DD>
- D.&nbsp;Barbieri, V.&nbsp;Cardellini, S.&nbsp;Filippone and D.&nbsp;Rouson
-<EM>Design Patterns for Scientific Computations on Sparse Matrices</EM>,
- HPSS 2011, Algorithms and Programming Tools for Next-Generation High-Performance Scientific Software, Bordeaux, Sep. 2011
+
+<H2><A NAME="SECTION000112000000000000000">
+psb_precbld -- Builds a preconditioner</A>
+</H2>

 <P>
-<P></P><DT><A NAME="PARA04FOREST">2</A>
+<PRE>
+call psb_precbld(a, desc_a, prec, info,amold,vmold)
+</PRE>
+
+<P>
+<DL>
+<DT><STRONG>Type:</STRONG></DT>
+<DD>Synchronous.
+</DD>
+<DT><STRONG><B>On Entry</B></STRONG></DT>
 <DD>
-G.&nbsp;Bella, S.&nbsp;Filippone, A.&nbsp;De Maio and M.&nbsp;Testa,
-<EM>A Simulation Model for Forest Fires</EM>,
-in J.&nbsp;Dongarra, K.&nbsp;Madsen, J.&nbsp;Wasniewski, editors,
-Proceedings of PARA&nbsp;04 Workshop on State of the Art
-in Scientific Computing, pp.&nbsp;546-553, Lecture Notes in Computer Science,
-Springer, 2005.
-<P></P><DT><A NAME="2007d">3</A>
-<DD> A. Buttari, D. di Serafino, P. D'Ambra, S. Filippone,<BR>
-2LEV-D2P4: a package of high-performance preconditioners,<BR>
-Applicable Algebra in Engineering, Communications and Computing, 
-Volume 18, Number 3, May, 2007, pp.  223-239
-<P></P><DT><A NAME="2007c">4</A>
-<DD>  P. D'Ambra, S. Filippone,  D. Di Serafino<BR>
-On the Development of PSBLAS-based Parallel Two-level Schwarz Preconditioners
+</DD>
+<DT><STRONG>a</STRONG></DT>
+<DD>the system sparse matrix.
+Scope: <B>local</B> 
 <BR>
-Applied Numerical Mathematics, Elsevier Science, 
-Volume 57, Issues 11-12, November-December 2007, Pages 1181-1196.
-
-<P>
-<P></P><DT><A NAME="BLAS2">5</A>
-<DD>
- Dongarra, J. J.,  DuCroz, J.,  Hammarling, S. and Hanson, R.,
-An Extended Set of Fortran Basic Linear Algebra Subprograms,
-ACM Trans. Math. Softw. vol.&nbsp;14, 1-17, 1988.
-<P></P><DT><A NAME="BLAS3">6</A>
-<DD>
-  Dongarra, J., DuCroz, J., Hammarling, S. and Duff, I.,
-A  Set of level 3 Basic Linear Algebra Subprograms,
-ACM Trans. Math. Softw. vol.&nbsp;16, 1-17, 1990.
-<P></P><DT><A NAME="BLACS">7</A>
-<DD>
-J.&nbsp;J.&nbsp;Dongarra and R.&nbsp;C.&nbsp;Whaley,
-<EM>A User's Guide to the BLACS v.&nbsp;1.1</EM>,
-Lapack Working Note 94, Tech. Rep. UT-CS-95-281, University of
-Tennessee, March 1995 (updated May 1997).
-<P></P><DT><A NAME="sblas97">8</A>
-<DD>
-I.&nbsp;Duff, M.&nbsp;Marrone, G.&nbsp;Radicati and C.&nbsp;Vittoli,
-<EM>Level 3 Basic Linear Algebra Subprograms for Sparse Matrices: 
-a User Level Interface</EM>,
-ACM Transactions on Mathematical Software, 23(3), pp.&nbsp;379-401, 1997.
-<P></P><DT><A NAME="sblas02">9</A>
-<DD>
-I.&nbsp;Duff, M.&nbsp;Heroux and R.&nbsp;Pozo,
-<EM>An Overview of the Sparse Basic Linear
-Algebra Subprograms: the New Standard from the BLAS Technical Forum</EM>,
-ACM Transactions on Mathematical Software, 28(2), pp.&nbsp;239-267, 2002.
-<P></P><DT><A NAME="PSBLAS">10</A>
-<DD>
-S.&nbsp;Filippone and M.&nbsp;Colajanni, 
-<EM>PSBLAS: A Library for Parallel Linear Algebra
-Computation on Sparse Matrices</EM>,
+Type: <B>required</B>
 <BR>
-ACM Transactions on Mathematical Software, 26(4), pp.&nbsp;527-550, 2000.
-<P></P><DT><A NAME="Sparse03">11</A>
-<DD>
-S.&nbsp;Filippone and A.&nbsp;Buttari, 
-<EM>Object-Oriented Techniques for Sparse Matrix Computations in Fortran 2003</EM>,
+Intent: <B>in</B>, target.
 <BR>
-ACM Transactions on Mathematical Software, to appear.
-<P></P><DT><A NAME="KIVA3PSBLAS">12</A>
-<DD>
-S.&nbsp;Filippone, P.&nbsp;D'Ambra, M.&nbsp;Colajanni,
-<EM>Using a Parallel Library of Sparse Linear Algebra in a Fluid Dynamics 
-Applications Code on Linux Clusters</EM>,
-in G.&nbsp;Joubert, A.&nbsp;Murli, F.&nbsp;Peters, M.&nbsp;Vanneschi, editors,
-Parallel Computing - Advances &amp; Current Issues,
-pp.&nbsp;441-448, Imperial College Press, 2002. 
-<P></P><DT><A NAME="DesignPatterns">13</A>
-<DD>
- Gamma, E.,  Helm, R.,  Johnson, R.,  and  Vlissides,
-  J. 1995.
- <EM>Design Patterns: Elements of Reusable Object-Oriented Software</EM>.
- Addison-Wesley.
+Specified as: a sparse matrix data structure spdata<TT>psb_Tspmat_type</TT>.
+</DD>
+<DT><STRONG>prec</STRONG></DT>
+<DD>the preconditioner.
+<BR>
+Scope: <B>local</B> 
+<BR>
+Type: <B>required</B>
+<BR>
+Intent: <B>inout</B>.
+<BR>
+Specified as: an already initialized precondtioner data structure precdata<TT>psb_prec_type</TT>
+<BR></DD>
+<DT><STRONG>desc_a</STRONG></DT>
+<DD>the problem communication descriptor. 
+Scope: <B>local</B> 
+<BR>
+Type: <B>required</B>
+<BR>
+Intent: <B>in</B>, target.
+<BR>
+Specified as: a communication descriptor data structure descdata<TT>psb_desc_type</TT>.
+</DD>
+<DT><STRONG>amold</STRONG></DT>
+<DD>The desired dynamic type for the internal matrix storage.
+<BR>
+Scope: <B>local</B>.
+<BR>
+Type: <B>optional</B>.
+<BR>
+Intent: <B>in</B>.
+<BR>
+Specified as: an object of a class derived from spbasedata<TT>psb_T_base_sparse_mat</TT>. 
+</DD>
+<DT><STRONG>vmold</STRONG></DT>
+<DD>The desired dynamic type for the internal vector storage.
+<BR>
+Scope: <B>local</B>.
+<BR>
+Type: <B>optional</B>.
+<BR>
+Intent: <B>in</B>.
+<BR>
+Specified as: an object of a class derived from vbasedata<TT>psb_T_base_vect_type</TT>. 

 <P>
-<P></P><DT><A NAME="METIS">14</A>
-<DD>
-Karypis, G. and Kumar, V.,
-<EM>METIS: Unstructured Graph Partitioning and Sparse Matrix
-  Ordering System</EM>.
-Minneapolis, MN 55455: University of Minnesota, Department of
-  Computer Science, 1995. 
-Internet Address: <code>http://www.cs.umn.edu/~karypis</code>.
-<P></P><DT><A NAME="BLAS1">15</A>
-<DD>
-Lawson, C.,  Hanson, R., Kincaid, D. and Krogh, F.,
-   Basic Linear Algebra Subprograms for Fortran usage,
-ACM Trans. Math. Softw. vol.&nbsp;5, 38-329, 1979.
+</DD>
+</DL>

 <P>
-<P></P><DT><A NAME="machiels">16</A>
+<DL>
+<DT><STRONG><B>On Return</B></STRONG></DT>
 <DD>
-Machiels, L. and Deville, M.
-<EM>Fortran 90: An entry to object-oriented programming for the solution
-  of partial differential equations.</EM>
-ACM Trans. Math. Softw. vol.&nbsp;23, 32-49.
-<P></P><DT><A NAME="metcalf">17</A>
-<DD>
-Metcalf, M., Reid, J. and Cohen, M.
-<EM>Fortran 95/2003 explained.</EM>
-Oxford University Press, 2004.
-<P></P><DT><A NAME="RouXiaXu:11">18</A>
-<DD>
-Rouson, D.W.I., Xia, J., Xu, X.: Scientific Software Design: The
-  Object-Oriented Way. Cambridge University Press (2011)
-
-<P>
-<P></P><DT><A NAME="MPI1">19</A>
-<DD>
-M.&nbsp;Snir, S.&nbsp;Otto, S.&nbsp;Huss-Lederman, D.&nbsp;Walker and J.&nbsp;Dongarra,
-<EM>MPI: The Complete Reference. Volume 1 - The MPI Core</EM>, second edition,
-MIT Press, 1998.
+</DD>
+<DT><STRONG>prec</STRONG></DT>
+<DD>the preconditioner.
+<BR>
+Scope: <B>local</B> 
+<BR>
+Type: <B>required</B>
+<BR>
+Intent: <B>inout</B>.
+<BR>
+Specified as: a precondtioner data structure precdata<TT>psb_prec_type</TT>
+<BR></DD>
+<DT><STRONG>info</STRONG></DT>
+<DD>Error code.
+<BR>
+Scope: <B>local</B> 
+<BR>
+Type: <B>required</B> 
+<BR>
+Intent: <B>out</B>.
+<BR>
+An integer value; 0 means no error has been detected. 
+</DD>
 </DL>

 <P>
@@ -7,8 +7,8 @@ original version by:  Nikos Drakos, CBLU, University of Leeds
  Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
 <HTML>
 <HEAD>
-<TITLE>About this document ...</TITLE>
-<META NAME="description" CONTENT="About this document ...">
+<TITLE>psb_precaply -- Preconditioner application routine</TITLE>
+<META NAME="description" CONTENT="psb_precaply -- Preconditioner application routine">
 <META NAME="keywords" CONTENT="userhtml">
 <META NAME="resource-type" CONTENT="document">
 <META NAME="distribution" CONTENT="global">
@@ -18,52 +18,138 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <LINK REL="STYLESHEET" HREF="userhtml.css">

+<LINK REL="next" HREF="node123.html">
 <LINK REL="previous" HREF="node121.html">
-<LINK REL="up" HREF="userhtml.html">
+<LINK REL="up" HREF="node119.html">
+<LINK REL="next" HREF="node123.html">
 </HEAD>

 <BODY >
 <!--Navigation Panel-->
-<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next_g.png"> 
-<A NAME="tex2html1749"
-  HREF="userhtml.html">
+<A NAME="tex2html1768"
+  HREF="node123.html">
+<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
+<A NAME="tex2html1764"
+  HREF="node119.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1745"
+<A NAME="tex2html1758"
  HREF="node121.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1751"
+<A NAME="tex2html1766"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Up:</B> <A NAME="tex2html1750"
-  HREF="userhtml.html">userhtml</A>
-<B> Previous:</B> <A NAME="tex2html1746"
-  HREF="node121.html">Bibliography</A>
- &nbsp; <B>  <A NAME="tex2html1752"
+<B> Next:</B> <A NAME="tex2html1769"
+  HREF="node123.html">psb_precdescr   Prints</A>
+<B> Up:</B> <A NAME="tex2html1765"
+  HREF="node119.html">Preconditioner routines</A>
+<B> Previous:</B> <A NAME="tex2html1759"
+  HREF="node121.html">psb_precbld   Builds</A>
+ &nbsp; <B>  <A NAME="tex2html1767"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
 <!--End of Navigation Panel-->

-<H1><A NAME="SECTION000140000000000000000">
-About this document ...</A>
-</H1>
- <P>
-This document was generated using the
-<A HREF="http://www.latex2html.org/"><STRONG>LaTeX</STRONG>2<tt>HTML</tt></A> translator Version 2008 (1.71)
+<H2><A NAME="SECTION000113000000000000000">
+psb_precaply -- Preconditioner application
+  routine</A>
+</H2>
+
 <P>
-Copyright &#169; 1993, 1994, 1995, 1996,
-<A HREF="http://cbl.leeds.ac.uk/nikos/personal.html">Nikos Drakos</A>, 
-Computer Based Learning Unit, University of Leeds.
+<PRE>
+call psb_precaply(prec,x,y,desc_a,info,trans,work)
+call psb_precaply(prec,x,desc_a,info,trans)
+</PRE>
+
+<P>
+<DL>
+<DT><STRONG>Type:</STRONG></DT>
+<DD>Synchronous.
+</DD>
+<DT><STRONG><B>On Entry</B></STRONG></DT>
+<DD>
+</DD>
+<DT><STRONG>prec</STRONG></DT>
+<DD>the preconditioner.
+Scope: <B>local</B> 
 <BR>
-Copyright &#169; 1997, 1998, 1999,
-<A HREF="http://www.maths.mq.edu.au/~ross/">Ross Moore</A>, 
-Mathematics Department, Macquarie University, Sydney.
+Type: <B>required</B>
+<BR>
+Intent: <B>in</B>.
+<BR>
+Specified as: a preconditioner data structure precdata<TT>psb_prec_type</TT>.
+</DD>
+<DT><STRONG>x</STRONG></DT>
+<DD>the source vector.
+Scope: <B>local</B> 
+<BR>
+Type: <B>required</B>
+<BR>
+Intent: <B>inout</B>.
+<BR>
+Specified as:  a rank one array or an object of type vdata<TT>psb_T_vect_type</TT>. 
+</DD>
+<DT><STRONG>desc_a</STRONG></DT>
+<DD>the problem communication descriptor.
+Scope: <B>local</B> 
+<BR>
+Type: <B>required</B>
+<BR>
+Intent: <B>in</B>.
+<BR>
+Specified as: a communication data structure descdata<TT>psb_desc_type</TT>.
+</DD>
+<DT><STRONG>trans</STRONG></DT>
+<DD>Scope:  
+<BR>
+Type: <B>optional</B>
+<BR>
+Intent: <B>in</B>.
+<BR>
+Specified as: a character.
+</DD>
+<DT><STRONG>work</STRONG></DT>
+<DD>an optional work space
+Scope: <B>local</B> 
+<BR>
+Type: <B>optional</B>
+<BR>
+Intent: <B>inout</B>.
+<BR>
+Specified as: a double precision array.
+</DD>
+</DL>
+
 <P>
-The command line arguments were: <BR>
- <STRONG>latex2html</STRONG> <TT>-local_icons -noaddress -dir ../../html userhtml.tex</TT>
+<DL>
+<DT><STRONG><B>On Return</B></STRONG></DT>
+<DD>
+</DD>
+<DT><STRONG>y</STRONG></DT>
+<DD>the destination vector.
+Scope: <B>local</B> 
+<BR>
+Type: <B>required</B>
+<BR>
+Intent: <B>inout</B>.
+<BR>
+Specified as:  a rank one array or an object of type vdata<TT>psb_T_vect_type</TT>.
+</DD>
+<DT><STRONG>info</STRONG></DT>
+<DD>Error code.
+<BR>
+Scope: <B>local</B> 
+<BR>
+Type: <B>required</B> 
+<BR>
+Intent: <B>out</B>.
+<BR>
+An integer value; 0 means no error has been detected. 
+</DD>
+</DL>
+
 <P>
-The translation was initiated by Salvatore Filippone on 2014-03-25
 <BR><HR>

 </BODY>
@@ -7,8 +7,8 @@ original version by:  Nikos Drakos, CBLU, University of Leeds
  Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
 <HTML>
 <HEAD>
-<TITLE>About this document ...</TITLE>
-<META NAME="description" CONTENT="About this document ...">
+<TITLE>psb_precdescr -- Prints a description of current preconditioner</TITLE>
+<META NAME="description" CONTENT="psb_precdescr -- Prints a description of current preconditioner">
 <META NAME="keywords" CONTENT="userhtml">
 <META NAME="resource-type" CONTENT="document">
 <META NAME="distribution" CONTENT="global">
@@ -18,52 +18,81 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <LINK REL="STYLESHEET" HREF="userhtml.css">

+<LINK REL="next" HREF="node124.html">
 <LINK REL="previous" HREF="node122.html">
-<LINK REL="up" HREF="userhtml.html">
+<LINK REL="up" HREF="node119.html">
+<LINK REL="next" HREF="node124.html">
 </HEAD>

 <BODY >
 <!--Navigation Panel-->
-<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next_g.png"> 
-<A NAME="tex2html1743"
-  HREF="userhtml.html">
+<A NAME="tex2html1780"
+  HREF="node124.html">
+<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
+<A NAME="tex2html1776"
+  HREF="node119.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html1739"
+<A NAME="tex2html1770"
  HREF="node122.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html1745"
+<A NAME="tex2html1778"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Up:</B> <A NAME="tex2html1744"
-  HREF="userhtml.html">userhtml</A>
-<B> Previous:</B> <A NAME="tex2html1740"
-  HREF="node122.html">Bibliography</A>
- &nbsp; <B>  <A NAME="tex2html1746"
+<B> Next:</B> <A NAME="tex2html1781"
+  HREF="node124.html">clone   clone</A>
+<B> Up:</B> <A NAME="tex2html1777"
+  HREF="node119.html">Preconditioner routines</A>
+<B> Previous:</B> <A NAME="tex2html1771"
+  HREF="node122.html">psb_precaply   Preconditioner</A>
+ &nbsp; <B>  <A NAME="tex2html1779"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
 <!--End of Navigation Panel-->

-<H1><A NAME="SECTION000140000000000000000">
-About this document ...</A>
-</H1>
- <P>
-This document was generated using the
-<A HREF="http://www.latex2html.org/"><STRONG>LaTeX</STRONG>2<tt>HTML</tt></A> translator Version 2008 (1.71)
+<H2><A NAME="SECTION000114000000000000000">
+psb_precdescr -- Prints a description of current
+  preconditioner</A>
+</H2>
+
 <P>
-Copyright &#169; 1993, 1994, 1995, 1996,
-<A HREF="http://cbl.leeds.ac.uk/nikos/personal.html">Nikos Drakos</A>, 
-Computer Based Learning Unit, University of Leeds.
+<PRE>
+call psb_precdescr(prec)
+call psb_precdescr(prec, iout)
+</PRE>
+
+<P>
+<DL>
+<DT><STRONG>Type:</STRONG></DT>
+<DD>Asynchronous.
+</DD>
+<DT><STRONG><B>On Entry</B></STRONG></DT>
+<DD>
+</DD>
+<DT><STRONG>prec</STRONG></DT>
+<DD>the preconditioner.
+Scope: <B>local</B> 
 <BR>
-Copyright &#169; 1997, 1998, 1999,
-<A HREF="http://www.maths.mq.edu.au/~ross/">Ross Moore</A>, 
-Mathematics Department, Macquarie University, Sydney.
+Type: <B>required</B>
+<BR>
+Intent: <B>in</B>.
+<BR>
+Specified as: a preconditioner data structure precdata<TT>psb_prec_type</TT>.
+</DD>
+<DT><STRONG>iout</STRONG></DT>
+<DD>output unit.
+Scope: <B>local</B> 
+<BR>
+Type: <B>optiona</B>
+<BR>
+Intent: <B>in</B>.
+<BR>
+Specified as: an integer number. 
+</DD>
+</DL>
+
 <P>
-The command line arguments were: <BR>
- <STRONG>latex2html</STRONG> <TT>-local_icons -noaddress -dir ../../html userhtml.tex</TT>
-<P>
-The translation was initiated by Salvatore Filippone on 2013-06-10
 <BR><HR>

 </BODY>
@@ -0,0 +1,94 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
+
+<!--Converted with LaTeX2HTML 2008 (1.71)
+original version by:  Nikos Drakos, CBLU, University of Leeds
+* revised and updated by:  Marcus Hennecke, Ross Moore, Herb Swan
+* with significant contributions from:
+  Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
+<HTML>
+<HEAD>
+<TITLE>clone -- clone current preconditioner</TITLE>
+<META NAME="description" CONTENT="clone -- clone current preconditioner">
+<META NAME="keywords" CONTENT="userhtml">
+<META NAME="resource-type" CONTENT="document">
+<META NAME="distribution" CONTENT="global">
+
+<META NAME="Generator" CONTENT="LaTeX2HTML v2008">
+<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
+
+<LINK REL="STYLESHEET" HREF="userhtml.css">
+
+<LINK REL="previous" HREF="node123.html">
+<LINK REL="up" HREF="node119.html">
+<LINK REL="next" HREF="node125.html">
+</HEAD>
+
+<BODY >
+<!--Navigation Panel-->
+<A NAME="tex2html1790"
+  HREF="node125.html">
+<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
+<A NAME="tex2html1786"
+  HREF="node119.html">
+<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
+<A NAME="tex2html1782"
+  HREF="node123.html">
+<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
+<A NAME="tex2html1788"
+  HREF="node1.html">
+<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
+<BR>
+<B> Next:</B> <A NAME="tex2html1791"
+  HREF="node125.html">Iterative Methods</A>
+<B> Up:</B> <A NAME="tex2html1787"
+  HREF="node119.html">Preconditioner routines</A>
+<B> Previous:</B> <A NAME="tex2html1783"
+  HREF="node123.html">psb_precdescr   Prints</A>
+ &nbsp; <B>  <A NAME="tex2html1789"
+  HREF="node1.html">Contents</A></B> 
+<BR>
+<BR>
+<!--End of Navigation Panel-->
+
+<H2><A NAME="SECTION000115000000000000000">
+clone -- clone  current
+  preconditioner</A>
+</H2>
+
+<PRE>
+call  prec%clone(precout,info)
+</PRE>
+
+<P>
+<DL>
+<DT><STRONG>Type:</STRONG></DT>
+<DD>Asynchronous.
+</DD>
+<DT><STRONG><B>On Entry</B></STRONG></DT>
+<DD>
+</DD>
+<DT><STRONG>prec</STRONG></DT>
+<DD>the preconditioner.
+<BR>
+Scope: <B>local</B>.
+<BR></DD>
+</DL>
+
+<P>
+<DL>
+<DT><STRONG><B>On Return</B></STRONG></DT>
+<DD>
+</DD>
+<DT><STRONG>precout</STRONG></DT>
+<DD>A copy of the input object.
+</DD>
+<DT><STRONG>info</STRONG></DT>
+<DD>Return code. 
+</DD>
+</DL>
+
+<P>
+<BR><HR>
+
+</BODY>
+</HTML>
@@ -0,0 +1,79 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
+
+<!--Converted with LaTeX2HTML 2008 (1.71)
+original version by:  Nikos Drakos, CBLU, University of Leeds
+* revised and updated by:  Marcus Hennecke, Ross Moore, Herb Swan
+* with significant contributions from:
+  Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
+<HTML>
+<HEAD>
+<TITLE>Iterative Methods</TITLE>
+<META NAME="description" CONTENT="Iterative Methods">
+<META NAME="keywords" CONTENT="userhtml">
+<META NAME="resource-type" CONTENT="document">
+<META NAME="distribution" CONTENT="global">
+
+<META NAME="Generator" CONTENT="LaTeX2HTML v2008">
+<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
+
+<LINK REL="STYLESHEET" HREF="userhtml.css">
+
+<LINK REL="next" HREF="node127.html">
+<LINK REL="previous" HREF="node119.html">
+<LINK REL="up" HREF="userhtml.html">
+<LINK REL="next" HREF="node126.html">
+</HEAD>
+
+<BODY >
+<!--Navigation Panel-->
+<A NAME="tex2html1802"
+  HREF="node126.html">
+<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
+<A NAME="tex2html1798"
+  HREF="userhtml.html">
+<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
+<A NAME="tex2html1792"
+  HREF="node124.html">
+<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
+<A NAME="tex2html1800"
+  HREF="node1.html">
+<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
+<BR>
+<B> Next:</B> <A NAME="tex2html1803"
+  HREF="node126.html">psb_krylov   Krylov</A>
+<B> Up:</B> <A NAME="tex2html1799"
+  HREF="userhtml.html">userhtml</A>
+<B> Previous:</B> <A NAME="tex2html1793"
+  HREF="node124.html">clone   clone</A>
+ &nbsp; <B>  <A NAME="tex2html1801"
+  HREF="node1.html">Contents</A></B> 
+<BR>
+<BR>
+<!--End of Navigation Panel-->
+
+<H1><A NAME="SECTION000120000000000000000"></A>
+<A NAME="sec:methods"></A>
+<BR>
+Iterative Methods
+</H1>
+
+<P>
+In this chapter we provide routines for preconditioners and iterative
+methods. The interfaces for Krylov subspace methods are available in
+the module <code>psb_krylov_mod</code>.
+
+<P>
+<BR><HR>
+<!--Table of Child-Links-->
+<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>
+
+<UL>
+<LI><A NAME="tex2html1804"
+  HREF="node126.html">psb_krylov  -- Krylov Methods Driver
+      Routine</A>
+</UL>
+<!--End of Table of Child-Links-->
+<BR><HR>
+
+</BODY>
+</HTML>
@@ -0,0 +1,394 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
+
+<!--Converted with LaTeX2HTML 2008 (1.71)
+original version by:  Nikos Drakos, CBLU, University of Leeds
+* revised and updated by:  Marcus Hennecke, Ross Moore, Herb Swan
+* with significant contributions from:
+  Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
+<HTML>
+<HEAD>
+<TITLE>psb_krylov -- Krylov Methods Driver Routine</TITLE>
+<META NAME="description" CONTENT="psb_krylov -- Krylov Methods Driver Routine">
+<META NAME="keywords" CONTENT="userhtml">
+<META NAME="resource-type" CONTENT="document">
+<META NAME="distribution" CONTENT="global">
+
+<META NAME="Generator" CONTENT="LaTeX2HTML v2008">
+<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
+
+<LINK REL="STYLESHEET" HREF="userhtml.css">
+
+<LINK REL="previous" HREF="node125.html">
+<LINK REL="up" HREF="node125.html">
+<LINK REL="next" HREF="node127.html">
+</HEAD>
+
+<BODY >
+<!--Navigation Panel-->
+<A NAME="tex2html1813"
+  HREF="node127.html">
+<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
+<A NAME="tex2html1809"
+  HREF="node125.html">
+<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
+<A NAME="tex2html1805"
+  HREF="node125.html">
+<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
+<A NAME="tex2html1811"
+  HREF="node1.html">
+<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
+<BR>
+<B> Next:</B> <A NAME="tex2html1814"
+  HREF="node127.html">Bibliography</A>
+<B> Up:</B> <A NAME="tex2html1810"
+  HREF="node125.html">Iterative Methods</A>
+<B> Previous:</B> <A NAME="tex2html1806"
+  HREF="node125.html">Iterative Methods</A>
+ &nbsp; <B>  <A NAME="tex2html1812"
+  HREF="node1.html">Contents</A></B> 
+<BR>
+<BR>
+<!--End of Navigation Panel-->
+
+<H2><A NAME="SECTION000121000000000000000"></A><A NAME="krylov"></A>
+<BR>
+psb_krylov  -- Krylov Methods Driver
+      Routine
+</H2>
+
+<P>
+This subroutine is a driver that provides a general interface for all
+the Krylov-Subspace family methods implemented in PSBLAS version 2. 
+
+<P>
+The stopping criterion is the normwise backward error, in the infinity
+norm, i.e. the iteration is stopped when 
+<BR><P></P>
+<DIV ALIGN="CENTER">
+<!-- MATH
+ \begin{displaymath}
+err = \frac{\|r_i\|}{(\|A\|\|x_i\|+\|b\|)} < eps
+\end{displaymath}
+ -->
+
+<IMG
+ WIDTH="204" HEIGHT="44" BORDER="0"
+ SRC="img157.png"
+ ALT="\begin{displaymath}err = \frac{\Vert r_i\Vert}{(\Vert A\Vert\Vert x_i\Vert+\Vert b\Vert)} &lt; eps \end{displaymath}">
+</DIV>
+<BR CLEAR="ALL">
+<P></P>
+or the 2-norm residual reduction
+<BR><P></P>
+<DIV ALIGN="CENTER">
+<!-- MATH
+ \begin{displaymath}
+err = \frac{\|r_i\|}{\|b\|_2} < eps
+\end{displaymath}
+ -->
+
+<IMG
+ WIDTH="121" HEIGHT="44" BORDER="0"
+ SRC="img158.png"
+ ALT="\begin{displaymath}err = \frac{\Vert r_i\Vert}{\Vert b\Vert _2} &lt; eps \end{displaymath}">
+</DIV>
+<BR CLEAR="ALL">
+<P></P>
+according to the value passed through the  istop argument (see
+later). In the above formulae, <IMG
+ WIDTH="18" HEIGHT="30" ALIGN="MIDDLE" BORDER="0"
+ SRC="img159.png"
+ ALT="$x_i$"> is the tentative solution and
+<IMG
+ WIDTH="91" HEIGHT="30" ALIGN="MIDDLE" BORDER="0"
+ SRC="img160.png"
+ ALT="$r_i=b-Ax_i$"> the corresponding residual at the <IMG
+ WIDTH="9" HEIGHT="17" ALIGN="BOTTOM" BORDER="0"
+ SRC="img4.png"
+ ALT="$i$">-th iteration. 
+
+<P>
+<BR>
+<IMG
+ WIDTH="482" HEIGHT="35" ALIGN="BOTTOM" BORDER="0"
+ SRC="img161.png"
+ ALT="\begin{lstlisting}
+call psb_krylov(method,a,prec,b,x,eps,desc_a,info,&amp;
+&amp; itmax,iter,err,itrace,irst,istop,cond)
+\end{lstlisting}">
+<BR>
+
+<P>
+<DL>
+<DT><STRONG>Type:</STRONG></DT>
+<DD>Synchronous.
+</DD>
+<DT><STRONG><B>On Entry</B></STRONG></DT>
+<DD>
+</DD>
+<DT><STRONG>method</STRONG></DT>
+<DD>a string that defines the iterative method to be
+  used. Supported values are:
+  <DL>
+<DT><STRONG>CG:</STRONG></DT>
+<DD>the Conjugate Gradient method;
+  
+</DD>
+<DT><STRONG>CGS:</STRONG></DT>
+<DD>the Conjugate Gradient Stabilized method;
+
+<P>
+</DD>
+<DT><STRONG>BICG:</STRONG></DT>
+<DD>the Bi-Conjugate Gradient method;
+  
+</DD>
+<DT><STRONG>BICGSTAB:</STRONG></DT>
+<DD>the Bi-Conjugate Gradient Stabilized method;
+  
+</DD>
+<DT><STRONG>BICGSTABL:</STRONG></DT>
+<DD>the Bi-Conjugate Gradient Stabilized method with restarting;
+  
+</DD>
+<DT><STRONG>RGMRES:</STRONG></DT>
+<DD>the Generalized Minimal Residual method with restarting.
+  
+</DD>
+</DL>
+</DD>
+<DT><STRONG>a</STRONG></DT>
+<DD>the local portion of global sparse matrix
+<IMG
+ WIDTH="16" HEIGHT="14" ALIGN="BOTTOM" BORDER="0"
+ SRC="img1.png"
+ ALT="$A$">. 
+<BR>
+Scope: <B>local</B> 
+<BR>
+Type: <B>required</B>
+<BR>
+Intent: <B>in</B>.
+<BR>
+Specified as: a structured data of type spdata<TT>psb_Tspmat_type</TT>.
+</DD>
+<DT><STRONG>prec</STRONG></DT>
+<DD>The data structure containing the preconditioner.
+<BR>
+Scope: <B>local</B> 
+<BR>
+Type: <B>required</B>
+<BR>
+Intent: <B>in</B>.
+<BR>
+Specified as: a structured data of type precdata<TT>psb_prec_type</TT>.
+</DD>
+<DT><STRONG>b</STRONG></DT>
+<DD>The RHS vector. 
+<BR>
+Scope: <B>local</B> 
+<BR>
+Type: <B>required</B>
+<BR>
+Intent: <B>in</B>.
+<BR>
+Specified as:  a rank one array or an object of type vdata<TT>psb_T_vect_type</TT>.
+</DD>
+<DT><STRONG>x</STRONG></DT>
+<DD>The initial guess. 
+<BR>
+Scope: <B>local</B> 
+<BR>
+Type: <B>required</B>
+<BR>
+Intent: <B>inout</B>.
+<BR>
+Specified as:  a rank one array or an object of type vdata<TT>psb_T_vect_type</TT>.
+</DD>
+<DT><STRONG>eps</STRONG></DT>
+<DD>The stopping tolerance. 
+<BR>
+Scope: <B>global</B> 
+<BR>
+Type: <B>required</B>
+<BR>
+Intent: <B>in</B>.
+<BR>
+Specified as: a real number. 
+</DD>
+<DT><STRONG>desc_a</STRONG></DT>
+<DD>contains data structures for communications.
+<BR>
+Scope: <B>local</B> 
+<BR>
+Type: <B>required</B>
+<BR>
+Intent: <B>in</B>.
+<BR>
+Specified as: a structured data of type descdata<TT>psb_desc_type</TT>.
+</DD>
+<DT><STRONG>itmax</STRONG></DT>
+<DD>The maximum number of iterations to perform.
+<BR>
+Scope: <B>global</B> 
+<BR>
+Type: <B>optional</B>
+<BR>
+Intent: <B>in</B>.
+<BR>
+Default: <IMG
+ WIDTH="100" HEIGHT="17" ALIGN="BOTTOM" BORDER="0"
+ SRC="img162.png"
+ ALT="$itmax = 1000$">.
+<BR>
+Specified as: an integer variable <IMG
+ WIDTH="75" HEIGHT="29" ALIGN="MIDDLE" BORDER="0"
+ SRC="img163.png"
+ ALT="$itmax \ge 1$">.
+</DD>
+<DT><STRONG>itrace</STRONG></DT>
+<DD>If <IMG
+ WIDTH="28" HEIGHT="30" ALIGN="MIDDLE" BORDER="0"
+ SRC="img112.png"
+ ALT="$&gt;0$"> print out an informational message about
+  convergence  every <IMG
+ WIDTH="46" HEIGHT="17" ALIGN="BOTTOM" BORDER="0"
+ SRC="img164.png"
+ ALT="$itrace$"> iterations.
+<BR>
+Scope: <B>global</B> 
+<BR>
+Type: <B>optional</B>
+<BR>
+Intent: <B>in</B>.
+<BR></DD>
+<DT><STRONG>irst</STRONG></DT>
+<DD>An integer specifying the restart parameter.
+<BR>
+Scope: <B>global</B> 
+<BR>
+Type: <B>optional</B>.
+<BR>
+Intent: <B>in</B>.
+<BR>
+Values: <IMG
+ WIDTH="60" HEIGHT="29" ALIGN="MIDDLE" BORDER="0"
+ SRC="img165.png"
+ ALT="$irst&gt;0$">. This is employed for the BiCGSTABL or RGMRES
+methods, otherwise it is ignored. 
+
+<P>
+</DD>
+<DT><STRONG>istop</STRONG></DT>
+<DD>An integer specifying the stopping criterion.
+<BR>
+Scope: <B>global</B> 
+<BR>
+Type: <B>optional</B>.
+<BR>
+Intent: <B>in</B>.
+<BR>
+Values: 1: use the normwise backward error, 2: use the scaled 2-norm
+of the residual. Default: 2. 
+</DD>
+<DT><STRONG><B>On Return</B></STRONG></DT>
+<DD>
+</DD>
+<DT><STRONG>x</STRONG></DT>
+<DD>The computed solution. 
+<BR>
+Scope: <B>local</B> 
+<BR>
+Type: <B>required</B>
+<BR>
+Intent: <B>inout</B>.
+<BR>
+Specified as:  a rank one array or an object of type vdata<TT>psb_T_vect_type</TT>.
+</DD>
+<DT><STRONG>iter</STRONG></DT>
+<DD>The number of iterations performed.
+<BR>
+Scope: <B>global</B> 
+<BR>
+Type: <B>optional</B>
+<BR>
+Intent: <B>out</B>.
+<BR>
+Returned  as: an integer variable.
+</DD>
+<DT><STRONG>err</STRONG></DT>
+<DD>The convergence estimate on exit.
+<BR>
+Scope: <B>global</B> 
+<BR>
+Type: <B>optional</B>
+<BR>
+Intent: <B>out</B>.
+<BR>
+Returned  as: a real number.
+</DD>
+<DT><STRONG>cond</STRONG></DT>
+<DD>An estimate of the condition number of matrix <IMG
+ WIDTH="16" HEIGHT="14" ALIGN="BOTTOM" BORDER="0"
+ SRC="img1.png"
+ ALT="$A$">; only
+  available with the <IMG
+ WIDTH="29" HEIGHT="14" ALIGN="BOTTOM" BORDER="0"
+ SRC="img166.png"
+ ALT="$CG$"> method.
+<BR>
+Scope: <B>global</B> 
+<BR>
+Type: <B>optional</B>
+<BR>
+Intent: <B>out</B>.
+<BR>
+Returned  as: a real number.
+</DD>
+<DT><STRONG>info</STRONG></DT>
+<DD>Error code.
+<BR>
+Scope: <B>local</B> 
+<BR>
+Type: <B>required</B> 
+<BR>
+Intent: <B>out</B>.
+<BR>
+An integer value; 0 means no error has been detected. 
+</DD>
+</DL>
+
+<P>
+
+<P>
+
+<P>
+
+<P>
+<HR>
+<!--Navigation Panel-->
+<A NAME="tex2html1813"
+  HREF="node127.html">
+<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
+<A NAME="tex2html1809"
+  HREF="node125.html">
+<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
+<A NAME="tex2html1805"
+  HREF="node125.html">
+<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
+<A NAME="tex2html1811"
+  HREF="node1.html">
+<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
+<BR>
+<B> Next:</B> <A NAME="tex2html1814"
+  HREF="node127.html">Bibliography</A>
+<B> Up:</B> <A NAME="tex2html1810"
+  HREF="node125.html">Iterative Methods</A>
+<B> Previous:</B> <A NAME="tex2html1806"
+  HREF="node125.html">Iterative Methods</A>
+ &nbsp; <B>  <A NAME="tex2html1812"
+  HREF="node1.html">Contents</A></B> 
+<!--End of Navigation Panel-->
+
+</BODY>
+</HTML>
@@ -0,0 +1,183 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
+
+<!--Converted with LaTeX2HTML 2008 (1.71)
+original version by:  Nikos Drakos, CBLU, University of Leeds
+* revised and updated by:  Marcus Hennecke, Ross Moore, Herb Swan
+* with significant contributions from:
+  Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
+<HTML>
+<HEAD>
+<TITLE>Bibliography</TITLE>
+<META NAME="description" CONTENT="Bibliography">
+<META NAME="keywords" CONTENT="userhtml">
+<META NAME="resource-type" CONTENT="document">
+<META NAME="distribution" CONTENT="global">
+
+<META NAME="Generator" CONTENT="LaTeX2HTML v2008">
+<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
+
+<LINK REL="STYLESHEET" HREF="userhtml.css">
+
+<LINK REL="next" HREF="node128.html">
+<LINK REL="previous" HREF="node125.html">
+<LINK REL="up" HREF="userhtml.html">
+<LINK REL="next" HREF="node128.html">
+</HEAD>
+
+<BODY >
+<!--Navigation Panel-->
+<A NAME="tex2html1825"
+  HREF="node128.html">
+<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
+<A NAME="tex2html1821"
+  HREF="userhtml.html">
+<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
+<A NAME="tex2html1815"
+  HREF="node126.html">
+<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
+<A NAME="tex2html1823"
+  HREF="node1.html">
+<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
+<BR>
+<B> Next:</B> <A NAME="tex2html1826"
+  HREF="node128.html">About this document ...</A>
+<B> Up:</B> <A NAME="tex2html1822"
+  HREF="userhtml.html">userhtml</A>
+<B> Previous:</B> <A NAME="tex2html1816"
+  HREF="node126.html">psb_krylov   Krylov</A>
+ &nbsp; <B>  <A NAME="tex2html1824"
+  HREF="node1.html">Contents</A></B> 
+<BR><BR>
+<!--End of Navigation Panel-->
+ 
+<H2><A NAME="SECTION000130000000000000000">
+Bibliography</A>
+</H2><DL COMPACT><DD><P></P><DT><A NAME="DesPat:11">1</A>
+<DD>
+ D.&nbsp;Barbieri, V.&nbsp;Cardellini, S.&nbsp;Filippone and D.&nbsp;Rouson
+<EM>Design Patterns for Scientific Computations on Sparse Matrices</EM>,
+ HPSS 2011, Algorithms and Programming Tools for Next-Generation High-Performance Scientific Software, Bordeaux, Sep. 2011
+
+<P>
+<P></P><DT><A NAME="PARA04FOREST">2</A>
+<DD>
+G.&nbsp;Bella, S.&nbsp;Filippone, A.&nbsp;De Maio and M.&nbsp;Testa,
+<EM>A Simulation Model for Forest Fires</EM>,
+in J.&nbsp;Dongarra, K.&nbsp;Madsen, J.&nbsp;Wasniewski, editors,
+Proceedings of PARA&nbsp;04 Workshop on State of the Art
+in Scientific Computing, pp.&nbsp;546-553, Lecture Notes in Computer Science,
+Springer, 2005.
+<P></P><DT><A NAME="2007d">3</A>
+<DD> A. Buttari, D. di Serafino, P. D'Ambra, S. Filippone,<BR>
+2LEV-D2P4: a package of high-performance preconditioners,<BR>
+Applicable Algebra in Engineering, Communications and Computing, 
+Volume 18, Number 3, May, 2007, pp.  223-239
+<P></P><DT><A NAME="2007c">4</A>
+<DD>  P. D'Ambra, S. Filippone,  D. Di Serafino<BR>
+On the Development of PSBLAS-based Parallel Two-level Schwarz Preconditioners
+<BR>
+Applied Numerical Mathematics, Elsevier Science, 
+Volume 57, Issues 11-12, November-December 2007, Pages 1181-1196.
+
+<P>
+<P></P><DT><A NAME="BLAS2">5</A>
+<DD>
+ Dongarra, J. J.,  DuCroz, J.,  Hammarling, S. and Hanson, R.,
+An Extended Set of Fortran Basic Linear Algebra Subprograms,
+ACM Trans. Math. Softw. vol.&nbsp;14, 1-17, 1988.
+<P></P><DT><A NAME="BLAS3">6</A>
+<DD>
+  Dongarra, J., DuCroz, J., Hammarling, S. and Duff, I.,
+A  Set of level 3 Basic Linear Algebra Subprograms,
+ACM Trans. Math. Softw. vol.&nbsp;16, 1-17, 1990.
+<P></P><DT><A NAME="BLACS">7</A>
+<DD>
+J.&nbsp;J.&nbsp;Dongarra and R.&nbsp;C.&nbsp;Whaley,
+<EM>A User's Guide to the BLACS v.&nbsp;1.1</EM>,
+Lapack Working Note 94, Tech. Rep. UT-CS-95-281, University of
+Tennessee, March 1995 (updated May 1997).
+<P></P><DT><A NAME="sblas97">8</A>
+<DD>
+I.&nbsp;Duff, M.&nbsp;Marrone, G.&nbsp;Radicati and C.&nbsp;Vittoli,
+<EM>Level 3 Basic Linear Algebra Subprograms for Sparse Matrices: 
+a User Level Interface</EM>,
+ACM Transactions on Mathematical Software, 23(3), pp.&nbsp;379-401, 1997.
+<P></P><DT><A NAME="sblas02">9</A>
+<DD>
+I.&nbsp;Duff, M.&nbsp;Heroux and R.&nbsp;Pozo,
+<EM>An Overview of the Sparse Basic Linear
+Algebra Subprograms: the New Standard from the BLAS Technical Forum</EM>,
+ACM Transactions on Mathematical Software, 28(2), pp.&nbsp;239-267, 2002.
+<P></P><DT><A NAME="PSBLAS">10</A>
+<DD>
+S.&nbsp;Filippone and M.&nbsp;Colajanni, 
+<EM>PSBLAS: A Library for Parallel Linear Algebra
+Computation on Sparse Matrices</EM>,
+<BR>
+ACM Transactions on Mathematical Software, 26(4), pp.&nbsp;527-550, 2000.
+<P></P><DT><A NAME="Sparse03">11</A>
+<DD>
+S.&nbsp;Filippone and A.&nbsp;Buttari, 
+<EM>Object-Oriented Techniques for Sparse Matrix Computations in Fortran 2003</EM>,
+<BR>
+ACM Transactions on Mathematical Software, to appear.
+<P></P><DT><A NAME="KIVA3PSBLAS">12</A>
+<DD>
+S.&nbsp;Filippone, P.&nbsp;D'Ambra, M.&nbsp;Colajanni,
+<EM>Using a Parallel Library of Sparse Linear Algebra in a Fluid Dynamics 
+Applications Code on Linux Clusters</EM>,
+in G.&nbsp;Joubert, A.&nbsp;Murli, F.&nbsp;Peters, M.&nbsp;Vanneschi, editors,
+Parallel Computing - Advances &amp; Current Issues,
+pp.&nbsp;441-448, Imperial College Press, 2002. 
+<P></P><DT><A NAME="DesignPatterns">13</A>
+<DD>
+ Gamma, E.,  Helm, R.,  Johnson, R.,  and  Vlissides,
+  J. 1995.
+ <EM>Design Patterns: Elements of Reusable Object-Oriented Software</EM>.
+ Addison-Wesley.
+
+<P>
+<P></P><DT><A NAME="METIS">14</A>
+<DD>
+Karypis, G. and Kumar, V.,
+<EM>METIS: Unstructured Graph Partitioning and Sparse Matrix
+  Ordering System</EM>.
+Minneapolis, MN 55455: University of Minnesota, Department of
+  Computer Science, 1995. 
+Internet Address: <code>http://www.cs.umn.edu/~karypis</code>.
+<P></P><DT><A NAME="BLAS1">15</A>
+<DD>
+Lawson, C.,  Hanson, R., Kincaid, D. and Krogh, F.,
+   Basic Linear Algebra Subprograms for Fortran usage,
+ACM Trans. Math. Softw. vol.&nbsp;5, 38-329, 1979.
+
+<P>
+<P></P><DT><A NAME="machiels">16</A>
+<DD>
+Machiels, L. and Deville, M.
+<EM>Fortran 90: An entry to object-oriented programming for the solution
+  of partial differential equations.</EM>
+ACM Trans. Math. Softw. vol.&nbsp;23, 32-49.
+<P></P><DT><A NAME="metcalf">17</A>
+<DD>
+Metcalf, M., Reid, J. and Cohen, M.
+<EM>Fortran 95/2003 explained.</EM>
+Oxford University Press, 2004.
+<P></P><DT><A NAME="RouXiaXu:11">18</A>
+<DD>
+Rouson, D.W.I., Xia, J., Xu, X.: Scientific Software Design: The
+  Object-Oriented Way. Cambridge University Press (2011)
+
+<P>
+<P></P><DT><A NAME="MPI1">19</A>
+<DD>
+M.&nbsp;Snir, S.&nbsp;Otto, S.&nbsp;Huss-Lederman, D.&nbsp;Walker and J.&nbsp;Dongarra,
+<EM>MPI: The Complete Reference. Volume 1 - The MPI Core</EM>, second edition,
+MIT Press, 1998.
+</DL>
+
+<P>
+<BR><HR>
+
+</BODY>
+</HTML>
@@ -0,0 +1,70 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
+
+<!--Converted with LaTeX2HTML 2008 (1.71)
+original version by:  Nikos Drakos, CBLU, University of Leeds
+* revised and updated by:  Marcus Hennecke, Ross Moore, Herb Swan
+* with significant contributions from:
+  Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
+<HTML>
+<HEAD>
+<TITLE>About this document ...</TITLE>
+<META NAME="description" CONTENT="About this document ...">
+<META NAME="keywords" CONTENT="userhtml">
+<META NAME="resource-type" CONTENT="document">
+<META NAME="distribution" CONTENT="global">
+
+<META NAME="Generator" CONTENT="LaTeX2HTML v2008">
+<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
+
+<LINK REL="STYLESHEET" HREF="userhtml.css">
+
+<LINK REL="previous" HREF="node127.html">
+<LINK REL="up" HREF="userhtml.html">
+</HEAD>
+
+<BODY >
+<!--Navigation Panel-->
+<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next_g.png"> 
+<A NAME="tex2html1831"
+  HREF="userhtml.html">
+<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
+<A NAME="tex2html1827"
+  HREF="node127.html">
+<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
+<A NAME="tex2html1833"
+  HREF="node1.html">
+<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
+<BR>
+<B> Up:</B> <A NAME="tex2html1832"
+  HREF="userhtml.html">userhtml</A>
+<B> Previous:</B> <A NAME="tex2html1828"
+  HREF="node127.html">Bibliography</A>
+ &nbsp; <B>  <A NAME="tex2html1834"
+  HREF="node1.html">Contents</A></B> 
+<BR>
+<BR>
+<!--End of Navigation Panel-->
+
+<H1><A NAME="SECTION000140000000000000000">
+About this document ...</A>
+</H1>
+ <P>
+This document was generated using the
+<A HREF="http://www.latex2html.org/"><STRONG>LaTeX</STRONG>2<tt>HTML</tt></A> translator Version 2008 (1.71)
+<P>
+Copyright &#169; 1993, 1994, 1995, 1996,
+<A HREF="http://cbl.leeds.ac.uk/nikos/personal.html">Nikos Drakos</A>, 
+Computer Based Learning Unit, University of Leeds.
+<BR>
+Copyright &#169; 1997, 1998, 1999,
+<A HREF="http://www.maths.mq.edu.au/~ross/">Ross Moore</A>, 
+Mathematics Department, Macquarie University, Sydney.
+<P>
+The command line arguments were: <BR>
+ <STRONG>latex2html</STRONG> <TT>-local_icons -noaddress -dir ../../html userhtml.tex</TT>
+<P>
+The translation was initiated by Salvatore Filippone on 2014-03-26
+<BR><HR>
+
+</BODY>
+</HTML>
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html378"
+<A NAME="tex2html384"
  HREF="node14.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html374"
+<A NAME="tex2html380"
  HREF="node10.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html368"
+<A NAME="tex2html374"
  HREF="node12.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html376"
+<A NAME="tex2html382"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html379"
+<B> Next:</B> <A NAME="tex2html385"
  HREF="node14.html">get_global_rows   Get</A>
-<B> Up:</B> <A NAME="tex2html375"
+<B> Up:</B> <A NAME="tex2html381"
  HREF="node10.html">Descriptor data structure</A>
-<B> Previous:</B> <A NAME="tex2html369"
+<B> Previous:</B> <A NAME="tex2html375"
  HREF="node12.html">get_local_rows   Get</A>
- &nbsp; <B>  <A NAME="tex2html377"
+ &nbsp; <B>  <A NAME="tex2html383"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html390"
+<A NAME="tex2html396"
  HREF="node15.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html386"
+<A NAME="tex2html392"
  HREF="node10.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html380"
+<A NAME="tex2html386"
  HREF="node13.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html388"
+<A NAME="tex2html394"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html391"
+<B> Next:</B> <A NAME="tex2html397"
  HREF="node15.html">get_global_cols   Get</A>
-<B> Up:</B> <A NAME="tex2html387"
+<B> Up:</B> <A NAME="tex2html393"
  HREF="node10.html">Descriptor data structure</A>
-<B> Previous:</B> <A NAME="tex2html381"
+<B> Previous:</B> <A NAME="tex2html387"
  HREF="node13.html">get_local_cols   Get</A>
- &nbsp; <B>  <A NAME="tex2html389"
+ &nbsp; <B>  <A NAME="tex2html395"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html402"
+<A NAME="tex2html408"
  HREF="node16.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html398"
+<A NAME="tex2html404"
  HREF="node10.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html392"
+<A NAME="tex2html398"
  HREF="node14.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html400"
+<A NAME="tex2html406"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html403"
+<B> Next:</B> <A NAME="tex2html409"
  HREF="node16.html">get_context   Get</A>
-<B> Up:</B> <A NAME="tex2html399"
+<B> Up:</B> <A NAME="tex2html405"
  HREF="node10.html">Descriptor data structure</A>
-<B> Previous:</B> <A NAME="tex2html393"
+<B> Previous:</B> <A NAME="tex2html399"
  HREF="node14.html">get_global_rows   Get</A>
- &nbsp; <B>  <A NAME="tex2html401"
+ &nbsp; <B>  <A NAME="tex2html407"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html414"
+<A NAME="tex2html420"
  HREF="node17.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html410"
+<A NAME="tex2html416"
  HREF="node10.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html404"
+<A NAME="tex2html410"
  HREF="node15.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html412"
+<A NAME="tex2html418"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html415"
+<B> Next:</B> <A NAME="tex2html421"
  HREF="node17.html">Clone   clone</A>
-<B> Up:</B> <A NAME="tex2html411"
+<B> Up:</B> <A NAME="tex2html417"
  HREF="node10.html">Descriptor data structure</A>
-<B> Previous:</B> <A NAME="tex2html405"
+<B> Previous:</B> <A NAME="tex2html411"
  HREF="node15.html">get_global_cols   Get</A>
- &nbsp; <B>  <A NAME="tex2html413"
+ &nbsp; <B>  <A NAME="tex2html419"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html426"
+<A NAME="tex2html432"
  HREF="node18.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html422"
+<A NAME="tex2html428"
  HREF="node10.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html416"
+<A NAME="tex2html422"
  HREF="node16.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html424"
+<A NAME="tex2html430"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html427"
+<B> Next:</B> <A NAME="tex2html433"
  HREF="node18.html">psb_cd_get_large_threshold   Get</A>
-<B> Up:</B> <A NAME="tex2html423"
+<B> Up:</B> <A NAME="tex2html429"
  HREF="node10.html">Descriptor data structure</A>
-<B> Previous:</B> <A NAME="tex2html417"
+<B> Previous:</B> <A NAME="tex2html423"
  HREF="node16.html">get_context   Get</A>
- &nbsp; <B>  <A NAME="tex2html425"
+ &nbsp; <B>  <A NAME="tex2html431"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html438"
+<A NAME="tex2html444"
  HREF="node19.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html434"
+<A NAME="tex2html440"
  HREF="node10.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html428"
+<A NAME="tex2html434"
  HREF="node17.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html436"
+<A NAME="tex2html442"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html439"
+<B> Next:</B> <A NAME="tex2html445"
  HREF="node19.html">psb_cd_set_large_threshold   Set</A>
-<B> Up:</B> <A NAME="tex2html435"
+<B> Up:</B> <A NAME="tex2html441"
  HREF="node10.html">Descriptor data structure</A>
-<B> Previous:</B> <A NAME="tex2html429"
+<B> Previous:</B> <A NAME="tex2html435"
  HREF="node17.html">Clone   clone</A>
- &nbsp; <B>  <A NAME="tex2html437"
+ &nbsp; <B>  <A NAME="tex2html443"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html450"
+<A NAME="tex2html456"
  HREF="node20.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html446"
+<A NAME="tex2html452"
  HREF="node10.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html440"
+<A NAME="tex2html446"
  HREF="node18.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html448"
+<A NAME="tex2html454"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html451"
+<B> Next:</B> <A NAME="tex2html457"
  HREF="node20.html">Named Constants</A>
-<B> Up:</B> <A NAME="tex2html447"
+<B> Up:</B> <A NAME="tex2html453"
  HREF="node10.html">Descriptor data structure</A>
-<B> Previous:</B> <A NAME="tex2html441"
+<B> Previous:</B> <A NAME="tex2html447"
  HREF="node18.html">psb_cd_get_large_threshold   Get</A>
- &nbsp; <B>  <A NAME="tex2html449"
+ &nbsp; <B>  <A NAME="tex2html455"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html197"
+<A NAME="tex2html203"
  HREF="node3.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html193"
+<A NAME="tex2html199"
  HREF="userhtml.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html187"
+<A NAME="tex2html193"
  HREF="node1.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html195"
+<A NAME="tex2html201"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html198"
+<B> Next:</B> <A NAME="tex2html204"
  HREF="node3.html">General overview</A>
-<B> Up:</B> <A NAME="tex2html194"
+<B> Up:</B> <A NAME="tex2html200"
  HREF="userhtml.html">userhtml</A>
-<B> Previous:</B> <A NAME="tex2html188"
+<B> Previous:</B> <A NAME="tex2html194"
  HREF="node1.html">Contents</A>
- &nbsp; <B>  <A NAME="tex2html196"
+ &nbsp; <B>  <A NAME="tex2html202"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -71,7 +71,7 @@ passing.
 <P>
 The PSBLAS library version 3 is  implemented in
 the Fortran&nbsp;2003&nbsp;[<A
- HREF="node121.html#metcalf">17</A>] programming language, with reuse and/or
+ HREF="node127.html#metcalf">17</A>] programming language, with reuse and/or
 adaptation of  existing Fortran&nbsp;77 and Fortran&nbsp;95 software, plus a
 handful of C  routines. 

@@ -81,11 +81,11 @@ mostly in the handling of requirements for evolution and adaptation of
 the library to new computing architectures and integration of
 new algorithms. 
 For a detailed discussion of our design see&nbsp;[<A
- HREF="node121.html#Sparse03">11</A>]; other
+ HREF="node127.html#Sparse03">11</A>]; other
 works discussing advanced programming in Fortran&nbsp;2003
 include&nbsp;[<A
- HREF="node121.html#DesPat:11">1</A>,<A
- HREF="node121.html#RouXiaXu:11">18</A>]; sufficient support for
+ HREF="node127.html#DesPat:11">1</A>,<A
+ HREF="node127.html#RouXiaXu:11">18</A>]; sufficient support for
 Fortran&nbsp;2003 is now available from many compilers, including the GNU
 Fortran compiler from the Free Software Foundation (as of version 4.6). 

@@ -94,7 +94,7 @@ Previous approaches have been based on mixing Fortran&nbsp;95, with its
 support for object-based design, with other languages; these have
 been advocated by a number of authors, 
 e.g.&nbsp;[<A
- HREF="node121.html#machiels">16</A>].  Moreover, the Fortran&nbsp;95 facilities for dynamic
+ HREF="node127.html#machiels">16</A>].  Moreover, the Fortran&nbsp;95 facilities for dynamic
 memory management and interface overloading greatly enhance the
 usability of the PSBLAS 
 subroutines. In this way, the library can take care of runtime memory
@@ -105,12 +105,12 @@ implementation or compilation time.
 The presentation of the
 PSBLAS library follows the general structure of the proposal for
 serial Sparse BLAS&nbsp;[<A
- HREF="node121.html#sblas97">8</A>,<A
- HREF="node121.html#sblas02">9</A>], which in its turn is based on the
+ HREF="node127.html#sblas97">8</A>,<A
+ HREF="node127.html#sblas02">9</A>], which in its turn is based on the
 proposal for BLAS on dense matrices&nbsp;[<A
- HREF="node121.html#BLAS1">15</A>,<A
- HREF="node121.html#BLAS2">5</A>,<A
- HREF="node121.html#BLAS3">6</A>].
+ HREF="node127.html#BLAS1">15</A>,<A
+ HREF="node127.html#BLAS2">5</A>,<A
+ HREF="node127.html#BLAS3">6</A>].

 <P>
 The applicability of sparse iterative solvers to many different areas
@@ -144,26 +144,26 @@ computational fluid dynamics applications.
 <P>
 <HR>
 <!--Navigation Panel-->
-<A NAME="tex2html197"
+<A NAME="tex2html203"
  HREF="node3.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html193"
+<A NAME="tex2html199"
  HREF="userhtml.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html187"
+<A NAME="tex2html193"
  HREF="node1.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html195"
+<A NAME="tex2html201"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html198"
+<B> Next:</B> <A NAME="tex2html204"
  HREF="node3.html">General overview</A>
-<B> Up:</B> <A NAME="tex2html194"
+<B> Up:</B> <A NAME="tex2html200"
  HREF="userhtml.html">userhtml</A>
-<B> Previous:</B> <A NAME="tex2html188"
+<B> Previous:</B> <A NAME="tex2html194"
  HREF="node1.html">Contents</A>
- &nbsp; <B>  <A NAME="tex2html196"
+ &nbsp; <B>  <A NAME="tex2html202"
  HREF="node1.html">Contents</A></B> 
 <!--End of Navigation Panel-->

@@ -25,26 +25,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html460"
+<A NAME="tex2html466"
  HREF="node21.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html456"
+<A NAME="tex2html462"
  HREF="node10.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html452"
+<A NAME="tex2html458"
  HREF="node19.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html458"
+<A NAME="tex2html464"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html461"
+<B> Next:</B> <A NAME="tex2html467"
  HREF="node21.html">Sparse Matrix class</A>
-<B> Up:</B> <A NAME="tex2html457"
+<B> Up:</B> <A NAME="tex2html463"
  HREF="node10.html">Descriptor data structure</A>
-<B> Previous:</B> <A NAME="tex2html453"
+<B> Previous:</B> <A NAME="tex2html459"
  HREF="node19.html">psb_cd_set_large_threshold   Set</A>
- &nbsp; <B>  <A NAME="tex2html459"
+ &nbsp; <B>  <A NAME="tex2html465"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html472"
+<A NAME="tex2html478"
  HREF="node22.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html468"
+<A NAME="tex2html474"
  HREF="node9.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html462"
+<A NAME="tex2html468"
  HREF="node20.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html470"
+<A NAME="tex2html476"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html473"
+<B> Next:</B> <A NAME="tex2html479"
  HREF="node22.html">Sparse Matrix Methods</A>
-<B> Up:</B> <A NAME="tex2html469"
+<B> Up:</B> <A NAME="tex2html475"
  HREF="node9.html">Data Structures and Classes</A>
-<B> Previous:</B> <A NAME="tex2html463"
+<B> Previous:</B> <A NAME="tex2html469"
  HREF="node20.html">Named Constants</A>
- &nbsp; <B>  <A NAME="tex2html471"
+ &nbsp; <B>  <A NAME="tex2html477"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -60,9 +60,9 @@ The spdata<TT>psb_Tspmat_type</TT> class
 contains all information about the local portion of the sparse matrix and   
 its storage mode. Its design is 
 based on the STATE design pattern&nbsp;[<A
- HREF="node121.html#DesignPatterns">13</A>] as detailed
+ HREF="node127.html#DesignPatterns">13</A>] as detailed
 in&nbsp;[<A
- HREF="node121.html#Sparse03">11</A>]; the type declaration is shown in
+ HREF="node127.html#Sparse03">11</A>]; the type declaration is shown in
 figure&nbsp;<A HREF="#fig:spmattype">4</A> where <code>T</code> is a placeholder for the
 data type and precision variants 
 <DL>
@@ -144,71 +144,71 @@ variants are obtained by conversion to/from it.
 <A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>

 <UL>
-<LI><A NAME="tex2html474"
+<LI><A NAME="tex2html480"
  HREF="node22.html">Sparse Matrix Methods</A>
-<LI><A NAME="tex2html475"
+<LI><A NAME="tex2html481"
  HREF="node23.html">get_nrows -- Get number of  rows in a sparse  matrix</A>
-<LI><A NAME="tex2html476"
+<LI><A NAME="tex2html482"
  HREF="node24.html">get_ncols -- Get number of  columns in a  sparse
  matrix</A>
-<LI><A NAME="tex2html477"
+<LI><A NAME="tex2html483"
  HREF="node25.html">get_nnzeros -- Get number of nonzero elements
  in a sparse matrix</A>
-<LI><A NAME="tex2html478"
+<LI><A NAME="tex2html484"
  HREF="node26.html">get_size  -- Get maximum number of nonzero elements
  in a sparse matrix</A>
-<LI><A NAME="tex2html479"
+<LI><A NAME="tex2html485"
  HREF="node27.html">sizeof  -- Get memory occupation in bytes
 of  a sparse matrix</A>
-<LI><A NAME="tex2html480"
+<LI><A NAME="tex2html486"
  HREF="node28.html">get_fmt  -- Short description of the dynamic type</A>
-<LI><A NAME="tex2html481"
+<LI><A NAME="tex2html487"
  HREF="node29.html">is_bld, is_upd, is_asb  -- Status check</A>
-<LI><A NAME="tex2html482"
+<LI><A NAME="tex2html488"
  HREF="node30.html">is_lower, is_upper, is_triangle, is_unit  --
  Format  check</A>
-<LI><A NAME="tex2html483"
-  HREF="node31.html">cscnv -- Convert to a different storage format</A>
-<LI><A NAME="tex2html484"
-  HREF="node32.html">csclip -- Reduce to a submatrix</A>
-<LI><A NAME="tex2html485"
-  HREF="node33.html">get_diag -- Get main diagonal</A>
-<LI><A NAME="tex2html486"
-  HREF="node34.html">clip_diag -- Cut out main diagonal</A>
-<LI><A NAME="tex2html487"
-  HREF="node35.html">tril -- Return the lower triangle</A>
-<LI><A NAME="tex2html488"
-  HREF="node36.html">triu -- Return the upper triangle</A>
 <LI><A NAME="tex2html489"
-  HREF="node37.html">psb_set_mat_default -- Set default  storage format</A>
+  HREF="node31.html">cscnv -- Convert to a different storage format</A>
 <LI><A NAME="tex2html490"
-  HREF="node38.html">clone -- Clone current object</A>
+  HREF="node32.html">csclip -- Reduce to a submatrix</A>
 <LI><A NAME="tex2html491"
+  HREF="node33.html">get_diag -- Get main diagonal</A>
+<LI><A NAME="tex2html492"
+  HREF="node34.html">clip_diag -- Cut out main diagonal</A>
+<LI><A NAME="tex2html493"
+  HREF="node35.html">tril -- Return the lower triangle</A>
+<LI><A NAME="tex2html494"
+  HREF="node36.html">triu -- Return the upper triangle</A>
+<LI><A NAME="tex2html495"
+  HREF="node37.html">psb_set_mat_default -- Set default  storage format</A>
+<LI><A NAME="tex2html496"
+  HREF="node38.html">clone -- Clone current object</A>
+<LI><A NAME="tex2html497"
  HREF="node39.html">Named Constants</A>
 </UL>
 <!--End of Table of Child-Links-->
 <HR>
 <!--Navigation Panel-->
-<A NAME="tex2html472"
+<A NAME="tex2html478"
  HREF="node22.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html468"
+<A NAME="tex2html474"
  HREF="node9.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html462"
+<A NAME="tex2html468"
  HREF="node20.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html470"
+<A NAME="tex2html476"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html473"
+<B> Next:</B> <A NAME="tex2html479"
  HREF="node22.html">Sparse Matrix Methods</A>
-<B> Up:</B> <A NAME="tex2html469"
+<B> Up:</B> <A NAME="tex2html475"
  HREF="node9.html">Data Structures and Classes</A>
-<B> Previous:</B> <A NAME="tex2html463"
+<B> Previous:</B> <A NAME="tex2html469"
  HREF="node20.html">Named Constants</A>
- &nbsp; <B>  <A NAME="tex2html471"
+ &nbsp; <B>  <A NAME="tex2html477"
  HREF="node1.html">Contents</A></B> 
 <!--End of Navigation Panel-->

@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html502"
+<A NAME="tex2html508"
  HREF="node23.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html498"
+<A NAME="tex2html504"
  HREF="node21.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html492"
+<A NAME="tex2html498"
  HREF="node21.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html500"
+<A NAME="tex2html506"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html503"
+<B> Next:</B> <A NAME="tex2html509"
  HREF="node23.html">get_nrows   Get</A>
-<B> Up:</B> <A NAME="tex2html499"
+<B> Up:</B> <A NAME="tex2html505"
  HREF="node21.html">Sparse Matrix class</A>
-<B> Previous:</B> <A NAME="tex2html493"
+<B> Previous:</B> <A NAME="tex2html499"
  HREF="node21.html">Sparse Matrix class</A>
- &nbsp; <B>  <A NAME="tex2html501"
+ &nbsp; <B>  <A NAME="tex2html507"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html514"
+<A NAME="tex2html520"
  HREF="node24.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html510"
+<A NAME="tex2html516"
  HREF="node21.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html504"
+<A NAME="tex2html510"
  HREF="node22.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html512"
+<A NAME="tex2html518"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html515"
+<B> Next:</B> <A NAME="tex2html521"
  HREF="node24.html">get_ncols   Get</A>
-<B> Up:</B> <A NAME="tex2html511"
+<B> Up:</B> <A NAME="tex2html517"
  HREF="node21.html">Sparse Matrix class</A>
-<B> Previous:</B> <A NAME="tex2html505"
+<B> Previous:</B> <A NAME="tex2html511"
  HREF="node22.html">Sparse Matrix Methods</A>
- &nbsp; <B>  <A NAME="tex2html513"
+ &nbsp; <B>  <A NAME="tex2html519"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html526"
+<A NAME="tex2html532"
  HREF="node25.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html522"
+<A NAME="tex2html528"
  HREF="node21.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html516"
+<A NAME="tex2html522"
  HREF="node23.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html524"
+<A NAME="tex2html530"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html527"
+<B> Next:</B> <A NAME="tex2html533"
  HREF="node25.html">get_nnzeros   Get</A>
-<B> Up:</B> <A NAME="tex2html523"
+<B> Up:</B> <A NAME="tex2html529"
  HREF="node21.html">Sparse Matrix class</A>
-<B> Previous:</B> <A NAME="tex2html517"
+<B> Previous:</B> <A NAME="tex2html523"
  HREF="node23.html">get_nrows   Get</A>
- &nbsp; <B>  <A NAME="tex2html525"
+ &nbsp; <B>  <A NAME="tex2html531"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html538"
+<A NAME="tex2html544"
  HREF="node26.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html534"
+<A NAME="tex2html540"
  HREF="node21.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html528"
+<A NAME="tex2html534"
  HREF="node24.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html536"
+<A NAME="tex2html542"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html539"
+<B> Next:</B> <A NAME="tex2html545"
  HREF="node26.html">get_size   Get</A>
-<B> Up:</B> <A NAME="tex2html535"
+<B> Up:</B> <A NAME="tex2html541"
  HREF="node21.html">Sparse Matrix class</A>
-<B> Previous:</B> <A NAME="tex2html529"
+<B> Previous:</B> <A NAME="tex2html535"
  HREF="node24.html">get_ncols   Get</A>
- &nbsp; <B>  <A NAME="tex2html537"
+ &nbsp; <B>  <A NAME="tex2html543"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html550"
+<A NAME="tex2html556"
  HREF="node27.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html546"
+<A NAME="tex2html552"
  HREF="node21.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html540"
+<A NAME="tex2html546"
  HREF="node25.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html548"
+<A NAME="tex2html554"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html551"
+<B> Next:</B> <A NAME="tex2html557"
  HREF="node27.html">sizeof   Get</A>
-<B> Up:</B> <A NAME="tex2html547"
+<B> Up:</B> <A NAME="tex2html553"
  HREF="node21.html">Sparse Matrix class</A>
-<B> Previous:</B> <A NAME="tex2html541"
+<B> Previous:</B> <A NAME="tex2html547"
  HREF="node25.html">get_nnzeros   Get</A>
- &nbsp; <B>  <A NAME="tex2html549"
+ &nbsp; <B>  <A NAME="tex2html555"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -28,26 +28,26 @@ of a sparse matrix">

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html562"
+<A NAME="tex2html568"
  HREF="node28.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html558"
+<A NAME="tex2html564"
  HREF="node21.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html552"
+<A NAME="tex2html558"
  HREF="node26.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html560"
+<A NAME="tex2html566"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html563"
+<B> Next:</B> <A NAME="tex2html569"
  HREF="node28.html">get_fmt   Short</A>
-<B> Up:</B> <A NAME="tex2html559"
+<B> Up:</B> <A NAME="tex2html565"
  HREF="node21.html">Sparse Matrix class</A>
-<B> Previous:</B> <A NAME="tex2html553"
+<B> Previous:</B> <A NAME="tex2html559"
  HREF="node26.html">get_size   Get</A>
- &nbsp; <B>  <A NAME="tex2html561"
+ &nbsp; <B>  <A NAME="tex2html567"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html574"
+<A NAME="tex2html580"
  HREF="node29.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html570"
+<A NAME="tex2html576"
  HREF="node21.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html564"
+<A NAME="tex2html570"
  HREF="node27.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html572"
+<A NAME="tex2html578"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html575"
+<B> Next:</B> <A NAME="tex2html581"
  HREF="node29.html">is_bld, is_upd, is_asb </A>
-<B> Up:</B> <A NAME="tex2html571"
+<B> Up:</B> <A NAME="tex2html577"
  HREF="node21.html">Sparse Matrix class</A>
-<B> Previous:</B> <A NAME="tex2html565"
+<B> Previous:</B> <A NAME="tex2html571"
  HREF="node27.html">sizeof   Get</A>
- &nbsp; <B>  <A NAME="tex2html573"
+ &nbsp; <B>  <A NAME="tex2html579"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html586"
+<A NAME="tex2html592"
  HREF="node30.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html582"
+<A NAME="tex2html588"
  HREF="node21.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html576"
+<A NAME="tex2html582"
  HREF="node28.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html584"
+<A NAME="tex2html590"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html587"
+<B> Next:</B> <A NAME="tex2html593"
  HREF="node30.html">is_lower, is_upper, is_triangle, is_unit</A>
-<B> Up:</B> <A NAME="tex2html583"
+<B> Up:</B> <A NAME="tex2html589"
  HREF="node21.html">Sparse Matrix class</A>
-<B> Previous:</B> <A NAME="tex2html577"
+<B> Previous:</B> <A NAME="tex2html583"
  HREF="node28.html">get_fmt   Short</A>
- &nbsp; <B>  <A NAME="tex2html585"
+ &nbsp; <B>  <A NAME="tex2html591"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html209"
+<A NAME="tex2html215"
  HREF="node4.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html205"
+<A NAME="tex2html211"
  HREF="userhtml.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html199"
+<A NAME="tex2html205"
  HREF="node2.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html207"
+<A NAME="tex2html213"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html210"
+<B> Next:</B> <A NAME="tex2html216"
  HREF="node4.html">Basic Nomenclature</A>
-<B> Up:</B> <A NAME="tex2html206"
+<B> Up:</B> <A NAME="tex2html212"
  HREF="userhtml.html">userhtml</A>
-<B> Previous:</B> <A NAME="tex2html200"
+<B> Previous:</B> <A NAME="tex2html206"
  HREF="node2.html">Introduction</A>
- &nbsp; <B>  <A NAME="tex2html208"
+ &nbsp; <B>  <A NAME="tex2html214"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -78,7 +78,7 @@ calls to the serial sparse BLAS subroutines.
 In a similar way, the inter-process message exchanges are encapsulated
 in an applicaiton layer that has been strongly inspired by the  Basic
 Linear Algebra Communication Subroutines (BLACS) library&nbsp;[<A
- HREF="node121.html#BLACS">7</A>].  
+ HREF="node127.html#BLACS">7</A>].  
 Usually  there is no need to deal directly with MPI;  however, in some
 cases, MPI routines are used directly to improve efficiency. For
 further details on our communication layer see Sec.&nbsp;<A HREF="node94.html#sec:parenv">7</A>.
@@ -134,7 +134,7 @@ equation indices to processes.
 In particular it is consistent with the
 usage of graph partitioning tools commonly available in the
 literature, e.g. METIS&nbsp;[<A
- HREF="node121.html#METIS">14</A>].
+ HREF="node127.html#METIS">14</A>].
 Dense vectors  conform  to sparse
 matrices, that is, the entries of a vector follow the same distribution
 of the matrix rows.  
@@ -154,43 +154,43 @@ bottleneck would make this option unattractive in most  cases.
 <A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>

 <UL>
-<LI><A NAME="tex2html211"
+<LI><A NAME="tex2html217"
  HREF="node4.html">Basic Nomenclature</A>
-<LI><A NAME="tex2html212"
+<LI><A NAME="tex2html218"
  HREF="node5.html">Library contents</A>
-<LI><A NAME="tex2html213"
+<LI><A NAME="tex2html219"
  HREF="node6.html">Application structure</A>
 <UL>
-<LI><A NAME="tex2html214"
+<LI><A NAME="tex2html220"
  HREF="node7.html">User-defined index mappings</A>
 </UL>
 <BR>
-<LI><A NAME="tex2html215"
+<LI><A NAME="tex2html221"
  HREF="node8.html">Programming model</A>
 </UL>
 <!--End of Table of Child-Links-->
 <HR>
 <!--Navigation Panel-->
-<A NAME="tex2html209"
+<A NAME="tex2html215"
  HREF="node4.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html205"
+<A NAME="tex2html211"
  HREF="userhtml.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html199"
+<A NAME="tex2html205"
  HREF="node2.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html207"
+<A NAME="tex2html213"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html210"
+<B> Next:</B> <A NAME="tex2html216"
  HREF="node4.html">Basic Nomenclature</A>
-<B> Up:</B> <A NAME="tex2html206"
+<B> Up:</B> <A NAME="tex2html212"
  HREF="userhtml.html">userhtml</A>
-<B> Previous:</B> <A NAME="tex2html200"
+<B> Previous:</B> <A NAME="tex2html206"
  HREF="node2.html">Introduction</A>
- &nbsp; <B>  <A NAME="tex2html208"
+ &nbsp; <B>  <A NAME="tex2html214"
  HREF="node1.html">Contents</A></B> 
 <!--End of Navigation Panel-->

@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html598"
+<A NAME="tex2html604"
  HREF="node31.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html594"
+<A NAME="tex2html600"
  HREF="node21.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html588"
+<A NAME="tex2html594"
  HREF="node29.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html596"
+<A NAME="tex2html602"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html599"
+<B> Next:</B> <A NAME="tex2html605"
  HREF="node31.html">cscnv   Convert</A>
-<B> Up:</B> <A NAME="tex2html595"
+<B> Up:</B> <A NAME="tex2html601"
  HREF="node21.html">Sparse Matrix class</A>
-<B> Previous:</B> <A NAME="tex2html589"
+<B> Previous:</B> <A NAME="tex2html595"
  HREF="node29.html">is_bld, is_upd, is_asb </A>
- &nbsp; <B>  <A NAME="tex2html597"
+ &nbsp; <B>  <A NAME="tex2html603"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html610"
+<A NAME="tex2html616"
  HREF="node32.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html606"
+<A NAME="tex2html612"
  HREF="node21.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html600"
+<A NAME="tex2html606"
  HREF="node30.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html608"
+<A NAME="tex2html614"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html611"
+<B> Next:</B> <A NAME="tex2html617"
  HREF="node32.html">csclip   Reduce</A>
-<B> Up:</B> <A NAME="tex2html607"
+<B> Up:</B> <A NAME="tex2html613"
  HREF="node21.html">Sparse Matrix class</A>
-<B> Previous:</B> <A NAME="tex2html601"
+<B> Previous:</B> <A NAME="tex2html607"
  HREF="node30.html">is_lower, is_upper, is_triangle, is_unit</A>
- &nbsp; <B>  <A NAME="tex2html609"
+ &nbsp; <B>  <A NAME="tex2html615"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html622"
+<A NAME="tex2html628"
  HREF="node33.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html618"
+<A NAME="tex2html624"
  HREF="node21.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html612"
+<A NAME="tex2html618"
  HREF="node31.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html620"
+<A NAME="tex2html626"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html623"
+<B> Next:</B> <A NAME="tex2html629"
  HREF="node33.html">get_diag   Get</A>
-<B> Up:</B> <A NAME="tex2html619"
+<B> Up:</B> <A NAME="tex2html625"
  HREF="node21.html">Sparse Matrix class</A>
-<B> Previous:</B> <A NAME="tex2html613"
+<B> Previous:</B> <A NAME="tex2html619"
  HREF="node31.html">cscnv   Convert</A>
- &nbsp; <B>  <A NAME="tex2html621"
+ &nbsp; <B>  <A NAME="tex2html627"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html634"
+<A NAME="tex2html640"
  HREF="node34.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html630"
+<A NAME="tex2html636"
  HREF="node21.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html624"
+<A NAME="tex2html630"
  HREF="node32.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html632"
+<A NAME="tex2html638"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html635"
+<B> Next:</B> <A NAME="tex2html641"
  HREF="node34.html">clip_diag   Cut</A>
-<B> Up:</B> <A NAME="tex2html631"
+<B> Up:</B> <A NAME="tex2html637"
  HREF="node21.html">Sparse Matrix class</A>
-<B> Previous:</B> <A NAME="tex2html625"
+<B> Previous:</B> <A NAME="tex2html631"
  HREF="node32.html">csclip   Reduce</A>
- &nbsp; <B>  <A NAME="tex2html633"
+ &nbsp; <B>  <A NAME="tex2html639"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html646"
+<A NAME="tex2html652"
  HREF="node35.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html642"
+<A NAME="tex2html648"
  HREF="node21.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html636"
+<A NAME="tex2html642"
  HREF="node33.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html644"
+<A NAME="tex2html650"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html647"
+<B> Next:</B> <A NAME="tex2html653"
  HREF="node35.html">tril   Return</A>
-<B> Up:</B> <A NAME="tex2html643"
+<B> Up:</B> <A NAME="tex2html649"
  HREF="node21.html">Sparse Matrix class</A>
-<B> Previous:</B> <A NAME="tex2html637"
+<B> Previous:</B> <A NAME="tex2html643"
  HREF="node33.html">get_diag   Get</A>
- &nbsp; <B>  <A NAME="tex2html645"
+ &nbsp; <B>  <A NAME="tex2html651"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html658"
+<A NAME="tex2html664"
  HREF="node36.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html654"
+<A NAME="tex2html660"
  HREF="node21.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html648"
+<A NAME="tex2html654"
  HREF="node34.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html656"
+<A NAME="tex2html662"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html659"
+<B> Next:</B> <A NAME="tex2html665"
  HREF="node36.html">triu   Return</A>
-<B> Up:</B> <A NAME="tex2html655"
+<B> Up:</B> <A NAME="tex2html661"
  HREF="node21.html">Sparse Matrix class</A>
-<B> Previous:</B> <A NAME="tex2html649"
+<B> Previous:</B> <A NAME="tex2html655"
  HREF="node34.html">clip_diag   Cut</A>
- &nbsp; <B>  <A NAME="tex2html657"
+ &nbsp; <B>  <A NAME="tex2html663"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html670"
+<A NAME="tex2html676"
  HREF="node37.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html666"
+<A NAME="tex2html672"
  HREF="node21.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html660"
+<A NAME="tex2html666"
  HREF="node35.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html668"
+<A NAME="tex2html674"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html671"
+<B> Next:</B> <A NAME="tex2html677"
  HREF="node37.html">psb_set_mat_default   Set</A>
-<B> Up:</B> <A NAME="tex2html667"
+<B> Up:</B> <A NAME="tex2html673"
  HREF="node21.html">Sparse Matrix class</A>
-<B> Previous:</B> <A NAME="tex2html661"
+<B> Previous:</B> <A NAME="tex2html667"
  HREF="node35.html">tril   Return</A>
- &nbsp; <B>  <A NAME="tex2html669"
+ &nbsp; <B>  <A NAME="tex2html675"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html682"
+<A NAME="tex2html688"
  HREF="node38.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html678"
+<A NAME="tex2html684"
  HREF="node21.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html672"
+<A NAME="tex2html678"
  HREF="node36.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html680"
+<A NAME="tex2html686"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html683"
+<B> Next:</B> <A NAME="tex2html689"
  HREF="node38.html">clone   Clone</A>
-<B> Up:</B> <A NAME="tex2html679"
+<B> Up:</B> <A NAME="tex2html685"
  HREF="node21.html">Sparse Matrix class</A>
-<B> Previous:</B> <A NAME="tex2html673"
+<B> Previous:</B> <A NAME="tex2html679"
  HREF="node36.html">triu   Return</A>
- &nbsp; <B>  <A NAME="tex2html681"
+ &nbsp; <B>  <A NAME="tex2html687"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html694"
+<A NAME="tex2html700"
  HREF="node39.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html690"
+<A NAME="tex2html696"
  HREF="node21.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html684"
+<A NAME="tex2html690"
  HREF="node37.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html692"
+<A NAME="tex2html698"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html695"
+<B> Next:</B> <A NAME="tex2html701"
  HREF="node39.html">Named Constants</A>
-<B> Up:</B> <A NAME="tex2html691"
+<B> Up:</B> <A NAME="tex2html697"
  HREF="node21.html">Sparse Matrix class</A>
-<B> Previous:</B> <A NAME="tex2html685"
+<B> Previous:</B> <A NAME="tex2html691"
  HREF="node37.html">psb_set_mat_default   Set</A>
- &nbsp; <B>  <A NAME="tex2html693"
+ &nbsp; <B>  <A NAME="tex2html699"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -25,26 +25,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html704"
+<A NAME="tex2html710"
  HREF="node40.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html700"
+<A NAME="tex2html706"
  HREF="node21.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html696"
+<A NAME="tex2html702"
  HREF="node38.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html702"
+<A NAME="tex2html708"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html705"
+<B> Next:</B> <A NAME="tex2html711"
  HREF="node40.html">Dense Vector Data Structure</A>
-<B> Up:</B> <A NAME="tex2html701"
+<B> Up:</B> <A NAME="tex2html707"
  HREF="node21.html">Sparse Matrix class</A>
-<B> Previous:</B> <A NAME="tex2html697"
+<B> Previous:</B> <A NAME="tex2html703"
  HREF="node38.html">clone   Clone</A>
- &nbsp; <B>  <A NAME="tex2html703"
+ &nbsp; <B>  <A NAME="tex2html709"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html226"
+<A NAME="tex2html232"
  HREF="node5.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html222"
+<A NAME="tex2html228"
  HREF="node3.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html216"
+<A NAME="tex2html222"
  HREF="node3.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html224"
+<A NAME="tex2html230"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html227"
+<B> Next:</B> <A NAME="tex2html233"
  HREF="node5.html">Library contents</A>
-<B> Up:</B> <A NAME="tex2html223"
+<B> Up:</B> <A NAME="tex2html229"
  HREF="node3.html">General overview</A>
-<B> Previous:</B> <A NAME="tex2html217"
+<B> Previous:</B> <A NAME="tex2html223"
  HREF="node3.html">General overview</A>
- &nbsp; <B>  <A NAME="tex2html225"
+ &nbsp; <B>  <A NAME="tex2html231"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -126,8 +126,8 @@ Overlap points do not usually exist in the basic data
 distributions; however they are a feature of Domain Decomposition
 Schwarz preconditioners which are the subject of related research
 work&nbsp;[<A
- HREF="node121.html#2007c">4</A>,<A
- HREF="node121.html#2007d">3</A>].
+ HREF="node127.html#2007c">4</A>,<A
+ HREF="node127.html#2007d">3</A>].

 <P>
 We denote the sets of  internal, boundary and halo points for a given
@@ -197,26 +197,26 @@ points in the literature.
 <P>
 <HR>
 <!--Navigation Panel-->
-<A NAME="tex2html226"
+<A NAME="tex2html232"
  HREF="node5.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html222"
+<A NAME="tex2html228"
  HREF="node3.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html216"
+<A NAME="tex2html222"
  HREF="node3.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html224"
+<A NAME="tex2html230"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html227"
+<B> Next:</B> <A NAME="tex2html233"
  HREF="node5.html">Library contents</A>
-<B> Up:</B> <A NAME="tex2html223"
+<B> Up:</B> <A NAME="tex2html229"
  HREF="node3.html">General overview</A>
-<B> Previous:</B> <A NAME="tex2html217"
+<B> Previous:</B> <A NAME="tex2html223"
  HREF="node3.html">General overview</A>
- &nbsp; <B>  <A NAME="tex2html225"
+ &nbsp; <B>  <A NAME="tex2html231"
  HREF="node1.html">Contents</A></B> 
 <!--End of Navigation Panel-->

@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html716"
+<A NAME="tex2html722"
  HREF="node41.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html712"
+<A NAME="tex2html718"
  HREF="node9.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html706"
+<A NAME="tex2html712"
  HREF="node39.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html714"
+<A NAME="tex2html720"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html717"
+<B> Next:</B> <A NAME="tex2html723"
  HREF="node41.html">Vector Methods</A>
-<B> Up:</B> <A NAME="tex2html713"
+<B> Up:</B> <A NAME="tex2html719"
  HREF="node9.html">Data Structures and Classes</A>
-<B> Previous:</B> <A NAME="tex2html707"
+<B> Previous:</B> <A NAME="tex2html713"
  HREF="node39.html">Named Constants</A>
- &nbsp; <B>  <A NAME="tex2html715"
+ &nbsp; <B>  <A NAME="tex2html721"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -122,41 +122,41 @@ private memory.
 <A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>

 <UL>
-<LI><A NAME="tex2html718"
+<LI><A NAME="tex2html724"
  HREF="node41.html">Vector Methods</A>
-<LI><A NAME="tex2html719"
+<LI><A NAME="tex2html725"
  HREF="node42.html">get_nrows -- Get number of  rows in a dense vector</A>
-<LI><A NAME="tex2html720"
+<LI><A NAME="tex2html726"
  HREF="node43.html">sizeof  -- Get memory occupation in bytes
 of  a dense vector</A>
-<LI><A NAME="tex2html721"
+<LI><A NAME="tex2html727"
  HREF="node44.html">get_vect  -- Get a copy of the vector contents</A>
-<LI><A NAME="tex2html722"
+<LI><A NAME="tex2html728"
  HREF="node45.html">clone -- Clone current object</A>
 </UL>
 <!--End of Table of Child-Links-->
 <HR>
 <!--Navigation Panel-->
-<A NAME="tex2html716"
+<A NAME="tex2html722"
  HREF="node41.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html712"
+<A NAME="tex2html718"
  HREF="node9.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html706"
+<A NAME="tex2html712"
  HREF="node39.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html714"
+<A NAME="tex2html720"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html717"
+<B> Next:</B> <A NAME="tex2html723"
  HREF="node41.html">Vector Methods</A>
-<B> Up:</B> <A NAME="tex2html713"
+<B> Up:</B> <A NAME="tex2html719"
  HREF="node9.html">Data Structures and Classes</A>
-<B> Previous:</B> <A NAME="tex2html707"
+<B> Previous:</B> <A NAME="tex2html713"
  HREF="node39.html">Named Constants</A>
- &nbsp; <B>  <A NAME="tex2html715"
+ &nbsp; <B>  <A NAME="tex2html721"
  HREF="node1.html">Contents</A></B> 
 <!--End of Navigation Panel-->

@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html733"
+<A NAME="tex2html739"
  HREF="node42.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html729"
+<A NAME="tex2html735"
  HREF="node40.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html723"
+<A NAME="tex2html729"
  HREF="node40.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html731"
+<A NAME="tex2html737"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html734"
+<B> Next:</B> <A NAME="tex2html740"
  HREF="node42.html">get_nrows   Get</A>
-<B> Up:</B> <A NAME="tex2html730"
+<B> Up:</B> <A NAME="tex2html736"
  HREF="node40.html">Dense Vector Data Structure</A>
-<B> Previous:</B> <A NAME="tex2html724"
+<B> Previous:</B> <A NAME="tex2html730"
  HREF="node40.html">Dense Vector Data Structure</A>
- &nbsp; <B>  <A NAME="tex2html732"
+ &nbsp; <B>  <A NAME="tex2html738"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html745"
+<A NAME="tex2html751"
  HREF="node43.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html741"
+<A NAME="tex2html747"
  HREF="node40.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html735"
+<A NAME="tex2html741"
  HREF="node41.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html743"
+<A NAME="tex2html749"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html746"
+<B> Next:</B> <A NAME="tex2html752"
  HREF="node43.html">sizeof   Get</A>
-<B> Up:</B> <A NAME="tex2html742"
+<B> Up:</B> <A NAME="tex2html748"
  HREF="node40.html">Dense Vector Data Structure</A>
-<B> Previous:</B> <A NAME="tex2html736"
+<B> Previous:</B> <A NAME="tex2html742"
  HREF="node41.html">Vector Methods</A>
- &nbsp; <B>  <A NAME="tex2html744"
+ &nbsp; <B>  <A NAME="tex2html750"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -28,26 +28,26 @@ of a dense vector">

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html757"
+<A NAME="tex2html763"
  HREF="node44.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html753"
+<A NAME="tex2html759"
  HREF="node40.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html747"
+<A NAME="tex2html753"
  HREF="node42.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html755"
+<A NAME="tex2html761"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html758"
+<B> Next:</B> <A NAME="tex2html764"
  HREF="node44.html">get_vect   Get</A>
-<B> Up:</B> <A NAME="tex2html754"
+<B> Up:</B> <A NAME="tex2html760"
  HREF="node40.html">Dense Vector Data Structure</A>
-<B> Previous:</B> <A NAME="tex2html748"
+<B> Previous:</B> <A NAME="tex2html754"
  HREF="node42.html">get_nrows   Get</A>
- &nbsp; <B>  <A NAME="tex2html756"
+ &nbsp; <B>  <A NAME="tex2html762"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html769"
+<A NAME="tex2html775"
  HREF="node45.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html765"
+<A NAME="tex2html771"
  HREF="node40.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html759"
+<A NAME="tex2html765"
  HREF="node43.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html767"
+<A NAME="tex2html773"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html770"
+<B> Next:</B> <A NAME="tex2html776"
  HREF="node45.html">clone   Clone</A>
-<B> Up:</B> <A NAME="tex2html766"
+<B> Up:</B> <A NAME="tex2html772"
  HREF="node40.html">Dense Vector Data Structure</A>
-<B> Previous:</B> <A NAME="tex2html760"
+<B> Previous:</B> <A NAME="tex2html766"
  HREF="node43.html">sizeof   Get</A>
- &nbsp; <B>  <A NAME="tex2html768"
+ &nbsp; <B>  <A NAME="tex2html774"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -25,26 +25,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html779"
+<A NAME="tex2html785"
  HREF="node46.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html775"
+<A NAME="tex2html781"
  HREF="node40.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html771"
+<A NAME="tex2html777"
  HREF="node44.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html777"
+<A NAME="tex2html783"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html780"
+<B> Next:</B> <A NAME="tex2html786"
  HREF="node46.html">Preconditioner data structure</A>
-<B> Up:</B> <A NAME="tex2html776"
+<B> Up:</B> <A NAME="tex2html782"
  HREF="node40.html">Dense Vector Data Structure</A>
-<B> Previous:</B> <A NAME="tex2html772"
+<B> Previous:</B> <A NAME="tex2html778"
  HREF="node44.html">get_vect   Get</A>
- &nbsp; <B>  <A NAME="tex2html778"
+ &nbsp; <B>  <A NAME="tex2html784"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -25,26 +25,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html789"
+<A NAME="tex2html795"
  HREF="node47.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html785"
+<A NAME="tex2html791"
  HREF="node9.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html781"
+<A NAME="tex2html787"
  HREF="node45.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html787"
+<A NAME="tex2html793"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html790"
+<B> Next:</B> <A NAME="tex2html796"
  HREF="node47.html">Computational routines</A>
-<B> Up:</B> <A NAME="tex2html786"
+<B> Up:</B> <A NAME="tex2html792"
  HREF="node9.html">Data Structures and Classes</A>
-<B> Previous:</B> <A NAME="tex2html782"
+<B> Previous:</B> <A NAME="tex2html788"
  HREF="node45.html">clone   Clone</A>
- &nbsp; <B>  <A NAME="tex2html788"
+ &nbsp; <B>  <A NAME="tex2html794"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html801"
+<A NAME="tex2html807"
  HREF="node48.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html797"
+<A NAME="tex2html803"
  HREF="userhtml.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html791"
+<A NAME="tex2html797"
  HREF="node46.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html799"
+<A NAME="tex2html805"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html802"
+<B> Next:</B> <A NAME="tex2html808"
  HREF="node48.html">psb_geaxpby   General</A>
-<B> Up:</B> <A NAME="tex2html798"
+<B> Up:</B> <A NAME="tex2html804"
  HREF="userhtml.html">userhtml</A>
-<B> Previous:</B> <A NAME="tex2html792"
+<B> Previous:</B> <A NAME="tex2html798"
  HREF="node46.html">Preconditioner data structure</A>
- &nbsp; <B>  <A NAME="tex2html800"
+ &nbsp; <B>  <A NAME="tex2html806"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -61,32 +61,32 @@ Computational routines</A>
 <A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>

 <UL>
-<LI><A NAME="tex2html803"
-  HREF="node48.html">psb_geaxpby -- General Dense Matrix Sum</A>
-<LI><A NAME="tex2html804"
-  HREF="node49.html">psb_gedot -- Dot Product</A>
-<LI><A NAME="tex2html805"
-  HREF="node50.html">psb_gedots -- Generalized Dot Product</A>
-<LI><A NAME="tex2html806"
-  HREF="node51.html">psb_geamax -- Infinity-Norm of Vector</A>
-<LI><A NAME="tex2html807"
-  HREF="node52.html">psb_geamaxs -- Generalized Infinity Norm</A>
-<LI><A NAME="tex2html808"
-  HREF="node53.html">psb_geasum -- 1-Norm of Vector</A>
 <LI><A NAME="tex2html809"
-  HREF="node54.html">psb_geasums -- Generalized 1-Norm of Vector</A>
+  HREF="node48.html">psb_geaxpby -- General Dense Matrix Sum</A>
 <LI><A NAME="tex2html810"
-  HREF="node55.html">psb_genrm2 -- 2-Norm of Vector</A>
+  HREF="node49.html">psb_gedot -- Dot Product</A>
 <LI><A NAME="tex2html811"
-  HREF="node56.html">psb_genrm2s -- Generalized 2-Norm of Vector</A>
+  HREF="node50.html">psb_gedots -- Generalized Dot Product</A>
 <LI><A NAME="tex2html812"
-  HREF="node57.html">psb_spnrm1 -- 1-Norm of Sparse Matrix</A>
+  HREF="node51.html">psb_geamax -- Infinity-Norm of Vector</A>
 <LI><A NAME="tex2html813"
-  HREF="node58.html">psb_spnrmi -- Infinity Norm of Sparse Matrix</A>
+  HREF="node52.html">psb_geamaxs -- Generalized Infinity Norm</A>
 <LI><A NAME="tex2html814"
+  HREF="node53.html">psb_geasum -- 1-Norm of Vector</A>
+<LI><A NAME="tex2html815"
+  HREF="node54.html">psb_geasums -- Generalized 1-Norm of Vector</A>
+<LI><A NAME="tex2html816"
+  HREF="node55.html">psb_genrm2 -- 2-Norm of Vector</A>
+<LI><A NAME="tex2html817"
+  HREF="node56.html">psb_genrm2s -- Generalized 2-Norm of Vector</A>
+<LI><A NAME="tex2html818"
+  HREF="node57.html">psb_spnrm1 -- 1-Norm of Sparse Matrix</A>
+<LI><A NAME="tex2html819"
+  HREF="node58.html">psb_spnrmi -- Infinity Norm of Sparse Matrix</A>
+<LI><A NAME="tex2html820"
  HREF="node59.html">psb_spmm -- Sparse Matrix by Dense Matrix
  Product</A>
-<LI><A NAME="tex2html815"
+<LI><A NAME="tex2html821"
  HREF="node60.html">psb_spsm -- Triangular System Solve</A>
 </UL>
 <!--End of Table of Child-Links-->
@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html826"
+<A NAME="tex2html832"
  HREF="node49.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html822"
+<A NAME="tex2html828"
  HREF="node47.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html816"
+<A NAME="tex2html822"
  HREF="node47.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html824"
+<A NAME="tex2html830"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html827"
+<B> Next:</B> <A NAME="tex2html833"
  HREF="node49.html">psb_gedot   Dot</A>
-<B> Up:</B> <A NAME="tex2html823"
+<B> Up:</B> <A NAME="tex2html829"
  HREF="node47.html">Computational routines</A>
-<B> Previous:</B> <A NAME="tex2html817"
+<B> Previous:</B> <A NAME="tex2html823"
  HREF="node47.html">Computational routines</A>
- &nbsp; <B>  <A NAME="tex2html825"
+ &nbsp; <B>  <A NAME="tex2html831"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -254,26 +254,26 @@ An integer value; 0 means no error has been detected.
 <P>
 <HR>
 <!--Navigation Panel-->
-<A NAME="tex2html826"
+<A NAME="tex2html832"
  HREF="node49.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html822"
+<A NAME="tex2html828"
  HREF="node47.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html816"
+<A NAME="tex2html822"
  HREF="node47.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html824"
+<A NAME="tex2html830"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html827"
+<B> Next:</B> <A NAME="tex2html833"
  HREF="node49.html">psb_gedot   Dot</A>
-<B> Up:</B> <A NAME="tex2html823"
+<B> Up:</B> <A NAME="tex2html829"
  HREF="node47.html">Computational routines</A>
-<B> Previous:</B> <A NAME="tex2html817"
+<B> Previous:</B> <A NAME="tex2html823"
  HREF="node47.html">Computational routines</A>
- &nbsp; <B>  <A NAME="tex2html825"
+ &nbsp; <B>  <A NAME="tex2html831"
  HREF="node1.html">Contents</A></B> 
 <!--End of Navigation Panel-->

@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html838"
+<A NAME="tex2html844"
  HREF="node50.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html834"
+<A NAME="tex2html840"
  HREF="node47.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html828"
+<A NAME="tex2html834"
  HREF="node48.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html836"
+<A NAME="tex2html842"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html839"
+<B> Next:</B> <A NAME="tex2html845"
  HREF="node50.html">psb_gedots   Generalized</A>
-<B> Up:</B> <A NAME="tex2html835"
+<B> Up:</B> <A NAME="tex2html841"
  HREF="node47.html">Computational routines</A>
-<B> Previous:</B> <A NAME="tex2html829"
+<B> Previous:</B> <A NAME="tex2html835"
  HREF="node48.html">psb_geaxpby   General</A>
- &nbsp; <B>  <A NAME="tex2html837"
+ &nbsp; <B>  <A NAME="tex2html843"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -253,26 +253,26 @@ An integer value; 0 means no error has been detected.
 <P>
 <HR>
 <!--Navigation Panel-->
-<A NAME="tex2html838"
+<A NAME="tex2html844"
  HREF="node50.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html834"
+<A NAME="tex2html840"
  HREF="node47.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html828"
+<A NAME="tex2html834"
  HREF="node48.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html836"
+<A NAME="tex2html842"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html839"
+<B> Next:</B> <A NAME="tex2html845"
  HREF="node50.html">psb_gedots   Generalized</A>
-<B> Up:</B> <A NAME="tex2html835"
+<B> Up:</B> <A NAME="tex2html841"
  HREF="node47.html">Computational routines</A>
-<B> Previous:</B> <A NAME="tex2html829"
+<B> Previous:</B> <A NAME="tex2html835"
  HREF="node48.html">psb_geaxpby   General</A>
- &nbsp; <B>  <A NAME="tex2html837"
+ &nbsp; <B>  <A NAME="tex2html843"
  HREF="node1.html">Contents</A></B> 
 <!--End of Navigation Panel-->

@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html238"
+<A NAME="tex2html244"
  HREF="node6.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html234"
+<A NAME="tex2html240"
  HREF="node3.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html228"
+<A NAME="tex2html234"
  HREF="node4.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html236"
+<A NAME="tex2html242"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html239"
+<B> Next:</B> <A NAME="tex2html245"
  HREF="node6.html">Application structure</A>
-<B> Up:</B> <A NAME="tex2html235"
+<B> Up:</B> <A NAME="tex2html241"
  HREF="node3.html">General overview</A>
-<B> Previous:</B> <A NAME="tex2html229"
+<B> Previous:</B> <A NAME="tex2html235"
  HREF="node4.html">Basic Nomenclature</A>
- &nbsp; <B>  <A NAME="tex2html237"
+ &nbsp; <B>  <A NAME="tex2html243"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -169,26 +169,26 @@ whose current value is <code>3.0.0</code>
 <P>
 <HR>
 <!--Navigation Panel-->
-<A NAME="tex2html238"
+<A NAME="tex2html244"
  HREF="node6.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html234"
+<A NAME="tex2html240"
  HREF="node3.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html228"
+<A NAME="tex2html234"
  HREF="node4.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html236"
+<A NAME="tex2html242"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html239"
+<B> Next:</B> <A NAME="tex2html245"
  HREF="node6.html">Application structure</A>
-<B> Up:</B> <A NAME="tex2html235"
+<B> Up:</B> <A NAME="tex2html241"
  HREF="node3.html">General overview</A>
-<B> Previous:</B> <A NAME="tex2html229"
+<B> Previous:</B> <A NAME="tex2html235"
  HREF="node4.html">Basic Nomenclature</A>
- &nbsp; <B>  <A NAME="tex2html237"
+ &nbsp; <B>  <A NAME="tex2html243"
  HREF="node1.html">Contents</A></B> 
 <!--End of Navigation Panel-->

@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html850"
+<A NAME="tex2html856"
  HREF="node51.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html846"
+<A NAME="tex2html852"
  HREF="node47.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html840"
+<A NAME="tex2html846"
  HREF="node49.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html848"
+<A NAME="tex2html854"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html851"
+<B> Next:</B> <A NAME="tex2html857"
  HREF="node51.html">psb_geamax   Infinity-Norm</A>
-<B> Up:</B> <A NAME="tex2html847"
+<B> Up:</B> <A NAME="tex2html853"
  HREF="node47.html">Computational routines</A>
-<B> Previous:</B> <A NAME="tex2html841"
+<B> Previous:</B> <A NAME="tex2html847"
  HREF="node49.html">psb_gedot   Dot</A>
- &nbsp; <B>  <A NAME="tex2html849"
+ &nbsp; <B>  <A NAME="tex2html855"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -239,26 +239,26 @@ An integer value; 0 means no error has been detected.
 <P>
 <HR>
 <!--Navigation Panel-->
-<A NAME="tex2html850"
+<A NAME="tex2html856"
  HREF="node51.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html846"
+<A NAME="tex2html852"
  HREF="node47.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html840"
+<A NAME="tex2html846"
  HREF="node49.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html848"
+<A NAME="tex2html854"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html851"
+<B> Next:</B> <A NAME="tex2html857"
  HREF="node51.html">psb_geamax   Infinity-Norm</A>
-<B> Up:</B> <A NAME="tex2html847"
+<B> Up:</B> <A NAME="tex2html853"
  HREF="node47.html">Computational routines</A>
-<B> Previous:</B> <A NAME="tex2html841"
+<B> Previous:</B> <A NAME="tex2html847"
  HREF="node49.html">psb_gedot   Dot</A>
- &nbsp; <B>  <A NAME="tex2html849"
+ &nbsp; <B>  <A NAME="tex2html855"
  HREF="node1.html">Contents</A></B> 
 <!--End of Navigation Panel-->

@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html862"
+<A NAME="tex2html868"
  HREF="node52.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html858"
+<A NAME="tex2html864"
  HREF="node47.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html852"
+<A NAME="tex2html858"
  HREF="node50.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html860"
+<A NAME="tex2html866"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html863"
+<B> Next:</B> <A NAME="tex2html869"
  HREF="node52.html">psb_geamaxs   Generalized</A>
-<B> Up:</B> <A NAME="tex2html859"
+<B> Up:</B> <A NAME="tex2html865"
  HREF="node47.html">Computational routines</A>
-<B> Previous:</B> <A NAME="tex2html853"
+<B> Previous:</B> <A NAME="tex2html859"
  HREF="node50.html">psb_gedots   Generalized</A>
- &nbsp; <B>  <A NAME="tex2html861"
+ &nbsp; <B>  <A NAME="tex2html867"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -217,26 +217,26 @@ An integer value; 0 means no error has been detected.
 <P>
 <HR>
 <!--Navigation Panel-->
-<A NAME="tex2html862"
+<A NAME="tex2html868"
  HREF="node52.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html858"
+<A NAME="tex2html864"
  HREF="node47.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html852"
+<A NAME="tex2html858"
  HREF="node50.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html860"
+<A NAME="tex2html866"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html863"
+<B> Next:</B> <A NAME="tex2html869"
  HREF="node52.html">psb_geamaxs   Generalized</A>
-<B> Up:</B> <A NAME="tex2html859"
+<B> Up:</B> <A NAME="tex2html865"
  HREF="node47.html">Computational routines</A>
-<B> Previous:</B> <A NAME="tex2html853"
+<B> Previous:</B> <A NAME="tex2html859"
  HREF="node50.html">psb_gedots   Generalized</A>
- &nbsp; <B>  <A NAME="tex2html861"
+ &nbsp; <B>  <A NAME="tex2html867"
  HREF="node1.html">Contents</A></B> 
 <!--End of Navigation Panel-->

@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html874"
+<A NAME="tex2html880"
  HREF="node53.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html870"
+<A NAME="tex2html876"
  HREF="node47.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html864"
+<A NAME="tex2html870"
  HREF="node51.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html872"
+<A NAME="tex2html878"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html875"
+<B> Next:</B> <A NAME="tex2html881"
  HREF="node53.html">psb_geasum   1-Norm</A>
-<B> Up:</B> <A NAME="tex2html871"
+<B> Up:</B> <A NAME="tex2html877"
  HREF="node47.html">Computational routines</A>
-<B> Previous:</B> <A NAME="tex2html865"
+<B> Previous:</B> <A NAME="tex2html871"
  HREF="node51.html">psb_geamax   Infinity-Norm</A>
- &nbsp; <B>  <A NAME="tex2html873"
+ &nbsp; <B>  <A NAME="tex2html879"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -191,26 +191,26 @@ An integer value; 0 means no error has been detected.
 <P>
 <HR>
 <!--Navigation Panel-->
-<A NAME="tex2html874"
+<A NAME="tex2html880"
  HREF="node53.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html870"
+<A NAME="tex2html876"
  HREF="node47.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html864"
+<A NAME="tex2html870"
  HREF="node51.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html872"
+<A NAME="tex2html878"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html875"
+<B> Next:</B> <A NAME="tex2html881"
  HREF="node53.html">psb_geasum   1-Norm</A>
-<B> Up:</B> <A NAME="tex2html871"
+<B> Up:</B> <A NAME="tex2html877"
  HREF="node47.html">Computational routines</A>
-<B> Previous:</B> <A NAME="tex2html865"
+<B> Previous:</B> <A NAME="tex2html871"
  HREF="node51.html">psb_geamax   Infinity-Norm</A>
- &nbsp; <B>  <A NAME="tex2html873"
+ &nbsp; <B>  <A NAME="tex2html879"
  HREF="node1.html">Contents</A></B> 
 <!--End of Navigation Panel-->

@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html886"
+<A NAME="tex2html892"
  HREF="node54.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html882"
+<A NAME="tex2html888"
  HREF="node47.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html876"
+<A NAME="tex2html882"
  HREF="node52.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html884"
+<A NAME="tex2html890"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html887"
+<B> Next:</B> <A NAME="tex2html893"
  HREF="node54.html">psb_geasums   Generalized</A>
-<B> Up:</B> <A NAME="tex2html883"
+<B> Up:</B> <A NAME="tex2html889"
  HREF="node47.html">Computational routines</A>
-<B> Previous:</B> <A NAME="tex2html877"
+<B> Previous:</B> <A NAME="tex2html883"
  HREF="node52.html">psb_geamaxs   Generalized</A>
- &nbsp; <B>  <A NAME="tex2html885"
+ &nbsp; <B>  <A NAME="tex2html891"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -216,26 +216,26 @@ An integer value; 0 means no error has been detected.
 <P>
 <HR>
 <!--Navigation Panel-->
-<A NAME="tex2html886"
+<A NAME="tex2html892"
  HREF="node54.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html882"
+<A NAME="tex2html888"
  HREF="node47.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html876"
+<A NAME="tex2html882"
  HREF="node52.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html884"
+<A NAME="tex2html890"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html887"
+<B> Next:</B> <A NAME="tex2html893"
  HREF="node54.html">psb_geasums   Generalized</A>
-<B> Up:</B> <A NAME="tex2html883"
+<B> Up:</B> <A NAME="tex2html889"
  HREF="node47.html">Computational routines</A>
-<B> Previous:</B> <A NAME="tex2html877"
+<B> Previous:</B> <A NAME="tex2html883"
  HREF="node52.html">psb_geamaxs   Generalized</A>
- &nbsp; <B>  <A NAME="tex2html885"
+ &nbsp; <B>  <A NAME="tex2html891"
  HREF="node1.html">Contents</A></B> 
 <!--End of Navigation Panel-->

@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html898"
+<A NAME="tex2html904"
  HREF="node55.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html894"
+<A NAME="tex2html900"
  HREF="node47.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html888"
+<A NAME="tex2html894"
  HREF="node53.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html896"
+<A NAME="tex2html902"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html899"
+<B> Next:</B> <A NAME="tex2html905"
  HREF="node55.html">psb_genrm2   2-Norm</A>
-<B> Up:</B> <A NAME="tex2html895"
+<B> Up:</B> <A NAME="tex2html901"
  HREF="node47.html">Computational routines</A>
-<B> Previous:</B> <A NAME="tex2html889"
+<B> Previous:</B> <A NAME="tex2html895"
  HREF="node53.html">psb_geasum   1-Norm</A>
- &nbsp; <B>  <A NAME="tex2html897"
+ &nbsp; <B>  <A NAME="tex2html903"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -239,26 +239,26 @@ An integer value; 0 means no error has been detected.
 <P>
 <HR>
 <!--Navigation Panel-->
-<A NAME="tex2html898"
+<A NAME="tex2html904"
  HREF="node55.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html894"
+<A NAME="tex2html900"
  HREF="node47.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html888"
+<A NAME="tex2html894"
  HREF="node53.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html896"
+<A NAME="tex2html902"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html899"
+<B> Next:</B> <A NAME="tex2html905"
  HREF="node55.html">psb_genrm2   2-Norm</A>
-<B> Up:</B> <A NAME="tex2html895"
+<B> Up:</B> <A NAME="tex2html901"
  HREF="node47.html">Computational routines</A>
-<B> Previous:</B> <A NAME="tex2html889"
+<B> Previous:</B> <A NAME="tex2html895"
  HREF="node53.html">psb_geasum   1-Norm</A>
- &nbsp; <B>  <A NAME="tex2html897"
+ &nbsp; <B>  <A NAME="tex2html903"
  HREF="node1.html">Contents</A></B> 
 <!--End of Navigation Panel-->

@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html910"
+<A NAME="tex2html916"
  HREF="node56.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html906"
+<A NAME="tex2html912"
  HREF="node47.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html900"
+<A NAME="tex2html906"
  HREF="node54.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html908"
+<A NAME="tex2html914"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html911"
+<B> Next:</B> <A NAME="tex2html917"
  HREF="node56.html">psb_genrm2s   Generalized</A>
-<B> Up:</B> <A NAME="tex2html907"
+<B> Up:</B> <A NAME="tex2html913"
  HREF="node47.html">Computational routines</A>
-<B> Previous:</B> <A NAME="tex2html901"
+<B> Previous:</B> <A NAME="tex2html907"
  HREF="node54.html">psb_geasums   Generalized</A>
- &nbsp; <B>  <A NAME="tex2html909"
+ &nbsp; <B>  <A NAME="tex2html915"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -217,26 +217,26 @@ An integer value; 0 means no error has been detected.
 <P>
 <HR>
 <!--Navigation Panel-->
-<A NAME="tex2html910"
+<A NAME="tex2html916"
  HREF="node56.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html906"
+<A NAME="tex2html912"
  HREF="node47.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html900"
+<A NAME="tex2html906"
  HREF="node54.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html908"
+<A NAME="tex2html914"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html911"
+<B> Next:</B> <A NAME="tex2html917"
  HREF="node56.html">psb_genrm2s   Generalized</A>
-<B> Up:</B> <A NAME="tex2html907"
+<B> Up:</B> <A NAME="tex2html913"
  HREF="node47.html">Computational routines</A>
-<B> Previous:</B> <A NAME="tex2html901"
+<B> Previous:</B> <A NAME="tex2html907"
  HREF="node54.html">psb_geasums   Generalized</A>
- &nbsp; <B>  <A NAME="tex2html909"
+ &nbsp; <B>  <A NAME="tex2html915"
  HREF="node1.html">Contents</A></B> 
 <!--End of Navigation Panel-->

@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html922"
+<A NAME="tex2html928"
  HREF="node57.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html918"
+<A NAME="tex2html924"
  HREF="node47.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html912"
+<A NAME="tex2html918"
  HREF="node55.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html920"
+<A NAME="tex2html926"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html923"
+<B> Next:</B> <A NAME="tex2html929"
  HREF="node57.html">psb_spnrm1   1-Norm</A>
-<B> Up:</B> <A NAME="tex2html919"
+<B> Up:</B> <A NAME="tex2html925"
  HREF="node47.html">Computational routines</A>
-<B> Previous:</B> <A NAME="tex2html913"
+<B> Previous:</B> <A NAME="tex2html919"
  HREF="node55.html">psb_genrm2   2-Norm</A>
- &nbsp; <B>  <A NAME="tex2html921"
+ &nbsp; <B>  <A NAME="tex2html927"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -194,26 +194,26 @@ An integer value; 0 means no error has been detected.
 <P>
 <HR>
 <!--Navigation Panel-->
-<A NAME="tex2html922"
+<A NAME="tex2html928"
  HREF="node57.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html918"
+<A NAME="tex2html924"
  HREF="node47.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html912"
+<A NAME="tex2html918"
  HREF="node55.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html920"
+<A NAME="tex2html926"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html923"
+<B> Next:</B> <A NAME="tex2html929"
  HREF="node57.html">psb_spnrm1   1-Norm</A>
-<B> Up:</B> <A NAME="tex2html919"
+<B> Up:</B> <A NAME="tex2html925"
  HREF="node47.html">Computational routines</A>
-<B> Previous:</B> <A NAME="tex2html913"
+<B> Previous:</B> <A NAME="tex2html919"
  HREF="node55.html">psb_genrm2   2-Norm</A>
- &nbsp; <B>  <A NAME="tex2html921"
+ &nbsp; <B>  <A NAME="tex2html927"
  HREF="node1.html">Contents</A></B> 
 <!--End of Navigation Panel-->

@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html934"
+<A NAME="tex2html940"
  HREF="node58.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html930"
+<A NAME="tex2html936"
  HREF="node47.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html924"
+<A NAME="tex2html930"
  HREF="node56.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html932"
+<A NAME="tex2html938"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html935"
+<B> Next:</B> <A NAME="tex2html941"
  HREF="node58.html">psb_spnrmi   Infinity</A>
-<B> Up:</B> <A NAME="tex2html931"
+<B> Up:</B> <A NAME="tex2html937"
  HREF="node47.html">Computational routines</A>
-<B> Previous:</B> <A NAME="tex2html925"
+<B> Previous:</B> <A NAME="tex2html931"
  HREF="node56.html">psb_genrm2s   Generalized</A>
- &nbsp; <B>  <A NAME="tex2html933"
+ &nbsp; <B>  <A NAME="tex2html939"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -192,26 +192,26 @@ An integer value; 0 means no error has been detected.
 <P>
 <HR>
 <!--Navigation Panel-->
-<A NAME="tex2html934"
+<A NAME="tex2html940"
  HREF="node58.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html930"
+<A NAME="tex2html936"
  HREF="node47.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html924"
+<A NAME="tex2html930"
  HREF="node56.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html932"
+<A NAME="tex2html938"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html935"
+<B> Next:</B> <A NAME="tex2html941"
  HREF="node58.html">psb_spnrmi   Infinity</A>
-<B> Up:</B> <A NAME="tex2html931"
+<B> Up:</B> <A NAME="tex2html937"
  HREF="node47.html">Computational routines</A>
-<B> Previous:</B> <A NAME="tex2html925"
+<B> Previous:</B> <A NAME="tex2html931"
  HREF="node56.html">psb_genrm2s   Generalized</A>
- &nbsp; <B>  <A NAME="tex2html933"
+ &nbsp; <B>  <A NAME="tex2html939"
  HREF="node1.html">Contents</A></B> 
 <!--End of Navigation Panel-->

@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html946"
+<A NAME="tex2html952"
  HREF="node59.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html942"
+<A NAME="tex2html948"
  HREF="node47.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html936"
+<A NAME="tex2html942"
  HREF="node57.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html944"
+<A NAME="tex2html950"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html947"
+<B> Next:</B> <A NAME="tex2html953"
  HREF="node59.html">psb_spmm   Sparse</A>
-<B> Up:</B> <A NAME="tex2html943"
+<B> Up:</B> <A NAME="tex2html949"
  HREF="node47.html">Computational routines</A>
-<B> Previous:</B> <A NAME="tex2html937"
+<B> Previous:</B> <A NAME="tex2html943"
  HREF="node57.html">psb_spnrm1   1-Norm</A>
- &nbsp; <B>  <A NAME="tex2html945"
+ &nbsp; <B>  <A NAME="tex2html951"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -192,26 +192,26 @@ An integer value; 0 means no error has been detected.
 <P>
 <HR>
 <!--Navigation Panel-->
-<A NAME="tex2html946"
+<A NAME="tex2html952"
  HREF="node59.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html942"
+<A NAME="tex2html948"
  HREF="node47.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html936"
+<A NAME="tex2html942"
  HREF="node57.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html944"
+<A NAME="tex2html950"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html947"
+<B> Next:</B> <A NAME="tex2html953"
  HREF="node59.html">psb_spmm   Sparse</A>
-<B> Up:</B> <A NAME="tex2html943"
+<B> Up:</B> <A NAME="tex2html949"
  HREF="node47.html">Computational routines</A>
-<B> Previous:</B> <A NAME="tex2html937"
+<B> Previous:</B> <A NAME="tex2html943"
  HREF="node57.html">psb_spnrm1   1-Norm</A>
- &nbsp; <B>  <A NAME="tex2html945"
+ &nbsp; <B>  <A NAME="tex2html951"
  HREF="node1.html">Contents</A></B> 
 <!--End of Navigation Panel-->

@@ -26,26 +26,26 @@ original version by:  Nikos Drakos, CBLU, University of Leeds

 <BODY >
 <!--Navigation Panel-->
-<A NAME="tex2html958"
+<A NAME="tex2html964"
  HREF="node60.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html954"
+<A NAME="tex2html960"
  HREF="node47.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html948"
+<A NAME="tex2html954"
  HREF="node58.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html956"
+<A NAME="tex2html962"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html959"
+<B> Next:</B> <A NAME="tex2html965"
  HREF="node60.html">psb_spsm   Triangular</A>
-<B> Up:</B> <A NAME="tex2html955"
+<B> Up:</B> <A NAME="tex2html961"
  HREF="node47.html">Computational routines</A>
-<B> Previous:</B> <A NAME="tex2html949"
+<B> Previous:</B> <A NAME="tex2html955"
  HREF="node58.html">psb_spnrmi   Infinity</A>
- &nbsp; <B>  <A NAME="tex2html957"
+ &nbsp; <B>  <A NAME="tex2html963"
  HREF="node1.html">Contents</A></B> 
 <BR>
 <BR>
@@ -399,26 +399,26 @@ An integer value; 0 means no error has been detected.
 <P>
 <HR>
 <!--Navigation Panel-->
-<A NAME="tex2html958"
+<A NAME="tex2html964"
  HREF="node60.html">
 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
-<A NAME="tex2html954"
+<A NAME="tex2html960"
  HREF="node47.html">
 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
-<A NAME="tex2html948"
+<A NAME="tex2html954"
  HREF="node58.html">
 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
-<A NAME="tex2html956"
+<A NAME="tex2html962"
  HREF="node1.html">
 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 <BR>
-<B> Next:</B> <A NAME="tex2html959"
+<B> Next:</B> <A NAME="tex2html965"
  HREF="node60.html">psb_spsm   Triangular</A>
-<B> Up:</B> <A NAME="tex2html955"
+<B> Up:</B> <A NAME="tex2html961"
  HREF="node47.html">Computational routines</A>
-<B> Previous:</B> <A NAME="tex2html949"
+<B> Previous:</B> <A NAME="tex2html955"
  HREF="node58.html">psb_spnrmi   Infinity</A>
- &nbsp; <B>  <A NAME="tex2html957"
+ &nbsp; <B>  <A NAME="tex2html963"
  HREF="node1.html">Contents</A></B> 
 <!--End of Navigation Panel-->

--- a/Show More
+++ b/Show More