2.1.24.9.1 ocmath_kaplan_meier_surviv_fn


Description

Survival Analysis function used to compute the Kaplan-Meier Estimate of survival probalities for a sample of failure times. This is an OriginPro only function.

Syntax

int ocmath_kaplan_meier_surviv_fn( const double * pTime, uint nTime, const double * pCensor, uint nCensor, const double * pCensored, uint nCensoredVal, const double dConLevel, SAEstim * psSurvivEstim, uint nSizeSAEstm, SAQuantEst * psSAQuantEstim, uint nSizeQuanEstm, SASummary * stSASumStats, SAMeanEst * pSAMeanEst = NULL )

Parameters

pTime
[input] pointer to time values
nTime
[input] size of time values.
pCensor
[input] pointer to censor values
nCensor
[input] size of censor values
pCensored
[input] pointer to Censored value. Please make sure that value of pCensored are all in pCensor and value are unduplicated.
nCensoredVal
[input] size of censored values, which needs to be less than 20
dConLevel
[input] confidence level
psSurvivEstim
[output] structure containing the Survival Analysis of time
nSizeSAEstm
[input] size (number of structure) of psSurvivEstim. it should not be less than size of vTime
psSAQuantEstim
[output] structure containing Quartile estimates
nSizeQuanEstm
[input] size (number of structure) of psSAQuantEstim. It should not be less than 3.
stSASumStats
[output] pointer to structure containing summary of event and censored values
pSAMeanEst
[output] pointer to structure constaining mean estimates

Return

Returns STATS_NO_ERROR on successful exit or an STATS error code on failure.

Examples

EX1

void ocmath_kaplan_meier_surviv_fn_ex1()
{
    vector vTime = { 107,90,169,50,954,972,6,111,70,90,930,52,50,414,111,482,104,29,983,93,133,468,65,846 };
    vector pCensor = { 0,1,0,1,0,0,1,1,0,2,0,0,0,2,0,1,0,1,1,0,2,0,0,1 };
    vector pCensored = {0, 2};
    int nCensoredVal = pCensored.GetSize();
    double dConLevel = 0.90;
    
    SAEstim psSurvivEstim[24];
    SAQuantEst psSAQuantEstim[3];
    SASummary stSASumStats;
    SAMeanEst pSAMeanEst;

    int nRet = ocmath_kaplan_meier_surviv_fn(vTime, vTime.GetSize(), pCensor, pCensor.GetSize(), pCensored, nCensoredVal, dConLevel, psSurvivEstim, 24, psSAQuantEstim, 3, &stSASumStats);
}

Remark

See Also

Header to Included

origin.h

Reference