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
|
<center><a href="https://gitlab.com/petsc/petsc/-/blob/01a2522431ef63feaceabbc11dd32b16a352f77d/include/petscistypes.h">Actual source code: petscistypes.h</a></center><br>
<html>
<head>
<title></title>
<meta name="generator" content="c2html 0.9.4">
<meta name="date" content="2023-02-27T22:24:49+00:00">
</head>
<body bgcolor="#FFFFFF">
<pre width="80">
<a name="line1"> 1: </a><font color="#A020F0">#ifndef PETSCISTYPES_H</font>
<a name="line2"> 2: </a><strong><font color="#228B22">#define PETSCISTYPES_H</font></strong>
<a name="line4"> 4: </a><font color="#B22222">/* SUBMANSEC = <a href="../docs/manualpages/IS/IS.html">IS</a> */</font>
<a name="line6"> 6: </a><font color="#B22222">/*S</font>
<a name="line7"> 7: </a><font color="#B22222"> <a href="../docs/manualpages/IS/IS.html">IS</a> - Abstract PETSc object that used for efficient indexing</font>
<a name="line9"> 9: </a><font color="#B22222"> Level: beginner</font>
<a name="line11"> 11: </a><font color="#B22222">.seealso: `<a href="../docs/manualpages/IS/ISCreateGeneral.html">ISCreateGeneral</a>()`, `<a href="../docs/manualpages/IS/ISCreateBlock.html">ISCreateBlock</a>()`, `<a href="../docs/manualpages/IS/ISCreateStride.html">ISCreateStride</a>()`, `<a href="../docs/manualpages/IS/ISGetIndices.html">ISGetIndices</a>()`, `<a href="../docs/manualpages/IS/ISDestroy.html">ISDestroy</a>()`</font>
<a name="line12"> 12: </a><font color="#B22222">S*/</font>
<a name="line13"> 13: </a><font color="#4169E1">typedef struct _p_IS *<a href="../docs/manualpages/IS/IS.html">IS</a>;</font>
<a name="line15"> 15: </a><font color="#B22222">/*S</font>
<a name="line16"> 16: </a><font color="#B22222"> <a href="../docs/manualpages/IS/ISLocalToGlobalMapping.html">ISLocalToGlobalMapping</a> - mappings from an arbitrary</font>
<a name="line17"> 17: </a><font color="#B22222"> local ordering from 0 to n-1 to a global PETSc ordering</font>
<a name="line18"> 18: </a><font color="#B22222"> used by a vector or matrix.</font>
<a name="line20"> 20: </a><font color="#B22222"> Level: intermediate</font>
<a name="line22"> 22: </a><font color="#B22222"> Notes:</font>
<a name="line23"> 23: </a><font color="#B22222"> Mapping from local to global is scalable; but global</font>
<a name="line24"> 24: </a><font color="#B22222"> to local may not be if the range of global values represented locally</font>
<a name="line25"> 25: </a><font color="#B22222"> is very large.</font>
<a name="line27"> 27: </a><font color="#B22222"> `<a href="../docs/manualpages/IS/ISLocalToGlobalMapping.html">ISLocalToGlobalMapping</a>` is actually a private object; it is included</font>
<a name="line28"> 28: </a><font color="#B22222"> here for the inline function `<a href="../docs/manualpages/IS/ISLocalToGlobalMappingApply.html">ISLocalToGlobalMappingApply</a>()` to allow it to be inlined since</font>
<a name="line29"> 29: </a><font color="#B22222"> it is used so often.</font>
<a name="line31"> 31: </a><font color="#B22222">.seealso: `<a href="../docs/manualpages/IS/ISLocalToGlobalMappingCreate.html">ISLocalToGlobalMappingCreate</a>()`, `<a href="../docs/manualpages/IS/ISLocalToGlobalMappingApply.html">ISLocalToGlobalMappingApply</a>()`, `<a href="../docs/manualpages/IS/ISLocalToGlobalMappingDestroy.html">ISLocalToGlobalMappingDestroy</a>()`</font>
<a name="line32"> 32: </a><font color="#B22222">S*/</font>
<a name="line33"> 33: </a><font color="#4169E1">typedef struct _p_ISLocalToGlobalMapping *<a href="../docs/manualpages/IS/ISLocalToGlobalMapping.html">ISLocalToGlobalMapping</a>;</font>
<a name="line35"> 35: </a><font color="#B22222">/*S</font>
<a name="line36"> 36: </a><font color="#B22222"> <a href="../docs/manualpages/IS/ISColoring.html">ISColoring</a> - sets of <a href="../docs/manualpages/IS/IS.html">IS</a>'s that define a coloring of something, such as a graph defined by a sparse matrix</font>
<a name="line38"> 38: </a><font color="#B22222"> Level: intermediate</font>
<a name="line40"> 40: </a><font color="#B22222"> Notes:</font>
<a name="line41"> 41: </a><font color="#B22222"> One should not access the *is records below directly because they may not yet</font>
<a name="line42"> 42: </a><font color="#B22222"> have been created. One should use `<a href="../docs/manualpages/IS/ISColoringGetIS.html">ISColoringGetIS</a>()` to make sure they are</font>
<a name="line43"> 43: </a><font color="#B22222"> created when needed.</font>
<a name="line45"> 45: </a><font color="#B22222"> When the coloring type is `<a href="../docs/manualpages/IS/ISColoringType.html">IS_COLORING_LOCAL</a>` the coloring is in the local ordering of the unknowns.</font>
<a name="line46"> 46: </a><font color="#B22222"> That is the matching the local (ghosted) vector; a local to global mapping must be applied to map</font>
<a name="line47"> 47: </a><font color="#B22222"> them to the global ordering.</font>
<a name="line49"> 49: </a><font color="#B22222"> Developer Note:</font>
<a name="line50"> 50: </a><font color="#B22222"> This is not a `<a href="../docs/manualpages/Sys/PetscObject.html">PetscObject</a>`</font>
<a name="line52"> 52: </a><font color="#B22222">.seealso: `<a href="../docs/manualpages/IS/ISColoringCreate.html">ISColoringCreate</a>()`, `<a href="../docs/manualpages/IS/ISColoringGetIS.html">ISColoringGetIS</a>()`, `<a href="../docs/manualpages/IS/ISColoringView.html">ISColoringView</a>()`</font>
<a name="line53"> 53: </a><font color="#B22222">S*/</font>
<a name="line54"> 54: </a><font color="#4169E1">typedef struct _n_ISColoring *<a href="../docs/manualpages/IS/ISColoring.html">ISColoring</a>;</font>
<a name="line56"> 56: </a><font color="#B22222">/*S</font>
<a name="line57"> 57: </a><font color="#B22222"> <a href="../docs/manualpages/IS/PetscLayout.html">PetscLayout</a> - defines layout of vectors and matrices across processes (which rows are owned by which processes)</font>
<a name="line59"> 59: </a><font color="#B22222"> Level: developer</font>
<a name="line61"> 61: </a><font color="#B22222">.seealso: `<a href="../docs/manualpages/IS/PetscLayoutCreate.html">PetscLayoutCreate</a>()`, `<a href="../docs/manualpages/IS/PetscLayoutDestroy.html">PetscLayoutDestroy</a>()`</font>
<a name="line62"> 62: </a><font color="#B22222">S*/</font>
<a name="line63"> 63: </a><font color="#4169E1">typedef struct _n_PetscLayout *<a href="../docs/manualpages/IS/PetscLayout.html">PetscLayout</a>;</font>
<a name="line65"> 65: </a><font color="#A020F0">#endif</font>
</pre>
</body>
</html>
|
