pypocketfft.cc 13.2 KB
Newer Older
Martin Reinecke's avatar
cleanup  
Martin Reinecke committed
1 2 3 4 5 6
/*
 * This file is part of pocketfft.
 * Licensed under a 3-clause BSD style license - see LICENSE.md
 */

/*
7
 *  Python interface.
Martin Reinecke's avatar
cleanup  
Martin Reinecke committed
8
 *
9
 *  Copyright (C) 2019 Max-Planck-Society
Martin Reinecke's avatar
cleanup  
Martin Reinecke committed
10 11 12
 *  \author Martin Reinecke
 */

Martin Reinecke's avatar
Martin Reinecke committed
13 14
#include <pybind11/pybind11.h>
#include <pybind11/numpy.h>
Martin Reinecke's avatar
more  
Martin Reinecke committed
15
#include <pybind11/stl.h>
Martin Reinecke's avatar
Martin Reinecke committed
16

17
#include "pocketfft_hdronly.h"
Martin Reinecke's avatar
Martin Reinecke committed
18

Martin Reinecke's avatar
Martin Reinecke committed
19
//
20
// Python interface
Martin Reinecke's avatar
Martin Reinecke committed
21 22
//

23
namespace {
24

25 26
using namespace std;
using namespace pocketfft;
Martin Reinecke's avatar
Martin Reinecke committed
27

Martin Reinecke's avatar
Martin Reinecke committed
28 29
namespace py = pybind11;

Martin Reinecke's avatar
Martin Reinecke committed
30 31
auto c64 = py::dtype("complex64");
auto c128 = py::dtype("complex128");
32
auto c256 = py::dtype("complex256");
Martin Reinecke's avatar
Martin Reinecke committed
33 34
auto f32 = py::dtype("float32");
auto f64 = py::dtype("float64");
35
auto f128 = py::dtype("float128");
Martin Reinecke's avatar
cleanup  
Martin Reinecke committed
36 37

shape_t copy_shape(const py::array &arr)
Martin Reinecke's avatar
Martin Reinecke committed
38
  {
39
  shape_t res(size_t(arr.ndim()));
Martin Reinecke's avatar
Martin Reinecke committed
40
  for (size_t i=0; i<res.size(); ++i)
41
    res[i] = size_t(arr.shape(int(i)));
Martin Reinecke's avatar
Martin Reinecke committed
42 43
  return res;
  }
Martin Reinecke's avatar
Martin Reinecke committed
44

Martin Reinecke's avatar
cleanup  
Martin Reinecke committed
45
stride_t copy_strides(const py::array &arr)
Martin Reinecke's avatar
cleanup  
Martin Reinecke committed
46
  {
47
  stride_t res(size_t(arr.ndim()));
Martin Reinecke's avatar
cleanup  
Martin Reinecke committed
48
  for (size_t i=0; i<res.size(); ++i)
49
    res[i] = arr.strides(int(i));
Martin Reinecke's avatar
cleanup  
Martin Reinecke committed
50 51
  return res;
  }
Martin Reinecke's avatar
Martin Reinecke committed
52

Martin Reinecke's avatar
cleanup  
Martin Reinecke committed
53
shape_t makeaxes(const py::array &in, py::object axes)
Martin Reinecke's avatar
more  
Martin Reinecke committed
54
  {
Martin Reinecke's avatar
Martin Reinecke committed
55
  if (axes.is(py::none()))
Martin Reinecke's avatar
more  
Martin Reinecke committed
56
    {
57
    shape_t res(size_t(in.ndim()));
Martin Reinecke's avatar
Martin Reinecke committed
58 59 60
    for (size_t i=0; i<res.size(); ++i)
      res[i]=i;
    return res;
Martin Reinecke's avatar
more  
Martin Reinecke committed
61
    }
Martin Reinecke's avatar
cleanup  
Martin Reinecke committed
62
  auto tmp=axes.cast<shape_t>();
Martin Reinecke's avatar
fix  
Martin Reinecke committed
63
  if ((tmp.size()>size_t(in.ndim())) || (tmp.size()==0))
Martin Reinecke's avatar
more  
Martin Reinecke committed
64
    throw runtime_error("bad axes argument");
Martin Reinecke's avatar
Martin Reinecke committed
65 66
  for (auto sz: tmp)
    if (sz>=size_t(in.ndim()))
Martin Reinecke's avatar
more  
Martin Reinecke committed
67
      throw runtime_error("invalid axis number");
Martin Reinecke's avatar
Martin Reinecke committed
68
  return tmp;
Martin Reinecke's avatar
more  
Martin Reinecke committed
69 70
  }

71 72 73 74
#define DISPATCH(arr, T1, T2, T3, func, args) \
  auto dtype = arr.dtype(); \
  if (dtype.is(T1)) return func<double> args; \
  if (dtype.is(T2)) return func<float> args; \
75
  if (dtype.is(T3)) return func<long double> args; \
76 77
  throw runtime_error("unsupported data type");

Martin Reinecke's avatar
Martin Reinecke committed
78
template<typename T> py::array xfftn_internal(const py::array &in,
Martin Reinecke's avatar
Martin Reinecke committed
79
  const shape_t &axes, double fct, bool inplace, bool fwd, size_t nthreads)
Martin Reinecke's avatar
Martin Reinecke committed
80
  {
Martin Reinecke's avatar
Martin Reinecke committed
81
  auto dims(copy_shape(in));
82
  py::array res = inplace ? in : py::array_t<complex<T>>(dims);
Martin Reinecke's avatar
sync  
Martin Reinecke committed
83 84
  c2c(dims, copy_strides(in), copy_strides(res), axes, fwd,
    reinterpret_cast<const complex<T> *>(in.data()),
Martin Reinecke's avatar
Martin Reinecke committed
85
    reinterpret_cast<complex<T> *>(res.mutable_data()), T(fct), nthreads);
Martin Reinecke's avatar
Martin Reinecke committed
86 87
  return res;
  }
Martin Reinecke's avatar
Martin Reinecke committed
88

89
py::array xfftn(const py::array &a, py::object axes, double fct, bool inplace,
Martin Reinecke's avatar
Martin Reinecke committed
90
  bool fwd, size_t nthreads)
Martin Reinecke's avatar
cleanup  
Martin Reinecke committed
91
  {
92
  DISPATCH(a, c128, c64, c256, xfftn_internal, (a, makeaxes(a, axes), fct,
Martin Reinecke's avatar
Martin Reinecke committed
93
           inplace, fwd, nthreads))
Martin Reinecke's avatar
cleanup  
Martin Reinecke committed
94
  }
95

Martin Reinecke's avatar
Martin Reinecke committed
96 97
py::array fftn(const py::array &a, py::object axes, double fct, bool inplace,
  size_t nthreads)
Martin Reinecke's avatar
Martin Reinecke committed
98
  { return xfftn(a, axes, fct, inplace, true, nthreads); }
99

Martin Reinecke's avatar
Martin Reinecke committed
100 101
py::array ifftn(const py::array &a, py::object axes, double fct, bool inplace,
  size_t nthreads)
Martin Reinecke's avatar
Martin Reinecke committed
102
  { return xfftn(a, axes, fct, inplace, false, nthreads); }
Martin Reinecke's avatar
Martin Reinecke committed
103

Martin Reinecke's avatar
Martin Reinecke committed
104
template<typename T> py::array rfftn_internal(const py::array &in,
Martin Reinecke's avatar
Martin Reinecke committed
105
  py::object axes_, T fct, size_t nthreads)
Martin Reinecke's avatar
Martin Reinecke committed
106
  {
Martin Reinecke's avatar
Martin Reinecke committed
107
  auto axes = makeaxes(in, axes_);
Martin Reinecke's avatar
Martin Reinecke committed
108
  auto dims_in(copy_shape(in)), dims_out(dims_in);
Martin Reinecke's avatar
more  
Martin Reinecke committed
109
  dims_out[axes.back()] = (dims_out[axes.back()]>>1)+1;
Martin Reinecke's avatar
Martin Reinecke committed
110
  py::array res = py::array_t<complex<T>>(dims_out);
Martin Reinecke's avatar
sync  
Martin Reinecke committed
111 112
  r2c(dims_in, copy_strides(in), copy_strides(res), axes,
    reinterpret_cast<const T *>(in.data()),
Martin Reinecke's avatar
Martin Reinecke committed
113
    reinterpret_cast<complex<T> *>(res.mutable_data()), T(fct), nthreads);
Martin Reinecke's avatar
more  
Martin Reinecke committed
114 115
  return res;
  }
116

Martin Reinecke's avatar
Martin Reinecke committed
117 118
py::array rfftn(const py::array &in, py::object axes_, double fct,
  size_t nthreads)
Martin Reinecke's avatar
Martin Reinecke committed
119
  {
Martin Reinecke's avatar
Martin Reinecke committed
120
  DISPATCH(in, f64, f32, f128, rfftn_internal, (in, axes_, fct, nthreads))
Martin Reinecke's avatar
Martin Reinecke committed
121
  }
122

123
template<typename T> py::array xrfft_scipy(const py::array &in,
Martin Reinecke's avatar
Martin Reinecke committed
124
  size_t axis, double fct, bool inplace, bool fwd, size_t nthreads)
125 126 127
  {
  auto dims(copy_shape(in));
  py::array res = inplace ? in : py::array_t<T>(dims);
Martin Reinecke's avatar
Martin Reinecke committed
128
  r2r_fftpack(dims, copy_strides(in), copy_strides(res), axis, fwd,
Martin Reinecke's avatar
sync  
Martin Reinecke committed
129
    reinterpret_cast<const T *>(in.data()),
Martin Reinecke's avatar
Martin Reinecke committed
130
    reinterpret_cast<T *>(res.mutable_data()), T(fct), nthreads);
131 132
  return res;
  }
133

Martin Reinecke's avatar
Martin Reinecke committed
134 135
py::array rfft_scipy(const py::array &in, size_t axis, double fct, bool inplace,
  size_t nthreads)
136
  {
Martin Reinecke's avatar
Martin Reinecke committed
137 138
  DISPATCH(in, f64, f32, f128, xrfft_scipy, (in, axis, fct, inplace, true,
    nthreads))
139
  }
140

Martin Reinecke's avatar
Martin Reinecke committed
141
py::array irfft_scipy(const py::array &in, size_t axis, double fct,
Martin Reinecke's avatar
Martin Reinecke committed
142
  bool inplace, size_t nthreads)
143
  {
Martin Reinecke's avatar
Martin Reinecke committed
144 145
  DISPATCH(in, f64, f32, f128, xrfft_scipy, (in, axis, fct, inplace, false,
    nthreads))
146
  }
Martin Reinecke's avatar
cleanup  
Martin Reinecke committed
147
template<typename T> py::array irfftn_internal(const py::array &in,
Martin Reinecke's avatar
Martin Reinecke committed
148
  py::object axes_, size_t lastsize, T fct, size_t nthreads)
Martin Reinecke's avatar
more  
Martin Reinecke committed
149
  {
Martin Reinecke's avatar
Martin Reinecke committed
150
  auto axes = makeaxes(in, axes_);
Martin Reinecke's avatar
more  
Martin Reinecke committed
151
  size_t axis = axes.back();
Martin Reinecke's avatar
Martin Reinecke committed
152 153 154
  shape_t dims_in(copy_shape(in)), dims_out=dims_in;
  if (lastsize==0) lastsize=2*dims_in[axis]-1;
  if ((lastsize/2) + 1 != dims_in[axis])
Martin Reinecke's avatar
more  
Martin Reinecke committed
155 156
    throw runtime_error("bad lastsize");
  dims_out[axis] = lastsize;
Martin Reinecke's avatar
cleanup  
Martin Reinecke committed
157
  py::array res = py::array_t<T>(dims_out);
Martin Reinecke's avatar
bug fix  
Martin Reinecke committed
158
  c2r(dims_out, copy_strides(in), copy_strides(res), axes,
Martin Reinecke's avatar
sync  
Martin Reinecke committed
159
    reinterpret_cast<const complex<T> *>(in.data()),
Martin Reinecke's avatar
Martin Reinecke committed
160
    reinterpret_cast<T *>(res.mutable_data()), T(fct), nthreads);
Martin Reinecke's avatar
more  
Martin Reinecke committed
161 162
  return res;
  }
163

Martin Reinecke's avatar
cleanup  
Martin Reinecke committed
164
py::array irfftn(const py::array &in, py::object axes_, size_t lastsize,
Martin Reinecke's avatar
Martin Reinecke committed
165
  double fct, size_t nthreads)
Martin Reinecke's avatar
cleanup  
Martin Reinecke committed
166
  {
Martin Reinecke's avatar
Martin Reinecke committed
167 168
  DISPATCH(in, c128, c64, c256, irfftn_internal, (in, axes_, lastsize, fct,
    nthreads))
Martin Reinecke's avatar
cleanup  
Martin Reinecke committed
169
  }
Martin Reinecke's avatar
Martin Reinecke committed
170 171

template<typename T> py::array hartley_internal(const py::array &in,
Martin Reinecke's avatar
Martin Reinecke committed
172
  py::object axes_, double fct, bool inplace, size_t nthreads)
Martin Reinecke's avatar
more  
Martin Reinecke committed
173
  {
Martin Reinecke's avatar
Martin Reinecke committed
174
  auto dims(copy_shape(in));
175
  py::array res = inplace ? in : py::array_t<T>(dims);
Martin Reinecke's avatar
Martin Reinecke committed
176
  r2r_hartley(dims, copy_strides(in), copy_strides(res), makeaxes(in, axes_),
Martin Reinecke's avatar
sync  
Martin Reinecke committed
177
    reinterpret_cast<const T *>(in.data()),
Martin Reinecke's avatar
Martin Reinecke committed
178
    reinterpret_cast<T *>(res.mutable_data()), T(fct), nthreads);
Martin Reinecke's avatar
Martin Reinecke committed
179 180
  return res;
  }
181

182
py::array hartley(const py::array &in, py::object axes_, double fct,
Martin Reinecke's avatar
Martin Reinecke committed
183
  bool inplace, size_t nthreads)
Martin Reinecke's avatar
Martin Reinecke committed
184
  {
Martin Reinecke's avatar
Martin Reinecke committed
185 186
  DISPATCH(in, f64, f32, f128, hartley_internal, (in, axes_, fct, inplace,
    nthreads))
Martin Reinecke's avatar
Martin Reinecke committed
187
  }
188

Martin Reinecke's avatar
fixes  
Martin Reinecke committed
189
template<typename T>py::array complex2hartley(const py::array &in,
Martin Reinecke's avatar
Martin Reinecke committed
190
  const py::array &tmp, py::object axes_, bool inplace)
Martin Reinecke's avatar
fixes  
Martin Reinecke committed
191
  {
Martin Reinecke's avatar
Martin Reinecke committed
192
  using namespace pocketfft::detail;
193
  size_t ndim = size_t(in.ndim());
Martin Reinecke's avatar
Martin Reinecke committed
194
  auto dims_out(copy_shape(in));
Martin Reinecke's avatar
Martin Reinecke committed
195 196 197
  py::array out = inplace ? in : py::array_t<T>(dims_out);
  ndarr<cmplx<T>> atmp(tmp.data(), copy_shape(tmp), copy_strides(tmp));
  ndarr<T> aout(out.mutable_data(), copy_shape(out), copy_strides(out));
Martin Reinecke's avatar
fixes  
Martin Reinecke committed
198
  auto axes = makeaxes(in, axes_);
Martin Reinecke's avatar
Martin Reinecke committed
199
  size_t axis = axes.back();
Martin Reinecke's avatar
Martin Reinecke committed
200 201
  multi_iter<1,cmplx<T>,T> it(atmp, aout, axis);
  vector<bool> swp(ndim,false);
Martin Reinecke's avatar
fixes  
Martin Reinecke committed
202 203
  for (auto i: axes)
    if (i!=axis)
Martin Reinecke's avatar
Martin Reinecke committed
204
      swp[i] = true;
Martin Reinecke's avatar
Martin Reinecke committed
205
  while(it.remaining()>0)
Martin Reinecke's avatar
fixes  
Martin Reinecke committed
206
    {
Martin Reinecke's avatar
Martin Reinecke committed
207
    ptrdiff_t rofs = 0;
Martin Reinecke's avatar
Martin Reinecke committed
208
    for (size_t i=0; i<it.pos.size(); ++i)
Martin Reinecke's avatar
fixes  
Martin Reinecke committed
209
      {
Martin Reinecke's avatar
Martin Reinecke committed
210
      if (i==axis) continue;
Martin Reinecke's avatar
fixes  
Martin Reinecke committed
211
      if (!swp[i])
212
        rofs += ptrdiff_t(it.pos[i])*it.oarr.stride(i);
Martin Reinecke's avatar
fixes  
Martin Reinecke committed
213 214
      else
        {
215
        auto x = ptrdiff_t((it.pos[i]==0) ? 0 : it.iarr.shape(i)-it.pos[i]);
Martin Reinecke's avatar
Martin Reinecke committed
216
        rofs += x*it.oarr.stride(i);
Martin Reinecke's avatar
fixes  
Martin Reinecke committed
217 218
        }
      }
Martin Reinecke's avatar
Martin Reinecke committed
219
    it.advance(1);
Martin Reinecke's avatar
Martin Reinecke committed
220
    for (size_t i=0; i<it.length_in(); ++i)
Martin Reinecke's avatar
fixes  
Martin Reinecke committed
221
      {
Martin Reinecke's avatar
Martin Reinecke committed
222 223
      auto re = it.in(i).r;
      auto im = it.in(i).i;
224
      auto rev_i = ptrdiff_t((i==0) ? 0 : it.length_out()-i);
Martin Reinecke's avatar
Martin Reinecke committed
225 226
      it.out(i) = re+im;
      aout[rofs + rev_i*it.stride_out()] = re-im;
Martin Reinecke's avatar
fixes  
Martin Reinecke committed
227 228 229 230
      }
    }
  return out;
  }
231

232
py::array mycomplex2hartley(const py::array &in,
Martin Reinecke's avatar
Martin Reinecke committed
233
  const py::array &tmp, py::object axes_, bool inplace)
234
  {
235
  DISPATCH(in, f64, f32, f128, complex2hartley, (in, tmp, axes_, inplace))
236
  }
237

Martin Reinecke's avatar
Martin Reinecke committed
238
py::array hartley2(const py::array &in, py::object axes_, double fct,
Martin Reinecke's avatar
Martin Reinecke committed
239
  bool inplace, size_t nthreads)
Martin Reinecke's avatar
Martin Reinecke committed
240 241 242 243
  {
  return mycomplex2hartley(in, rfftn(in, axes_, fct, nthreads), axes_,
    inplace);
  }
Martin Reinecke's avatar
fixes  
Martin Reinecke committed
244

Martin Reinecke's avatar
Martin Reinecke committed
245
const char *pypocketfft_DS = R"""(Fast Fourier and Hartley transforms.
Martin Reinecke's avatar
Martin Reinecke committed
246 247 248 249 250 251 252 253 254

This module supports
- single and double precision
- complex and real-valued transforms
- multi-dimensional transforms

For two- and higher-dimensional transforms the code will use SSE2 and AVX
vector instructions for faster execution if these are supported by the CPU and
were enabled during compilation.
Martin Reinecke's avatar
Martin Reinecke committed
255
)""";
Martin Reinecke's avatar
Martin Reinecke committed
256

Martin Reinecke's avatar
Martin Reinecke committed
257
const char *fftn_DS = R"""(
258 259 260 261 262 263 264
Performs a forward complex FFT.

Parameters
----------
a : numpy.ndarray (np.complex64 or np.complex128)
    The input data
axes : list of integers
265
    The axes along which the FFT is carried out.
266
    If not set, all axes will be transformed.
Martin Reinecke's avatar
Martin Reinecke committed
267
fct : float
Martin Reinecke's avatar
Martin Reinecke committed
268
    Normalization factor
269
inplace : bool
Martin Reinecke's avatar
Martin Reinecke committed
270
    if False, returns the result in a new array and leaves the input unchanged.
271
    if True, stores the result in the input array and returns a handle to it.
272 273 274 275

Returns
-------
np.ndarray (same shape and data type as a)
276
    The transformed data.
Martin Reinecke's avatar
Martin Reinecke committed
277
)""";
278

Martin Reinecke's avatar
Martin Reinecke committed
279
const char *ifftn_DS = R"""(Performs a backward complex FFT.
280 281 282 283 284 285

Parameters
----------
a : numpy.ndarray (np.complex64 or np.complex128)
    The input data
axes : list of integers
286
    The axes along which the FFT is carried out.
287
    If not set, all axes will be transformed.
Martin Reinecke's avatar
Martin Reinecke committed
288
fct : float
Martin Reinecke's avatar
Martin Reinecke committed
289
    Normalization factor
290
inplace : bool
Martin Reinecke's avatar
Martin Reinecke committed
291
    if False, returns the result in a new array and leaves the input unchanged.
292
    if True, stores the result in the input array and returns a handle to it.
293 294 295 296

Returns
-------
np.ndarray (same shape and data type as a)
Martin Reinecke's avatar
Martin Reinecke committed
297
    The transformed data
Martin Reinecke's avatar
Martin Reinecke committed
298
)""";
299

Martin Reinecke's avatar
Martin Reinecke committed
300
const char *rfftn_DS = R"""(Performs a forward real-valued FFT.
Martin Reinecke's avatar
Martin Reinecke committed
301 302 303 304 305 306

Parameters
----------
a : numpy.ndarray (np.float32 or np.float64)
    The input data
axes : list of integers
307
    The axes along which the FFT is carried out.
Martin Reinecke's avatar
Martin Reinecke committed
308 309
    If not set, all axes will be transformed in ascending order.
fct : float
Martin Reinecke's avatar
Martin Reinecke committed
310
    Normalization factor
Martin Reinecke's avatar
Martin Reinecke committed
311 312 313 314

Returns
-------
np.ndarray (np.complex64 or np.complex128)
Martin Reinecke's avatar
Martin Reinecke committed
315
    The transformed data. The shape is identical to that of the input array,
Martin Reinecke's avatar
Martin Reinecke committed
316 317
    except for the axis that was transformed last. If the length of that axis
    was n on input, it is n//2+1 on output.
Martin Reinecke's avatar
Martin Reinecke committed
318
)""";
Martin Reinecke's avatar
Martin Reinecke committed
319

Martin Reinecke's avatar
Martin Reinecke committed
320
const char *rfft_scipy_DS = R"""(Performs a forward real-valued FFT.
321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339

Parameters
----------
a : numpy.ndarray (np.float32 or np.float64)
    The input data
axis : int
    The axis along which the FFT is carried out.
fct : float
    Normalization factor
inplace : bool
    if False, returns the result in a new array and leaves the input unchanged.
    if True, stores the result in the input array and returns a handle to it.

Returns
-------
np.ndarray (np.float32 or np.float64)
    The transformed data. The shape is identical to that of the input array.
    Along the transformed axis, values are arranged in
    FFTPACK half-complex order, i.e. `a[0].re, a[1].re, a[1].im, a[2].re ...`.
Martin Reinecke's avatar
Martin Reinecke committed
340
)""";
341

Martin Reinecke's avatar
Martin Reinecke committed
342
const char *irfftn_DS = R"""(Performs a backward real-valued FFT.
Martin Reinecke's avatar
Martin Reinecke committed
343 344 345 346 347 348

Parameters
----------
a : numpy.ndarray (np.complex64 or np.complex128)
    The input data
axes : list of integers
349
    The axes along which the FFT is carried out.
Martin Reinecke's avatar
Martin Reinecke committed
350 351 352 353
    If not set, all axes will be transformed in ascending order.
lastsize : the output size of the last axis to be transformed.
    If the corresponding input axis has size n, this can be 2*n-2 or 2*n-1.
fct : float
Martin Reinecke's avatar
Martin Reinecke committed
354
    Normalization factor
Martin Reinecke's avatar
Martin Reinecke committed
355 356 357 358

Returns
-------
np.ndarray (np.float32 or np.float64)
Martin Reinecke's avatar
Martin Reinecke committed
359 360
    The transformed data. The shape is identical to that of the input array,
    except for the axis that was transformed last, which has now `lastsize`
Martin Reinecke's avatar
Martin Reinecke committed
361
    entries.
Martin Reinecke's avatar
Martin Reinecke committed
362
)""";
Martin Reinecke's avatar
Martin Reinecke committed
363

Martin Reinecke's avatar
Martin Reinecke committed
364
const char *irfft_scipy_DS = R"""(Performs a backward real-valued FFT.
365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382

Parameters
----------
a : numpy.ndarray (np.float32 or np.float64)
    The input data. Along the transformed axis, values are expected in
    FFTPACK half-complex order, i.e. `a[0].re, a[1].re, a[1].im, a[2].re ...`.
axis : int
    The axis along which the FFT is carried out.
fct : float
    Normalization factor
inplace : bool
    if False, returns the result in a new array and leaves the input unchanged.
    if True, stores the result in the input array and returns a handle to it.

Returns
-------
np.ndarray (np.float32 or np.float64)
    The transformed data. The shape is identical to that of the input array.
Martin Reinecke's avatar
Martin Reinecke committed
383
)""";
384

Martin Reinecke's avatar
Martin Reinecke committed
385
const char *hartley_DS = R"""(Performs a Hartley transform.
386 387 388 389 390 391 392 393 394
For every requested axis, a 1D forward Fourier transform is carried out,
and the sum of real and imaginary parts of the result is stored in the output
array.

Parameters
----------
a : numpy.ndarray (np.float32 or np.float64)
    The input data
axes : list of integers
395
    The axes along which the transform is carried out.
396
    If not set, all axes will be transformed.
Martin Reinecke's avatar
Martin Reinecke committed
397
fct : float
Martin Reinecke's avatar
Martin Reinecke committed
398
    Normalization factor
399
inplace : bool
Martin Reinecke's avatar
Martin Reinecke committed
400
    if False, returns the result in a new array and leaves the input unchanged.
401
    if True, stores the result in the input array and returns a handle to it.
402 403 404 405

Returns
-------
np.ndarray (same shape and data type as a)
Martin Reinecke's avatar
Martin Reinecke committed
406
    The transformed data
Martin Reinecke's avatar
Martin Reinecke committed
407
)""";
408

Martin Reinecke's avatar
Martin Reinecke committed
409 410 411 412
} // unnamed namespace

