statsmodels.duration.hazard_regression.PHReg.predict

method

PHReg.predict(params, exog=None, cov_params=None, endog=None, strata=None, offset=None, pred_type='lhr')[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_typestring

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

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.