Skip to main content

new-fave

PyPI PyPI - Python Version Python CI codecov Maintainability License: GPL v3 DOI

What is new-fave?

new-fave is a tool for automating and optimizing vowel formant extraction. It is philosophically similar (and named after) the FAVE-suite. However, new-fave has been completely written from scratch, and has some key differences from the FAVE-suite.

  1. new-fave does not include a forced-aligner. It can process alignments produced by fave-align, but we would recommend using the Monteal Forced Aligner instead
  2. new-fave does not require speaker demographics. You can optionally pass fave-extract a speaker demographics file to be merged into your formant data, but this does not influence how the data is processed in any way. Besides including file name and speaker number data, you can pass any demographic information you would like.
  3. new-fave does not assume North American English vowels. Your alignments can contain any set of vowels, in any transcription system, as long as you can provide a regular expression to identify them.
  4. new-fave is customizable. With config files, you can customize vowel recoding, labelset parsing, and point measurement heuristics.
  5. new-fave is focused on formant tracks. You can still produce single point measurements for vowels, but new-fave is built upon the FastTrack method. By default, it will write output files including point measurements, full formant tracks, and Discrete Cosine Transform coefficients.
  6. new-fave is maintainable. As time goes on, and the code base needs updating, the organization and infrastructure of new-fave should allow it to be readilly updateable.

You can read more at the new-fave documentation.

Installation

You can install new-fave with pip.

# bash
pip install new-fave

Usage

To use the default settings (which assume CMU dictionary transcriptions), you can use one of these patterns.

A single audio + textgrid pair

# bash
fave-extract audio-textgrid speaker1.wav speaker1.TextGrid

A directory of audio + textgrid pairs

# bash
fave-extract corpus speakers/

Multiple subdirectories of audio + textgrid pairs

# bash
fave-extract subcorpora data/*

Metadata

Release files for new-fave 1.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for new-fave 1.3.0
File Size Uploaded
new_fave-1.3.0.tar.gz 31.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for new-fave 1.3.0
File Interpreter ABI Platform
new_fave-1.3.0-py3-none-any.whl Python 3 none any Details

Total release size: 76.1 kB

Release files / new_fave-1.3.0.tar.gz

Download URL new_fave-1.3.0.tar.gz
Size 31.8 kB
Tags Source
SHA-256 checksum
How to use checksums
42b12360f95ea8a38ef8acb2ee074c7637f5083248d9445a1a77e58898982017
BLAKE2b-256 checksum
How to use checksums
a0cdb40fb8ca03c0f8291af77e0f360d16a81e533b72d7c8655dddfbba4a20dc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / new_fave-1.3.0-py3-none-any.whl

Download URL new_fave-1.3.0-py3-none-any.whl
Size 44.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
39520246d8c8248371486d93f5c94a9e96a89517933dc1487b11d2ba3432bdda
BLAKE2b-256 checksum
How to use checksums
d96d000c9272c4c0ce9058c9f99a8e9200f781647758a7099b555abd0e32c374
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release history Release notifications | RSS feed

This release

1.3.0 This release

2 release files

1.2.1

2 release files

1.2.0

2 release files

1.1.1

2 release files

1.1.0

2 release files

1.0.3

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0.0

2 release files

0.2.0

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page