dtfft_parameters Module

This module defines common dtFFT parameters


Uses

  • module~~dtfft_parameters~~UsesGraph module~dtfft_parameters dtfft_parameters iso_c_binding iso_c_binding module~dtfft_parameters->iso_c_binding iso_fortran_env iso_fortran_env module~dtfft_parameters->iso_fortran_env mpi_f08 mpi_f08 module~dtfft_parameters->mpi_f08

Used by

  • module~~dtfft_parameters~~UsedByGraph module~dtfft_parameters dtfft_parameters module~dtfft dtfft module~dtfft->module~dtfft_parameters module~dtfft_config dtfft_config module~dtfft->module~dtfft_config module~dtfft_pencil dtfft_pencil module~dtfft->module~dtfft_pencil module~dtfft_plan dtfft_plan module~dtfft->module~dtfft_plan module~dtfft_abstract_backend dtfft_abstract_backend module~dtfft_abstract_backend->module~dtfft_parameters module~dtfft_abstract_backend->module~dtfft_config module~dtfft_interface_cuda_runtime dtfft_interface_cuda_runtime module~dtfft_abstract_backend->module~dtfft_interface_cuda_runtime module~dtfft_interface_nccl dtfft_interface_nccl module~dtfft_abstract_backend->module~dtfft_interface_nccl module~dtfft_nvrtc_kernel dtfft_nvrtc_kernel module~dtfft_abstract_backend->module~dtfft_nvrtc_kernel module~dtfft_abstract_backend->module~dtfft_pencil module~dtfft_utils dtfft_utils module~dtfft_abstract_backend->module~dtfft_utils module~dtfft_abstract_executor dtfft_abstract_executor module~dtfft_abstract_executor->module~dtfft_parameters module~dtfft_abstract_executor->module~dtfft_pencil module~dtfft_abstract_executor->module~dtfft_utils module~dtfft_interface_nvtx dtfft_interface_nvtx module~dtfft_abstract_executor->module~dtfft_interface_nvtx module~dtfft_abstract_transpose_plan dtfft_abstract_transpose_plan module~dtfft_abstract_transpose_plan->module~dtfft_parameters module~dtfft_abstract_transpose_plan->module~dtfft_abstract_backend module~dtfft_abstract_transpose_plan->module~dtfft_config module~dtfft_abstract_transpose_plan->module~dtfft_interface_cuda_runtime module~dtfft_abstract_transpose_plan->module~dtfft_interface_nccl module~dtfft_interface_nvshmem dtfft_interface_nvshmem module~dtfft_abstract_transpose_plan->module~dtfft_interface_nvshmem module~dtfft_abstract_transpose_plan->module~dtfft_nvrtc_kernel module~dtfft_abstract_transpose_plan->module~dtfft_pencil module~dtfft_abstract_transpose_plan->module~dtfft_utils module~dtfft_abstract_transpose_plan->module~dtfft_interface_nvtx module~dtfft_api dtfft_api module~dtfft_api->module~dtfft_parameters module~dtfft_api->module~dtfft_config module~dtfft_api->module~dtfft_pencil module~dtfft_api->module~dtfft_plan module~dtfft_api->module~dtfft_utils module~dtfft_backend_cufftmp_m dtfft_backend_cufftmp_m module~dtfft_backend_cufftmp_m->module~dtfft_parameters module~dtfft_backend_cufftmp_m->module~dtfft_abstract_backend module~dtfft_backend_cufftmp_m->module~dtfft_interface_cuda_runtime module~dtfft_interface_cufft dtfft_interface_cufft module~dtfft_backend_cufftmp_m->module~dtfft_interface_cufft module~dtfft_backend_cufftmp_m->module~dtfft_interface_nvshmem module~dtfft_backend_cufftmp_m->module~dtfft_pencil module~dtfft_backend_cufftmp_m->module~dtfft_utils module~dtfft_backend_mpi dtfft_backend_mpi module~dtfft_backend_mpi->module~dtfft_parameters module~dtfft_backend_mpi->module~dtfft_abstract_backend module~dtfft_backend_mpi->module~dtfft_interface_cuda_runtime module~dtfft_backend_mpi->module~dtfft_utils module~dtfft_backend_nccl_m dtfft_backend_nccl_m module~dtfft_backend_nccl_m->module~dtfft_parameters module~dtfft_backend_nccl_m->module~dtfft_abstract_backend module~dtfft_backend_nccl_m->module~dtfft_interface_cuda_runtime module~dtfft_backend_nccl_m->module~dtfft_interface_nccl module~dtfft_backend_nccl_m->module~dtfft_utils module~dtfft_config->module~dtfft_parameters module~dtfft_config->module~dtfft_interface_cuda_runtime module~dtfft_config->module~dtfft_utils module~dtfft_executor_cufft_m dtfft_executor_cufft_m module~dtfft_executor_cufft_m->module~dtfft_parameters module~dtfft_executor_cufft_m->module~dtfft_abstract_executor module~dtfft_executor_cufft_m->module~dtfft_config module~dtfft_executor_cufft_m->module~dtfft_interface_cuda_runtime module~dtfft_executor_cufft_m->module~dtfft_interface_cufft module~dtfft_executor_cufft_m->module~dtfft_utils module~dtfft_executor_fftw_m dtfft_executor_fftw_m module~dtfft_executor_fftw_m->module~dtfft_parameters module~dtfft_executor_fftw_m->module~dtfft_abstract_executor module~dtfft_executor_fftw_m->module~dtfft_pencil module~dtfft_executor_fftw_m->module~dtfft_utils module~dtfft_executor_mkl_m dtfft_executor_mkl_m module~dtfft_executor_mkl_m->module~dtfft_parameters module~dtfft_executor_mkl_m->module~dtfft_abstract_executor module~dtfft_executor_mkl_m->module~dtfft_utils module~dtfft_interface_mkl_m dtfft_interface_mkl_m module~dtfft_executor_mkl_m->module~dtfft_interface_mkl_m module~dtfft_executor_vkfft_m dtfft_executor_vkfft_m module~dtfft_executor_vkfft_m->module~dtfft_parameters module~dtfft_executor_vkfft_m->module~dtfft_abstract_executor module~dtfft_executor_vkfft_m->module~dtfft_config module~dtfft_interface_vkfft_m dtfft_interface_vkfft_m module~dtfft_executor_vkfft_m->module~dtfft_interface_vkfft_m module~dtfft_interface_cuda dtfft_interface_cuda module~dtfft_interface_cuda->module~dtfft_parameters module~dtfft_interface_cuda->module~dtfft_utils module~dtfft_interface_cuda_runtime->module~dtfft_parameters module~dtfft_interface_cuda_runtime->module~dtfft_utils module~dtfft_interface_cufft->module~dtfft_parameters module~dtfft_interface_cufft->module~dtfft_utils module~dtfft_interface_nccl->module~dtfft_parameters module~dtfft_interface_nccl->module~dtfft_utils module~dtfft_interface_nvshmem->module~dtfft_parameters module~dtfft_interface_nvshmem->module~dtfft_utils module~dtfft_interface_vkfft_m->module~dtfft_parameters module~dtfft_interface_vkfft_m->module~dtfft_utils module~dtfft_nvrtc_block_optimizer dtfft_nvrtc_block_optimizer module~dtfft_nvrtc_block_optimizer->module~dtfft_parameters module~dtfft_nvrtc_block_optimizer->module~dtfft_config module~dtfft_nvrtc_block_optimizer->module~dtfft_interface_cuda module~dtfft_nvrtc_block_optimizer->module~dtfft_interface_cuda_runtime module~dtfft_nvrtc_block_optimizer->module~dtfft_utils module~dtfft_nvrtc_kernel->module~dtfft_parameters module~dtfft_nvrtc_kernel->module~dtfft_config module~dtfft_nvrtc_kernel->module~dtfft_interface_cuda module~dtfft_nvrtc_kernel->module~dtfft_interface_cuda_runtime module~dtfft_nvrtc_kernel->module~dtfft_nvrtc_block_optimizer module~dtfft_nvrtc_kernel_cache dtfft_nvrtc_kernel_cache module~dtfft_nvrtc_kernel->module~dtfft_nvrtc_kernel_cache module~dtfft_nvrtc_kernel_generator dtfft_nvrtc_kernel_generator module~dtfft_nvrtc_kernel->module~dtfft_nvrtc_kernel_generator module~dtfft_nvrtc_kernel->module~dtfft_utils module~dtfft_interface_nvrtc dtfft_interface_nvrtc module~dtfft_nvrtc_kernel->module~dtfft_interface_nvrtc module~dtfft_nvrtc_kernel->module~dtfft_interface_nvtx module~dtfft_nvrtc_kernel_cache->module~dtfft_parameters module~dtfft_nvrtc_kernel_cache->module~dtfft_config module~dtfft_nvrtc_kernel_cache->module~dtfft_interface_cuda module~dtfft_nvrtc_kernel_cache->module~dtfft_interface_cuda_runtime module~dtfft_nvrtc_kernel_cache->module~dtfft_utils module~dtfft_nvrtc_kernel_generator->module~dtfft_parameters module~dtfft_nvrtc_kernel_generator->module~dtfft_interface_cuda module~dtfft_nvrtc_kernel_generator->module~dtfft_interface_cuda_runtime module~dtfft_nvrtc_kernel_generator->module~dtfft_nvrtc_block_optimizer module~dtfft_nvrtc_kernel_generator->module~dtfft_utils module~dtfft_nvrtc_kernel_generator->module~dtfft_interface_nvrtc module~dtfft_pencil->module~dtfft_parameters module~dtfft_pencil->module~dtfft_interface_cuda_runtime module~dtfft_pencil->module~dtfft_utils module~dtfft_plan->module~dtfft_parameters module~dtfft_plan->module~dtfft_abstract_executor module~dtfft_plan->module~dtfft_abstract_transpose_plan module~dtfft_plan->module~dtfft_config module~dtfft_plan->module~dtfft_executor_cufft_m module~dtfft_plan->module~dtfft_executor_fftw_m module~dtfft_plan->module~dtfft_executor_mkl_m module~dtfft_plan->module~dtfft_executor_vkfft_m module~dtfft_plan->module~dtfft_interface_cuda_runtime module~dtfft_plan->module~dtfft_interface_nvshmem module~dtfft_plan->module~dtfft_pencil module~dtfft_transpose_plan_cuda dtfft_transpose_plan_cuda module~dtfft_plan->module~dtfft_transpose_plan_cuda module~dtfft_transpose_plan_host dtfft_transpose_plan_host module~dtfft_plan->module~dtfft_transpose_plan_host module~dtfft_plan->module~dtfft_utils module~dtfft_plan->module~dtfft_interface_nvtx module~dtfft_transpose_handle_cuda dtfft_transpose_handle_cuda module~dtfft_transpose_handle_cuda->module~dtfft_parameters module~dtfft_transpose_handle_cuda->module~dtfft_abstract_backend module~dtfft_transpose_handle_cuda->module~dtfft_backend_cufftmp_m module~dtfft_transpose_handle_cuda->module~dtfft_backend_mpi module~dtfft_transpose_handle_cuda->module~dtfft_backend_nccl_m module~dtfft_transpose_handle_cuda->module~dtfft_interface_cuda_runtime module~dtfft_transpose_handle_cuda->module~dtfft_nvrtc_kernel module~dtfft_transpose_handle_cuda->module~dtfft_pencil module~dtfft_transpose_handle_cuda->module~dtfft_utils module~dtfft_transpose_handle_cuda->module~dtfft_interface_nvtx module~dtfft_transpose_handle_host dtfft_transpose_handle_host module~dtfft_transpose_handle_host->module~dtfft_parameters module~dtfft_transpose_handle_host->module~dtfft_pencil module~dtfft_transpose_handle_host->module~dtfft_interface_nvtx module~dtfft_transpose_plan_cuda->module~dtfft_parameters module~dtfft_transpose_plan_cuda->module~dtfft_abstract_backend module~dtfft_transpose_plan_cuda->module~dtfft_abstract_transpose_plan module~dtfft_transpose_plan_cuda->module~dtfft_config module~dtfft_transpose_plan_cuda->module~dtfft_interface_cuda module~dtfft_transpose_plan_cuda->module~dtfft_interface_cuda_runtime module~dtfft_transpose_plan_cuda->module~dtfft_nvrtc_kernel_cache module~dtfft_transpose_plan_cuda->module~dtfft_pencil module~dtfft_transpose_plan_cuda->module~dtfft_transpose_handle_cuda module~dtfft_transpose_plan_cuda->module~dtfft_utils module~dtfft_transpose_plan_cuda->module~dtfft_interface_nvrtc module~dtfft_transpose_plan_cuda->module~dtfft_interface_nvtx module~dtfft_transpose_plan_host->module~dtfft_parameters module~dtfft_transpose_plan_host->module~dtfft_abstract_transpose_plan module~dtfft_transpose_plan_host->module~dtfft_config module~dtfft_transpose_plan_host->module~dtfft_pencil module~dtfft_transpose_plan_host->module~dtfft_transpose_handle_host module~dtfft_transpose_plan_host->module~dtfft_utils module~dtfft_transpose_plan_host->module~dtfft_interface_nvtx module~dtfft_utils->module~dtfft_parameters module~dtfft_interface_mkl_m->module~dtfft_utils module~dtfft_interface_nvrtc->module~dtfft_utils module~dtfft_interface_nvtx->module~dtfft_utils

