Pattern

Representative sound field computation utilities such as a single focal point, a plane wave, a Bessel beam, and the trapping fields used for acoustic levitation.

Installation

Rust

cargo add autd3-rs-pattern

Python

pip install autd3-pattern

C#

dotnet add package AUTD3.Pattern

Function List

• focus — single focal point
• plane — plane wave
• bessel — Bessel beam
• laguerre_gaussian_phase — Laguerre-Gaussian beam
• hermite_gaussian_phase — Hermite-Gaussian beam
• set_intensity / set_phase / add_phase — set the intensity and phase of a whole buffer
• group — select a pattern per transducer

focus / plane / bessel / laguerre_gaussian_phase / hermite_gaussian_phase also have a *_device variant that computes for only a single device, and a *_transducer variant that returns the phase of a single transducer element (for example, focus_device / focus_transducer). These variants are available in Rust and C#, but not in Python.

Pattern functions write only the phase and leave the intensity untouched. A buffer allocated with pattern_buffer starts at phase 0 and the maximum intensity; use set_intensity to change the intensity.

Wavelength

The phase computation requires the wavelength . The wavelength can be obtained from the sound speed via autd3_rs_pattern::wavelength(sound_speed). At a sound speed of 340 m/s (the speed of sound in air at a room temperature of about 15°C), .