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
|
<!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/PCBDDCSetDiscreteGradient.html" />
<META NAME="GENERATOR" CONTENT="DOCTEXT">
<TITLE>PCBDDCSetDiscreteGradient</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/PCBDDCSetDiscreteGradient.html "><small>Report Typos and Errors</small></a></div>
<A NAME="PCBDDCSetDiscreteGradient"><H1>PCBDDCSetDiscreteGradient</H1></A>
Sets the discrete gradient
<H3><FONT COLOR="#CC3333">Synopsis</FONT></H3>
<PRE>
#include "petscpc.h"
<A HREF="../Sys/PetscErrorCode.html#PetscErrorCode">PetscErrorCode</A> <A HREF="../PC/PCBDDCSetDiscreteGradient.html#PCBDDCSetDiscreteGradient">PCBDDCSetDiscreteGradient</A>(<A HREF="../PC/PC.html#PC">PC</A> pc, <A HREF="../Mat/Mat.html#Mat">Mat</A> G, <A HREF="../Sys/PetscInt.html#PetscInt">PetscInt</A> order, <A HREF="../Sys/PetscInt.html#PetscInt">PetscInt</A> field, <A HREF="../Sys/PetscBool.html#PetscBool">PetscBool</A> global, <A HREF="../Sys/PetscBool.html#PetscBool">PetscBool</A> conforming)
</PRE>
Collective on <A HREF="../PC/PC.html#PC">PC</A>
<P>
<H3><FONT COLOR="#CC3333">Input Parameters</FONT></H3>
<TABLE border="0" cellpadding="0" cellspacing="0">
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>pc </B></TD><TD>- the preconditioning context
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>G </B></TD><TD>- the discrete gradient matrix (should be in AIJ format)
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>order </B></TD><TD>- the order of the Nedelec space (1 for the lowest order)
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>field </B></TD><TD>- the field id of the Nedelec dofs (not used if the fields have not been specified)
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>global </B></TD><TD>- the type of global ordering for the rows of G
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>conforming </B></TD><TD>- whether the mesh is conforming or not
</TD></TR></TABLE>
<P>
<P>
<H3><FONT COLOR="#CC3333">Notes</FONT></H3>
The discrete gradient matrix G is used to analyze the subdomain edges, and it should not contain any zero entry.
For variable order spaces, the order should be set to zero.
If global is true, the rows of G should be given in global ordering for the whole dofs;
if false, the ordering should be global for the Nedelec field.
In the latter case, it should hold gid[i] < gid[j] iff geid[i] < geid[j], with gid the global orderding for all the dofs
and geid the one for the Nedelec field.
<P>
<H3><FONT COLOR="#CC3333">See Also</FONT></H3>
<A HREF="../PC/PCBDDC.html#PCBDDC">PCBDDC</A>,<A HREF="../PC/PCBDDCSetDofsSplitting.html#PCBDDCSetDofsSplitting">PCBDDCSetDofsSplitting</A>(),<A HREF="../PC/PCBDDCSetDofsSplittingLocal.html#PCBDDCSetDofsSplittingLocal">PCBDDCSetDofsSplittingLocal</A>()
<BR><P><B></B><H3><FONT COLOR="#CC3333">Level</FONT></H3>advanced<BR>
<H3><FONT COLOR="#CC3333">Location</FONT></H3>
</B><A HREF="../../../src/ksp/pc/impls/bddc/bddc.c.html#PCBDDCSetDiscreteGradient">src/ksp/pc/impls/bddc/bddc.c</A>
<P><H3><FONT COLOR="CC3333">Implementations</FONT></H3><A HREF="../../../src/ksp/pc/impls/bddc/bddc.c.html#PCBDDCSetDiscreteGradient_BDDC">PCBDDCSetDiscreteGradient_BDDC in src/ksp/pc/impls/bddc/bddc.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>
|
