statsmodels.duration.hazard_regression.PHReg.predict

PHReg.predict(params, exog=None, cov_params=None, endog=None, strata=None, offset=None, pred_type='lhr', pred_only=False)[source]

Returns predicted values from the proportional hazards regression model.

Parameters:
paramsarray_like

The proportional hazards model parameters.

exogarray_like

Data to use as exog in forming predictions. If not provided, the exog values from the model used to fit the data are used.

cov_paramsarray_like

The covariance matrix of the estimated params vector, used to obtain prediction errors if pred_type=’lhr’, otherwise optional.

endogarray_like

Duration (time) values at which the predictions are made. Only used if pred_type is either ‘cumhaz’ or ‘surv’. If using model exog, defaults to model endog (time), but may be provided explicitly to make predictions at alternative times.

strataarray_like

A vector of stratum values used to form the predictions. Not used (may be ‘None’) if pred_type is ‘lhr’ or ‘hr’. If exog is None, the model stratum values are used. If exog is not None and pred_type is ‘surv’ or ‘cumhaz’, stratum values must be provided (unless there is only one stratum).

offsetarray_like

Offset values used to create the predicted values.

pred_typestr

If ‘lhr’, returns log hazard ratios, if ‘hr’ returns hazard ratios, if ‘surv’ returns the survival function, if ‘cumhaz’ returns the cumulative hazard function.

pred_onlybool

If True, returns only an array of predicted values. Otherwise returns a bunch containing the predicted values and standard errors.

Returns:
A bunch containing two fields: predicted_values and
standard_errors.

Notes

Standard errors are only returned when predicting the log hazard ratio (pred_type is ‘lhr’).

Types surv and cumhaz require estimation of the cumulative hazard function.