Variables

Type Visibility Attributes Name Initial
integer(kind=int32), public, parameter :: DTFFT_VERSION_MAJOR = 2

dtFFT Major Version
integer(kind=int32), public, parameter :: DTFFT_VERSION_MINOR = 2

dtFFT Minor Version
integer(kind=int32), public, parameter :: DTFFT_VERSION_PATCH = 0

dtFFT Patch Version
integer(kind=int32), public, parameter :: DTFFT_VERSION_CODE = 202000

dtFFT Version Code. Can be used in Version comparison
real(kind=real32), public, parameter :: MAX_REAL32 = huge(1._real32)

Maximum value of real32
integer(kind=int32), public, parameter :: MAX_INT32 = huge(1_int32)

Maximum value of int32
type(dtfft_execute_t), public, parameter :: DTFFT_EXECUTE_FORWARD = dtfft_execute_t(11)

Perform XYZ –> YXZ –> ZXY plan execution (Forward)
type(dtfft_execute_t), public, parameter :: DTFFT_EXECUTE_BACKWARD = dtfft_execute_t(12)

Perform ZXY –> YXZ –> XYZ plan execution (Backward)
type(dtfft_transpose_t), public, parameter :: DTFFT_TRANSPOSE_X_TO_Y = dtfft_transpose_t(+1)

