Caution

You're reading an old version of this documentation. If you want up-to-date information, please have a look at 0.10.2.

librosa.resample

librosa.resample(y, *, orig_sr, target_sr, res_type='kaiser_best', fix=True, scale=False, **kwargs)[source]

Resample a time series from orig_sr to target_sr

By default, this uses a high-quality (but relatively slow) method (‘kaiser_best’) for band-limited sinc interpolation. The alternate res_type values listed below offer different trade-offs of speed and quality.

Parameters:

ynp.ndarray [shape=(…, n)]

audio time series. Multi-channel is supported.

orig_srnumber > 0 [scalar]

original sampling rate of y

target_srnumber > 0 [scalar]

target sampling rate

res_typestr

resample type

‘kaiser_best’ (default): resampy high-quality mode
‘kaiser_fast’: resampy faster method
‘fft’ or ‘scipy’: scipy.signal.resample Fourier method.
‘polyphase’: scipy.signal.resample_poly polyphase filtering. (fast)
‘linear’: samplerate linear interpolation. (very fast)
‘zero_order_hold’: samplerate repeat the last value between samples. (very fast)
‘sinc_best’, ‘sinc_medium’ or ‘sinc_fastest’: samplerate high-, medium-, and low-quality sinc interpolation.
‘soxr_vhq’, ‘soxr_hq’, ‘soxr_mq’ or ‘soxr_lq’: soxr Very high-, High-, Medium-, Low-quality FFT-based bandlimited interpolation. 'soxr_hq' is the default setting of soxr (fast)
‘soxr_qq’: soxr Quick cubic interpolation (very fast)

Note

samplerate and soxr are not installed with librosa. To use samplerate or soxr, they should be installed manually:

$ pip install samplerate
$ pip install soxr

Note

When using res_type='polyphase', only integer sampling rates are supported.

fixbool

adjust the length of the resampled signal to be of size exactly ceil(target_sr * len(y) / orig_sr)

scalebool

Scale the resampled signal so that y and y_hat have approximately equal total energy.

**kwargsadditional keyword arguments

If fix==True, additional keyword arguments to pass to librosa.util.fix_length.

Returns:

y_hatnp.ndarray [shape=(…, n * target_sr / orig_sr)]: y resampled from orig_sr to target_sr

Raises:

ParameterError: If res_type='polyphase' and orig_sr or target_sr are not both integer-valued.