#!/usr/bin/env python # -*- coding: utf-8 -*- """Fast Fourier Transform (FFT) library container""" __all__ = ["get_fftlib", "set_fftlib"] # Object to hold FFT interfaces __FFTLIB = None def set_fftlib(lib=None): """Set the FFT library used by librosa. Parameters ---------- lib : None or module Must implement an interface compatible with `numpy.fft`. If ``None``, reverts to `numpy.fft`. Examples -------- Use `pyfftw`: >>> import pyfftw >>> librosa.set_fftlib(pyfftw.interfaces.numpy_fft) Reset to default `numpy` implementation >>> librosa.set_fftlib() """ global __FFTLIB if lib is None: from numpy import fft lib = fft __FFTLIB = lib def get_fftlib(): """Get the FFT library currently used by librosa Returns ------- fft : module The FFT library currently used by librosa. Must API-compatible with `numpy.fft`. """ global __FFTLIB return __FFTLIB # Set the FFT library to numpy's, by default set_fftlib(None)