acoustotreams 0.2.20

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 acoustic wave scattering in finite and periodic arrangements of particles, based on the T-matrix method.

Installation

Installation using pip

To install the package with pip, use

pip install acoustotreams

Preliminarily, you have to also install original treams>0.4 as well as numpy and scipy<1.17

pip install treams

Documentation

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

Publications

When using this code please cite:

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, arXiv 2602.15741 (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