@ -10,7 +10,7 @@
< link rel = "stylesheet" type = "text/css" href = "userhtml.css" >
< link rel = "stylesheet" type = "text/css" href = "userhtml.css" >
< / head > < body
< / head > < body
>
>
<!-- l. 9 00 --> < div class = "crosslinks" > < p class = "noindent" > < span
<!-- l. 9 23 --> < div class = "crosslinks" > < p class = "noindent" > < span
class="cmr-12">[< / span > < a
class="cmr-12">[< / span > < a
href="userhtmlsu15.html" >< span
href="userhtmlsu15.html" >< span
class="cmr-12">prev< / span > < / a > < span
class="cmr-12">prev< / span > < / a > < span
@ -28,99 +28,52 @@ class="cmr-12">] </span></p></div>
class="cmr-12">5.9 < / span > < / span > < a
class="cmr-12">5.9 < / span > < / span > < a
id="x26-250005.9">< / a > < span
id="x26-250005.9">< / a > < span
class="cmr-12">Auxiliary Methods< / span > < / h4 >
class="cmr-12">Auxiliary Methods< / span > < / h4 >
<!-- l. 9 01 --> < p class = "noindent" > < span
<!-- l. 9 24 --> < p class = "noindent" > < span
class="cmr-12">Various functionalities are implemented as additional methods of the preconditioner< / span >
class="cmr-12">Various functionalities are implemented as additional methods of the preconditioner< / span >
< span
< span
class="cmr-12">object.< / span >
class="cmr-12">object.< / span >
<!-- l. 9 04 --> < p class = "noindent" >
<!-- l. 9 27 --> < p class = "noindent" >
< h5 class = "subsubsectionHead" > < span class = "titlemark" > < span
< h5 class = "subsubsectionHead" > < span class = "titlemark" > < span
class="cmr-12">5.9.1 < / span > < / span > < a
class="cmr-12">5.9.1 < / span > < / span > < a
id="x26-260005.9.1">< / a > < span
id="x26-260005.9.1">< / a > < span
class="cmr-12">Method: dump< / span > < / h5 >
class="cmr-12">Method: dump< / span > < / h5 >
< div class = "center"
< div class = "center"
>
>
<!-- l. 906 --> < p class = "noindent" >
<!-- l. 929 --> < p class = "noindent" >
<!-- l. 907 --> < p class = "noindent" > < span class = "lstinline" > < / span > < span
<!-- l. 930 --> < p class = "noindent" > < code class = "lstinline" > < span style = "color:#000000" > call< / span > < span style = "color:#000000" > < / span > < span style = "color:#000000" > p< / span > < span style = "color:#000000" > %< / span > < span style = "color:#000000" > dump< / span > < span style = "color:#000000" > (< / span > < span style = "color:#000000" > info< / span > < span style = "color:#000000" > [,< / span > < span style = "color:#000000" > istart< / span > < span style = "color:#000000" > ,< / span > < span style = "color:#000000" > iend< / span > < span style = "color:#000000" > ,< / span > < span style = "color:#000000" > prefix< / span > < span style = "color:#000000" > ,< / span > < span style = "color:#000000" > head< / span > < span style = "color:#000000" > ,< / span > < span style = "color:#000000" > ac< / span > < span style = "color:#000000" > ,< / span > < span style = "color:#000000" > rp< / span > < span style = "color:#000000" > ,< / span > < span style = "color:#000000" > smoother< / span > < span style = "color:#000000" > ,< / span > < span style = "color:#000000" > solver< / span > < span style = "color:#000000" > ,< / span > < span style = "color:#000000" > global_num< / span > < span style = "color:#000000" > ])< / span > < / code > < br / >
class="cmtt-12">call< / span > < span
class="cmtt-12">  < / span > < span
class="cmtt-12">p< / span > < span
class="cmtt-12">%< / span > < span
class="cmtt-12">dump< / span > < span
class="cmtt-12">(< / span > < span
class="cmtt-12">info< / span > < span
class="cmtt-12">[,< / span > < span
class="cmtt-12">istart< / span > < span
class="cmtt-12">,< / span > < span
class="cmtt-12">iend< / span > < span
class="cmtt-12">,< / span > < span
class="cmtt-12">prefix< / span > < span
class="cmtt-12">,< / span > < span
class="cmtt-12">head< / span > < span
class="cmtt-12">,< / span > < span
class="cmtt-12">ac< / span > < span
class="cmtt-12">,< / span > < span
class="cmtt-12">rp< / span > < span
class="cmtt-12">,< / span > < span
class="cmtt-12">smoother< / span > < span
class="cmtt-12">,< / span > < span
class="cmtt-12">solver< / span > < span
class="cmtt-12">,< / span > < span
class="cmtt-12">global_num< / span > < span
class="cmtt-12">])< / span > < br / >
< / div >
< / div >
<!-- l. 9 10 --> < p class = "noindent" > < span
<!-- l. 933 --> < p class = "noindent" > < span
class="cmr-12">Dump on file.< / span >
class="cmr-12">Dump on file.< / span >
<!-- l. 9 1 3--> < p class = "noindent" > < span
<!-- l. 936 --> < p class = "noindent" > < span
class="cmbx-12">Arguments< / span >
class="cmbx-12">Arguments< / span >
< div class = "tabular" > < table id = "TBL-17" class = "tabular"
< div class = "tabular" > < table id = "TBL-18" class = "tabular"
cellspacing="0" cellpadding="0"
>< colgroup id = "TBL-17-1g" > < col
>< colgroup id = "TBL-18-1g" > < col
id="TBL-17-1">< col
id="TBL-18-1">< col
id="TBL-17-2">< / colgroup > < tr
id="TBL-18-2">< / colgroup > < tr
style="vertical-align:baseline;" id="TBL-17-1-">< td style = "white-space:normal; text-align:left;" id = "TBL-17-1-1"
style="vertical-align:baseline;" id="TBL-18-1-">< td style = "white-space:normal; text-align:left;" id = "TBL-18-1-1"
class="td11"><!-- l. 916 --> < p class = "noindent" > < span class = "lstinline" > < / span > < span
class="td11"> <!-- l. 939 --> < p class = "noindent" > < code class = "lstinline" > < span style = "color:#000000" > info< / span > < / code > < / td > < td style = "white-space:normal; text-align:left;" id = "TBL-18-1-2"
class="cmtt-12">info< / span > < / td > < td style = "white-space:normal; text-align:left;" id = "TBL-17-1-2"
class="td11"> <!-- l. 939 --> < p class = "noindent" > < code class = "lstinline" > < span style = "color:#000000" > integer< / span > < span style = "color:#000000" > ,< / span > < span style = "color:#000000" > < / span > < span style = "color:#000000" > intent< / span > < span style = "color:#000000" > (< / span > < span style = "color:#000000" > out< / span > < span style = "color:#000000" > )< / span > < / code > < span
class="td11"><!-- l. 916 --> < p class = "noindent" > < span class = "lstinline" > < / span > < span
class="cmtt-12">integer< / span > < span
class="cmtt-12">,< / span > < span
class="cmtt-12">  < / span > < span
class="cmtt-12">intent< / span > < span
class="cmtt-12">(< / span > < span
class="cmtt-12">out< / span > < span
class="cmtt-12">)< / span > < span
class="cmr-12">.< / span > < / td >
class="cmr-12">.< / span > < / td >
< / tr > < tr
< / tr > < tr
style="vertical-align:baseline;" id="TBL-17 -2-">< td style = "white-space:normal; text-align:left;" id = "TBL-1 7 -2-1"
style="vertical-align:baseline;" id="TBL-18-2-">< td style = "white-space:normal; text-align:left;" id = "TBL-18-2-1"
class="td11"><!-- l. 917 --> < p class = "noindent" > < / td > < td style = "white-space:normal; text-align:left;" id = "TBL-1 7 -2-2"
class="td11"> <!-- l. 940 --> < p class = "noindent" > < / td > < td style = "white-space:normal; text-align:left;" id = "TBL-18-2-2"
class="td11"><!-- l. 917 --> < p class = "noindent" > < span
class="td11"> <!-- l. 940 --> < p class = "noindent" > < span
class="cmr-12">Error code. If no error, 0 is returned. See Section< / span > < span
class="cmr-12">Error code. If no error, 0 is returned. See Section< / span > < span
class="cmr-12">  < / span > < a
class="cmr-12">  < / span > < a
href="userhtmlse7.html#x28-320007">< span
href="userhtmlse7.html#x28-320007">< span
class="cmr-12">7< / span > <!-- tex4ht:ref: sec:errors --> < / a > < span
class="cmr-12">7< / span > <!-- tex4ht:ref: sec:errors --> < / a > < span
class="cmr-12">for details.< / span > < / td >
class="cmr-12">for details.< / span > < / td >
< / tr > < tr
< / tr > < tr
style="vertical-align:baseline;" id="TBL-17-3-">< td style = "white-space:normal; text-align:left;" id = "TBL-17-3-1"
style="vertical-align:baseline;" id="TBL-18-3-">< td style = "white-space:normal; text-align:left;" id = "TBL-18-3-1"
class="td11"><!-- l. 918 --> < p class = "noindent" > < span class = "lstinline" > < / span > < span
class="td11"> <!-- l. 941 --> < p class = "noindent" > < code class = "lstinline" > < span style = "color:#000000" > amold< / span > < / code > < / td > < td style = "white-space:normal; text-align:left;" id = "TBL-18-3-2"
class="cmtt-12">amold< / span > < / td > < td style = "white-space:normal; text-align:left;" id = "TBL-17-3-2"
class="td11"> <!-- l. 941 --> < p class = "noindent" > < code class = "lstinline" > < span style = "color:#000000" > class< / span > < span style = "color:#000000" > (< / span > < span style = "color:#000000" > psb_< / span > < / code > < span
class="td11"><!-- l. 918 --> < p class = "noindent" > < span class = "lstinline" > < / span > < span
class="cmti-12">x< / span > < code class = "lstinline" > < span style = "color:#000000" > _base_sparse_mat< / span > < span style = "color:#000000" > ),< / span > < span style = "color:#000000" > < / span > < span style = "color:#000000" > intent< / span > < span style = "color:#000000" > (< / span > < span style = "color:#000000" > in< / span > < span style = "color:#000000" > ),< / span > < span style = "color:#000000" > < / span > < span style = "color:#000000" > optional< / span > < / code > < span
class="cmtt-12">class< / span > < span
class="cmtt-12">(< / span > < span
class="cmtt-12">psb_< / span > < span
class="cmti-12">x< / span > < span class = "lstinline" > < / span > < span
class="cmtt-12">_base_sparse_mat< / span > < span
class="cmtt-12">),< / span > < span
class="cmtt-12">  < / span > < span
class="cmtt-12">intent< / span > < span
class="cmtt-12">(< / span > < span
class="cmtt-12">in< / span > < span
class="cmtt-12">),< / span > < span
class="cmtt-12">  < / span > < span
class="cmtt-12">optional< / span > < span
class="cmr-12">.< / span > < / td >
class="cmr-12">.< / span > < / td >
< / tr > < tr
< / tr > < tr
style="vertical-align:baseline;" id="TBL-17 -4-">< td style = "white-space:normal; text-align:left;" id = "TBL-1 7 -4-1"
style="vertical-align:baseline;" id="TBL-18-4-">< td style = "white-space:normal; text-align:left;" id = "TBL-18-4-1"
class="td11"><!-- l. 919 --> < p class = "noindent" > < / td > < td style = "white-space:normal; text-align:left;" id = "TBL-1 7 -4-2"
class="td11"> <!-- l. 942 --> < p class = "noindent" > < / td > < td style = "white-space:normal; text-align:left;" id = "TBL-18-4-2"
class="td11"><!-- l. 919 --> < p class = "noindent" > < span
class="td11"> <!-- l. 942 --> < p class = "noindent" > < span
class="cmr-12">The desired dynamic type for internal matrix components; this< / span >
class="cmr-12">The desired dynamic type for internal matrix components; this< / span >
< span
< span
class="cmr-12">allows e.g. running on GPUs; it needs not be the same on all< / span >
class="cmr-12">allows e.g. running on GPUs; it needs not be the same on all< / span >
@ -128,151 +81,102 @@ class="cmr-12">allows e.g. running on GPUs; it needs not be the same
class="cmr-12">processes. See the PSBLAS User’ s Guide for details < / span > < span class = "cite" > < span
class="cmr-12">processes. See the PSBLAS User’ s Guide for details < / span > < span class = "cite" > < span
class="cmr-12">[< / span > < a
class="cmr-12">[< / span > < a
href="userhtmlli5.html#XPSBLASGUIDE">< span
href="userhtmlli5.html#XPSBLASGUIDE">< span
class="cmr-12">20 < / span > < / a > < span
class="cmr-12">21 < / span > < / a > < span
class="cmr-12">]< / span > < / span > < span
class="cmr-12">]< / span > < / span > < span
class="cmr-12">.< / span > < / td >
class="cmr-12">.< / span > < / td >
< / tr > < tr
< / tr > < tr
style="vertical-align:baseline;" id="TBL-17 -5-">< td style = "white-space:normal; text-align:left;" id = "TBL-1 7 -5-1"
style="vertical-align:baseline;" id="TBL-18 -5-">< td style = "white-space:normal; text-align:left;" id = "TBL-1 8 -5-1"
class="td11"> < / td > < / tr > < / table > < / div >
class="td11"> < / td > < / tr > < / table > < / div >
<!-- l. 9 26 --> < p class = "noindent" >
<!-- l. 9 49 --> < p class = "noindent" >
< h5 class = "subsubsectionHead" > < span class = "titlemark" > < span
< h5 class = "subsubsectionHead" > < span class = "titlemark" > < span
class="cmr-12">5.9.2 < / span > < / span > < a
class="cmr-12">5.9.2 < / span > < / span > < a
id="x26-270005.9.2">< / a > < span
id="x26-270005.9.2">< / a > < span
class="cmr-12">Method: clone< / span > < / h5 >
class="cmr-12">Method: clone< / span > < / h5 >
< div class = "center"
< div class = "center"
>
>
<!-- l. 928 --> < p class = "noindent" >
<!-- l. 951 --> < p class = "noindent" >
<!-- l. 929 --> < p class = "noindent" > < span class = "lstinline" > < / span > < span
<!-- l. 952 --> < p class = "noindent" > < code class = "lstinline" > < span style = "color:#000000" > call< / span > < span style = "color:#000000" > < / span > < span style = "color:#000000" > p< / span > < span style = "color:#000000" > %< / span > < span style = "color:#000000" > clone< / span > < span style = "color:#000000" > (< / span > < span style = "color:#000000" > pout< / span > < span style = "color:#000000" > ,< / span > < span style = "color:#000000" > info< / span > < span style = "color:#000000" > )< / span > < / code > < br / >
class="cmtt-12">call< / span > < span
class="cmtt-12">  < / span > < span
class="cmtt-12">p< / span > < span
class="cmtt-12">%< / span > < span
class="cmtt-12">clone< / span > < span
class="cmtt-12">(< / span > < span
class="cmtt-12">pout< / span > < span
class="cmtt-12">,< / span > < span
class="cmtt-12">info< / span > < span
class="cmtt-12">)< / span > < br / >
< / div >
< / div >
<!-- l. 9 32 --> < p class = "noindent" > < span
<!-- l. 955 --> < p class = "noindent" > < span
class="cmr-12">Create a (deep) copy of the preconditioner object.< / span >
class="cmr-12">Create a (deep) copy of the preconditioner object.< / span >
<!-- l. 9 3 5--> < p class = "noindent" > < span
<!-- l. 958 --> < p class = "noindent" > < span
class="cmbx-12">Arguments< / span >
class="cmbx-12">Arguments< / span >
< div class = "tabular" > < table id = "TBL-18" class = "tabular"
< div class = "tabular" > < table id = "TBL-19" class = "tabular"
cellspacing="0" cellpadding="0"
>< colgroup id = "TBL-18-1g" > < col
>< colgroup id = "TBL-19-1g" > < col
id="TBL-18-1">< col
id="TBL-19-1">< col
id="TBL-18-2">< / colgroup > < tr
id="TBL-19-2">< / colgroup > < tr
style="vertical-align:baseline;" id="TBL-18-1-">< td style = "white-space:normal; text-align:left;" id = "TBL-18-1-1"
style="vertical-align:baseline;" id="TBL-19-1-">< td style = "white-space:normal; text-align:left;" id = "TBL-19-1-1"
class="td11"><!-- l. 938 --> < p class = "noindent" > < span class = "lstinline" > < / span > < span
class="td11"> <!-- l. 961 --> < p class = "noindent" > < code class = "lstinline" > < span style = "color:#000000" > pout< / span > < / code > < / td > < td style = "white-space:normal; text-align:left;" id = "TBL-19-1-2"
class="cmtt-12">pout< / span > < / td > < td style = "white-space:normal; text-align:left;" id = "TBL-18-1-2"
class="td11"> <!-- l. 961 --> < p class = "noindent" > < code class = "lstinline" > < span style = "color:#000000" > type< / span > < span style = "color:#000000" > (< / span > < span style = "color:#000000" > amg_< / span > < / code > < span
class="td11"><!-- l. 938 --> < p class = "noindent" > < span class = "lstinline" > < / span > < span
class="cmti-12">x< / span > < code class = "lstinline" > < span style = "color:#000000" > prec_type< / span > < span style = "color:#000000" > ),< / span > < span style = "color:#000000" > < / span > < span style = "color:#000000" > intent< / span > < span style = "color:#000000" > (< / span > < span style = "color:#000000" > out< / span > < span style = "color:#000000" > )< / span > < / code > < span
class="cmtt-12">type< / span > < span
class="cmtt-12">(< / span > < span
class="cmtt-12">amg_< / span > < span
class="cmti-12">x< / span > < span class = "lstinline" > < / span > < span
class="cmtt-12">prec_type< / span > < span
class="cmtt-12">),< / span > < span
class="cmtt-12">  < / span > < span
class="cmtt-12">intent< / span > < span
class="cmtt-12">(< / span > < span
class="cmtt-12">out< / span > < span
class="cmtt-12">)< / span > < span
class="cmr-12">.< / span > < / td >
class="cmr-12">.< / span > < / td >
< / tr > < tr
< / tr > < tr
style="vertical-align:baseline;" id="TBL-18 -2-">< td style = "white-space:normal; text-align:left;" id = "TBL-1 8 -2-1"
style="vertical-align:baseline;" id="TBL-19-2-">< td style = "white-space:normal; text-align:left;" id = "TBL-19-2-1"
class="td11"><!-- l. 939 --> < p class = "noindent" > < / td > < td style = "white-space:normal; text-align:left;" id = "TBL-1 8 -2-2"
class="td11"> <!-- l. 962 --> < p class = "noindent" > < / td > < td style = "white-space:normal; text-align:left;" id = "TBL-19-2-2"
class="td11"><!-- l. 939 --> < p class = "noindent" > < span
class="td11"> <!-- l. 962 --> < p class = "noindent" > < span
class="cmr-12">The copy of the preconditioner data structure. Note that < / span > < span
class="cmr-12">The copy of the preconditioner data structure. Note that < / span > < span
class="cmti-12">x < / span > < span
class="cmti-12">x < / span > < span
class="cmr-12">must< / span >
class="cmr-12">must< / span >
< span
< span
class="cmr-12">be chosen according to the < / span > < span class = "lstinline" > < / span > < span
class="cmr-12">be chosen according to the < / span > < code class = "lstinline" > < span style = "color:#000000" > real< / span > < / code > < span
class="cmtt-12">real< / span > < span
class="cmr-12">/< / span > < code class = "lstinline" > < span style = "color:#000000" > complex< / span > < / code > < span
class="cmr-12">/< / span > < span class = "lstinline" > < / span > < span
class="cmtt-12">complex< / span > < span
class="cmr-12">, single/double precision< / span >
class="cmr-12">, single/double precision< / span >
< span
< span
class="cmr-12">version of AMG4PSBLAS under use.< / span > < / td >
class="cmr-12">version of AMG4PSBLAS under use.< / span > < / td >
< / tr > < tr
< / tr > < tr
style="vertical-align:baseline;" id="TBL-18-3-">< td style = "white-space:normal; text-align:left;" id = "TBL-18-3-1"
style="vertical-align:baseline;" id="TBL-19-3-">< td style = "white-space:normal; text-align:left;" id = "TBL-19-3-1"
class="td11"><!-- l. 942 --> < p class = "noindent" > < span class = "lstinline" > < / span > < span
class="td11"> <!-- l. 965 --> < p class = "noindent" > < code class = "lstinline" > < span style = "color:#000000" > info< / span > < / code > < / td > < td style = "white-space:normal; text-align:left;" id = "TBL-19-3-2"
class="cmtt-12">info< / span > < / td > < td style = "white-space:normal; text-align:left;" id = "TBL-18-3-2"
class="td11"> <!-- l. 965 --> < p class = "noindent" > < code class = "lstinline" > < span style = "color:#000000" > integer< / span > < span style = "color:#000000" > ,< / span > < span style = "color:#000000" > < / span > < span style = "color:#000000" > intent< / span > < span style = "color:#000000" > (< / span > < span style = "color:#000000" > out< / span > < span style = "color:#000000" > )< / span > < / code > < span
class="td11"><!-- l. 942 --> < p class = "noindent" > < span class = "lstinline" > < / span > < span
class="cmtt-12">integer< / span > < span
class="cmtt-12">,< / span > < span
class="cmtt-12">  < / span > < span
class="cmtt-12">intent< / span > < span
class="cmtt-12">(< / span > < span
class="cmtt-12">out< / span > < span
class="cmtt-12">)< / span > < span
class="cmr-12">.< / span > < / td >
class="cmr-12">.< / span > < / td >
< / tr > < tr
< / tr > < tr
style="vertical-align:baseline;" id="TBL-18 -4-">< td style = "white-space:normal; text-align:left;" id = "TBL-1 8 -4-1"
style="vertical-align:baseline;" id="TBL-19-4-">< td style = "white-space:normal; text-align:left;" id = "TBL-19-4-1"
class="td11"><!-- l. 943 --> < p class = "noindent" > < / td > < td style = "white-space:normal; text-align:left;" id = "TBL-1 8 -4-2"
class="td11"> <!-- l. 966 --> < p class = "noindent" > < / td > < td style = "white-space:normal; text-align:left;" id = "TBL-19-4-2"
class="td11"><!-- l. 943 --> < p class = "noindent" > < span
class="td11"> <!-- l. 966 --> < p class = "noindent" > < span
class="cmr-12">Error code. If no error, 0 is returned. See Section< / span > < span
class="cmr-12">Error code. If no error, 0 is returned. See Section< / span > < span
class="cmr-12">  < / span > < a
class="cmr-12">  < / span > < a
href="userhtmlse7.html#x28-320007">< span
href="userhtmlse7.html#x28-320007">< span
class="cmr-12">7< / span > <!-- tex4ht:ref: sec:errors --> < / a > < span
class="cmr-12">7< / span > <!-- tex4ht:ref: sec:errors --> < / a > < span
class="cmr-12">for details.< / span > < / td >
class="cmr-12">for details.< / span > < / td >
< / tr > < tr
< / tr > < tr
style="vertical-align:baseline;" id="TBL-18 -5-">< td style = "white-space:normal; text-align:left;" id = "TBL-1 8 -5-1"
style="vertical-align:baseline;" id="TBL-19 -5-">< td style = "white-space:normal; text-align:left;" id = "TBL-1 9 -5-1"
class="td11"> < / td > < / tr > < / table > < / div >
class="td11"> < / td > < / tr > < / table > < / div >
<!-- l. 9 48 --> < p class = "noindent" >
<!-- l. 9 71 --> < p class = "noindent" >
< h5 class = "subsubsectionHead" > < span class = "titlemark" > < span
< h5 class = "subsubsectionHead" > < span class = "titlemark" > < span
class="cmr-12">5.9.3 < / span > < / span > < a
class="cmr-12">5.9.3 < / span > < / span > < a
id="x26-280005.9.3">< / a > < span
id="x26-280005.9.3">< / a > < span
class="cmr-12">Method: sizeof< / span > < / h5 >
class="cmr-12">Method: sizeof< / span > < / h5 >
< div class = "center"
< div class = "center"
>
>
<!-- l. 950 --> < p class = "noindent" >
<!-- l. 973 --> < p class = "noindent" >
<!-- l. 951 --> < p class = "noindent" > < span class = "lstinline" > < / span > < span
<!-- l. 974 --> < p class = "noindent" > < code class = "lstinline" > < span style = "color:#000000" > sz< / span > < span style = "color:#000000" > < / span > < span style = "color:#000000" > =< / span > < span style = "color:#000000" > < / span > < span style = "color:#000000" > p< / span > < span style = "color:#000000" > %< / span > < span style = "color:#000000" > sizeof< / span > < span style = "color:#000000" > ([< / span > < span style = "color:#000000" > global< / span > < span style = "color:#000000" > ])< / span > < / code > < br / >
class="cmtt-12">sz< / span > < span
class="cmtt-12">  < / span > < span
class="cmtt-12">=< / span > < span
class="cmtt-12">  < / span > < span
class="cmtt-12">p< / span > < span
class="cmtt-12">%< / span > < span
class="cmtt-12">sizeof< / span > < span
class="cmtt-12">([< / span > < span
class="cmtt-12">global< / span > < span
class="cmtt-12">])< / span > < br / >
< / div >
< / div >
< div class = "tabular" > < table id = "TBL-19" class = "tabular"
< div class = "tabular" > < table id = "TBL-20" class = "tabular"
cellspacing="0" cellpadding="0"
>< colgroup id = "TBL-19-1g" > < col
>< colgroup id = "TBL-20-1g" > < col
id="TBL-19-1">< col
id="TBL-20-1">< col
id="TBL-19-2">< / colgroup > < tr
id="TBL-20-2">< / colgroup > < tr
style="vertical-align:baseline;" id="TBL-19-1-">< td style = "white-space:normal; text-align:left;" id = "TBL-19-1-1"
style="vertical-align:baseline;" id="TBL-20-1-">< td style = "white-space:normal; text-align:left;" id = "TBL-20-1-1"
class="td11"><!-- l. 955 --> < p class = "noindent" > < span class = "lstinline" > < / span > < span
class="td11"> <!-- l. 978 --> < p class = "noindent" > < code class = "lstinline" > < span style = "color:#000000" > global< / span > < / code > < / td > < td style = "white-space:normal; text-align:left;" id = "TBL-20-1-2"
class="cmtt-12">global< / span > < / td > < td style = "white-space:normal; text-align:left;" id = "TBL-19-1-2"
class="td11"> <!-- l. 978 --> < p class = "noindent" > < code class = "lstinline" > < span style = "color:#000000" > logical< / span > < span style = "color:#000000" > ,< / span > < span style = "color:#000000" > < / span > < span style = "color:#000000" > optional< / span > < / code > < span
class="td11"><!-- l. 955 --> < p class = "noindent" > < span class = "lstinline" > < / span > < span
class="cmtt-12">logical< / span > < span
class="cmtt-12">,< / span > < span
class="cmtt-12">  < / span > < span
class="cmtt-12">optional< / span > < span
class="cmr-12">.< / span > < / td >
class="cmr-12">.< / span > < / td >
< / tr > < tr
< / tr > < tr
style="vertical-align:baseline;" id="TBL-19 -2-">< td style = "white-space:normal; text-align:left;" id = "TBL- 19 -2-1"
style="vertical-align:baseline;" id="TBL-20-2-">< td style = "white-space:normal; text-align:left;" id = "TBL-20-2-1"
class="td11"><!-- l. 956 --> < p class = "noindent" > < / td > < td style = "white-space:normal; text-align:left;" id = "TBL- 19 -2-2"
class="td11"> <!-- l. 979 --> < p class = "noindent" > < / td > < td style = "white-space:normal; text-align:left;" id = "TBL-20-2-2"
class="td11"><!-- l. 956 --> < p class = "noindent" > < span
class="td11"> <!-- l. 979 --> < p class = "noindent" > < span
class="cmr-12">Whether the global or local preconditioner memory occupation is< / span >
class="cmr-12">Whether the global or local preconditioner memory occupation is< / span >
< span
< span
class="cmr-12">desired. Default: < / span > < span class = "lstinline" > < / span > < span
class="cmr-12">desired. Default: < / span > < code class = "lstinline" > < span style = "color:#000000" > .< / span > < span style = "color:#000000" > false< / span > < span style = "color:#000000" > .< / span > < / code > < span
class="cmtt-12">.< / span > < span
class="cmtt-12">false< / span > < span
class="cmtt-12">.< / span > < span
class="cmr-12">.< / span > < / td >
class="cmr-12">.< / span > < / td >
< / tr > < tr
< / tr > < tr
style="vertical-align:baseline;" id="TBL-19 -3-">< td style = "white-space:normal; text-align:left;" id = "TBL- 19 -3-1"
style="vertical-align:baseline;" id="TBL-20-3-">< td style = "white-space:normal; text-align:left;" id = "TBL-20-3-1"
class="td11"> < / td > < / tr > < / table >
class="td11"> < / td > < / tr > < / table > < / div >
< / div > < span
< span
class="cmr-12">Return memory footprint in bytes.< / span >
class="cmr-12">Return memory footprint in bytes.< / span >
<!-- l. 9 63 --> < p class = "noindent" >
<!-- l. 9 8 6--> < p class = "noindent" >
< h5 class = "subsubsectionHead" > < span class = "titlemark" > < span
< h5 class = "subsubsectionHead" > < span class = "titlemark" > < span
class="cmr-12">5.9.4 < / span > < / span > < a
class="cmr-12">5.9.4 < / span > < / span > < a
id="x26-290005.9.4">< / a > < span
id="x26-290005.9.4">< / a > < span
@ -280,21 +184,10 @@ class="cmr-12">Method: allocate</span><span
class="cmr-12">_wrk< / span > < / h5 >
class="cmr-12">_wrk< / span > < / h5 >
< div class = "center"
< div class = "center"
>
>
<!-- l. 965 --> < p class = "noindent" >
<!-- l. 988 --> < p class = "noindent" >
<!-- l. 966 --> < p class = "noindent" > < span class = "lstinline" > < / span > < span
<!-- l. 989 --> < p class = "noindent" > < code class = "lstinline" > < span style = "color:#000000" > call< / span > < span style = "color:#000000" > < / span > < span style = "color:#000000" > p< / span > < span style = "color:#000000" > %< / span > < span style = "color:#000000" > allocate_wrk< / span > < span style = "color:#000000" > (< / span > < span style = "color:#000000" > info< / span > < span style = "color:#000000" > [,< / span > < span style = "color:#000000" > < / span > < span style = "color:#000000" > vmold< / span > < span style = "color:#000000" > ])< / span > < / code > < br / >
class="cmtt-12">call< / span > < span
class="cmtt-12">  < / span > < span
class="cmtt-12">p< / span > < span
class="cmtt-12">%< / span > < span
class="cmtt-12">allocate_wrk< / span > < span
class="cmtt-12">(< / span > < span
class="cmtt-12">info< / span > < span
class="cmtt-12">[,< / span > < span
class="cmtt-12">  < / span > < span
class="cmtt-12">vmold< / span > < span
class="cmtt-12">])< / span > < br / >
< / div >
< / div >
<!-- l. 9 6 9--> < p class = "noindent" > < span
<!-- l. 992 --> < p class = "noindent" > < span
class="cmr-12">Allocate internal work vectors. Each application of the preconditioner uses a number of< / span >
class="cmr-12">Allocate internal work vectors. Each application of the preconditioner uses a number of< / span >
< span
< span
class="cmr-12">work vectors which are allocated internally as necessary; therefore allocation and< / span >
class="cmr-12">work vectors which are allocated internally as necessary; therefore allocation and< / span >
@ -308,82 +201,58 @@ class="cmr-12">notably GPUs, memory allocation is a slow operation, and the defa
class="cmr-12">lead to a slowdown. This method allows to trade space for time by preallocating< / span >
class="cmr-12">lead to a slowdown. This method allows to trade space for time by preallocating< / span >
< span
< span
class="cmr-12">the internal workspace outside of the invocation of a Krylov method. When< / span >
class="cmr-12">the internal workspace outside of the invocation of a Krylov method. When< / span >
< span
class="cmr-12">using GPUs or other specialized devices, the < / span > < code class = "lstinline" > < span style = "color:#000000" > vmold< / span > < / code > < span
class="cmr-12">argument is also necessary< / span >
< span
class="cmr-12">using GPUs or other specialized devices, the < / span > < span class = "lstinline" > < / span > < span
class="cmtt-12">vmold< / span > < span
class="cmr-12">argument is also necessary< / span >
< span
< span
class="cmr-12">to ensure the internal work vectors are of the appropriate dynamic type to< / span >
class="cmr-12">to ensure the internal work vectors are of the appropriate dynamic type to< / span >
< span
< span
class="cmr-12">exploit the accelerator hardware; when allocation occurs internally this is< / span >
class="cmr-12">exploit the accelerator hardware; when allocation occurs internally this is< / span >
< span
< span
class="cmr-12">taken care of based on the dynamic type of the < / span > < span class = "lstinline" > < / span > < span
class="cmr-12">taken care of based on the dynamic type of the < / span > < code class = "lstinline" > < span style = "color:#000000" > x< / span > < / code > < span
class="cmtt-12">x< / span > < span
class="cmr-12">argument to the < / span > < code class = "lstinline" > < span style = "color:#000000" > apply< / span > < / code >
class="cmr-12">argument to the < / span > < span class = "lstinline" > < / span > < span
class="cmtt-12">apply< / span >
< span
< span
class="cmr-12">method.< / span >
class="cmr-12">method.< / span >
<!-- l. 985 --> < p class = "noindent" > < span
<!-- l. 1008 --> < p class = "noindent" > < span
class="cmbx-12">Arguments< / span >
class="cmbx-12">Arguments< / span >
< div class = "tabular" > < table id = "TBL-20" class = "tabular"
< div class = "tabular" > < table id = "TBL-21" class = "tabular"
cellspacing="0" cellpadding="0"
>< colgroup id = "TBL-20-1g" > < col
>< colgroup id = "TBL-21-1g" > < col
id="TBL-20-1">< col
id="TBL-21-1">< col
id="TBL-20-2">< / colgroup > < tr
id="TBL-21-2">< / colgroup > < tr
style="vertical-align:baseline;" id="TBL-20-1-">< td style = "white-space:normal; text-align:left;" id = "TBL-20-1-1"
style="vertical-align:baseline;" id="TBL-21-1-">< td style = "white-space:normal; text-align:left;" id = "TBL-21-1-1"
class="td11"><!-- l. 988 --> < p class = "noindent" > < span class = "lstinline" > < / span > < span
class="td11"> <!-- l. 1011 --> < p class = "noindent" > < code class = "lstinline" > < span style = "color:#000000" > info< / span > < / code > < / td > < td style = "white-space:normal; text-align:left;" id = "TBL-21-1-2"
class="cmtt-12">info< / span > < / td > < td style = "white-space:normal; text-align:left;" id = "TBL-20-1-2"
class="td11"> <!-- l. 1011 --> < p class = "noindent" > < code class = "lstinline" > < span style = "color:#000000" > integer< / span > < span style = "color:#000000" > ,< / span > < span style = "color:#000000" > < / span > < span style = "color:#000000" > intent< / span > < span style = "color:#000000" > (< / span > < span style = "color:#000000" > out< / span > < span style = "color:#000000" > )< / span > < / code > < span
class="td11"><!-- l. 988 --> < p class = "noindent" > < span class = "lstinline" > < / span > < span
class="cmtt-12">integer< / span > < span
class="cmtt-12">,< / span > < span
class="cmtt-12">  < / span > < span
class="cmtt-12">intent< / span > < span
class="cmtt-12">(< / span > < span
class="cmtt-12">out< / span > < span
class="cmtt-12">)< / span > < span
class="cmr-12">.< / span > < / td >
class="cmr-12">.< / span > < / td >
< / tr > < tr
< / tr > < tr
style="vertical-align:baseline;" id="TBL-20 -2-">< td style = "white-space:normal; text-align:left;" id = "TBL-2 0 -2-1"
style="vertical-align:baseline;" id="TBL-21-2-">< td style = "white-space:normal; text-align:left;" id = "TBL-21-2-1"
class="td11"><!-- l. 989 --> < p class = "noindent" > < / td > < td style = "white-space:normal; text-align:left;" id = "TBL-2 0 -2-2"
class="td11"> <!-- l. 1012 --> < p class = "noindent" > < / td > < td style = "white-space:normal; text-align:left;" id = "TBL-21-2-2"
class="td11"><!-- l. 989 --> < p class = "noindent" > < span
class="td11"> <!-- l. 1012 --> < p class = "noindent" > < span
class="cmr-12">Error code. If no error, 0 is returned. See Section< / span > < span
class="cmr-12">Error code. If no error, 0 is returned. See Section< / span > < span
class="cmr-12">  < / span > < a
class="cmr-12">  < / span > < a
href="userhtmlse7.html#x28-320007">< span
href="userhtmlse7.html#x28-320007">< span
class="cmr-12">7< / span > <!-- tex4ht:ref: sec:errors --> < / a > < span
class="cmr-12">7< / span > <!-- tex4ht:ref: sec:errors --> < / a > < span
class="cmr-12">for details.< / span > < / td >
class="cmr-12">for details.< / span > < / td >
< / tr > < tr
< / tr > < tr
style="vertical-align:baseline;" id="TBL-20-3-">< td style = "white-space:normal; text-align:left;" id = "TBL-20-3-1"
style="vertical-align:baseline;" id="TBL-21-3-">< td style = "white-space:normal; text-align:left;" id = "TBL-21-3-1"
class="td11"><!-- l. 990 --> < p class = "noindent" > < span class = "lstinline" > < / span > < span
class="td11"> <!-- l. 1013 --> < p class = "noindent" > < code class = "lstinline" > < span style = "color:#000000" > vmold< / span > < / code > < / td > < td style = "white-space:normal; text-align:left;" id = "TBL-21-3-2"
class="cmtt-12">vmold< / span > < / td > < td style = "white-space:normal; text-align:left;" id = "TBL-20-3-2"
class="td11"> <!-- l. 1013 --> < p class = "noindent" > < code class = "lstinline" > < span style = "color:#000000" > class< / span > < span style = "color:#000000" > (< / span > < span style = "color:#000000" > psb_< / span > < / code > < span
class="td11"><!-- l. 990 --> < p class = "noindent" > < span class = "lstinline" > < / span > < span
class="cmti-12">x< / span > < code class = "lstinline" > < span style = "color:#000000" > _base_vect_type< / span > < span style = "color:#000000" > ),< / span > < span style = "color:#000000" > < / span > < span style = "color:#000000" > intent< / span > < span style = "color:#000000" > (< / span > < span style = "color:#000000" > in< / span > < span style = "color:#000000" > ),< / span > < span style = "color:#000000" > < / span > < span style = "color:#000000" > optional< / span > < / code > < span
class="cmtt-12">class< / span > < span
class="cmtt-12">(< / span > < span
class="cmtt-12">psb_< / span > < span
class="cmti-12">x< / span > < span class = "lstinline" > < / span > < span
class="cmtt-12">_base_vect_type< / span > < span
class="cmtt-12">),< / span > < span
class="cmtt-12">  < / span > < span
class="cmtt-12">intent< / span > < span
class="cmtt-12">(< / span > < span
class="cmtt-12">in< / span > < span
class="cmtt-12">),< / span > < span
class="cmtt-12">  < / span > < span
class="cmtt-12">optional< / span > < span
class="cmr-12">.< / span > < / td >
class="cmr-12">.< / span > < / td >
< / tr > < tr
< / tr > < tr
style="vertical-align:baseline;" id="TBL-20 -4-">< td style = "white-space:normal; text-align:left;" id = "TBL-2 0 -4-1"
style="vertical-align:baseline;" id="TBL-21-4-">< td style = "white-space:normal; text-align:left;" id = "TBL-21-4-1"
class="td11"><!-- l. 991 --> < p class = "noindent" > < / td > < td style = "white-space:normal; text-align:left;" id = "TBL-2 0 -4-2"
class="td11"> <!-- l. 1014 --> < p class = "noindent" > < / td > < td style = "white-space:normal; text-align:left;" id = "TBL-21-4-2"
class="td11"><!-- l. 991 --> < p class = "noindent" > < span
class="td11"> <!-- l. 1014 --> < p class = "noindent" > < span
class="cmr-12">The desired dynamic type for internal vector components; this< / span >
class="cmr-12">The desired dynamic type for internal vector components; this< / span >
< span
< span
class="cmr-12">allows e.g. running on GPUs.< / span > < / td >
class="cmr-12">allows e.g. running on GPUs.< / span > < / td >
< / tr > < tr
< / tr > < tr
style="vertical-align:baseline;" id="TBL-20 -5-">< td style = "white-space:normal; text-align:left;" id = "TBL-2 0 -5-1"
style="vertical-align:baseline;" id="TBL-21-5-">< td style = "white-space:normal; text-align:left;" id = "TBL-21-5-1"
class="td11"> < / td > < / tr > < / table > < / div >
class="td11"> < / td > < / tr > < / table > < / div >
<!-- l. 997 --> < p class = "noindent" >
<!-- l. 1020 --> < p class = "noindent" >
< h5 class = "subsubsectionHead" > < span class = "titlemark" > < span
< h5 class = "subsubsectionHead" > < span class = "titlemark" > < span
class="cmr-12">5.9.5 < / span > < / span > < a
class="cmr-12">5.9.5 < / span > < / span > < a
id="x26-300005.9.5">< / a > < span
id="x26-300005.9.5">< / a > < span
@ -391,49 +260,33 @@ class="cmr-12">Method: free</span><span
class="cmr-12">_wrk< / span > < / h5 >
class="cmr-12">_wrk< / span > < / h5 >
< div class = "center"
< div class = "center"
>
>
<!-- l. 999 --> < p class = "noindent" >
<!-- l. 1022 --> < p class = "noindent" >
<!-- l. 1000 --> < p class = "noindent" > < span class = "lstinline" > < / span > < span
<!-- l. 1023 --> < p class = "noindent" > < code class = "lstinline" > < span style = "color:#000000" > call< / span > < span style = "color:#000000" > < / span > < span style = "color:#000000" > p< / span > < span style = "color:#000000" > %< / span > < span style = "color:#000000" > free_wrk< / span > < span style = "color:#000000" > (< / span > < span style = "color:#000000" > info< / span > < span style = "color:#000000" > )< / span > < / code > < br / >
class="cmtt-12">call< / span > < span
class="cmtt-12">  < / span > < span
class="cmtt-12">p< / span > < span
class="cmtt-12">%< / span > < span
class="cmtt-12">free_wrk< / span > < span
class="cmtt-12">(< / span > < span
class="cmtt-12">info< / span > < span
class="cmtt-12">)< / span > < br / >
< / div >
< / div >
<!-- l. 10 03 --> < p class = "noindent" > < span
<!-- l. 1026 --> < p class = "noindent" > < span
class="cmr-12">Deallocate internal work vectors.< / span >
class="cmr-12">Deallocate internal work vectors.< / span >
<!-- l. 10 06 --> < p class = "noindent" > < span
<!-- l. 1029 --> < p class = "noindent" > < span
class="cmbx-12">Arguments< / span >
class="cmbx-12">Arguments< / span >
< div class = "tabular" > < table id = "TBL-21" class = "tabular"
< div class = "tabular" > < table id = "TBL-22" class = "tabular"
cellspacing="0" cellpadding="0"
>< colgroup id = "TBL-21-1g" > < col
>< colgroup id = "TBL-22-1g" > < col
id="TBL-21-1">< col
id="TBL-22-1">< col
id="TBL-21-2">< / colgroup > < tr
id="TBL-22-2">< / colgroup > < tr
style="vertical-align:baseline;" id="TBL-21-1-">< td style = "white-space:normal; text-align:left;" id = "TBL-21-1-1"
style="vertical-align:baseline;" id="TBL-22-1-">< td style = "white-space:normal; text-align:left;" id = "TBL-22-1-1"
class="td11"><!-- l. 1009 --> < p class = "noindent" > < span class = "lstinline" > < / span > < span
class="td11"> <!-- l. 1032 --> < p class = "noindent" > < code class = "lstinline" > < span style = "color:#000000" > info< / span > < / code > < / td > < td style = "white-space:normal; text-align:left;" id = "TBL-22-1-2"
class="cmtt-12">info< / span > < / td > < td style = "white-space:normal; text-align:left;" id = "TBL-21-1-2"
class="td11"> <!-- l. 1032 --> < p class = "noindent" > < code class = "lstinline" > < span style = "color:#000000" > integer< / span > < span style = "color:#000000" > ,< / span > < span style = "color:#000000" > < / span > < span style = "color:#000000" > intent< / span > < span style = "color:#000000" > (< / span > < span style = "color:#000000" > out< / span > < span style = "color:#000000" > )< / span > < / code > < span
class="td11"><!-- l. 1009 --> < p class = "noindent" > < span class = "lstinline" > < / span > < span
class="cmtt-12">integer< / span > < span
class="cmtt-12">,< / span > < span
class="cmtt-12">  < / span > < span
class="cmtt-12">intent< / span > < span
class="cmtt-12">(< / span > < span
class="cmtt-12">out< / span > < span
class="cmtt-12">)< / span > < span
class="cmr-12">.< / span > < / td >
class="cmr-12">.< / span > < / td >
< / tr > < tr
< / tr > < tr
style="vertical-align:baseline;" id="TBL-21 -2-">< td style = "white-space:normal; text-align:left;" id = "TBL-2 1 -2-1"
style="vertical-align:baseline;" id="TBL-22-2-">< td style = "white-space:normal; text-align:left;" id = "TBL-22-2-1"
class="td11"><!-- l. 1010 --> < p class = "noindent" > < / td > < td style = "white-space:normal; text-align:left;" id = "TBL-2 1 -2-2"
class="td11"> <!-- l. 1033 --> < p class = "noindent" > < / td > < td style = "white-space:normal; text-align:left;" id = "TBL-22-2-2"
class="td11"><!-- l. 1010 --> < p class = "noindent" > < span
class="td11"> <!-- l. 1033 --> < p class = "noindent" > < span
class="cmr-12">Error code. If no error, 0 is returned. See Section< / span > < span
class="cmr-12">Error code. If no error, 0 is returned. See Section< / span > < span
class="cmr-12">  < / span > < a
class="cmr-12">  < / span > < a
href="userhtmlse7.html#x28-320007">< span
href="userhtmlse7.html#x28-320007">< span
class="cmr-12">7< / span > <!-- tex4ht:ref: sec:errors --> < / a > < span
class="cmr-12">7< / span > <!-- tex4ht:ref: sec:errors --> < / a > < span
class="cmr-12">for details.< / span > < / td >
class="cmr-12">for details.< / span > < / td >
< / tr > < tr
< / tr > < tr
style="vertical-align:baseline;" id="TBL-21 -3-">< td style = "white-space:normal; text-align:left;" id = "TBL-2 1 -3-1"
style="vertical-align:baseline;" id="TBL-22 -3-">< td style = "white-space:normal; text-align:left;" id = "TBL-2 2 -3-1"
class="td11"> < / td > < / tr > < / table > < / div >
class="td11"> < / td > < / tr > < / table > < / div >
@ -444,6 +297,9 @@ class="td11"> </td> </tr></table></div>
<!-- l. 4 --> < div class = "crosslinks" > < p class = "noindent" > < span
<!-- l. 4 --> < div class = "crosslinks" > < p class = "noindent" > < span
class="cmr-12">[< / span > < a
class="cmr-12">[< / span > < a
href="userhtmlsu15.html" >< span
href="userhtmlsu15.html" >< span