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
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML3.2 EN">
<HTML>
<HEAD> <link rel="canonical" href="http://www.mcs.anl.gov/petsc/petsc-current/docs/manualpages/Mat/MatNullSpaceCreateRigidBody.html" />
<META NAME="GENERATOR" CONTENT="DOCTEXT">
<TITLE>MatNullSpaceCreateRigidBody</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/Mat/MatNullSpaceCreateRigidBody.html "><small>Report Typos and Errors</small></a></div>
<A NAME="MatNullSpaceCreateRigidBody"><H1>MatNullSpaceCreateRigidBody</H1></A>
create rigid body modes from coordinates
<H3><FONT COLOR="#CC3333">Synopsis</FONT></H3>
<PRE>
#include "petscmat.h"
<A HREF="../Sys/PetscErrorCode.html#PetscErrorCode">PetscErrorCode</A> <A HREF="../Mat/MatNullSpaceCreateRigidBody.html#MatNullSpaceCreateRigidBody">MatNullSpaceCreateRigidBody</A>(<A HREF="../Vec/Vec.html#Vec">Vec</A> coords,<A HREF="../Mat/MatNullSpace.html#MatNullSpace">MatNullSpace</A> *sp)
</PRE>
Collective on <A HREF="../Vec/Vec.html#Vec">Vec</A>
<P>
<H3><FONT COLOR="#CC3333">Input Argument</FONT></H3>
<DT><B>coords </B> -block of coordinates of each node, must have block size set
<br>
<P>
<H3><FONT COLOR="#CC3333">Output Argument</FONT></H3>
<DT><B>sp </B> -the null space
<br>
<P>
<P>
<H3><FONT COLOR="#CC3333">Notes</FONT></H3>
If you are solving an elasticity problems you should likely use this, in conjunction with ee MatSetNearNullspace(), to provide information that
the <A HREF="../PC/PCGAMG.html#PCGAMG">PCGAMG</A> preconditioner can use to construct a much more efficient preconditioner.
<P>
If you are solving an elasticity problem with pure Neumann boundary conditions you can use this in conjunction with MatSetNullspace() to
provide this information to the linear solver so it can handle the null space appropriately in the linear solution.
<P>
<P>
<H3><FONT COLOR="#CC3333">See Also</FONT></H3>
<A HREF="../Mat/MatNullSpaceCreate.html#MatNullSpaceCreate">MatNullSpaceCreate</A>(), MatSetNearNullspace(), MatSetNullspace()
<BR><P><B></B><H3><FONT COLOR="#CC3333">Level</FONT></H3>advanced<BR>
<H3><FONT COLOR="#CC3333">Location</FONT></H3>
</B><A HREF="../../../src/mat/interface/matnull.c.html#MatNullSpaceCreateRigidBody">src/mat/interface/matnull.c</A>
<P><H3><FONT COLOR="#CC3333">Examples</FONT></H3>
<A HREF="../../../src/ksp/ksp/examples/tutorials/ex49.c.html">src/ksp/ksp/examples/tutorials/ex49.c.html</A><BR>
<A HREF="../../../src/ksp/ksp/examples/tutorials/ex56.c.html">src/ksp/ksp/examples/tutorials/ex56.c.html</A><BR>
<BR><A HREF="./index.html">Index of all Mat 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>
|
