Hartley

Syntax

IppStatus ippgHartley_32f(const Ipp32f* pSrc, Ipp32f* pDst, int len, int flag);

IppStatus ippgHartley_64f(const Ipp64f* pSrc, Ipp64f* pDst, int len, int flag);

IppStatus ippgHartley_<len>_32f(const Ipp32f* pSrc, Ipp32f* pDst, int flag);

IppStatus ippgHartley_<len>_32f(const Ipp64f* pSrc, Ipp64f* pDst, int flag);

supported value for <len>: integer in the range [2, 64].

Parameters

pSrc	Pointer to the input array.
pDst	Pointer to the output array.
flag	Specifies the result normalization method. The values for the flag argument are described in the section Flag and Hint Arguments.
len	Length of the DFT transform in range [2, 64].

Description

The function ippgHartley is declared in the ipps.h and ippgen.h files respectively .

The function computes the discrete Hartley transform (DHT) of the fixed length of a real signal. The length of transform can be specified by the parameter len, or by choosing the function flavor designed for the specific length of transform and containing its value in the function name, for example, the function flavor ippgHartley_11_32f performs the DHT with length 11. Intel IPP support functions for DHT with fixed length in the range [2, 64].

Caution

Data vectors for these functions must be aligned to an appropriate number of bytes that is determined by the SIMD width that is supported by the customer's platform - use ippMalloc function for such alignment.

Optimization Notice
Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice. Notice revision #20110804

Optimization Notice

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804

To avoid listing all the similar prototypes of function flavors of this type, only templates are given here. In the template the length of DHT is denoted by the modifier <len> and can be varied in the range of integers [2, 64].

The normalization method of the result is specified by the parameter flag.

The DHT functionality can be described as follows:

where k is the index of elements in the frequency domain, n is the index of elements in the time domain, N is the input signal len, and A is a multiplier defined by flag. Also, x(n) is pSrc[n] and X(k) is pDst[k].

The DHT is an involutary transform and the same function can be used both for forward and inverse transforms.

Return Values

ippStsNoErr	Indicates no error.
ippStsNullPtrErr	Indicates an error when one of the specified pointers is NULL.
ippStsFftFlagErr	Indicates an error when the flag value is incorrect.