1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML3.2 EN">
<HTML>
<HEAD> <link rel="canonical" href="http://www.mcs.anl.gov/petsc/petsc-current/docs/manualpages/PC/PCCreate.html" />
<META NAME="GENERATOR" CONTENT="DOCTEXT">
<TITLE>PCCreate</TITLE>
</HEAD>
<BODY BGCOLOR="FFFFFF">
<div id="version" align=right><b>petsc-3.10.3 2018-12-18</b></div>
<div id="bugreport" align=right><a href="mailto:petsc-maint@mcs.anl.gov?subject=Typo or Error in Documentation &body=Please describe the typo or error in the documentation: petsc-3.10.3 v3.10.3 docs/manualpages/PC/PCCreate.html "><small>Report Typos and Errors</small></a></div>
<A NAME="PCCreate"><H1>PCCreate</H1></A>
Creates a preconditioner context.
<H3><FONT COLOR="#CC3333">Synopsis</FONT></H3>
<PRE>
#include "petscksp.h"
<A HREF="../Sys/PetscErrorCode.html#PetscErrorCode">PetscErrorCode</A> <A HREF="../PC/PCCreate.html#PCCreate">PCCreate</A>(<A HREF="../Sys/MPI_Comm.html#MPI_Comm">MPI_Comm</A> comm,<A HREF="../PC/PC.html#PC">PC</A> *newpc)
</PRE>
Collective on <A HREF="../Sys/MPI_Comm.html#MPI_Comm">MPI_Comm</A>
<P>
<H3><FONT COLOR="#CC3333">Input Parameter</FONT></H3>
<DT><B>comm </B> -MPI communicator
<br>
<P>
<H3><FONT COLOR="#CC3333">Output Parameter</FONT></H3>
<DT><B>pc </B> -location to put the preconditioner context
<br>
<P>
<H3><FONT COLOR="#CC3333">Notes</FONT></H3>
The default preconditioner for sparse matrices is <A HREF="../PC/PCILU.html#PCILU">PCILU</A> or <A HREF="../PC/PCICC.html#PCICC">PCICC</A> with 0 fill on one process and block Jacobi with <A HREF="../PC/PCILU.html#PCILU">PCILU</A> or ICC
in parallel. For dense matrices it is always <A HREF="../PC/PCNONE.html#PCNONE">PCNONE</A>.
<P>
<P>
<H3><FONT COLOR="#CC3333">Keywords</FONT></H3>
<A HREF="../PC/PC.html#PC">PC</A>, create, context
<BR>
<P>
<H3><FONT COLOR="#CC3333">See Also</FONT></H3>
<A HREF="../PC/PCSetUp.html#PCSetUp">PCSetUp</A>(), <A HREF="../PC/PCApply.html#PCApply">PCApply</A>(), <A HREF="../PC/PCDestroy.html#PCDestroy">PCDestroy</A>()
<BR><P><B></B><H3><FONT COLOR="#CC3333">Level</FONT></H3>developer<BR>
<H3><FONT COLOR="#CC3333">Location</FONT></H3>
</B><A HREF="../../../src/ksp/pc/interface/precon.c.html#PCCreate">src/ksp/pc/interface/precon.c</A>
<P><H3><FONT COLOR="#CC3333">Examples</FONT></H3>
<A HREF="../../../src/ksp/ksp/examples/tutorials/ex21f.F90.html">src/ksp/ksp/examples/tutorials/ex21f.F90.html</A><BR>
<P><H3><FONT COLOR="CC3333">Implementations</FONT></H3><A HREF="../../../src/ksp/pc/impls/asm/asm.c.html#PCCreate_ASM">PCCreate_ASM in src/ksp/pc/impls/asm/asm.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/bddc/bddc.c.html#PCCreate_BDDC">PCCreate_BDDC in src/ksp/pc/impls/bddc/bddc.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/bjacobi/bjacobi.c.html#PCCreate_BJacobi">PCCreate_BJacobi in src/ksp/pc/impls/bjacobi/bjacobi.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/chowiluviennacl/chowiluviennacl.cxx.html#PCCreate_CHOWILUVIENNACL">PCCreate_CHOWILUVIENNACL in src/ksp/pc/impls/chowiluviennacl/chowiluviennacl.cxx</A><BR>
<A HREF="../../../src/ksp/pc/impls/composite/composite.c.html#PCCreate_Composite">PCCreate_Composite in src/ksp/pc/impls/composite/composite.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/cp/cp.c.html#PCCreate_CP">PCCreate_CP in src/ksp/pc/impls/cp/cp.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/eisens/eisen.c.html#PCCreate_Eisenstat">PCCreate_Eisenstat in src/ksp/pc/impls/eisens/eisen.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/factor/cholesky/cholesky.c.html#PCCreate_Cholesky">PCCreate_Cholesky in src/ksp/pc/impls/factor/cholesky/cholesky.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/factor/icc/icc.c.html#PCCreate_ICC">PCCreate_ICC in src/ksp/pc/impls/factor/icc/icc.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/factor/ilu/ilu.c.html#PCCreate_ILU">PCCreate_ILU in src/ksp/pc/impls/factor/ilu/ilu.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/factor/lu/lu.c.html#PCCreate_LU">PCCreate_LU in src/ksp/pc/impls/factor/lu/lu.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/fieldsplit/fieldsplit.c.html#PCCreate_FieldSplit">PCCreate_FieldSplit in src/ksp/pc/impls/fieldsplit/fieldsplit.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/galerkin/galerkin.c.html#PCCreate_Galerkin">PCCreate_Galerkin in src/ksp/pc/impls/galerkin/galerkin.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/gamg/gamg.c.html#PCCreate_GAMG">PCCreate_GAMG in src/ksp/pc/impls/gamg/gamg.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/gasm/gasm.c.html#PCCreate_GASM">PCCreate_GASM in src/ksp/pc/impls/gasm/gasm.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/hypre/hypre.c.html#PCCreate_HYPRE">PCCreate_HYPRE in src/ksp/pc/impls/hypre/hypre.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/hypre/hypre.c.html#PCCreate_PFMG">PCCreate_PFMG in src/ksp/pc/impls/hypre/hypre.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/hypre/hypre.c.html#PCCreate_SysPFMG">PCCreate_SysPFMG in src/ksp/pc/impls/hypre/hypre.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/is/nn/nn.c.html#PCCreate_NN">PCCreate_NN in src/ksp/pc/impls/is/nn/nn.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/jacobi/jacobi.c.html#PCCreate_Jacobi">PCCreate_Jacobi in src/ksp/pc/impls/jacobi/jacobi.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/kaczmarz/kaczmarz.c.html#PCCreate_Kaczmarz">PCCreate_Kaczmarz in src/ksp/pc/impls/kaczmarz/kaczmarz.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/ksp/pcksp.c.html#PCCreate_KSP">PCCreate_KSP in src/ksp/pc/impls/ksp/pcksp.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/lmvm/lmvmpc.c.html#PCCreate_LMVM">PCCreate_LMVM in src/ksp/pc/impls/lmvm/lmvmpc.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/lsc/lsc.c.html#PCCreate_LSC">PCCreate_LSC in src/ksp/pc/impls/lsc/lsc.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/mat/pcmat.c.html#PCCreate_Mat">PCCreate_Mat in src/ksp/pc/impls/mat/pcmat.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/mg/mg.c.html#PCCreate_MG">PCCreate_MG in src/ksp/pc/impls/mg/mg.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/ml/ml.c.html#PCCreate_ML">PCCreate_ML in src/ksp/pc/impls/ml/ml.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/none/none.c.html#PCCreate_None">PCCreate_None in src/ksp/pc/impls/none/none.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/parms/parms.c.html#PCCreate_PARMS">PCCreate_PARMS in src/ksp/pc/impls/parms/parms.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/patch/pcpatch.c.html#PCCreate_Patch">PCCreate_Patch in src/ksp/pc/impls/patch/pcpatch.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/pbjacobi/pbjacobi.c.html#PCCreate_PBJacobi">PCCreate_PBJacobi in src/ksp/pc/impls/pbjacobi/pbjacobi.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/redistribute/redistribute.c.html#PCCreate_Redistribute">PCCreate_Redistribute in src/ksp/pc/impls/redistribute/redistribute.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/redundant/redundant.c.html#PCCreate_Redundant">PCCreate_Redundant in src/ksp/pc/impls/redundant/redundant.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/rowscalingviennacl/rowscalingviennacl.cxx.html#PCCreate_ROWSCALINGVIENNACL">PCCreate_ROWSCALINGVIENNACL in src/ksp/pc/impls/rowscalingviennacl/rowscalingviennacl.cxx</A><BR>
<A HREF="../../../src/ksp/pc/impls/saviennacl/saviennacl.cxx.html#PCCreate_SAVIENNACL">PCCreate_SAVIENNACL in src/ksp/pc/impls/saviennacl/saviennacl.cxx</A><BR>
<A HREF="../../../src/ksp/pc/impls/shell/shellpc.c.html#PCCreate_Shell">PCCreate_Shell in src/ksp/pc/impls/shell/shellpc.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/sor/sor.c.html#PCCreate_SOR">PCCreate_SOR in src/ksp/pc/impls/sor/sor.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/spai/ispai.c.html#PCCreate_SPAI">PCCreate_SPAI in src/ksp/pc/impls/spai/ispai.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/svd/svd.c.html#PCCreate_SVD">PCCreate_SVD in src/ksp/pc/impls/svd/svd.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/telescope/telescope.c.html#PCCreate_Telescope">PCCreate_Telescope in src/ksp/pc/impls/telescope/telescope.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/tfs/tfs.c.html#PCCreate_TFS">PCCreate_TFS in src/ksp/pc/impls/tfs/tfs.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/vpbjacobi/vpbjacobi.c.html#PCCreate_VPBJacobi">PCCreate_VPBJacobi in src/ksp/pc/impls/vpbjacobi/vpbjacobi.c</A><BR>
<A HREF="../../../src/ksp/pc/impls/wb/wb.c.html#PCCreate_Exotic">PCCreate_Exotic in src/ksp/pc/impls/wb/wb.c</A><BR>
<BR><A HREF="./index.html">Index of all PC routines</A>
<BR><A HREF="../../index.html">Table of Contents for all manual pages</A>
<BR><A HREF="../singleindex.html">Index of all manual pages</A>
</BODY></HTML>
|
