acoustotreams 0.2.44

A Python package for acoustic-wave scattering based on the T-matrix method

acoustotreams

The package acoustotreams adopts the framework of the treams package for pressure-wave scattering in arrangements of multiple acoustic scatterers, with and without peridic boundary conditions, using the T-matrix method.

The package supports Python versions 3.8-3.13.

Installation

Installation using pip

To install the package with pip, use

pip install acoustotreams

Preliminarily, you have to also install original treams as well as numpy and scipy.

pip install treams

Documentation

The documentation can be found at https://NikUstimenko.github.io/acoustotreams.

Publications

When using this code, please cite:

N. Ustimenko, and C. Rockstuhl, acoustotreams -- A Python package for acoustic-wave scattering based on the T-matrix method, arXiv 2606.22573 (2026).

The following publications document the developments and methods for different parts of the code:

• N. Ustimenko, I. Fernandez-Corbaton, and C. Rockstuhl, Singular value decomposition to describe bound states in the continuum in periodic metasurfaces, Phys. Rev. B 113, 235418 (2026).
• O. Demeulenaere, N. Ustimenko, A. G. Athanassiadis, L. Gulati, C. Rockstuhl, and P. Fischer, Ultrasonic metamaterial at MHz frequencies using microstructured glass, arXiv 2512.20506 (2026).
• N. Ustimenko, A. B. Evlyukhin, V. Kyrimi, A. V. Kildishev, and C. Rockstuhl, Lattice-induced sound trapping in biperiodic metasurfaces of acoustic resonators, Phys. Rev. Res. 8, 013074 (2026).
• N. Ustimenko, C. Rockstuhl, and A. V. Kildishev, Optimal multipole center for subwavelength acoustic scatterers, Appl. Phys. Lett. 126, 142201 (2025).

Features

• T-matrix calculations using a spherical or cylindrical wave basis set
• Scattering from clusters of particles
• Scattering from particles and clusters arranged in 3d-, 2d-, and 1d-lattices
• Calculation of sound propagation in stratified media
• Band calculation in crystal structures