python_speech_features

This library provides common speech features for ASR including MFCCs and filterbank energies.

https://github.com/jameslyons/python_speech_features

Science Score: 23.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
  • .zenodo.json file
  • DOI references
    Found 2 DOI reference(s) in README
  • Academic publication links
  • Committers with academic emails
    1 of 19 committers (5.3%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (12.3%) to scientific vocabulary
Last synced: 10 months ago · JSON representation

Repository

This library provides common speech features for ASR including MFCCs and filterbank energies.

Basic Info
  • Host: GitHub
  • Owner: jameslyons
  • License: mit
  • Language: Python
  • Default Branch: master
  • Homepage:
  • Size: 216 KB
Statistics
  • Stars: 2,411
  • Watchers: 86
  • Forks: 619
  • Open Issues: 25
  • Releases: 0
Created over 12 years ago · Last pushed over 4 years ago
Metadata Files
Readme License

README.rst

======================
python_speech_features
======================

This library provides common speech features for ASR including MFCCs and filterbank energies.
If you are not sure what MFCCs are, and would like to know more have a look at this 
`MFCC tutorial `_

`Project Documentation `_

To cite, please use: James Lyons et al. (2020, January 14). jameslyons/python_speech_features: release v0.6.1 (Version 0.6.1). Zenodo. http://doi.org/10.5281/zenodo.3607820

Installation
============

This `project is on pypi `_

To install from pypi:: 

	pip install python_speech_features

	
From this repository::

	git clone https://github.com/jameslyons/python_speech_features
	python setup.py develop


Usage
=====

Supported features:

- Mel Frequency Cepstral Coefficients
- Filterbank Energies
- Log Filterbank Energies
- Spectral Subband Centroids

`Example use `_

From here you can write the features to a file etc.


MFCC Features
=============

The default parameters should work fairly well for most cases, 
if you want to change the MFCC parameters, the following parameters are supported::

	python
	def mfcc(signal,samplerate=16000,winlen=0.025,winstep=0.01,numcep=13,
			 nfilt=26,nfft=512,lowfreq=0,highfreq=None,preemph=0.97,
             ceplifter=22,appendEnergy=True)

=============	===========
Parameter 		Description
=============	===========
signal			the audio signal from which to compute features. Should be an N*1 array
samplerate 		the samplerate of the signal we are working with.
winlen 			the length of the analysis window in seconds. Default is 0.025s (25 milliseconds)
winstep 		the step between successive windows in seconds. Default is 0.01s (10 milliseconds)
numcep			the number of cepstrum to return, default 13
nfilt			the number of filters in the filterbank, default 26.
nfft			the FFT size. Default is 512
lowfreq			lowest band edge of mel filters. In Hz, default is 0
highfreq		highest band edge of mel filters. In Hz, default is samplerate/2
preemph			apply preemphasis filter with preemph as coefficient. 0 is no filter. Default is 0.97
ceplifter		apply a lifter to final cepstral coefficients. 0 is no lifter. Default is 22
appendEnergy	if this is true, the zeroth cepstral coefficient is replaced with the log of the total frame energy.
returns			A numpy array of size (NUMFRAMES by numcep) containing features. Each row holds 1 feature vector.
=============	===========


Filterbank Features
===================

These filters are raw filterbank energies. 
For most applications you will want the logarithm of these features.
The default parameters should work fairly well for most cases. 
If you want to change the fbank parameters, the following parameters are supported::

	python
	def fbank(signal,samplerate=16000,winlen=0.025,winstep=0.01,
              nfilt=26,nfft=512,lowfreq=0,highfreq=None,preemph=0.97)

=============	===========
Parameter 		Description
=============	===========
signal			the audio signal from which to compute features. Should be an N*1 array
samplerate		the samplerate of the signal we are working with
winlen			the length of the analysis window in seconds. Default is 0.025s (25 milliseconds)
winstep			the step between successive windows in seconds. Default is 0.01s (10 milliseconds)
nfilt			the number of filters in the filterbank, default 26.
nfft			the FFT size. Default is 512.
lowfreq			lowest band edge of mel filters. In Hz, default is 0
highfreq		highest band edge of mel filters. In Hz, default is samplerate/2
preemph			apply preemphasis filter with preemph as coefficient. 0 is no filter. Default is 0.97
returns			A numpy array of size (NUMFRAMES by nfilt) containing features. Each row holds 1 feature vector. The second return value is the energy in each frame (total energy, unwindowed)
=============	===========


Reference
=========
sample english.wav obtained from::

	wget http://voyager.jpl.nasa.gov/spacecraft/audio/english.au
	sox english.au -e signed-integer english.wav

Owner

  • Name: James Lyons
  • Login: jameslyons
  • Kind: user

GitHub Events

Total
  • Watch event: 48
  • Fork event: 5
Last Year
  • Watch event: 48
  • Fork event: 5

Committers

Last synced: over 2 years ago

All Time
  • Total Commits: 102
  • Total Committers: 19
  • Avg Commits per committer: 5.368
  • Development Distribution Score (DDS): 0.373
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
James Lyons j****0@g****m 64
scienceopen s****n 11
ybdarrenwang d****g@f****m 7
Yow-Bang (Darren) Wang y****g@g****m 2
janLuke g****o@g****m 2
Watcharapol Watcharawisetkul w****l@a****m 2
hshteingart h****t@s****m 2
Pablo Jadzinsky j****z@s****u 1
Henrik Almér h****r@g****m 1
Janis j****s@c****m 1
Josef Hölzl h****f@g****m 1
Watcharapol Watcharawisetkul g****l@g****m 1
Yash Gaurkar y****r@g****m 1
erikma e****1@h****m 1
Chris Lord c****t@g****m 1
Adam Stark a****k@g****m 1
Sam Birch s****h@g****m 1
Lu ZhiHe l****e@g****m 1
Tim Gates t****s@i****m 1
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 11 months ago

All Time
  • Total issues: 71
  • Total pull requests: 29
  • Average time to close issues: 4 months
  • Average time to close pull requests: 3 months
  • Total issue authors: 68
  • Total pull request authors: 25
  • Average comments per issue: 2.01
  • Average comments per pull request: 0.69
  • Merged pull requests: 17
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • ghost (2)
  • radmar10 (2)
  • dmoham1476 (2)
  • LeeYongHyeok (1)
  • WeiJenLee (1)
  • chananshgong (1)
  • excetara2 (1)
  • keithchugg (1)
  • bernardohenz (1)
  • leeeeeeo (1)
  • YueWenWu (1)
  • ShasV05 (1)
  • lezasantaizi (1)
  • MarcosBarraza (1)
  • aavaas (1)
Pull Request Authors
  • janluke (3)
  • groupw66 (2)
  • erikmav (2)
  • chanansh (1)
  • mr-yamraj (1)
  • oranj (1)
  • ybdarrenwang (1)
  • zh794390558 (1)
  • jkravanja (1)
  • morenoh149 (1)
  • shuttle1987 (1)
  • drhirsch (1)
  • jhoelzl (1)
  • sbirch (1)
  • tbfly (1)
Top Labels
Issue Labels
Pull Request Labels

Packages

  • Total packages: 2
  • Total downloads:
    • pypi 51,323 last-month
  • Total docker downloads: 27
  • Total dependent packages: 2
    (may contain duplicates)
  • Total dependent repositories: 244
    (may contain duplicates)
  • Total versions: 7
  • Total maintainers: 1
pypi.org: python_speech_features

Python Speech Feature extraction

  • Versions: 6
  • Dependent Packages: 2
  • Dependent Repositories: 244
  • Downloads: 51,323 Last month
  • Docker Downloads: 27
Rankings
Downloads: 0.8%
Dependent repos count: 1.0%
Stargazers count: 1.5%
Forks count: 1.9%
Average: 2.3%
Docker downloads count: 4.1%
Dependent packages count: 4.8%
Maintainers (1)
Last synced: 11 months ago
proxy.golang.org: github.com/jameslyons/python_speech_features
  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 5.5%
Average: 5.7%
Dependent repos count: 5.9%
Last synced: 11 months ago

Dependencies

requirements.txt pypi
  • mock *
setup.py pypi
  • numpy *
  • scipy *