Librosa

------
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*

====

------
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

------
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

------
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

====