Follow the transformation
Start with the audience and decision.
Choose an explanation method that matches model type and question (global vs local).
Use held-out data when measuring importance that depends on predictive performance.
Permutation Importance is part of model interpretation and communication.
Permutation Importance is part of model interpretation and communication. Explanations describe model behaviour under specific assumptions; they are not automatically causal statements about the real world.
Permutation Importance matters because a trained model becomes a system only when it can be explained, persisted, served, monitored and governed consistently with its validated preprocessing and intended use.
Treat this as a sequence of observable decisions rather than one opaque command. Stage 1: Start with the audience and decision. Stage 2: Choose an explanation method that matches model type and question (global vs local). Stage 3: Use held-out data when measuring importance that depends on predictive performance. Final checkpoint: State uncertainty, limitations and what the explanation does not establish.
Start with the audience and decision.
Choose an explanation method that matches model type and question (global vs local).
Use held-out data when measuring importance that depends on predictive performance.
Start with the audience and decision. For Permutation Importance, identify the exact state before this stage, the operation or rule applied here, and the observable state afterwards so the mechanism remains inspectable.
Baseline validation score = 0.88.
Shuffle feature A → score 0.80 (drop 0.08).
Shuffle feature B → score 0.87 (drop 0.01).Feature A is more important to this fitted model on this evaluation set, but correlation can redistribute importance among redundant predictors.
For Permutation Importance, connect the reported result to the exact training/validation/prediction step that produced it and check one prediction, fold or metric component independently.
CoefficientsDirect model parameters; interpretation depends on scaling/encoding and model form.Permutation importancePerformance loss after shuffling a feature.PDPAverage predicted response as a feature is varied, marginalising over data.ICEIndividual prediction curves rather than the average.SHAPAdditive feature-attribution framework tied to a background/reference distribution.Use Permutation Importance when a trained model must be interpreted, persisted, served or monitored as part of a repeatable prediction system rather than a one-off notebook.
Do not deploy or automate when feature definitions, software/model versions, input contracts, monitoring signals or ownership for retraining are unspecified.
No single feature-importance number answers every question. Use statistical, univariate predictive and model-based evidence together, then validate the selected subset.
max(AUC, 1-AUC) to measure one-feature discrimination, and/or measure the drop in model ROC-AUC when the fitted model loses that feature’s information.# Feature evidence on training data only
# Step 1 — Import the module so its functions/classes are available to the rest of this example.
import numpy as np
# Step 2 — Import only the named objects needed by the following steps, keeping dependencies explicit.
from scipy.stats import ttest_ind
# Step 3 — Import only the named objects needed by the following steps, keeping dependencies explicit.
from sklearn.metrics import roc_auc_score
# Step 4 — Import only the named objects needed by the following steps, keeping dependencies explicit.
from sklearn.linear_model import LogisticRegression
# Step 5 — Import only the named objects needed by the following steps, keeping dependencies explicit.
from sklearn.feature_selection import RFE
# Step 6 — Import only the named objects needed by the following steps, keeping dependencies explicit.
from sklearn.inspection import permutation_importance
# Step 7 — Compute the right-hand expression and store its result in `feature_rows` for the next step.
feature_rows = []
# Step 8 — Iterate through the collection so the indented block is applied once for each item.
for name in feature_names:
# Step 9 — Execute this statement and inspect how it changes the current value, object or program state.
x0 = X_train.loc[y_train == 0, name].dropna()
# Step 10 — Execute this statement and inspect how it changes the current value, object or program state.
x1 = X_train.loc[y_train == 1, name].dropna()
# 1) Statistical significance: unequal-variance two-sample test
# Step 11 — Compute the right-hand expression and store its result in `t_stat, p_value` for the next step.
t_stat, p_value = ttest_ind(x0, x1, equal_var=False)
# 2) Univariate discrimination; direction-adjusted for importance
# Step 12 — Compute the right-hand expression and store its result in `auc` for the next step.
auc = roc_auc_score(y_train, X_train[name])
# Step 13 — Compute the right-hand expression and store its result in `auc_importance` for the next step.
auc_importance = max(auc, 1 - auc)
# Step 14 — Execute this statement and inspect how it changes the current value, object or program state.
feature_rows.append((name, t_stat, p_value, auc_importance))
# 3) Model-based subset selection: fit only on development data
# Step 15 — Instantiate `base` with the chosen algorithm/configuration before fitting it to data.
base = LogisticRegression(max_iter=2000)
# Step 16 — Compute the right-hand expression and store its result in `rfe` for the next step.
rfe = RFE(base, n_features_to_select=3)
# Step 17 — Fit the model or transformer, learning its parameters from the supplied training data.
rfe.fit(X_train_scaled, y_train)
# Step 18 — Construct `selected` as an array so vectorised numerical operations can be applied consistently.
selected = np.array(feature_names)[rfe.support_]
# 4) Model reliance: evaluate permutation loss on validation data
# Step 19 — Fit the model or transformer, learning its parameters from the supplied training data.
model = LogisticRegression(max_iter=2000).fit(
X_train_scaled[:, rfe.support_], y_train
)
# Step 20 — Compute the right-hand expression and store its result in `perm` for the next step.
perm = permutation_importance(
model,
X_valid_scaled[:, rfe.support_],
y_valid,
scoring="roc_auc",
n_repeats=20,
random_state=42,
)
# Step 21 — Display the current value explicitly so the result/state can be inspected during execution.
print("Selected by RFE:", selected.tolist())
# Step 22 — Display the current value explicitly so the result/state can be inspected during execution.
print("Validation permutation ΔAUC:", perm.importances_mean.round(3))If many p-values are screened at once, consider false-discovery or family-wise error control and report effect sizes as well as significance. Use the p-value as evidence under assumptions, not as a mechanical feature-selection cutoff.
Build a tiny, inspectable example of Permutation Importance. First start with the audience and decision. Then choose an explanation method that matches model type and question (global vs local). Write the expected result before running it, and explain one condition that would make the result misleading or invalid.
Before trusting a result from Permutation Importance, which check provides the strongest evidence that you understand and applied it correctly?
Step 1Start with the audience and decision.Step 2Choose an explanation method that matches model type and question (global vs local).Step 3Use held-out data when measuring importance that depends on predictive performance.Step 4Check correlated features because importance can be shared or displaced.