Intel® Integrated Performance Primitives Developer Guide and Reference

ID 790148
Date 11/07/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

ConvBiased

Computes the specified number of elements of the full finite linear convolution of two vectors.

Syntax

IppStatus ippsConvBiased_32f(const Ipp32f* pSrc1, int src1Len, const Ipp32f* pSrc2, int src2Len, Ipp32f* pDst, int dstLen, int bias);

Include Files

ipps.h

Domain Dependencies

Headers: ippcore.h, ippvm.h

Libraries: ippcore.lib, ippvm.lib

Parameters

pSrc1, pSrc2

Pointers to the two vectors to be convolved.

src1Len

Number of elements in the vector pSrc1.

src2Len

Number of elements in the vector pSrc2.

pDst

Pointer to the vector pDst. This vector stores the result of the convolution.

dstLen

Number of elements in the vector pDst.

bias

Parameter that specifes the starting element of the convolution.

Description

This function computes dstLen elements of finite linear convolution of two specified vectors pSrc1 and pSrc2 starting with an element that is specified by the bias. The result is stored in the vector pDst.

Return Values

ippStsNoErr

Indicates no error.

ippStsNullPtrErr

Indicates an error when the pDst or pSrc pointer is NULL.

ippStsSizeErr

Indicates an error when src1Len or src2Len is less than or equal to 0.

Example

The example below shows how to call the function ippsConvBiased.

void func_convbiased() 
{    
    Ipp32f pSrc1[5] = {1.1, -2.0, 3.5, 2.2, 0.0};
    Ipp32f pSrc2[4] = {0.0, 0.2, 2.5, -1.0};
    const int len = 10;
    Ipp32f pDst[len];
    int bias = 1;

    ippsZero_32f(pDst, len);
    ippsConvBiased_32f(pSrc1, 5, &pSrc2[1], 3, pDst, len, bias); 
}

Result:

        pDst -> 0.2  2.3  -4.3  9.2  5.5  0.0  0.0  0.0  0.0  0.0