From 758164ff204f9d9f221fa2d4aae3c0e719606ff4 Mon Sep 17 00:00:00 2001 From: Salvatore Filippone Date: Wed, 18 May 2016 17:05:36 +0000 Subject: [PATCH] mld2p4-2: docs/html/img107.png docs/html/node12.html docs/html/node15.html docs/html/node16.html docs/html/node18.html docs/html/node20.html docs/html/node26.html docs/html/node3.html docs/html/node4.html docs/html/node5.html docs/html/node6.html docs/html/node8.html docs/mld2p4-2.1-guide.pdf Doc fixes. --- docs/html/img107.png | Bin 0 -> 655 bytes docs/html/node12.html | 2 +- docs/html/node15.html | 20 +- docs/html/node16.html | 9 +- docs/html/node18.html | 28 +-- docs/html/node20.html | 2 +- docs/html/node26.html | 2 +- docs/html/node3.html | 7 +- docs/html/node4.html | 2 +- docs/html/node5.html | 5 +- docs/html/node6.html | 2 +- docs/html/node8.html | 22 ++- docs/mld2p4-2.1-guide.pdf | 403 +++++++++++++++++++------------------- 13 files changed, 263 insertions(+), 241 deletions(-) create mode 100644 docs/html/img107.png diff --git a/docs/html/img107.png b/docs/html/img107.png new file mode 100644 index 0000000000000000000000000000000000000000..f2a61b67456f71d46a7a4a0112c874e1cc59df9e GIT binary patch literal 655 zcmV;A0&x9_P)baZq;KtP(BnhgyN0001IXJ?I#jWjeg7gNe100001 zbW%=J06^y0W&i*J4M{{nR7i>Klg~@rU>wGuBwa{j^EMF?OUKMk>gb`KymVME(qr)t zkcbX;8hRT8A&Mu#F+2{LMGs?x4G)Uf(n2XBrSv2s(lYckO3QA-*xonkuQx5)fv3?2 z-sH{uee(JKAOQyYH%SjVo*S3?{SM{oA%=PfCC(px^Lhfn6Z1aEXA2@`s7?!Z8vnOF$&&@Lop0v z)PeXs{TvqPutr=1NmCFXUZhK#ut8RuZ8C^p^RCic;C8Oj8-*zD_Vop(4|Y;GVy^^s zOh%#|5aJn%UWd4uZ9KfAP-mkoXv5d*n3v-WB78tJ*62WaIz}60$5p0V7ZQRbHHY@) z{j}?yF-d-T6~74^`=L-%QzKmJGzU?moIyMC*>cu_=p?f#W;p{75%6=;Yz?giNyDc{ENxYFAjqd$9Xk@)y!Zc5{c<6J zZ8V40Hf69yOPnaPlq8B1v^#c^)HwSO3?;!2jcKDYjL@@Bz(>g81a?Vy&FUONvD3VC zZ2Qg1>8KYXmVv|zy4mUCGX<@l$K4X0e<0X1_Nq??mI~}D6??^Y`-Qxzn(VgSBc!DI pg)}7hc{b2M1O0b8e*`@W diff --git a/docs/html/node15.html b/docs/html/node15.html index f7a2ff60..acb36212 100644 --- a/docs/html/node15.html +++ b/docs/html/node15.html @@ -163,10 +163,13 @@ preconditioner, which uses block Jacobi with ILU(0) on the local blocks as post-smoother, has a coarsest matrix replicated on the processors, and solves the coarsest-level system with the LU factorization from UMFPACK [9]. -Figure 4 shows how to set a three-level preconditioner similar to the one of 3, but the coarsest-level systems is solved with the multifrontal factorization from MUMPS [9]. -Note that MUMPS can be used on both replicated and distributed coarsest level matrices, -as a global and local solver respectively. +Figure 4 shows how to set a three-level preconditioner +similar to the one of 3, but the coarsest-level +systems is solved with the multifrontal factorization from +MUMPS [9]. +Note that MUMPS can be used on both replicated and distributed +coarsest level matrices, as a global and local solver respectively. The number of levels is specified by using mld_precinit; the other preconditioner parameters are set by calling mld_precset. Note that the type of multilevel framework (i.e. multiplicative among the levels @@ -183,13 +186,14 @@ solver. Again, mld_precset is used only to set non-default values of the parameters (see Tables 2-5). In both cases, the construction and the application of the preconditioner are carried out as for the default multi-level preconditioner. -The code fragments shown in in Figures 3 4-5 are -included in the example program file mld_dexample_ml.f90 too. +The code fragments shown in in +Figures 3 4-5 are +included in the example program file mld_dexample_ml.f90 too.

Finally, Figure 6 shows the setup of a one-level -additive Schwarz preconditioner, i.e. RAS with overlap 2. The corresponding -example program is available in mld_dexample_ 1lev.f90. +additive Schwarz preconditioner, i.e. RAS with overlap 2. The +corresponding example program is available in mld_dexample_1lev.f90.

For all the previous preconditioners, example programs where the sparse matrix and diff --git a/docs/html/node16.html b/docs/html/node16.html index d749e818..ad31029e 100644 --- a/docs/html/node16.html +++ b/docs/html/node16.html @@ -57,10 +57,11 @@ User Interface

-The basic user interface of MLD2P4 consists of six routines. The four routines mld_ precinit, -mld_precset, mld_precbld and mld_precaply encapsulate all the functionalities -for the setup and the application of any one-level and multi-level -preconditioner implemented in the package. +The basic user interface of MLD2P4 consists of six routines. The four +routines mld_ precinit, mld_precset, +mld_precbld and mld_precaply encapsulate all the +functionalities for the setup and the application of any one-level and +multi-level preconditioner implemented in the package. The routine mld_precfree deallocates the preconditioner data structure, while mld_precdescr prints a description of the preconditioner setup by the user. diff --git a/docs/html/node18.html b/docs/html/node18.html index 90842249..359e34bf 100644 --- a/docs/html/node18.html +++ b/docs/html/node18.html @@ -71,7 +71,7 @@ contained in val. The routine may also be invoked as a method of the preconditioner object as in the following:

-call p%set(what,val,info [,ilev]) +call p%set(what,val,info [,ilev, pos])
In this case it is also possible to specify an optional ilev @@ -84,8 +84,8 @@ solver by extending one of the base MLD2P4 types, and has declared a variable of the new type in the main program, it is possible to pass the new smoother/solver variable to the setup routine as follows:
-call p%set(smoother,info [,ilev]) -
call p%set(solver,info [,ilev]) +call p%set(smoother,info [,ilev ,pos]) +
call p%set(solver,info [,ilev ,poss])
In this way, the variable will act as a mold to which the @@ -202,7 +202,7 @@ according to their needs.


-
+
Table 2: Parameters defining the type of multi-level preconditioner. @@ -246,7 +246,7 @@ Parameters defining the type of multi-level preconditioner.


-
+
+ + 'UMF' + 'SLU' + 'MUMPS' + ALT="$p,t$">), LU from UMFPACK, LU from + SuperLU (plus triangular solve), LU from MUMPS. @@ -362,7 +366,7 @@ Parameters defining the one-level preconditioner used as smoother.


