Opensoundscape

**Full Changelog**: https://github.com/kitzeslab/opensoundscape/compare/v0.9.1...v0.10.0

This release includes bug fixes and small changes to OpenSoundscape, and moves two modules previously in opensoundscape to separate packages:

* `taxa` module is now a separate [github repo ](https://github.com/kitzeslab/name_conversions)
* `aru` module has been removed and is now a separate [github repo](https://github.com/kitzeslab/aru_metadata_parser) and package available on [PyPI](https://pypi.org/project/aru-metadata-parser/0.1.0/): `pip install aru_metadata_parser` (and is a dependency of OpenSoundscape)
* the `localization` module has been improved with bug fixes, including corrected cross-correlation algorithm for `gcc`
* several issues and bugs have been resolved (see below for details)

What's Changed
* Increase tolerance of Audio too short warning by louisfh in https://github.com/kitzeslab/opensoundscape/pull/728
* for metadata values, replace empty string with space by sammlapp in https://github.com/kitzeslab/opensoundscape/pull/713
* fix failing tests for Python 3.10: avoid deprecated pd.Series.append by sammlapp in https://github.com/kitzeslab/opensoundscape/pull/739
* resolve 727 AudioSample repr error by sammlapp in https://github.com/kitzeslab/opensoundscape/pull/740
* change import convention for scipy by sammlapp in https://github.com/kitzeslab/opensoundscape/pull/738
* documentation updates by sammlapp in https://github.com/kitzeslab/opensoundscape/pull/741
* resolve issues for BoxedAnnotations by sammlapp in https://github.com/kitzeslab/opensoundscape/pull/742
* add check for artist field to prevent KeyError by syunkova in https://github.com/kitzeslab/opensoundscape/pull/748
* metadata parsing resolve 745 by sammlapp in https://github.com/kitzeslab/opensoundscape/pull/750
* don't fail in predict() with empty sample list by sammlapp in https://github.com/kitzeslab/opensoundscape/pull/755
* remove `taxa` module and `resources` by sammlapp in https://github.com/kitzeslab/opensoundscape/pull/759
* Issue 756 aru package by sammlapp in https://github.com/kitzeslab/opensoundscape/pull/758
* Issue 723 gcc tdoa by louisfh in https://github.com/kitzeslab/opensoundscape/pull/724
* refactor audio.extend by sammlapp in https://github.com/kitzeslab/opensoundscape/pull/763
* version 0.9.1 by sammlapp in https://github.com/kitzeslab/opensoundscape/pull/760


**Full Changelog**: https://github.com/kitzeslab/opensoundscape/compare/v0.9.0...v0.9.1

This release represents a major update to the OpenSoundscape library, including new features, bug fixes, and some breaking changes.

New feature highlights

* Localization of sounds from time-synchronized recorders with the `localization` module
* Class activation mapping in deep learning models with several flavors of GradCAM and guided backpropagation using the `cam` module or `CNN.generate_cams()`
* BoxedAnnotation class now support loading, saving, and manipulating labels (and Raven formatted txt files) for many audio files at once, instead of just one audio file
* New methods and properties for the Audio class, including `.show_widget()`, `.dBFS`, `.rms`, `.from_url()`, `.normalize()`, and `.apply_gain()`
* Methods for loading and saving CNN class across OpenSoundscape versions (`.save_torch_dict()` and `.from_torch_dict()`)

What's Changed
* add missing mock-imports by sammlapp in https://github.com/kitzeslab/opensoundscape/pull/650
* merge hotfix from master to develop by sammlapp in https://github.com/kitzeslab/opensoundscape/pull/651
* 578: tutorial download links by syunkova in https://github.com/kitzeslab/opensoundscape/pull/658
* Implement wandb.watch in CNN.train() by sammlapp in https://github.com/kitzeslab/opensoundscape/pull/675
* Class activation maps by sammlapp in https://github.com/kitzeslab/opensoundscape/pull/676
* change default resample type to 'soxr_hq' by sammlapp in https://github.com/kitzeslab/opensoundscape/pull/682
* implement save_torch_dict and load_torch_dict by sammlapp in https://github.com/kitzeslab/opensoundscape/pull/683
* Refactor modules by sammlapp in https://github.com/kitzeslab/opensoundscape/pull/686
* warn usr if load_model loads model of old version resolves 661 by sammlapp in https://github.com/kitzeslab/opensoundscape/pull/689
* Issue 679 retain metadata when using Audio methods by sammlapp in https://github.com/kitzeslab/opensoundscape/pull/690
* Resolves 579 boxed annotations by sammlapp in https://github.com/kitzeslab/opensoundscape/pull/688
* Audio class display and from_url by sammlapp in https://github.com/kitzeslab/opensoundscape/pull/691
* add gcc (generalized cross correlation) function and tests by louisfh in https://github.com/kitzeslab/opensoundscape/pull/693
* Feat refact localizer by louisfh in https://github.com/kitzeslab/opensoundscape/pull/697
* v0.9.0 by sammlapp in https://github.com/kitzeslab/opensoundscape/pull/702


**Full Changelog**: https://github.com/kitzeslab/opensoundscape/compare/v0.8.0...v0.9.0

**Full Changelog**: https://github.com/kitzeslab/opensoundscape/compare/v0.7.1...v0.8.0

This release updates dependencies, fixes various bugs, updates documentation, and adds a few small features.

Notable feature additions
- Parsing metadata from AudioMoth firmware through 1.8.1 and from SongMeter Micros is now supported. The Audio.from_file method will automatically parse metadata and store it in the object's `.metadata` dictionary unless you specify `metadata=False`
- Audio.save() now saves metadata, so that you can retain or update .wav file metadata when using OpenSoundscape
- ResNet networks with pre-trained weights and a number of input channels other than 3 now average conv1 weights over the input channels

Dependencies
Python 3.9 no longer causes installation issues. This release updates OpenSoundscape's package dependencies in a way that allows Python 3.9 environments. Users with Apple Silicon chips to install OpenSoundscape hassle-free in a Python 3.9 environment (but may experience issues with Python 3.7 and 3.8).

If you encounter problems with installation, regardless of your platform, please open an issue.

What's Changed: a list of merged Pull Requests
* add scaling option to the Spectrogram class and MelSpectrogram class by zoharrpg in https://github.com/kitzeslab/opensoundscape/pull/505
* Annotation docs hotfix by rhine3 in https://github.com/kitzeslab/opensoundscape/pull/517
* Minor updates to annotation tutorial by rhine3 in https://github.com/kitzeslab/opensoundscape/pull/516
* Fixes Poetry Installer issue during CI by louisfh in https://github.com/kitzeslab/opensoundscape/pull/535
* change filepath of poetry by louisfh in https://github.com/kitzeslab/opensoundscape/pull/536
* Removed redundant empty load method from base model modules by jatinkhilnani in https://github.com/kitzeslab/opensoundscape/pull/537
* Update black version by sammlapp in https://github.com/kitzeslab/opensoundscape/pull/539
* Issue 472 spectrogram methods by louisfh in https://github.com/kitzeslab/opensoundscape/pull/534
* Resolved - Resample with replacement 479 by jatinkhilnani in https://github.com/kitzeslab/opensoundscape/pull/497
* resolve 520 skip loading metadata by sammlapp in https://github.com/kitzeslab/opensoundscape/pull/541
* resolve 513 Spectrogram loses properties on out-of-place method by sammlapp in https://github.com/kitzeslab/opensoundscape/pull/542
* Fix loading of ResampleLoss CNN models by sammlapp in https://github.com/kitzeslab/opensoundscape/pull/544
* Resolve Issue 507 metrics by sammlapp in https://github.com/kitzeslab/opensoundscape/pull/540
* update pre-commit black version to 22.8.0 by sammlapp in https://github.com/kitzeslab/opensoundscape/pull/551
* Issue 531 final clip by jatinkhilnani in https://github.com/kitzeslab/opensoundscape/pull/550
* Issue 496 tests for cnn arch by louisfh in https://github.com/kitzeslab/opensoundscape/pull/545
* different input channels should retain pre-trained weights by sammlapp in https://github.com/kitzeslab/opensoundscape/pull/546
* Issue 523 AudioMoth 1.5-1.8.1 MetaData by syunkova in https://github.com/kitzeslab/opensoundscape/pull/553
* Sammlapp/issue391 by sammlapp in https://github.com/kitzeslab/opensoundscape/pull/554
* v0.7.1 by sammlapp in https://github.com/kitzeslab/opensoundscape/pull/557

New Contributors
* zoharrpg made their first contribution in https://github.com/kitzeslab/opensoundscape/pull/505
* syunkova made their first contribution in https://github.com/kitzeslab/opensoundscape/pull/553

**Full Changelog**: https://github.com/kitzeslab/opensoundscape/compare/v0.7.0...v0.7.1

New Contributors
* jatinkhilnani made their first contribution in https://github.com/kitzeslab/opensoundscape/pull/475

**Full Changelog**: https://github.com/kitzeslab/opensoundscape/compare/v0.6.2...v0.7.0