Research Workflow

Treat Recalibration as a Model Update That Needs Evaluation

Diagnose the problem before updating

A model can rank people reasonably well while systematically overpredicting or underpredicting absolute risk. Recalibration may address some such discrepancies, but it should follow a documented validation assessment. Save the original predictions and their performance before fitting any update.

The scikit-learn calibration guide explains probability calibration and the need to separate fitting and calibration data appropriately. Updating probabilities using the same outcomes used to judge the update can produce an overly favorable performance estimate.

Choose the smallest justified update

For an existing binary-risk model, an intercept update changes the overall level on the log-odds scale while holding the original slope contribution fixed. A logistic intercept-and-slope update changes both level and spread. More flexible calibration methods require enough data and can introduce their own overfitting.

Specify the population, outcome horizon and update method in advance. Investigate whether discrepancies instead arise from a coding error, different outcome definition, unavailable predictor or incorrect unit conversion. Recalibration should not hide a broken implementation of the original model.

Work through a hypothetical intercept change

Suppose a model predicts risk 0.20, corresponding to odds 0.20/0.80 = 0.25. An illustrative intercept update adds ln2 to every predicted log odds, doubling those odds to 0.50. The updated risk is 0.50/(1 + 0.50), approximately 0.333.

A prediction of 0.80 has odds 4 and becomes odds 8, or risk approximately 0.889. The update is not an addition of the same number of percentage points to every probability. Its effect depends on the original risk, which is why storing the exact transformation matters.

Evaluate the updated prediction rule

Use a suitable held-out, resampling or later evaluation strategy that accounts for estimating the update. Report calibration, discrimination and decision-relevant performance for both original and updated versions. An intercept-only monotone update can leave ranking unchanged while materially changing threshold-based decisions.

Version the updated model, including the original model identifier, calibration dataset, fitted parameters and intended population. Record how future data drift will be monitored and what would trigger another review. If the available update sample is small or unrepresentative, describe the uncertainty rather than presenting a smooth calibration curve as a guarantee of transportability. Recalibration is a new estimation step with its own evidence requirements, not a cosmetic correction to a published score.

Source verification: 6 November 2026. Examples are hypothetical.

Related reading

Reading path: Analyze data. Guide 75 of 89. Choose any guide to suit your project.

Research Workflow

Repeat the Model-Building Process When Estimating Optimism

Use bootstrap validation to assess overfitting while preserving every development step.

Research Workflow

Explain How Case Mix Changes External Model Performance

Compare the validation population with the development setting before interpreting a performance difference.

Browse this reading pathTools for this stageGuides and downloads for this stage