Perform single transposition, from X aligned to Y aligned
type(dtfft_transpose_t), public, parameter :: DTFFT_TRANSPOSE_Y_TO_X = dtfft_transpose_t((-1))

Perform single transposition, from Y aligned to X aligned
type(dtfft_transpose_t), public, parameter :: DTFFT_TRANSPOSE_X_TO_Z = dtfft_transpose_t(+3)

Perform single transposition, from X aligned to Z aligned
type(dtfft_transpose_t), public, parameter :: DTFFT_TRANSPOSE_Y_TO_Z = dtfft_transpose_t(+2)

Perform single transposition, from Y aligned to Z aligned
type(dtfft_transpose_t), public, parameter :: DTFFT_TRANSPOSE_Z_TO_Y = dtfft_transpose_t((-2))

Perform single transposition, from Z aligned to Y aligned
type(dtfft_transpose_t), public, parameter :: DTFFT_TRANSPOSE_Z_TO_X = dtfft_transpose_t((-3))

Perform single transposition, from Z aligned to X aligned
character(len=*), public, parameter :: TRANSPOSE_NAMES(-3:3) = ["Z_TO_X", "Z_TO_Y", "Y_TO_X", " NULL ", "X_TO_Y", "Y_TO_Z", "X_TO_Z"]

String representation of dtfft_transpose_t
type(dtfft_executor_t), public, parameter :: DTFFT_EXECUTOR_NONE = dtfft_executor_t(0)

Do not setup any executor. If this type is provided, then execute method should not be called. Use transpose method instead
type(dtfft_executor_t), public, parameter :: DTFFT_EXECUTOR_FFTW3 = dtfft_executor_t(1)

FFTW3 executor
type(dtfft_executor_t), public, parameter :: DTFFT_EXECUTOR_MKL = dtfft_executor_t(2)

MKL executor
type(dtfft_executor_t), public, parameter :: DTFFT_EXECUTOR_CUFFT = dtfft_executor_t(3)

cuFFT GPU executor
type(dtfft_executor_t), public, parameter :: DTFFT_EXECUTOR_VKFFT = dtfft_executor_t(4)

VkFFT GPU executor
integer(kind=int8), public, parameter :: FFT_FORWARD = (-1)

Forward c2c transform
integer(kind=int8), public, parameter :: FFT_BACKWARD = (+1)

Backward c2c transform
type(dtfft_effort_t), public, parameter :: DTFFT_ESTIMATE = dtfft_effort_t(0)

Estimate flag. dtFFT will use default decomposition provided by MPI_Dims_create
type(dtfft_effort_t), public, parameter :: DTFFT_MEASURE = dtfft_effort_t(+1)

Measure flag. dtFFT will run transpose routines to find the best grid decomposition. Passing this flag and MPI Communicator with Cartesian topology to plan%create makes dtFFT do nothing.
type(dtfft_effort_t), public, parameter :: DTFFT_PATIENT = dtfft_effort_t(+2)

Patient flag. Same as DTFFT_MEASURE, but different MPI datatypes will also be tested
type(dtfft_precision_t), public, parameter :: DTFFT_SINGLE = dtfft_precision_t(0)

Use single precision
type(dtfft_precision_t), public, parameter :: DTFFT_DOUBLE = dtfft_precision_t(+1)

Use double precision
type(dtfft_r2r_kind_t), public, parameter :: DTFFT_DCT_1 = dtfft_r2r_kind_t(+3)

