HALS - Holographic Acoustic Loudspeaker Scanner
After more than a year of development, testing and discussion, we believe HALS has reached the point where it can be presented as a usable project rather than only as a development journey.HALS is, in essence, a DIY alternative to a Klippel-style Near Field Scanner: an automated system that measures a loudspeaker at many positions in the near field, then uses spherical harmonics to reconstruct a continuous three-dimensional model of its sound field.
This “holographic” model has two major advantages over a conventional horizontal or vertical microphone sweep:
- It can separate the loudspeaker from the room’s influence, providing effectively anechoic measurements.
- The reconstructed sound field can be evaluated at many locations in three dimensional space - from only 5 cm from a port, where cabinet leakage and local behaviour can be examined, to a position 50 metres away for evaluating true far-field performance.
The project grew primarily out of collaboration between Dimitri, Tom and Jan, as well as lengthy and productive discussions with many users here and on DIY-Audio.com. The original development threads contain a great deal of background, experimentation and problem-solving, but they have inevitably become rather long.
This thread is intended to provide a cleaner introduction to the HALS system as it exists today and a central place for new users.
What does HALS do?
HALS moves a measurement microphone through a cylindrical cloud of points around a stationary loudspeaker. At every position, it plays a sine sweep and records the loudspeaker’s impulse response. Typical measurement grids contain between 500 and 2,000 points.The resulting collection of measurements is processed in HALS Studio, where the measured sound field can be reconstructed and analysed. HALS Studio can also generate FRD files and impulse responses for use in other software.
In practical terms, the complete workflow is:
- Mount and align the loudspeaker, then home the scanner.
- Tell the software the approximate size and position of the loudspeaker by jogging the microphone to key reference points, such as the baffle edge and tweeter.
- Let the software automatically generate a measurement-point cloud containing the chosen number of points.
- Let the scanner record an impulse response at every position. Depending on the grid and measurement settings, this typically takes between one and four hours, but the process is automated.
- Process the resulting measurement set in HALS Studio.
- Explore the response and directivity by interacting with the reconstructed sound field in 3D, placing virtual microphones and using the available analysis tools.
- Export plots, frequency responses, impulse responses and other results for further use.
The documentation is still a significant area of ongoing work and will continue to improve.
The three parts of HALS
1. Measurement and scanner-control software
The acquisition software controls the robot, generates the measurement grid, handles audio playback and recording, and manages the complete automated scanning sequence. It produces measurement-session folders that can be opened directly in HALS Studio.The desktop application includes:
- Audio-interface and channel configuration
- A cylindrical measurement-grid generator
- Scanner calibration, homing and manual jogging
- Automated measurement runs
- Multiple-sweep averaging
- Dual-channel capture for timing alignment
- Farina-style exponential-sine-sweep deconvolution, separating the linear and nonlinear components of the impulse response
- Live impulse-response and frequency-response displays
- A mock mode for exploring the workflow without connected hardware
Release v0.3.0 — TomKamphuys/NFS
Source code and documentation:
https://github.com/TomKamphuys/NFS
2. HALS Studio
HALS Studio is the companion desktop application for processing and analysing the measurements made by the scanner.Its workflow is organised into three main workspace areas:
- Process — prepares the measurement set and performs the sound-field processing.
- Analysis — provides advanced tools for evaluating the response, directivity and time-domain behaviour of the reconstructed sound field.
- Export — generates FRD files and impulse responses at specified virtual-microphone positions for use in other applications, such as VituixCAD and REW.
HALS Studio initial release
Source code and documentation:
https://github.com/dfapinov/HALS-Studio
Short HALS Studio tutorial:
Process:
Analyze:
Analyze:
Export:
3. Scanner mechatronics
The physical scanner uses a rotating arm carrying a microphone assembly that can move both radially and vertically. In other words, it uses a cylindrical kinematic system. The device under test stands on a central platform and does not rotate.The published design uses:
- A steel tripod and central pillar
- Standard aluminium profiles and assembly parts
- Stepper motors and geared stepper motors
- A BTT 3D-printer motion-control board running GRBLHAL firmware
- Timing-belt-driven rotary and linear axes
- Commonly available bearings, shafts and other mechanical parts
- Approximately 80 3D-printed components
The mechatronics repository contains the Fusion 360 model, STEP files, bills of materials, design decisions, photographs and construction information for the main assemblies.
Hardware repository:
https://github.com/JanRSmit/HALS-Mechatronics
Jan's Scanner Build:
Getting started
If you are mainly interested in understanding the workflow, both HALS Studio and the scanner-control software can be explored before building the complete robot. The acquisition software includes a mock mode, allowing a measurement run to be rehearsed without connected hardware.A practice dataset for analysis and export is also available:
PRACTICE DATASET - Elac Debut 2.0
Its results can be compared with independent measurements published by >ASR< and >Erin’s Audio Corner<.
However, a more robust validation is to compare the HALS prediction against a direct measurement of the DUT at a position that was not part of the input dataset.
The measurement point shown above was not included in the HALS input data. The HALS model was used to predict the complete response at this position, which was then compared with a direct in-room measurement at the same coordinates. Some differences in smoothing remain visible as HALS uses Frequency dependant Windowing.
The download does not contain the complete input dataset of almost 2,000 impulse-response WAV files, as these require several gigabytes of storage and are impractical to host indefinitely. Instead, it contains the preprocessed holographic model—the _coefficients.h5 and _project.json files—which can be opened in HALS Studio.
For an actual scan, the main requirements are:
- A completed scanner
- A measurement microphone
- An audio interface with ASIO support and at least two input and two output channels (Focusrite Scarlett 2i2, MOTU M2, Behringer UMC202 etc..)
- A power amplifier and loudspeaker under test, or an active loudspeaker
- A Windows 10 or Windows 11 computer connected to the audio interface and motion controller
Processing in HALS Studio requires a reasonably modern system because the computational load can be significant and the application uses hardware-accelerated graphics. Modern integrated graphics should be sufficient.
Project status
HALS should still be regarded as a developing DIY project, but the complete chain is now present:- A working and documented scanner
- Automated measurement software
- A graphical processing and analysis application
- Published source code, mechanical models and documentation
There will certainly be further improvements, additional documentation and lessons learned from other builds. Feedback, test results, bug reports and contributions are therefore very welcome.
Links
Measurement and scanner-control software:https://github.com/TomKamphuys/NFS
Processing, analysis and export software:
https://github.com/dfapinov/HALS-Studio
Scanner design and mechatronics:
https://github.com/JanRSmit/HALS-Mechatronics
PRACTICE DATASET - Elac Debut 2.0
https://drive.proton.me/urls/0RZGWMYY6R#D2XFbyG3kUyg
HALS Studio tutorial video:
Original DIYAudio development thread:
https://www.diyaudio.com/community/threads/klippel-near-field-scanner-on-a-shoestring.318151/
Original ASR development thread:
https://www.audiosciencereview.com/...ner-the-mathematics-and-everything-else.9970/
We hope to welcome you aboard the HALShip!
Last edited: