Skip to content

samkirkham/aurora

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

39 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AURORA

AURORA: Acoustic Understanding and Real-time Observation of Resonant Articulations

Description

AURORA provides real-time visualization of spectral features with formant tracking and (preliminary) tongue shape estimation. The application captures audio input, performs spectral analysis, and displays spectral peaks and predicted tongue shape in real-time. An example screenshot of the GUI is shown below:

AURORA Screenshot

Requirements

  • Python 3.12 or higher
  • uv (for dependency management)

Installation

1. Install uv

If you don't have uv installed, follow the installation instructions at https://docs.astral.sh/uv/getting-started/installation/.

2. Clone and Setup

# Navigate to the top-level directory
cd aurora

# Install dependencies
uv sync

Usage

Run the main application:

uv run python aurora/aurora.py

Dependencies

  • numpy: Numerical computing
  • sounddevice: Real-time audio I/O
  • scipy: Scientific computing (signal processing)
  • librosa: Audio analysis
  • pyqtgraph: Real-time plotting and GUI
  • polars: Data manipulation (used in model building)

Features

  • Real-time audio capture and analysis
  • Formant tracking using LPC analysis
  • Tongue shape modeling and visualization
  • Configurable parameters (sampling rate, frame size, LPC order)
  • GUI interface with interactive plots

Configuration

Default parameters can be modified in the main script:

  • fs: Sampling rate (default: 10000 Hz)
  • frame_size: Analysis frame size (default: 1024)
  • lpc_order: LPC analysis order (default: 12)
  • rms_threshold: RMS threshold for processing (default: 0.03)

Author

Sam Kirkham (s.kirkham@lancaster.ac.uk)

About

Real-time formant and articulatory feedback from acoustics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors