From 2b60afe6c3e5748c31043ea4cc3945cfbf3440f5 Mon Sep 17 00:00:00 2001 From: Salvatore Filippone Date: Thu, 1 Apr 2021 14:25:32 +0200 Subject: [PATCH] Minor doc changes --- docs/amg4psblas_1.0-guide.pdf | Bin 1806652 -> 1806933 bytes docs/html/userhtmlse6.html | 2 +- docs/html/userhtmlsu8.html | 21 +++++++++++++-------- docs/src/newobjects.tex | 2 +- docs/src/userinterface.tex | 8 ++++---- 5 files changed, 19 insertions(+), 14 deletions(-) diff --git a/docs/amg4psblas_1.0-guide.pdf b/docs/amg4psblas_1.0-guide.pdf index ddf0dcf1580cad391adfa6d66e8f9c93b3603ae2..b2cf1de413589cca70db31e6d618ac5f3d0a0911 100644 GIT binary patch delta 7155 zcmai33vg6bn)Wv7PLmfQ>2o?s1G!OPI!Z40-gBSILqKI`6cOUAmf)iy4YcL~c_8SF zi9@4~fJ7bnU3Ev6aYqFUQIP0>fR2tUI*iQLzFggv+M20ZXLe@Xsx5cb9rru;b|;-^ z)mADe=brPQ|8@TJzjAzE_uoC$J(O4Sk^H25Sw5PN<;(N&{N#K^zA|5xug=%xr{rt% zQ}cEC`h4OD`%cFsVHqQ5uT0KT=&3B*T4rmmO)cx#g;Cejgh$t`WBbc2%@g#ebu1l~ z+Xfvw+%S!MELg8(T_)x3YM=xJXkg*eu$3B$=W!x3bC6V4eQ?R(8)ANX=)wB><@rmaF-m zquL?Z3%9Y6sAYjXb#=0rW5Uo(VbVoi>`2UTH3#gU)9N{W-o;KwbxSh@o$h8wt1VyG zY|jdKO4ILqSQ9iuBHoGx{;lTIYP4_ROKf2lbGdezHsTCP3-l_;T$JN8Ly`^ zy{xVX^y^-zOE}QsNPQpsmJ%~fO*eg7+s_V0bq`1>IlxYo3*Q1#gFYBwZ^k?W@FqRI znY|lxTxea;!0qfGW45K4kfD7GJ025Y!gMIHl?}&C;CCI`zmh6I6HezyKsVi&?eEWZuMba!5;|5okfxMO1tQ@MgaBX11+^@wPuAM7AG4rSd4m41g*BI(7VO!v=*#c0 z7isrZi7I;ayKHe(=$c{Bibwf$+W18s9@*{nm9*?Gyh9V_X3(m;*f4nu>Z|C}yV$FA z)73b5Y7lFu?q<=5>&Mad7_%??q<(N9aA$L`q|xVA3d=Gu>Id-N9mo#^>s9F z8ykuWTZ4aiZ5y)-)6ciD<#b{@tD?8I;Su)a*U5g$(1T0gILcHG`Vb_jAd8TH9QVEnn+g<`0xK+mhx4Py) zDjUz-!ILjyxrGT+6Nast*zj$LZQ1awbncTR-*c2rqa#OId%^?@0(-a$&oxy6oeRo* zSua7R(EJg$KH|Ehzg5>p?;Ym#BflPD2NfDx)KEpA>`Wx6dOJHnht{wty|OD&JtKIQ zaJ%XDfsNVTtG)%3zEY%kq^9LR6{ z340|fy{ARfjxi%@!}J7gs)gyP$5|UaaST=$?jJbD+9&Kgg{{@c*=?kqXsD#WJr0Kt z=jvGo4Zq43(Z8N#xZw?nO8V2QY;tj{>IB;r(|su1q#vGOJBoAdBwJpbfA1t)T^n4n z6~?J_u44;jx)N+;(kb@Y>ysQ|jZEE=oT<>vJnxM9LPIn>yMoUk?J%#Q)P20792V#z z5YjDYm`aCs<3)U#=YF}+p?}LKB?Uo0oX^W+LPwPHlKF%o}Yx~e~E>g@8gSNzM)yVK|j8aUp#J8 zKf^DkYZmZWG=QM9>Et0PZ+slo!u!Wi+`WUVqz?17<01Z?dGxzsKDkHcEs7ia*4&G1!V}yVUm(UpbBlWZuQ&WuE5y)N*Ty zt=Gj2T%ZG+7La=QSGYC`wvjfeR>dClXXraaFVmYW5Lsf&~8(Ap