DCT-I (Logical N=2*(n-1), inverse is DTFFT_DCT_1)
type(dtfft_r2r_kind_t), public, parameter :: DTFFT_DCT_2 = dtfft_r2r_kind_t(+5)

DCT-II (Logical N=2*n, inverse is DTFFT_DCT_3)
type(dtfft_r2r_kind_t), public, parameter :: DTFFT_DCT_3 = dtfft_r2r_kind_t(+4)

DCT-III (Logical N=2*n, inverse is DTFFT_DCT_2)
type(dtfft_r2r_kind_t), public, parameter :: DTFFT_DCT_4 = dtfft_r2r_kind_t(+6)

DCT-IV (Logical N=2*n, inverse is DTFFT_DCT_4)
type(dtfft_r2r_kind_t), public, parameter :: DTFFT_DST_1 = dtfft_r2r_kind_t(+7)

DST-I (Logical N=2*(n+1), inverse is DTFFT_DST_1)
type(dtfft_r2r_kind_t), public, parameter :: DTFFT_DST_2 = dtfft_r2r_kind_t(+9)

DST-II (Logical N=2*n, inverse is DTFFT_DST_3)
type(dtfft_r2r_kind_t), public, parameter :: DTFFT_DST_3 = dtfft_r2r_kind_t(+8)

DST-III (Logical N=2*n, inverse is DTFFT_DST_2)
type(dtfft_r2r_kind_t), public, parameter :: DTFFT_DST_4 = dtfft_r2r_kind_t(+10)

DST-IV (Logical N=2*n, inverse is DTFFT_DST_4)
integer(kind=int64), public, parameter :: DOUBLE_COMPLEX_STORAGE_SIZE = storage_size((1._real64, 1._real64))/8_int64

Number of bytes to store single double precision complex element
integer(kind=int64), public, parameter :: COMPLEX_STORAGE_SIZE = storage_size((1._real32, 1._real32))/8_int64

Number of bytes to store single float precision complex element
integer(kind=int64), public, parameter :: DOUBLE_STORAGE_SIZE = storage_size(1._real64)/8_int64

Number of bytes to store single double precision real element
integer(kind=int64), public, parameter :: FLOAT_STORAGE_SIZE = storage_size(1._real32)/8_int64

Number of bytes to store single single precision real element
integer(kind=int32), public, parameter :: COLOR_CREATE = int(Z'00FAB53C')

Color for plan.create
integer(kind=int32), public, parameter :: COLOR_EXECUTE = int(Z'00E25DFC')

Color for plan.execute
integer(kind=int32), public, parameter :: COLOR_TRANSPOSE = int(Z'00B175BD')

Color for plan.transpose
integer(kind=int32), public, parameter :: COLOR_TRANSPOSE_XY = int(Z'005DFCCA')

Color for DTFFT_TRANSPOSE_X_TO_Y
integer(kind=int32), public, parameter :: COLOR_TRANSPOSE_YX = int(Z'0076A797')

Color for DTFFT_TRANSPOSE_Y_TO_X
integer(kind=int32), public, parameter :: COLOR_TRANSPOSE_YZ = int(Z'00E3CF9F')

Color for DTFFT_TRANSPOSE_Y_TO_Z
integer(kind=int32), public, parameter :: COLOR_TRANSPOSE_ZY = int(Z'008C826A')

Color for DTFFT_TRANSPOSE_Z_TO_Y
integer(kind=int32), public, parameter :: COLOR_TRANSPOSE_XZ = int(Z'00546F66')

Color for DTFFT_TRANSPOSE_X_TO_Z
integer(kind=int32), public, parameter :: COLOR_TRANSPOSE_ZX = int(Z'007A6D7D')

Color for DTFFT_TRANSPOSE_Z_TO_X
integer(kind=int32), public, parameter :: COLOR_FFT = int(Z'00FCD05D')

Color for FFT
integer(kind=int32), public, parameter :: COLOR_AUTOTUNE = int(Z'006075FF')

Color for Autotune
integer(kind=int32), public, parameter :: COLOR_AUTOTUNE2 = int(Z'0056E874')

Color for Autotune2
integer(kind=int32), public, parameter :: COLOR_DESTROY = int(Z'00000000')

Color for plan.destroy
integer(kind=int32), public, parameter :: COLOR_TRANSPOSE_PALLETTE(-3:3) = [COLOR_TRANSPOSE_ZX, COLOR_TRANSPOSE_ZY, COLOR_TRANSPOSE_YX, 0, COLOR_TRANSPOSE_XY, COLOR_TRANSPOSE_YZ, COLOR_TRANSPOSE_XZ]

Color pallete for plan.transpose
integer(kind=int32), public, parameter :: VARIABLE_NOT_SET = -111

Default value when environ is not set
type(dtfft_backend_t), public, parameter :: DTFFT_BACKEND_MPI_DATATYPE = dtfft_backend_t(21)

Backend that uses MPI datatypes Not really recommended to use, since it is a million times slower than other backends Left here just to show how slow MPI Datatypes are for GPU usage
type(dtfft_backend_t), public, parameter :: DTFFT_BACKEND_MPI_P2P = dtfft_backend_t(22)

MPI peer-to-peer algorithm
type(dtfft_backend_t), public, parameter :: DTFFT_BACKEND_MPI_A2A = dtfft_backend_t(23)

MPI backend using MPI_Alltoallv
type(dtfft_backend_t), public, parameter :: DTFFT_BACKEND_NCCL = dtfft_backend_t(24)

NCCL backend
type(dtfft_backend_t), public, parameter :: DTFFT_BACKEND_MPI_P2P_PIPELINED = dtfft_backend_t(26)

MPI peer-to-peer algorithm with overlapping data copying and unpacking
type(dtfft_backend_t), public, parameter :: DTFFT_BACKEND_NCCL_PIPELINED = dtfft_backend_t(27)

NCCL backend with overlapping data copying and unpacking
type(dtfft_backend_t), public, parameter :: DTFFT_BACKEND_CUFFTMP = dtfft_backend_t(25)

