How to install gammatone from GitHub?

Run 'pip install git+https://github.com/detly/gammatone.git' for direct installation, or clone the repository and use 'pip install .' from the local directory. This method ensures you get the latest version from the source.

What's the difference between gammatone and Fourier spectrograms?

Gammatone spectrograms use filterbanks based on human auditory perception, with logarithmic frequency spacing for intuitive visualization, while Fourier spectrograms use linear spacing and may not align as well with how we hear sound.

Can I use gammatone for real-time audio analysis?

No, the toolkit is optimized for offline analysis and visualization; it doesn't include features for low-latency or streaming audio processing, making it unsuitable for real-time applications.

How does gammatone compare to librosa for audio processing?

Gammatone specializes in perceptual auditory models and gammatone filterbanks for education and research, whereas librosa offers a broader suite of audio analysis tools, including standard spectrograms and music features, with more active development.

What dependencies do I need to run gammatone?

It requires numpy, scipy, and matplotlib for core functionality, plus nose and mock for testing. These are standard in scientific Python but add overhead compared to lighter audio libraries.

Is there a way to verify the gammatone code against MATLAB?

Yes, the project includes test generation scripts that create .mat files for comparison, but this process relies on MATLAB or pre-generated data, which can be a barrier if you don't have access to MATLAB.

Open-Awesome

Gammatone

BSD-3-ClauseMATLAB

A Python toolkit for generating gammatone-based spectrograms using perceptual models of human hearing.

GitHub

229 stars70 forks0 contributors

What is Gammatone?

Gammatone is a Python toolkit for generating gammatone-based spectrograms, which analyze sound using perceptual models of human hearing. It ports MATLAB code for gammatone filterbanks and Fourier transform weightings to create visualizations that better represent how humans experience sound compared to traditional Fourier-based spectrograms.

Target Audience

Researchers, educators, and developers working in audio signal processing, auditory science, or music visualization who need perceptually accurate sound analysis tools.

Value Proposition

It provides a Python implementation of established auditory models, offering a more intuitive and human-centric approach to sound visualization than standard Fourier methods, with verified accuracy against original MATLAB code.

Overview

Gammatone-based spectrograms, using gammatone filterbanks or Fourier transform weightings.

Use Cases

Best For

Creating perceptually accurate spectrograms for music visualization
Teaching auditory signal processing with human-centric models
Researching auditory perception and sound analysis
Porting MATLAB gammatone filterbank code to Python
Analyzing audio signals with gammatone filterbanks
Developing intuitive sound visualization tools for education

Not Ideal For

Real-time audio processing applications requiring low latency
Machine learning pipelines needing integration with frameworks like TensorFlow or PyTorch
Projects requiring extensive community support or active maintenance
Environments where minimal dependencies are critical for deployment

Pros & Cons

Pros

Verified MATLAB Fidelity

Includes test suites that verify the Python implementation against original MATLAB code, ensuring accuracy for research and educational use.

Educational Focus

Designed to teach auditory signal processing with intuitive visualizations that model human hearing, making abstract concepts more accessible.

Efficient FFT Approximation

Uses Fourier transform weightings to approximate gammatone-grams, offering computational efficiency while preserving perceptual accuracy.

Dual Python Support

Compatible with both Python 2 and 3, accommodating legacy systems and broadening usability across different environments.

Cons

Outdated Codebase

Last updated in 2013, with no recent activity, potentially missing modern Python features, bug fixes, or security updates.

Heavy Dependencies

Requires numpy, scipy, matplotlib, and testing libraries, which can increase setup complexity and resource usage for simple tasks.

Sparse Documentation

The README provides basic usage but lacks in-depth tutorials or examples beyond a demo, making it harder for new users to adopt.

Frequently Asked Questions

Related Projects

matchering

🎚️ Open Source Audio Matching and Mastering

Stars2,577

Forks281

Last commit5 days ago

AudioTK

An audio digital processing toolbox based on a workflow/pipeline principle

Stars253

Forks38

Last commit5 years ago

PyRubberband

python wrapper for rubberband

Stars218

Forks28

Last commit1 year ago

MDCT

A fast MDCT implementation using SciPy and FFTs

Stars55

Forks13

Last commit4 years ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub