Skip to contents

This calibration method fits the predicted linear predictor from a Cox PH model as the only predictor in a new Cox PH model with the test data as the response. $$h(t|x) = h_0(t)exp(\beta \times lp)$$ where \(lp\) is the predicted linear predictor on the test data.

The model is well calibrated if the estimated \(\hat{\beta}\) coefficient (returned score) is equal to 1.

Note: Assumes fitted model is Cox PH (i.e. has an lp prediction type).

Dictionary

This Measure can be instantiated via the dictionary mlr_measures or with the associated sugar function msr():

MeasureSurvCalibrationBeta$new()
mlr_measures$get("surv.calib_beta")
msr("surv.calib_beta")

Parameters

IdTypeDefaultLevels
selogicalFALSETRUE, FALSE
methodcharacterratioratio, diff

Meta Information

  • Type: "surv"

  • Range: \((-\infty, \infty)\)

  • Minimize: FALSE

  • Required prediction: lp

Parameter details

  • se (logical(1))
    If TRUE then return standard error of the measure which is the standard error of the estimated coefficient \(se_{\hat{\beta}}\) from the Cox PH model. If FALSE (default) then returns the estimated coefficient \(\hat{\beta}\).

  • method (character(1))
    Returns \(\hat{\beta}\) if equal to ratio (default) and \(|1-\hat{\beta}|\) if diff. With diff, the output score can be minimized and for example be used for tuning purposes. This parameter takes effect only if se is FALSE.

References

Van Houwelingen, C. H (2000). “Validation, calibration, revision and combination of prognostic survival models.” Statistics in Medicine, 19(24), 3401–3415. doi:10.1002/1097-0258(20001230)19:24<3401::AID-SIM554>3.0.CO;2-2 .

Super classes

mlr3::Measure -> mlr3proba::MeasureSurv -> MeasureSurvCalibrationBeta

Methods

Inherited methods


Method new()

Creates a new instance of this R6 class.

Usage

MeasureSurvCalibrationBeta$new(method = "ratio")

Arguments

method

defines which output score to return, see "Parameter details" section.


Method clone()

The objects of this class are cloneable with this method.

Usage

MeasureSurvCalibrationBeta$clone(deep = FALSE)

Arguments

deep

Whether to make a deep clone.