93rg{uoTUNadqP_yrUA zXr|%sC(1}2O2nriL)0AIP>bMe_V9sdK#4xw!;J|it4Mt+Q9;9Hd~#sI&`TVzy6rHZ zBA){E0vj@XdJu1rYM06(Q4$L*CI0LJPP z*^wK=CN^EzFy{XtJCa@(arR-}S#H2pAy84r6MVi*hQoD@2B8O;)XKe$4xCNk?Z!^d zp`pj{Ca*cf%PNH@)FPfc@8Buw_!UCjfBYq1I)!NK)%Hhe6u^Dmc{vFM*=4Sd1Tuf^H&Ccm`k{)@od_wjF1*QLCY z-rvV}(%!d`Wo-Hp|CexW)l+=vYY2n6h0=A#V<8&)#Xk7*jepIPUjuw@2X9>qsni0= zF#lbI1k^_wi&Q*FVKMLDkdd{3Z>Br4t99M%&dM?&*pR6!COIV7nf~17!e>{ue?yPV z?j=kQo!ZYERv>GGZ5L`2SyKqdNryFsKz4llhHQ7ZmhIZu*|RkuE;lma>Xp4)J9{?E zxtk8rQ_B~LR{Gr%lE9Ll?pp`e zqb6#-@!D^xI?7wKP_z}f_Fz}V>SJkdrX!c_mg+`;Y1_|dSGzD>Tc{xvUHLRT60)E& z>gi0xEfQv!JZ@{>++OXYP)mB16V0>2jpY z4nk=u+|ng0>94-Y)j<@u!ZgP1g;a$|FU@wt7)G&~AscN)@sZevHEU6P+egt*$jbsf zfmsvPZeOlrAR~)Ye1$iDiNrDY3OJYf`#G;hnr0zO4$ss3&p!wwlLrY zO0gFdW2Ud@%x=l8>6F$A(38*d^Xa|I`Q#f+X$F2_J;Yq#O;0b*wT(9!$Z)*O!c#*ax@AAe-noKRwR(~+s+-c&Azg@2N;j|&)bpBU+97)-L`*L|&R)>`fW6GB zfrryf1I1f#jM@(H3+TNJubz%~uiJ&?QejO=luqvFjZtL2=y&Wnz*i$eIVdweJ-{z1 zOn00`l6a_=S5?CSJGP;=g&-TBFxTy~Ej-f4e>TQI^59T8yC;>;Jvk18h-~yi> z8$-2F2DggB-lms%8|^&AXO&H$6a=&aCAw%IvI)3oK1N|-Sm!+V!YHa^FYrey5toY| zlxp`Rr_t>%@)aexgJ|~A|FC$#kS&6=?p~BIBiiBQW%UsxYyCe z5*;-pwouaxU)njUZyWx?f0k8+fVo)vLHwH074&;nc1?k#A^ z_N4Ssx9!=W2=umZfDpW@qst3~TX77jJhW0A^l-6-o`>ao&@^Cd+`u5(qpIUbM82&e zdVmJ#IHWShFW-q4}) z3TcoAx;bD;+92)~(#R!gZqnl$x~)TO*n^=vU|(7XdQ@OW-mmOYK{lAN?!(w^SR`h^ zVdLV^tP<9q)5)9Q*?b$_;nPXI%(gXWQi!#lGorkkjMg&g z-oU#DXN?zNp%rd=KBYcL=BLa48#sdzqT7c(nUc!uGY}7qVxy>rKKdYeJukqzXq3D1 zsk=5BGXBWbA0`{WtyuD(1GANp2Sfu+9dwZYboXa+-GxS~lkV&4L1#DY2RrsxwsXkU zOyqC<1HFY=m^AgR)@>tbgc@kU7GT2c5zslA)<|rb!Xb2@yZZ++m7Qpz2Kd%wgO2RI zZ(ZJi-$wj4jl6Yv>Y{YiLOO5Lr(LNT;dG>_JM~^-3Ea& za)>MJwI#tuh5W3QL$$)rhHEwQbBY}5L*YlB4K{4~>C0ih96W`8{Bf{xiTqq7hXqQq=~Gg6rDjL2 z`g>~KmC_@tPSdJgDLb{51+c3m*v)cSBZr%mBpsmxyHe9GeEoU=M4BQ>!xwJ`GYA}M zDwjiC4%KpqD#=gh(F>*kY@QgOAhBN4J(={_dsgevYSr^d#!RAx`;H*Q5x1C2-e!YzoO#*04SJpW&i*H delta 6893 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 if the library code does not recognize a keyword, it passes it down the composition hierarchy (levels containing smoothers containing in turn solvers), so that it can be eventually +class="cmr-12">(levels containing smoothers containing in turn solvers), so that it can eventually be caught by the new solver. By the same token, any keyword/value pair that does not ). class="newline" />

