dtfft_config_t Derived Type

type, public, bind(C) :: dtfft_config_t

Type that can be used to set additional configuration parameters to dtFFT

Inherits

Help

Components

Type	Visibility	Attributes		Name		Initial
logical(kind=c_bool),	public		::	enable_z_slab			Should dtFFT use Z-slab optimization or not. Default is true. One should consider disabling Z-slab optimization in order to resolve `DTFFT_ERROR_VKFFT_R2R_2D_PLAN` error OR when underlying FFT implementation of 2D plan is too slow. In all other cases it is considered that Z-slab is always faster, since it reduces number of data transpositions.
type(dtfft_platform_t),	public		::	platform			Selects platform to execute plan. Default is DTFFT_PLATFORM_HOST This option is only defined with device support build. Even when dtFFT is build with device support it does not nessasary means that all plans must be related to device. This enables single library installation to be compiled with both host, CUDA and HIP plans.
type(dtfft_stream_t),	public		::	stream			Main CUDA stream that will be used in dtFFT. This parameter is a placeholder for user to set custom stream. Stream that is actually used by dtFFT plan is returned by `plan%get_stream` function. When user sets stream he is responsible of destroying it. Stream must not be destroyed before call to `plan%destroy`.
type(dtfft_backend_t),	public		::	backend			Backend that will be used by dtFFT when `effort` is `DTFFT_ESTIMATE` or `DTFFT_MEASURE`. Default is `DTFFT_GPU_BACKEND_NCCL` if NCCL is enabled, otherwise `DTFFT_BACKEND_MPI_P2P`.
logical(kind=c_bool),	public		::	enable_mpi_backends			Should MPI GPU Backends be enabled when `effort` is `DTFFT_PATIENT` or not. Default is false. MPI Backends are disabled by default during autotuning process due to OpenMPI Bug https://github.com/open-mpi/ompi/issues/12849 It was noticed that during plan autotuning GPU memory not being freed completely. For example: 1024x1024x512 C2C, double precision, single GPU, using Z-slab optimization, with MPI backends enabled, plan autotuning will leak 8Gb GPU memory. Without Z-slab optimization, running on 4 GPUs, will leak 24Gb on each of the GPUs. One of the workarounds is to disable MPI Backends by default, which is done here. Other is to pass “–mca btl_smcuda_use_cuda_ipc 0” to `mpiexec`, but it was noticed that disabling CUDA IPC seriously affects overall performance of MPI algorithms
logical(kind=c_bool),	public		::	enable_pipelined_backends			Should pipelined GPU backends be enabled when `effort` is `DTFFT_PATIENT` or not. Default is true. Pipelined backends require additional buffer that user has no control over.
logical(kind=c_bool),	public		::	enable_nccl_backends			Should NCCL Backends be enabled when `effort` is `DTFFT_PATIENT` or not. Default is true.
logical(kind=c_bool),	public		::	enable_nvshmem_backends			Should NVSHMEM Backends be enabled when `effort` is `DTFFT_PATIENT` or not. Default is true.

Constructor

public interface dtfft_config_t

Interface to create a new configuration

private pure function config_constructor(enable_z_slab, platform, stream, backend, enable_mpi_backends, enable_pipelined_backends, enable_nccl_backends, enable_nvshmem_backends) result(config)

Creates a new configuration

Arguments

Type	Intent	Optional	Attributes		Name
logical,	intent(in),	optional		::	enable_z_slab	Should dtFFT use Z-slab optimization or not.
type(dtfft_platform_t),	intent(in),	optional		::	platform	Selects platform to execute plan.
type(dtfft_stream_t),	intent(in),	optional		::	stream	Main CUDA stream that will be used in dtFFT.
type(dtfft_backend_t),	intent(in),	optional		::	backend	Backend that will be used by dtFFT when `effort` is `DTFFT_ESTIMATE` or `DTFFT_MEASURE`.
logical,	intent(in),	optional		::	enable_mpi_backends	Should MPI GPU Backends be enabled when `effort` is `DTFFT_PATIENT` or not.
logical,	intent(in),	optional		::	enable_pipelined_backends	Should pipelined GPU backends be enabled when `effort` is `DTFFT_PATIENT` or not.
logical,	intent(in),	optional		::	enable_nccl_backends	Should NCCL Backends be enabled when `effort` is `DTFFT_PATIENT` or not.
logical,	intent(in),	optional		::	enable_nvshmem_backends	Should NVSHMEM Backends be enabled when `effort` is `DTFFT_PATIENT` or not.

Return Value type(dtfft_config_t)

Constructed dtFFT config ready to be set by call to dtfft_set_config