Docs and krylov->linsolve changes

This commit is contained in:
Salvatore Filippone
2024-11-16 10:50:31 +01:00
parent ef1cc4b321
commit eefc67bbdd
19 changed files with 6466 additions and 6359 deletions
+29 -28
View File
@@ -2559,17 +2559,17 @@ Scaling or Block Jacobi with incomplete factorization ILU(0).
<!--l. 1319--><p class="indent" > A preconditioner is held in the <a
id="precdata"></a><span
class="cmtt-10">psb</span><span
class="cmtt-10">_prec</span><span
class="cmtt-10">_Tprec</span><span
class="cmtt-10">_type </span>data structure reported in
figure&#x00A0;<a
href="#x8-53001r4">4<!--tex4ht:ref: fig:prectype --></a>. The <code class="lstinline"><span style="color:#000000">psb_prec_type</span></code> data type may contain a simple preconditioning matrix
with the associated communication descriptor.The internal preconditioner is
href="#x8-53001r4">4<!--tex4ht:ref: fig:prectype --></a>. The <code class="lstinline"><span style="color:#000000">psb_Tprec_type</span></code> data type may contain a simple preconditioning
matrix with the associated communication descriptor. The internal preconditioner is
allocated appropriately with the dynamic type corresponding to the desired
preconditioner.
<!--l. 1337--><p class="indent" > <a
<!--l. 1338--><p class="indent" > <a
id="x8-53001r4"></a><hr class="float"><div class="float"
>
@@ -2577,7 +2577,7 @@ preconditioner.
<div class="center"
>
<!--l. 1347--><p class="noindent" >
<!--l. 1348--><p class="noindent" >
<div class="minipage"><pre class="verbatim" id="verbatim-30">
&#x00A0;&#x00A0;type&#x00A0;psb_Tprec_type
@@ -2585,7 +2585,7 @@ preconditioner.
&#x00A0;&#x00A0;end&#x00A0;type&#x00A0;psb_Tprec_type
</pre>
<!--l. 1355--><p class="nopar" > </div></div>
<!--l. 1356--><p class="nopar" > </div></div>
<br /> <div class="caption"
><span class="id">Listing 4: </span><span
class="content">The PSBLAS defined data type that contains a preconditioner.</span></div><!--tex4ht:label?: x8-53001r4 -->
@@ -2595,70 +2595,71 @@ class="content">The PSBLAS defined data type that contains a preconditioner.</sp
</div><hr class="endfloat" />
<h4 class="subsectionHead"><span class="titlemark">3.5 </span> <a
id="x8-540003.5"></a>Heap data structure</h4>
<!--l. 1391--><p class="noindent" >Among the tools routines of sec.&#x00A0;<a
<!--l. 1392--><p class="noindent" >Among the tools routines of sec.&#x00A0;<a
href="userhtmlse6.html#x11-770006">6<!--tex4ht:ref: sec:toolsrout --></a>, we have a number of sorting utilities; the heap
sort is implemented in terms of heaps having the following signatures:
<dl class="description"><dt class="description">
<!--l. 1395--><p class="noindent" >
<!--l. 1396--><p class="noindent" >
<span
class="cmtt-10">psb</span><span
class="cmtt-10">_T</span><span
class="cmtt-10">_heap</span> </dt><dd
class="description">
<!--l. 1395--><p class="noindent" >: a heap containing elements of type T, where T can be <code class="lstinline"><span style="color:#000000">i</span><span style="color:#000000">,</span><span style="color:#000000">s</span><span style="color:#000000">,</span><span style="color:#000000">c</span><span style="color:#000000">,</span><span style="color:#000000">d</span><span style="color:#000000">,</span><span style="color:#000000">z</span></code> for
<!--l. 1396--><p class="noindent" >: a heap containing elements of type T, where T can be <code class="lstinline"><span style="color:#000000">i</span><span style="color:#000000">,</span><span style="color:#000000">s</span><span style="color:#000000">,</span><span style="color:#000000">c</span><span style="color:#000000">,</span><span style="color:#000000">d</span><span style="color:#000000">,</span><span style="color:#000000">z</span></code> for
integer, real and complex data;
</dd><dt class="description">
<!--l. 1397--><p class="noindent" >
<!--l. 1398--><p class="noindent" >
<span
class="cmtt-10">psb</span><span
class="cmtt-10">_T</span><span
class="cmtt-10">_idx</span><span
class="cmtt-10">_heap</span> </dt><dd
class="description">
<!--l. 1397--><p class="noindent" >: a heap containing elements of type T, as above, together with an integer
<!--l. 1398--><p class="noindent" >: a heap containing elements of type T, as above, together with an integer
index.</dd></dl>
<!--l. 1400--><p class="noindent" >Given a heap object, the following methods are defined on it:
<!--l. 1401--><p class="noindent" >Given a heap object, the following methods are defined on it:
<dl class="description"><dt class="description">
<!--l. 1402--><p class="noindent" >
<!--l. 1403--><p class="noindent" >
<span
class="cmbx-10">init</span> </dt><dd
class="description">
<!--l. 1402--><p class="noindent" >Initialize memory; also choose ascending or descending order;
</dd><dt class="description">
<!--l. 1404--><p class="noindent" >
<span
class="cmbx-10">howmany</span> </dt><dd
class="description">
<!--l. 1404--><p class="noindent" >Current heap occupancy;
<!--l. 1403--><p class="noindent" >Initialize memory; also choose ascending or descending order;
</dd><dt class="description">
<!--l. 1405--><p class="noindent" >
<span
class="cmbx-10">insert</span> </dt><dd
class="cmbx-10">howmany</span> </dt><dd
class="description">
<!--l. 1405--><p class="noindent" >Add an item (or an item and its index);
<!--l. 1405--><p class="noindent" >Current heap occupancy;
</dd><dt class="description">
<!--l. 1406--><p class="noindent" >
<span
class="cmbx-10">insert</span> </dt><dd
class="description">
<!--l. 1406--><p class="noindent" >Add an item (or an item and its index);
</dd><dt class="description">
<!--l. 1407--><p class="noindent" >
<span
class="cmbx-10">get</span><span
class="cmbx-10">_first</span> </dt><dd
class="description">
<!--l. 1406--><p class="noindent" >Remove and return the first element;
<!--l. 1407--><p class="noindent" >Remove and return the first element;
</dd><dt class="description">
<!--l. 1407--><p class="noindent" >
<!--l. 1408--><p class="noindent" >
<span
class="cmbx-10">dump</span> </dt><dd
class="description">
<!--l. 1407--><p class="noindent" >Print on file;
<!--l. 1408--><p class="noindent" >Print on file;
</dd><dt class="description">
<!--l. 1408--><p class="noindent" >
<!--l. 1409--><p class="noindent" >
<span
class="cmbx-10">free</span> </dt><dd
class="description">
<!--l. 1408--><p class="noindent" >Release memory.</dd></dl>
<!--l. 1410--><p class="noindent" >These objects are used in AMG4PSBLAS to implement the factorization algorithms.
<!--l. 1409--><p class="noindent" >Release memory.</dd></dl>
<!--l. 1411--><p class="noindent" >These objects are used to implement the factorization and approximate inversion
algorithms.