blob: e7eced69c269b2e823f853e094f560ffd3c16d3b [file]
// This file is part of Eigen, a lightweight C++ template library
// for linear algebra.
//
// Copyright (C) 2015 Jianwei Cui <thucjw@gmail.com>
//
// This Source Code Form is subject to the terms of the Mozilla
// Public License v. 2.0. If a copy of the MPL was not distributed
// with this file, You can obtain one at http://mozilla.org/MPL/2.0/.
// SPDX-License-Identifier: MPL-2.0
#ifndef EIGEN_TENSOR_TENSOR_FFT_H
#define EIGEN_TENSOR_TENSOR_FFT_H
// IWYU pragma: private
#include "./InternalHeaderCheck.h"
namespace Eigen {
template <bool IsReal>
struct MakeComplex {
template <typename T>
EIGEN_DEVICE_FUNC T operator()(const T& val) const {
return val;
}
};
template <>
struct MakeComplex<true> {
template <typename T>
EIGEN_DEVICE_FUNC internal::make_complex_t<T> operator()(const T& val) const {
return internal::make_complex_t<T>(val, T(0));
}
};
template <int ResultType>
struct PartOf {
template <typename T>
T operator()(const T& val) const {
return val;
}
};
template <>
struct PartOf<RealPart> {
template <typename T, typename EnableIf = std::enable_if_t<NumTraits<T>::IsComplex>>
typename NumTraits<T>::Real operator()(const T& val) const {
return Eigen::numext::real(val);
}
};
template <>
struct PartOf<ImagPart> {
template <typename T, typename EnableIf = std::enable_if_t<NumTraits<T>::IsComplex>>
typename NumTraits<T>::Real operator()(const T& val) const {
return Eigen::numext::imag(val);
}
};
namespace internal {
template <typename FFT, typename XprType, int FFTResultType, int FFTDir>
struct traits<TensorFFTOp<FFT, XprType, FFTResultType, FFTDir>> : public traits<XprType> {
typedef traits<XprType> XprTraits;
typedef typename XprTraits::Scalar Scalar;
typedef typename NumTraits<Scalar>::Real RealScalar;
typedef make_complex_t<Scalar> ComplexScalar;
typedef typename XprTraits::Scalar InputScalar;
typedef std::conditional_t<FFTResultType == RealPart || FFTResultType == ImagPart, RealScalar, ComplexScalar>
OutputScalar;
typedef typename XprTraits::StorageKind StorageKind;
typedef typename XprTraits::Index Index;
static constexpr int NumDimensions = XprTraits::NumDimensions;
static constexpr int Layout = XprTraits::Layout;
typedef typename traits<XprType>::PointerType PointerType;
};
template <typename FFT, typename XprType, int FFTResultType, int FFTDirection>
struct eval<TensorFFTOp<FFT, XprType, FFTResultType, FFTDirection>, Eigen::Dense> {
typedef const TensorFFTOp<FFT, XprType, FFTResultType, FFTDirection>& type;
};
} // end namespace internal
/**
* \ingroup Tensor_Module
*
* \brief Tensor FFT class.
*
* \note Input values are required to be finite. Complex multiplications on the
* hot path use the naive (a+bi)(c+di) = (ac-bd) + (ad+bc)i form, which differs
* from C99 / cppreference complex multiplication for non-finite operands: an
* input containing +/-inf or NaN may produce NaN-laden output where the C99
* specification would have given a finite or infinite result. Callers that
* need NaN/inf propagation per Annex G must filter inputs first.
*
* TODO:
* Add support for multithreaded evaluation
* Improve the performance on GPU
*/
template <typename FFT, typename XprType, int FFTResultType, int FFTDir>
class TensorFFTOp : public TensorBase<TensorFFTOp<FFT, XprType, FFTResultType, FFTDir>, ReadOnlyAccessors> {
public:
typedef typename Eigen::internal::traits<TensorFFTOp>::Scalar Scalar;
typedef typename Eigen::NumTraits<Scalar>::Real RealScalar;
typedef internal::make_complex_t<Scalar> ComplexScalar;
typedef std::conditional_t<FFTResultType == RealPart || FFTResultType == ImagPart, RealScalar, ComplexScalar>
OutputScalar;
typedef OutputScalar CoeffReturnType;
typedef typename Eigen::internal::ref_selector<TensorFFTOp>::type Nested;
typedef typename Eigen::internal::traits<TensorFFTOp>::StorageKind StorageKind;
typedef typename Eigen::internal::traits<TensorFFTOp>::Index Index;
EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE TensorFFTOp(const XprType& expr, const FFT& fft) : m_xpr(expr), m_fft(fft) {}
EIGEN_DEVICE_FUNC const FFT& fft() const { return m_fft; }
EIGEN_DEVICE_FUNC const internal::remove_all_t<typename XprType::Nested>& expression() const { return m_xpr; }
protected:
typename XprType::Nested m_xpr;
const FFT m_fft;
};
// Eval as rvalue
template <typename FFT, typename ArgType, typename Device, int FFTResultType, int FFTDir>
struct TensorEvaluator<const TensorFFTOp<FFT, ArgType, FFTResultType, FFTDir>, Device> {
typedef TensorFFTOp<FFT, ArgType, FFTResultType, FFTDir> XprType;
typedef typename XprType::Index Index;
static constexpr int NumDims = internal::array_size<typename TensorEvaluator<ArgType, Device>::Dimensions>::value;
typedef DSizes<Index, NumDims> Dimensions;
typedef typename XprType::Scalar Scalar;
typedef typename Eigen::NumTraits<Scalar>::Real RealScalar;
typedef internal::make_complex_t<Scalar> ComplexScalar;
typedef typename TensorEvaluator<ArgType, Device>::Dimensions InputDimensions;
typedef internal::traits<XprType> XprTraits;
typedef typename XprTraits::Scalar InputScalar;
typedef std::conditional_t<FFTResultType == RealPart || FFTResultType == ImagPart, RealScalar, ComplexScalar>
OutputScalar;
typedef OutputScalar CoeffReturnType;
typedef typename PacketType<OutputScalar, Device>::type PacketReturnType;
static constexpr int PacketSize = internal::unpacket_traits<PacketReturnType>::size;
typedef StorageMemory<CoeffReturnType, Device> Storage;
typedef typename Storage::Type EvaluatorPointerType;
static constexpr int Layout = TensorEvaluator<ArgType, Device>::Layout;
enum {
IsAligned = false,
PacketAccess = true,
// FFT eagerly materializes its result into m_data; once that buffer
// exists, exposing block access is just a wrapper around it. Leave
// PreferBlockAccess false so the executor still uses the cheaper
// packet path by default; this only matters when an outer expression
// calls block() directly.
BlockAccess = (NumDims > 0),
PreferBlockAccess = false,
CoordAccess = false,
RawAccess = false
};
//===- Tensor block evaluation strategy (see TensorBlock.h) -------------===//
typedef internal::TensorBlockDescriptor<NumDims, Index> TensorBlockDesc;
typedef internal::TensorBlockScratchAllocator<Device> TensorBlockScratch;
typedef typename internal::TensorMaterializedBlock<std::remove_const_t<CoeffReturnType>, NumDims, Layout, Index>
TensorBlock;
//===--------------------------------------------------------------------===//
EIGEN_STRONG_INLINE TensorEvaluator(const XprType& op, const Device& device)
: m_fft(op.fft()), m_impl(op.expression(), device), m_data(nullptr), m_device(device) {
const typename TensorEvaluator<ArgType, Device>::Dimensions& input_dims = m_impl.dimensions();
for (int i = 0; i < NumDims; ++i) {
eigen_assert(input_dims[i] > 0);
m_dimensions[i] = input_dims[i];
}
EIGEN_IF_CONSTEXPR (static_cast<int>(Layout) == static_cast<int>(ColMajor)) {
m_strides[0] = 1;
for (int i = 1; i < NumDims; ++i) {
m_strides[i] = m_strides[i - 1] * m_dimensions[i - 1];
}
} else {
m_strides[NumDims - 1] = 1;
for (int i = NumDims - 2; i >= 0; --i) {
m_strides[i] = m_strides[i + 1] * m_dimensions[i + 1];
}
}
m_size = m_dimensions.TotalSize();
}
EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const Dimensions& dimensions() const { return m_dimensions; }
EIGEN_STRONG_INLINE bool evalSubExprsIfNeeded(EvaluatorPointerType data) {
m_impl.evalSubExprsIfNeeded(nullptr);
if (data) {
evalToBuf(data);
return false;
} else {
m_data = (EvaluatorPointerType)m_device.get(
(CoeffReturnType*)(m_device.allocate_temp(sizeof(CoeffReturnType) * m_size)));
evalToBuf(m_data);
return true;
}
}
EIGEN_STRONG_INLINE void cleanup() {
if (m_data) {
m_device.deallocate(m_data);
m_data = nullptr;
}
m_impl.cleanup();
}
EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE CoeffReturnType coeff(Index index) const { return m_data[index]; }
template <int LoadMode>
EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE PacketReturnType packet(Index index) const {
return internal::ploadt<PacketReturnType, LoadMode>(m_data + index);
}
EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE TensorOpCost costPerCoeff(bool vectorized) const {
return TensorOpCost(sizeof(CoeffReturnType), 0, 0, vectorized, PacketSize);
}
EIGEN_DEVICE_FUNC EvaluatorPointerType data() const { return m_data; }
EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE internal::TensorBlockResourceRequirements getResourceRequirements() const {
return internal::TensorBlockResourceRequirements::any();
}
EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE TensorBlock block(TensorBlockDesc& desc, TensorBlockScratch& scratch,
bool /*root_of_expr_ast*/ = false) const {
eigen_assert(m_data != nullptr);
return TensorBlock::materialize(m_data, m_dimensions, desc, scratch);
}
private:
EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalToBuf(EvaluatorPointerType data) {
const bool write_to_out = std::is_same<OutputScalar, ComplexScalar>::value;
ComplexScalar* buf =
write_to_out ? (ComplexScalar*)data : (ComplexScalar*)m_device.allocate(sizeof(ComplexScalar) * m_size);
constexpr bool is_real_input = std::is_same<InputScalar, RealScalar>::value;
if (!is_real_input && m_impl.data() != nullptr) {
// Contiguous complex input — copy in one shot instead of N coeff() calls.
// `x = x.fft(...)` aliases input and output onto the same storage; in
// that case the data is already in `buf` and a memcpy would be self-
// overlapping (UB).
if (static_cast<const void*>(m_impl.data()) != static_cast<const void*>(buf)) {
m_device.memcpy(buf, m_impl.data(), m_size * sizeof(ComplexScalar));
}
} else {
for (Index i = 0; i < m_size; ++i) {
buf[i] = MakeComplex<is_real_input>()(m_impl.coeff(i));
}
}
for (size_t i = 0; i < m_fft.size(); ++i) {
Index dim = m_fft[i];
eigen_assert(dim >= 0 && dim < NumDims);
Index line_len = m_dimensions[dim];
eigen_assert(line_len >= 1);
if (line_len == 1) continue;
const Index stride = m_strides[dim];
const bool is_power_of_two = isPowerOfTwo(line_len);
const Index good_composite = is_power_of_two ? 0 : findGoodComposite(line_len);
const Index log_len = is_power_of_two ? getLog2(line_len) : getLog2(good_composite);
// Real, not ComplexScalar(s, 0): the latter would dispatch through
// libgcc __mulsc3/__muldc3 and re-introduce the NaN-check branch.
const RealScalar div_factor = (FFTDir == FFT_REVERSE) ? RealScalar(1) / RealScalar(line_len) : RealScalar(1);
// Scratch line buffer is only needed when we have to gather/scatter
// (stride != 1); for stride == 1 the FFT runs in place on `buf`.
ComplexScalar* line_buf =
(stride == 1) ? nullptr : (ComplexScalar*)m_device.allocate(sizeof(ComplexScalar) * line_len);
ComplexScalar* a =
is_power_of_two ? nullptr : (ComplexScalar*)m_device.allocate(sizeof(ComplexScalar) * good_composite);
ComplexScalar* b_fft =
is_power_of_two ? nullptr : (ComplexScalar*)m_device.allocate(sizeof(ComplexScalar) * good_composite);
ComplexScalar* pos_j_base_powered =
is_power_of_two ? nullptr : (ComplexScalar*)m_device.allocate(sizeof(ComplexScalar) * (line_len + 1));
if (!is_power_of_two) {
// Bluestein chirp factors t_n = exp(sqrt(-1) * pi * n^2 / line_len),
// n = 0..line_len. Computed in double for accuracy and cast down.
for (Index j = 0; j < line_len + 1; ++j) {
double arg = ((EIGEN_PI * j) * j) / line_len;
std::complex<double> tmp(numext::cos(arg), numext::sin(arg));
pos_j_base_powered[j] = static_cast<ComplexScalar>(tmp);
}
// The b-sequence and its forward FFT depend only on n, m, and the
// FFT direction — compute once and reuse for every line.
precompute_bluestein_b(b_fft, line_len, good_composite, log_len, pos_j_base_powered);
}
for (Index partial_index = 0; partial_index < m_size / line_len; ++partial_index) {
const Index base_offset = getBaseOffsetFromIndex(partial_index, dim);
ComplexScalar* line_ptr = (stride == 1) ? &buf[base_offset] : line_buf;
if (stride != 1) {
Index offset = base_offset;
for (Index j = 0; j < line_len; ++j, offset += stride) {
line_buf[j] = buf[offset];
}
}
if (is_power_of_two) {
processDataLineCooleyTukey(line_ptr, line_len, log_len);
} else {
processDataLineBluestein(line_ptr, line_len, good_composite, log_len, a, b_fft, pos_j_base_powered);
}
if (stride == 1) {
if (FFTDir == FFT_REVERSE) {
for (Index j = 0; j < line_len; ++j) {
line_ptr[j] *= div_factor;
}
}
} else {
Index offset = base_offset;
for (Index j = 0; j < line_len; ++j, offset += stride) {
buf[offset] = (FFTDir == FFT_FORWARD) ? line_buf[j] : line_buf[j] * div_factor;
}
}
}
if (line_buf) m_device.deallocate(line_buf);
if (!is_power_of_two) {
m_device.deallocate(a);
m_device.deallocate(b_fft);
m_device.deallocate(pos_j_base_powered);
}
}
if (!write_to_out) {
for (Index i = 0; i < m_size; ++i) {
data[i] = PartOf<FFTResultType>()(buf[i]);
}
m_device.deallocate(buf);
}
}
EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE static bool isPowerOfTwo(Index x) {
eigen_assert(x > 0);
return !(x & (x - 1));
}
// The composite number for padding, used in Bluestein's FFT algorithm
EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE static Index findGoodComposite(Index n) {
Index i = 2;
while (i < 2 * n - 1) i *= 2;
return i;
}
EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE static Index getLog2(Index m) {
Index log2m = 0;
while (m >>= 1) log2m++;
return log2m;
}
// Build the b-sequence and forward-FFT it once per dim. It depends only on
// (line_len, good_composite, FFTDir), so the result is shared across all
// lines — the main win for batched non-power-of-two transforms.
EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void precompute_bluestein_b(ComplexScalar* b_fft, Index n, Index m, Index log_m,
const ComplexScalar* pos_j_base_powered) {
internal::conj_if<FFTDir == FFT_REVERSE> cj;
for (Index i = 0; i < n; ++i) {
b_fft[i] = cj(pos_j_base_powered[i]);
}
for (Index i = n; i < m - n; ++i) {
b_fft[i] = ComplexScalar(0, 0);
}
for (Index i = m - n; i < m; ++i) {
b_fft[i] = cj(pos_j_base_powered[m - i]);
}
scramble_FFT(b_fft, m);
compute_1D_Butterfly<FFT_FORWARD>(b_fft, m, log_m);
}
// Call Cooley Tukey algorithm directly; line_len must be a power of 2.
EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void processDataLineCooleyTukey(ComplexScalar* line_buf, Index line_len,
Index log_len) {
eigen_assert(isPowerOfTwo(line_len));
scramble_FFT(line_buf, line_len);
compute_1D_Butterfly<FFTDir>(line_buf, line_len, log_len);
}
// Bluestein's algorithm: turn an arbitrary-length transform into three
// length-m power-of-two transforms (m = good_composite >= 2*line_len). The
// forward-FFT of b is taken as input (precomputed once per dim).
EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void processDataLineBluestein(ComplexScalar* line_buf, Index line_len,
Index good_composite, Index log_m,
ComplexScalar* a, const ComplexScalar* b_fft,
const ComplexScalar* pos_j_base_powered) {
const Index n = line_len;
const Index m = good_composite;
// Data-side chirp is conjugated for forward, not for reverse — opposite
// of the b-sequence conjugation in precompute_bluestein_b.
internal::conj_if<FFTDir == FFT_FORWARD> cj;
for (Index i = 0; i < n; ++i) {
a[i] = internal::pmul(line_buf[i], cj(pos_j_base_powered[i]));
}
for (Index i = n; i < m; ++i) {
a[i] = ComplexScalar(0, 0);
}
scramble_FFT(a, m);
compute_1D_Butterfly<FFT_FORWARD>(a, m, log_m);
for (Index i = 0; i < m; ++i) {
a[i] = internal::pmul(a[i], b_fft[i]);
}
scramble_FFT(a, m);
compute_1D_Butterfly<FFT_REVERSE>(a, m, log_m);
const RealScalar inv_m = RealScalar(1) / RealScalar(m);
for (Index i = 0; i < n; ++i) {
line_buf[i] = internal::pmul(a[i] * inv_m, cj(pos_j_base_powered[i]));
}
}
EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE static void scramble_FFT(ComplexScalar* data, Index n) {
eigen_assert(isPowerOfTwo(n));
Index j = 1;
for (Index i = 1; i < n; ++i) {
if (j > i) {
std::swap(data[j - 1], data[i - 1]);
}
Index m = n >> 1;
while (m >= 2 && j > m) {
j -= m;
m >>= 1;
}
j += m;
}
}
template <int Dir>
EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void butterfly_2(ComplexScalar* data) {
ComplexScalar tmp = data[1];
data[1] = data[0] - data[1];
data[0] += tmp;
}
// Closed-form ±i multiplications: (re, im) * (0, ±1) without a generic
// complex multiply. Dispatched via mul_pm_i<Dir> at the radix-{4,8} leaves.
EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE static ComplexScalar mul_neg_i(const ComplexScalar& c) {
return ComplexScalar(c.imag(), -c.real());
}
EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE static ComplexScalar mul_pos_i(const ComplexScalar& c) {
return ComplexScalar(-c.imag(), c.real());
}
template <int Dir>
EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE static ComplexScalar mul_pm_i(const ComplexScalar& c) {
return (Dir == FFT_FORWARD) ? mul_neg_i(c) : mul_pos_i(c);
}
template <int Dir>
EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void butterfly_4(ComplexScalar* data) {
ComplexScalar tmp[4];
tmp[0] = data[0] + data[1];
tmp[1] = data[0] - data[1];
tmp[2] = data[2] + data[3];
tmp[3] = mul_pm_i<Dir>(data[2] - data[3]);
data[0] = tmp[0] + tmp[2];
data[1] = tmp[1] + tmp[3];
data[2] = tmp[0] - tmp[2];
data[3] = tmp[1] - tmp[3];
}
template <int Dir>
EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void butterfly_8(ComplexScalar* data) {
ComplexScalar tmp_1[8];
ComplexScalar tmp_2[8];
tmp_1[0] = data[0] + data[1];
tmp_1[1] = data[0] - data[1];
tmp_1[2] = data[2] + data[3];
tmp_1[3] = mul_pm_i<Dir>(data[2] - data[3]);
tmp_1[4] = data[4] + data[5];
tmp_1[5] = data[4] - data[5];
tmp_1[6] = data[6] + data[7];
tmp_1[7] = mul_pm_i<Dir>(data[6] - data[7]);
tmp_2[0] = tmp_1[0] + tmp_1[2];
tmp_2[1] = tmp_1[1] + tmp_1[3];
tmp_2[2] = tmp_1[0] - tmp_1[2];
tmp_2[3] = tmp_1[1] - tmp_1[3];
tmp_2[4] = tmp_1[4] + tmp_1[6];
// omega_8^1 = (sqrt(2)/2, -sqrt(2)/2) for forward.
constexpr RealScalar kSqrt2Div2 = RealScalar(0.7071067811865476);
if (Dir == FFT_FORWARD) {
tmp_2[5] = internal::pmul(tmp_1[5] + tmp_1[7], ComplexScalar(kSqrt2Div2, -kSqrt2Div2));
tmp_2[6] = mul_neg_i(tmp_1[4] - tmp_1[6]);
tmp_2[7] = internal::pmul(tmp_1[5] - tmp_1[7], ComplexScalar(-kSqrt2Div2, -kSqrt2Div2));
} else {
tmp_2[5] = internal::pmul(tmp_1[5] + tmp_1[7], ComplexScalar(kSqrt2Div2, kSqrt2Div2));
tmp_2[6] = mul_pos_i(tmp_1[4] - tmp_1[6]);
tmp_2[7] = internal::pmul(tmp_1[5] - tmp_1[7], ComplexScalar(-kSqrt2Div2, kSqrt2Div2));
}
data[0] = tmp_2[0] + tmp_2[4];
data[1] = tmp_2[1] + tmp_2[5];
data[2] = tmp_2[2] + tmp_2[6];
data[3] = tmp_2[3] + tmp_2[7];
data[4] = tmp_2[0] - tmp_2[4];
data[5] = tmp_2[1] - tmp_2[5];
data[6] = tmp_2[2] - tmp_2[6];
data[7] = tmp_2[3] - tmp_2[7];
}
template <int Dir>
EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void butterfly_1D_merge(ComplexScalar* data, Index n, Index n_power_of_2) {
// Original code:
// RealScalar wtemp = std::sin(EIGEN_PI/n);
// RealScalar wpi = -std::sin(2 * EIGEN_PI/n);
const RealScalar wtemp = m_sin_PI_div_n_LUT[n_power_of_2];
const RealScalar wpi =
(Dir == FFT_FORWARD) ? m_minus_sin_2_PI_div_n_LUT[n_power_of_2] : -m_minus_sin_2_PI_div_n_LUT[n_power_of_2];
const ComplexScalar wp(wtemp, wpi);
const ComplexScalar wp_one = wp + ComplexScalar(1, 0);
const Index n2 = n / 2;
#if !defined(EIGEN_GPU_COMPILE_PHASE)
// The class-level PacketReturnType keys off OutputScalar, which can be
// real for RealPart/ImagPart modes; resolve the complex packet here so
// the merge always vectorizes regardless of the output reduction.
using CPacket = typename internal::packet_traits<ComplexScalar>::type;
constexpr Index CPacketSize = internal::unpacket_traits<CPacket>::size;
// A batch's twiddles are a broadcast of the running factor times a
// precomputed ramp wp_one^{0..kBatch-1}: one vector pmul per packet
// instead of a scalar cmul per lane plus a round-trip through scratch. The
// running factor advances by wp_one^kBatch per batch; kBatch >= 4 keeps
// that recurrence at the same stride — and thus the same accumulated
// rounding — as the original scalar code.
//
// Two cases fall through to the scalar loop. A 1-wide complex packet
// (CPacketSize == 1: Packet1cd, i.e. SSE2 std::complex<double>) carries no
// SIMD parallelism — the "vector" path is then scalar dressed in packet
// ops and loses to the hand-unrolled scalar fallback. Packets wider than
// kMaxBatch (e.g. RVV with VLEN >= 1024 gives CPacketSize == 16 for
// std::complex<float>) overflow the ramp.
constexpr Index kMaxBatch = 8;
constexpr Index kBatch = (CPacketSize >= 4) ? CPacketSize : Index(4);
if (CPacketSize >= 2 && CPacketSize <= kMaxBatch && kBatch <= n2) {
// ramp[k] = wp_one^k — built once, reused for every batch and every line.
alignas(alignof(CPacket)) ComplexScalar ramp[kMaxBatch];
ramp[0] = ComplexScalar(1, 0);
for (Index k = 1; k < kBatch; ++k) ramp[k] = internal::pmul(ramp[k - 1], wp_one);
const ComplexScalar wp_one_batch = internal::pmul(ramp[kBatch - 1], wp_one);
const ComplexScalar wp_one_2batch = internal::pmul(wp_one_batch, wp_one_batch);
// Two batches are processed per iteration with two independent running
// factors, so the w recurrence (one complex pmul of latency) is no
// longer the serial bottleneck — each chain advances only once per two
// batches and overlaps the butterfly work of the other.
ComplexScalar w(1, 0);
Index i = 0;
for (; i + 2 * kBatch <= n2; i += 2 * kBatch) {
const CPacket wv0 = internal::pset1<CPacket>(w);
const CPacket wv1 = internal::pset1<CPacket>(internal::pmul(w, wp_one_batch));
for (Index k = 0; k < kBatch; k += CPacketSize) {
const CPacket rk = internal::pload<CPacket>(ramp + k);
const CPacket pa0 = internal::ploadu<CPacket>(data + i + k);
const CPacket pb0 = internal::ploadu<CPacket>(data + i + n2 + k);
const CPacket pa1 = internal::ploadu<CPacket>(data + i + kBatch + k);
const CPacket pb1 = internal::ploadu<CPacket>(data + i + kBatch + n2 + k);
const CPacket pt0 = internal::pmul(internal::pmul(wv0, rk), pb0);
const CPacket pt1 = internal::pmul(internal::pmul(wv1, rk), pb1);
internal::pstoreu(data + i + k, internal::padd(pa0, pt0));
internal::pstoreu(data + i + n2 + k, internal::psub(pa0, pt0));
internal::pstoreu(data + i + kBatch + k, internal::padd(pa1, pt1));
internal::pstoreu(data + i + kBatch + n2 + k, internal::psub(pa1, pt1));
}
w = internal::pmul(w, wp_one_2batch);
}
// n2 is a power of two >= kBatch, so this tail runs at most once.
for (; i < n2; i += kBatch) {
const CPacket wv = internal::pset1<CPacket>(w);
for (Index k = 0; k < kBatch; k += CPacketSize) {
const CPacket pw = internal::pmul(wv, internal::pload<CPacket>(ramp + k));
const CPacket pa = internal::ploadu<CPacket>(data + i + k);
const CPacket pb = internal::ploadu<CPacket>(data + i + n2 + k);
const CPacket pt = internal::pmul(pw, pb);
internal::pstoreu(data + i + k, internal::padd(pa, pt));
internal::pstoreu(data + i + n2 + k, internal::psub(pa, pt));
}
}
return;
}
#endif
// Scalar fallback (GPU build, or RVV with VLEN >= 1024 → CPacketSize > 8).
const ComplexScalar wp_one_2 = internal::pmul(wp_one, wp_one);
const ComplexScalar wp_one_3 = internal::pmul(wp_one_2, wp_one);
const ComplexScalar wp_one_4 = internal::pmul(wp_one_3, wp_one);
ComplexScalar w(1.0, 0.0);
for (Index i = 0; i < n2; i += 4) {
const ComplexScalar w1 = internal::pmul(w, wp_one);
const ComplexScalar w2 = internal::pmul(w, wp_one_2);
const ComplexScalar w3 = internal::pmul(w, wp_one_3);
const ComplexScalar temp0 = internal::pmul(data[i + n2], w);
const ComplexScalar temp1 = internal::pmul(data[i + 1 + n2], w1);
const ComplexScalar temp2 = internal::pmul(data[i + 2 + n2], w2);
const ComplexScalar temp3 = internal::pmul(data[i + 3 + n2], w3);
w = internal::pmul(w, wp_one_4);
data[i + n2] = data[i] - temp0;
data[i] += temp0;
data[i + 1 + n2] = data[i + 1] - temp1;
data[i + 1] += temp1;
data[i + 2 + n2] = data[i + 2] - temp2;
data[i + 2] += temp2;
data[i + 3 + n2] = data[i + 3] - temp3;
data[i + 3] += temp3;
}
}
template <int Dir>
EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void compute_1D_Butterfly(ComplexScalar* data, Index n, Index n_power_of_2) {
eigen_assert(isPowerOfTwo(n));
if (n > 8) {
compute_1D_Butterfly<Dir>(data, n / 2, n_power_of_2 - 1);
compute_1D_Butterfly<Dir>(data + n / 2, n / 2, n_power_of_2 - 1);
butterfly_1D_merge<Dir>(data, n, n_power_of_2);
} else if (n == 8) {
butterfly_8<Dir>(data);
} else if (n == 4) {
butterfly_4<Dir>(data);
} else if (n == 2) {
butterfly_2<Dir>(data);
}
}
EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Index getBaseOffsetFromIndex(Index index, Index omitted_dim) const {
Index result = 0;
EIGEN_IF_CONSTEXPR (static_cast<int>(Layout) == static_cast<int>(ColMajor)) {
for (int i = NumDims - 1; i > omitted_dim; --i) {
const Index partial_m_stride = m_strides[i] / m_dimensions[omitted_dim];
const Index idx = index / partial_m_stride;
index -= idx * partial_m_stride;
result += idx * m_strides[i];
}
result += index;
} else {
for (Index i = 0; i < omitted_dim; ++i) {
const Index partial_m_stride = m_strides[i] / m_dimensions[omitted_dim];
const Index idx = index / partial_m_stride;
index -= idx * partial_m_stride;
result += idx * m_strides[i];
}
result += index;
}
// Value of index_coords[omitted_dim] is not determined to this step
return result;
}
protected:
Index m_size;
const FFT EIGEN_DEVICE_REF m_fft;
Dimensions m_dimensions;
array<Index, NumDims> m_strides;
TensorEvaluator<ArgType, Device> m_impl;
EvaluatorPointerType m_data;
const Device EIGEN_DEVICE_REF m_device;
// This will support a maximum FFT size of 2^32 for each dimension
// m_sin_PI_div_n_LUT[i] = (-2) * std::sin(EIGEN_PI / std::pow(2,i)) ^ 2;
const RealScalar m_sin_PI_div_n_LUT[32] = {RealScalar(0.0),
RealScalar(-2),
RealScalar(-0.999999999999999),
RealScalar(-0.292893218813453),
RealScalar(-0.0761204674887130),
RealScalar(-0.0192147195967696),
RealScalar(-0.00481527332780311),
RealScalar(-0.00120454379482761),
RealScalar(-3.01181303795779e-04),
RealScalar(-7.52981608554592e-05),
RealScalar(-1.88247173988574e-05),
RealScalar(-4.70619042382852e-06),
RealScalar(-1.17654829809007e-06),
RealScalar(-2.94137117780840e-07),
RealScalar(-7.35342821488550e-08),
RealScalar(-1.83835707061916e-08),
RealScalar(-4.59589268710903e-09),
RealScalar(-1.14897317243732e-09),
RealScalar(-2.87243293150586e-10),
RealScalar(-7.18108232902250e-11),
RealScalar(-1.79527058227174e-11),
RealScalar(-4.48817645568941e-12),
RealScalar(-1.12204411392298e-12),
RealScalar(-2.80511028480785e-13),
RealScalar(-7.01277571201985e-14),
RealScalar(-1.75319392800498e-14),
RealScalar(-4.38298482001247e-15),
RealScalar(-1.09574620500312e-15),
RealScalar(-2.73936551250781e-16),
RealScalar(-6.84841378126949e-17),
RealScalar(-1.71210344531737e-17),
RealScalar(-4.28025861329343e-18)};
// m_minus_sin_2_PI_div_n_LUT[i] = -std::sin(2 * EIGEN_PI / std::pow(2,i));
const RealScalar m_minus_sin_2_PI_div_n_LUT[32] = {RealScalar(0.0),
RealScalar(0.0),
RealScalar(-1.00000000000000e+00),
RealScalar(-7.07106781186547e-01),
RealScalar(-3.82683432365090e-01),
RealScalar(-1.95090322016128e-01),
RealScalar(-9.80171403295606e-02),
RealScalar(-4.90676743274180e-02),
RealScalar(-2.45412285229123e-02),
RealScalar(-1.22715382857199e-02),
RealScalar(-6.13588464915448e-03),
RealScalar(-3.06795676296598e-03),
RealScalar(-1.53398018628477e-03),
RealScalar(-7.66990318742704e-04),
RealScalar(-3.83495187571396e-04),
RealScalar(-1.91747597310703e-04),
RealScalar(-9.58737990959773e-05),
RealScalar(-4.79368996030669e-05),
RealScalar(-2.39684498084182e-05),
RealScalar(-1.19842249050697e-05),
RealScalar(-5.99211245264243e-06),
RealScalar(-2.99605622633466e-06),
RealScalar(-1.49802811316901e-06),
RealScalar(-7.49014056584716e-07),
RealScalar(-3.74507028292384e-07),
RealScalar(-1.87253514146195e-07),
RealScalar(-9.36267570730981e-08),
RealScalar(-4.68133785365491e-08),
RealScalar(-2.34066892682746e-08),
RealScalar(-1.17033446341373e-08),
RealScalar(-5.85167231706864e-09),
RealScalar(-2.92583615853432e-09)};
};
} // end namespace Eigen
#endif // EIGEN_TENSOR_TENSOR_FFT_H