xref: /libCEED/examples/petsc/README.md (revision e6a04bf5cb06fd03ee882d1ea55149c09771081b)
1## libCEED + PETSc Examples
2
3### CEED bakeoff problems - bps
4
5This code solves the CEED bakeoff problems on a structured grid generated and
6referenced using only low-level communication primitives.
7
8To build, run `make bps`.
9
10To run, `./bps -ceed [ceed-resource] -problem bp[1-6] -degree [degree]`.
11
12In addition to the common arguments, the following arguments may be set:
13
14- `-local`             - Target number of locally owned DoFs per process
15
16### CEED bakeoff problems with DMPlex - bpsdmplex
17
18This code solves the CEED bakeoff problems on a unstructured grid using DMPlex.
19This example requires a PETSc version later than 3.11.3.
20
21To build, run `make bpsdmplex`.
22
23To run, `./bpsdmplex -ceed [ceed-resource] -problem bp[1-6] -degree [degree]`.
24
25In addition to the common arguments, the following arguments may be set:
26
27- `-mesh`              - Read mesh from file
28- `-cells`             - Number of cells per dimension
29
30### CEED bakeoff problems with DMPlex and PCMG - multigrid
31
32This code solves the CEED bakeoff problems on a unstructured grid using DMPlex
33with p-multigrid implemented in PCMG. This example requires a PETSc version later than 3.11.3.
34
35To build, run `make multigrid`.
36
37To run, `./multigrid -ceed [ceed-resource] -problem bp[1-6] -degree [degree]`.
38
39In addition to the common arguments, the following arguments may be set:
40
41- `-mesh`              - Read mesh from file
42- `-cells`             - Number of cells per dimension
43
44### Command line arguments
45
46The following arguments can be specified for both examples:
47
48- `-ceed`              - CEED resource specifier
49- `-problem`           - CEED benchmark problem to solve
50- `-degree`            - Polynomial degree of tensor product basis
51- `-qextra`            - Number of extra quadrature points
52- `-test`              - Testing mode (do not print unless error is large)
53- `-benchmark`         - Benchmarking mode (prints benchmark statistics)
54