gwrs 0.1.3

A Rust library for studying data from ground-based gravitational-wave detectors.
Documentation
use crate::detector::channel::Channel;
use astronomy::time::Time;
use astronomy::units::{Quantity, QuantityError, Unit, UnitProduct};
use ndarray::Array1;

#[derive(Debug, Clone, PartialEq)]
pub struct GWArray {
    pub quantity: Quantity,
    pub name: Option<String>,
    pub epoch: Option<Time>,
    pub channel: Option<Channel>,
}

impl GWArray {
    pub fn new(
        value: Array1<f64>,
        unit: Option<Unit>,
        name: Option<String>,
        epoch: Option<Time>,
        channel: Option<Channel>,
    ) -> Self {
        let actual_unit = unit.unwrap_or_else(|| Unit {
            name: "",
            scale: 1.0,
            dimensions: UnitProduct::from_components(&[]),
        });
        GWArray {
            quantity: Quantity::new(value, actual_unit),
            name,
            epoch,
            channel,
        }
    }

    pub fn value(&self) -> &Array1<f64> {
        &self.quantity.value
    }

    pub fn unit(&self) -> &Unit {
        &self.quantity.unit
    }

    pub fn get_name(&self) -> Option<&str> {
        self.name.as_deref()
    }

    pub fn get_epoch(&self) -> Option<Time> {
        self.epoch
    }

    pub fn get_channel(&self) -> Option<&Channel> {
        self.channel.as_ref()
    }

    pub fn to(&self, target_unit: &Unit) -> Result<Self, QuantityError> {
        let converted_quantity = self.quantity.to(target_unit)?;
        Ok(GWArray::new(
            converted_quantity.value,
            Some(converted_quantity.unit),
            self.name.clone(),
            self.epoch,
            self.channel.clone(),
        ))
    }
}

use std::ops::{Add, Div, Mul, Sub};

impl Add for GWArray {
    type Output = Result<Self, QuantityError>;
    fn add(self, rhs: Self) -> Self::Output {
        let added_quantity = (self.quantity + rhs.quantity)?;
        Ok(GWArray::new(
            added_quantity.value,
            Some(added_quantity.unit),
            self.name.clone(),
            self.epoch,
            self.channel.clone(),
        ))
    }
}

impl Sub for GWArray {
    type Output = Result<Self, QuantityError>;
    fn sub(self, rhs: Self) -> Self::Output {
        let subtracted_quantity = (self.quantity - rhs.quantity)?;
        Ok(GWArray::new(
            subtracted_quantity.value,
            Some(subtracted_quantity.unit),
            self.name.clone(),
            self.epoch,
            self.channel.clone(),
        ))
    }
}
impl Mul for GWArray {
    type Output = Result<Self, QuantityError>;
    fn mul(self, rhs: Self) -> Self::Output {
        let multiplied_quantity = self.quantity * rhs.quantity;
        Ok(GWArray::new(
            multiplied_quantity.value,
            Some(multiplied_quantity.unit),
            self.name.clone(),
            self.epoch,
            self.channel.clone(),
        ))
    }
}
impl Div for GWArray {
    type Output = Result<Self, QuantityError>;
    fn div(self, rhs: Self) -> Self::Output {
        let divided_quantity = (self.quantity / rhs.quantity)?;
        Ok(GWArray::new(
            divided_quantity.value,
            Some(divided_quantity.unit),
            self.name.clone(),
            self.epoch,
            self.channel.clone(),
        ))
    }
}

// Some tests
#[cfg(test)]
mod tests {
    use super::*;
    use astronomy::units::{CENTIMETRE, METRE, SECOND};
    use ndarray::array;

    #[test]
    fn test_gwarray_creation() {
        let value = array![1.0, 2.0, 3.0];
        let gw_array = GWArray::new(
            value,
            Some(METRE),
            Some("Test Array".to_string()),
            None,
            None,
        );
        assert_eq!(gw_array.value(), &array![1.0, 2.0, 3.0]);
        assert_eq!(gw_array.unit(), &METRE);
        assert_eq!(gw_array.name, Some("Test Array".to_string()));
    }

    #[test]
    fn test_gwarray_creation_and_name() {
        let gw_array = GWArray::new(
            array![1.0, 2.0, 3.0],
            Some(METRE.clone()),
            Some("Test Array".to_string()),
            None,
            None,
        );
        assert_eq!(gw_array.name, Some("Test Array".to_string()));
        assert_eq!(gw_array.unit(), &METRE);
        assert_eq!(gw_array.value(), &array![1.0, 2.0, 3.0]);
    }

    #[test]
    fn test_gw_array_to_method() {
        let gw_array = GWArray::new(
            array![1.0, 2.0, 3.0],
            Some(METRE.clone()),
            Some("Test Array".to_string()),
            None,
            None,
        );
        let converted_array = gw_array.to(&CENTIMETRE).unwrap();

        assert_eq!(converted_array.value(), &array![100.0, 200.0, 300.0]);
        assert_eq!(converted_array.unit(), &CENTIMETRE);
        assert_eq!(converted_array.name, Some("Test Array".to_string()));
    }

    #[test]
    fn test_gw_array_addition() {
        let gw_array1 = GWArray::new(array![1.0, 2.0, 3.0], Some(METRE.clone()), None, None, None);
        let gw_array2 = GWArray::new(array![4.0, 5.0, 6.0], Some(METRE.clone()), None, None, None);
        let result = gw_array1 + gw_array2;

        assert!(result.is_ok());
        let added_array = result.unwrap();
        assert_eq!(added_array.value(), &array![5.0, 7.0, 9.0]);
        assert_eq!(added_array.unit(), &METRE);
    }

    #[test]
    fn test_gw_array_addition_with_different_units_same_dimension() {
        let gw_array1 = GWArray::new(array![1.0, 2.0, 3.0], Some(METRE.clone()), None, None, None);
        let gw_array2 = GWArray::new(
            array![100.0, 200.0, 300.0],
            Some(CENTIMETRE.clone()),
            None,
            None,
            None,
        );
        let result = gw_array1 + gw_array2;

        assert!(result.is_err());
        if let Err(QuantityError::IncompatibleAddition { lhs, rhs }) = result {
            assert_eq!(lhs, "m");
            assert_eq!(rhs, "cm");
        } else {
            panic!("Expected incompatible addition error");
        }
    }

    #[test]
    fn test_gw_array_addition_with_different_units_different_dimension() {
        let gw_array1 = GWArray::new(array![1.0, 2.0, 3.0], Some(METRE.clone()), None, None, None);
        let gw_array2 = GWArray::new(
            array![100.0, 200.0, 300.0],
            Some(SECOND.clone()),
            None,
            None,
            None,
        );
        let result = gw_array1 + gw_array2;

        assert!(result.is_err());
        if let Err(QuantityError::IncompatibleAddition { lhs, rhs }) = result {
            assert_eq!(lhs, "m");
            assert_eq!(rhs, "s");
        } else {
            panic!("Expected incompatible addition error");
        }
    }
}