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
|
<center><a href="https://gitlab.com/petsc/petsc/-/blob/9fe822445bcdd45fb93170ff68fa7403d3f52f09/include/petscbag.h">Actual source code: petscbag.h</a></center><br>
<html>
<head>
<title></title>
<meta name="generator" content="c2html 0.9.6">
<meta name="date" content="2025-03-28T21:10:40+00:00">
</head>
<body bgcolor="#FFFFFF">
<pre width=80>
<a name="line1"> 1: </a><font color="#A020F0">#pragma once</font>
<a name="line3"> 3: </a>#include <A href="../include/petscsys.h.html"><petscsys.h></A>
<a name="line5"> 5: </a><font color="#B22222">/* SUBMANSEC = Sys */</font>
<a name="line7"> 7: </a><font color="#B22222">/*S</font>
<a name="line8"> 8: </a><font color="#B22222"> <a href="../manualpages/Sys/PetscBag.html">PetscBag</a> - PETSc object that manages a collection of user data including parameters.</font>
<a name="line9"> 9: </a><font color="#B22222"> A bag is essentially a C struct with serialization (you can save it and load it from files).</font>
<a name="line11"> 11: </a><font color="#B22222"> Level: beginner</font>
<a name="line13"> 13: </a><font color="#B22222"> Sample Usage:</font>
<a name="line14"> 14: </a><font color="#B22222">.vb</font>
<a name="line15"> 15: </a><font color="#B22222"> typedef struct {</font>
<a name="line16"> 16: </a><font color="#B22222"> <a href="../manualpages/Sys/PetscInt.html">PetscInt</a> height;</font>
<a name="line17"> 17: </a><font color="#B22222"> <a href="../manualpages/Sys/PetscScalar.html">PetscScalar</a> root;</font>
<a name="line18"> 18: </a><font color="#B22222"> <a href="../manualpages/Sys/PetscReal.html">PetscReal</a> byebye;</font>
<a name="line19"> 19: </a><font color="#B22222"> } MyParameters;</font>
<a name="line21"> 21: </a><font color="#B22222"> <a href="../manualpages/Sys/PetscBag.html">PetscBag</a> bag;</font>
<a name="line22"> 22: </a><font color="#B22222"> MyParameters *params;</font>
<a name="line24"> 24: </a><font color="#B22222"> <a href="../manualpages/Sys/PetscCall.html">PetscCall</a>(<a href="../manualpages/Sys/PetscBagCreate.html">PetscBagCreate</a>(<a href="../manualpages/Sys/PETSC_COMM_WORLD.html">PETSC_COMM_WORLD</a>,sizeof(MyParameters),&bag));</font>
<a name="line25"> 25: </a><font color="#B22222"> <a href="../manualpages/Sys/PetscCall.html">PetscCall</a>(<a href="../manualpages/Sys/PetscBagGetData.html">PetscBagGetData</a>(bag,(void **)&params));</font>
<a name="line26"> 26: </a><font color="#B22222"> <a href="../manualpages/Sys/PetscCall.html">PetscCall</a>(<a href="../manualpages/Sys/PetscBagSetName.html">PetscBagSetName</a>(bag,"MyParameters"));</font>
<a name="line27"> 27: </a><font color="#B22222"> <a href="../manualpages/Sys/PetscCall.html">PetscCall</a>(<a href="../manualpages/Sys/PetscBagRegisterInt.html">PetscBagRegisterInt</a>(bag,&params.height,22,"height","Height of the water tower"));</font>
<a name="line28"> 28: </a><font color="#B22222">.ve</font>
<a name="line29"> 29: </a><font color="#B22222"> Note:</font>
<a name="line30"> 30: </a><font color="#B22222"> `<a href="../manualpages/Sys/PetscBag.html">PetscBag</a>` is a C struct, it is not a `<a href="../manualpages/Sys/PetscObject.html">PetscObject</a>`</font>
<a name="line32"> 32: </a><font color="#B22222">.seealso: `<a href="../manualpages/Sys/PetscBagSetName.html">PetscBagSetName</a>()`, `<a href="../manualpages/Sys/PetscBagGetName.html">PetscBagGetName</a>()`, `<a href="../manualpages/Sys/PetscBagView.html">PetscBagView</a>()`, `<a href="../manualpages/Sys/PetscBagLoad.html">PetscBagLoad</a>()`, `<a href="../manualpages/Sys/PetscBagGetData.html">PetscBagGetData</a>()`</font>
<a name="line33"> 33: </a><font color="#B22222"> `<a href="../manualpages/Sys/PetscBagRegisterReal.html">PetscBagRegisterReal</a>()`, `<a href="../manualpages/Sys/PetscBagRegisterInt.html">PetscBagRegisterInt</a>()`, `<a href="../manualpages/Sys/PetscBagRegisterBool.html">PetscBagRegisterBool</a>()`, `<a href="../manualpages/Sys/PetscBagRegisterScalar.html">PetscBagRegisterScalar</a>()`</font>
<a name="line34"> 34: </a><font color="#B22222"> `<a href="../manualpages/Sys/PetscBagSetFromOptions.html">PetscBagSetFromOptions</a>()`, `PetscBagRegisterVec()`, `<a href="../manualpages/Sys/PetscBagCreate.html">PetscBagCreate</a>()`, `<a href="../manualpages/Sys/PetscBagDestroy.html">PetscBagDestroy</a>()`, `<a href="../manualpages/Sys/PetscBagRegisterEnum.html">PetscBagRegisterEnum</a>()`</font>
<a name="line35"> 35: </a><font color="#B22222">S*/</font>
<a name="line36"> 36: </a><font color="#4169E1">typedef struct _n_PetscBag *<a href="../manualpages/Sys/PetscBag.html">PetscBag</a>;</font>
<a name="line37"> 37: </a><font color="#4169E1">typedef struct _n_PetscBagItem *PetscBagItem;</font>
<a name="line39"> 39: </a><strong><font color="#4169E1">PETSC_EXTERN <a href="../manualpages/Sys/PetscErrorCode.html">PetscErrorCode</a> <a href="../manualpages/Sys/PetscBagCreate.html">PetscBagCreate</a>(<a href="../manualpages/Sys/MPI_Comm.html">MPI_Comm</a>, size_t, <a href="../manualpages/Sys/PetscBag.html">PetscBag</a> *)</font></strong>;
<a name="line40"> 40: </a><strong><font color="#4169E1">PETSC_EXTERN <a href="../manualpages/Sys/PetscErrorCode.html">PetscErrorCode</a> <a href="../manualpages/Sys/PetscBagDestroy.html">PetscBagDestroy</a>(<a href="../manualpages/Sys/PetscBag.html">PetscBag</a> *)</font></strong>;
<a name="line41"> 41: </a><strong><font color="#4169E1">PETSC_EXTERN <a href="../manualpages/Sys/PetscErrorCode.html">PetscErrorCode</a> <a href="../manualpages/Sys/PetscBagGetData.html">PetscBagGetData</a>(<a href="../manualpages/Sys/PetscBag.html">PetscBag</a>, void **)</font></strong>;
<a name="line42"> 42: </a><strong><font color="#4169E1">PETSC_EXTERN <a href="../manualpages/Sys/PetscErrorCode.html">PetscErrorCode</a> <a href="../manualpages/Sys/PetscBagRegisterReal.html">PetscBagRegisterReal</a>(<a href="../manualpages/Sys/PetscBag.html">PetscBag</a>, void *, <a href="../manualpages/Sys/PetscReal.html">PetscReal</a>, const char *, const char *)</font></strong>;
<a name="line43"> 43: </a><strong><font color="#4169E1">PETSC_EXTERN <a href="../manualpages/Sys/PetscErrorCode.html">PetscErrorCode</a> <a href="../manualpages/Sys/PetscBagRegisterRealArray.html">PetscBagRegisterRealArray</a>(<a href="../manualpages/Sys/PetscBag.html">PetscBag</a>, void *, <a href="../manualpages/Sys/PetscInt.html">PetscInt</a>, const char *, const char *)</font></strong>;
<a name="line44"> 44: </a><strong><font color="#4169E1">PETSC_EXTERN <a href="../manualpages/Sys/PetscErrorCode.html">PetscErrorCode</a> <a href="../manualpages/Sys/PetscBagRegisterString.html">PetscBagRegisterString</a>(<a href="../manualpages/Sys/PetscBag.html">PetscBag</a>, void *, <a href="../manualpages/Sys/PetscInt.html">PetscInt</a>, const char *, const char *, const char *)</font></strong>;
<a name="line45"> 45: </a><strong><font color="#4169E1">PETSC_EXTERN <a href="../manualpages/Sys/PetscErrorCode.html">PetscErrorCode</a> <a href="../manualpages/Sys/PetscBagRegisterScalar.html">PetscBagRegisterScalar</a>(<a href="../manualpages/Sys/PetscBag.html">PetscBag</a>, void *, <a href="../manualpages/Sys/PetscScalar.html">PetscScalar</a>, const char *, const char *)</font></strong>;
<a name="line46"> 46: </a><strong><font color="#4169E1">PETSC_EXTERN <a href="../manualpages/Sys/PetscErrorCode.html">PetscErrorCode</a> <a href="../manualpages/Sys/PetscBagRegisterInt.html">PetscBagRegisterInt</a>(<a href="../manualpages/Sys/PetscBag.html">PetscBag</a>, void *, <a href="../manualpages/Sys/PetscInt.html">PetscInt</a>, const char *, const char *)</font></strong>;
<a name="line47"> 47: </a><strong><font color="#4169E1">PETSC_EXTERN <a href="../manualpages/Sys/PetscErrorCode.html">PetscErrorCode</a> <a href="../manualpages/Sys/PetscBagRegisterInt64.html">PetscBagRegisterInt64</a>(<a href="../manualpages/Sys/PetscBag.html">PetscBag</a>, void *, PetscInt64, const char *, const char *)</font></strong>;
<a name="line48"> 48: </a><strong><font color="#4169E1">PETSC_EXTERN <a href="../manualpages/Sys/PetscErrorCode.html">PetscErrorCode</a> <a href="../manualpages/Sys/PetscBagRegisterIntArray.html">PetscBagRegisterIntArray</a>(<a href="../manualpages/Sys/PetscBag.html">PetscBag</a>, void *, <a href="../manualpages/Sys/PetscInt.html">PetscInt</a>, const char *, const char *)</font></strong>;
<a name="line49"> 49: </a><strong><font color="#4169E1">PETSC_EXTERN <a href="../manualpages/Sys/PetscErrorCode.html">PetscErrorCode</a> <a href="../manualpages/Sys/PetscBagRegisterEnum.html">PetscBagRegisterEnum</a>(<a href="../manualpages/Sys/PetscBag.html">PetscBag</a>, void *, const char *const *, <a href="../manualpages/Sys/PetscEnum.html">PetscEnum</a>, const char *, const char *)</font></strong>;
<a name="line50"> 50: </a><strong><font color="#4169E1">PETSC_EXTERN <a href="../manualpages/Sys/PetscErrorCode.html">PetscErrorCode</a> <a href="../manualpages/Sys/PetscBagRegisterBool.html">PetscBagRegisterBool</a>(<a href="../manualpages/Sys/PetscBag.html">PetscBag</a>, void *, <a href="../manualpages/Sys/PetscBool.html">PetscBool</a>, const char *, const char *)</font></strong>;
<a name="line51"> 51: </a><strong><font color="#4169E1">PETSC_EXTERN <a href="../manualpages/Sys/PetscErrorCode.html">PetscErrorCode</a> <a href="../manualpages/Sys/PetscBagRegisterBoolArray.html">PetscBagRegisterBoolArray</a>(<a href="../manualpages/Sys/PetscBag.html">PetscBag</a>, void *, <a href="../manualpages/Sys/PetscInt.html">PetscInt</a>, const char *, const char *)</font></strong>;
<a name="line52"> 52: </a><strong><font color="#4169E1">PETSC_EXTERN <a href="../manualpages/Sys/PetscErrorCode.html">PetscErrorCode</a> <a href="../manualpages/Sys/PetscBagGetNames.html">PetscBagGetNames</a>(<a href="../manualpages/Sys/PetscBag.html">PetscBag</a>, const char *[])</font></strong>;
<a name="line54"> 54: </a><strong><font color="#4169E1">PETSC_EXTERN <a href="../manualpages/Sys/PetscErrorCode.html">PetscErrorCode</a> <a href="../manualpages/Sys/PetscBagSetFromOptions.html">PetscBagSetFromOptions</a>(<a href="../manualpages/Sys/PetscBag.html">PetscBag</a>)</font></strong>;
<a name="line55"> 55: </a><strong><font color="#4169E1">PETSC_EXTERN <a href="../manualpages/Sys/PetscErrorCode.html">PetscErrorCode</a> <a href="../manualpages/Sys/PetscBagGetName.html">PetscBagGetName</a>(<a href="../manualpages/Sys/PetscBag.html">PetscBag</a>, const char **)</font></strong>;
<a name="line56"> 56: </a><strong><font color="#4169E1">PETSC_EXTERN <a href="../manualpages/Sys/PetscErrorCode.html">PetscErrorCode</a> <a href="../manualpages/Sys/PetscBagSetName.html">PetscBagSetName</a>(<a href="../manualpages/Sys/PetscBag.html">PetscBag</a>, const char *, const char *)</font></strong>;
<a name="line57"> 57: </a><strong><font color="#4169E1">PETSC_EXTERN <a href="../manualpages/Sys/PetscErrorCode.html">PetscErrorCode</a> <a href="../manualpages/Sys/PetscBagSetOptionsPrefix.html">PetscBagSetOptionsPrefix</a>(<a href="../manualpages/Sys/PetscBag.html">PetscBag</a>, const char *)</font></strong>;
<a name="line59"> 59: </a><strong><font color="#4169E1">PETSC_EXTERN <a href="../manualpages/Sys/PetscErrorCode.html">PetscErrorCode</a> <a href="../manualpages/Sys/PetscBagView.html">PetscBagView</a>(<a href="../manualpages/Sys/PetscBag.html">PetscBag</a>, <a href="../manualpages/Viewer/PetscViewer.html">PetscViewer</a>)</font></strong>;
<a name="line60"> 60: </a><strong><font color="#4169E1">PETSC_EXTERN <a href="../manualpages/Sys/PetscErrorCode.html">PetscErrorCode</a> <a href="../manualpages/Sys/PetscBagLoad.html">PetscBagLoad</a>(<a href="../manualpages/Viewer/PetscViewer.html">PetscViewer</a>, <a href="../manualpages/Sys/PetscBag.html">PetscBag</a>)</font></strong>;
<a name="line61"> 61: </a><strong><font color="#4169E1">PETSC_EXTERN <a href="../manualpages/Sys/PetscErrorCode.html">PetscErrorCode</a> <a href="../manualpages/Sys/PetscBagViewFromOptions.html">PetscBagViewFromOptions</a>(<a href="../manualpages/Sys/PetscBag.html">PetscBag</a>, <a href="../manualpages/Sys/PetscObject.html">PetscObject</a>, const char[])</font></strong>;
<a name="line63"> 63: </a><strong><font color="#228B22">#define PETSC_BAG_FILE_CLASSID 1211219</font></strong>
</pre>
</body>
</html>
|
