---
title: "gathering(atIndices:)"
framework: coreml
role: symbol
role_heading: Instance Method
path: "coreml/mltensor/gathering(atindices:)"
---

# gathering(atIndices:)

Returns a tensor by gathering slices at the specified indices.

## Declaration

```swift
func gathering(atIndices indices: MLTensor) -> MLTensor
```

## Parameters

- `indices`: A 32-bit integer tensor containing indices to gather at.

## Return Value

Return Value The gathered tensor.

## Discussion

Discussion The indices tensor is interpreted as a (rank-1) dimensional set of one-dimensional lookup vectors, for example: let x = MLTensor(shape: [2, 2], scalars: [     0,  1,     10, 11 ], scalarType: Float.self) let i = MLTensor(shape: [2, 2], scalars: [     0, 0,     1, 1 ], scalarType: Int32.self) let y = x.gathering(atIndices: i) // [ 0, 11] If the one-dimensional lookup vectors do not give a full set of indices, the remaining indices are treated as a slice, for example: let x = MLTensor(shape: [3, 3], scalars: [     0,  1,  2,     10, 11, 12,     20, 21, 22 ], scalarType: Float.self) let i = MLTensor(shape: [3, 1], scalars: [     2,     1 ], scalarType: Int32.self) let y = x.gathering(atIndices: i) // [[20 21 22] //  [10 11 12]]

## See Also

### Gathering slices

- [gathering(atIndices:alongAxis:)](coreml/mltensor/gathering(atindices:alongaxis:).md)