xref: /petsc/include/petscfv.h (revision fbf9dbe564678ed6eff1806adbc4c4f01b9743f4)
1 /*
2       Objects which encapsulate finite volume spaces and operations
3 */
4 #ifndef PETSCFV_H
5 #define PETSCFV_H
6 
7 #include <petscdm.h>
8 #include <petscdt.h>
9 #include <petscspace.h>
10 #include <petscdualspace.h>
11 #include <petscfvtypes.h>
12 #include <petscdstypes.h>
13 
14 /* SUBMANSEC = FV */
15 
16 PETSC_EXTERN PetscClassId PETSCLIMITER_CLASSID;
17 
18 /*J
19   PetscLimiterType - String with the name of a PETSc finite volume slope limiter
20 
21   Level: beginner
22 
23 .seealso: `PetscLimiterSetType()`, `PetscLimiter`
24 J*/
25 typedef const char *PetscLimiterType;
26 #define PETSCLIMITERSIN       "sin"
27 #define PETSCLIMITERZERO      "zero"
28 #define PETSCLIMITERNONE      "none"
29 #define PETSCLIMITERMINMOD    "minmod"
30 #define PETSCLIMITERVANLEER   "vanleer"
31 #define PETSCLIMITERVANALBADA "vanalbada"
32 #define PETSCLIMITERSUPERBEE  "superbee"
33 #define PETSCLIMITERMC        "mc"
34 
35 PETSC_EXTERN PetscFunctionList PetscLimiterList;
36 PETSC_EXTERN PetscErrorCode    PetscLimiterCreate(MPI_Comm, PetscLimiter *);
37 PETSC_EXTERN PetscErrorCode    PetscLimiterDestroy(PetscLimiter *);
38 PETSC_EXTERN PetscErrorCode    PetscLimiterSetType(PetscLimiter, PetscLimiterType);
39 PETSC_EXTERN PetscErrorCode    PetscLimiterGetType(PetscLimiter, PetscLimiterType *);
40 PETSC_EXTERN PetscErrorCode    PetscLimiterSetUp(PetscLimiter);
41 PETSC_EXTERN PetscErrorCode    PetscLimiterSetFromOptions(PetscLimiter);
42 PETSC_EXTERN PetscErrorCode    PetscLimiterViewFromOptions(PetscLimiter, PetscObject, const char[]);
43 PETSC_EXTERN PetscErrorCode    PetscLimiterView(PetscLimiter, PetscViewer);
44 PETSC_EXTERN PetscErrorCode    PetscLimiterRegister(const char[], PetscErrorCode (*)(PetscLimiter));
45 PETSC_EXTERN PetscErrorCode    PetscLimiterRegisterDestroy(void);
46 
47 PETSC_EXTERN PetscErrorCode PetscLimiterLimit(PetscLimiter, PetscReal, PetscReal *);
48 
49 PETSC_EXTERN PetscErrorCode PetscFVInitializePackage(void);
50 
51 PETSC_EXTERN PetscClassId PETSCFV_CLASSID;
52 
53 /*J
54   PetscFVType - String with the name of a PETSc finite volume discretization
55 
56   Level: beginner
57 
58 .seealso: `PetscFVSetType()`, `PetscFV`
59 J*/
60 typedef const char *PetscFVType;
61 #define PETSCFVUPWIND       "upwind"
62 #define PETSCFVLEASTSQUARES "leastsquares"
63 
64 PETSC_EXTERN PetscFunctionList PetscFVList;
65 PETSC_EXTERN PetscErrorCode    PetscFVCreate(MPI_Comm, PetscFV *);
66 PETSC_EXTERN PetscErrorCode    PetscFVDestroy(PetscFV *);
67 PETSC_EXTERN PetscErrorCode    PetscFVSetType(PetscFV, PetscFVType);
68 PETSC_EXTERN PetscErrorCode    PetscFVGetType(PetscFV, PetscFVType *);
69 PETSC_EXTERN PetscErrorCode    PetscFVSetUp(PetscFV);
70 PETSC_EXTERN PetscErrorCode    PetscFVSetFromOptions(PetscFV);
71 PETSC_EXTERN PetscErrorCode    PetscFVViewFromOptions(PetscFV, PetscObject, const char[]);
72 PETSC_EXTERN PetscErrorCode    PetscFVView(PetscFV, PetscViewer);
73 PETSC_EXTERN PetscErrorCode    PetscFVRegister(const char[], PetscErrorCode (*)(PetscFV));
74 PETSC_EXTERN PetscErrorCode    PetscFVRegisterDestroy(void);
75 PETSC_EXTERN PetscErrorCode    PetscFVSetComponentName(PetscFV, PetscInt, const char[]);
76 PETSC_EXTERN PetscErrorCode    PetscFVGetComponentName(PetscFV, PetscInt, const char *[]);
77 
78 PETSC_EXTERN PetscErrorCode PetscFVSetLimiter(PetscFV, PetscLimiter);
79 PETSC_EXTERN PetscErrorCode PetscFVGetLimiter(PetscFV, PetscLimiter *);
80 PETSC_EXTERN PetscErrorCode PetscFVSetNumComponents(PetscFV, PetscInt);
81 PETSC_EXTERN PetscErrorCode PetscFVGetNumComponents(PetscFV, PetscInt *);
82 PETSC_EXTERN PetscErrorCode PetscFVSetSpatialDimension(PetscFV, PetscInt);
83 PETSC_EXTERN PetscErrorCode PetscFVGetSpatialDimension(PetscFV, PetscInt *);
84 PETSC_EXTERN PetscErrorCode PetscFVSetComputeGradients(PetscFV, PetscBool);
85 PETSC_EXTERN PetscErrorCode PetscFVGetComputeGradients(PetscFV, PetscBool *);
86 PETSC_EXTERN PetscErrorCode PetscFVSetQuadrature(PetscFV, PetscQuadrature);
87 PETSC_EXTERN PetscErrorCode PetscFVGetQuadrature(PetscFV, PetscQuadrature *);
88 PETSC_EXTERN PetscErrorCode PetscFVSetDualSpace(PetscFV, PetscDualSpace);
89 PETSC_EXTERN PetscErrorCode PetscFVGetDualSpace(PetscFV, PetscDualSpace *);
90 
91 PETSC_EXTERN PetscErrorCode PetscFVRefine(PetscFV, PetscFV *);
92 
93 PETSC_EXTERN PetscErrorCode PetscFVGetCellTabulation(PetscFV, PetscTabulation *);
94 PETSC_EXTERN PetscErrorCode PetscFVCreateTabulation(PetscFV, PetscInt, PetscInt, const PetscReal[], PetscInt, PetscTabulation *);
95 
96 PETSC_EXTERN PetscErrorCode PetscFVComputeGradient(PetscFV, PetscInt, PetscScalar[], PetscScalar[]);
97 PETSC_EXTERN PetscErrorCode PetscFVIntegrateRHSFunction(PetscFV, PetscDS, PetscInt, PetscInt, PetscFVFaceGeom *, PetscReal *, PetscScalar[], PetscScalar[], PetscScalar[], PetscScalar[]);
98 
99 PETSC_EXTERN PetscErrorCode PetscFVLeastSquaresSetMaxFaces(PetscFV, PetscInt);
100 
101 PETSC_EXTERN PetscErrorCode PetscDualSpaceApplyFVM(PetscDualSpace, PetscInt, PetscReal, PetscFVCellGeom *, PetscInt, PetscErrorCode (*)(PetscInt, PetscReal, const PetscReal[], PetscInt, PetscScalar *, void *), void *, PetscScalar *);
102 
103 #endif
104