-
+
Table 3: Parameters defining the one-level preconditioner used as smoother. @@ -288,13 +288,17 @@ Parameters defining the one-level preconditioner used as smoother.
mld_sub_solve_
SUB_SOLVE		 character(len=*) 'DIAG' - 'GS' + 'GS' 'BWGS' 'ILU' 'MILU' 'ILUT' - 'UMF' 'SLU' 'ILU' Predefined local solver: pointwise Jacobi (diagonal scaling), + (forward) Gauss-Seidel, Backward Gauss-Seidel, ILU($p,t$), LU from UMFPACK, LU from - SuperLU (plus triangular solve).
mld_sub_fillin_
SUB_FILLIN		 integer
- +
Table 4: Parameters defining the aggregation algorithm. @@ -397,7 +401,7 @@ Parameters defining the aggregation algorithm.
mld_aggr_ord_
AGGR_ORD		 character(len=*)'NAT''NATURAL' 'DEGREE' Initial ordering of indices for aggregation algorithm: natural ordering or sorted by @@ -503,7 +507,7 @@ Parameters defining the aggregation algorithm.


-
+
Table 5: Parameters defining the coarse-space correction at the coarsest diff --git a/docs/html/node20.html b/docs/html/node20.html index 97d82361..612b3273 100644 --- a/docs/html/node20.html +++ b/docs/html/node20.html @@ -70,7 +70,7 @@ This routine computes