1288c0443SJeremy L Thompson## libCEED + PETSc Examples 2819eb1b3Sjeremylt 3*ccb3a226Sjeremylt### CEED bakeoff problems with raw mesh management - bpsraw 4819eb1b3Sjeremylt 5*ccb3a226SjeremyltThis code solves the CEED bakeoff problems on a structured grid generated and referenced using only low-level communication primitives. 6819eb1b3Sjeremylt 7cb32e2e7SValeria BarraTo build, run `make bpsraw` 8819eb1b3Sjeremylt 9cb32e2e7SValeria BarraTo run, `./bpsraw -ceed [ceed-resource] -problem bp[1-6] -degree [degree]` 10819eb1b3Sjeremylt 11819eb1b3SjeremyltIn addition to the common arguments, the following arguments may be set: 12819eb1b3Sjeremylt 13819eb1b3Sjeremylt- `-local` - Target number of locally owned DoFs per process 14819eb1b3Sjeremylt 15cb32e2e7SValeria Barra### CEED bakeoff problems with DMPlex - bps 16819eb1b3Sjeremylt 17819eb1b3SjeremyltThis code solves the CEED bakeoff problems on a unstructured grid using DMPlex. 18819eb1b3SjeremyltThis example requires a PETSc version later than 3.11.3. 19819eb1b3Sjeremylt 20cb32e2e7SValeria BarraTo build, run `make bps` 21819eb1b3Sjeremylt 22cb32e2e7SValeria BarraTo run, `./bps -ceed [ceed-resource] -problem bp[1-6] -degree [degree]` 23819eb1b3Sjeremylt 24819eb1b3SjeremyltIn addition to the common arguments, the following arguments may be set: 25819eb1b3Sjeremylt 26819eb1b3Sjeremylt- `-mesh` - Read mesh from file 27819eb1b3Sjeremylt- `-cells` - Number of cells per dimension 286c5df90dSjeremylt 29565a3730SJed Brown#### Running a suite 30565a3730SJed Brown 31*ccb3a226SjeremyltSome run-time arguments can be passed lists, which allows a single `mpiexec` invocation to run many experiments. 32*ccb3a226SjeremyltFor example 33565a3730SJed Brown 34565a3730SJed Brown mpiexec -n 64 ./bps -problem bp1,bp2,bp3,bp4 -degree 2,3,5,7 \ 35565a3730SJed Brown -ceed /cpu/self/opt/serial,/cpu/self/xsmm/serial,/cpu/self/xsmm/blocked \ 36565a3730SJed Brown -local_nodes 600,20000 | tee bps.log 37565a3730SJed Brown 38*ccb3a226Sjeremyltwhich will sample from the `4*4*3=48` specified combinations, each of which will run a problem-size sweep of 600, 1200, 2400, 4800, 9600, 192000 FEM nodes per MPI rank. 39*ccb3a226SjeremyltThe resulting log file can be read by the Python plotting scripts in `benchmarks/`. 40565a3730SJed Brown 416c5df90dSjeremylt### CEED bakeoff problems with DMPlex and PCMG - multigrid 426c5df90dSjeremylt 43*ccb3a226SjeremyltThis code solves the CEED bakeoff problems on a unstructured grid using DMPlex with p-multigrid implemented in PCMG. 44*ccb3a226SjeremyltThis example requires a PETSc version later than 3.11.3. 456c5df90dSjeremylt 46cb32e2e7SValeria BarraTo build, run `make multigrid` 476c5df90dSjeremylt 48cb32e2e7SValeria BarraTo run, `./multigrid -ceed [ceed-resource] -problem bp[1-6] -degree [degree]` 496c5df90dSjeremylt 506c5df90dSjeremyltIn addition to the common arguments, the following arguments may be set: 516c5df90dSjeremylt 526c5df90dSjeremylt- `-mesh` - Read mesh from file 536c5df90dSjeremylt- `-cells` - Number of cells per dimension 54819eb1b3Sjeremylt 55288c0443SJeremy L Thompson### Command line arguments 56819eb1b3Sjeremylt 57cb32e2e7SValeria BarraThe following arguments can be specified for all of the above examples: 58819eb1b3Sjeremylt 59819eb1b3Sjeremylt- `-ceed` - CEED resource specifier 60819eb1b3Sjeremylt- `-problem` - CEED benchmark problem to solve 616c5df90dSjeremylt- `-degree` - Polynomial degree of tensor product basis 62819eb1b3Sjeremylt- `-qextra` - Number of extra quadrature points 63819eb1b3Sjeremylt- `-test` - Testing mode (do not print unless error is large) 64819eb1b3Sjeremylt- `-benchmark` - Benchmarking mode (prints benchmark statistics) 65cb32e2e7SValeria Barra 6632d2ee49SValeria Barra### libCEED example to compute surface area using DMPlex - area 67cb32e2e7SValeria Barra 6832d2ee49SValeria BarraThis example uses the mass matrix to compute the surface area of a cube or a discrete cubed-sphere, defined via DMPlex. 69cb32e2e7SValeria Barra 70cb32e2e7SValeria BarraTo build, run `make area` 71cb32e2e7SValeria Barra 7232d2ee49SValeria BarraTo run, `./area -problem cube -ceed [ceed-resource] -petscspace_degree [degree]` 73cb32e2e7SValeria Barra 7432d2ee49SValeria Barraor 75cb32e2e7SValeria Barra 7632d2ee49SValeria Barra`./area -problem sphere -ceed [ceed-resource] -petscspace_degree [degree]` 7732d2ee49SValeria Barra 7832d2ee49SValeria Barra#### Command line arguments 7932d2ee49SValeria Barra 8032d2ee49SValeria BarraThe following arguments can be specified for the area example: 81cb32e2e7SValeria Barra 82cb32e2e7SValeria Barra- `-ceed` - CEED resource specifier 8332d2ee49SValeria Barra- `-problem` - Problem to solve, either 'cube' or 'sphere' 84cb32e2e7SValeria Barra- `-petscspace_degree` - Polynomial degree of tensor product basis 85cb32e2e7SValeria Barra- `-qextra` - Number of extra quadrature points 86cb32e2e7SValeria Barra- `-test` - Testing mode (do not print unless error is large) 87cb32e2e7SValeria Barra- `-mesh` - Read mesh from file 88cb32e2e7SValeria Barra 89