EventData

EventData[{e1,e2,}]

represents event data with explicitly specified censoring ei.

EventData[{e1,e2,},{ci1,ci2,}]

represents event data ei with censoring indicators cii.

EventData[{e1,e2,},{cc1,cc2,}]

represents event data ei with censoring counts cci.

EventData[{e1,e2,},cspec,{tr1,tr2,}]

represents event data with censoring and truncation tri.

Details

  • EventData augments data with censoring and truncation information.
  • The following event specifications can be used for ei:
  • tino censoring; event happens at tti
    {ti,}right censoring; event happens at some t where tit
    {-,ti}left censoring; event happens at some t where t<ti
    {ti,min,ti,max}interval censoring; event happens at some t where ti,min<tti,max
  • The following censoring indicators can be used for cii:
  • 0, None{t,t}no censoring
    1, Right{t,}right censoring
    -1,Left{-,t}left censoring
  • The following count specifications can be used for cci:
  • { ni}ni events at ei
    {ni,ri}ni events and ri right-censored events at ei
    {ni,ri,li}ni events, ri right-censored events, and li left-censored events at ei
  • The following event specifications can be used for tri:
  • ti,{ti,}left truncation; observable for t>=t_(i)
    {-,ti}right truncation; observable for t<=t_(i)
    {ti,min,ti,max}interval truncation; observable over ti,mintti,max
  • EventData can be used in statistics functions including:
  • Mean,Variance,descriptive statistics functions
    EmpiricalDistribution,nonparametric distribution estimation
    EstimatedDistribution,parametric distribution estimation
    SurvivalModelFit,functions for survival analysis
  • Properties of EventData can be obtained by specifying EventData[]["property"].
  • A list of available properties can be obtained using EventData[]["Properties"].
  • EventData has the following properties:
  • "CensoringIndicators"censoring indicators {ci1,}
    "CensoredData"censored event intervals in the form {{t1,},}
    "EmpiricalPDF"event locations and corresponding estimated weights
    "InputData"input event specification {e1,}
    "MetaInformation"list of meta information rules
    "TruncationIntervals"truncation intervals {tr1,}
    "CensoringType"most general type of censoring present
    "TruncationType"most general type of truncation present

Examples

open allclose all

Basic Examples  (1)

Indicate right-censored data values:

Compute some descriptive statistics:

Scope  (12)

Basic Uses  (5)

Compute descriptive statistics for event data:

Fit nonparametric distributions to event data:

Fit parametric distributions to event data:

Plot the distribution and the empirical estimate:

Fit a model using SurvivalModelFit:

Empirical survival function with confidence bands:

Fit a model with covariates using CoxModelFit:

Parameter estimates:

A comparison of the survival rates for the two groups:

Specifying Censoring and Truncation  (7)

Specify right censoring in a number of ways:

The objects all represent the same four observations where the third is right censored:

Left censoring:

The objects all represent the same four observations where the third is left censored:

Interval censoring:

The object represents four observations where the third is interval censored:

Use the count specifications to indicate multiple equivalent observations:

The objects each represent the same nine observations:

Specify left truncation:

The objects are equivalent representations of left-truncated, non-censored data:

Specify right truncation:

The object represents right-truncated, non-censored data:

Data can be both censored and truncated:

The object represents right-censored, left-truncated data:

Applications  (1)

Mark right censoring on a plot of an estimated survival function:

The estimated survival function:

Create the censoring markers:

Show the censoring markers with the plot of the estimated survival:

Properties & Relations  (1)

Descriptive statistics are based on the underlying SurvivalDistribution:

Sample estimates are given when they differ from population estimates:

Introduced in 2012
 (9.0)