********* Changelog ********* v0.9 ==== v0.9.2 ------ 2022-06-27 Bug fixes - `#1457`_ Fixed `librosa.show_versions` to match package dependencies. *Brian McFee* - `#1493`_ Fixed a bug in `librosa.effects.split` when applied to multichannel data. *Brian McFee* Documentation - `#1447`_ Migrated documentation builds to GitHub Actions. *Brian McFee* - `#1469`_ Corrected documentation for `db_to_amplitude` and `amplitude_to_db`. *i-aki-y* - `#1473`_ Readability improvements to package README. *Asmitha Krishnakumar* - `#1475`_ Expanded documentation to `librosa.sequence.viterbi_discriminative`. *Brian McFee* - `#1487`_ Readability improvements to package README. *Chandrashekhar Ramaprasad* - `#1491`_ Pinned sphinx version for documentation builds. *Brian McFee* - `#1511`_ Expanded documentation for `find_files`. *Xiao-Ming* - `#1513`_ Various documentation updates and enhancements. *Brian McFee* Other changes - `#1453`_ Removed test data from main repository and reduced the git attic. *Brian McFee* - `#1479`_ Accept pre-constructed audioread objects in `librosa.load`. *Brian McFee* - `#1504`_ Accelerate `librosa.magphase`. *Will Monroe* - `#1507`_, `#1508`_, `#1509`_ Various spelling corrections in documentation, comments, and warnings. *Lorenz Nickel* .. _#1457: https://github.com/librosa/librosa/issues/1457 .. _#1493: https://github.com/librosa/librosa/issues/1493 .. _#1447: https://github.com/librosa/librosa/issues/1447 .. _#1469: https://github.com/librosa/librosa/issues/1469 .. _#1473: https://github.com/librosa/librosa/issues/1473 .. _#1475: https://github.com/librosa/librosa/issues/1475 .. _#1487: https://github.com/librosa/librosa/issues/1487 .. _#1491: https://github.com/librosa/librosa/issues/1491 .. _#1511: https://github.com/librosa/librosa/issues/1511 .. _#1513: https://github.com/librosa/librosa/issues/1513 .. _#1453: https://github.com/librosa/librosa/issues/1453 .. _#1479: https://github.com/librosa/librosa/issues/1479 .. _#1504: https://github.com/librosa/librosa/issues/1504 .. _#1507: https://github.com/librosa/librosa/issues/1507 .. _#1508: https://github.com/librosa/librosa/issues/1508 .. _#1509: https://github.com/librosa/librosa/issues/1509 v0.9.1 ------ 2022-02-15 This release provides partial backward compatibility to the 0.8 series. The 0.9.0 release introduced restrictions on positional arguments to many functions, requiring parameters to be passed by keyword arguments instead. In 0.9.1, positional parameters now trigger warnings instead of errors, so 0.8-compatible code should work again. Additional changes: - `#1448`_ Documentation for `librosa.effects.trim` and `librosa.effects.split` has been corrected to reflect a semantic change in the `ref` parameter introduced by `#1130`_. Explicit `ref` values now measure amplitude rather than power. .. _#1448: https://github.com/librosa/librosa/issues/1448 v0.9.0 ------ 2022-02-07 The main feature of this release is (nearly) full support for arbitrary multi-channel processing, along with several speed and stability enhancements. A detailed list of changes is provided below. New Features - `#1130`_ Nearly full support for multi-channel processing. *Brian McFee, Daniel Faronbi, Iran Roman* - `#1331`_ Option to disable unicode characters in display functions. *Brian McFee* - `#1441`_ Significantly expanded the library of example audio clips. *Brian McFee* API changes - `#1114`_ Most functions now require keyword arguments. *Brian McFee* - `#1382`_ The default padding mode for most functions (including STFT) is now zero-padding. *Brian McFee* - `#1418`_ `librosa.load` and `librosa.stream` can now operate directly on open `soundfile` objects. *Brian McFee* - `#1414`_ `librosa.display.specshow` now uses centered coordinate grids. *Brian McFee* - `#1398`_ `librosa.iirt` now exposes API control over resampling modes. *Brian McFee* - `#1416`_ Removed deprecated functions `librosa.display.waveplot` and `librosa.util.example_audio_file`. *Brian McFee* Bug fixes - `#1387`_ Fixed errors in support of odd frame lengths in various functions. *Brian McFee* - `#1273`_ Minor corrections to constants in perceptual weighting functions. *Brian McFee* - `#1350`_ Removed uses of deprecated numpy numerical types. *Brian McFee* - `#1361`_ Maximum frequency is now correctly inferred as Nyquist in onset strength calculation. *Brian McFee* - `#1362`_ `librosa.effects.deemphasis` no longer modifies the input signal in-place. *Brian McFee* - `#1375`_ `librosa.util.frame` now correctly works for arbitrary memory layouts and numbers of axes. *Brian McFee* - `#1425`_ Fixed an off-by-one error in `librosa.yin` and `librosa.pyin`. *@philstem, Brian McFee* - `#1430`_ Removed unnecessary `__all__` specifications to better support static analysis. *Fabian Keller* - `#1407`_ Corrected a normalization error in inverse CQT. *Brian McFee, Vincent Lostanlen* Documentation - `#1328`_ Retired the `examples/` folder and expanded the `Advanced Examples` gallery. *Brian McFee* - `#1427`_ Fixed docstring for `librosa.reassigned_spectrogram`. *Fabian Keller* Other changes - `#418`_ `librosa.cqt` now supports arbitrary hop lengths. *Brian McFee* - `#1405`_ Improvements and generalizations to constant-Q/variable-Q basis construction. *Brian McFee, Vincent Lostanlen* - `#1324`_ Added a run-time check for minimally supported matplotlib versions. *Brian McFee* - `#1325`_ Enhanced continuous integration testing for oldest and newest environments. *Brian McFee* - `#1358`_ Harmonic interpolation now preemptively detects repeated values that produce unstable estimates. *Brian McFee* - `#1432`_ Specify stack levels in warnings to provide more helpful warning messages. *Brian McFee* - `#1404`_, `#1406`_ Improved packaging configurations. *Alex Malins* - `#1384`_ Fixed package configuration error for documentation builds. *Adam Weiss* Deprecations - `#1389`_ The `mono` parameter of `librosa.util.valid_audio` is deprecated and the default is now set to `False`. *Brian McFee* - `#1405`_ CQT filter-bank constructors `librosa.filters.constant_q` are now deprecated in favor of `librosa.filters.wavelet`. *Brian McFee, Vincent Lostanlen* .. _#418: https://github.com/librosa/librosa/issues/418 .. _#1114: https://github.com/librosa/librosa/issues/1114 .. _#1130: https://github.com/librosa/librosa/issues/1130 .. _#1273: https://github.com/librosa/librosa/issues/1273 .. _#1324: https://github.com/librosa/librosa/issues/1324 .. _#1325: https://github.com/librosa/librosa/issues/1325 .. _#1328: https://github.com/librosa/librosa/issues/1328 .. _#1331: https://github.com/librosa/librosa/issues/1331 .. _#1350: https://github.com/librosa/librosa/issues/1350 .. _#1358: https://github.com/librosa/librosa/issues/1358 .. _#1361: https://github.com/librosa/librosa/issues/1361 .. _#1362: https://github.com/librosa/librosa/issues/1362 .. _#1375: https://github.com/librosa/librosa/issues/1375 .. _#1382: https://github.com/librosa/librosa/issues/1382 .. _#1384: https://github.com/librosa/librosa/issues/1384 .. _#1387: https://github.com/librosa/librosa/issues/1387 .. _#1389: https://github.com/librosa/librosa/issues/1389 .. _#1398: https://github.com/librosa/librosa/issues/1398 .. _#1404: https://github.com/librosa/librosa/issues/1404 .. _#1405: https://github.com/librosa/librosa/issues/1405 .. _#1406: https://github.com/librosa/librosa/issues/1406 .. _#1407: https://github.com/librosa/librosa/issues/1407 .. _#1414: https://github.com/librosa/librosa/issues/1414 .. _#1416: https://github.com/librosa/librosa/issues/1416 .. _#1418: https://github.com/librosa/librosa/issues/1418 .. _#1425: https://github.com/librosa/librosa/issues/1425 .. _#1427: https://github.com/librosa/librosa/issues/1427 .. _#1430: https://github.com/librosa/librosa/issues/1430 .. _#1432: https://github.com/librosa/librosa/issues/1432 .. _#1441: https://github.com/librosa/librosa/issues/1441 v0.8 ==== v0.8.1 ------ 2021-05-26 New Features - `#1293`_ `librosa.effects.deemphasis`, inverse operation of `librosa.effects.preemphasis`. *Dan Mazur* - `#1207`_ `librosa.display.waveshow`, adaptively visualize waveforms by amplitude envelope when zoomed out, or raw sample values when zoomed in. *Brian McFee* - `#1338`_ `librosa.resample` now optionally supports `soxr`. *Myungchul Keum* Bug fixes - `#1290`_ `librosa.display.specshow` fixed a bug in format and tick locations for CQT plots. *Brian McFee* - `#1240`_ `librosa.display.specshow` now correctly infers `fmax` for mel frequency axes. *Brian McFee, Bea Steers* - `#1311`_ `librosa.filters.chroma` fixed an error in how chromagrams were generated when `n_chroma!=12` and `base_c=True`. *Joon Lim* - `#1322`_ `librosa.feature.inverse.mel_to_audio` now infers `hop_length` by default in a way that is consistent with the rest of the package. *Dan Ellis* - `#1341`_ `librosa.onset.onset_detect` no longer modifies user-provided onset envelopes. *Brian McFee* Documentation - `#1211`_ fixed a broken link in the changelog. *Pavel Campr* - `#1218`_ corrected an exception/warning message in `librosa.stft` when the frame length exceeds the input length. *Frank Zalkow* - `#1237`_ fixed spelling errors in `librosa.yin` and `librosa.pyin` documentation. *Tim Gates* - `#1284`_ fixed broken links in `CONTRIBUTING.md` document. *Abduttayyeb Mazhar* - `#1287`_ expanded instructions for installing ffmpeg on Windows. *Cash TingHin Lo* - `#1298`_ fixed a dimension calculation error in `librosa.stream` documentation. *Xinlu Zhuang* - `#1321`_ fixed a mismatched parenthesis in `librosa.feature.mfcc` documentation. *Connor Guerrero* - `#1333`_ expanded documentation describing unsupported codecs in `librosa.load`. *Brian McFee* Other changes - `#1312`_ `librosa.display.specshow` can now automatically sets the aspect ratio of a plot if the axes are of the same type and shape. *N. Dorukhan Sergin* - `#1323`_, `#1317_`, `#1308`_ simplified testing framework and migrated to GitHub Actions. *Brian McFee* - `#1324`_ `librosa.display.specshow` is now future-proofed for matplotlib 3.5. *Brian McFee* - `#1334`_ `librosa.display.specshow` now supports HTK-style Mel scaling. *Brian McFee* - `#1335`_, `#1336`_ `librosa.display.specshow` now supports pitch notation (Western, Hindustani, and Carnatic) for STFT matrices. *Paul Biberstein, Brian McFee* - `#1333`_ minimum version of `soundfile` has been updated to 0.10.2. *Brian McFee* - `#1340`_ several functions now support `np.integer`-valued parameters as well as integer-valued parameters. *Brian McFee* - `#1207`_ `librosa.display` time-formatted axes now have enhanced precision at short time scales. *Brian McFee* - `#1341`_ `librosa.onset.onset_detect` can now optionally disable normalization of the onset envelope. *Brian McFee* Deprecations to be removed in 0.9 - `librosa.display.waveplot` is now deprecated in favor of `librosa.display.waveshow`. .. _#1293: https://github.com/librosa/librosa/issues/1293 .. _#1207: https://github.com/librosa/librosa/issues/1207 .. _#1290: https://github.com/librosa/librosa/issues/1290 .. _#1240: https://github.com/librosa/librosa/issues/1240 .. _#1311: https://github.com/librosa/librosa/issues/1311 .. _#1322: https://github.com/librosa/librosa/issues/1322 .. _#1211: https://github.com/librosa/librosa/issues/1211 .. _#1218: https://github.com/librosa/librosa/issues/1218 .. _#1237: https://github.com/librosa/librosa/issues/1237 .. _#1284: https://github.com/librosa/librosa/issues/1284 .. _#1287: https://github.com/librosa/librosa/issues/1287 .. _#1298: https://github.com/librosa/librosa/issues/1298 .. _#1321: https://github.com/librosa/librosa/issues/1321 .. _#1333: https://github.com/librosa/librosa/issues/1333 .. _#1312: https://github.com/librosa/librosa/issues/1312 .. _#1323: https://github.com/librosa/librosa/issues/1323 .. _#1317: https://github.com/librosa/librosa/issues/1317 .. _#1308: https://github.com/librosa/librosa/issues/1308 .. _#1324: https://github.com/librosa/librosa/issues/1324 .. _#1334: https://github.com/librosa/librosa/issues/1334 .. _#1335: https://github.com/librosa/librosa/issues/1335 .. _#1336: https://github.com/librosa/librosa/issues/1336 .. _#1340: https://github.com/librosa/librosa/issues/1340 .. _#1341: https://github.com/librosa/librosa/issues/1341 .. _#1338: https://github.com/librosa/librosa/issues/1338 v0.8.0 ------ 2020-07-22 New Features - `#1203`_ Support for Carnatic and Hindustani notations. *Brian McFee, Kaushik Sripathi Hatti, Kaustuv Kanti Ganguli* - `librosa.hz_to_svara_c`, `librosa.hz_to_svara_h` - `librosa.midi_to_svara_c`, `librosa.midi_to_svara_h` - `librosa.note_to_svara_c`, `librosa.note_to_svara_h` - `librosa.list_mela`, `librosa.list_thaat` - and `librosa.display.specshow` support. - `#1063`_ `librosa.yin` and `librosa.pyin` for fundamental frequency estimation. *Benjamin van Niekirk* - `#1018`_ Variable-Q transform `librosa.vqt`. *Brian McFee, Frank Cwitkowitz* - `#1059`_ `libsamplerate` support in `librosa.resample`. *Brian McFee* - `#1134`_ perceptual loudness weighting for B, C, D, and Z-weighting. *Bea Steers* - `#1149`_ key support and note-spelling in pitch<=>note conversion. *Brian McFee* - `#1150`_ new data loader, and expanded collection of example recordings. *Brian McFee* - `#1166`_ `librosa.sequence.dtw` can now return the step matrix. *Frank Zaklow* - `#1171`_ automatic precision inference for spectral transforms (stft, cqt) and explicit control for `librosa.cqt`. *Brian McFee* - `#1198`_ `librosa.util.localmin` for computing local minima. *Brian McFee* Removed features and API changes - `#1062`_ - Removed support for python < 3.6. - Removed the deprecated `output` module. - Removed deprecated `ifgram` function. - Removed deprecated `amin` parameter from `icqt` - Removed deprecated `A440` parameter from `hz_to_octs`, `octs_to_hz`, and `chroma` features - Removed deprecated `tuning=` parameter in CQT filter constructors - Removed deprecated `util.roll_sparse` function - `#1050`_ implemented changes to Mel filter normalization - `#1165`_ removed deprecated `optional_jit` decorator Deprecations to be removed in 0.9 - `librosa.util.example_audio_file` is now deprecated in favor of `librosa.util.example`. Bug fixes - `#1078`_ fixed edge-padding errors in `librosa.feature.stack_memory`. *beantowel* - `#1091`_ fixed joblib version requirements. *Thor Whalen* - `#1094`_ fixed STFT bug when using large window sizes. *Frank Zalkow* - `#1157`_, `#1196`_ fixed an alignment bug in `librosa.iirt`. *Frank Zalkow* - `#1159`_ fixed a warm-up glitch in `librosa.effects.preemphasis`. *Brian McFee* - `#1179`_ fixed memory initialization in unit tests. *Brian McFee* Documentation - `#1068`_ Corrections to `librosa.effects.pitch_shift` documentation. *Keunwoo Choi* Other changes - `#1064`_ unit test suite modernized to support latest `pytest`. *Brian McFee* - `#1112`_ numba accelerated `librosa.feature.stack_memory`. *Brian McFee* - `#1120`_ added reference tuning for pitch conversion utilities. *Julia Wilkins* - `#1123`_ fixed Python requirement definition in installation script. *Stefan Sullivan* - `#1125`_ updates to `librosa.util.frame` to remove default parameters and relax contiguity restrictions. *Brian McFee* - `#1131`_ more stringent shape requirements on `librosa.util.valid_audio`. *Brian McFee* - `#1140`_ removed contiguity requirement for `librosa.util.valid_audio`. *Brian McFee* - `#1147`_ updates to `librosa.display.specshow` documentation. *Brian McFee* - `#1182`_ `librosa.display.specshow` now returns a `QuadMesh` object, rather than the axes handle. *Brian McFee* - `#1183`_ `librosa.feature.chroma_cqt` now uses higher CQT resolution by default. *Brian McFee* - `#1183`_ `librosa.feature.tonnetz` can now pass-through arguments to `librosa.feature.chroma_cqt`. *Brian McFee* - `#1186`_ `librosa.display.cmap` now returns binary colormaps for boolean data. *Brian McFee* .. _#1203: https://github.com/librosa/librosa/issues/1203 .. _#1018: https://github.com/librosa/librosa/issues/1018 .. _#1059: https://github.com/librosa/librosa/issues/1059 .. _#1134: https://github.com/librosa/librosa/issues/1134 .. _#1149: https://github.com/librosa/librosa/issues/1149 .. _#1150: https://github.com/librosa/librosa/issues/1150 .. _#1166: https://github.com/librosa/librosa/issues/1166 .. _#1171: https://github.com/librosa/librosa/issues/1171 .. _#1062: https://github.com/librosa/librosa/issues/1062 .. _#1050: https://github.com/librosa/librosa/issues/1050 .. _#1165: https://github.com/librosa/librosa/issues/1165 .. _#1078: https://github.com/librosa/librosa/issues/1078 .. _#1091: https://github.com/librosa/librosa/issues/1091 .. _#1094: https://github.com/librosa/librosa/issues/1094 .. _#1157: https://github.com/librosa/librosa/issues/1157 .. _#1159: https://github.com/librosa/librosa/issues/1159 .. _#1179: https://github.com/librosa/librosa/issues/1179 .. _#1068: https://github.com/librosa/librosa/issues/1068 .. _#1064: https://github.com/librosa/librosa/issues/1064 .. _#1112: https://github.com/librosa/librosa/issues/1112 .. _#1120: https://github.com/librosa/librosa/issues/1120 .. _#1123: https://github.com/librosa/librosa/issues/1123 .. _#1125: https://github.com/librosa/librosa/issues/1125 .. _#1131: https://github.com/librosa/librosa/issues/1131 .. _#1140: https://github.com/librosa/librosa/issues/1140 .. _#1147: https://github.com/librosa/librosa/issues/1147 .. _#1182: https://github.com/librosa/librosa/issues/1182 .. _#1183: https://github.com/librosa/librosa/issues/1183 .. _#1186: https://github.com/librosa/librosa/issues/1186 .. _#1196: https://github.com/librosa/librosa/issues/1196 .. _#1198: https://github.com/librosa/librosa/issues/1198 .. _#1063: https://github.com/librosa/librosa/issues/1063 v0.7 ==== v0.7.2 ------ 2020-01-13 New Features - `#1008`_ added liftering support to MFCC inversion. *Ayoub Malek* - `#1021`_ added `pathlib` support to `librosa.load`. *Stef van der Struijk* - `#1022`_ added "mu-law" compression and expansion (companding). *Brian McFee* Bug fixes - `#1031`_ fixed errors in dynamic time warping with `NaN` inputs and detection of invalid warping paths. *Frank Zalkow, Brian McFee* - `#1041`_ fixed frame-length normalization in spectrogram-based RMS energy calculation. *Shunsuke Hidaka* - `#1054`_ fixed the length of signals produced by `librosa.tone`. *Brian McFee* Documentation - `#1038`_ removed math formatting from documentation. *Vincent Lostanlen* - `#1042`_ corrected documentation for DTW. *Eric Semeniuc* - `#1043`_ corrected typos in time-frequency reassignment spectrogram documentation. *Scott Seyfarth* - `#1055`_ removed `dct_type=None` as an option in MFCC documentation. *Brian McFee* Other changes - `#1050`_ expanded normalization modes in Mel basis construction. *Brian McFee* .. _#1008: https://github.com/librosa/librosa/issues/1008 .. _#1021: https://github.com/librosa/librosa/issues/1021 .. _#1022: https://github.com/librosa/librosa/issues/1022 .. _#1031: https://github.com/librosa/librosa/issues/1031 .. _#1041: https://github.com/librosa/librosa/issues/1041 .. _#1054: https://github.com/librosa/librosa/issues/1054 .. _#1038: https://github.com/librosa/librosa/issues/1038 .. _#1042: https://github.com/librosa/librosa/issues/1042 .. _#1043: https://github.com/librosa/librosa/issues/1043 .. _#1055: https://github.com/librosa/librosa/issues/1055 .. _#1050: https://github.com/librosa/librosa/issues/1050 v0.7.1 ------ 2019-10-09 New Features - `#966`_ `librosa.util.frame` now supports multidimensional data. Includes a new helper function `librosa.util.stack` for contiguous concatenation. *Brian McFee* - `#934`_ `librosa.griffinlim_cqt`: Phase retrieval from constant-Q magnitude spectra. *Brian McFee* - `#940`_ Enhanced compatibility with HTK's MFCC implementation: `librosa.effects.preemphasis` and `lifter=` parameter in MFCC. *Brian McFee* - `#949`_ `librosa.util.shear` utility for shear-transforming 2D arrays. *Brian McFee* - `#926`_ `librosa.reassigned_spectrogram`: time-frequency reassigned spectrogram. *Scott Seyfarth* Bug fixes - `#983`_ Added a missing parameter to `librosa.griffinlim_cqt`. *Voodoohop* - `#978`_ Correct FFT normalization discrepancy in rms calculation. *Brian McFee* - `#930`_ Corrected an error in automatic tuning correction for CQT. *Brian McFee* - `#942`_ Fixed seeking behavior in `librosa.stream` when operating on file-handle inputs. *Carl Thome* - `#920`_ Fixed a boundary condition check in full-sequence DTW. *Frank Zalkow* Documentation - `#976`_ Fixed a typo in `librosa.stream` documentation. *Alastair Porter* - `#958`_ Visualization of reassigned spectrograms. *Vincent Lostanlen* - `#943`_ Improved documentation for `librosa.stft`. *Vincent Lostanlen* - `#939`_ Expanded documentation of `librosa.feature.melspectrogram`. *Vincent Lostanlen* Other changes - `#1004`_ Expose frame parameters in `librosa.onset` and `librosa.feature.chroma_stft` functions. *Brian McFee* - `#1003`_ Removed warning filter reset, and changed the Python2 deprecation warning to class `FutureWarning`. *Brian McFee, Fabian Keller* - `#1000`_ Fixed an upstream deprecation warning from `np.asscalar()`. *Vincent Lostanlen* - `#971`_ Beat and tempo estimation now support prior distributions. *Brian McFee* - `#968`_ `librosa.util.valid_audio` now enforces memory contiguity. *Vincent Lostanlen* - `#963`_ Improved x-axis decoration types in `librosa.display.waveplot`. *Vincent Lostanlen* - `#960`_ Ensure memory contiguity of audio buffers after resampling. *Brian McFee* - `#957`_ Code-base audit for proper usage of `librosa.times_like`. *Brian McFee* - `#953`_ Deprecated `librosa.ifgram` in favor of `librosa.reassigned_spectrogram`. *Brian McFee* - `#950`_ Allow initial phase estimates for `librosa.griffinlim` methods. *Brian McFee* - `#949`_ Accelerated `librosa.segment.lag_to_recurrence` and `librosa.segment.recurrence_to_lag`. Deprecated `librosa.util.roll_sparse`. *Brian McFee* - `#930`_ `A440=` parameter has been deprecated across the library in favor of a standardized `tuning=` parameter. *Brian McFee* .. _#966: https://github.com/librosa/librosa/issues/966 .. _#934: https://github.com/librosa/librosa/issues/934 .. _#940: https://github.com/librosa/librosa/issues/940 .. _#949: https://github.com/librosa/librosa/issues/949 .. _#926: https://github.com/librosa/librosa/issues/926 .. _#983: https://github.com/librosa/librosa/issues/983 .. _#978: https://github.com/librosa/librosa/issues/978 .. _#930: https://github.com/librosa/librosa/issues/930 .. _#942: https://github.com/librosa/librosa/issues/942 .. _#920: https://github.com/librosa/librosa/issues/920 .. _#976: https://github.com/librosa/librosa/issues/976 .. _#958: https://github.com/librosa/librosa/issues/958 .. _#943: https://github.com/librosa/librosa/issues/943 .. _#939: https://github.com/librosa/librosa/issues/939 .. _#1004: https://github.com/librosa/librosa/issues/1004 .. _#1003: https://github.com/librosa/librosa/issues/1003 .. _#1000: https://github.com/librosa/librosa/issues/1000 .. _#971: https://github.com/librosa/librosa/issues/971 .. _#968: https://github.com/librosa/librosa/issues/968 .. _#963: https://github.com/librosa/librosa/issues/963 .. _#960: https://github.com/librosa/librosa/issues/960 .. _#957: https://github.com/librosa/librosa/issues/957 .. _#953: https://github.com/librosa/librosa/issues/953 .. _#950: https://github.com/librosa/librosa/issues/950 v0.7.0 ------ 2019-07-07 Note: the 0.7 series will be the last to officially support Python 2.7. New features - `#772`_ `librosa.stream`: Stream generator to process long audio files into smaller pieces. *Brian McFee* - `#845`_ `librosa.load`: Replaced the default audio decoder with `pysoundfile`, and only use `audioread` as backup. *Brian McFee* - `#843`_ `librosa.griffinlim`: Phase retrieval from magnitude spectrograms using the (accelerated) Griffin-Lim method. *Brian McFee* - `#843`_ `librosa.feature.inverse`: New module for feature inversion, based on the Griffin-Lim phase retrieval algorithm. Includes `mel_to_audio` and `mfcc_to_audio`. *Brian McFee* - `#725`_ `librosa.lpc`: Linear prediction coefficients (LPC). *Adam Weiss* - `#907`_ `librosa.sequence.rqa`: Recurrence Quantification Analysis (RQA) for sequence alignment. *Brian McFee* - `#739`_ `librosa.beat.plp`: Predominant local pulse (PLP) for variable-tempo beat tracking. *Brian McFee* - `#894`_ `librosa.feature.fourier_tempogram`: Fourier Tempogram for representing rhythm in the frequency domain. *Brian McFee* - `#891`_ `librosa.pcen` Per-channel energy normalization (PCEN) now allows logarithmic range compression at the limit power->0. *Vincent Lostanlen* - `#863`_ `librosa.effects.pitch_shift` supports custom resampling modes. *Taewoon Kim* - `#857`_ `librosa.cqt` and `librosa.icqt` Forward and inverse constant-Q transform now support custom resampling modes. *Brian McFee* - `#842`_ `librosa.segment.path_enhance`: Near-diagonal path enhancement for recurrence, self- or cross-similarity matrices. *Brian McFee* - `#840`_ `librosa.segment.recurrence_matrix` now supports a keyword argument, `self=False`. If set to `True`, the recurrence matrix includes self-loops. *Brian McFee* - `#776`_ `librosa.piptrack` now supports a keyword argument, `ref=None`, allowing users to override the reference thresholding behavior for determining which bins correspond to pitches. *Brian McFee* - `#770`_ `librosa.segment.cross_similarity`: Cross-similarity function for comparing two feature sequences. *Rachel Bittner, Brian McFee* - `#709`_ `librosa.onset.onset_strength_multi` now supports a user-specified reference spectrum via the `ref` keyword argument. *Brian McFee* - `#576`_ `librosa.resample` now supports `mode='polyphase'`. *Brian McFee* - `#519`_ `librosa.onset.onset_strength_multi`: Setting `aggregate=False` disables the aggregation of onset strengths across frequency bins. *Brian McFee* Bug fixes - `#900`_ `librosa.effects.pitch_shift` now preserves length. *Vincent Lostanlen* - `#891`_ `librosa.pcen` Dynamic range compression in PCEN is more numerically stable for small values of the exponent. *Vincent Lostanlen* - `#888`_ `librosa.ifgram` Instantaneous frequency spectrogram now correctly estimates center frequencies when using windows other than `hann`. *Brian McFee* - `#869`_ `librosa.sequence.dtw` Fixed a bug in dynamic time warping when `subseq=True`. *Viktor Andreevitch Morozov* - `#851`_ `librosa.pcen` now initializes its autoregressive filtering in the steady state, not with silence. *Jan Schlüter, Brian McFee* - `#833`_ `librosa.segment.recurrence_matrix`: `width` parameter now cannot exceed data length. *Brian McFee* - `#825`_ Filter bank constructors `mel`, `chroma`, `constant_q`, and `cq_to_chroma` are now type-stable. *Vincent Lostanlen, Brian McFee* - `#802`_ `librosa.icqt` Inverse constant-Q transform has been completely rewritten and is more numerically stable. *Brian McFee* Removed features (deprecated in v0.6) - Discrete cosine transform. We recommend using `scipy.fftpack.dct` - The `delta` function no longer support the `trim` keyword argument. - Root mean square error (`rmse`) has been renamed to `rms`. - `iirt` now uses `sos` mode by default. Documentation - `#891`_ Improved the documentation of PCEN. *Vincent Lostanlen* - `#884`_ Improved installation documentation. *Darío Hereñú* - `#882`_ Improved code style for plot generation. *Alex Metsai* - `#874`_ Improved the documentation of spectral features. *Brian McFee* - `#804`_ Improved the documentation of MFCC. *Brian McFee* - `#849`_ Removed a redundant link in the `util` documentation. *Keunwoo Choi* - `#827`_ Improved the docstring of `recurrence_matrix`. *Brian McFee* - `#813`_ Improved the docstring of `load`. *Andy Sarroff* Other changes - `#917`_ The `output` module is now deprecated, and will be removed in version 0.8. - `#878`_ More informative exception handling. *Jack Mason* - `#857`_ `librosa.resample()` now supports `mode='fft'`, equivalent to the previous `scipy` mode. *Brian McFee* - `#854`_ More efficient length-aware ISTFT and ICQT. *Vincent Lostanlen* - `#846`_ Nine librosa functions now store jit-compiled, numba-accelerated caches across sessions. *Brian McFee* - `#841`_ `librosa.load` no longer relies on `realpath()`. *Brian McFee* - `#834`_ All spectral feature extractors now expose all STFT parameters. *Brian McFee* - `#829`_ Refactored `librosa.cache`. *Brian McFee* - `#818`_ Thanks to `np.fft.rfft`, functions `stft`, `istft`, `ifgram`, and `fmt` are faster and have a reduced memory footprint. *Brian McFee* .. _#772: https://github.com/librosa/librosa/issues/772 .. _#845: https://github.com/librosa/librosa/issues/845 .. _#907: https://github.com/librosa/librosa/issues/907 .. _#739: https://github.com/librosa/librosa/issues/739 .. _#894: https://github.com/librosa/librosa/issues/894 .. _#891: https://github.com/librosa/librosa/issues/891 .. _#863: https://github.com/librosa/librosa/issues/863 .. _#857: https://github.com/librosa/librosa/issues/857 .. _#843: https://github.com/librosa/librosa/issues/843 .. _#842: https://github.com/librosa/librosa/issues/842 .. _#840: https://github.com/librosa/librosa/issues/840 .. _#776: https://github.com/librosa/librosa/issues/776 .. _#770: https://github.com/librosa/librosa/issues/770 .. _#725: https://github.com/librosa/librosa/issues/725 .. _#709: https://github.com/librosa/librosa/issues/709 .. _#576: https://github.com/librosa/librosa/issues/576 .. _#519: https://github.com/librosa/librosa/issues/519 .. _#900: https://github.com/librosa/librosa/issues/900 .. _#888: https://github.com/librosa/librosa/issues/888 .. _#869: https://github.com/librosa/librosa/issues/869 .. _#851: https://github.com/librosa/librosa/issues/851 .. _#833: https://github.com/librosa/librosa/issues/833 .. _#825: https://github.com/librosa/librosa/issues/825 .. _#802: https://github.com/librosa/librosa/issues/802 .. _#884: https://github.com/librosa/librosa/issues/884 .. _#882: https://github.com/librosa/librosa/issues/882 .. _#874: https://github.com/librosa/librosa/issues/874 .. _#804: https://github.com/librosa/librosa/issues/804 .. _#849: https://github.com/librosa/librosa/issues/849 .. _#827: https://github.com/librosa/librosa/issues/827 .. _#813: https://github.com/librosa/librosa/issues/813 .. _#878: https://github.com/librosa/librosa/issues/878 .. _#857: https://github.com/librosa/librosa/issues/857 .. _#854: https://github.com/librosa/librosa/issues/854 .. _#846: https://github.com/librosa/librosa/issues/846 .. _#841: https://github.com/librosa/librosa/issues/841 .. _#834: https://github.com/librosa/librosa/issues/834 .. _#829: https://github.com/librosa/librosa/issues/829 .. _#818: https://github.com/librosa/librosa/issues/818 .. _#917: https://github.com/librosa/librosa/issues/917 v0.6 ==== v0.6.3 ------ 2019-02-13 Bug fixes - `#806`_ Fixed a bug in `librosa.estimate_tuning`. *@robrib, Monsij Biswal, Brian McFee* - `#799`_ Enhanced stability of elliptical filter implementation in `iirt`. *Frank Zalkow* New features - `#766`_ made smoothing optional in `librosa.feature.chroma_cens`. *Kyungyun Lee* - `#760`_ allow explicit units for time axis decoration in `librosa.display`. *Kyungyun Lee* Other changes - `#813`_ updated `librosa.load` documentation to cover bit depth truncation. *Andy Sarroff* - `#805`_ updated documentation for `librosa.localmax`. *Brian McFee* - `#801`_ renamed `librosa.feature.rmse` to `librosa.feature.rms`. *@nullmightybofo* - `#793`_ updated comments in `librosa.stft`. *Dan Ellis* - `#791`_ updated documentation for `write_wav`. *Brian McFee* - `#790`_ removed dependency on deprecated `imp` module. *Brian McFee* - `#787`_ fixed typos in CONTRIBUTING documentation. *Vincent Lostanlen* - `#785`_ removed all run-time assertions in favor of proper exceptions. *Brian McFee* - `#783`_ migrated test infrastructure from `nose` to `pytest`. *Brian McFee* - `#777`_ include LICENSE file in source distribution. *toddrme2178* - `#769`_ updated documentation in `librosa.istft`. *Shayenne Moura* .. _#813: https://github.com/librosa/librosa/issues/813 .. _#806: https://github.com/librosa/librosa/issues/806 .. _#805: https://github.com/librosa/librosa/issues/805 .. _#801: https://github.com/librosa/librosa/issues/801 .. _#799: https://github.com/librosa/librosa/issues/799 .. _#793: https://github.com/librosa/librosa/issues/793 .. _#791: https://github.com/librosa/librosa/issues/791 .. _#790: https://github.com/librosa/librosa/issues/790 .. _#787: https://github.com/librosa/librosa/issues/787 .. _#785: https://github.com/librosa/librosa/issues/785 .. _#783: https://github.com/librosa/librosa/issues/783 .. _#777: https://github.com/librosa/librosa/issues/777 .. _#769: https://github.com/librosa/librosa/issues/769 .. _#766: https://github.com/librosa/librosa/issues/766 .. _#760: https://github.com/librosa/librosa/issues/760 v0.6.2 ------ 2018-08-09 Bug fixes - `#730`_ Fixed cache support for `joblib>=0.12`. *Matt Vollrath* New features - `#735`_ Added `librosa.times_like` and `librosa.samples_like` to generate time and sample indices corresponding to an existing feature matrix or shape specification. *Steve Tjoa* - `#750`_, `#753`_ Added `librosa.tone` and `librosa.chirp` signal generators. *Ziyao Wei* Other changes - `#727`_ updated documentation for `librosa.get_duration`. *Zhen Wang* - `#731`_ fixed a typo in documentation for `librosa.fft_frequencies`. *Ziyao Wei* - `#734`_ expanded documentation for `librosa.feature.spectrall_rolloff`. *Ziyao Wei* - `#751`_ fixed example documentation for proper handling of phase in dB-scaling. *Vincent Lostanlen* - `#755`_ forward support and future-proofing for fancy indexing with `numpy>1.15`. *Brian McFee* .. _#730: https://github.com/librosa/librosa/pull/730 .. _#735: https://github.com/librosa/librosa/pull/735 .. _#750: https://github.com/librosa/librosa/pull/750 .. _#753: https://github.com/librosa/librosa/pull/753 .. _#727: https://github.com/librosa/librosa/pull/727 .. _#731: https://github.com/librosa/librosa/pull/731 .. _#734: https://github.com/librosa/librosa/pull/734 .. _#751: https://github.com/librosa/librosa/pull/751 .. _#755: https://github.com/librosa/librosa/pull/755 v0.6.1 ------ 2018-05-24 Bug fixes - `#677`_ `librosa.util.find_files` now correctly de-duplicates files on case-insensitive platforms. *Brian McFee* - `#713`_ `librosa.util.valid_intervals` now checks for non-negative durations. *Brian McFee, Dana Lee* - `#714`_ `librosa.util.match_intervals` can now explicitly fail when no matches are possible. *Brian McFee, Dana Lee* New features - `#679`_, `#708`_ `librosa.pcen`, per-channel energy normalization. *Vincent Lostanlen, Brian McFee* - `#682`_ added different DCT modes to `librosa.feature.mfcc`. *Brian McFee* - `#687`_ `librosa.display` functions now accept target axes. *Pius Friesch* - `#688`_ numba-accelerated `librosa.util.match_events`. *Dana Lee* - `#710`_ `librosa.sequence` module and Viterbi decoding for generative, discriminative, and multi-label hidden Markov models. *Brian McFee* - `#714`_ `librosa.util.match_intervals` now supports tie-breaking for disjoint query intervals. *Brian McFee* Other changes - `#677`_, `#705`_ added continuous integration testing for Windows. *Brian McFee*, *Ryuichi Yamamoto* - `#680`_ updated display module tests to support matplotlib 2.1. *Brian McFee* - `#684`_ corrected documentation for `librosa.stft` and `librosa.ifgram`. *Keunwoo Choi* - `#699`_, `#701`_ corrected documentation for `librosa.filters.semitone_filterbank` and `librosa.filters.mel_frequencies`. *Vincent Lostanlen* - `#704`_ eliminated unnecessary side-effects when importing `librosa.display`. *Brian McFee* - `#707`_ improved test coverage for dynamic time warping. *Brian McFee* - `#714`_ `librosa.util.match_intervals` matching logic has changed from raw intersection to Jaccard similarity. *Brian McFee* API Changes and compatibility - `#716`_ `librosa.dtw` has moved to `librosa.sequence.dtw`, and `librosa.fill_off_diagonal` has moved to `librosa.util.fill_off_diagonal`. *Brian McFee* .. _#716: https://github.com/librosa/librosa/pull/716 .. _#714: https://github.com/librosa/librosa/pull/714 .. _#713: https://github.com/librosa/librosa/pull/713 .. _#710: https://github.com/librosa/librosa/pull/710 .. _#708: https://github.com/librosa/librosa/pull/708 .. _#707: https://github.com/librosa/librosa/pull/707 .. _#705: https://github.com/librosa/librosa/pull/705 .. _#704: https://github.com/librosa/librosa/pull/704 .. _#701: https://github.com/librosa/librosa/pull/701 .. _#699: https://github.com/librosa/librosa/pull/699 .. _#688: https://github.com/librosa/librosa/pull/688 .. _#687: https://github.com/librosa/librosa/pull/687 .. _#684: https://github.com/librosa/librosa/pull/684 .. _#682: https://github.com/librosa/librosa/pull/682 .. _#680: https://github.com/librosa/librosa/pull/680 .. _#679: https://github.com/librosa/librosa/pull/679 .. _#677: https://github.com/librosa/librosa/pull/677 v0.6.0 ------ 2018-02-17 Bug fixes - `#663`_ fixed alignment errors in `librosa.feature.delta`. *Brian McFee* - `#646`_ `librosa.effects.trim` now correctly handles all-zeros signals. *Rimvydas Naktinis* - `#634`_ `librosa.stft` now conjugates the correct half of the spectrum. *Brian McFee* - `#630`_ fixed display decoration errors with `cqt_note` mode. *Brian McFee* - `#619`_ `librosa.effects.split` no longer returns out-of-bound sample indices. *Brian McFee* - `#616`_ Improved `librosa.util.valid_audio` to avoid integer type errors. *Brian McFee* - `#600`_ CQT basis functions are now correctly centered. *Brian McFee* - `#597`_ fixed frequency bin centering in `librosa.display.specshow`. *Brian McFee* - `#594`_ `librosa.dtw` fixed a bug which ignored weights when `step_sizes_sigma` did not match length. *Jackie Wu* - `#593`_ `librosa.stft` properly checks for valid input signals. *Erik Peterson* - `#587`_ `librosa.show_versions` now shows correct module names. *Ryuichi Yamamoto* New features - `#648`_ `librosa.feature.spectral_flatness`. *Keunwoo Choi* - `#633`_ `librosa.feature.tempogram` now supports multi-band analysis. *Brian McFee* - `#439`_ `librosa.iirt` implements the multi-rate filterbank from Chroma Toolbox. *Stefan Balke* - `#435`_ `librosa.icqt` inverse constant-Q transform (unstable). *Brian McFee* Other changes - `#674`_ Improved `write_wav` documentation with cross-references to `soundfile`. *Brian McFee* - `#671`_ Warn users when phase information is lost in dB conversion. *Carl Thome* - `#666`_ Expanded documentation for `librosa.load`'s resampling behavior. *Brian McFee* - `#656`_ Future-proofing numpy data type checks. *Carl Thome* - `#642`_ Updated unit tests for compatibility with matplotlib 2.1. *Brian McFee* - `#637`_ Improved documentation for advanced I/O. *Siddhartha Kumar* - `#636`_ `librosa.util.normalize` now preserves data type. *Brian McFee* - `#632`_ refined the validation requirements for `librosa.util.frame`. *Brian McFee* - `#628`_ all time/frequency conversion functions preserve input shape. *Brian McFee* - `#625`_ Numba is now a hard dependency. *Brian McFee* - `#622`_ `librosa.hz_to_midi` documentation corrections. *Carl Thome* - `#621`_ `dtw` is now symmetric with respect to input arguments. *Stefan Balke* - `#620`_ Updated requirements to prevent installation with (incompatible) sklearn 0.19.0. *Brian McFee* - `#609`_ Improved documentation for `librosa.segment.recurrence_matrix`. *Julia Wilkins* - `#598`_ Improved efficiency of `librosa.decompose.nn_filter`. *Brian McFee* - `#574`_ `dtw` now supports pre-computed distance matrices. *Curtis Hawthorne* API changes and compatibility - `#627`_ The following functions and features have been removed: - `real=` parameter in `cqt` - `logamplitude` (replaced by `amplitude_to_db`) - `beat.estimate_tempo` (replaced by `beat.tempo`) - `n_fft=` parameter to `feature.rmse` - `ref_power=` parameter to `power_to_db` - The following features have been deprecated, and will be removed in 0.7.0: - `trim=` parameter to `feature.delta` - `#616`_ `write_wav` no longer supports integer-typed waveforms. This is due to enforcing consistency with `librosa.util.valid_audio` checks elsewhere in the codebase. If you have existing code that requires integer-valued output, consider using `soundfile.write` instead. .. _#674: https://github.com/librosa/librosa/pull/674 .. _#671: https://github.com/librosa/librosa/pull/671 .. _#663: https://github.com/librosa/librosa/pull/663 .. _#646: https://github.com/librosa/librosa/pull/646 .. _#634: https://github.com/librosa/librosa/pull/634 .. _#630: https://github.com/librosa/librosa/pull/630 .. _#619: https://github.com/librosa/librosa/pull/619 .. _#616: https://github.com/librosa/librosa/pull/616 .. _#600: https://github.com/librosa/librosa/pull/600 .. _#597: https://github.com/librosa/librosa/pull/597 .. _#594: https://github.com/librosa/librosa/pull/594 .. _#593: https://github.com/librosa/librosa/pull/593 .. _#587: https://github.com/librosa/librosa/pull/587 .. _#648: https://github.com/librosa/librosa/pull/648 .. _#633: https://github.com/librosa/librosa/pull/633 .. _#439: https://github.com/librosa/librosa/pull/439 .. _#435: https://github.com/librosa/librosa/pull/435 .. _#666: https://github.com/librosa/librosa/pull/666 .. _#656: https://github.com/librosa/librosa/pull/656 .. _#642: https://github.com/librosa/librosa/pull/642 .. _#637: https://github.com/librosa/librosa/pull/637 .. _#636: https://github.com/librosa/librosa/pull/636 .. _#632: https://github.com/librosa/librosa/pull/632 .. _#628: https://github.com/librosa/librosa/pull/628 .. _#625: https://github.com/librosa/librosa/pull/625 .. _#622: https://github.com/librosa/librosa/pull/622 .. _#621: https://github.com/librosa/librosa/pull/621 .. _#620: https://github.com/librosa/librosa/pull/620 .. _#609: https://github.com/librosa/librosa/pull/609 .. _#598: https://github.com/librosa/librosa/pull/598 .. _#574: https://github.com/librosa/librosa/pull/574 .. _#627: https://github.com/librosa/librosa/pull/627 v0.5 ==== v0.5.1 ------ 2017-05-08 Bug fixes - `#555`_ added safety check for frequency bands in `librosa.feature.spectral_contrast`. *Brian McFee* - `#554`_ fix interactive display for `tonnetz` visualization. *Brian McFee* - `#553`_ fix bug in `librosa.feature.spectral_bandwidth`. *Brian McFee* - `#539`_ fix `librosa.feature.chroma_cens` to support scipy >=0.19. *Brian McFee* New features - `#565`_ `librosa.feature.stack_memory` now supports negative delay. *Brian McFee* - `#563`_ expose padding mode in `stft/ifgram/cqt`. *Brian McFee* - `#559`_ explicit length option for `librosa.istft`. *Brian McFee* - `#557`_ added `librosa.show_versions`. *Brian McFee* - `#551`_ add `norm=` option to `librosa.filters.mel`. *Dan Ellis* Other changes - `#569`_ `librosa.feature.rmse` now centers frames in the time-domain by default. *Brian McFee* - `#564`_ `librosa.display.specshow` now rasterizes images by default. *Brian McFee* - `#558`_ updated contributing documentation and issue templates. *Brian McFee* - `#556`_ updated tutorial for 0.5 API compatibility. *Brian McFee* - `#544`_ efficiency improvement in CQT. *Carl Thome* - `#523`_ support reading files with more than two channels. *Paul Brossier* .. _#523: https://github.com/librosa/librosa/pull/523 .. _#544: https://github.com/librosa/librosa/pull/544 .. _#556: https://github.com/librosa/librosa/pull/556 .. _#558: https://github.com/librosa/librosa/pull/558 .. _#564: https://github.com/librosa/librosa/pull/564 .. _#551: https://github.com/librosa/librosa/pull/551 .. _#557: https://github.com/librosa/librosa/pull/557 .. _#559: https://github.com/librosa/librosa/pull/559 .. _#563: https://github.com/librosa/librosa/pull/563 .. _#565: https://github.com/librosa/librosa/pull/565 .. _#539: https://github.com/librosa/librosa/pull/539 .. _#553: https://github.com/librosa/librosa/pull/553 .. _#554: https://github.com/librosa/librosa/pull/554 .. _#555: https://github.com/librosa/librosa/pull/555 .. _#569: https://github.com/librosa/librosa/pull/569 v0.5.0 ------ 2017-02-17 Bug fixes - `#371`_ preserve integer hop lengths in constant-Q transforms. *Brian McFee* - `#386`_ fixed a length check in `librosa.util.frame`. *Brian McFee* - `#416`_ `librosa.output.write_wav` only normalizes floating point, and normalization is disabled by default. *Brian McFee* - `#417`_ `librosa.cqt` output is now scaled continuously across octave boundaries. *Brian McFee, Eric Humphrey* - `#450`_ enhanced numerical stability for `librosa.util.softmask`. *Brian McFee* - `#467`_ correction to chroma documentation. *Seth Kranzler* - `#501`_ fixed a numpy 1.12 compatibility error in `librosa.pitch_tuning`. *Hojin Lee* New features - `#323`_ `librosa.dtw` dynamic time warping. *Stefan Balke* - `#404`_ `librosa.cache` now supports priority levels, analogous to logging levels. *Brian McFee* - `#405`_ `librosa.interp_harmonics` for estimating harmonics of time-frequency representations. *Brian McFee* - `#410`_ `librosa.beat.beat_track` and `librosa.onset.onset_detect` can return output in frames, samples, or time units. *Brian McFee* - `#413`_ full support for scipy-style window specifications. *Brian McFee* - `#427`_ `librosa.salience` for computing spectrogram salience using harmonic peaks. *Rachel Bittner* - `#428`_ `librosa.effects.trim` and `librosa.effects.split` for trimming and splitting waveforms. *Brian McFee* - `#464`_ `librosa.amplitude_to_db`, `db_to_amplitude`, `power_to_db`, and `db_to_power` for amplitude conversions. This deprecates `logamplitude`. *Brian McFee* - `#471`_ `librosa.util.normalize` now supports `threshold` and `fill_value` arguments. *Brian McFee* - `#472`_ `librosa.feature.melspectrogram` now supports `power` argument. *Keunwoo Choi* - `#473`_ `librosa.onset.onset_backtrack` for backtracking onset events to previous local minima of energy. *Brian McFee* - `#479`_ `librosa.beat.tempo` replaces `librosa.beat.estimate_tempo`, supports time-varying estimation. *Brian McFee* Other changes - `#352`_ removed `seaborn` integration. *Brian McFee* - `#368`_ rewrite of the `librosa.display` submodule. All plots are now in natural coordinates. *Brian McFee* - `#402`_ `librosa.display` submodule is not automatically imported. *Brian McFee* - `#403`_ `librosa.decompose.hpss` now returns soft masks. *Brian McFee* - `#407`_ `librosa.feature.rmse` can now compute directly in the time domain. *Carl Thome* - `#432`_ `librosa.feature.rmse` renames `n_fft` to `frame_length`. *Brian McFee* - `#446`_ `librosa.cqt` now disables tuning estimation by default. *Brian McFee* - `#452`_ `librosa.filters.__float_window` now always uses integer length windows. *Brian McFee* - `#459`_ `librosa.load` now supports `res_type` argument for resampling. *CJ Carr* - `#482`_ `librosa.filters.mel` now warns if parameters will generate empty filter channels. *Brian McFee* - `#480`_ expanded documentation for advanced IO use-cases. *Fabian Robert-Stoeter* API changes and compatibility - The following functions have permanently moved: - `core.peak_peak` to `util.peak_pick` - `core.localmax` to `util.localmax` - `feature.sync` to `util.sync` - The following functions, classes, and constants have been removed: - `core.ifptrack` - `feature.chromagram` - `feature.logfsgram` - `filters.logfrequency` - `output.frames_csv` - `segment.structure_Feature` - `display.time_ticks` - `util.FeatureExtractor` - `util.buf_to_int` - `util.SMALL_FLOAT` - The following parameters have been removed: - `librosa.cqt`: `resolution` - `librosa.cqt`: `aggregate` - `feature.chroma_cqt`: `mode` - `onset_strength`: `centering` - Seaborn integration has been removed, and the `display` submodule now requires matplotlib >= 1.5. - The `use_sns` argument has been removed from `display.cmap` - `magma` is now the default sequential colormap. - The `librosa.display` module has been rewritten. - `librosa.display.specshow` now plots using `pcolormesh`, and supports non-uniform time and frequency axes. - All plots can be rendered in natural coordinates (e.g., time or Hz) - Interactive plotting is now supported via ticker and formatter objects - `librosa.decompose.hpss` with `mask=True` now returns soft masks, rather than binary masks. - `librosa.filters.get_window` wraps `scipy.signal.get_window`, and handles generic callables as well pre-registered window functions. All windowed analyses (e.g., `stft`, `cqt`, or `tempogram`) now support the full range of window functions and parameteric windows via tuple parameters, e.g., `window=('kaiser', 4.0)`. - `stft` windows are now explicitly asymmetric by default, which breaks backwards compatibility with the 0.4 series. - `cqt` now returns properly scaled outputs that are continuous across octave boundaries. This breaks backwards compatibility with the 0.4 series. - `cqt` now uses `tuning=0.0` by default, rather than estimating the tuning from the signal. Tuning estimation is still supported, and enabled by default for chroma analysis (`librosa.feature.chroma_cqt`). - `logamplitude` is deprecated in favor of `amplitude_to_db` or `power_to_db`. The `ref_power` parameter has been renamed to `ref`. .. _#501: https://github.com/librosa/librosa/pull/501 .. _#480: https://github.com/librosa/librosa/pull/480 .. _#467: https://github.com/librosa/librosa/pull/467 .. _#450: https://github.com/librosa/librosa/pull/450 .. _#417: https://github.com/librosa/librosa/pull/417 .. _#416: https://github.com/librosa/librosa/pull/416 .. _#386: https://github.com/librosa/librosa/pull/386 .. _#371: https://github.com/librosa/librosa/pull/371 .. _#479: https://github.com/librosa/librosa/pull/479 .. _#473: https://github.com/librosa/librosa/pull/473 .. _#472: https://github.com/librosa/librosa/pull/472 .. _#471: https://github.com/librosa/librosa/pull/471 .. _#464: https://github.com/librosa/librosa/pull/464 .. _#428: https://github.com/librosa/librosa/pull/428 .. _#427: https://github.com/librosa/librosa/pull/427 .. _#413: https://github.com/librosa/librosa/pull/413 .. _#410: https://github.com/librosa/librosa/pull/410 .. _#405: https://github.com/librosa/librosa/pull/405 .. _#404: https://github.com/librosa/librosa/pull/404 .. _#323: https://github.com/librosa/librosa/pull/323 .. _#482: https://github.com/librosa/librosa/pull/482 .. _#459: https://github.com/librosa/librosa/pull/459 .. _#452: https://github.com/librosa/librosa/pull/452 .. _#446: https://github.com/librosa/librosa/pull/446 .. _#432: https://github.com/librosa/librosa/pull/432 .. _#407: https://github.com/librosa/librosa/pull/407 .. _#403: https://github.com/librosa/librosa/pull/403 .. _#402: https://github.com/librosa/librosa/pull/402 .. _#368: https://github.com/librosa/librosa/pull/368 .. _#352: https://github.com/librosa/librosa/pull/352 v0.4 ==== v0.4.3 ------ 2016-05-17 Bug fixes - `#315`_ fixed a positioning error in `librosa.display.specshow` with logarithmic axes. *Brian McFee* - `#332`_ `librosa.cqt` now throws an exception if the signal is too short for analysis. *Brian McFee* - `#341`_ `librosa.hybrid_cqt` properly matches the scale of `librosa.cqt`. *Brian McFee* - `#348`_ `librosa.cqt` fixed a bug introduced in v0.4.2. *Brian McFee* - `#354`_ Fixed a minor off-by-one error in `librosa.beat.estimate_tempo`. *Brian McFee* - `#357`_ improved numerical stability of `librosa.decompose.hpss`. *Brian McFee* New features - `#312`_ `librosa.segment.recurrence_matrix` can now construct sparse self-similarity matrices. *Brian McFee* - `#337`_ `librosa.segment.recurrence_matrix` can now produce weighted affinities and distances. *Brian McFee* - `#311`_ `librosa.decompose.nl_filter` implements several self-similarity based filtering operations including non-local means. *Brian McFee* - `#320`_ `librosa.feature.chroma_cens` implements chroma energy normalized statistics (CENS) features. *Stefan Balke* - `#354`_ `librosa.tempo_frequencies` computes tempo (BPM) frequencies for autocorrelation and tempogram features. *Brian McFee* - `#355`_ `librosa.decompose.hpss` now supports harmonic-percussive-residual separation. *CJ Carr, Brian McFee* - `#357`_ `librosa.util.softmask` computes numerically stable soft masks. *Brian McFee* Other changes - `librosa.cqt`, `librosa.hybrid_cqt` parameter `aggregate` is now deprecated. - Resampling is now handled by the `resampy` library - `librosa.get_duration` can now operate directly on filenames as well as audio buffers and feature matrices. - `librosa.decompose.hpss` no longer supports `power=0`. .. _#315: https://github.com/librosa/librosa/pull/315 .. _#332: https://github.com/librosa/librosa/pull/332 .. _#341: https://github.com/librosa/librosa/pull/341 .. _#348: https://github.com/librosa/librosa/pull/348 .. _#312: https://github.com/librosa/librosa/pull/312 .. _#337: https://github.com/librosa/librosa/pull/337 .. _#311: https://github.com/librosa/librosa/pull/311 .. _#320: https://github.com/librosa/librosa/pull/320 .. _#354: https://github.com/librosa/librosa/pull/354 .. _#355: https://github.com/librosa/librosa/pull/355 .. _#357: https://github.com/librosa/librosa/pull/357 v0.4.2 ------ 2016-02-20 Bug fixes - Support for matplotlib 1.5 color properties in the `librosa.display` module - `#308`_ Fixed a per-octave scaling error in `librosa.cqt`. *Brian McFee* New features - `#279`_ `librosa.cqt` now provides complex-valued output with argument `real=False`. This will become the default behavior in subsequent releases. - `#288`_ `librosa.resample` now supports multi-channel inputs. *Brian McFee* - `#295`_ `librosa.display.frequency_ticks`: like `time_ticks`. Ticks can now dynamically adapt to scale (mHz, Hz, KHz, MHz, GHz) and use automatic precision formatting (`%g`). *Brian McFee* Other changes - `#277`_ improved documentation for OSX. *Stefan Balke* - `#294`_ deprecated the `FeatureExtractor` object. *Brian McFee* - `#300`_ added dependency version requirements to install script. *Brian McFee* - `#302`_, `#279`_ renamed the following parameters - `librosa.display.time_ticks`: `fmt` is now `time_fmt` - `librosa.feature.chroma_cqt`: `mode` is now `cqt_mode` - `librosa.cqt`, `hybrid_cqt`, `pseudo_cqt`, `librosa.filters.constant_q`: `resolution` is now `filter_scale` - `#308`_ `librosa.cqt` default `filter_scale` parameter is now 1 instead of 2. .. _#277: https://github.com/librosa/librosa/pull/277 .. _#279: https://github.com/librosa/librosa/pull/279 .. _#288: https://github.com/librosa/librosa/pull/288 .. _#294: https://github.com/librosa/librosa/pull/294 .. _#295: https://github.com/librosa/librosa/pull/295 .. _#300: https://github.com/librosa/librosa/pull/300 .. _#302: https://github.com/librosa/librosa/pull/302 .. _#308: https://github.com/librosa/librosa/pull/308 v0.4.1 ------ 2015-10-17 Bug fixes - Improved safety check in CQT for invalid hop lengths - Fixed division by zero bug in `librosa.pitch.pip_track` - Fixed integer-type error in `librosa.util.pad_center` on numpy v1.10 - Fixed a context scoping error in `librosa.load` with some audioread backends - `librosa.autocorrelate` now persists type for complex input New features - `librosa.clicks` sonifies timed events such as beats or onsets - `librosa.onset.onset_strength_multi` computes onset strength within multiple sub-bands - `librosa.feature.tempogram` computes localized onset strength autocorrelation - `librosa.display.specshow` now supports `*_axis='tempo'` for annotating tempo-scaled data - `librosa.fmt` implements the Fast Mellin Transform Other changes - Rewrote `librosa.display.waveplot` for improved efficiency - `librosa.decompose.deompose()` now supports pre-trained transformation objects - Nullified side-effects of optional seaborn dependency - Moved `feature.sync` to `librosa.util.sync` and expanded its functionality - `librosa.onset.onset_strength` and `onset_strength_multi` support superflux-style lag and max-filtering - `librosa.autocorrelate` can now operate along any axis of multi-dimensional input - the `librosa.segment` module functions now support arbitrary target axis - Added proper window normalization to `librosa.istft` for better reconstruction (`PR #235 `_). - Standardized `n_fft=2048` for `piptrack`, `ifptrack` (deprecated), and `logfsgram` (deprecated) - `onset_strength` parameter `'centering'` has been deprecated and renamed to `'center'` - `onset_strength` always trims to match the input spectrogram duration - added tests for `piptrack` - added test support for Python 3.5 v0.4.0 ------ 2015-07-08 Bug fixes - Fixed alignment errors with `offset` and `duration` in `load()` - Fixed an edge-padding issue with `decompose.hpss()` which resulted in percussive noise leaking into the harmonic component. - Fixed stability issues with `ifgram()`, added options to suppress negative frequencies. - Fixed scaling and padding errors in `feature.delta()` - Fixed some errors in `librosa.note_to_hz()` string parsing - Added robust range detection for `librosa.display.cmap` - Fixed tick placement in `librosa.display.specshow` - Fixed a low-frequency filter alignment error in `librosa.cqt` - Added aliasing checks for `librosa.cqt` filterbanks - Fixed corner cases in `peak_pick` - Fixed bugs in `find_files()` with negative slicing - Fixed tuning estimation errors - Fixed octave numbering in to conform to scientific pitch notation New features - python 3 compatibility - Deprecation and moved-function warnings - added `norm=None` option to `util.normalize()` - `segment.recurrence_to_lag`, `lag_to_recurrence` - `core.hybrid_cqt()` and `core.pseudo_cqt()` - `segment.timelag_filter` - Efficiency enhancements for `cqt` - Major rewrite and reformatting of documentation - Improvements to `display.specshow`: - added the `lag` axis format - added the `tonnetz` axis format - allow any combination of axis formats - `effects.remix()` - Added new time and frequency converters: - `note_to_hz()`, `hz_to_note()` - `frames_to_samples()`, `samples_to_frames()` - `time_to_samples()`, `samples_to_time()` - `core.zero_crossings` - `util.match_events()` - `segment.subsegment()` for segmentation refinement - Functional examples in almost all docstrings - improved numerical stability in `normalize()` - audio validation checks - `to_mono()` - `librosa.cache` for storing pre-computed features - Stereo output support in `write_wav` - Added new feature extraction functions: - `feature.spectral_contrast` - `feature.spectral_bandwidth` - `feature.spectral_centroid` - `feature.spectral_rolloff` - `feature.poly_features` - `feature.rmse` - `feature.zero_crossing_rate` - `feature.tonnetz` - Added `display.waveplot` Other changes - Internal refactoring and restructuring of submodules - Removed the `chord` module - input validation and better exception reporting for most functions - Changed the default colormaps in `display` - Changed default parameters in onset detection, beat tracking - Changed default parameters in `cqt` - `filters.constant_q` now returns filter lengths - Chroma now starts at `C` by default, instead of `A` - `pad_center` supports multi-dimensional input and `axis` parameter - switched from `np.fft` to `scipy.fftpack` for FFT operations - changed all librosa-generated exception to a new class librosa.ParameterError Deprecated functions - `util.buf_to_int` - `output.frames_csv` - `segment.structure_feature` - `filters.logfrequency` - `feature.logfsgram` v0.3 ==== v0.3.1 ------ 2015-02-18 Bug fixes - Fixed bug #117: `librosa.segment.agglomerative` now returns a numpy.ndarray instead of a list - Fixed bug #115: off-by-one error in `librosa.load` with fixed duration - Fixed numerical underflow errors in `librosa.decompose.hpss` - Fixed bug #104: `librosa.decompose.hpss` failed with silent, complex-valued input - Fixed bug #103: `librosa.feature.estimate_tuning` fails when no bins exceed the threshold Features - New function `librosa.get_duration()` computes the duration of an audio signal or spectrogram-like input matrix - `librosa.util.pad_center` now accepts multi-dimensional input Other changes - Adopted the ISC license - Python 3 compatibility via futurize - Fixed issue #102: segment.agglomerative no longer depends on the deprecated Ward module of sklearn; it now depends on the newer Agglomerative module. - Issue #108: set character encoding on all source files - Added dtype persistence for resample, stft, istft, and effects functions v0.3.0 ------ 2014-06-30 Bug fixes - Fixed numpy array indices to force integer values - `librosa.util.frame` now warns if the input data is non-contiguous - Fixed a formatting error in `librosa.display.time_ticks()` - Added a warning if `scikits.samplerate` is not detected Features - New module `librosa.chord` for training chord recognition models - Parabolic interpolation piptracking `librosa.feature.piptrack()` - `librosa.localmax()` now supports multi-dimensional slicing - New example scripts - Improved documentation - Added the `librosa.util.FeatureExtractor` class, which allows librosa functions to act as feature extraction stages in `sklearn` - New module `librosa.effects` for time-domain audio processing - Added demo notebooks for the `librosa.effects` and `librosa.util.FeatureExtractor` - Added a full-track audio example, `librosa.util.example_audio_file()` - Added peak-frequency sorting of basis elements in `librosa.decompose.decompose()` Other changes - Spectrogram frames are now centered, rather than left-aligned. This removes the need for window correction in `librosa.frames_to_time()` - Accelerated constant-Q transform `librosa.cqt()` - PEP8 compliance - Removed normalization from `librosa.feature.logfsgram()` - Efficiency improvements by ensuring memory contiguity - `librosa.logamplitude()` now supports functional reference power, in addition to scalar values - Improved `librosa.feature.delta()` - Additional padding options to `librosa.feature.stack_memory()` - `librosa.cqt` and `librosa.feature.logfsgram` now use the same parameter formats `(fmin, n_bins, bins_per_octave)`. - Updated demo notebook(s) to IPython 2.0 - Moved `perceptual_weighting()` from `librosa.feature` into `librosa` - Moved `stack_memory()` from `librosa.segment` into `librosa.feature` - Standardized `librosa.output.annotation` input format to match `mir_eval` - Standardized variable names (e.g., `onset_envelope`). v0.2 ==== v0.2.1 ------ 2014-01-21 Bug fixes - fixed an off-by-one error in `librosa.onset.onset_strength()` - fixed a sign-flip error in `librosa.output.write_wav()` - removed all mutable object default parameters Features - added option `centering` to `librosa.onset.onset_strength()` to resolve frame-centering issues with sliding window STFT - added frame-center correction to `librosa.frames_to_time()` and `librosa.time_to_frames()` - added `librosa.util.pad_center()` - added `librosa.output.annotation()` - added `librosa.output.times_csv()` - accelerated `librosa.stft()` and `ifgram()` - added `librosa.util.frame` for in-place signal framing - `librosa.beat.beat_track` now supports user-supplied tempo - added `librosa.util.normalize()` - added `librosa.util.find_files()` - added `librosa.util.axis_sort()` - new module: `librosa.util()` - `librosa.filters.constant_q` now support padding - added boolean input support for `librosa.display.cmap()` - speedup in `librosa.cqt()` Other changes - optimized default parameters for `librosa.onset.onset_detect` - set `librosa.filters.mel` parameter `n_mels=128` by default - `librosa.feature.chromagram()` and `logfsgram()` now use power instead of energy - `librosa.display.specshow()` with `y_axis='chroma'` now labels as `pitch class` - set `librosa.cqt` parameter `resolution=2` by default - set `librosa.feature.chromagram` parameter `octwidth=2` by default v0.2.0 ------ 2013-12-14 Bug fixes - fixed default `librosa.stft, istft, ifgram` to match specification - fixed a float->int bug in peak\_pick - better memory efficiency - `librosa.segment.recurrence_matrix` corrects for width suppression - fixed a divide-by-0 error in the beat tracker - fixed a bug in tempo estimation with short windows - `librosa.feature.sync` now supports 1d arrays - fixed a bug in beat trimming - fixed a bug in `librosa.stft` when calculating window size - fixed `librosa.resample` to support stereo signals Features - added filters option to cqt - added window function support to istft - added an IPython notebook demo - added `librosa.features.delta` for computing temporal difference features - new `examples` scripts: tuning, hpss - added optional trimming to `librosa.segment.stack_memory` - `librosa.onset.onset_strength` now takes generic spectrogram function `feature` - compute reference power directly in `librosa.logamplitude` - color-blind-friendly default color maps in `librosa.display.cmap` - `librosa.onset_strength` now accepts an aggregator - added `librosa.feature.perceptual_weighting` - added tuning estimation to `librosa.feature.chromagram` - added `librosa.A_weighting` - vectorized frequency converters - added `librosa.cqt_frequencies` to get CQT frequencies - `librosa.cqt` basic constant-Q transform implementation - `librosa.filters.cq_to_chroma` to convert log-frequency to chroma - added `librosa.fft_frequencies` - `librosa.decompose.hpss` can now return masking matrices - added reversal for `librosa.segment.structure_feature` - added `librosa.time_to_frames` - added cent notation to `librosa.midi_to_note` - added time-series or spectrogram input options to `chromagram`, `logfsgram`, `melspectrogram`, and `mfcc` - new module: `librosa.display` - `librosa.output.segment_csv` => `librosa.output.frames_csv` - migrated frequency converters to `librosa` - new module: `librosa.filters` - `librosa.decompose.hpss` now supports complex-valued STFT matrices - `librosa.decompose.decompose()` supports `sklearn` decomposition objects - added `librosa.phase_vocoder` - new module: `librosa.onset`; migrated onset strength from `librosa.beat` - added `librosa.pick_peaks` - `librosa.load()` supports offset and duration parameters - `librosa.magphase()` to separate magnitude and phase from a complex matrix - new module: `librosa.segment` Other changes - `onset_estimate_bpm => estimate_tempo` - removed `n_fft` from `librosa.istft()` - `librosa.mel_frequencies` returns `n_mels` values by default - changed default `librosa.decompose.hpss` window to 31 - disabled onset de-trending by default in `librosa.onset.onset_strength` - added complex-value warning to `librosa.display.specshow` - broke compatibility with `ifgram.m`; `librosa.ifgram` now matches `stft` - changed default beat tracker settings - migrated `hpss` into `librosa.decompose` - changed default `librosa.decompose.hpss` power parameter to `2.0` - `librosa.load()` now returns single-precision by default - standardized `n_fft=2048`, `hop_length=512` for most functions - refactored tempo estimator v0.1 ==== Initial public release.