<!--
{
  "availability" : [
    "iOS: 13.0.0 -",
    "iPadOS: 13.0.0 -",
    "macCatalyst: -",
    "macOS: 10.15.0 -",
    "tvOS: 13.0.0 -",
    "visionOS: -",
    "watchOS: 6.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Accelerate",
  "identifier" : "/documentation/Accelerate/vDSP/stereoRamp(withInitialValue:multiplyingBy:_:increment:)-18f8z",
  "metadataVersion" : "0.1.0",
  "role" : "Type Method",
  "symbol" : {
    "kind" : "Type Method",
    "modules" : [
      "Accelerate"
    ],
    "preciseIdentifier" : "s:10Accelerate4vDSPO10stereoRamp16withInitialValue13multiplyingBy_9incrementSaySfG11firstOutput_AH06secondL0tSfz_xxSftAA0A6BufferRzSf7ElementRtzlFZ"
  },
  "title" : "stereoRamp(withInitialValue:multiplyingBy:_:increment:)"
}
-->

# stereoRamp(withInitialValue:multiplyingBy:_:increment:)

Returns two single-precision vectors that contain stereo monotonically incrementing or decrementing values multiplied by two source vectors.

```
static func stereoRamp<U>(withInitialValue initialValue: inout Float, multiplyingBy multiplierOne: U, _ multiplierTwo: U, increment: Float) -> (firstOutput: [Float], secondOutput: [Float]) where U : AccelerateBuffer, U.Element == Float
```

## Parameters

`initialValue`

The initial value of the ramp.

`multiplierOne`

The first input vector that’s multiplied by the ramp function.

`multiplierTwo`

The second input vector that’s multiplied by the ramp function.

`increment`

The increment, or decrement if negative, between each generated element.

## Discussion

Use this function to create two vectors by multiplying the values in two input vectors with the corresponding values of a ramp.

For example, the following code fills the arrays `multiplierOne` and `multiplierTwo` with sine values:

```swift
let n = vDSP_Length(1024)

let multiplierOne: [Float] = (0 ..< n).map {
    return sin(Float($0) / 20) * 2
}

let multiplierTwo: [Float] = (0 ..< n).map {
    return sin(Float($0) / 40)
}
```

The following figure illustrates the values of `multiplierOne`, as a solid line, and `multiplierTwo`, as a dashed line:

![A graphic shows two sine waves. The first sine wave appears as a solid line and the second sine wave appears as a dashed line. The first sine wave has a higher freqency and a higher amplitude than the second sine wave. ](images/com.apple.accelerate/media-3732292@2x.png)

Pass `multiplierOne` and `multiplierTwo` as the `multiplyingBy` parameter of [`stereoRamp(withInitialValue:multiplyingBy:_:increment:)`](/documentation/Accelerate/vDSP/stereoRamp(withInitialValue:multiplyingBy:_:increment:)-18f8z):

```swift
var start: Float = 0
let step: Float = 0.1

let results = vDSP.stereoRamp(withInitialValue: &start,
                              multiplyingBy: multiplierOne, multiplierTwo,
                              increment: step)
```

On return, the output vectors, `results.firstOutput` and `results.secondOutput`, contain ramped-sine waves. The figure below shows the first output as a solid line and the second output as a dashed line:

![A graphic shows two sine waves. The first sine wave appears as a solid line and the second sine wave appears as a dashed line. The first sine wave and has a higher freqency and a higher amplitude than the second sine wave.  Both sine waves are tapered, that is, they begin on the left with a very low amplitude and their amplitudes ramp up towards the right of the image.](images/com.apple.accelerate/media-3732287@2x.png)

---

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)