burn_tensor/tensor/api/
take.rs

1use crate::{
2    AsIndex, Int, Tensor, check, check::TensorCheck, check::unwrap_dim_index, kind::Basic,
3};
4use alloc::vec::Vec;
5
6impl<const D: usize, K> Tensor<D, K>
7where
8    K: Basic,
9{
10    /// Takes elements from the tensor along the given dimension using indices of any dimensionality.
11    ///
12    /// This behaves like numpy's take function. When indices is multi-dimensional,
13    /// the output shape will be: input.shape\[:dim\] + indices.shape + input.shape\[dim+1:\]
14    ///
15    /// # Arguments
16    ///
17    /// * `dim` - The dimension along which to select elements. Supports negative indexing.
18    /// * `indices` - The indices of elements to select. Can be any dimensionality.
19    ///   Must be valid indices in the range [0, dim_size).
20    ///
21    /// # Example
22    ///
23    /// ```rust
24    /// use burn_tensor::{Tensor, Int};
25    ///
26    /// fn example() {
27    ///   let device = Default::default();
28    ///
29    ///   // Example with 1D indices
30    ///   let tensor = Tensor::<2>::from_data([[1.0, 2.0, 3.0], [4.0, 5.0, 6.0]], &device);
31    ///   let indices = Tensor::<1, Int>::from_data([2, 0, 1], &device);
32    ///   let result: Tensor<2> = tensor.clone().take::<1, 2>(-1, indices);  // -1 refers to last dimension
33    ///   println!("{result}");
34    ///   // [[3.0, 1.0, 2.0], [6.0, 4.0, 5.0]]
35    ///
36    ///   // Example with 2D indices - output will have +1 dimension (2D -> 3D)
37    ///   let indices_2d = Tensor::<2, Int>::from_data([[0, 2], [1, 0]], &device);
38    ///   let result: Tensor<3> = tensor.take::<2, 3>(1, indices_2d);
39    ///   println!("{result}");
40    ///   // [[[1.0, 3.0], [2.0, 1.0]], [[4.0, 6.0], [5.0, 4.0]]]
41    /// }
42    /// ```
43    pub fn take<const DI: usize, const DO: usize>(
44        self,
45        dim: impl AsIndex,
46        indices: Tensor<DI, Int>,
47    ) -> Tensor<DO, K> {
48        let dim = unwrap_dim_index(dim.try_dim_index(D), "Take");
49        check!(TensorCheck::take::<D, DI, DO>());
50
51        // Store the indices shape for reshaping later
52        let indices_shape = indices.shape();
53        let indices_dims = indices_shape.clone();
54
55        // Flatten indices to 1D for processing
56        let indices_flat = indices.reshape([indices_shape.num_elements()]);
57
58        // Perform the selection with the flattened indices
59        let selected = self.select(dim, indices_flat);
60
61        // Build the output shape
62        // Output shape = input.shape[:dim] + indices.shape + input.shape[dim+1:]
63        let selected_shape = selected.shape();
64        let mut new_shape = Vec::with_capacity(DO);
65
66        // Add dimensions before the selected dimension
67        for i in 0..dim {
68            new_shape.push(selected_shape[i]);
69        }
70
71        // Add all indices dimensions
72        for &idx_dim in indices_dims.iter() {
73            new_shape.push(idx_dim);
74        }
75
76        // Add dimensions after the selected dimension
77        for i in (dim + 1)..D {
78            new_shape.push(selected_shape[i]);
79        }
80
81        // Verify we have the correct number of dimensions
82        assert_eq!(
83            new_shape.len(),
84            DO,
85            "Internal error: shape calculation resulted in {} dims but expected {}",
86            new_shape.len(),
87            DO
88        );
89
90        // Convert to fixed-size array for reshape
91        let mut shape_array = [0; DO];
92        for (i, &s) in new_shape.iter().enumerate() {
93            shape_array[i] = s;
94        }
95
96        selected.reshape(shape_array)
97    }
98}
burn_tensor/tensor/api/take.rs

burn_tensor/tensor/api/
take.rs
