<!--
{
  "availability" : [
    "*: -",
    "iOS: 16.0.0 -",
    "iPadOS: 16.0.0 -",
    "macCatalyst: -",
    "macOS: 13.0.0 -",
    "tvOS: 16.0.0 -",
    "visionOS: -",
    "watchOS: 9.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Accelerate",
  "identifier" : "/documentation/Accelerate/BNNS/scatter(input:indices:output:axis:reductionFunction:filterParameters:)",
  "metadataVersion" : "0.1.0",
  "role" : "Type Method",
  "symbol" : {
    "kind" : "Type Method",
    "modules" : [
      "Accelerate"
    ],
    "preciseIdentifier" : "s:10Accelerate4BNNSO7scatter5input7indices6output4axis17reductionFunction16filterParametersySo21BNNSNDArrayDescriptora_A2LSiAC09ReductionI0OSo010BNNSFilterK0aSgtKFZ"
  },
  "title" : "scatter(input:indices:output:axis:reductionFunction:filterParameters:)"
}
-->

# scatter(input:indices:output:axis:reductionFunction:filterParameters:)

Scatters the elements of a tensor along a single axis.

```
static func scatter(input: BNNSNDArrayDescriptor, indices: BNNSNDArrayDescriptor, output: BNNSNDArrayDescriptor, axis: Int, reductionFunction: BNNS.ReductionFunction, filterParameters: BNNSFilterParameters? = nil) throws
```

## Parameters

`input`

The input descriptor.

`indices`

The indices descriptor.

`output`

The output descriptor.

`axis`

The axis along which the operation scatters elements.

`reductionFunction`

The reduction operation that the function uses to reduce existing output value with scattered value.

`filterParameters`

The runtime filter parameters.

## See Also

[`func BNNSScatter(Int, BNNSReduceFunction, UnsafePointer<BNNSNDArrayDescriptor>, UnsafePointer<BNNSNDArrayDescriptor>, UnsafeMutablePointer<BNNSNDArrayDescriptor>, UnsafePointer<BNNSFilterParameters>?) -> Int32`](/documentation/Accelerate/BNNSScatter(_:_:_:_:_:_:))

Scatters the elements of a tensor along a single axis.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)