Holo

Holo is a Gain for generating multiple focal points.

Install

cargo add autd3-gain-holo

target_link_libraries(<TARGET> PRIVATE autd3::gain::holo)

APIs

Several algorithms for generating multiple focal points have been proposed, and the SDK implements the following algorithms:

• Naive - Superimposition of single focal point solutions
• GS - Gershberg-Saxon
• GSPAT - Gershberg-Saxon for Phased Arrays of Transducers
• LM - Levenberg-Marquardt
• Greedy - Greedy algorithm and Brute-force search

In addition, each method allows you to choose a computation backend. (except for Greedy.) The SDK provides the following Backends:

• NalgebraBackend - Uses Nalgebra
• CUDABackend - Uses CUDA, runs on GPU (Rust version only)
• ArrayFireBackend - Uses ArrayFire (Rust version only)

NOTE: CUDABackend and ArrayFireBackend are intended for speedup, but in most cases, NalgebraBackend is sufficient. Be sure to benchmark when using them.

Emission Constraints

The intensity of the calculation results of each algorithm must ultimately be limited to the range that the transducers can output. This can be controlled with the optional EmissionConstraint, and one of the following four must be specified:

• Normalize: Normalize all transducer intensities by dividing by the maximum intensity.
• Uniform: Set the intensity of all transducers to the specified value.
• Clamp: Clamp the intensity to the specified range.
• Multiply: Multiply by a specified value after normalization.