Remark 3. Many of the coarsest-level solvers cannot be used with both the +class="cmr-12">Many of the coarsest-level solvers cannot be used with both replicated replicated and distributed coarsest-matrix layout; therefore, setting the solver after the +class="cmr-12">and distributed coarsest-matrix layouts; therefore, setting the solver after the layout layout may change the layout. Similarly, setting the layout after the solver may change +class="cmr-12">may change the layout. Similarly, setting the layout after the solver may change the the solver. +class="cmr-12">solver.

More precisely, UMFPACK and SuperLU require the coarsest-level matrix to be ’FCG’

A string that defines the iterative method to -be used. CG the Conjugate Gradient method; -CGS the Conjugate Gradient Stabilized +be used when employing a Krylov method +’KRM’ as a coarse solver. CG the Conjugate +Gradient method; CGS the Conjugate Gradient +Stabilized method; GCR the Generalized Conjugate Residual method; 0$ & -1 & Number of iterations after which a residual is to be calculated. \\ \hline \fortinline|'BJAC_STOPTOL'| & \fortinline|real(kind_parameter)| & Any real\par $<1$ & 0 & Tolerance for the stopping criterion on the residual. \\ \hline \fortinline|'KRM_METHOD'| & \fortinline|character(len=*)| & \fortinline|'CG'| \par \fortinline|'FCG'| \par \fortinline|'CGS'| \par \fortinline|'CGR'| \par \fortinline|'BICG'| \par \fortinline|'BICGSTAB'| \par \fortinline|'BICGSTABL'| \par \fortinline|'RGMRES'| & \fortinline|'FCG'| & A string that defines the iterative method to be - used. \texttt{CG} the Conjugate Gradient method; + used when employing a Krylov method \fortinline|'KRM'| as a coarse solver. \texttt{CG} the Conjugate Gradient method; \texttt{CGS} the Conjugate Gradient Stabilized method; \texttt{GCR} the Generalized Conjugate Residual method; \texttt{FCG} the Flexible Conjugate Gradient method; @@ -940,7 +940,7 @@ Create a (deep) copy of the preconditioner object. \begin{tabular}{p{1.2cm}p{12cm}} \fortinline|global| & \fortinline|logical, optional|.\\ & Whether the global or local preconditioner memory - occupatio is + occupation is desired. Default: \fortinline|.false.|.\\ \end{tabular} \noindent @@ -951,7 +951,7 @@ Return memory footprint in bytes. \begin{center} \fortinline|call p%allocate_wrk(info[, vmold])|\\ \end{center} -n + \noindent Allocate internal work vectors. Each application of the preconditioner uses a number of work vectors which are allocated internally as