use std::ops::{Deref, DerefMut};
use crate::defined::{float, METER};
use super::{Matrix3, Transducer, UnitQuaternion, Vector3};
pub struct Device<T: Transducer> {
idx: usize,
transducers: Vec<T>,
pub enable: bool,
pub force_fan: bool,
pub reads_fpga_info: bool,
pub sound_speed: float,
pub attenuation: float,
inv: Matrix3,
}
impl<T: Transducer> Device<T> {
#[doc(hidden)]
pub fn new(idx: usize, transducers: Vec<T>) -> Self {
let inv = Matrix3::from_columns(&[
transducers[0].x_direction(),
transducers[0].y_direction(),
transducers[0].z_direction(),
])
.transpose();
Self {
idx,
transducers,
enable: true,
force_fan: false,
reads_fpga_info: false,
sound_speed: 340.0 * METER,
attenuation: 0.0,
inv,
}
}
pub fn idx(&self) -> usize {
self.idx
}
pub fn num_transducers(&self) -> usize {
self.transducers.len()
}
pub fn center(&self) -> Vector3 {
self.transducers
.iter()
.map(|tr| tr.position())
.sum::<Vector3>()
/ self.transducers.len() as float
}
pub fn to_local(&self, p: &Vector3) -> Vector3 {
self.inv * (p - self.transducers[0].position())
}
pub fn translate(&mut self, t: Vector3) {
self.affine(t, UnitQuaternion::identity());
}
pub fn rotate(&mut self, r: UnitQuaternion) {
self.affine(Vector3::zeros(), r);
}
pub fn affine(&mut self, t: Vector3, r: UnitQuaternion) {
self.transducers.iter_mut().for_each(|tr| tr.affine(t, r));
}
pub fn set_sound_speed_from_temp(&mut self, temp: float) {
self.set_sound_speed_from_temp_with(temp, 1.4, 8.314_463, 28.9647e-3);
}
pub fn set_sound_speed_from_temp_with(&mut self, temp: float, k: float, r: float, m: float) {
self.sound_speed = (k * r * (273.15 + temp) / m).sqrt() * METER;
}
}
impl<T: Transducer> Deref for Device<T> {
type Target = [T];
fn deref(&self) -> &Self::Target {
&self.transducers
}
}
impl<T: Transducer> DerefMut for Device<T> {
fn deref_mut(&mut self) -> &mut Self::Target {
&mut self.transducers
}
}
pub trait IntoDevice<T: Transducer> {
fn into_device(self, dev_idx: usize) -> Device<T>;
}
#[cfg(test)]
pub mod tests {
use crate::{defined::PI, geometry::LegacyTransducer};
use super::*;
macro_rules! assert_approx_eq_vec3 {
($a:expr, $b:expr) => {
assert_approx_eq::assert_approx_eq!($a.x, $b.x, 1e-3);
assert_approx_eq::assert_approx_eq!($a.y, $b.y, 1e-3);
assert_approx_eq::assert_approx_eq!($a.z, $b.z, 1e-3);
};
}
macro_rules! assert_approx_eq_quat {
($a:expr, $b:expr) => {
assert_approx_eq::assert_approx_eq!($a.w, $b.w, 1e-3);
assert_approx_eq::assert_approx_eq!($a.i, $b.i, 1e-3);
assert_approx_eq::assert_approx_eq!($a.j, $b.j, 1e-3);
assert_approx_eq::assert_approx_eq!($a.k, $b.k, 1e-3);
};
}
pub fn create_device<T: Transducer>(idx: usize, n: usize) -> Device<T> {
Device::new(
idx,
(0..n)
.map(|i| T::new(i, Vector3::zeros(), UnitQuaternion::identity()))
.collect(),
)
}
#[test]
fn device_idx() {
let device = create_device::<LegacyTransducer>(0, 249);
assert_eq!(device.idx(), 0);
let device = create_device::<LegacyTransducer>(1, 249);
assert_eq!(device.idx(), 1);
}
#[test]
fn device_num_transducers() {
let device = create_device::<LegacyTransducer>(0, 249);
assert_eq!(device.num_transducers(), 249);
}
#[test]
fn device_center() {
let transducers = itertools::iproduct!((0..18), (0..14))
.enumerate()
.map(|(i, (y, x))| {
LegacyTransducer::new(
i,
10.16 * Vector3::new(x as float, y as float, 0.),
UnitQuaternion::identity(),
)
})
.collect::<Vec<_>>();
let expected =
transducers.iter().map(|t| t.position()).sum::<Vector3>() / transducers.len() as float;
let device = Device::new(0, transducers);
assert_approx_eq_vec3!(device.center(), expected);
}
#[test]
fn device_to_local() {
{
let transducers = itertools::iproduct!((0..18), (0..14))
.enumerate()
.map(|(i, (y, x))| {
LegacyTransducer::new(
i,
10.16 * Vector3::new(x as float, y as float, 0.),
UnitQuaternion::identity(),
)
})
.collect::<Vec<_>>();
let device = Device::new(0, transducers);
let p = Vector3::new(10., 20., 30.);
assert_approx_eq_vec3!(device.to_local(&p), p);
}
{
let p = Vector3::new(10., 20., 30.);
let transducers = itertools::iproduct!((0..18), (0..14))
.enumerate()
.map(|(i, (y, x))| {
LegacyTransducer::new(
i,
10.16 * Vector3::new(x as float, y as float, 0.) + p,
UnitQuaternion::identity(),
)
})
.collect::<Vec<_>>();
let device = Device::new(0, transducers);
assert_approx_eq_vec3!(device.to_local(&p), Vector3::zeros());
}
{
let q = UnitQuaternion::from_axis_angle(&Vector3::z_axis(), PI / 2.);
let transducers = itertools::iproduct!((0..18), (0..14))
.enumerate()
.map(|(i, (y, x))| {
LegacyTransducer::new(i, 10.16 * Vector3::new(x as float, y as float, 0.), q)
})
.collect::<Vec<_>>();
let device = Device::new(0, transducers);
let p = Vector3::new(10., 20., 30.);
assert_approx_eq_vec3!(device.to_local(&p), Vector3::new(p.y, -p.x, p.z));
}
{
let p = Vector3::new(10., 20., 30.);
let q = UnitQuaternion::from_axis_angle(&Vector3::x_axis(), PI / 2.);
let transducers = itertools::iproduct!((0..18), (0..14))
.enumerate()
.map(|(i, (y, x))| {
LegacyTransducer::new(
i,
10.16 * Vector3::new(x as float, y as float, 0.) + p,
q,
)
})
.collect::<Vec<_>>();
let device = Device::new(0, transducers);
assert_approx_eq_vec3!(device.to_local(&p), Vector3::new(0., 0., 0.));
let d = Vector3::new(40., 50., 60.);
assert_approx_eq_vec3!(device.to_local(&(p + d)), Vector3::new(d.x, d.z, -d.y));
}
}
#[test]
fn device_translate() {
let transducers = itertools::iproduct!((0..18), (0..14))
.enumerate()
.map(|(i, (y, x))| {
LegacyTransducer::new(
i,
10.16 * Vector3::new(x as float, y as float, 0.),
UnitQuaternion::identity(),
)
})
.collect::<Vec<_>>();
let mut device = Device::new(0, transducers);
let t = Vector3::new(40., 50., 60.);
device.translate(t);
itertools::iproduct!((0..18), (0..14))
.map(|(y, x)| 10.16 * Vector3::new(x as float, y as float, 0.) + t)
.zip(device.iter())
.for_each(|(expect, tr)| {
assert_approx_eq_vec3!(expect, tr.position());
});
}
#[test]
fn device_rotate() {
let transducers = itertools::iproduct!((0..18), (0..14))
.enumerate()
.map(|(i, (y, x))| {
LegacyTransducer::new(
i,
10.16 * Vector3::new(x as float, y as float, 0.),
UnitQuaternion::identity(),
)
})
.collect::<Vec<_>>();
let mut device = Device::new(0, transducers);
let rot = UnitQuaternion::from_axis_angle(&Vector3::x_axis(), 0.)
* UnitQuaternion::from_axis_angle(&Vector3::y_axis(), 0.)
* UnitQuaternion::from_axis_angle(&Vector3::z_axis(), PI / 2.);
device.rotate(rot);
let expect_x = Vector3::new(0., 1., 0.);
let expect_y = Vector3::new(-1., 0., 0.);
let expect_z = Vector3::new(0., 0., 1.);
device.iter().for_each(|tr| {
assert_approx_eq_quat!(rot, tr.rotation());
assert_approx_eq_vec3!(expect_x, tr.x_direction());
assert_approx_eq_vec3!(expect_y, tr.y_direction());
assert_approx_eq_vec3!(expect_z, tr.z_direction());
});
let rot = UnitQuaternion::from_axis_angle(&Vector3::x_axis(), PI / 2.)
* UnitQuaternion::from_axis_angle(&Vector3::y_axis(), 0.)
* UnitQuaternion::from_axis_angle(&Vector3::z_axis(), 0.);
device.rotate(rot);
let expect_x = Vector3::new(0., 0., 1.);
let expect_y = Vector3::new(-1., 0., 0.);
let expect_z = Vector3::new(0., -1., 0.);
device.iter().for_each(|tr| {
assert_approx_eq_vec3!(expect_x, tr.x_direction());
assert_approx_eq_vec3!(expect_y, tr.y_direction());
assert_approx_eq_vec3!(expect_z, tr.z_direction());
});
}
#[test]
fn affine() {
let transducers = itertools::iproduct!((0..18), (0..14))
.enumerate()
.map(|(i, (y, x))| {
LegacyTransducer::new(
i,
10.16 * Vector3::new(x as float, y as float, 0.),
UnitQuaternion::identity(),
)
})
.collect::<Vec<_>>();
let mut device = Device::new(0, transducers);
let t = Vector3::new(40., 50., 60.);
let rot = UnitQuaternion::from_axis_angle(&Vector3::x_axis(), 0.)
* UnitQuaternion::from_axis_angle(&Vector3::y_axis(), 0.)
* UnitQuaternion::from_axis_angle(&Vector3::z_axis(), PI / 2.);
device.affine(t, rot);
let expect_x = Vector3::new(0., 1., 0.);
let expect_y = Vector3::new(-1., 0., 0.);
let expect_z = Vector3::new(0., 0., 1.);
device.iter().for_each(|tr| {
assert_approx_eq_quat!(rot, tr.rotation());
assert_approx_eq_vec3!(expect_x, tr.x_direction());
assert_approx_eq_vec3!(expect_y, tr.y_direction());
assert_approx_eq_vec3!(expect_z, tr.z_direction());
});
itertools::iproduct!((0..18), (0..14))
.map(|(y, x)| 10.16 * Vector3::new(-y as float, x as float, 0.) + t)
.zip(device.iter())
.for_each(|(expect, tr)| {
assert_approx_eq_vec3!(expect, tr.position());
});
}
}