cuFFTMp backend
type(dtfft_backend_t), public, parameter :: DTFFT_BACKEND_CUFFTMP_PIPELINED = dtfft_backend_t(28)

cuFFTMp backend that uses extra buffer to gain performance
type(dtfft_backend_t), public, parameter :: BACKEND_NOT_SET = dtfft_backend_t(VARIABLE_NOT_SET)

Backend is not used
type(dtfft_backend_t), public, parameter :: VALID_GPU_BACKENDS(*) = [DTFFT_BACKEND_MPI_DATATYPE, DTFFT_BACKEND_MPI_P2P, DTFFT_BACKEND_MPI_A2A, DTFFT_BACKEND_MPI_P2P_PIPELINED, DTFFT_BACKEND_NCCL_PIPELINED, DTFFT_BACKEND_NCCL, DTFFT_BACKEND_CUFFTMP, DTFFT_BACKEND_CUFFTMP_PIPELINED]

List of valid GPU backends that dtFFT was compiled for
type(dtfft_stream_t), public, parameter :: NULL_STREAM = dtfft_stream_t(c_null_ptr)
type(dtfft_platform_t), public, parameter :: DTFFT_PLATFORM_HOST = dtfft_platform_t(1)

Host platform
type(dtfft_platform_t), public, parameter :: DTFFT_PLATFORM_CUDA = dtfft_platform_t(2)

CUDA platform
type(kernel_type_t), public, parameter :: KERNEL_DUMMY = kernel_type_t(-1)

Dummy kernel, does nothing
type(kernel_type_t), public, parameter :: KERNEL_TRANSPOSE = kernel_type_t(1)

Basic transpose kernel type.
type(kernel_type_t), public, parameter :: KERNEL_TRANSPOSE_PACKED = kernel_type_t(2)

Transposes data and packs it into contiguous buffer. Should be used only in X-Y 3D plans.
type(kernel_type_t), public, parameter :: KERNEL_UNPACK = kernel_type_t(3)

Unpacks contiguous buffer.
type(kernel_type_t), public, parameter :: KERNEL_UNPACK_SIMPLE_COPY = kernel_type_t(4)

Doesn’t actually unpacks anything. Performs cudaMemcpyAsync call. Should be used only when backend is DTFFT_GPU_BACKEND_CUFFTMP.
type(kernel_type_t), public, parameter :: KERNEL_UNPACK_PIPELINED = kernel_type_t(5)

Unpacks pack of contiguous buffer recieved from rank.
type(kernel_type_t), public, parameter :: KERNEL_UNPACK_PARTIAL = kernel_type_t(6)

Unpacks contiguous buffer recieved from everyone except myself.
type(dtfft_platform_t), public, parameter :: PLATFORM_NOT_SET = dtfft_platform_t(VARIABLE_NOT_SET)
type(dtfft_execute_t), private, parameter :: VALID_EXECUTE_TYPES(*) = [DTFFT_EXECUTE_FORWARD, DTFFT_EXECUTE_BACKWARD]

Valid execute types
type(dtfft_transpose_t), private, parameter :: VALID_TRANSPOSE_TYPES(*) = [DTFFT_TRANSPOSE_X_TO_Y, DTFFT_TRANSPOSE_Y_TO_X, DTFFT_TRANSPOSE_Y_TO_Z, DTFFT_TRANSPOSE_Z_TO_Y, DTFFT_TRANSPOSE_X_TO_Z, DTFFT_TRANSPOSE_Z_TO_X]

Types of transpose that are valid to pass to transpose method
type(dtfft_executor_t), private, parameter :: VALID_EXECUTORS(*) = [DTFFT_EXECUTOR_NONE, DTFFT_EXECUTOR_FFTW3, DTFFT_EXECUTOR_MKL, DTFFT_EXECUTOR_CUFFT, DTFFT_EXECUTOR_VKFFT]

List of valid executors
type(dtfft_executor_t), private, parameter :: HOST_EXECUTORS(*) = [DTFFT_EXECUTOR_NONE, DTFFT_EXECUTOR_FFTW3, DTFFT_EXECUTOR_MKL]

List of host executors
type(dtfft_executor_t), private, parameter :: CUDA_EXECUTORS(*) = [DTFFT_EXECUTOR_NONE, DTFFT_EXECUTOR_CUFFT, DTFFT_EXECUTOR_VKFFT]

List of CUDA executors
type(dtfft_effort_t), private, parameter :: VALID_EFFORTS(*) = [DTFFT_ESTIMATE, DTFFT_MEASURE, DTFFT_PATIENT]

Valid effort flags
type(dtfft_precision_t), private, parameter :: VALID_PRECISIONS(*) = [DTFFT_SINGLE, DTFFT_DOUBLE]

Valid precision flags
type(dtfft_r2r_kind_t), private, parameter :: VALID_R2R_KINDS(*) = [DTFFT_DCT_1, DTFFT_DCT_2, DTFFT_DCT_3, DTFFT_DCT_4, DTFFT_DST_1, DTFFT_DST_2, DTFFT_DST_3, DTFFT_DST_4]

Array of valid R2R kinds
integer(kind=int8), private, parameter :: VALID_DIMENSIONS(*) = [2_int8, 3_int8]

Valid dimensions for plan.create
integer(kind=int32), private, parameter :: VALID_COMM_TYPES(*) = [MPI_UNDEFINED, MPI_CART]

Valid communicator types for plan.create
type(dtfft_backend_t), private, parameter :: PIPELINED_BACKENDS(*) = [DTFFT_BACKEND_MPI_P2P_PIPELINED, DTFFT_BACKEND_NCCL_PIPELINED, DTFFT_BACKEND_CUFFTMP_PIPELINED]

List of pipelined backends
type(dtfft_backend_t), private, parameter :: MPI_BACKENDS(*) = [DTFFT_BACKEND_MPI_P2P, DTFFT_BACKEND_MPI_A2A, DTFFT_BACKEND_MPI_P2P_PIPELINED]

List of MPI backends
type(dtfft_backend_t), private, parameter :: NCCL_BACKENDS(*) = [DTFFT_BACKEND_NCCL, DTFFT_BACKEND_NCCL_PIPELINED]

