MFEM v4.7.0
Finite element discretization library
Loading...
Searching...
No Matches
mfem::Backend Struct Reference

MFEM backends. More...

#include <device.hpp>

Public Types

enum  Id : unsigned long {
  CPU = 1 << 0 , OMP = 1 << 1 , CUDA = 1 << 2 , HIP = 1 << 3 ,
  RAJA_CPU = 1 << 4 , RAJA_OMP = 1 << 5 , RAJA_CUDA = 1 << 6 , RAJA_HIP = 1 << 7 ,
  OCCA_CPU = 1 << 8 , OCCA_OMP = 1 << 9 , OCCA_CUDA = 1 << 10 , CEED_CPU = 1 << 11 ,
  CEED_CUDA = 1 << 12 , CEED_HIP = 1 << 13 , DEBUG_DEVICE = 1 << 14
}
 In the documentation below, we use square brackets to indicate the type of the backend: host or device. More...
 
enum  {
  NUM_BACKENDS = 15 , CPU_MASK = CPU | RAJA_CPU | OCCA_CPU | CEED_CPU , CUDA_MASK = CUDA | RAJA_CUDA | OCCA_CUDA | CEED_CUDA , HIP_MASK = HIP | RAJA_HIP | CEED_HIP ,
  OMP_MASK = OMP | RAJA_OMP | OCCA_OMP , CEED_MASK = CEED_CPU | CEED_CUDA | CEED_HIP , DEVICE_MASK = CUDA_MASK | HIP_MASK | DEBUG_DEVICE , RAJA_MASK = RAJA_CPU | RAJA_OMP | RAJA_CUDA | RAJA_HIP ,
  OCCA_MASK = OCCA_CPU | OCCA_OMP | OCCA_CUDA
}
 Additional useful constants. For example, the *_MASK constants can be used with Device::Allows(). More...
 

Detailed Description

MFEM backends.

Individual backends will generally implement only a subset of the kernels implemented by the default CPU backend. The goal of the backends is to accelerate data-parallel portions of the code and they can use a device memory space (e.g. GPUs) or share the memory space of the host (OpenMP).

Definition at line 27 of file device.hpp.

Member Enumeration Documentation

◆ anonymous enum

anonymous enum

Additional useful constants. For example, the *_MASK constants can be used with Device::Allows().

Enumerator
NUM_BACKENDS 

Number of backends: from (1 << 0) to (1 << (NUM_BACKENDS-1)).

CPU_MASK 

Biwise-OR of all CPU backends.

CUDA_MASK 

Biwise-OR of all CUDA backends.

HIP_MASK 

Biwise-OR of all HIP backends.

OMP_MASK 

Biwise-OR of all OpenMP backends.

CEED_MASK 

Bitwise-OR of all CEED backends.

DEVICE_MASK 

Biwise-OR of all device backends.

RAJA_MASK 

Biwise-OR of all RAJA backends.

OCCA_MASK 

Biwise-OR of all OCCA backends.

Definition at line 81 of file device.hpp.

◆ Id

enum mfem::Backend::Id : unsigned long

In the documentation below, we use square brackets to indicate the type of the backend: host or device.

Enumerator
CPU 

[host] Default CPU backend: sequential execution on each MPI rank.

OMP 

[host] OpenMP backend. Enabled when MFEM_USE_OPENMP = YES.

CUDA 

[device] CUDA backend. Enabled when MFEM_USE_CUDA = YES.

HIP 

[device] HIP backend. Enabled when MFEM_USE_HIP = YES.

RAJA_CPU 

[host] RAJA CPU backend: sequential execution on each MPI rank. Enabled when MFEM_USE_RAJA = YES.

RAJA_OMP 

[host] RAJA OpenMP backend. Enabled when MFEM_USE_RAJA = YES and MFEM_USE_OPENMP = YES.

RAJA_CUDA 

[device] RAJA CUDA backend. Enabled when MFEM_USE_RAJA = YES and MFEM_USE_CUDA = YES.

RAJA_HIP 

[device] RAJA HIP backend. Enabled when MFEM_USE_RAJA = YES and MFEM_USE_HIP = YES.

OCCA_CPU 

[host] OCCA CPU backend: sequential execution on each MPI rank. Enabled when MFEM_USE_OCCA = YES.

OCCA_OMP 

[host] OCCA OpenMP backend. Enabled when MFEM_USE_OCCA = YES.

OCCA_CUDA 

[device] OCCA CUDA backend. Enabled when MFEM_USE_OCCA = YES and MFEM_USE_CUDA = YES.

CEED_CPU 

[host] CEED CPU backend. GPU backends can still be used, but with expensive memory transfers. Enabled when MFEM_USE_CEED = YES.

CEED_CUDA 

[device] CEED CUDA backend working together with the CUDA backend. Enabled when MFEM_USE_CEED = YES and MFEM_USE_CUDA = YES. NOTE: The current default libCEED CUDA backend is non-deterministic!

CEED_HIP 

[device] CEED HIP backend working together with the HIP backend. Enabled when MFEM_USE_CEED = YES and MFEM_USE_HIP = YES.

DEBUG_DEVICE 

[device] Debug backend: host memory is READ/WRITE protected while a device is in use. It allows to test the "device" code-path (using separate host/device memory pools and host <-> device transfers) without any GPU hardware. As 'DEBUG' is sometimes used as a macro, _DEVICE has been added to avoid conflicts.

Definition at line 31 of file device.hpp.


The documentation for this struct was generated from the following file: