2.1.24.4.25 ocmath_frequency_count


Description

Function to calculate frequency count

Syntax

int ocmath_frequency_count( double * pSource, UINT nSourceSize, FreqCountOptions * fcoOptions, double * pBinCenters, UINT nBinCenterSize, double * pAbsoluteCounts, UINT nAbsoluteCountSize, double * pCumulativeCounts = NULL, UINT nCumulativeCountSize = 0, int nOption = FC_STEPSIZE, double * pBin = NULL, UINT nBinSize = 0 )

Parameters

pSource
[input] pointer to an array containing input data
nSourceSize
[input] size of an array containing input data
fcoOptions
[input] pointer to the sturcture that containing FromMin, ToMax, StepSize, IncludeLTMin, IncludeGEMax. Please see stats_types.h for more detail.
pBinCenters
[output] pointer to an array containing all Bin Centers
nBinCenterSize
[input] size of an array containing all Bin Centers
pAbsoluteCounts
[output] pinter to all absolute counts in each interval
nAbsoluteCountSize
[input] size of Absolute Count
pCumulativeCounts
[output] pointer to Cumulative Counts for each interval
nCumulativeCountSize
[input] size of Cumulative Counts for each interval
nOption
[input] Define for the Boundary type of frequency counts
FC_STEPSIZE(default) uses step size to determine bins
FC_NUMINTERVALS uses number of intervals to determine bins
pBin
[input] pointer to an array containing all input Bin
nBinSize
[input] size of an array containing all input Bin

Return

Returns STATS_NO_ERROR on successful exit and a non-zero STATS error code on failure.

Examples

EX1

void ocmath_frequency_count_ex1()
{
    UINT nSourceSize = 5;   //Set the DataSize to 5        
    vector vSource;
    vSource.Data(1, nSourceSize, 1);            
    
    FreqCountOptions fcoOptions;    
    fcoOptions.FromMin = 0;
    fcoOptions.ToMax = 7;
    fcoOptions.StepSize = 7;
    fcoOptions.IncludeLTMin = 0;
    fcoOptions.IncludeGEMax = 0;
    
    vector    vBinCenters, vAbsoluteCounts, vCumulativeCounts, vBinCentersChk, vAbsoluteCountsChk, vCumulativeCountsChk;
    UINT nBinCenterSize = fcoOptions.StepSize;
    vBinCenters.SetSize(nBinCenterSize);
    
    UINT nAbsoluteCountSize = fcoOptions.StepSize;
    vAbsoluteCounts.SetSize(nAbsoluteCountSize);
    
    UINT nCumulativeCountSize = fcoOptions.StepSize;
    vCumulativeCounts.SetSize(nCumulativeCountSize);
    
    int nRet;   
    int nOption = FC_NUMINTERVALS;
    nRet = ocmath_frequency_count(vSource, nSourceSize, &fcoOptions, vBinCenters, nBinCenterSize, vAbsoluteCounts, nAbsoluteCountSize, vCumulativeCounts, nCumulativeCountSize, nOption);
}

Remark

See Also

Header to Included

origin.h

Reference