survDistr: Survival Distribution Container
In survdistr: Survival Distribution Container with Flexible Interpolation Methods
survDistr R Documentation
Survival Distribution Container
Description
survDistr is an R6 specialized container designed for storing
and managing prediction outputs from survival models in single-event settings.
This includes models such as Cox proportional hazards, random survival forests,
and other classical or machine learning-based survival estimators.
The main prediction data type is survival matrix, where
rows represent observations and columns represent time points.
Details
Key design features:
The survival matrix is stored internally and can be accessed using the $data() method.
The $times active field provides the time points corresponding to the matrix columns.
The interpolation method is controlled via the $method active field.
Survival-related quantities (e.g., distribution, density, hazard functions) are
interpolated using the interp() function.
The assert_prob() function validates the input data matrix during construction if
check is set to TRUE.
Use the $filter() method to subset observations in-place by filtering rows of the
stored matrix.
Use trim_dups = TRUE in the constructor to remove flat survival segments (repeated
values across time points) with a pre-specified tolerance (for a more controlled
pre-processing, see trim_duplicates()).
Active bindings
times(numeric)
Numeric vector of time points corresponding to columns of data. Read-only.
method(character(1))
Interpolation method; one of "const_surv" (default), "const_dens" (alias: "linear_surv")
and "const_haz" (alias: "exp_surv").
Methods
Public methods
-
-
-
-
-
-
-
-
-
-
Method new()
Creates a new instance of this R6 class.
Usage
survDistr$new(
x,
times = NULL,
method = "const_surv",
check = TRUE,
trim_dups = FALSE
)
Arguments
x(matrix)
A numeric matrix of survival probabilities (values between 0 and 1).
Column names must correspond to time points if times is NULL.
times(numeric())
Numeric vector of time points for matrix x,
must match the number of columns.
method(character(1))
Interpolation method; one of "const_surv" (default), "const_dens" (alias: "linear_surv")
and "const_haz" (alias: "exp_surv").
check(logical(1))
If TRUE, run input matrix validation checks using assert_prob();
set to FALSE to skip checks (NOT recommended for external use).
trim_dups(logical(1))
If TRUE, removes adjacent duplicate values from the input using trim_duplicates().
This eliminates flat segments in survival curves and improves interpolation efficiency.
Default is FALSE.
Method print()
Displays summary information about a survDistr object, including
the number of observations and time points.
Usage
survDistr$print()
Method data()
Return the stored data matrix.
Usage
survDistr$data(rows = NULL, add_times = TRUE)
Arguments
rows(integer() | logical() | NULL)
Row indices or a logical vector used to filter observations.
Logical vectors must have length equal to the number of observations.
Integer indices must be positive and within range.
If NULL, no filtering is applied.
add_times(logical(1))
If TRUE, attach eval_times to the output.
Returns
(matrix)
Method filter()
Filters observations in-place by subsetting rows of the stored matrix.
Usage
survDistr$filter(rows = NULL)
Arguments
rows(integer() | logical() | NULL)
Row indices or a logical vector used to filter observations.
Logical vectors must have length equal to the number of observations.
Integer indices must be positive and within range.
If NULL, no filtering is applied.
Returns
Invisibly returns the survDistr object itself.
Method survival()
Computes survival probabilities S(t) at the specified time points.
Usage
survDistr$survival(rows = NULL, times = NULL, add_times = TRUE)
Arguments
rows(integer() | logical() | NULL)
Row indices or a logical vector used to filter observations.
Logical vectors must have length equal to the number of observations.
Integer indices must be positive and within range.
If NULL, no filtering is applied.
times(numeric)
New time points at which to interpolate.
Values need to be unique, increasing non-negative numbers.
If NULL, the object's stored time points are used.
add_times(logical(1))
If TRUE, attach eval_times to the output.
Returns
a matrix of survival probabilities (rows = observations, columns = time points).
Method distribution()
Computes the cumulative distribution function F(t) = 1 - S(t) or CDF at the specified time points.
F(t) is the probability that the event has occurred up until time t.
Usage
survDistr$distribution(rows = NULL, times = NULL, add_times = TRUE)
Arguments
rows(integer() | logical() | NULL)
Row indices or a logical vector used to filter observations.
Logical vectors must have length equal to the number of observations.
Integer indices must be positive and within range.
If NULL, no filtering is applied.
times(numeric)
New time points at which to interpolate.
Values need to be unique, increasing non-negative numbers.
If NULL, the object's stored time points are used.
add_times(logical(1))
If TRUE, attach eval_times to the output.
Returns
a matrix of CDF values (rows = observations, columns = time points).
Method density()
Computes the probability density function f(t) or PDF at the specified time points.
f(t) = \frac{d}{dt} F(t) is the probability of the event occurring at the specific
time t.
Usage
survDistr$density(rows = NULL, times = NULL, add_times = TRUE)
Arguments
rows(integer() | logical() | NULL)
Row indices or a logical vector used to filter observations.
Logical vectors must have length equal to the number of observations.
Integer indices must be positive and within range.
If NULL, no filtering is applied.
times(numeric)
New time points at which to interpolate.
Values need to be unique, increasing non-negative numbers.
If NULL, the object's stored time points are used.
add_times(logical(1))
If TRUE, attach eval_times to the output.
Returns
a matrix of PDF values (rows = observations, columns = time points).
Method cumhazard()
Computes the cumulative hazard (accumulated risk up to time t) at the specified time
points as H(t) = -log(S(t)).
Usage
survDistr$cumhazard(rows = NULL, times = NULL, add_times = TRUE, eps = 1e-12)
Arguments
rows(integer() | logical() | NULL)
Row indices or a logical vector used to filter observations.
Logical vectors must have length equal to the number of observations.
Integer indices must be positive and within range.
If NULL, no filtering is applied.
times(numeric)
New time points at which to interpolate.
Values need to be unique, increasing non-negative numbers.
If NULL, the object's stored time points are used.
add_times(logical(1))
If TRUE, attach eval_times to the output.
eps(numeric(1))
Small positive value used to replace extremely low survival probabilities when computing cumulative hazard,
preventing numerical instability in -\log S(t) calculations.
Returns
a matrix of cumulative hazards (rows = observations, columns = time points).
Method hazard()
Computes the hazard h(t) = \frac{f(t)}{S(t)} at the specified time points.
Hazard is the conditional instantaneous event rate at time t given
survival up to time t.
Usage
survDistr$hazard(rows = NULL, times = NULL, add_times = TRUE)
Arguments
rows(integer() | logical() | NULL)
Row indices or a logical vector used to filter observations.
Logical vectors must have length equal to the number of observations.
Integer indices must be positive and within range.
If NULL, no filtering is applied.
times(numeric)
New time points at which to interpolate.
Values need to be unique, increasing non-negative numbers.
If NULL, the object's stored time points are used.
add_times(logical(1))
If TRUE, attach eval_times to the output.
Returns
a matrix of hazard values (rows = observations, columns = time points).
Method clone()
The objects of this class are cloneable with this method.
Usage
survDistr$clone(deep = FALSE)
Arguments
deepWhether to make a deep clone.
Examples
# generate survival matrix
mat = matrix(data = c(1,0.6,0.4,0.8,0.8,0.7), nrow = 2,
ncol = 3, byrow = TRUE)
times = c(12, 34, 42)
x = survDistr$new(mat, times)
x
# stored survival matrix
x$data()
# interpolation method
x$method
# time points
x$times
eval_times = c(10, 30, 42, 50)
# S(t) at given time points (constant interpolation)
x$survival(times = eval_times)
# same but with linear interpolation
x$method = "linear_surv"
x$survival(times = eval_times)
# Cumulative hazard
x$cumhazard(times = eval_times)
# Density
x$density(times = eval_times)
# Hazard
x$hazard(times = eval_times)
survdistr documentation built on April 9, 2026, 5:09 p.m.
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
| survDistr | R Documentation |
Survival Distribution Container
Description
survDistr is an R6 specialized container designed for storing and managing prediction outputs from survival models in single-event settings. This includes models such as Cox proportional hazards, random survival forests, and other classical or machine learning-based survival estimators.
The main prediction data type is survival matrix, where rows represent observations and columns represent time points.
Details
Key design features:
The survival matrix is stored internally and can be accessed using the
$data()method.The
$timesactive field provides the time points corresponding to the matrix columns.The interpolation method is controlled via the
$methodactive field.Survival-related quantities (e.g., distribution, density, hazard functions) are interpolated using the
interp()function.The
assert_prob()function validates the input data matrix during construction ifcheckis set toTRUE.Use the
$filter()method to subset observations in-place by filtering rows of the stored matrix.Use
trim_dups = TRUEin the constructor to remove flat survival segments (repeated values across time points) with a pre-specified tolerance (for a more controlled pre-processing, seetrim_duplicates()).
Active bindings
times(
numeric)
Numeric vector of time points corresponding to columns ofdata. Read-only.method(
character(1))
Interpolation method; one of"const_surv"(default),"const_dens"(alias:"linear_surv") and"const_haz"(alias:"exp_surv").
Methods
Public methods
Method new()
Creates a new instance of this R6 class.
Usage
survDistr$new( x, times = NULL, method = "const_surv", check = TRUE, trim_dups = FALSE )
Arguments
x(
matrix)
A numeric matrix of survival probabilities (values between 0 and 1). Column names must correspond to time points iftimesisNULL.times(
numeric())
Numeric vector of time points for matrixx, must match the number of columns.method(
character(1))
Interpolation method; one of"const_surv"(default),"const_dens"(alias:"linear_surv") and"const_haz"(alias:"exp_surv").check(
logical(1))
IfTRUE, run input matrix validation checks usingassert_prob(); set toFALSEto skip checks (NOT recommended for external use).trim_dups(
logical(1))
IfTRUE, removes adjacent duplicate values from the input usingtrim_duplicates(). This eliminates flat segments in survival curves and improves interpolation efficiency. Default isFALSE.
Method print()
Displays summary information about a survDistr object, including the number of observations and time points.
Usage
survDistr$print()
Method data()
Return the stored data matrix.
Usage
survDistr$data(rows = NULL, add_times = TRUE)
Arguments
rows(
integer()|logical()|NULL)
Row indices or a logical vector used to filter observations. Logical vectors must have length equal to the number of observations. Integer indices must be positive and within range. IfNULL, no filtering is applied.add_times(
logical(1))
IfTRUE, attacheval_timesto the output.
Returns
(matrix)
Method filter()
Filters observations in-place by subsetting rows of the stored matrix.
Usage
survDistr$filter(rows = NULL)
Arguments
rows(
integer()|logical()|NULL)
Row indices or a logical vector used to filter observations. Logical vectors must have length equal to the number of observations. Integer indices must be positive and within range. IfNULL, no filtering is applied.
Returns
Invisibly returns the survDistr object itself.
Method survival()
Computes survival probabilities S(t) at the specified time points.
Usage
survDistr$survival(rows = NULL, times = NULL, add_times = TRUE)
Arguments
rows(
integer()|logical()|NULL)
Row indices or a logical vector used to filter observations. Logical vectors must have length equal to the number of observations. Integer indices must be positive and within range. IfNULL, no filtering is applied.times(
numeric)
New time points at which to interpolate. Values need to be unique, increasing non-negative numbers. IfNULL, the object's stored time points are used.add_times(
logical(1))
IfTRUE, attacheval_timesto the output.
Returns
a matrix of survival probabilities (rows = observations, columns = time points).
Method distribution()
Computes the cumulative distribution function F(t) = 1 - S(t) or CDF at the specified time points.
F(t) is the probability that the event has occurred up until time t.
Usage
survDistr$distribution(rows = NULL, times = NULL, add_times = TRUE)
Arguments
rows(
integer()|logical()|NULL)
Row indices or a logical vector used to filter observations. Logical vectors must have length equal to the number of observations. Integer indices must be positive and within range. IfNULL, no filtering is applied.times(
numeric)
New time points at which to interpolate. Values need to be unique, increasing non-negative numbers. IfNULL, the object's stored time points are used.add_times(
logical(1))
IfTRUE, attacheval_timesto the output.
Returns
a matrix of CDF values (rows = observations, columns = time points).
Method density()
Computes the probability density function f(t) or PDF at the specified time points.
f(t) = \frac{d}{dt} F(t) is the probability of the event occurring at the specific
time t.
Usage
survDistr$density(rows = NULL, times = NULL, add_times = TRUE)
Arguments
rows(
integer()|logical()|NULL)
Row indices or a logical vector used to filter observations. Logical vectors must have length equal to the number of observations. Integer indices must be positive and within range. IfNULL, no filtering is applied.times(
numeric)
New time points at which to interpolate. Values need to be unique, increasing non-negative numbers. IfNULL, the object's stored time points are used.add_times(
logical(1))
IfTRUE, attacheval_timesto the output.
Returns
a matrix of PDF values (rows = observations, columns = time points).
Method cumhazard()
Computes the cumulative hazard (accumulated risk up to time t) at the specified time
points as H(t) = -log(S(t)).
Usage
survDistr$cumhazard(rows = NULL, times = NULL, add_times = TRUE, eps = 1e-12)
Arguments
rows(
integer()|logical()|NULL)
Row indices or a logical vector used to filter observations. Logical vectors must have length equal to the number of observations. Integer indices must be positive and within range. IfNULL, no filtering is applied.times(
numeric)
New time points at which to interpolate. Values need to be unique, increasing non-negative numbers. IfNULL, the object's stored time points are used.add_times(
logical(1))
IfTRUE, attacheval_timesto the output.eps(
numeric(1))
Small positive value used to replace extremely low survival probabilities when computing cumulative hazard, preventing numerical instability in-\log S(t)calculations.
Returns
a matrix of cumulative hazards (rows = observations, columns = time points).
Method hazard()
Computes the hazard h(t) = \frac{f(t)}{S(t)} at the specified time points.
Hazard is the conditional instantaneous event rate at time t given
survival up to time t.
Usage
survDistr$hazard(rows = NULL, times = NULL, add_times = TRUE)
Arguments
rows(
integer()|logical()|NULL)
Row indices or a logical vector used to filter observations. Logical vectors must have length equal to the number of observations. Integer indices must be positive and within range. IfNULL, no filtering is applied.times(
numeric)
New time points at which to interpolate. Values need to be unique, increasing non-negative numbers. IfNULL, the object's stored time points are used.add_times(
logical(1))
IfTRUE, attacheval_timesto the output.
Returns
a matrix of hazard values (rows = observations, columns = time points).
Method clone()
The objects of this class are cloneable with this method.
Usage
survDistr$clone(deep = FALSE)
Arguments
deepWhether to make a deep clone.
Examples
# generate survival matrix
mat = matrix(data = c(1,0.6,0.4,0.8,0.8,0.7), nrow = 2,
ncol = 3, byrow = TRUE)
times = c(12, 34, 42)
x = survDistr$new(mat, times)
x
# stored survival matrix
x$data()
# interpolation method
x$method
# time points
x$times
eval_times = c(10, 30, 42, 50)
# S(t) at given time points (constant interpolation)
x$survival(times = eval_times)
# same but with linear interpolation
x$method = "linear_surv"
x$survival(times = eval_times)
# Cumulative hazard
x$cumhazard(times = eval_times)
# Density
x$density(times = eval_times)
# Hazard
x$hazard(times = eval_times)
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
Embedding an R snippet on your website
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.