diff --git a/docs/html/cmsy10-42.png b/docs/html/cmsy10-42.png index bd31f1f8..6a82d3d1 100644 Binary files a/docs/html/cmsy10-42.png and b/docs/html/cmsy10-42.png differ diff --git a/docs/html/cmsy10-48.png b/docs/html/cmsy10-48.png index df31f928..f37fc27d 100644 Binary files a/docs/html/cmsy10-48.png and b/docs/html/cmsy10-48.png differ diff --git a/docs/html/cmsy10-49.png b/docs/html/cmsy10-49.png index cb292c09..80f90637 100644 Binary files a/docs/html/cmsy10-49.png and b/docs/html/cmsy10-49.png differ diff --git a/docs/html/index.html b/docs/html/index.html index 0cca7b4c..b92e1f8d 100644 --- a/docs/html/index.html +++ b/docs/html/index.html @@ -10,7 +10,7 @@ -

PSBLAS
User’s and Reference Guide
-

PSBLAS
User’s and Reference Guide
-

diff --git a/docs/html/userhtmlse3.html b/docs/html/userhtmlse3.html index d6b907b1..75c521ee 100644 --- a/docs/html/userhtmlse3.html +++ b/docs/html/userhtmlse3.html @@ -22,11 +22,11 @@ href="userhtml.html#userhtmlsu7.html" >up]

interfaces. They include data structures for sparse matrices, communication descriptors and preconditioners.

All the data types and the basic subroutine interfaces related to descriptors and -sparse matrices are defined in the module psb_base_mod; this will have to be +sparse matrices are defined in the module psb_base_mod; this will have to be included by every user subroutine that makes use of the library. The preconditioners -are defined in the module psb_prec_mod +are defined in the module psb_prec_mod

Integer, real and complex data types are parametrized with a kind type defined in the library as follows:

@@ -35,17 +35,18 @@ class="cmbx-10">psb_spk_
Kind parameter for short precision real and complex data; - corresponds to a REAL declaration and is normally 4 bytes; + corresponds to a REAL declaration and is normally 4 bytes;
psb_dpk_
Kind parameter for long precision real and complex data; - corresponds to a DOUBLE PRECISION declaration and is normally 8 bytes; +class="cmtt-10"> PRECISION declaration and is normally 8 bytes;
psbpsb_epk_
Kind parameter for 8-bytes integer data, as is always used by the - sizeof methods; + sizeof methods;
psb

Figure 9 shows the layout of a generic 5 shows the layout of a generic psb_foo routine with respect to the PSBLAS-2.0 error handling policy. It is possible to see how, whenever an error condition is detected, the psb_set_erraction. The default is to print the error and terminate the program, but the user may choose to handle the error explicitly. -


- +


-

-

-

+

+
subroutine psb_foo(some args, info) 
subroutine psb_foo(some args, info) 
   ... 
   ... 
   if(error detected) then 
   if(error detected) then 
      info=errcode1 
      info=errcode1 
      call psb_errpush(psb_foo, errcode1) 
      call psb_errpush(psb_foo, errcode1) 
      goto 9999 
      goto 9999 
   end if 
   end if 
   ... 
   ... 
   call psb_bar(some args, info) 
   call psb_bar(some args, info) 
   if(info .ne. zero) then 
   if(info .ne. zero) then 
      info=errcode2 
      info=errcode2 
      call psb_errpush(psb_foo, errcode2) 
      call psb_errpush(psb_foo, errcode2) 
      goto 9999 
      goto 9999 
   end if 
   end if 
   ... 
   ... 
9999 continue 
9999 continue 
   if (err_act .eq. act_abort) then 
   if (err_act .eq. act_abort) then 
     call psb_error(icontxt) 
     call psb_error(icontxt) 
     return 
     return 
   else 
   else 
     return 
     return 
   end if 
   end if 
 
 
end subroutine psb_foo +class="cmbx-9">end subroutine psb_foo

Figure 9: Listing 5: The layout of a generic psb_foo routine with respect to PSBLAS-2.0 -error handling policy.
+error handling policy.
-


-

Figure 10 reports a sample error message generated by the PSBLAS-2.0 +


+

Figure 6 reports a sample error message generated by the PSBLAS-2.0 library. This error has been generated by the fact that the user has chosen the invalid “FOO” storage format to represent the sparse matrix. From this error message it is possible to see that the error has been detected inside @@ -339,20 +348,19 @@ the psb_cest subroutine called by psb_spasb ... by process 0 (i.e. the root process). -


- +


-

-

+

+

==========================================================  
Process: 0.  PSBLAS Error (4010) in subroutine: df_sample  
Error from call to subroutine mat dist @@ -368,16 +376,16 @@ process).  
==========================================================  
Aborting...
-

+


Figure 10: A sample PSBLAS-2.0 error message. Process 0 detected an error -condition inside the psb_cest subroutine
+>Listing 6: A sample PSBLAS-3.0 error message. Process 0 detected an error +condition inside the psb_cest subroutine
-


+

diff --git a/docs/html/userhtmlsu1.html b/docs/html/userhtmlsu1.html index 4e6f170e..502e961d 100644 --- a/docs/html/userhtmlsu1.html +++ b/docs/html/userhtmlsu1.html @@ -116,7 +116,7 @@ class="cmsy-10">|. + id="x6-4002r2"> @@ -128,7 +128,7 @@ src="points.png" alt="PIC" >

Figure 2: Point classfication.
+class="content">Point classfication.
diff --git a/docs/html/userhtmlsu10.html b/docs/html/userhtmlsu10.html index e1a66a1f..9dc53065 100644 --- a/docs/html/userhtmlsu10.html +++ b/docs/html/userhtmlsu10.html @@ -23,26 +23,41 @@ sum: src="userhtml1x.png" alt="y ← α x+ βy " class="math-display" >

- - - -

-call psb_geaxpby(alpha, x, beta, y, desc_a, info) -
-

+

call psb_geaxpby(alpha, x, beta, y, desc_a, info)

-



-

+




Table 1: Data types
+class="content">Data types
@@ -106,7 +121,7 @@ class="cmbx-10">required
Intent: in.
Specified as: a number of the data type indicated in Table 1. +href="#x19-56001r1">1.
x
psb_T_vect_type containing numbers of type specified in Table 1. The +href="#x19-56001r1">1. The rank of x must be the same of y. @@ -141,7 +156,7 @@ class="cmbx-10">required
Intent: in.
Specified as: a number of the data type indicated in Table 1. +href="#x19-56001r1">1.
y
psb_T_vect_type containing numbers of the type indicated in Table 1. +href="#x19-56001r1">1. The rank of y must be the same of x. @@ -206,7 +221,7 @@ class="cmtt-10">psb_T_vect_type containing numbers of the type indicated in Table 1. +href="#x19-56001r1">1.
info
An integer value; 0 means no error has been detected.