AcousTools: A ‘Full-Stack’, Python-Based, Acoustic Holography Library
Joshua Mukherjee, Giorgos Christopoulos, Zhouyang Shen, Sriram Subramanian, Ryuji Hirayama · 2025
Read AcousTools: A ‘Full-Stack’, Python-Based, Acoustic Holography Library by Joshua Mukherjee, Giorgos Christopoulos, Zhouyang Shen, Sriram Subramanian, Ryuji Hirayama (2025) in the Tower of Babel, a free online library of public-domain works preserved in clean, searchable text. No sign-up. The full text is served as a plain-text file at a predictable URL, where text is present: https://antarctic-labs.com/tower-of-babel/arxiv-2511-07336.txt.
Introduction
Joshua Mukherjee and four co-authors present AcousTools, a Python library covering the whole workflow of acoustic holography. The field steers mid-air ultrasound to create haptic sensations, volumetric displays, contactless fabrication. Biomedical effects, but researchers lacked one software stack spanning setup, propagation modeling, transducer phase retrieval, sound field analysis, and hardware control. Current tools each miss at least one stage of that pipeline.
AcousTools implements the full stack in Python, a language chosen for accessibility, and the paper shows the library meeting each stage's requirements. The authors argue a standard library would let researchers build applications faster and review each other's work accurately, since methods can be compared stage by stage within a shared system. They position the full-stack view itself as a contribution to how the field organizes its methods.
Catalog record
| CREATOR | Joshua Mukherjee, Giorgos Christopoulos, Zhouyang Shen, Sriram Subramanian, Ryuji Hirayama |
|---|---|
| YEAR | 2025 |
| COLLECTION | PAPERS |
| FORMAT | TXT |
| FILE SIZE | 58 KB |
| VERSION | 1.0 |
| LICENSE | http://creativecommons.org/licenses/by/4.0/ |
| RIGHTS | CC BY |
| SOURCE | arXiv |
Source: https://arxiv.org/abs/2511-07336
Browse the full library · About the Tower of Babel
Full text
The opening of the work, from the library's hosted text:
AcousTools: A ‘Full-Stack’, Python-Based, Acoustic Holography Library Joshua Mukherjee, Giorgos Christopoulos, Zhouyang Shen, Sriram Subramanian, Ryuji Hirayama Abstract Acoustic Holography is an emerging field where mid-air ultrasound is controlled and manipulated for novel and exciting applications. These range from mid-air haptics, volumetric displays, contactless fabrication, and even chemical and biomedical applications such as drug delivery. To develop these applications, a software framework to predict acoustic behaviour and simulating resulting effects, such as applied forces or scattering patterns is desirable. There have been various software libraries and platforms that attempt to fill this role, but there is yet to be a single piece of software that acts as a ‘full-stack’ solution. We define this full-stack as the process from abstraction to physicalisation starting with setup, modelling acoustic propagation, transducer phase retrieval, sound field analysis, and control of the acoustic holographic hardware itself. Existing methods fail to fulfil one or more of these categories. To address this, we present AcousTools, a Python-based acoustic holography library, designed to support the full suite of acoustic holographic applications and we show AcousTools’s ability to meet each step of the full-stack’s requirements. AcousTools has the potential to become the standard code library for acoustic holography, with the uniquely complete suite of features wrapped in a language that is known to be easy to use, AcousTools will increase the ability for researchers to develop novel applications as well as accurately review other’s work. The full-stack, aside from software, will also be useful for researchers – providing a way to view and compare methodologies by understanding where they fit into the stack. Fig. 1: The acoustic holography full-stack (top) describes the workflow for acoustic holography. A developer begins on the left and progresses to the right, moving from the most abstract stages (defining modelling parameters and modelling propagation) to the most physical stages (examining physical metrics of a sound field and producing that sound field in reality). This framework allows the analysis of different acoustic holography software based on the stages they support – the ideal software would allow a developer to complete every stage using a single software package. AcousTools uniquely addresses all stages in the full stack as shown in this example (bottom), from (1) defining the board and scatterer for levitation setup (i.e., a flat array and rabbit reflector), (2) computing the sound propagation using the scattering profile, (3) solving for the transducers’ activation to focus sound waves above the rabbit’s head, and then (4) analysing the acoustic force on a small particle (shown as blue arrows) before (5) finally rendering this in the real-world hardware. I Introduction Highlights \bullet Acoustic holography has neither a unified framework to think about acoustic applications nor a single software library to implement them – reducing interoperability and flexibility. \bullet We present the Acoustic Full-Stack, which describes the process a developer goes through to implement an acoustic application and then present AcousTools; a python-based library to implement each of these stages. \bullet With a unified software library, the interpretability between researchers will increase and the full-suite of options means developers can make fully informed choices about which methods and algorithms to use. Non-contact manipulation and stimulus open the door for numerous applications in a user-friendly and ergonomic way. Objects can be fabricated without ever touching the materials used, either by assembling smaller building blocks [ 7 ] or by shaping raw materials [ 5 ] . Haptic stimulus can give greater immersion in virtual reality [ 14 ] , leveraging human tactile mechanisms to produce higher quality stimulus [ 40 , 39 ] and render complex stimulus such as softness [ 30 ] . Levitation of small particles, in addition to fabrication, allows the creation of computer displays that are truly 3D [ 18 ] , by using props to represent objects [ 8 ] or by exploiting persistence of vision (PoV) to render shapes in 3D [ 37 , 18 ] . All these applications and more are unlocked by utilising focused mid-air ultrasound. To create these applications, a software package or library that can model the behaviour of acoustic waves is advantageous [ 33 , 27 ] . Common tasks include computing phases for transducer arrays in complex scenarios [ 7 ] , predicting how sound scatters from irregular objects [ 17 ] , and analysing the force exerted on an object in a sound field [ 29 ] . Pre-built software allows developers to focus on higher-level goals without needing to implement these complex processes from scratch. To compare software implementations for these tasks, we propose the acoustic ‘full-stack’, a conceptual framework for developing acoustic applications that outlines the process a developer follows from concept to physical deployment. This framework has five stages as shown in Fig. 1 . It begins with Setup , where the developer defines parameters for their application, such as the transducer arrays to be used and the locations that sound should be focused at. Next, Propagators is where the developer selects a method for modelling the acoustic waves, largely choosing between free-field assumptions or models that consider scattering effects. Then, Solvers is where the developer selects algorithms to compute the signals to be sent to the transducer arrays, with different algorithms having different advantages and trade-offs. In Analysis , the developer uses different metrics to compute the quality of the resulting sound field, either for quantification or to inform refinement of earlier stages. Finally, Hardware is where the computed signals are sent to physical devices, allowing the applications to be rendered in the real world. There are a variety of software packages that attempt to meet the stages described in the full-stack [ 33 , 27 , 1 , 43 , 9 ] . However, all existing solutions fail to meet one or many of these categories as can be seen in Tab. I . As a result, developers often need to switch between different packages or are unable to use certain methodologies without implementing them independently. As a unified solution for developing applications based on acoustic holography, we present AcousTools, a python-based library that can support every stage of the acoustic ‘full-stack’. Elements of this ‘full-stack’ are shown in Fig. 1 . In the Setup stage, an array above a rabbit reflector is defined which means that for the Propagators phase the chosen propagator considers scattered contributions from the rabbit. Using this scattering, the waves can be focused at a point above the rabbit’s head in the Solvers step and the resulting force is computed in the Analysis phase. Finally, in the Hardware step the field is rendered in reality above a 3D printed rabbit and a particle is levitated at the point that is predicted by the converging forces. In this work, we step through each stage of the full-stack, showing AcousTools’ efficacy in that area and highlighting where other software falls short. Its implementation using PyTorch in Python leverages the language’s ease of access especially for beginners [ 42 ] , as well as the parallelised and comprehensive capabilities of the PyTorch environment [ 36 ] . AcousTools is therefore the general purpose software solution that the acoustic holography community currently lacks. We anticipate that the community will