hēRo3 includes a wide array of functions for working with survival distributions. These functions can be used to define parametric survival distributions or KaplanMeiers, work with life tables, apply treatment effects, joint curves together, or many other typical survival modelingrelated tasks. A complete listing of these functions and their usage is provided in the table below.
Function 
Description 
Example 
apply_af 
Applies acceleration factor to a survival distribution. 
surv_prob(my_dist, 0.65)

apply_hr 
Applies hazard ratio to a survival distribution. 
apply_hr(my_dist, 0.5)

apply_or 
Applies odds ratio to a survival distribution. 
apply_or(my_dist, 1.3)

apply_shift 
Shift survival distribution forwards or backwards in time. 
apply_shift(my_dist, 20)

event_prob 
Calculates probability of experiencing an event in a set of intervals given a survival distribution, start times of the intervals, and end times of the intervals. Useful for calculating transition probabilities based either on state time or model time using a survival distribution. 
event_prob(my_dist, start, end)

surv_prob 
Calculates survival probabilities for survival distribution at given times. 
surv_prob(my_dist, times)

add_hazards 
Combine two survival distributions as two independent risks. 
add_hazards(dist1, dist2)

define_survival 
Define parametric survival model for given family and with given parameter values. Supported distributions include:
Information on parameterization of each survival distribution can be found here. 
define_survival(

define_survival_cure 
Define mixture or nonmixture parametric survival cure model for a given family, with given cure fraction, and with given parameter values. Supports same set of distributions and parameterizations as with "define_survival". 
define_survival_cure(

define_spline_survival 
Define parametric survival model for given family and with given parameter values. Supported distributions include:

define_spline_survival( 
define_surv_table 
Define survival distribution based on a table of times and survival probabilities. Columns must be named "time" and "survival" respectively. 
define_surv_table(my_table)

define_surv_lifetable 
Define survival distribution based on a life table. First argument is a table with annual death rates by age containing the columns "age", "male", and "female". Second and third arguments are the starting age and percent of patients who are men. 
define_surv_lifetable(

join 
Join two or more survival distributions together at given cut time(s). First argument is survival distribution for first segment, followed by cut point, and then distribution used in second segment. 
join(km_dist, 60, param_dist) 
mix 
Mix two or more distributions using given weights. Each survival distribution argument must be followed by additional numeric argument specifying weight assigned to that distribution. 
mix(dist1, 0.7, dist2, 0.3) 
set_covariates 
Takes a survival model estimated with covariates (from survfit, flexsurvreg, or other supported functions) and sets the covariate values for which survival projections will be used. 
set_covariates( 
Functions from Other R Packages
In addition to the builtin functions above, hēRo3 can also support fitted parametric models from the flexsurv and flexsurvcure packages, as well as KaplanMeiers from the survival package. More information on how to use these functions is provided in their respective documentation pages.