List of NCCL backends
type(dtfft_backend_t), private, parameter :: CUFFTMP_BACKENDS(*) = [DTFFT_BACKEND_CUFFTMP, DTFFT_BACKEND_CUFFTMP_PIPELINED]

List of cuFFTMp backends
type(dtfft_backend_t), private, parameter :: NVSHMEM_BACKENDS(*) = [DTFFT_BACKEND_CUFFTMP, DTFFT_BACKEND_CUFFTMP_PIPELINED]

List of NVSHMEM-based backends
type(dtfft_platform_t), private, parameter :: VALID_PLATFORMS(*) = [DTFFT_PLATFORM_HOST, DTFFT_PLATFORM_CUDA]

Valid platforms
type(kernel_type_t), private, parameter :: TRANSPOSE_KERNELS(*) = [KERNEL_TRANSPOSE, KERNEL_TRANSPOSE_PACKED]

List of all transpose kernel types
type(kernel_type_t), private, parameter :: UNPACK_KERNELS(*) = [KERNEL_UNPACK, KERNEL_UNPACK_PIPELINED, KERNEL_UNPACK_PARTIAL]

List of all unpack kernel types

Interfaces

public interface dtfft_get_version

Get dtFFT version

  • private function dtfft_get_version_current() bind(C)

    Returns the current version code

    Arguments

    None

    Return Value integer(kind=c_int32_t)

  • private function dtfft_get_version_required(major, minor, patch)

    Returns the version code required by the user

    Arguments

    Type IntentOptional Attributes Name
    integer(kind=int32), intent(in) :: major

    Major version
    integer(kind=int32), intent(in) :: minor

    Minor version
    integer(kind=int32), intent(in) :: patch

    Patch version

    Return Value integer(kind=int32)

public interface operator(==)

  • private pure elemental function execute_type_eq(left, right) result(res)

    Arguments

    Type IntentOptional Attributes Name
    type(dtfft_execute_t), intent(in) :: left
    type(dtfft_execute_t), intent(in) :: right

    Return Value logical

  • private pure elemental function transpose_type_eq(left, right) result(res)

    Arguments

    Type IntentOptional Attributes Name
    type(dtfft_transpose_t), intent(in) :: left
    type(dtfft_transpose_t), intent(in) :: right

    Return Value logical

  • private pure elemental function executor_eq(left, right) result(res)

    Arguments

    Type IntentOptional Attributes Name
    type(dtfft_executor_t), intent(in) :: left
    type(dtfft_executor_t), intent(in) :: right

    Return Value logical

  • private pure elemental function effort_eq(left, right) result(res)

    Arguments

    Type IntentOptional Attributes Name
    type(dtfft_effort_t), intent(in) :: left
    type(dtfft_effort_t), intent(in) :: right

    Return Value logical

  • private pure elemental function precision_eq(left, right) result(res)

    Arguments

    Type IntentOptional Attributes Name
    type(dtfft_precision_t), intent(in) :: left
    type(dtfft_precision_t), intent(in) :: right

    Return Value logical

  • private pure elemental function r2r_kind_eq(left, right) result(res)

    Arguments

    Type IntentOptional Attributes Name
    type(dtfft_r2r_kind_t), intent(in) :: left
    type(dtfft_r2r_kind_t), intent(in) :: right

    Return Value logical

  • private pure elemental function platform_eq(left, right) result(res)

    Arguments

    Type IntentOptional Attributes Name
    type(dtfft_platform_t), intent(in) :: left
    type(dtfft_platform_t), intent(in) :: right

    Return Value logical

  • private pure elemental function gpu_backend_eq(left, right) result(res)

    Arguments

    Type IntentOptional Attributes Name
    type(dtfft_backend_t), intent(in) :: left
    type(dtfft_backend_t), intent(in) :: right

    Return Value logical

  • private pure elemental function kernel_type_eq(left, right) result(res)

    Arguments

    Type IntentOptional Attributes Name
    type(kernel_type_t), intent(in) :: left
    type(kernel_type_t), intent(in) :: right

    Return Value logical

public interface operator(/=)

  • private pure elemental function execute_type_ne(left, right) result(res)

    Arguments

    Type IntentOptional Attributes Name
    type(dtfft_execute_t), intent(in) :: left
    type(dtfft_execute_t), intent(in) :: right

    Return Value logical

  • private pure elemental function transpose_type_ne(left, right) result(res)

    Arguments

    Type IntentOptional Attributes Name
    type(dtfft_transpose_t), intent(in) :: left
    type(dtfft_transpose_t), intent(in) :: right

    Return Value logical

  • private pure elemental function executor_ne(left, right) result(res)

    Arguments

    Type IntentOptional Attributes Name
    type(dtfft_executor_t), intent(in) :: left
    type(dtfft_executor_t), intent(in) :: right

    Return Value logical

  • private pure elemental function effort_ne(left, right) result(res)

    Arguments

    Type IntentOptional Attributes Name
    type(dtfft_effort_t), intent(in) :: left
    type(dtfft_effort_t), intent(in) :: right

    Return Value logical

  • private pure elemental function precision_ne(left, right) result(res)

    Arguments

    Type IntentOptional Attributes Name
    type(dtfft_precision_t), intent(in) :: left
    type(dtfft_precision_t), intent(in) :: right

    Return Value logical

  • private pure elemental function r2r_kind_ne(left, right) result(res)

    Arguments

    Type IntentOptional Attributes Name
    type(dtfft_r2r_kind_t), intent(in) :: left
    type(dtfft_r2r_kind_t), intent(in) :: right

    Return Value logical

  • private pure elemental function platform_ne(left, right) result(res)

    Arguments

    Type IntentOptional Attributes Name
    type(dtfft_platform_t), intent(in) :: left
    type(dtfft_platform_t), intent(in) :: right

    Return Value logical

  • private pure elemental function gpu_backend_ne(left, right) result(res)

    Arguments

    Type IntentOptional Attributes Name
    type(dtfft_backend_t), intent(in) :: left
    type(dtfft_backend_t), intent(in) :: right

    Return Value logical

  • private pure elemental function kernel_type_ne(left, right) result(res)

    Arguments

    Type IntentOptional Attributes Name
    type(kernel_type_t), intent(in) :: left
    type(kernel_type_t), intent(in) :: right

    Return Value logical