PYBIND11_MODULE(pypocketfft, m)
  {
Martin Reinecke's avatar
more  
Martin Reinecke committed
413 414
  using namespace pybind11::literals;

Martin Reinecke's avatar
Martin Reinecke committed
415
  m.doc() = pypocketfft_DS;
416
  m.def("fftn",&fftn, fftn_DS, "a"_a, "axes"_a=py::none(), "fct"_a=1.,
Martin Reinecke's avatar
Martin Reinecke committed
417
    "inplace"_a=false, "nthreads"_a=1);
418
  m.def("ifftn",&ifftn, ifftn_DS, "a"_a, "axes"_a=py::none(), "fct"_a=1.,
Martin Reinecke's avatar
Martin Reinecke committed
419
    "inplace"_a=false, "nthreads"_a=1);
Martin Reinecke's avatar
Martin Reinecke committed
420 421
  m.def("rfftn",&rfftn, rfftn_DS, "a"_a, "axes"_a=py::none(), "fct"_a=1.,
    "nthreads"_a=1);
422
  m.def("rfft_scipy",&rfft_scipy, rfft_scipy_DS, "a"_a, "axis"_a, "fct"_a=1.,
Martin Reinecke's avatar
Martin Reinecke committed
423
    "inplace"_a=false, "nthreads"_a=1);
424
  m.def("irfftn",&irfftn, irfftn_DS, "a"_a, "axes"_a=py::none(), "lastsize"_a=0,
Martin Reinecke's avatar
Martin Reinecke committed
425
    "fct"_a=1., "nthreads"_a=1);
426
  m.def("irfft_scipy",&irfft_scipy, irfft_scipy_DS, "a"_a, "axis"_a, "fct"_a=1.,
Martin Reinecke's avatar
Martin Reinecke committed
427
    "inplace"_a=false, "nthreads"_a=1);
428
  m.def("hartley",&hartley, hartley_DS, "a"_a, "axes"_a=py::none(), "fct"_a=1.,
Martin Reinecke's avatar
Martin Reinecke committed
429
    "inplace"_a=false, "nthreads"_a=1);
Martin Reinecke's avatar
Martin Reinecke committed
430
  m.def("hartley2",&hartley2, "a"_a, "axes"_a=py::none(), "fct"_a=1.,
Martin Reinecke's avatar
Martin Reinecke committed
431
    "inplace"_a=false, "nthreads"_a=1);
Martin Reinecke's avatar
Martin Reinecke committed
432 433
  m.def("complex2hartley",&mycomplex2hartley, "in"_a, "tmp"_a, "axes"_a,
    "inplace"_a=false);
Martin Reinecke's avatar
Martin Reinecke committed
434
  }