Skip to content
No description, website, or topics provided.
Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
sample
.gitignore
LICENSE
README.md
generate.sh

README.md

directivity-utils

A script to create a directivity sonogram based on measurements dumped out of [REW] (http://www.roomeqwizard.com/) (and until such time as http://www.hometheatershack.com/forums/rew-forum/111090-feature-request-polar-response-plots.html is implemented).

What is a polar map?

See [this article] (http://www.acousticfrontiers.com/20131129controlled-directivity-speakers-open-up-your-acoustic-treatment-options/) for a summary. The approach, I believe, originates from Geddes and has been subsequently implemented in [ARTA] (http://www.artalabs.hr/). This implementation uses the same colour scheme (the matlab jet colourmap) for consistency.

What do I need to get started?

  • a set of measurements containing appropriately measured data of a loudspeaker taken at various angles
  • either
    • a linux box
    • a windows box with cygwin - install from here
  • gnuplot
  • awk

How do I generate a sonogram?

NB: these instructions assume you are using REW, other software probably works as they all seem to stick to the same space delimited [FRD] (http://www.cross-spectrum.com/weblog/2010/03/05) format.

Prepare the Input Data

  • take measurements in your usual fashion at various degrees off axis
  • create a directory to store the exported data
  • export each measurement to a text file in space delimited FRD format named <degrees>.dat (select measurement, file/export/measurement as text, enter file name)

NB: see the [sample] dir in this repo for an example of the exported data

Generate the Plot

NB: assumes generate.sh from this repo is on your path and is executable

  • open a shell in the directory containing the data

    generate.sh

  • look for some png files in the output dir

if you want to know what the cmd line options are then just run generate.sh -v

generate.sh -d -l 100 -h 22000 -m -x 1920 -y 1080 -p foo -z 30
    -d force delete of existing generated files
-l sets the lo frequency for the data generated, if unset default to the minimum value in the input data (NB: actually 200 for now)
    -h sets the hi frequency for the data generated, if unset default to the maximum value in the input data (NB: actually 24000 for now)
    -m mirror mode
    -x width of image in pixels, default 1920
    -y height of image in pixels, default 1080
    -p file name prefix
    -z z axis range, defaults to 30dB

The generated plot will always have a black line indicating the -6dB contour.

How do I change the reference SPL?

The reference SPL is set using the -r option, if the supplied value is greater than the detected max spl then this is used instead. The reference spl is the point from which the -6dB contour is calculated.

My FRDs use a different file extension, how do I override it?

Use the -e option

TODO

Formatting

  • label the contours as -3, -6, -9 etc
You can’t perform that action at this time.