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
|
<!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/PCHPDDMSetAuxiliaryMat.html" />
<META NAME="GENERATOR" CONTENT="DOCTEXT">
<TITLE>PCHPDDMSetAuxiliaryMat</TITLE>
</HEAD>
<BODY BGCOLOR="FFFFFF">
<div id="version" align=right><b>petsc-3.14.5 2021-03-03</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.14.5 v3.14.5 docs/manualpages/PC/PCHPDDMSetAuxiliaryMat.html "><small>Report Typos and Errors</small></a></div>
<A NAME="PCHPDDMSetAuxiliaryMat"><H1>PCHPDDMSetAuxiliaryMat</H1></A>
Sets the auxiliary matrix used by <A HREF="../PC/PCHPDDM.html#PCHPDDM">PCHPDDM</A> for the concurrent GenEO eigenproblems at the finest level. As an example, in a finite element context with nonoverlapping subdomains plus (overlapping) ghost elements, this could be the unassembled (Neumann) local overlapping operator. As opposed to the assembled (Dirichlet) local overlapping operator obtained by summing neighborhood contributions at the interface of ghost elements.
<H3><FONT COLOR="#CC3333">Synopsis</FONT></H3>
<PRE>
#include "petscpc.h"
<A HREF="../Sys/PetscErrorCode.html#PetscErrorCode">PetscErrorCode</A> <A HREF="../PC/PCHPDDMSetAuxiliaryMat.html#PCHPDDMSetAuxiliaryMat">PCHPDDMSetAuxiliaryMat</A>(<A HREF="../PC/PC.html#PC">PC</A> pc, <A HREF="../IS/IS.html#IS">IS</A> is, <A HREF="../Mat/Mat.html#Mat">Mat</A> A, <A HREF="../Sys/PetscErrorCode.html#PetscErrorCode">PetscErrorCode</A> (*setup)(<A HREF="../Mat/Mat.html#Mat">Mat</A>, <A HREF="../Sys/PetscReal.html#PetscReal">PetscReal</A>, <A HREF="../Vec/Vec.html#Vec">Vec</A>, <A HREF="../Vec/Vec.html#Vec">Vec</A>, <A HREF="../Sys/PetscReal.html#PetscReal">PetscReal</A>, <A HREF="../IS/IS.html#IS">IS</A>, void*), void* setup_ctx)
</PRE>
<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>- preconditioner context
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>is </B></TD><TD>- index set of the local auxiliary, e.g., Neumann, matrix
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>A </B></TD><TD>- auxiliary sequential matrix
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>setup </B></TD><TD>- function for generating the auxiliary matrix
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>setup_ctx </B></TD><TD>- context for setup
</TD></TR></TABLE>
<P>
<P>
<H3><FONT COLOR="#CC3333">See Also</FONT></H3>
<A HREF="../PC/PCCreate.html#PCCreate">PCCreate</A>(), <A HREF="../PC/PCSetType.html#PCSetType">PCSetType</A>(), <A HREF="../PC/PCType.html#PCType">PCType</A> (for list of available types), <A HREF="../PC/PC.html#PC">PC</A>, <A HREF="../PC/PCHPDDMSetRHSMat.html#PCHPDDMSetRHSMat">PCHPDDMSetRHSMat</A>(), <A HREF="../Mat/MATIS.html#MATIS">MATIS</A>
<BR><P><B></B><H3><FONT COLOR="#CC3333">Level</FONT></H3>intermediate<BR>
<H3><FONT COLOR="#CC3333">Location</FONT></H3>
</B><A HREF="../../../src/ksp/pc/impls/hpddm/hpddm.cxx.html#PCHPDDMSetAuxiliaryMat">src/ksp/pc/impls/hpddm/hpddm.cxx</A>
<P><H3><FONT COLOR="#CC3333">Examples</FONT></H3>
<A HREF="../../../src/ksp/ksp/tutorials/ex76.c.html">src/ksp/ksp/tutorials/ex76.c.html</A><BR>
<A HREF="../../../src/ksp/ksp/tutorials/ex76f.F90.html">src/ksp/ksp/tutorials/ex76f.F90.html</A><BR>
<P><H3><FONT COLOR="CC3333">Implementations</FONT></H3><A HREF="../../../src/ksp/pc/impls/hpddm/hpddm.cxx.html#PCHPDDMSetAuxiliaryMat_HPDDM(PC pc, IS is, Mat A, PetscErrorCode (*setup)">PCHPDDMSetAuxiliaryMat_HPDDM(PC pc, IS is, Mat A, PetscErrorCode (*setup) in src/ksp/pc/impls/hpddm/hpddm.cxx</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>
|
