arr-rs 0.6.0

arr-rs - rust arrays library
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
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

use crate::{
    core::prelude::*,
    errors::prelude::*,
    extensions::prelude::*,
};
use crate::prelude::Numeric;

/// `ArrayTrait` - Array Tiling functions
pub trait ArrayTiling<T: ArrayElement> where Self: Sized + Clone {

    /// Repeat each element of an array after themselves
    ///
    /// # Arguments
    ///
    /// * `repeats` - number of repetitions for each element, broadcasted to fit the shape of the given axis
    /// * `axis` - the axis along which to repeat. optional, if None, array is flattened
    ///
    /// # Examples
    /// ```
    /// use arr_rs::prelude::*;
    ///
    /// let arr = Array::<i32>::single(3);
    /// assert_eq!(array![i32, 3, 3, 3, 3], arr.repeat(&vec![4], None));
    ///
    /// let arr = Array::<i32>::new(vec![1, 2, 3, 4], vec![2, 2]);
    /// assert_eq!(array!(i32, [[1, 2], [3, 4], [3, 4]]), arr.repeat(&vec![1, 2], Some(0)));
    /// ```
    ///
    /// # Errors
    ///
    /// may returns `ArrayError`
    fn repeat(&self, repeats: &[usize], axis: Option<usize>) -> Result<Array<T>, ArrayError>;
}

impl <T: ArrayElement> ArrayTiling<T> for Array<T> {

    fn repeat(&self, repeats: &[usize], axis: Option<usize>) -> Result<Self, ArrayError> {
        if let Some(axis) = axis {
            let repeats = repeats.to_vec().to_array()?.broadcast_to(vec![self.get_shape()?[axis]]).get_elements()?;
            let new_axis_len = repeats.clone().into_iter().sum();
            let new_shape = self.get_shape()?.update_at(axis, new_axis_len);
            let tmp_shape = new_shape.clone().swap_ext(0, axis);
            let partial = self.split(self.get_shape()?[axis], Some(axis))?.into_iter()
                .zip(&repeats)
                .flat_map(|(el, &rep)| vec![el; rep])
                .flatten()
                .collect::<Self>();
            partial.reshape(&tmp_shape)
                .moveaxis(vec![0], vec![axis.to_isize()])
                .reshape(&new_shape)
        } else {
            let result = self.get_elements()?.into_iter()
                .zip(&repeats.to_vec().to_array()?.broadcast_to(self.get_shape()?).get_elements()?)
                .flat_map(|(el, &rep)| vec![el; rep])
                .collect();
            Self::flat(result)
        }
    }
}

impl <T: ArrayElement> ArrayTiling<T> for Result<Array<T>, ArrayError> {

    fn repeat(&self, repeats: &[usize], axis: Option<usize>) -> Self {
        self.clone()?.repeat(repeats, axis)
    }
}