Git Product home page Git Product logo

aqua-tk's Introduction

AquaTK


Still in development

Logo

AquaTK is short for "Audio QUality Assessment Toolkit". It contains metrics that are popularly used in the evaluation of Neural Audio Synthesizers such as FAD and Kernel Distances. It also contains a pure python port of PEAQb, a C implementation of the Basic PEAQ algorithm.

Currently implemented metrics:

Metric Description
FAD Frechet Audio Distance
KID Kernel Inception Distance
PEAQb Basic PEAQ
NDB/k Number of Different Bins over K
SISDR Scale-Invariant SDR
SNR Signal-to-Noise Ratio
MAE Mean Absolute Error
MSE Mean Squared Error
KL Kullback-Leibler Divergence

Installation

You can install this repo using Git for now. PyPi support is coming soon:

$ pip install git+https://github.com/ashvala/AQUA-tk.git

Setting up VGGish weights:

Download The following:

Put them in the embedding_extractors/models/vggish folder. However, as long as you have the files, you can set the paths manually by yourself when initializing the VGGish extractor:

from aquatk.embedding_extractors import VGGish

vggish_extractor = VGGish(path_to_checkpoint=PATH_TO_CHECKPOINT, path_to_pca_params=PATH_TO_PARAMS)

Contributing

Contributions are welcome! Please feel free to open an issue or a pull request. This repository will only improve with your involvement!

Acknowledgements

This package would not exist if it weren't for the following:


License acknowledgements:

The program generally is released under the GPL license. However, it is important to mention the license for some of these models and implementations: FAD and VGGish from Google are provided under the Apache 2.0 license. @gudgud96's implementation for FAD is released under MIT license. PEAQb is released under the GPL license.


aqua-tk's People

Contributors

ashvala avatar jerryuhoo avatar tbyronb avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

aqua-tk's Issues

2f metric

Hi @Ashvala! this is a great project, finally someone tackles this! :-)

Do you plan to support the 2f metric directly here that you mention in the paper?

add documentations?

Thanks your meaningful work, I think this repo will be better if we have a docs about how to use it?

pip install git+https://github.com/ashvala/AQUA-tk.git doesn't seem to work

Hi,

The library doesn't seem to install with the command provided in the readme:

pip install git+https://github.com/ashvala/AQUA-tk.git

Then trying:

% python
Python 3.10.0 (default, Mar  1 2024, 13:29:06) [Clang 14.0.3 (clang-1403.0.22.14.1)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> from aquatk.embedding_extractors import VGGish
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ModuleNotFoundError: No module named 'aquatk.embedding_extractors'
>>> 

What Python version is recommended for AQUA-Tk?

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.