mirror of
https://github.com/sfilippone/psblas3.git
synced 2026-10-20 12:52:14 +00:00
Update docs. Bump 3.8 version.
This commit is contained in:
@@ -136,9 +136,9 @@ module psb_const_mod
|
||||
!
|
||||
! Version
|
||||
!
|
||||
character(len=*), parameter :: psb_version_string_ = "3.7.0"
|
||||
character(len=*), parameter :: psb_version_string_ = "3.8.0"
|
||||
integer(psb_ipk_), parameter :: psb_version_major_ = 3
|
||||
integer(psb_ipk_), parameter :: psb_version_minor_ = 7
|
||||
integer(psb_ipk_), parameter :: psb_version_minor_ = 8
|
||||
integer(psb_ipk_), parameter :: psb_patchlevel_ = 0
|
||||
|
||||
!
|
||||
|
||||
@@ -20,8 +20,8 @@ class="newline" /> <span
|
||||
class="cmbx-10">Salvatore Filippone</span><br
|
||||
class="newline" /><span
|
||||
class="cmbx-10">Alfredo Buttari </span><br
|
||||
class="newline" />Software version: 3.7.0.1<br
|
||||
class="newline" />Feb 14th, 2022
|
||||
class="newline" />Software version: 3.8.0<br
|
||||
class="newline" />May 1st, 2022
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -20,8 +20,8 @@ class="newline" /> <span
|
||||
class="cmbx-10">Salvatore Filippone</span><br
|
||||
class="newline" /><span
|
||||
class="cmbx-10">Alfredo Buttari </span><br
|
||||
class="newline" />Software version: 3.7.0.1<br
|
||||
class="newline" />Feb 14th, 2022
|
||||
class="newline" />Software version: 3.8.0<br
|
||||
class="newline" />May 1st, 2022
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -145,8 +145,9 @@ class="cmmi-10">nnz </span>in the
|
||||
multiple) data reallocations;
|
||||
</li>
|
||||
<li
|
||||
class="enumerate" id="x47-84008x4">Using <span class="obeylines-h"><span class="verb"><span
|
||||
class="cmtt-10">psb_matbld_remote_</span></span></span> will cause an overhead at assembly time;</li></ol>
|
||||
class="enumerate" id="x47-84008x4">Using <span class="obeylines-h"><span class="verb"><span
|
||||
class="cmtt-10">psb_matbld_remote_</span></span></span> is likely to cause a runtime overhead at
|
||||
assembly time;</li></ol>
|
||||
|
||||
|
||||
|
||||
|
||||
+12
-10
@@ -234,14 +234,11 @@ class="cmmi-10">,ja</span>(<span
|
||||
class="cmmi-10">i</span>)<span
|
||||
class="cmmi-10">,val</span>(<span
|
||||
class="cmmi-10">i</span>), for <span
|
||||
class="cmmi-10">i </span>= 1<span
|
||||
class="cmmi-10">i </span>= 1<span
|
||||
class="cmmi-10">,</span><span
|
||||
class="cmmi-10">…</span><span
|
||||
class="cmmi-10">,nz</span>; these triples should
|
||||
belong to the current process, i.e. <span
|
||||
class="cmmi-10">ia</span>(<span
|
||||
class="cmmi-10">i</span>) should be one of the local indices,
|
||||
but are otherwise arbitrary;
|
||||
class="cmmi-10">,nz</span>; these triples are
|
||||
arbitrary;
|
||||
</li>
|
||||
<li
|
||||
class="enumerate" id="x48-85012x6">In CSR format the coefficients to be inserted for each input row <span
|
||||
@@ -280,8 +277,13 @@ class="cmsy-10">-</span>1 should be one of the local indices, but are otherwise
|
||||
call, according to the application needs;
|
||||
</li>
|
||||
<li
|
||||
class="enumerate" id="x48-85018x9">Any coefficients from matrix rows not owned by the calling process are
|
||||
silently ignored;
|
||||
class="enumerate" id="x48-85018x9">Coefficients from matrix rows not owned by the calling process are
|
||||
treated according to the value of <span class="obeylines-h"><span class="verb"><span
|
||||
class="cmtt-10">buildmode</span></span></span> specified at allocation time; if
|
||||
<span class="obeylines-h"><span class="verb"><span
|
||||
class="cmtt-10">buildmode</span></span></span> was chosen as <span class="obeylines-h"><span class="verb"><span
|
||||
class="cmtt-10">psb_matbld_remote_</span></span></span> the library will keep track
|
||||
of them, otherwise they are silently ignored;
|
||||
|
||||
|
||||
|
||||
@@ -300,12 +302,12 @@ class="cmsy-10">-</span>1 should be one of the local indices, but are otherwise
|
||||
|
||||
|
||||
|
||||
<!--l. 739--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 741--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu41.html" >next</a>] [<a
|
||||
href="userhtmlsu36.html" >prev</a>] [<a
|
||||
href="userhtmlsu36.html#tailuserhtmlsu36.html" >prev-tail</a>] [<a
|
||||
href="userhtmlsu37.html" >front</a>] [<a
|
||||
href="userhtmlsu32.html#userhtmlsu40.html" >up</a>] </p></div>
|
||||
<!--l. 739--><p class="indent" > <a
|
||||
<!--l. 741--><p class="indent" > <a
|
||||
id="tailuserhtmlsu37.html"></a>
|
||||
</body></html>
|
||||
|
||||
+13
-12
@@ -10,7 +10,7 @@
|
||||
<link rel="stylesheet" type="text/css" href="userhtml.css">
|
||||
</head><body
|
||||
>
|
||||
<!--l. 739--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 741--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu42.html" >next</a>] [<a
|
||||
href="userhtmlsu37.html" >prev</a>] [<a
|
||||
href="userhtmlsu37.html#tailuserhtmlsu37.html" >prev-tail</a>] [<a
|
||||
@@ -22,10 +22,10 @@ href="userhtmlsu32.html#userhtmlsu41.html" >up</a>] </p></div>
|
||||
|
||||
|
||||
<pre class="verbatim" id="verbatim-42">
|
||||
call psb_spasb(a, desc_a, info, afmt, upd,  mold)
|
||||
call psb_spasb(a, desc_a, info [, afmt, upd,  mold])
|
||||
</pre>
|
||||
<!--l. 743--><p class="nopar" >
|
||||
<!--l. 745--><p class="indent" >
|
||||
<!--l. 745--><p class="nopar" >
|
||||
<!--l. 747--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">Type:</span> </dt><dd
|
||||
@@ -91,7 +91,7 @@ class="cmtt-10">_T</span><span
|
||||
class="cmtt-10">_base</span><span
|
||||
class="cmtt-10">_sparse</span><span
|
||||
class="cmtt-10">_mat</span>.</dd></dl>
|
||||
<!--l. 770--><p class="indent" >
|
||||
<!--l. 772--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">On Return</span> </dt><dd
|
||||
@@ -144,7 +144,7 @@ class="cmbx-10">required </span><br
|
||||
class="newline" />Intent: <span
|
||||
class="cmbx-10">out</span>.<br
|
||||
class="newline" />An integer value; 0 means no error has been detected.</dd></dl>
|
||||
<!--l. 791--><p class="noindent" ><span
|
||||
<!--l. 793--><p class="noindent" ><span
|
||||
class="cmbx-12">Notes</span>
|
||||
<ol class="enumerate1" >
|
||||
<li
|
||||
@@ -178,22 +178,23 @@ class="cmtt-10">psb_spins</span></span></span>
|
||||
class="enumerate" id="x49-86014x7">If the <span class="obeylines-h"><span class="verb"><span
|
||||
class="cmtt-10">buildmode=psb_matbld_remote_</span></span></span> value was specified at allocation
|
||||
time, contributions defined on the current process but belonging to a
|
||||
remote process will be handled accordingly. This is most likely to occur
|
||||
in finite element applications, with <span class="obeylines-h"><span class="verb"><span
|
||||
class="cmtt-10">dupl=psb_dupl_add_</span></span></span>; note that the
|
||||
descriptor will be updated, and there will be a runtime overhead.</li></ol>
|
||||
remote process will be handled accordingly. This is most likely to occur in
|
||||
finite element applications, with <span class="obeylines-h"><span class="verb"><span
|
||||
class="cmtt-10">dupl=psb_dupl_add_</span></span></span>; it is necessary to
|
||||
check for possible updates needed in the descriptor, hence there will be a
|
||||
runtime overhead.</li></ol>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<!--l. 854--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 857--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu42.html" >next</a>] [<a
|
||||
href="userhtmlsu37.html" >prev</a>] [<a
|
||||
href="userhtmlsu37.html#tailuserhtmlsu37.html" >prev-tail</a>] [<a
|
||||
href="userhtmlsu38.html" >front</a>] [<a
|
||||
href="userhtmlsu32.html#userhtmlsu41.html" >up</a>] </p></div>
|
||||
<!--l. 854--><p class="indent" > <a
|
||||
<!--l. 857--><p class="indent" > <a
|
||||
id="tailuserhtmlsu38.html"></a>
|
||||
</body></html>
|
||||
|
||||
@@ -10,7 +10,7 @@
|
||||
<link rel="stylesheet" type="text/css" href="userhtml.css">
|
||||
</head><body
|
||||
>
|
||||
<!--l. 854--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 857--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu43.html" >next</a>] [<a
|
||||
href="userhtmlsu38.html" >prev</a>] [<a
|
||||
href="userhtmlsu38.html#tailuserhtmlsu38.html" >prev-tail</a>] [<a
|
||||
@@ -24,8 +24,8 @@ href="userhtmlsu32.html#userhtmlsu42.html" >up</a>] </p></div>
|
||||
<pre class="verbatim" id="verbatim-43">
|
||||
call psb_spfree(a, desc_a, info)
|
||||
</pre>
|
||||
<!--l. 858--><p class="nopar" >
|
||||
<!--l. 860--><p class="indent" >
|
||||
<!--l. 861--><p class="nopar" >
|
||||
<!--l. 863--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">Type:</span> </dt><dd
|
||||
@@ -65,7 +65,7 @@ href="userhtmlsu5.html#descdata"><span
|
||||
class="cmtt-10">psb</span><span
|
||||
class="cmtt-10">_desc</span><span
|
||||
class="cmtt-10">_type</span></a>.</dd></dl>
|
||||
<!--l. 875--><p class="indent" >
|
||||
<!--l. 878--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">On Return</span> </dt><dd
|
||||
@@ -87,12 +87,12 @@ class="newline" />An integer value; 0 means no error has been detected.</dd></dl
|
||||
|
||||
|
||||
|
||||
<!--l. 890--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 893--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu43.html" >next</a>] [<a
|
||||
href="userhtmlsu38.html" >prev</a>] [<a
|
||||
href="userhtmlsu38.html#tailuserhtmlsu38.html" >prev-tail</a>] [<a
|
||||
href="userhtmlsu39.html" >front</a>] [<a
|
||||
href="userhtmlsu32.html#userhtmlsu42.html" >up</a>] </p></div>
|
||||
<!--l. 890--><p class="indent" > <a
|
||||
<!--l. 893--><p class="indent" > <a
|
||||
id="tailuserhtmlsu39.html"></a>
|
||||
</body></html>
|
||||
|
||||
@@ -10,7 +10,7 @@
|
||||
<link rel="stylesheet" type="text/css" href="userhtml.css">
|
||||
</head><body
|
||||
>
|
||||
<!--l. 891--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 894--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu44.html" >next</a>] [<a
|
||||
href="userhtmlsu39.html" >prev</a>] [<a
|
||||
href="userhtmlsu39.html#tailuserhtmlsu39.html" >prev-tail</a>] [<a
|
||||
@@ -24,8 +24,8 @@ href="userhtmlsu32.html#userhtmlsu43.html" >up</a>] </p></div>
|
||||
<pre class="verbatim" id="verbatim-44">
|
||||
call psb_sprn(a, decsc_a, info, clear)
|
||||
</pre>
|
||||
<!--l. 895--><p class="nopar" >
|
||||
<!--l. 897--><p class="indent" >
|
||||
<!--l. 898--><p class="nopar" >
|
||||
<!--l. 900--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">Type:</span> </dt><dd
|
||||
@@ -76,7 +76,7 @@ class="cmbx-10">optional</span>.<br
|
||||
class="newline" />Intent: <span
|
||||
class="cmbx-10">in</span>.<br
|
||||
class="newline" />Default: true.</dd></dl>
|
||||
<!--l. 917--><p class="indent" >
|
||||
<!--l. 920--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">On Return</span> </dt><dd
|
||||
@@ -92,7 +92,7 @@ class="cmbx-10">required </span><br
|
||||
class="newline" />Intent: <span
|
||||
class="cmbx-10">out</span>.<br
|
||||
class="newline" />An integer value; 0 means no error has been detected.</dd></dl>
|
||||
<!--l. 925--><p class="noindent" ><span
|
||||
<!--l. 928--><p class="noindent" ><span
|
||||
class="cmbx-12">Notes</span>
|
||||
<ol class="enumerate1" >
|
||||
<li
|
||||
@@ -103,12 +103,12 @@ class="cmbx-12">Notes</span>
|
||||
|
||||
|
||||
|
||||
<!--l. 978--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 981--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu44.html" >next</a>] [<a
|
||||
href="userhtmlsu39.html" >prev</a>] [<a
|
||||
href="userhtmlsu39.html#tailuserhtmlsu39.html" >prev-tail</a>] [<a
|
||||
href="userhtmlsu40.html" >front</a>] [<a
|
||||
href="userhtmlsu32.html#userhtmlsu43.html" >up</a>] </p></div>
|
||||
<!--l. 978--><p class="indent" > <a
|
||||
<!--l. 981--><p class="indent" > <a
|
||||
id="tailuserhtmlsu40.html"></a>
|
||||
</body></html>
|
||||
|
||||
@@ -10,7 +10,7 @@
|
||||
<link rel="stylesheet" type="text/css" href="userhtml.css">
|
||||
</head><body
|
||||
>
|
||||
<!--l. 978--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 981--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu45.html" >next</a>] [<a
|
||||
href="userhtmlsu40.html" >prev</a>] [<a
|
||||
href="userhtmlsu40.html#tailuserhtmlsu40.html" >prev-tail</a>] [<a
|
||||
@@ -24,8 +24,8 @@ href="userhtmlsu32.html#userhtmlsu44.html" >up</a>] </p></div>
|
||||
<pre class="verbatim" id="verbatim-45">
|
||||
call psb_geall(x, desc_a, info[, dupl, bldmode, n, lb])
|
||||
</pre>
|
||||
<!--l. 983--><p class="nopar" >
|
||||
<!--l. 985--><p class="indent" >
|
||||
<!--l. 986--><p class="nopar" >
|
||||
<!--l. 988--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">Type:</span> </dt><dd
|
||||
@@ -90,9 +90,9 @@ class="newline" />Intent: <span
|
||||
class="cmbx-10">in</span>.<br
|
||||
class="newline" />Specified as: integer, possible values: <span class="obeylines-h"><span class="verb"><span
|
||||
class="cmtt-10">psb_dupl_ovwrt_</span></span></span>, <span class="obeylines-h"><span class="verb"><span
|
||||
class="cmtt-10">psb_dupl_add_</span></span></span>,
|
||||
class="cmtt-10">psb_dupl_add_</span></span></span>;
|
||||
<span class="obeylines-h"><span class="verb"><span
|
||||
class="cmtt-10">psb_dupl_err_</span></span></span>.
|
||||
class="cmtt-10">psb_dupl_err_</span></span></span> has no effect.
|
||||
</dd><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">buildmode</span> </dt><dd
|
||||
@@ -110,7 +110,7 @@ class="cmtt-10">psb_matbld_noremote_</span></span></span>, <span class="obeyline
|
||||
class="cmtt-10">psb_matbld_remote_</span></span></span>. Default:
|
||||
<span class="obeylines-h"><span class="verb"><span
|
||||
class="cmtt-10">psb_matbld_noremote_</span></span></span>.</dd></dl>
|
||||
<!--l. 1020--><p class="indent" >
|
||||
<!--l. 1023--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">On Return</span> </dt><dd
|
||||
@@ -144,18 +144,25 @@ class="cmbx-10">required </span><br
|
||||
class="newline" />Intent: <span
|
||||
class="cmbx-10">out</span>.<br
|
||||
class="newline" />An integer value; 0 means no error has been detected.</dd></dl>
|
||||
<!--l. 1038--><p class="noindent" ><span
|
||||
class="cmbx-12">Notes</span>
|
||||
<ol class="enumerate1" >
|
||||
<li
|
||||
class="enumerate" id="x52-89002x1">Using <span class="obeylines-h"><span class="verb"><span
|
||||
class="cmtt-10">psb_matbld_remote_</span></span></span> is likely to cause a runtime overhead at
|
||||
assembly time;</li></ol>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<!--l. 1039--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 1047--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu45.html" >next</a>] [<a
|
||||
href="userhtmlsu40.html" >prev</a>] [<a
|
||||
href="userhtmlsu40.html#tailuserhtmlsu40.html" >prev-tail</a>] [<a
|
||||
href="userhtmlsu41.html" >front</a>] [<a
|
||||
href="userhtmlsu32.html#userhtmlsu44.html" >up</a>] </p></div>
|
||||
<!--l. 1039--><p class="indent" > <a
|
||||
<!--l. 1047--><p class="indent" > <a
|
||||
id="tailuserhtmlsu41.html"></a>
|
||||
</body></html>
|
||||
|
||||
@@ -10,7 +10,7 @@
|
||||
<link rel="stylesheet" type="text/css" href="userhtml.css">
|
||||
</head><body
|
||||
>
|
||||
<!--l. 1039--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 1047--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu46.html" >next</a>] [<a
|
||||
href="userhtmlsu41.html" >prev</a>] [<a
|
||||
href="userhtmlsu41.html#tailuserhtmlsu41.html" >prev-tail</a>] [<a
|
||||
@@ -24,8 +24,8 @@ href="userhtmlsu32.html#userhtmlsu45.html" >up</a>] </p></div>
|
||||
<pre class="verbatim" id="verbatim-46">
|
||||
call psb_geins(m, irw, val, x, desc_a, info [,local])
|
||||
</pre>
|
||||
<!--l. 1044--><p class="nopar" >
|
||||
<!--l. 1046--><p class="indent" >
|
||||
<!--l. 1052--><p class="nopar" >
|
||||
<!--l. 1054--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">Type:</span> </dt><dd
|
||||
@@ -102,7 +102,7 @@ class="cmbx-10">optional</span>.<br
|
||||
class="newline" />Specified as: a logical value; default: <span class="obeylines-h"><span class="verb"><span
|
||||
class="cmtt-10">.false.</span></span></span>.
|
||||
</dd></dl>
|
||||
<!--l. 1080--><p class="indent" >
|
||||
<!--l. 1088--><p class="indent" >
|
||||
|
||||
|
||||
|
||||
@@ -139,7 +139,7 @@ class="cmbx-10">required </span><br
|
||||
class="newline" />Intent: <span
|
||||
class="cmbx-10">out</span>.<br
|
||||
class="newline" />An integer value; 0 means no error has been detected.</dd></dl>
|
||||
<!--l. 1095--><p class="noindent" ><span
|
||||
<!--l. 1103--><p class="noindent" ><span
|
||||
class="cmbx-12">Notes</span>
|
||||
<ol class="enumerate1" >
|
||||
<li
|
||||
@@ -154,12 +154,12 @@ class="cmbx-12">Notes</span>
|
||||
|
||||
|
||||
|
||||
<!--l. 1106--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 1114--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu46.html" >next</a>] [<a
|
||||
href="userhtmlsu41.html" >prev</a>] [<a
|
||||
href="userhtmlsu41.html#tailuserhtmlsu41.html" >prev-tail</a>] [<a
|
||||
href="userhtmlsu42.html" >front</a>] [<a
|
||||
href="userhtmlsu32.html#userhtmlsu45.html" >up</a>] </p></div>
|
||||
<!--l. 1106--><p class="indent" > <a
|
||||
<!--l. 1114--><p class="indent" > <a
|
||||
id="tailuserhtmlsu42.html"></a>
|
||||
</body></html>
|
||||
|
||||
@@ -10,7 +10,7 @@
|
||||
<link rel="stylesheet" type="text/css" href="userhtml.css">
|
||||
</head><body
|
||||
>
|
||||
<!--l. 1106--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 1114--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu47.html" >next</a>] [<a
|
||||
href="userhtmlsu42.html" >prev</a>] [<a
|
||||
href="userhtmlsu42.html#tailuserhtmlsu42.html" >prev-tail</a>] [<a
|
||||
@@ -24,8 +24,8 @@ href="userhtmlsu32.html#userhtmlsu46.html" >up</a>] </p></div>
|
||||
<pre class="verbatim" id="verbatim-47">
|
||||
call psb_geasb(x, desc_a, info, mold)
|
||||
</pre>
|
||||
<!--l. 1111--><p class="nopar" >
|
||||
<!--l. 1113--><p class="indent" >
|
||||
<!--l. 1119--><p class="nopar" >
|
||||
<!--l. 1121--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">Type:</span> </dt><dd
|
||||
@@ -75,7 +75,7 @@ class="cmtt-10">psb</span><span
|
||||
class="cmtt-10">_T</span><span
|
||||
class="cmtt-10">_vect</span><span
|
||||
class="cmtt-10">_type</span></a>.</dd></dl>
|
||||
<!--l. 1129--><p class="indent" >
|
||||
<!--l. 1137--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">On Return</span> </dt><dd
|
||||
@@ -109,15 +109,36 @@ class="cmbx-10">required </span><br
|
||||
class="newline" />Intent: <span
|
||||
class="cmbx-10">out</span>.<br
|
||||
class="newline" />An integer value; 0 means no error has been detected.</dd></dl>
|
||||
<!--l. 1153--><p class="noindent" ><span
|
||||
class="cmbx-12">Notes</span>
|
||||
|
||||
|
||||
|
||||
<!--l. 1146--><div class="crosslinks"><p class="noindent">[<a
|
||||
<ol class="enumerate1" >
|
||||
<li
|
||||
class="enumerate" id="x54-91002x1">On entry to this routine the descriptor must be in the assembled state,
|
||||
i.e. <span class="obeylines-h"><span class="verb"><span
|
||||
class="cmtt-10">psb_cdasb</span></span></span> must already have been called.
|
||||
</li>
|
||||
<li
|
||||
class="enumerate" id="x54-91004x2">If the <span class="obeylines-h"><span class="verb"><span
|
||||
class="cmtt-10">buildmode=psb_matbld_remote_</span></span></span> value was specified at allocation
|
||||
time, contributions defined on the current process but belonging to a
|
||||
remote process will be handled accordingly. This is most likely to occur in
|
||||
finite element applications, with <span class="obeylines-h"><span class="verb"><span
|
||||
class="cmtt-10">dupl=psb_dupl_add_</span></span></span>.</li></ol>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<!--l. 1169--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu47.html" >next</a>] [<a
|
||||
href="userhtmlsu42.html" >prev</a>] [<a
|
||||
href="userhtmlsu42.html#tailuserhtmlsu42.html" >prev-tail</a>] [<a
|
||||
href="userhtmlsu43.html" >front</a>] [<a
|
||||
href="userhtmlsu32.html#userhtmlsu46.html" >up</a>] </p></div>
|
||||
<!--l. 1146--><p class="indent" > <a
|
||||
<!--l. 1169--><p class="indent" > <a
|
||||
id="tailuserhtmlsu43.html"></a>
|
||||
</body></html>
|
||||
|
||||
@@ -10,7 +10,7 @@
|
||||
<link rel="stylesheet" type="text/css" href="userhtml.css">
|
||||
</head><body
|
||||
>
|
||||
<!--l. 1146--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 1169--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu48.html" >next</a>] [<a
|
||||
href="userhtmlsu43.html" >prev</a>] [<a
|
||||
href="userhtmlsu43.html#tailuserhtmlsu43.html" >prev-tail</a>] [<a
|
||||
@@ -24,8 +24,8 @@ href="userhtmlsu32.html#userhtmlsu47.html" >up</a>] </p></div>
|
||||
<pre class="verbatim" id="verbatim-48">
|
||||
call psb_gefree(x, desc_a, info)
|
||||
</pre>
|
||||
<!--l. 1151--><p class="nopar" >
|
||||
<!--l. 1153--><p class="indent" >
|
||||
<!--l. 1174--><p class="nopar" >
|
||||
<!--l. 1176--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">Type:</span> </dt><dd
|
||||
@@ -69,7 +69,7 @@ class="cmtt-10">psb</span><span
|
||||
class="cmtt-10">_desc</span><span
|
||||
class="cmtt-10">_type</span></a>.<br
|
||||
class="newline" /></dd></dl>
|
||||
<!--l. 1171--><p class="indent" >
|
||||
<!--l. 1194--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">On Return</span> </dt><dd
|
||||
@@ -91,12 +91,12 @@ class="newline" />An integer value; 0 means no error has been detected.</dd></dl
|
||||
|
||||
|
||||
|
||||
<!--l. 1184--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 1207--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu48.html" >next</a>] [<a
|
||||
href="userhtmlsu43.html" >prev</a>] [<a
|
||||
href="userhtmlsu43.html#tailuserhtmlsu43.html" >prev-tail</a>] [<a
|
||||
href="userhtmlsu44.html" >front</a>] [<a
|
||||
href="userhtmlsu32.html#userhtmlsu47.html" >up</a>] </p></div>
|
||||
<!--l. 1184--><p class="indent" > <a
|
||||
<!--l. 1207--><p class="indent" > <a
|
||||
id="tailuserhtmlsu44.html"></a>
|
||||
</body></html>
|
||||
|
||||
@@ -10,7 +10,7 @@
|
||||
<link rel="stylesheet" type="text/css" href="userhtml.css">
|
||||
</head><body
|
||||
>
|
||||
<!--l. 1185--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 1208--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu49.html" >next</a>] [<a
|
||||
href="userhtmlsu44.html" >prev</a>] [<a
|
||||
href="userhtmlsu44.html#tailuserhtmlsu44.html" >prev-tail</a>] [<a
|
||||
@@ -24,8 +24,8 @@ href="userhtmlsu32.html#userhtmlsu48.html" >up</a>] </p></div>
|
||||
<pre class="verbatim" id="verbatim-49">
|
||||
call psb_gelp(trans, iperm, x, info)
|
||||
</pre>
|
||||
<!--l. 1190--><p class="nopar" >
|
||||
<!--l. 1192--><p class="indent" >
|
||||
<!--l. 1213--><p class="nopar" >
|
||||
<!--l. 1215--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">Type:</span> </dt><dd
|
||||
@@ -76,7 +76,7 @@ class="newline" />Intent: <span
|
||||
class="cmbx-10">inout</span>.<br
|
||||
class="newline" />Specified as: a one or two dimensional array.<br
|
||||
class="newline" /></dd></dl>
|
||||
<!--l. 1212--><p class="indent" >
|
||||
<!--l. 1235--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">On Return</span> </dt><dd
|
||||
@@ -98,12 +98,12 @@ class="newline" />An integer value; 0 means no error has been detected.</dd></dl
|
||||
|
||||
|
||||
|
||||
<!--l. 1225--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 1248--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu49.html" >next</a>] [<a
|
||||
href="userhtmlsu44.html" >prev</a>] [<a
|
||||
href="userhtmlsu44.html#tailuserhtmlsu44.html" >prev-tail</a>] [<a
|
||||
href="userhtmlsu45.html" >front</a>] [<a
|
||||
href="userhtmlsu32.html#userhtmlsu48.html" >up</a>] </p></div>
|
||||
<!--l. 1225--><p class="indent" > <a
|
||||
<!--l. 1248--><p class="indent" > <a
|
||||
id="tailuserhtmlsu45.html"></a>
|
||||
</body></html>
|
||||
|
||||
@@ -10,7 +10,7 @@
|
||||
<link rel="stylesheet" type="text/css" href="userhtml.css">
|
||||
</head><body
|
||||
>
|
||||
<!--l. 1226--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 1249--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu50.html" >next</a>] [<a
|
||||
href="userhtmlsu45.html" >prev</a>] [<a
|
||||
href="userhtmlsu45.html#tailuserhtmlsu45.html" >prev-tail</a>] [<a
|
||||
@@ -25,8 +25,8 @@ href="userhtmlsu32.html#userhtmlsu49.html" >up</a>] </p></div>
|
||||
call psb_glob_to_loc(x, y, desc_a, info, iact,owned)
|
||||
call psb_glob_to_loc(x, desc_a, info, iact,owned)
|
||||
</pre>
|
||||
<!--l. 1232--><p class="nopar" >
|
||||
<!--l. 1234--><p class="indent" >
|
||||
<!--l. 1255--><p class="nopar" >
|
||||
<!--l. 1257--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">Type:</span> </dt><dd
|
||||
@@ -88,7 +88,7 @@ class="newline" />Intent: <span
|
||||
class="cmbx-10">in</span>.<br
|
||||
class="newline" />If true, then only indices strictly owned by the current process are
|
||||
considered valid, if false then halo indices are also accepted. Default: false.</dd></dl>
|
||||
<!--l. 1262--><p class="indent" >
|
||||
<!--l. 1285--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">On Return</span> </dt><dd
|
||||
@@ -134,7 +134,7 @@ class="cmbx-10">required </span><br
|
||||
class="newline" />Intent: <span
|
||||
class="cmbx-10">out</span>.<br
|
||||
class="newline" />An integer value; 0 means no error has been detected.</dd></dl>
|
||||
<!--l. 1284--><p class="noindent" ><span
|
||||
<!--l. 1307--><p class="noindent" ><span
|
||||
class="cmbx-12">Notes</span>
|
||||
<ol class="enumerate1" >
|
||||
<li
|
||||
@@ -151,12 +151,12 @@ class="cmtt-10">I</span></span></span>gnore means that the negative output is th
|
||||
|
||||
|
||||
|
||||
<!--l. 1293--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 1316--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu50.html" >next</a>] [<a
|
||||
href="userhtmlsu45.html" >prev</a>] [<a
|
||||
href="userhtmlsu45.html#tailuserhtmlsu45.html" >prev-tail</a>] [<a
|
||||
href="userhtmlsu46.html" >front</a>] [<a
|
||||
href="userhtmlsu32.html#userhtmlsu49.html" >up</a>] </p></div>
|
||||
<!--l. 1293--><p class="indent" > <a
|
||||
<!--l. 1316--><p class="indent" > <a
|
||||
id="tailuserhtmlsu46.html"></a>
|
||||
</body></html>
|
||||
|
||||
@@ -10,7 +10,7 @@
|
||||
<link rel="stylesheet" type="text/css" href="userhtml.css">
|
||||
</head><body
|
||||
>
|
||||
<!--l. 1294--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 1317--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu51.html" >next</a>] [<a
|
||||
href="userhtmlsu46.html" >prev</a>] [<a
|
||||
href="userhtmlsu46.html#tailuserhtmlsu46.html" >prev-tail</a>] [<a
|
||||
@@ -25,8 +25,8 @@ href="userhtmlsu32.html#userhtmlsu50.html" >up</a>] </p></div>
|
||||
call psb_loc_to_glob(x, y, desc_a, info, iact)
|
||||
call psb_loc_to_glob(x, desc_a, info, iact)
|
||||
</pre>
|
||||
<!--l. 1300--><p class="nopar" >
|
||||
<!--l. 1302--><p class="indent" >
|
||||
<!--l. 1323--><p class="nopar" >
|
||||
<!--l. 1325--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">Type:</span> </dt><dd
|
||||
@@ -77,7 +77,7 @@ class="cmtt-10">I</span></span></span>gnore, <span class="obeylines-h"><span cla
|
||||
class="cmtt-10">W</span></span></span>arning or <span class="obeylines-h"><span class="verb"><span
|
||||
class="cmtt-10">A</span></span></span>bort, default <span class="obeylines-h"><span class="verb"><span
|
||||
class="cmtt-10">I</span></span></span>gnore.</dd></dl>
|
||||
<!--l. 1323--><p class="indent" >
|
||||
<!--l. 1346--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">On Return</span> </dt><dd
|
||||
@@ -129,12 +129,12 @@ class="newline" />An integer value; 0 means no error has been detected.</dd></dl
|
||||
|
||||
|
||||
|
||||
<!--l. 1350--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 1373--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu51.html" >next</a>] [<a
|
||||
href="userhtmlsu46.html" >prev</a>] [<a
|
||||
href="userhtmlsu46.html#tailuserhtmlsu46.html" >prev-tail</a>] [<a
|
||||
href="userhtmlsu47.html" >front</a>] [<a
|
||||
href="userhtmlsu32.html#userhtmlsu50.html" >up</a>] </p></div>
|
||||
<!--l. 1350--><p class="indent" > <a
|
||||
<!--l. 1373--><p class="indent" > <a
|
||||
id="tailuserhtmlsu47.html"></a>
|
||||
</body></html>
|
||||
|
||||
@@ -10,7 +10,7 @@
|
||||
<link rel="stylesheet" type="text/css" href="userhtml.css">
|
||||
</head><body
|
||||
>
|
||||
<!--l. 1350--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 1373--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu52.html" >next</a>] [<a
|
||||
href="userhtmlsu47.html" >prev</a>] [<a
|
||||
href="userhtmlsu47.html#tailuserhtmlsu47.html" >prev-tail</a>] [<a
|
||||
@@ -24,8 +24,8 @@ href="userhtmlsu32.html#userhtmlsu51.html" >up</a>] </p></div>
|
||||
<pre class="verbatim" id="verbatim-52">
|
||||
call psb_is_owned(x, desc_a)
|
||||
</pre>
|
||||
<!--l. 1355--><p class="nopar" >
|
||||
<!--l. 1357--><p class="indent" >
|
||||
<!--l. 1378--><p class="nopar" >
|
||||
<!--l. 1380--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">Type:</span> </dt><dd
|
||||
@@ -62,7 +62,7 @@ href="userhtmlsu5.html#descdata"><span
|
||||
class="cmtt-10">psb</span><span
|
||||
class="cmtt-10">_desc</span><span
|
||||
class="cmtt-10">_type</span></a>.</dd></dl>
|
||||
<!--l. 1372--><p class="indent" >
|
||||
<!--l. 1395--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">On Return</span> </dt><dd
|
||||
@@ -79,7 +79,7 @@ class="cmbx-10">required</span><br
|
||||
class="newline" />Intent: <span
|
||||
class="cmbx-10">out</span>.<br
|
||||
class="newline" /></dd></dl>
|
||||
<!--l. 1382--><p class="noindent" ><span
|
||||
<!--l. 1405--><p class="noindent" ><span
|
||||
class="cmbx-12">Notes</span>
|
||||
<ol class="enumerate1" >
|
||||
<li
|
||||
@@ -92,12 +92,12 @@ class="cmtt-10">.true.</span></span></span> value for an index that is strictly
|
||||
|
||||
|
||||
|
||||
<!--l. 1390--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 1413--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu52.html" >next</a>] [<a
|
||||
href="userhtmlsu47.html" >prev</a>] [<a
|
||||
href="userhtmlsu47.html#tailuserhtmlsu47.html" >prev-tail</a>] [<a
|
||||
href="userhtmlsu48.html" >front</a>] [<a
|
||||
href="userhtmlsu32.html#userhtmlsu51.html" >up</a>] </p></div>
|
||||
<!--l. 1390--><p class="indent" > <a
|
||||
<!--l. 1413--><p class="indent" > <a
|
||||
id="tailuserhtmlsu48.html"></a>
|
||||
</body></html>
|
||||
|
||||
@@ -10,7 +10,7 @@
|
||||
<link rel="stylesheet" type="text/css" href="userhtml.css">
|
||||
</head><body
|
||||
>
|
||||
<!--l. 1390--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 1413--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu53.html" >next</a>] [<a
|
||||
href="userhtmlsu48.html" >prev</a>] [<a
|
||||
href="userhtmlsu48.html#tailuserhtmlsu48.html" >prev-tail</a>] [<a
|
||||
@@ -24,8 +24,8 @@ href="userhtmlsu32.html#userhtmlsu52.html" >up</a>] </p></div>
|
||||
<pre class="verbatim" id="verbatim-53">
|
||||
call psb_owned_index(y, x, desc_a, info)
|
||||
</pre>
|
||||
<!--l. 1395--><p class="nopar" >
|
||||
<!--l. 1397--><p class="indent" >
|
||||
<!--l. 1418--><p class="nopar" >
|
||||
<!--l. 1420--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">Type:</span> </dt><dd
|
||||
@@ -76,7 +76,7 @@ class="cmtt-10">I</span></span></span>gnore, <span class="obeylines-h"><span cla
|
||||
class="cmtt-10">W</span></span></span>arning or <span class="obeylines-h"><span class="verb"><span
|
||||
class="cmtt-10">A</span></span></span>bort, default <span class="obeylines-h"><span class="verb"><span
|
||||
class="cmtt-10">I</span></span></span>gnore.</dd></dl>
|
||||
<!--l. 1418--><p class="indent" >
|
||||
<!--l. 1441--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">On Return</span> </dt><dd
|
||||
@@ -107,7 +107,7 @@ class="newline" />An integer value; 0 means no error has been detected.</dd></dl
|
||||
|
||||
|
||||
|
||||
<!--l. 1434--><p class="noindent" ><span
|
||||
<!--l. 1457--><p class="noindent" ><span
|
||||
class="cmbx-12">Notes</span>
|
||||
<ol class="enumerate1" >
|
||||
<li
|
||||
@@ -120,12 +120,12 @@ class="cmtt-10">.true.</span></span></span> value for those indices that are str
|
||||
|
||||
|
||||
|
||||
<!--l. 1442--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 1465--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu53.html" >next</a>] [<a
|
||||
href="userhtmlsu48.html" >prev</a>] [<a
|
||||
href="userhtmlsu48.html#tailuserhtmlsu48.html" >prev-tail</a>] [<a
|
||||
href="userhtmlsu49.html" >front</a>] [<a
|
||||
href="userhtmlsu32.html#userhtmlsu52.html" >up</a>] </p></div>
|
||||
<!--l. 1442--><p class="indent" > <a
|
||||
<!--l. 1465--><p class="indent" > <a
|
||||
id="tailuserhtmlsu49.html"></a>
|
||||
</body></html>
|
||||
|
||||
@@ -10,7 +10,7 @@
|
||||
<link rel="stylesheet" type="text/css" href="userhtml.css">
|
||||
</head><body
|
||||
>
|
||||
<!--l. 1442--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 1465--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu54.html" >next</a>] [<a
|
||||
href="userhtmlsu49.html" >prev</a>] [<a
|
||||
href="userhtmlsu49.html#tailuserhtmlsu49.html" >prev-tail</a>] [<a
|
||||
@@ -24,8 +24,8 @@ href="userhtmlsu32.html#userhtmlsu53.html" >up</a>] </p></div>
|
||||
<pre class="verbatim" id="verbatim-54">
|
||||
call psb_is_local(x, desc_a)
|
||||
</pre>
|
||||
<!--l. 1447--><p class="nopar" >
|
||||
<!--l. 1449--><p class="indent" >
|
||||
<!--l. 1470--><p class="nopar" >
|
||||
<!--l. 1472--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">Type:</span> </dt><dd
|
||||
@@ -62,7 +62,7 @@ href="userhtmlsu5.html#descdata"><span
|
||||
class="cmtt-10">psb</span><span
|
||||
class="cmtt-10">_desc</span><span
|
||||
class="cmtt-10">_type</span></a>.</dd></dl>
|
||||
<!--l. 1464--><p class="indent" >
|
||||
<!--l. 1487--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">On Return</span> </dt><dd
|
||||
@@ -79,7 +79,7 @@ class="cmbx-10">required</span><br
|
||||
class="newline" />Intent: <span
|
||||
class="cmbx-10">out</span>.<br
|
||||
class="newline" /></dd></dl>
|
||||
<!--l. 1474--><p class="noindent" ><span
|
||||
<!--l. 1497--><p class="noindent" ><span
|
||||
class="cmbx-12">Notes</span>
|
||||
<ol class="enumerate1" >
|
||||
<li
|
||||
@@ -92,12 +92,12 @@ class="cmtt-10">.true.</span></span></span> value for an index that is local to
|
||||
|
||||
|
||||
|
||||
<!--l. 1481--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 1504--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu54.html" >next</a>] [<a
|
||||
href="userhtmlsu49.html" >prev</a>] [<a
|
||||
href="userhtmlsu49.html#tailuserhtmlsu49.html" >prev-tail</a>] [<a
|
||||
href="userhtmlsu50.html" >front</a>] [<a
|
||||
href="userhtmlsu32.html#userhtmlsu53.html" >up</a>] </p></div>
|
||||
<!--l. 1481--><p class="indent" > <a
|
||||
<!--l. 1504--><p class="indent" > <a
|
||||
id="tailuserhtmlsu50.html"></a>
|
||||
</body></html>
|
||||
|
||||
@@ -10,7 +10,7 @@
|
||||
<link rel="stylesheet" type="text/css" href="userhtml.css">
|
||||
</head><body
|
||||
>
|
||||
<!--l. 1481--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 1504--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu55.html" >next</a>] [<a
|
||||
href="userhtmlsu50.html" >prev</a>] [<a
|
||||
href="userhtmlsu50.html#tailuserhtmlsu50.html" >prev-tail</a>] [<a
|
||||
@@ -24,8 +24,8 @@ href="userhtmlsu32.html#userhtmlsu54.html" >up</a>] </p></div>
|
||||
<pre class="verbatim" id="verbatim-55">
|
||||
call psb_local_index(y, x, desc_a, info)
|
||||
</pre>
|
||||
<!--l. 1486--><p class="nopar" >
|
||||
<!--l. 1488--><p class="indent" >
|
||||
<!--l. 1509--><p class="nopar" >
|
||||
<!--l. 1511--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">Type:</span> </dt><dd
|
||||
@@ -76,7 +76,7 @@ class="cmtt-10">I</span></span></span>gnore, <span class="obeylines-h"><span cla
|
||||
class="cmtt-10">W</span></span></span>arning or <span class="obeylines-h"><span class="verb"><span
|
||||
class="cmtt-10">A</span></span></span>bort, default <span class="obeylines-h"><span class="verb"><span
|
||||
class="cmtt-10">I</span></span></span>gnore.</dd></dl>
|
||||
<!--l. 1509--><p class="indent" >
|
||||
<!--l. 1532--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">On Return</span> </dt><dd
|
||||
@@ -107,7 +107,7 @@ class="newline" />An integer value; 0 means no error has been detected.</dd></dl
|
||||
|
||||
|
||||
|
||||
<!--l. 1525--><p class="noindent" ><span
|
||||
<!--l. 1548--><p class="noindent" ><span
|
||||
class="cmbx-12">Notes</span>
|
||||
<ol class="enumerate1" >
|
||||
<li
|
||||
@@ -120,12 +120,12 @@ class="cmtt-10">.true.</span></span></span> value for those indices that are loc
|
||||
|
||||
|
||||
|
||||
<!--l. 1537--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 1560--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu55.html" >next</a>] [<a
|
||||
href="userhtmlsu50.html" >prev</a>] [<a
|
||||
href="userhtmlsu50.html#tailuserhtmlsu50.html" >prev-tail</a>] [<a
|
||||
href="userhtmlsu51.html" >front</a>] [<a
|
||||
href="userhtmlsu32.html#userhtmlsu54.html" >up</a>] </p></div>
|
||||
<!--l. 1537--><p class="indent" > <a
|
||||
<!--l. 1560--><p class="indent" > <a
|
||||
id="tailuserhtmlsu51.html"></a>
|
||||
</body></html>
|
||||
|
||||
@@ -10,7 +10,7 @@
|
||||
<link rel="stylesheet" type="text/css" href="userhtml.css">
|
||||
</head><body
|
||||
>
|
||||
<!--l. 1538--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 1561--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu56.html" >next</a>] [<a
|
||||
href="userhtmlsu51.html" >prev</a>] [<a
|
||||
href="userhtmlsu51.html#tailuserhtmlsu51.html" >prev-tail</a>] [<a
|
||||
@@ -24,8 +24,8 @@ href="userhtmlsu32.html#userhtmlsu55.html" >up</a>] </p></div>
|
||||
<pre class="verbatim" id="verbatim-56">
|
||||
call psb_get_boundary(bndel, desc, info)
|
||||
</pre>
|
||||
<!--l. 1543--><p class="nopar" >
|
||||
<!--l. 1545--><p class="indent" >
|
||||
<!--l. 1566--><p class="nopar" >
|
||||
<!--l. 1568--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">Type:</span> </dt><dd
|
||||
@@ -49,7 +49,7 @@ href="userhtmlsu5.html#descdata"><span
|
||||
class="cmtt-10">psb</span><span
|
||||
class="cmtt-10">_desc</span><span
|
||||
class="cmtt-10">_type</span></a>.</dd></dl>
|
||||
<!--l. 1555--><p class="indent" >
|
||||
<!--l. 1578--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">On Return</span> </dt><dd
|
||||
@@ -78,7 +78,7 @@ class="cmbx-10">required </span><br
|
||||
class="newline" />Intent: <span
|
||||
class="cmbx-10">out</span>.<br
|
||||
class="newline" />An integer value; 0 means no error has been detected.</dd></dl>
|
||||
<!--l. 1571--><p class="noindent" ><span
|
||||
<!--l. 1594--><p class="noindent" ><span
|
||||
class="cmbx-12">Notes</span>
|
||||
<ol class="enumerate1" >
|
||||
<li
|
||||
@@ -96,12 +96,12 @@ class="cmtt-10">bndel</span></span></span> will be exactly equal to the nu
|
||||
|
||||
|
||||
|
||||
<!--l. 1580--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 1603--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu56.html" >next</a>] [<a
|
||||
href="userhtmlsu51.html" >prev</a>] [<a
|
||||
href="userhtmlsu51.html#tailuserhtmlsu51.html" >prev-tail</a>] [<a
|
||||
href="userhtmlsu52.html" >front</a>] [<a
|
||||
href="userhtmlsu32.html#userhtmlsu55.html" >up</a>] </p></div>
|
||||
<!--l. 1580--><p class="indent" > <a
|
||||
<!--l. 1603--><p class="indent" > <a
|
||||
id="tailuserhtmlsu52.html"></a>
|
||||
</body></html>
|
||||
|
||||
@@ -10,7 +10,7 @@
|
||||
<link rel="stylesheet" type="text/css" href="userhtml.css">
|
||||
</head><body
|
||||
>
|
||||
<!--l. 1581--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 1604--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlse7.html" >next</a>] [<a
|
||||
href="userhtmlsu52.html" >prev</a>] [<a
|
||||
href="userhtmlsu52.html#tailuserhtmlsu52.html" >prev-tail</a>] [<a
|
||||
@@ -24,8 +24,8 @@ href="userhtmlsu32.html#userhtmlsu56.html" >up</a>] </p></div>
|
||||
<pre class="verbatim" id="verbatim-57">
|
||||
call psb_get_overlap(ovrel, desc, info)
|
||||
</pre>
|
||||
<!--l. 1586--><p class="nopar" >
|
||||
<!--l. 1588--><p class="indent" >
|
||||
<!--l. 1609--><p class="nopar" >
|
||||
<!--l. 1611--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">Type:</span> </dt><dd
|
||||
@@ -49,7 +49,7 @@ href="userhtmlsu5.html#descdata"><span
|
||||
class="cmtt-10">psb</span><span
|
||||
class="cmtt-10">_desc</span><span
|
||||
class="cmtt-10">_type</span></a>.</dd></dl>
|
||||
<!--l. 1598--><p class="indent" >
|
||||
<!--l. 1621--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">On Return</span> </dt><dd
|
||||
@@ -78,7 +78,7 @@ class="cmbx-10">required </span><br
|
||||
class="newline" />Intent: <span
|
||||
class="cmbx-10">out</span>.<br
|
||||
class="newline" />An integer value; 0 means no error has been detected.</dd></dl>
|
||||
<!--l. 1614--><p class="noindent" ><span
|
||||
<!--l. 1637--><p class="noindent" ><span
|
||||
class="cmbx-12">Notes</span>
|
||||
<ol class="enumerate1" >
|
||||
<li
|
||||
@@ -95,12 +95,12 @@ class="cmtt-10">ovrel</span></span></span> will be exactly equal to the number o
|
||||
|
||||
|
||||
|
||||
<!--l. 1624--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 1647--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlse7.html" >next</a>] [<a
|
||||
href="userhtmlsu52.html" >prev</a>] [<a
|
||||
href="userhtmlsu52.html#tailuserhtmlsu52.html" >prev-tail</a>] [<a
|
||||
href="userhtmlsu53.html" >front</a>] [<a
|
||||
href="userhtmlsu32.html#userhtmlsu56.html" >up</a>] </p></div>
|
||||
<!--l. 1624--><p class="indent" > <a
|
||||
<!--l. 1647--><p class="indent" > <a
|
||||
id="tailuserhtmlsu53.html"></a>
|
||||
</body></html>
|
||||
|
||||
@@ -10,7 +10,7 @@
|
||||
<link rel="stylesheet" type="text/css" href="userhtml.css">
|
||||
</head><body
|
||||
>
|
||||
<!--l. 1625--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 1648--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu57.html" >next</a>] [<a
|
||||
href="userhtmlsu53.html" >prev</a>] [<a
|
||||
href="userhtmlsu53.html#tailuserhtmlsu53.html" >prev-tail</a>] [<a
|
||||
@@ -25,8 +25,8 @@ href="userhtmlsu32.html#userhtmlse7.html" >up</a>] </p></div>
|
||||
call psb_sp_getrow(row, a, nz, ia, ja, val, info, &
|
||||
              & append, nzin, lrw)
