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

# gathering(atIndices:alongAxis:)

Returns a tensor by gathering slices along the given axis at the specified indices.

## Declaration

```swift
func gathering(atIndices indices: MLTensor, alongAxis axis: Int) -> MLTensor
```

## Parameters

- `indices`: A 32-bit integer tensor containing indices to gather at.
- `axis`: The dimension to gather along. Must be in the range [-rank, rank).

## Return Value

Return Value The gathered tensor.

## Discussion

Discussion For example: let x = MLTensor(shape: [3, 3], scalars: [      0,  1,  2,     10, 11, 12,     20, 21, 22 ], scalarType: Float.self) let i = MLTensor([2, 1], scalarType: Int32.self) let y0 = x.gathering(atIndices: i) // [[20, 21, 22], //  [10, 11, 12]]

let y1 = x.gathering(atIndices: i, alongAxis: 1) // [[ 2,  1], //  [12, 11], //  [22, 21]]

## See Also

### Gathering slices

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