PAL 3D Arrays: Complex Operations

Initialization and copying helpers for three-dimensional complex arrays.

PAL 3D Arrays: Complex Operations — 4 functions

KiratPalCopy3D­Complex

Signature
void KiratPalCopy3DComplex( T_COMPLEX** const* pppcSource, T_COMPLEX*** pppcDestination, T_INT iSizeDim1, T_INT iSizeDim2, T_INT iSizeDim3);
Description
Copies the specified data or subrange to the destination.
Mathematical operation
\(D_{\mathbf i}\leftarrow S_{\mathbf i}\) element-wise (with type conversion where indicated by the function name).
Supported implementations
  • ANSI C - portable reference implementation
  • Intel/AMD processors - Intel IPP library support

KiratPalSet3D­ComplexToFloat

Signature
void KiratPalSet3DComplexToFloat( T_COMPLEX*** pppcDestination, T_INT iSizeDim1, T_INT iSizeDim2, T_INT iSizeDim3, T_FLOAT fValue);
Description
Sets real components/elements from Float values; complex imaginary components are handled according to the implementation.
Mathematical operation
\(z_{\mathbf i}\leftarrow a+j0\).
Supported implementations
  • ANSI C - portable reference implementation

KiratPalSet3D­ComplexToZero

Signature
void KiratPalSet3DComplexToZero( T_COMPLEX*** pppcDestination, T_INT iSizeDim1, T_INT iSizeDim2, T_INT iSizeDim3);
Description
Sets all elements of the array to zero.
Mathematical operation
\(d_{\mathbf i}\leftarrow0\) for every array index \(\mathbf i\).
Supported implementations
  • ANSI C - portable reference implementation

KiratPalSet3D­ComplexToZero­OrFillWithLow­PowerNoise

Signature
void KiratPalSet3DComplexToZeroOrFillWithLowPowerNoise( T_COMPLEX*** pppcDestination, T_INT iSizeDim1, T_INT iSizeDim2, T_INT iSizeDim3);
Description
Sets the array to zero or, depending on the configuration, fills it with very low-level noise to avoid numerical corner cases.
Mathematical operation
Current 1-D complex default path uses \(z_i=10^{-10}u_i+j10^{-10}v_i\) with \(u_i,v_i\approx\mathcal U[-1,1)\); higher-dimensional complex variants call this row-wise. (The 1-D local mode is currently set to noise.)
Supported implementations
  • ANSI C - portable reference implementation