|
||||
</pre>
|
||||
<!--l. 1631--><p class="nopar" >
|
||||
<!--l. 1633--><p class="indent" >
|
||||
<!--l. 1654--><p class="nopar" >
|
||||
<!--l. 1656--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">Type:</span> </dt><dd
|
||||
@@ -103,7 +103,7 @@ class="cmmi-10">row</span>.
|
||||
|
||||
|
||||
|
||||
<!--l. 1673--><p class="indent" >
|
||||
<!--l. 1696--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">On Return</span> </dt><dd
|
||||
@@ -166,7 +166,7 @@ class="cmbx-10">required </span><br
|
||||
class="newline" />Intent: <span
|
||||
class="cmbx-10">out</span>.<br
|
||||
class="newline" />An integer value; 0 means no error has been detected.</dd></dl>
|
||||
<!--l. 1702--><p class="noindent" ><span
|
||||
<!--l. 1725--><p class="noindent" ><span
|
||||
class="cmbx-12">Notes</span>
|
||||
<ol class="enumerate1" >
|
||||
<li
|
||||
@@ -198,12 +198,12 @@ class="cmtt-10">psb_loc_to_glob</span></span></span> routine on the output.</li>
|
||||
|
||||
|
||||
|
||||
<!--l. 1718--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 1741--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu57.html" >next</a>] [<a
|
||||
href="userhtmlsu53.html" >prev</a>] [<a
|
||||
href="userhtmlsu53.html#tailuserhtmlsu53.html" >prev-tail</a>] [<a
|
||||
href="userhtmlsu54.html" >front</a>] [<a
|
||||
href="userhtmlsu32.html#userhtmlse7.html" >up</a>] </p></div>
|
||||
<!--l. 1718--><p class="indent" > <a
|
||||
<!--l. 1741--><p class="indent" > <a
|
||||
id="tailuserhtmlsu54.html"></a>
|
||||
</body></html>
|
||||
|
||||
@@ -10,7 +10,7 @@
|
||||
<link rel="stylesheet" type="text/css" href="userhtml.css">
|
||||
</head><body
|
||||
>
|
||||
<!--l. 1718--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 1741--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu58.html" >next</a>] [<a
|
||||
href="userhtmlsu54.html" >prev</a>] [<a
|
||||
href="userhtmlsu54.html#tailuserhtmlsu54.html" >prev-tail</a>] [<a
|
||||
@@ -18,7 +18,7 @@ href="userhtmlsu52.html#tailuserhtmlsu55.html">tail</a>] [<a
|
||||
href="userhtmlsu32.html#userhtmlsu57.html" >up</a>] </p></div>
|
||||
<h4 class="subsectionHead"><span class="titlemark">6.26 </span> <a
|
||||
id="x66-1030006.26"></a>psb_sizeof — Memory occupation</h4>
|
||||
<!--l. 1721--><p class="noindent" >This function computes the memory occupation of a PSBLAS object.
|
||||
<!--l. 1744--><p class="noindent" >This function computes the memory occupation of a PSBLAS object.
|
||||
|
||||
|
||||
|
||||
@@ -27,8 +27,8 @@ isz = psb_sizeof(a)
|
||||
isz = psb_sizeof(desc_a)
|
||||
isz = psb_sizeof(prec)
|
||||
</pre>
|
||||
<!--l. 1728--><p class="nopar" >
|
||||
<!--l. 1730--><p class="indent" >
|
||||
<!--l. 1751--><p class="nopar" >
|
||||
<!--l. 1753--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">Type:</span> </dt><dd
|
||||
@@ -102,12 +102,12 @@ class="cmtt-10">integer(psb_long_int_k_)</span></span></span> number.</dd></dl>
|
||||
|
||||
|
||||
|
||||
<!--l. 1757--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 1780--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu58.html" >next</a>] [<a
|
||||
href="userhtmlsu54.html" >prev</a>] [<a
|
||||
href="userhtmlsu54.html#tailuserhtmlsu54.html" >prev-tail</a>] [<a
|
||||
href="userhtmlsu55.html" >front</a>] [<a
|
||||
href="userhtmlsu32.html#userhtmlsu57.html" >up</a>] </p></div>
|
||||
<!--l. 1757--><p class="indent" > <a
|
||||
<!--l. 1780--><p class="indent" > <a
|
||||
id="tailuserhtmlsu55.html"></a>
|
||||
</body></html>
|
||||
|
||||
@@ -10,20 +10,20 @@
|
||||
<link rel="stylesheet" type="text/css" href="userhtml.css">
|
||||
</head><body
|
||||
>
|
||||
<!--l. 1757--><div class="crosslinks"><p class="noindent">[<a
|
||||
<!--l. 1780--><div class="crosslinks"><p class="noindent">[<a
|
||||
href="userhtmlsu55.html" >prev</a>] [<a
|
||||
href="userhtmlsu55.html#tailuserhtmlsu55.html" >prev-tail</a>] [<a
|
||||
href="userhtmlsu53.html#tailuserhtmlsu56.html">tail</a>] [<a
|
||||
href="userhtmlsu32.html#userhtmlsu58.html" >up</a>] </p></div>
|
||||
<h4 class="subsectionHead"><span class="titlemark">6.27 </span> <a
|
||||
id="x67-1040006.27"></a>Sorting utilities — </h4>
|
||||
<!--l. 1760--><p class="noindent" ><span
|
||||
<!--l. 1783--><p class="noindent" ><span
|
||||
class="cmbx-12">psb</span><span
|
||||
class="cmbx-12">_msort — Sorting by the Merge-sort algorithm</span>
|
||||
<!--l. 1763--><p class="noindent" ><span
|
||||
<!--l. 1786--><p class="noindent" ><span
|
||||
class="cmbx-12">psb</span><span
|
||||
class="cmbx-12">_qsort — Sorting by the Quicksort algorithm</span>
|
||||
<!--l. 1766--><p class="noindent" ><span
|
||||
<!--l. 1789--><p class="noindent" ><span
|
||||
class="cmbx-12">psb</span><span
|
||||
class="cmbx-12">_hsort — Sorting by the Heapsort algorithm</span>
|
||||
|
||||
@@ -34,8 +34,8 @@ call psb_msort(x,ix,dir,flag)
|
||||
call psb_qsort(x,ix,dir,flag)
|
||||
call psb_hsort(x,ix,dir,flag)
|
||||
</pre>
|
||||
<!--l. 1771--><p class="nopar" >
|
||||
<!--l. 1773--><p class="indent" > These serial routines sort a sequence <span
|
||||
<!--l. 1794--><p class="nopar" >
|
||||
<!--l. 1796--><p class="indent" > These serial routines sort a sequence <span
|
||||
class="cmmi-10">X </span>into ascending or descending order. The
|
||||
argument meaning is identical for the three calls; the only difference is the algorithm
|
||||
used to accomplish the task (see Usage Notes below).
|
||||
@@ -102,7 +102,7 @@ class="cmtt-10">psb_sort_keep_idx_</span></span></span>;
|
||||
default <span class="obeylines-h"><span class="verb"><span
|
||||
class="cmtt-10">psb_sort_ovw_idx_</span></span></span>.
|
||||
</dd></dl>
|
||||
<!--l. 1803--><p class="indent" >
|
||||
<!--l. 1826--><p class="indent" >
|
||||
<dl class="description"><dt class="description">
|
||||
<span
|
||||
class="cmbx-10">On Return</span> </dt><dd
|
||||
@@ -126,7 +126,7 @@ class="cmbx-10">Optional </span><br
|
||||
class="newline" />An integer array of rank 1, whose entries are moved to the same position
|
||||
as the corresponding entries in <span
|
||||
class="cmmi-10">x</span>.</dd></dl>
|
||||
<!--l. 1814--><p class="noindent" ><span
|
||||
<!--l. 1837--><p class="noindent" ><span
|
||||
class="cmbx-12">Notes</span>
|
||||
<ol class="enumerate1" >
|
||||
<li
|
||||
|
||||
@@ -108,6 +108,38 @@ class="description">Error code.<br
|
||||
class="newline" />Type: <span
|
||||
class="cmbx-10">required </span><br
|
||||
class="newline" />An integer value; 0 means no error has been detected.</dd></dl>
|
||||
<!--l. 294--><p class="noindent" ><span
|
||||
class="cmbx-12">Notes</span>
|
||||
<!--l. 296--><p class="indent" > If this function is called on a vector <span class="lstinline"></span><span
|
||||
class="cmtt-10">v</span> on a distributed communicator only the
|
||||
local part is written in output. To get a single MatrixMarket file with the whole
|
||||
vector when appropriate, e.g. for debugging purposes, one could <span
|
||||
class="cmti-10">gather </span>the whole
|
||||
vector on a single rank and then write it. Consider the following example for a <span
|
||||
class="cmti-10">double</span>
|
||||
precision vector
|
||||
<div class="center"
|
||||
>
|
||||
<!--l. 312--><p class="noindent" >
|
||||
<div class="minipage"><pre class="verbatim" id="verbatim-81">
|
||||
real(psb_dpk_), allocatable :: vglobal(:)
|
||||
call psb_gather(vglobal,v,desc,info)
|
||||
if (iam == psb_root_) then
|
||||
call mm_array_write(vglobal,vtitle,info,filename)
|
||||
end if
|
||||
call deallocate(vglobal, stat=info)
|
||||
</pre>
|
||||
<!--l. 322--><p class="nopar" ></div></div>
|
||||
<!--l. 326--><p class="noindent" >To simplify this procedure in <span class="obeylines-h"><span class="verb"><span
|
||||
class="cmtt-10">C</span></span></span>, there is a utility function
|
||||
<div class="center"
|
||||
>
|
||||
<!--l. 332--><p class="noindent" >
|
||||
<div class="minipage"><pre class="verbatim" id="verbatim-82">
|
||||
psb_i_t psb_c_<s,d,c,z>global_vec_write(vh,cdh);
|
||||
</pre>
|
||||
<!--l. 336--><p class="nopar" ></div></div>
|
||||
<!--l. 340--><p class="noindent" >that produces exactly this result.
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -19,7 +19,7 @@ href="userhtmlsu86.html#userhtmlsu87.html" >up</a>] </p></div>
|
||||
|
||||
|
||||
|
||||
<pre class="verbatim" id="verbatim-81">
|
||||
<pre class="verbatim" id="verbatim-83">
|
||||
call prec%init(icontxt,ptype, info)
|
||||
</pre>
|
||||
<!--l. 30--><p class="nopar" >
|
||||
|
||||
@@ -21,7 +21,7 @@ href="userhtmlsu86.html#userhtmlsu89.html" >up</a>] </p></div>
|
||||
|
||||
|
||||
|
||||
<pre class="verbatim" id="verbatim-82">
|
||||
<pre class="verbatim" id="verbatim-84">
|
||||
call prec%build(a, desc_a, info[,amold,vmold,imold])
|
||||
</pre>
|
||||
<!--l. 91--><p class="nopar" >
|
||||
|
||||
@@ -21,7 +21,7 @@ href="userhtmlsu86.html#userhtmlse11.html" >up</a>] </p></div>
|
||||
|
||||
|
||||
|
||||
<pre class="verbatim" id="verbatim-83">
|
||||
<pre class="verbatim" id="verbatim-85">
|
||||
call prec%apply(x,y,desc_a,info,trans,work)
|
||||
call prec%apply(x,desc_a,info,trans)
|
||||
</pre>
|
||||
|
||||
@@ -21,7 +21,7 @@ href="userhtmlsu86.html#userhtmlsu90.html" >up</a>] </p></div>
|
||||
|
||||
|
||||
|
||||
<pre class="verbatim" id="verbatim-84">
|
||||
<pre class="verbatim" id="verbatim-86">
|
||||
call prec%descr(info)
|
||||
call prec%descr(info,iout, root)
|
||||
</pre>
|
||||
|
||||
@@ -20,7 +20,7 @@ href="userhtmlsu86.html#userhtmlli2.html" >up</a>] </p></div>
|
||||
|
||||
|
||||
|
||||
<pre class="verbatim" id="verbatim-85">
|
||||
<pre class="verbatim" id="verbatim-87">
|
||||
call  prec%clone(precout,info)
|
||||
</pre>
|
||||
<!--l. 248--><p class="nopar" >
|
||||
|
||||
@@ -20,7 +20,7 @@ href="userhtmlsu86.html# " >up</a>] </p></div>
|
||||
|
||||
|
||||
|
||||
<pre class="verbatim" id="verbatim-86">
|
||||
<pre class="verbatim" id="verbatim-88">
|
||||
call prec%free(info)
|
||||
</pre>
|
||||
<!--l. 271--><p class="nopar" >
|
||||
|
||||
+1
-1
@@ -139,7 +139,7 @@ PDF = $(join $(BASEFILE),.pdf)
|
||||
PS = $(join $(BASEFILE),.ps)
|
||||
GXS = $(join $(BASEFILE),.gxs)
|
||||
GLX = $(join $(BASEFILE),.glx)
|
||||
TARGETPDF= ../psblas-3.7.pdf
|
||||
TARGETPDF= ../psblas-3.8.pdf
|
||||
BASEHTML = $(patsubst %.tex,%,$(HTMLFILE))
|
||||
HTML = $(join $(BASEHTML),.html)
|
||||
HTMLDIR = ../html
|
||||
|
||||
+32
-9
@@ -601,7 +601,7 @@ An integer value; 0 means no error has been detected.
|
||||
the assembled matrix may substantially improve performance in the
|
||||
matrix build phase, as it will reduce or eliminate the need for
|
||||
(potentially multiple) data reallocations;
|
||||
\item Using \verb|psb_matbld_remote_| will cause an overhead at
|
||||
\item Using \verb|psb_matbld_remote_| is likely to cause a runtime overhead at
|
||||
assembly time;
|
||||
\end{enumerate}
|
||||
|
||||
@@ -712,8 +712,7 @@ An integer value; 0 means no error has been detected.
|
||||
\item The input data can be passed in either COO or CSR formats;
|
||||
\item In COO format the coefficients to be inserted are represented by
|
||||
the ordered triples $ia(i),ja(i),val(i)$, for $i=1,\dots,nz$;
|
||||
these triples should belong to the current process, i.e. $ia(i)$
|
||||
should be one of the local indices, but are otherwise arbitrary;
|
||||
these triples are arbitrary;
|
||||
\item In CSR format the coefficients to be inserted for each input row $i=1,nr$
|
||||
are represented by the ordered triples $(i+irw-1),ja(j),val(j)$, for
|
||||
$j=irp(i),\dots,irp(i+1)-1$;
|
||||
@@ -724,8 +723,11 @@ An integer value; 0 means no error has been detected.
|
||||
may be split into as many calls as desired (even in the CSR format);
|
||||
\item Coefficients from different rows may also be mixed up freely
|
||||
in a single call, according to the application needs;
|
||||
\item Any coefficients from matrix rows not owned by the calling
|
||||
process are silently ignored;
|
||||
\item Coefficients from matrix rows not owned by the calling
|
||||
process are treated according to the value of \verb|buildmode|
|
||||
specified at allocation time; if
|
||||
\verb|buildmode| was chosen as \verb|psb_matbld_remote_| the library
|
||||
will keep track of them, otherwise they are silently ignored;
|
||||
\item If the descriptor is in the assembled state, then any entries in
|
||||
the sparse matrix that would generate additional communication
|
||||
requirements are ignored;
|
||||
@@ -739,7 +741,7 @@ An integer value; 0 means no error has been detected.
|
||||
\clearpage\subsection{psb\_spasb --- Sparse matrix assembly routine}
|
||||
|
||||
\begin{verbatim}
|
||||
call psb_spasb(a, desc_a, info, afmt, upd, mold)
|
||||
call psb_spasb(a, desc_a, info [, afmt, upd, mold])
|
||||
\end{verbatim}
|
||||
|
||||
\begin{description}
|
||||
@@ -808,8 +810,9 @@ An integer value; 0 means no error has been detected.
|
||||
at allocation time, contributions defined on the current process but
|
||||
belonging to a remote process will be handled accordingly. This is
|
||||
most likely to occur in finite element applications, with
|
||||
\verb|dupl=psb_dupl_add_|; note that the descriptor will be updated,
|
||||
and there will be a runtime overhead.
|
||||
\verb|dupl=psb_dupl_add_|; it is necessary to check for possible
|
||||
updates needed in the descriptor, hence there will be a runtime
|
||||
overhead.
|
||||
\end{enumerate}
|
||||
|
||||
|
||||
@@ -1007,7 +1010,7 @@ Scope: {\bf global}.\\
|
||||
Type: {\bf optional}.\\
|
||||
Intent: {\bf in}.\\
|
||||
Specified as: integer, possible values: \verb|psb_dupl_ovwrt_|,
|
||||
\verb|psb_dupl_add_|, \verb|psb_dupl_err_|.
|
||||
\verb|psb_dupl_add_|; \verb|psb_dupl_err_| has no effect.
|
||||
\item[buildmode] Whether to keep track of matrix entries that do not
|
||||
belong to the current process.\\
|
||||
Scope: {\bf global}.\\
|
||||
@@ -1032,6 +1035,11 @@ Intent: {\bf out}.\\
|
||||
An integer value; 0 means no error has been detected.
|
||||
\end{description}
|
||||
|
||||
{\par\noindent\large\bfseries Notes}
|
||||
\begin{enumerate}
|
||||
\item Using \verb|psb_matbld_remote_| is likely to cause a runtime overhead at
|
||||
assembly time;
|
||||
\end{enumerate}
|
||||
|
||||
%
|
||||
%% psb_ins %%
|
||||
@@ -1140,7 +1148,22 @@ Type: {\bf required} \\
|
||||
Intent: {\bf out}.\\
|
||||
An integer value; 0 means no error has been detected.
|
||||
\end{description}
|
||||
|
||||
|
||||
{\par\noindent\large\bfseries Notes}
|
||||
\begin{enumerate}
|
||||
\item On entry to this routine the descriptor must be in the
|
||||
assembled state, i.e. \verb|psb_cdasb| must already have been called.
|
||||
\item If the \verb|buildmode=psb_matbld_remote_| value was specified
|
||||
at allocation time, contributions defined on the current process but
|
||||
belonging to a remote process will be handled accordingly. This is
|
||||
most likely to occur in finite element applications, with
|
||||
\verb|dupl=psb_dupl_add_|.
|
||||
\end{enumerate}
|
||||
|
||||
|
||||
%
|
||||
|
||||
%% psb_free %%
|
||||
%
|
||||
\clearpage\subsection{psb\_gefree --- Frees a dense matrix}
|
||||
|
||||
@@ -36,7 +36,7 @@
|
||||
\relax
|
||||
\pdfcompresslevel=0 %-- 0 = none, 9 = best
|
||||
\pdfinfo{ %-- Info dictionary of PDF output /Author (Alfredo Buttari)
|
||||
/Title (Parallel Sparse BLAS V. 3.7.0)
|
||||
/Title (Parallel Sparse BLAS V. 3.8.0)
|
||||
/Subject (Parallel Sparse Basic Linear Algebra Subroutines)
|
||||
/Keywords (Computer Science Linear Algebra Fluid Dynamics Parallel Linux MPI PSBLAS Iterative Solvers Preconditioners)
|
||||
/Creator (pdfLaTeX)
|
||||
@@ -99,7 +99,7 @@
|
||||
|
||||
\begin{document}
|
||||
{
|
||||
\pdfbookmark{PSBLAS-v3.7.0 User's Guide}{title}
|
||||
\pdfbookmark{PSBLAS-v3.8.0 User's Guide}{title}
|
||||
\lstset{language=Fortran}
|
||||
\newlength{\centeroffset}
|
||||
\setlength{\centeroffset}{-0.5\oddsidemargin}
|
||||
@@ -109,7 +109,7 @@
|
||||
\vspace*{\stretch{1}}
|
||||
\noindent\hspace*{\centeroffset}\makebox[0pt][l]{\begin{minipage}{\textwidth}
|
||||
\flushright
|
||||
{\Huge\bfseries PSBLAS 3.7.0.2 User's guide
|
||||
{\Huge\bfseries PSBLAS 3.8.0 User's guide
|
||||
}
|
||||
\noindent\rule[-1ex]{\textwidth}{5pt}\\[2.5ex]
|
||||
\hfill\emph{\Large A reference guide for the Parallel Sparse BLAS library}
|
||||
@@ -130,7 +130,7 @@
|
||||
{\bfseries
|
||||
by Salvatore Filippone\\
|
||||
and Alfredo Buttari}\\
|
||||
Feb 14th, 2022
|
||||
May 1st, 2022
|
||||
\end{minipage}}
|
||||
}
|
||||
%\addtolength{\textwidth}{\centeroffset}
|
||||
|
||||
@@ -94,9 +94,9 @@
|
||||
Alfredo Buttari } \\
|
||||
%\\[10ex]
|
||||
%\today
|
||||
Software version: 3.7.0.1\\
|
||||
Software version: 3.8.0\\
|
||||
%\today
|
||||
Feb 14th, 2022
|
||||
May 1st, 2022
|
||||
\cleardoublepage
|
||||
\begingroup
|
||||
\renewcommand*{\thepage}{toc}
|
||||
|
||||
Reference in New Issue
Block a user