1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML3.2 EN">
4
<META NAME="GENERATOR" CONTENT="DOCTEXT">
5
<TITLE>MATSEQSBAIJSPOOLES</TITLE>
7
<BODY BGCOLOR="FFFFFF">
8
<A NAME="MATSEQSBAIJSPOOLES"><H1>MATSEQSBAIJSPOOLES</H1></A>
9
<A HREF="../Mat/MATSEQSBAIJSPOOLES.html#MATSEQSBAIJSPOOLES">MATSEQSBAIJSPOOLES</A> = "seqsbaijspooles" - A matrix type providing direct solvers (Cholesky) for sequential symmetric matrices via the external package Spooles. If Spooles is installed (see the manual for
10
instructions on how to declare the existence of external packages),
11
a matrix type can be constructed which invokes Spooles solvers.
12
After calling <A HREF="../Mat/MatCreate.html#MatCreate">MatCreate</A>(...,A), simply call <A HREF="../Mat/MatSetType.html#MatSetType">MatSetType</A>(A,<A HREF="../Mat/MATSEQSBAIJSPOOLES.html#MATSEQSBAIJSPOOLES">MATSEQSBAIJSPOOLES</A>).
13
This matrix type is only supported for double precision real.
15
This matrix inherits from <A HREF="../Mat/MATSEQSBAIJ.html#MATSEQSBAIJ">MATSEQSBAIJ</A>. As a result, <A HREF="../Mat/MatSeqSBAIJSetPreallocation.html#MatSeqSBAIJSetPreallocation">MatSeqSBAIJSetPreallocation</A> is
16
supported for this matrix type. One can also call <A HREF="../Mat/MatConvert.html#MatConvert">MatConvert</A> for an inplace conversion to or from
17
the <A HREF="../Mat/MATSEQSBAIJ.html#MATSEQSBAIJ">MATSEQSBAIJ</A> type without data copy.
19
<H3><FONT COLOR="#CC3333">Options Database Keys</FONT></H3>
20
<TABLE border="0" cellpadding="0" cellspacing="0">
21
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-mat_type seqsbaijspooles </B></TD><TD>- sets the matrix type to seqsbaijspooles during calls to <A HREF="../Mat/MatSetFromOptions.html#MatSetFromOptions">MatSetFromOptions</A>()
23
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-mat_spooles_tau <tau> </B></TD><TD>- upper bound on the magnitude of the largest element in L or U
25
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-mat_spooles_seed <seed> </B></TD><TD>- random number seed used for ordering
27
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-mat_spooles_msglvl <msglvl> </B></TD><TD>- message output level
29
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-mat_spooles_ordering <BestOfNDandMS,MMD,MS,ND> </B></TD><TD>- ordering used
31
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-mat_spooles_maxdomainsize <n> </B></TD><TD>- maximum subgraph <A HREF="../Sys/size.html#size">size</A> used by Spooles orderings
33
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-mat_spooles_maxzeros <n> </B></TD><TD>- maximum number of zeros inside a supernode
35
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-mat_spooles_maxsize <n> </B></TD><TD>- maximum <A HREF="../Sys/size.html#size">size</A> of a supernode
37
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-mat_spooles_FrontMtxInfo <true,fase> </B></TD><TD>- print Spooles information about the computed factorization
39
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-mat_spooles_symmetryflag <0,1,2> </B></TD><TD>- 0: SPOOLES_SYMMETRIC, 1: SPOOLES_HERMITIAN, 2: SPOOLES_NONSYMMETRIC
41
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-mat_spooles_patchAndGoFlag <0,1,2> </B></TD><TD>- 0: no patch, 1: use PatchAndGo strategy 1, 2: use PatchAndGo strategy 2
43
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-mat_spooles_toosmall <dt> </B></TD><TD>- drop tolerance for PatchAndGo strategy 1
45
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-mat_spooles_storeids <bool integer> </B></TD><TD>- if nonzero, stores row and col numbers where patches were applied in an IV object
47
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-mat_spooles_fudge <delta> </B></TD><TD>- fudge factor for rescaling diagonals with PatchAndGo strategy 2
49
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-mat_spooles_storevalues <bool integer> </B></TD><TD>- if nonzero and PatchAndGo strategy 2 is used, store change in diagonal value in a DV object
54
<H3><FONT COLOR="#CC3333">See Also</FONT></H3>
55
<A HREF="../Mat/MATMPISBAIJSPOOLES.html#MATMPISBAIJSPOOLES">MATMPISBAIJSPOOLES</A>, <A HREF="../Mat/MATSEQAIJSPOOLES.html#MATSEQAIJSPOOLES">MATSEQAIJSPOOLES</A>, <A HREF="../Mat/MATMPIAIJSPOOLES.html#MATMPIAIJSPOOLES">MATMPIAIJSPOOLES</A>, PCCHOLESKY
56
<BR><P><B><P><B><FONT COLOR="#CC3333">Level:</FONT></B>beginner
57
<BR><FONT COLOR="#CC3333">Location:</FONT></B><A HREF="../../../src/mat/impls/sbaij/seq/spooles/sbaijspooles.c.html#MATSEQSBAIJSPOOLES">src/mat/impls/sbaij/seq/spooles/sbaijspooles.c</A>
58
<BR><A HREF="./index.html">Index of all Mat routines</A>
59
<BR><A HREF="../../index.html">Table of Contents for all manual pages</A>
60
<BR><A HREF="../singleindex.html">Index of all manual pages</A>