corinfinite / brp-pacu

An audio analysis tool to configure any sound system with an equalizer. It compares the output of the system to the input of the system and allows you to use this data to perform final equalization by matching the results with actual DSP/EQ.

BRP-PACU - An Audio Configuration utility

BRP-PACU is a dual channel FFT audio analysis tool. It is designed to aid in the equalization and time alignment of a sound system. It compares the output of the system to the input of the system to obtain the transfer function of the system. It is similar to commercial products like Smaart.

Dependencies

Development versions of the following packages:

• build-essential for build tools
• jack2
  • Tip: If jack is not already installed on your system, try to install the package qjackctl which depends on JACK and provides an easy way to manage JACK connections.
• GtK+ and Glade
• GTKdatabox for GTK3
  • git clone https://git.code.sf.net/u/felipo/gtkdatabox gtkdatabox3
  • Run ./scripts/myAutogen.sh and then the traditional ./configure, make, and make install since this is not a release, but coming straight from the repo.
  • The original library on SourceForge claims GTK3 support on the git master branch but this has not been tested with BRP-PACU; while the fork from felipo indicated above has been tested OK.
• FFTW version 3

On Ubuntu 16.04:

sudo apt install build-essential libfftw3-dev libc6 libglade2-dev libglib2.0-dev libgtk2.0-dev libjack-jackd2-dev

You can likely tweak this if you are on a different distribution. GTKDatabox must still be installed from the source following the instructions above.

Building

When you first checkout the repo you must first run ./autogen.sh to generate some Autotools files. If configure.ac or Makefile.am are changed you must run this script again.

Run the traditional ./configure, make, and make install to build BRP-PACU.

You can start BRP-PACU with ./BRP-PACU.

When BRP-PACU is installed on your system using make install, the executable is named “BRP_PACU”. It can be started from the Run dialog (that comes up when pressing ALt-F2), or from a command line which will give extra debugging information.

Usage

See docs/Usage.md

brp-pacu's Issues

Update GTKDatabox dependency

Make guiY less points, so drawing requires less CPU.

Added from TODO

Change delay buffer to not be dependent on N-FFT so that the maximum system delay is not dependednt on N_FFT and Sample Rates

Added from TODO

Reformat README

Add script for dependency installation

This will make getting started a little easier

Processing is done in JACK callback

The JACK callback should return as fast as possible but there is buffer filling and shuffling that occurs. This should be moved into the main thread or a new thread, along with the other processing tasks.

Couldn't load builder file: /usr/local/share/brp-pacu/BRP_PACU.ui

This error appears after trying to run the BRP_PACU executable after the initial build (sans "sudo make install"). Running "sudo make install" fixes this, but means that after any UI changes, "sudo make install" must be run.

Add comiler flags -Werror, -Wpedantic, and -Wall

Move code and media into sub directories

Window size, smoothing, and avg_num should be changeable in the UI

Added from TODO

The program should not quit when Jack does not start but stay on hold until jack is fixed and/or started manually. Also, it should not crash when Jack is stopped manually.

Added from TODO.

Check pink noise generator for correctness.

A while ago I tried to test BRP-PACU on a live system and myself and a colleague observed that the pink noise generator seemed to be lacking in the high end when compared to the pink noise generated by a Yamaha LS-9. The audio interface was a Digidesign MBox2.

Migrate issues from TODO file to Issues feature

Averaging is done on GUI rendering

Averaging on the output trace is done when the GUI updates. If the GUI updates more frequently the trace will appear smoother. If the GUI updates less frequently the trace will appear less well behaved. This is not desirable.

Averaging should be done as part of calculating the auto spectra and cross spectrum. Resolving this will be part of resolving #18

Sample Rate should be displayed somewhere.

Currently sample rate is printed to console, which is of no use to the average users.

Added from TODO

There should be a warning, and not buff_store.brp ceated.

Added from TODO. I assume this refers to the message displayed when the program is first run.

Implement windowing on input data

Feature: Change window function

The user must be able to specify what windowing function they wish to be applied to the input audio through the GUI.
The user must have at least two window functions to choose from. Currently Blackman is implemented and Hanning should be added. More functions would be nice.

Give JACK ports more intuitive names

Fix compiler warnings

Upgrade from GTK2 to GTK3

https://developer.gnome.org/gtk3/stable/gtk-migrating-2-to-3.html

Preparation steps done in 0ed157d and 92f2ae3

Any checked items without a bullet point below them were not used/applicable

• Replace size_request by get_preferred_width/height
• Replace GdkRegion by cairo_region_t
• Replace GdkPixmap by cairo surfaces
• Removed in 92f2ae3
• Removed commented out code involving Pixmaps
• Replace GdkColormap by GdkVisual
• GdkDrawable is gone
• Event filtering
• Backend-specific code
• GtkPlug and GtkSocket
• The GtkWidget::draw signal
• GtkProgressBar orientation
• Check your expand and fill flags
• Scrolling changes
• GtkObject is gone
• Unsure exactly how to resolve, for the time being changing GTK_OBJECT to G_OBJECT
• GtkEntryCompletion signal parameters
• Resize grips
• Prevent mixed linkage
• It may be an issues that the latest gtkdatabox release (0.9.3.0) uses gtk2 and the release suggested in our current readme is 0.9.2.0
• The master branch on the sourceforge repo advertises gtk3 support
• This github repo advertises gtk3 support
• It appears there may be gtk3 versions in newer Ubuntu repositories: https://packages.ubuntu.com/zesty/libgtkdatabox-0.9.3-0-glade
• Further investigation is needed
• Install GTK+ modules in the right place

"Resize" lets the line go out of the window

Added from TODO.

Phase and "coherence" plots?

Hi, and thanks for adopting BRP-PACU! I've been playing around with it many years ago, and when I wanted to resurrect it this week, I found it still required FFTW2... so I was more than happy to stumble upon your fork! It works very well for me so far. I would love to see a "coherence" graph (I think this is what most dual-FFT tools call it) that indicates how reliable each part of the computed transfer frequency response is based on if those frequencies are actually in the reference signal and how much correlation there is to the measured signal in that bin. At the moment, I frequently see a slight artefact at the HF end, which appears as if it's shelved up by about 10dB above 16k (disappears of course when using pink noise).
Additionally, having a way to display the phase portion of the FFT would be a great aid in tuning crossovers and time-alingning subwoofer stacks.
All the best, and thanks for sharing your work! Jörn

Move executables to Releases section