public interface dtfft_stream_t

Creates dtfft_stream_t from integer(cuda_stream_kind)

  • private function stream_from_int64(cuda_stream) result(stream)

    Creates dtfft_stream_t from integer(cuda_stream_kind)

    Arguments

    Type IntentOptional Attributes Name
    integer(kind=int64), intent(in) :: cuda_stream

    CUDA stream

    Return Value type(dtfft_stream_t)

    dtfft Stream


Derived Types

type, public, bind(C) ::  dtfft_execute_t

Type that is used during call to execute method

Components

Type Visibility Attributes Name Initial
integer(kind=c_int32_t), public :: val

Internal value

type, public, bind(C) ::  dtfft_transpose_t

Type that is used during call to transpose method

Components

Type Visibility Attributes Name Initial
integer(kind=c_int32_t), public :: val

Internal value

type, public, bind(C) ::  dtfft_executor_t

Type that specifies external FFT executor

Components

Type Visibility Attributes Name Initial
integer(kind=c_int32_t), public :: val

Internal value

type, public, bind(C) ::  dtfft_effort_t

Type that specifies effort that dtFFT should use when creating plan

Components

Type Visibility Attributes Name Initial
integer(kind=c_int32_t), public :: val

Internal value

type, public, bind(C) ::  dtfft_precision_t

Type that specifies precision of dtFFT plan

Components

Type Visibility Attributes Name Initial
integer(kind=c_int32_t), public :: val

Internal value

type, public, bind(C) ::  dtfft_r2r_kind_t

Type that specifies various kinds of R2R FFTs

Components

Type Visibility Attributes Name Initial
integer(kind=c_int32_t), public :: val

Internal value

type, public, bind(C) ::  dtfft_backend_t

Type that specifies various GPU Backend present in dtFFT

Components

Type Visibility Attributes Name Initial
integer(kind=c_int32_t), public :: val

Internal value

type, public, bind(C) ::  dtfft_stream_t

dtFFT stream representation.

Components

Type Visibility Attributes Name Initial
type(c_ptr), public :: stream

Actual stream

Constructor

Creates dtfft_stream_t from integer(cuda_stream_kind)

private function stream_from_int64 (cuda_stream)

Creates dtfft_stream_t from integer(cuda_stream_kind)

type, public, bind(C) ::  dtfft_platform_t

Type that specifies runtime platform, e.g. Host, CUDA, HIP

Components

Type Visibility Attributes Name Initial
integer(kind=c_int32_t), public :: val

Internal value

type, public ::  kernel_type_t

nvRTC Kernel type

Components

Type Visibility Attributes Name Initial
integer(kind=int32), public :: val

Functions

public pure elemental function is_valid_execute_type(param) result(res)

Arguments

Type IntentOptional Attributes Name
type(dtfft_execute_t), intent(in) :: param

Return Value logical

public pure elemental function is_valid_transpose_type(param) result(res)

Arguments

Type IntentOptional Attributes Name
type(dtfft_transpose_t), intent(in) :: param

Return Value logical

public pure elemental function is_valid_executor(param) result(res)

Arguments

Type IntentOptional Attributes Name
type(dtfft_executor_t), intent(in) :: param

Return Value logical

public pure elemental function is_valid_effort(param) result(res)

Arguments

Type IntentOptional Attributes Name
type(dtfft_effort_t), intent(in) :: param

Return Value logical

public pure elemental function is_valid_precision(param) result(res)

Arguments

Type IntentOptional Attributes Name
type(dtfft_precision_t), intent(in) :: param

Return Value logical

public pure elemental function is_valid_r2r_kind(param) result(res)

Arguments

Type IntentOptional Attributes Name
type(dtfft_r2r_kind_t), intent(in) :: param

Return Value logical

public pure elemental function is_valid_dimension(param) result(res)

Arguments

Type IntentOptional Attributes Name
integer(kind=int8), intent(in) :: param

Return Value logical

public pure elemental function is_valid_comm_type(param) result(res)

Arguments

Type IntentOptional Attributes Name
integer(kind=int32), intent(in) :: param

Return Value logical

public function dtfft_get_precision_string(precision) result(string)

Gets the string description of a precision

Arguments

Type IntentOptional Attributes Name
type(dtfft_precision_t), intent(in) :: precision

Precision type

Return Value character(len=:), allocatable

Precision string

public function dtfft_get_executor_string(executor) result(string)

Gets the string description of an executor

Arguments

Type IntentOptional Attributes Name
type(dtfft_executor_t), intent(in) :: executor

Executor type

Return Value character(len=:), allocatable

Executor string

public pure elemental function is_transpose_kernel(param) result(res)

Arguments

Type IntentOptional Attributes Name
type(kernel_type_t), intent(in) :: param

Return Value logical

public pure elemental function is_unpack_kernel(param) result(res)

Arguments

Type IntentOptional Attributes Name
type(kernel_type_t), intent(in) :: param

Return Value logical

public pure elemental function is_host_executor(param) result(res)

Arguments

Type IntentOptional Attributes Name
type(dtfft_executor_t), intent(in) :: param

Return Value logical

public pure elemental function is_cuda_executor(param) result(res)

Arguments

Type IntentOptional Attributes Name
type(dtfft_executor_t), intent(in) :: param

Return Value logical

public pure elemental function is_valid_platform(param) result(res)

Arguments

Type IntentOptional Attributes Name
type(dtfft_platform_t), intent(in) :: param

Return Value logical

public pure elemental function is_valid_gpu_backend(param) result(res)

Arguments

Type IntentOptional Attributes Name
type(dtfft_backend_t), intent(in) :: param

Return Value logical

public pure elemental function is_backend_pipelined(param) result(res)

Arguments

Type IntentOptional Attributes Name
type(dtfft_backend_t), intent(in) :: param

Return Value logical

public pure elemental function is_backend_mpi(param) result(res)

Arguments

Type IntentOptional Attributes Name
type(dtfft_backend_t), intent(in) :: param

Return Value logical

public pure elemental function is_backend_nccl(param) result(res)

Arguments

Type IntentOptional Attributes Name
type(dtfft_backend_t), intent(in) :: param

Return Value logical

public pure elemental function is_backend_cufftmp(param) result(res)

Arguments

Type IntentOptional Attributes Name
type(dtfft_backend_t), intent(in) :: param

Return Value logical

public pure elemental function is_backend_nvshmem(param) result(res)

Arguments

Type IntentOptional Attributes Name
type(dtfft_backend_t), intent(in) :: param

Return Value logical

public function dtfft_get_backend_string(backend) result(string)

Gets the string description of a GPU backend

Arguments

Type IntentOptional Attributes Name
type(dtfft_backend_t), intent(in) :: backend

GPU backend

Return Value character(len=:), allocatable

Backend string

public function dtfft_get_cuda_stream(stream) result(cuda_stream)

Returns the CUDA stream from dtfft_stream_t

Arguments

Type IntentOptional Attributes Name
type(dtfft_stream_t), intent(in) :: stream

dtfft stream

Return Value integer(kind=int64)

CUDA stream

private pure elemental function execute_type_eq(left, right) result(res)

Arguments

Type IntentOptional Attributes Name
type(dtfft_execute_t), intent(in) :: left
type(dtfft_execute_t), intent(in) :: right

Return Value logical

private pure elemental function transpose_type_eq(left, right) result(res)

Arguments

Type IntentOptional Attributes Name
type(dtfft_transpose_t), intent(in) :: left
type(dtfft_transpose_t), intent(in) :: right

Return Value logical

private pure elemental function executor_eq(left, right) result(res)

Arguments

Type IntentOptional Attributes Name
type(dtfft_executor_t), intent(in) :: left
type(dtfft_executor_t), intent(in) :: right

Return Value logical

private pure elemental function effort_eq(left, right) result(res)

Arguments

Type IntentOptional Attributes Name
type(dtfft_effort_t), intent(in) :: left
type(dtfft_effort_t), intent(in) :: right

Return Value logical

private pure elemental function precision_eq(left, right) result(res)

Arguments

Type IntentOptional Attributes Name
type(dtfft_precision_t), intent(in) :: left
type(dtfft_precision_t), intent(in) :: right

Return Value logical

private pure elemental function r2r_kind_eq(left, right) result(res)

Arguments

Type IntentOptional Attributes Name
type(dtfft_r2r_kind_t), intent(in) :: left
type(dtfft_r2r_kind_t), intent(in) :: right

Return Value logical

private pure elemental function platform_eq(left, right) result(res)

Arguments

Type IntentOptional Attributes Name
type(dtfft_platform_t), intent(in) :: left
type(dtfft_platform_t), intent(in) :: right

Return Value logical

private pure elemental function execute_type_ne(left, right) result(res)

Arguments

Type IntentOptional Attributes Name
type(dtfft_execute_t), intent(in) :: left
type(dtfft_execute_t), intent(in) :: right

Return Value logical

private pure elemental function transpose_type_ne(left, right) result(res)

Arguments

Type IntentOptional Attributes Name
type(dtfft_transpose_t), intent(in) :: left
type(dtfft_transpose_t), intent(in) :: right

Return Value logical

private pure elemental function executor_ne(left, right) result(res)

Arguments

Type IntentOptional Attributes Name
type(dtfft_executor_t), intent(in) :: left
type(dtfft_executor_t), intent(in) :: right

Return Value logical

private pure elemental function effort_ne(left, right) result(res)

Arguments

Type IntentOptional Attributes Name
type(dtfft_effort_t), intent(in) :: left
type(dtfft_effort_t), intent(in) :: right

Return Value logical

private pure elemental function precision_ne(left, right) result(res)

Arguments

Type IntentOptional Attributes Name
type(dtfft_precision_t), intent(in) :: left
type(dtfft_precision_t), intent(in) :: right

Return Value logical

private pure elemental function r2r_kind_ne(left, right) result(res)

Arguments

Type IntentOptional Attributes Name
type(dtfft_r2r_kind_t), intent(in) :: left
type(dtfft_r2r_kind_t), intent(in) :: right

Return Value logical

private pure elemental function platform_ne(left, right) result(res)

Arguments

Type IntentOptional Attributes Name
type(dtfft_platform_t), intent(in) :: left
type(dtfft_platform_t), intent(in) :: right

Return Value logical

private function dtfft_get_version_current() bind(C)

Returns the current version code

Arguments

None

Return Value integer(kind=c_int32_t)

private function dtfft_get_version_required(major, minor, patch)

Returns the version code required by the user

Arguments

Type IntentOptional Attributes Name
integer(kind=int32), intent(in) :: major

Major version
integer(kind=int32), intent(in) :: minor

Minor version
integer(kind=int32), intent(in) :: patch

Patch version

Return Value integer(kind=int32)

private pure elemental function gpu_backend_eq(left, right) result(res)

Arguments

Type IntentOptional Attributes Name
type(dtfft_backend_t), intent(in) :: left
type(dtfft_backend_t), intent(in) :: right

Return Value logical

private pure elemental function gpu_backend_ne(left, right) result(res)

Arguments

Type IntentOptional Attributes Name
type(dtfft_backend_t), intent(in) :: left
type(dtfft_backend_t), intent(in) :: right

Return Value logical

private pure elemental function kernel_type_eq(left, right) result(res)

Arguments

Type IntentOptional Attributes Name
type(kernel_type_t), intent(in) :: left
type(kernel_type_t), intent(in) :: right

Return Value logical

private pure elemental function kernel_type_ne(left, right) result(res)

Arguments

Type IntentOptional Attributes Name
type(kernel_type_t), intent(in) :: left
type(kernel_type_t), intent(in) :: right

Return Value logical

private function stream_from_int64(cuda_stream) result(stream)

Creates dtfft_stream_t from integer(cuda_stream_kind)

Arguments

Type IntentOptional Attributes Name
integer(kind=int64), intent(in) :: cuda_stream

CUDA stream

Return Value type(dtfft_stream_t)

dtfft Stream