forked from sdsc/p3dfft
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
103 lines (80 loc) · 3.72 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
P3DFFT - Highly scalable parallel 3D Fast Fourier Transforms library
Version 2.7
Copyright (C) 2006-2015 Dmitry Pekurovsky
Copyright (C) 2006-2015 University of California
Copyright (C) 2010-2011 Jens Henrik Goebbert
San Diego Supercomputer Center/UC SanDiego
------------
Notice
------------
! P3DFFT is free software: you can redistribute it and/or modify
! it under the terms of the GNU General Public License as published by
! the Free Software Foundation, either version 3 of the License, or
! (at your option) any later version.
! P3DFFT is distributed in the hope that it will be useful,
! but WITHOUT ANY WARRANTY; without even the implied warranty of
! MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
!
! GNU General Public License for more details.
! You should have received a copy of the GNU General Public License
! along with P3DFFT. If not, see <http://www.gnu.org/licenses/>.
------------
Features
------------
* Parallel implementation of 3D FFT with 2D (a.k.a. pencils) data
decomposition, overcoming an important limitation to scalability of other
3D FFT libraries implementing 1D, or slab, decomposition.
* Optimized for parallel communication and single-CPU performance.
* Uses established libraries (FFTW, ESSL) for underlying local 1D FFT.
* Fortran and C interfaces.
* Pruned input/output options
* User-defined communicator
The 1D decomposition suffers from the limitation that the number
of processors used cannot be greater than the maximum linear grid size of the
cubic domain to be processed. With the 2D domain decomposition scheme
the maximum number of processors is significantly higher, equal to the
square of the linear grid size.
This library is especially suited for large-data-volume applications on ultra-scale
parallel platforms.
------------
Machine requirements
------------
This library is built on top of an externally provided 1D FFT library.
Current choices are ESSL (for IBM systems) or FFTW. Either one of these
libraries must be installed on the system in order to use P3DFFT.
The choice of the library is specified at compile time.
P3DFFT is written in Fortran 90 with MPI. Having an Fortran90/MPI compiler
is essential to building the library on your system. C interface is
provided.
P3DFFT currently supports compilation by PGI, Intel, GCC and IBM
compilers. Additional support for other compilers will be added in the future.
------------
Directory structure
------------
build/
The library files are contained here. Building the library is required
before it can be used. In order to build the library, you must run
./configure from the top level directory. Then type "make"
and then "make install". For further instructions
on building the library see the P3DFFT User Guide, or visit the web site
https://github.com/sdsc/p3dfft/wiki/install. You can also see a list of options
by typing "./configure --help".
sample/
This directory has example programs in both FORTRAN and C, in
separate subdirectories. Tests provided include
out-of-place and in-place transforms 3D FFT, with error checking.
Also provided is an example of power spectrum calculation.
Example programs will be compiled automatically with the library
during make.
include/
The library is provided as a Fortran module.
After installation this directory will have p3dfft.mod (for Fortran interface),
p3dfft.h (the C wrapper/include file), and config.h (header generated by
configure script that contains all arguments used when configure script was
executed).
------------
Feedback
------------
Please send your feedback, including bugs and suggestions, to
Dmitry Pekurovsky, [email protected], or open an issue on github
(https://github.com/sdsc/p3dfft/issues/new).