Scikit-maad

**Release Notes**

We are pleased to announce the latest release with several important fixes and documentation improvements to ensure compatibility with the latest versions of SciPy and NumPy.

**Bug Fixes**
[FIX]: Updated to address the deprecation of the scipy.ndimage.morphology namespace. The grey_opening function should now be imported from the scipy.ndimage namespace. (Commit: 768e831)
[FIX]: Resolved an import error when using gaussian from scipy.signal in SciPy versions >= 1.13.0. Please use scipy.signal.windows.gaussian instead. (Commit: e434362)
[FIX]: Replaced the nyq parameter with fs in scipy.signal.firwin to maintain compliance with SciPy versions > 12.0.0. (Commit: 0f9e1d5)
[FIX]: Ensured compatibility with NumPy v2.0.0. (Commit: f8ecccd)
[FIX]: Added an internal function _quantile_is_valid to address the removal of this functionality in NumPy v2.0.0. (Commit: 9783bb7, e0d336b)

**Documentation**
[DOC]: Added a link to Google Colab in the ADI and ADI functions documentation for easier access. (Commit: 9bf1294)
[DOC]: Added a License badge to the documentation. (Commit: c9f9e9b)
[DOC]: Made minor improvements to the documentation webpage. (Commit: caa8b7d)
[DOC]: Updated the version number in the documentation. (Commit: b8a0d52)

Thank you to all contributors for helping us maintain the quality and compatibility of our codebase. We encourage users to upgrade to this latest version to benefit from these updates.

**Full Changelog**: https://github.com/scikit-maad/scikit-maad/compare/v1.4.2...v1.4.3

**Fixes:**
* Improved multiprocessing context in example.
* Corrected default plot values.
* Addressed column name issues in date_parser.
* Enhanced plot axis display.
* General fixes in plotting and template matching.
* Replaced 'selem' with 'footprint' for compatibility with scikit-image.
* Improved input validation for metadata retrieval.

**Enhancements:**
* Added metadata reading for any wav files.
* Parallelized graphical_soundscapes function.
* Enhanced verbose task execution display.
* Added local maxima detection in spectrograms.

Documentation:
* Updated examples for new date_parser.
* Refreshed version 1.4.2 documentation.
* Added new examples and images to the gallery.

**Development:**
* Universal date_parser modification.
* Introduced heatmap functions for better visualization.
* Added tests for template matching and spectrogram peaks.

We encourage users to upgrade to this latest version to take advantage of these improvements and enhancements.

We're excited to announce the release of a new minor version of our package, incorporating several enhancements, bug fixes, and documentation improvements. Here's a summary of the updates:

*Enhancements:*
- Added the possibility to read metadata from any WAV file, similar to the functionality in sox -i.
- Improved verbose display of execution of tasks.
- Added functionality to parallelize graphical soundscapes.
- Introduced a new function to find local maxima in spectrograms.
- Enhanced the verbose display of task execution.
- Added a new feature to compute graphical soundscapes.
- Included a new example for graphical soundscapes.

*Bug Fixes:*
- Fixed NaN issues for ACTmean and TFSD.
- Addressed a minor bug for plotting graphical soundscapes.
- Ensured the time column is formatted as a string.
- Resolved an issue with the time column.
- Fixed a bug when saving Audacity annotations with labels.
- Improved input validation and file search for the get_metadata_dir function.
- Fixed a bug related to plotting and removed unnecessary plt.show() calls.
- Replaced selem with footprint in scikit-image.
- Made minor adjustments to ensure generalization in the usage of the graphical_soundscape function.
- Corrected an issue with template matching function.

*Documentation:*
- Updated README.md.
- Edited docstrings for proper display with Sphinx.
- Fixed examples to work with macOS.
- Added images for the example gallery in documentation.

Additionally, various tests were adjusted and added to ensure the reliability and functionality of the package.

This new release adheres to the guidelines for a more robust, stable, and responsive package, aiming to enhance performance and enable more reproducible scientific research.

We now integrate a continuous integration and continuous development process to ensure that scikit-maad is supported on different operating systems (UNIX, Windows and MacOSX) with different versions of Python.

With this update, we can easily track deprecated functions and anticipate future releases of the required packages.

Additionally, we have addressed all the detected bugs and made necessary fixes.

In particular, we have added the following functionalities:

**New features**
Template matching: new spectrogram template matching function to easily find stereotyped signals in audio recordings.
Acoustic features: new functions to compute robust spectral (peak frequency, spectral quantiles, bandwidth) and temporal features (duration, temporal_quantile) on audio signals.

**Documentation**
The updated documentation with new functions is still here: [scikit-maad.github.io](https://scikit-maad.github.io/)

**Fixed bugs**
Ensured swift integration with latest versions of scipy, numpy, pandas and scikit-image.

**Enhancements**
We worked to meet all of the standards listed on [pyOpenSci](https://www.pyopensci.org/software-peer-review/how-to/author-guide.html)

- Advances in packaging best practices to ensure continuous integration and continuous development
- Shifted to project.toml for packaging
- CONTRIBUTING.md file: helps newcomers understand the project's contribution process and encourages active participation.
- Github workflows for testing on multiple platforms and multiple versions of Python
- Templates for reporting issues on GitHub
- Community guidelines including contribution guidelines in the CONTRIBUTING.md file

**Test**
We improved the test coverage by adding tests for most of the main functions: spectrogram, alpha_indices, shape_features, and more. We used both, pytest with specific tests and doctest that tests the examples provided for each function in the documentation.

**Note**
Be aware that the v1.4.0 may be not compatible with older versions of Python (<=3.7).

**Contributors**
We would like to extend our sincere gratitude to all the contributors who have taken the time to submit issues and provide advice. Your valuable input and feedback have been instrumental in improving our software and ensuring its continued development. Thank you for your support and for helping us create a better experience for all users. In particular, we would like to thank:

- [saguileran](https://github.com/saguileran) [Sebastian Aguilera Novoa]
- [Bengt](https://github.com/Bengt) [Bengt Lüer]
- [NickleDave](https://github.com/NickleDave) [[David Nicholson](https://github.com/NickleDave)]
- [thealejandroperilla](https://github.com/thealejandroperilla) [Gabriel Perilla]
- [pierromond](https://github.com/pierromond) [Pierre Aumond]
- [modantailleur](https://github.com/modantailleur)

This release is a minor update of the release [v1.3.6](https://github.com/scikit-maad/scikit-maad/releases/tag/1.3.6).

Update of the Xeno-Canto functions to fix the problem when a query contains the keyword "type".
The updated function xc_query now is able to deal with the new API of Xeno-Canto.

This release is a minor update of the release [v1.3.6](https://github.com/scikit-maad/scikit-maad/releases/tag/1.3.6).

This release fix minor problems in xeno-canto functions and update setup.py in order to avoid warning or error when installing scikit-maad on Google Colab.