Visible to Intel only — GUID: GUID-13EFA46A-34C2-4906-BDBA-4965753C1B37
Visible to Intel only — GUID: GUID-13EFA46A-34C2-4906-BDBA-4965753C1B37
CdfNorm
Computes the cumulative normal distribution function values of vector element.
Syntax
IppStatus ippsCdfNorm_32f_A11 (const Ipp32f* pSrc, Ipp32f* pDst, Ipp32s len);
IppStatus ippsCdfNorm_32f_A21 (const Ipp32f* pSrc, Ipp32f* pDst, Ipp32s len);
IppStatus ippsCdfNorm_32f_A24 (const Ipp32f* pSrc, Ipp32f* pDst, Ipp32s len);
IppStatus ippsCdfNorm_64f_A26 (const Ipp64f* pSrc, Ipp64f* pDst, Ipp32s len);
IppStatus ippsCdfNorm_64f_A50 (const Ipp64f* pSrc, Ipp64f* pDst, Ipp32s len);
IppStatus ippsCdfNorm_64f_A53 (const Ipp64f* pSrc, Ipp64f* pDst, Ipp32s len);
Include Files
ippvm.h
Domain Dependencies
Headers: ippcore.h
Libraries: ippcore.lib
Parameters
pSrc |
Pointer to the source vector. |
pDst |
Pointer to the destination vector. |
len |
Number of elements in the vectors. |
Description
This function computes the cumulative normal distribution function values of pSrc element and stores the result in the corresponding element of pDst.
For single precision data:
function flavor ippsCdfNorm_32f_A11 guarantees 11 correctly rounded bits of significand, or at least 3 exact decimal digits;
function flavor ippsCdfNorm_32f_A21 guarantees 21 correctly rounded bits of significand, or 4 ulps, or about 6 exact decimal digits;
function flavor ippsCdfNorm_32f_A24 guarantees 24 correctly rounded bits of significand, including the implied bit, with the maximum guaranteed error within 1 ulp.
For double precision data:
function flavor ippsCdfNorm_64f_A26 guarantees 26 correctly rounded bits of significand, or 6.7E+7 ulps, or approximately 8 exact decimal digits;
function flavor ippsCdfNorm_64f_A50 guarantees 50 correctly rounded bits of significand, or 4 ulps, or approximately 15 exact decimal digits;
function flavor ippsCdfNorm_64f_A53 guarantees 53 correctly rounded bits of significand, including the implied bit, with the maximum guaranteed error within 1 ulp.
The computation is performed as follows:
pDst[n] = CdfNorm(pSrc[n]), 0 ≤ n < len, where
The example below shows how to use the function ippsCdfNorm.
Return Values
ippStsNoErr |
Indicates no error. |
ippStsNullPtrErr |
Indicates an error when pSrc or pDst pointer is NULL. |
ippStsSizeErr |
Indicates an error when len is less than or equal to 0. |
IppStsUnderflow |
Indicates a warning that the function underflows, that is, at least one element of pSrc is less than some threshold value, where the function result is less than the minimum positive floating-point value in the target precision. |
Using ippsCdfNorm Function
IppStatus ippsCdfNorm_32f_A24_sample(void)
{
const Ipp32f x[4] = {+4.885, -0.543, -3.809, -4.953};
Ipp32f y[4];
IppStatus st = ippsCdfNorm_32f_A24( x, y, 4 );
printf(" ippsCdfNorm_32f_A24:\n");
printf(" x = %+.3f %+.3f %+.3f %+.3f \n", x[0], x[1], x[2], x[3]);
printf(" y = %+.3f %+.3f %+.3f %+.3f \n", y[0], y[1], y[2], y[3]);
return st;
}
Output results:
ippsCdfNorm_32f_A24:
x = +4.885 -0.543 -3.809 -4.953
y = +1.000 +0.294 +0.000 +0.000