autd 9.0.1

AUTD library for Rust.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

/*
 * File: lib.rs
 * Project: src
 * Created Date: 22/05/2020
 * Author: Shun Suzuki
 * -----
 * Last Modified: 31/12/2020
 * Modified By: Shun Suzuki (suzuki@hapis.k.u-tokyo.ac.jp)
 * -----
 * Copyright (c) 2020 Hapis Lab. All rights reserved.
 *
 */

pub mod primitives;

use crate::{consts::DataArray, geometry::Geometry};
use crate::{Float, PI};

/// Gain contains amplitude and phase of each transducer in the AUTD.
///  Note that the amplitude and phase mean duty ratio and shift duration of Pulse Width Modulation, respectively.
pub trait Gain: Send {
    /// Calculate amplitude and phase of each transducers.
    fn build(&mut self, geometry: &Geometry);
    /// Get amplitude and phase data of all transducers.
    /// The data must be [0-th transducer's phase, 0-th transducer's amplitude, 1-th transducer's phase, ...].
    fn get_data(&self) -> &[DataArray];
}

/// Adjust amplitude to duty ratio of Pulse Width Modulation.
pub fn adjust_amp(amp: Float) -> u8 {
    let d = amp.asin() / PI; // duty (0 ~ 0.5)
    (510.0 * d) as u8
}