Test Descriptions
Model Performance
Average Confidence
This test checks the average confidence of the model predictions between the reference and evaluation sets to see if the metric has experienced significant degradation. The "confidence" of a prediction for classification tasks is defined as the distance between the probability of the predicted class (defined as the argmax over the prediction vector) and 1. We average this metric across all predictions.
Policies: NIST Map 1.5
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly. Since oftentimes labels are not available in a production setting, this metric can serve as a useful proxy for model performance.
Configuration: By default, this test runs if predictions are specified (no labels required).
Example: Assume that on the reference set the model obtained 0.85 average confidence but on the evaluation set without labels we predict that the model obtained 0.5 average confidence. Then this test raises a warning.
Average Thresholded Confidence
This test checks the average thresholded confidence (ATC) of the model predictions between the reference and evaluation sets to see if the metric has experienced significant degradation. ATC is a method for estimating accuracy of unlabeled examples taken from this paper. The threshold is first computed on the reference set: we pick a confidence threshold such that the percentage of datapoints whose max predicted probability is less than the threshold is around equal to the error rate of the model (here, it is 1-accuracy) on the reference set. Then, we apply this threshold in the evaluation set: the predicted accuracy is then equal to the percentage of datapoints with max predicted probability greater than this threshold.
Policies: NIST Map 1.5
Why it matters: During production, factors like distribution shift may cause model performance to decrease significantly. Since oftentimes labels are not available in a production setting, this metric can serve as a useful proxy for model performance.
Configuration: By default, this test runs if predictions/labels are specified in the reference set and predictions are specified in the eval set (no labels required).
Example: Assume that on the reference set the model obtained 0.85 accuracy but on the evaluation set, we find that only 55 percent of datapoints have max predicted probability greater than our threshold. Then our predicted accuracy is 0.55 and this test raises a warning.
Calibration Comparison
This test checks that the reference and evaluation sets have sufficiently similar calibration curves as measured by the Mean Squared Error (MSE) between the two curves. The calibration curve is a line plot where the x-axis represents the average predicted probability and the y-axis is the proportion of positive predictions. The curve of the ideal calibrated model is thus a linear straight line from (0, 0) moving linearly.
Policies: NIST Map 1.5
Why it matters: Knowing how well-calibrated your model is can help you better interpret and act upon model outputs, and can even be an indicator of generalization. A greater difference between reference and evaluation curves could indicate a lack of generalizability. In addition, a change in calibration could indicate that decision-making or thresholding conducted upstream needs to change as it is behaving differently on held-out data.
Configuration: By default, this test runs over the predictions and labels.
Example: Suppose the model’s task is binary classification and predicts whether or not a data point is fraudulent. If we have a reference set in which 1% of the data points are fraudulent, but an evaluation set where 50% are fraudulent, then our model may not be well calibrated, and the MSE difference in the curves will be large, resulting in a failing test.
Average Rank
This test checks the Average Rank metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of Average Rank has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the Average Rank metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 50.0 Average Rank but on the evaluation set the model obtained 85.0 Average Rank. Then this test raises a warning.
Recall
This test checks the Recall metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of Recall has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5, NIST Map 2.3, NIST Map 3.4, NIST Measure 1.1, NIST Measure 2.3
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the Recall metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 0.85 Recall but on the evaluation set the model obtained 0.5 Recall. Then this test raises a warning.
Average Number of Predicted Entities
This test checks the Average Number of Predicted Entities metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of Average Number of Predicted Entities has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the Average Number of Predicted Entities metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 50.0 Average Number of Predicted Entities but on the evaluation set the model obtained 85.0 Average Number of Predicted Entities. Then this test raises a warning.
Normalized Discounted Cumulative Gain (NDCG)
This test checks the Normalized Discounted Cumulative Gain (NDCG) metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of Normalized Discounted Cumulative Gain (NDCG) has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the Normalized Discounted Cumulative Gain (NDCG) metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 0.85 Normalized Discounted Cumulative Gain (NDCG) but on the evaluation set the model obtained 0.5 Normalized Discounted Cumulative Gain (NDCG). Then this test raises a warning.
Macro Recall
This test checks the Macro Recall metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of Macro Recall has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the Macro Recall metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 0.85 Macro Recall but on the evaluation set the model obtained 0.5 Macro Recall. Then this test raises a warning.
F1
This test checks the F1 metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of F1 has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the F1 metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 0.85 F1 but on the evaluation set the model obtained 0.5 F1. Then this test raises a warning.
Mean-Absolute Percentage Error (MAPE)
This test checks the Mean-Absolute Percentage Error (MAPE) metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of Mean-Absolute Percentage Error (MAPE) has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the Mean-Absolute Percentage Error (MAPE) metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 50.0 Mean-Absolute Percentage Error (MAPE) but on the evaluation set the model obtained 85.0 Mean-Absolute Percentage Error (MAPE). Then this test raises a warning.
Positive Prediction Rate
This test checks the Positive Prediction Rate metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of Positive Prediction Rate has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the Positive Prediction Rate metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 0.5 Positive Prediction Rate but on the evaluation set the model obtained 0.85 Positive Prediction Rate. Then this test raises a warning.
Recall
This test checks the Recall metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of Recall has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5, NIST Map 2.3, NIST Map 3.4, NIST Measure 1.1, NIST Measure 2.3
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the Recall metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 0.85 Recall but on the evaluation set the model obtained 0.5 Recall. Then this test raises a warning.
Macro Precision
This test checks the Macro Precision metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of Macro Precision has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the Macro Precision metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 0.85 Macro Precision but on the evaluation set the model obtained 0.5 Macro Precision. Then this test raises a warning.
Root-Mean-Squared Error (RMSE)
This test checks the Root-Mean-Squared Error (RMSE) metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of Root-Mean-Squared Error (RMSE) has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the Root-Mean-Squared Error (RMSE) metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 50.0 Root-Mean-Squared Error (RMSE) but on the evaluation set the model obtained 85.0 Root-Mean-Squared Error (RMSE). Then this test raises a warning.
Precision
This test checks the Precision metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of Precision has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5, NIST Map 2.3, NIST Map 3.4, NIST Measure 1.1, NIST Measure 2.3
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the Precision metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 0.85 Precision but on the evaluation set the model obtained 0.5 Precision. Then this test raises a warning.
Prediction Variance (Positive Labels)
This test checks the Prediction Variance (Positive Labels) metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of Prediction Variance (Positive Labels) has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the Prediction Variance (Positive Labels) metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 0.5 Prediction Variance (Positive Labels) but on the evaluation set the model obtained 0.85 Prediction Variance (Positive Labels). Then this test raises a warning.
Multiclass AUC
This test checks the Multiclass AUC metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of Multiclass AUC has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the Multiclass AUC metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 0.85 Multiclass AUC but on the evaluation set the model obtained 0.5 Multiclass AUC. Then this test raises a warning.
False Negative Rate
This test checks the False Negative Rate metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of False Negative Rate has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5, NIST Map 2.3, NIST Map 3.4, NIST Measure 1.1, NIST Measure 2.3
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the False Negative Rate metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 0.5 False Negative Rate but on the evaluation set the model obtained 0.85 False Negative Rate. Then this test raises a warning.
Precision
This test checks the Precision metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of Precision has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5, NIST Map 2.3, NIST Map 3.4, NIST Measure 1.1, NIST Measure 2.3
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the Precision metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 0.85 Precision but on the evaluation set the model obtained 0.5 Precision. Then this test raises a warning.
Average Prediction
This test checks the Average Prediction metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of Average Prediction has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the Average Prediction metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 0.0 Average Prediction but on the evaluation set the model obtained 70.0 Average Prediction. Then this test raises a warning.
Mean Reciprocal Rank (MRR)
This test checks the Mean Reciprocal Rank (MRR) metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of Mean Reciprocal Rank (MRR) has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the Mean Reciprocal Rank (MRR) metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 0.85 Mean Reciprocal Rank (MRR) but on the evaluation set the model obtained 0.5 Mean Reciprocal Rank (MRR). Then this test raises a warning.
AUC
This test checks the AUC metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of AUC has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5, NIST Map 2.3, NIST Map 3.4, NIST Measure 1.1, NIST Measure 2.3
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the AUC metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 0.85 AUC but on the evaluation set the model obtained 0.5 AUC. Then this test raises a warning.
Precision
This test checks the Precision metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of Precision has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5, NIST Map 2.3, NIST Map 3.4, NIST Measure 1.1, NIST Measure 2.3
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the Precision metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 0.85 Precision but on the evaluation set the model obtained 0.5 Precision. Then this test raises a warning.
Rank Correlation
This test checks the Rank Correlation metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of Rank Correlation has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the Rank Correlation metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 0.7 Rank Correlation but on the evaluation set the model obtained 0.0 Rank Correlation. Then this test raises a warning.
F1
This test checks the F1 metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of F1 has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the F1 metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 0.85 F1 but on the evaluation set the model obtained 0.5 F1. Then this test raises a warning.
Prediction Variance (Negative Labels)
This test checks the Prediction Variance (Negative Labels) metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of Prediction Variance (Negative Labels) has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the Prediction Variance (Negative Labels) metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 0.5 Prediction Variance (Negative Labels) but on the evaluation set the model obtained 0.85 Prediction Variance (Negative Labels). Then this test raises a warning.
False Positive Rate
This test checks the False Positive Rate metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of False Positive Rate has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5, NIST Map 2.3, NIST Map 3.4, NIST Measure 1.1, NIST Measure 2.3
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the False Positive Rate metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 0.5 False Positive Rate but on the evaluation set the model obtained 0.85 False Positive Rate. Then this test raises a warning.
Prediction Variance
This test checks the Prediction Variance metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of Prediction Variance has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the Prediction Variance metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 50.0 Prediction Variance but on the evaluation set the model obtained 85.0 Prediction Variance. Then this test raises a warning.
Accuracy
This test checks the Accuracy metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of Accuracy has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5, NIST Map 2.3, NIST Map 3.4, NIST Measure 1.1, NIST Measure 2.3
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the Accuracy metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 0.85 Accuracy but on the evaluation set the model obtained 0.5 Accuracy. Then this test raises a warning.
Mean-Absolute Error (MAE)
This test checks the Mean-Absolute Error (MAE) metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of Mean-Absolute Error (MAE) has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the Mean-Absolute Error (MAE) metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 50.0 Mean-Absolute Error (MAE) but on the evaluation set the model obtained 85.0 Mean-Absolute Error (MAE). Then this test raises a warning.
F1
This test checks the F1 metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of F1 has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the F1 metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 0.85 F1 but on the evaluation set the model obtained 0.5 F1. Then this test raises a warning.
Mean-Squared-Log Error (MSLE)
This test checks the Mean-Squared-Log Error (MSLE) metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of Mean-Squared-Log Error (MSLE) has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the Mean-Squared-Log Error (MSLE) metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 50.0 Mean-Squared-Log Error (MSLE) but on the evaluation set the model obtained 85.0 Mean-Squared-Log Error (MSLE). Then this test raises a warning.
Macro F1
This test checks the Macro F1 metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of Macro F1 has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the Macro F1 metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 0.85 Macro F1 but on the evaluation set the model obtained 0.5 Macro F1. Then this test raises a warning.
Mean-Squared Error (MSE)
This test checks the Mean-Squared Error (MSE) metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of Mean-Squared Error (MSE) has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the Mean-Squared Error (MSE) metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 50.0 Mean-Squared Error (MSE) but on the evaluation set the model obtained 85.0 Mean-Squared Error (MSE). Then this test raises a warning.
Recall
This test checks the Recall metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of Recall has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5, NIST Map 2.3, NIST Map 3.4, NIST Measure 1.1, NIST Measure 2.3
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the Recall metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 0.85 Recall but on the evaluation set the model obtained 0.5 Recall. Then this test raises a warning.
Multiclass Accuracy
This test checks the Multiclass Accuracy metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of Multiclass Accuracy has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the Multiclass Accuracy metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 0.85 Multiclass Accuracy but on the evaluation set the model obtained 0.5 Multiclass Accuracy. Then this test raises a warning.
Average Number of Predicted Boxes
This test checks the Average Number of Predicted Boxes metric to see both if its performance on the evaluation set alone is satisfactory, as well as if performance in terms of Average Number of Predicted Boxes has degraded from the reference to evaluation set. The key detail displays whether the given performance metric has degraded beyond a defined threshold.
Policies: NIST Map 1.5
Why it matters: During production, factors like distribution shift or a change in p(y|x) may cause model performance to decrease significantly.
Configuration: By default, this test runs over the Average Number of Predicted Boxes metric with the below thresholds set for the absolute and degradation tests.
Example: Assume that on the reference set the model obtained 50.0 Average Number of Predicted Boxes but on the evaluation set the model obtained 85.0 Average Number of Predicted Boxes. Then this test raises a warning.
Bias and Fairness
Protected Feature Drift
This test measures the change in the distribution of a feature by comparing the distribution in an evaluation set to a reference set. The test severity is a function of both the degree to which the distribution has changed and the estimated impact the observed drift has had on model performance.
Policies: NIST Map 1.5, NIST Map 1.6, NIST Measure 2.11
Why it matters: Distribution shift between training and inference can cause degradation in model performance. If the shift is sufficiently large, retraining the model on newer data may be necessary.
Configuration: By default, this test runs over all feature columns with sufficiently many samples in both the reference and evaluation sets.
Example: Suppose that the distribution of a feature Age shifts between the reference and evaluation sets such that the PSI between these two samples is 0.2. If PSI is configured as the drift statistic for numeric features and the PSI warning threshold is set to 0.1, this test would raise a warning.
Demographic Parity (Pos Pred)
This test checks whether the Selection Rate for any subset of a feature performs as well as the best Selection Rate across all subsets of that feature. The Demographic Parity is calculated as the Positive Prediction Rate. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Selection Rate of model predictions within a specific subset is significantly lower than that of other subsets by taking a ratio of the rates. Also included in this test is the Impact Ratios tab, which includes a calculation of Disparate Impact Ratio for each subset. Disparate Impact Ratio is defined as the Positive Prediction Rate for the subset divided by the best Positive Prediction Rate across all subsets.
Policies: NYC Local Law 144, NIST Map 1.5, NIST Map 1.6, NIST Measure 2.2, NIST Measure 2.11
Why it matters: Assessing differences in Selection Rate is an important measures of fairness. It is meant to be used in a setting where we assert that the base Selection Rates between subgroups should be the same (even if empirically they are different). This contrasts with equality of opportunity or predictive parity tests, which permit classification rates to depend on a sensitive attribute. Comparing Positive Prediction Rates and Impact Ratios over all subsets can be useful in legal/compliance settings where we want the Selection Rate for any sensitive group to fundamentally be the same as other groups.
Configuration: By default, the Selection Rate is computed for all protected features. The severity threshold baseline is set to 80% by default, in accordance with the four-fifths law for adverse impact detection.
Example: Suppose we had data with the following protected feature 'animal': ['cat', 'cat', 'cat', 'dog', 'dog', 'dog'], and model predictions [0.3, 0.3, 0.9, 0.9, 0.9, 0.3]. Then regardless of the labels, the Positive Prediction Rate over the feature values ('cat', 'dog') would be (0.33, 0.66), indicating a failure because cats would be selected half as often as dogs.
Demographic Parity (Avg Pred)
This test checks whether the Average Prediction for any subset of a feature performs as well as the best Average Prediction across all subsets of that feature. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Average Prediction of model predictions within a specific subset is significantly lower than that of other subsets by taking a ratio of the rates. Also included in this test is the Impact Ratios tab, which includes a calculation of Disparate Impact Ratio for each subset. Disparate Impact Ratio is defined as the Positive Prediction Rate for the subset divided by the best Positive Prediction Rate across all subsets.
Policies: NYC Local Law 144, NIST Map 1.5, NIST Map 1.6, NIST Measure 2.2, NIST Measure 2.11
Why it matters: Assessing differences in Average Prediction is an important measures of fairness. It is meant to be used in a setting where we assert that the base Average Predictions between subgroups should be the same (even if empirically they are different). This contrasts with equality of opportunity or predictive parity tests, which permit classification rates to depend on a sensitive attribute. Comparing Positive Prediction Rates and Impact Ratios over all subsets can be useful in legal/compliance settings where we want the Average Prediction for any sensitive group to fundamentally be the same as other groups.
Configuration: By default, the Average Prediction is computed for all protected features. The severity threshold baseline is set to 80% by default, in accordance with the four-fifths law for adverse impact detection.
Example: Suppose we had data with the following protected feature 'animal': ['cat', 'cat', 'cat', 'dog', 'dog', 'dog'], and model predictions [10.4, 10.0, 10.2, 7.7, 8.0, 8.0]. Then regardless of the labels, the Positive Prediction Rate over the feature values ('cat', 'dog') would be (10.2, 7.9), indicating a failure because dogs have an Average Prediction less than 80% of the Average Prediction for cats.
Demographic Parity (Avg Rank)
This test checks whether the Average Rank for any subset of a feature performs as well as the best Average Rank across all subsets of that feature. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Average Rank of model predictions within a specific subset is significantly lower than that of other subsets by taking a ratio of the rates. Also included in this test is the Impact Ratios tab, which includes a calculation of Disparate Impact Ratio for each subset. Disparate Impact Ratio is defined as the Positive Prediction Rate for the subset divided by the best Positive Prediction Rate across all subsets.
Policies: NYC Local Law 144, NIST Map 1.5, NIST Map 1.6, NIST Measure 2.2, NIST Measure 2.11
Why it matters: Assessing differences in Average Rank is an important measures of fairness. It is meant to be used in a setting where we assert that the base Average Ranks between subgroups should be the same (even if empirically they are different). This contrasts with equality of opportunity or predictive parity tests, which permit classification rates to depend on a sensitive attribute. Comparing Positive Prediction Rates and Impact Ratios over all subsets can be useful in legal/compliance settings where we want the Average Rank for any sensitive group to fundamentally be the same as other groups.
Configuration: By default, the Average Rank is computed for all protected features. The severity threshold baseline is set to 80% by default, in accordance with the four-fifths law for adverse impact detection.
Example: Suppose we had data with the following protected feature 'animal': ['cat', 'cat', 'cat', 'dog', 'dog', 'dog'], and model predictions [0.3, 0.4, 0.5, 0.7, 0.8, 0.9], and rank [6, 5, 4, 3, 2, 1]. Then regardless of the labels, the Average Rank over the feature values ('cat', 'dog') would be (5, 2), indicating a failure in Average Rank.
Class Imbalance
This test checks whether the training sample size for any subset of a feature is significantly smaller than other subsets of that feature. The test first splits the dataset into various subset classes within the feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the class imbalance measure of that subset compared to the largest subset exceeds a set threshold.
Policies: NIST Map 1.5, NIST Map 1.6, NIST Measure 2.10, NIST Measure 2.11
Why it matters: Assessing class imbalance is an important measure of fairness. Features with low subset sizes can result in the model overfitting those subsets, and hence cause a larger error when those subsets appear in test data. This test can be useful in legal/compliance settings where sufficient data for all subsets of a protected feature is important.
Configuration: By default, class imbalance is tested for all protected features. For each subset, the class imbalance ratio is calculated using the feature's largest subset's size with the formula (largest_subset_size-subset_size) / (largest_subset_size+subset_size).
Example: Suppose we had data with the protected feature 'animal', where the distribution of the feature over subsets was 80% dog, 19% cat, and 1% rabbit. The class imbalance ratio hence would be 0.616 for cat and 0.975 for rabbit. The CI ratio for rabbit is close to the extreme of 1, implying that a model trained on this data might perform worse when making predictions on rabbits than over the other subsets.
Equalized Odds
This test checks for equal true positive and false positive rates over all subsets for each protected feature. The test first splits the dataset into various subset classes within the feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the true positive and false positive rates of that subset significantly varies as compared to the largest subset.
Policies: NIST Map 1.5, NIST Map 1.6, NIST Measure 2.2, NIST Measure 2.11
Why it matters: Equalized odds (or disparate mistreatment) is an important measure of fairness in machine learning. Subjects in protected groups may have different true positive rates or false positive rates, which imply that the model may be biased on those protected features. Fulfilling the condition of equalized odds may be a requirement in various legal/compliance settings.
Configuration: By default, equalized odds is tested for all protected features.
Example: Suppose we had data with the protected feature 'animal', where the true positive rates over the subsets 'dog', 'cat', and 'rabbit' were [0.6, 0.9, 0.1], and the false positive rates over the same subsets were [0.3, 0.33, 0.31]. Equalized odds tests for consistency over all true positive prediction rates and false positive prediction rates, hence this would result in a test failure because there is high discrepancy in the true positive rates over the subsets.
Feature Independence
This test checks the independence of each protected feature with the predicted label class. It runs over categorical protected features and uses the chi square test of independence to determine the feature independence. The test compares the observed data to a model that distributes the data according to the expectation that the variables are independent. Wherever the observed data does not fit the model, the likelihood that the variables are dependent becomes stronger.
Policies: NIST Map 1.5, NIST Map 1.6, NIST Map 2.3, NIST Measure 2.5, NIST Measure 2.11
Why it matters: A test of independence assesses whether observations consisting of measures on two variables, expressed in a contingency table, are independent of each other. This can be useful when assessing how protected features impact the predicted class and helping with the feature selection process.
Configuration: By default, this test is run over all protected categorical features.
Example: Let's say you have a model that predicts whether or not a person will be hired or not. One protected feature is gender. If these two variables are independent then the male-female ratio across hired and not hired should be the same. The p-value is 0.06 and the chi squared value is 300. The p-value is above the threshold of 0.05 to declare independence.
Predict Protected Features
The Predict Protected Features test works by training a multi-class logistic regression model to infer categorical protected features from unprotected categorical and numerical features. The model is fit to the reference data and scored based on its accuracy over the evaluation data. The unprotected categorical features are one-hot encoded.
Policies: NIST Map 1.5, NIST Map 1.6, NIST Measure 2.11
Why it matters: In a compliance setting, it may be prohibited to include certain protected features in your training data. However, unprotected features might still provide your model with information about the protected features. If a simple logistic regression model can be trained to accurately predict protected features, your model might have a hidden reliance on protected features, resulting in biased decisions.
Configuration: By default, the selection rate is computed for all protected features.
Example: Suppose we had data with the following protected feature 'animal': ['cat', 'cat', 'cat', 'dog', 'dog', 'dog'], and unprotected feature 'age': [15, 10, 16, 2, 3, 7]. Then if a logistic regression model is trained to predict 'animal' based on 'age', it might achieve a high accuracy, indicating that the unprotected feature 'age' could be used to easily predict the protected feature 'animal'
Equal Opportunity (Recall)
The recall test is more popularly referred to as equal opportunity or false negative error rate balance in fairness literature. This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Recall of model predictions within a specific subset is significantly lower than the model prediction Recall over the entire population.
Policies: NIST Map 1.5, NIST Map 1.6, NIST Measure 2.2, NIST Measure 2.9, NIST Measure 2.11
Why it matters: Having different Recall between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation. Unlike demographic parity, this test permits assuming different base label rates but flags differing mistake rates between different subgroups. An intuitive example is when the label indicates a positive attribute: if predicting whether to interview a given candidate, make sure that out of qualified candidates, the rate at which the model predicts a rejection is similar to group A and B.
Configuration: By default, Recall is computed over all predictions/labels. Note that we round predictions to 0/1 to compute recall.
Example: Suppose we had data with 2 features: [['cat', 0.2], ['dog', 0.3], ['cat', 0.5], ['dog', 0.7], ['cat', 0.7], ['dog', 0.2]], mode predictions [0.3, 0.51, 0.7, 0.49, 0.9, 0.58], and labels [1, 0, 1, 0, 0, 1]. Then, the Recall over the feature subset value 'cat' would be 0.5, compared to the overall metric of 0.67.
Equal Opportunity (Macro Recall)
The recall test is more popularly referred to as equal opportunity or false negative error rate balance in fairness literature. When transitioning to the multiclass setting we can use macro recall which computes the recall of each individual class and then averages these numbers. This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Macro Recall of model predictions within a specific subset is significantly lower than the model prediction Macro Recall over the entire population.
Policies: NIST Map 1.5, NIST Map 1.6, NIST Measure 2.2, NIST Measure 2.9, NIST Measure 2.11
Why it matters: Having different Macro Recall between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation. Unlike demographic parity, this test permits assuming different base label rates but flags differing mistake rates between different subgroups. An intuitive example is when the label indicates a positive attribute: if predicting whether to interview a given candidate, make sure that out of qualified candidates, the rate at which the model predicts an interview is similar to group A and B.
Configuration: By default, Macro Recall is computed over all predictions/labels. Note that the predicted label is the label with the largest predicted class probability.
Example: Suppose we are differentiating between cats, bears, and dogs. Assume that across the data points where height=2 the predictions are [0.9, 0.1, 0], [0.1, 0.9, 0], [0.2, 0.1, 0.7] and the labels are [1, 0, 0], [1, 0, 0], [0, 0, 1] (where the first index corresponds to cat, the second corresponds to bear, and the third corresponds to dog). Then the Macro Recall across this subset is 0.5. If the overall Macro Recall across all subsets is 0.9 then this test raises a warning.
Intersectional Group Fairness (Pos Pred)
This test checks whether the model performs equally well across subgroups created from the intersection of protected groups. The test first creates unique pairs of categorical protected features. We then test whether the positive prediction rate of model predictions within a specific subset is significantly lower than the model positive prediction rate over the entire population. This will expose hidden biases against groups at the intersection of these protected features. Also included in this test is the Impact Ratios tab, which includes a calculation of Disparate Impact Ratio for each subgroup. Disparate Impact Ratio is defined as the Positive Prediction Rate for the subgroup divided by the best Positive Prediction Rate across all subgroups.
Policies: NYC Local Law 144, NIST Map 1.5, NIST Map 1.6, NIST Measure 2.2, NIST Measure 2.11
Why it matters: Most existing work in the fairness literature deals with a binary view of fairness - either a particular group is performing worse or not. This binary categorization misses the important nuance of the fairness field - that biases can often be amplified in subgroups that combine membership from different protected groups, especially if such a subgroup is particularly underrepresented in opportunities historically. The intersectional group fairness test is run over subsets representing this intersection between two protected groups.
Configuration: This test runs over unique pairs of categorical protected features.
Example: Suppose your dataset contains two protected features: race and gender. Both features pass the demographic parity test for categories women, men, white and black. However, when certain subsets of these features are combined, such as black women or white men, the positive prediction rates perform significantly worse than the overall population. This would show disparate impact towards this subgroup.
Intersectional Group Fairness (Avg Pred)
This test checks whether the model performs equally well across subgroups created from the intersection of protected groups. The test first creates unique pairs of categorical protected features. We then test whether the average prediction of model predictions within a specific subset is significantly lower than the model average prediction over the entire population. This will expose hidden biases against groups at the intersection of these protected features. Also included in this test is the Impact Ratios tab, which includes a calculation of Disparate Impact Ratio for each subgroup. Disparate Impact Ratio is defined as the Positive Prediction Rate for the subgroup divided by the best Positive Prediction Rate across all subgroups.
Policies: NYC Local Law 144, NIST Map 1.5, NIST Map 1.6, NIST Measure 2.2, NIST Measure 2.11
Why it matters: Most existing work in the fairness literature deals with a binary view of fairness - either a particular group is performing worse or not. This binary categorization misses the important nuance of the fairness field - that biases can often be amplified in subgroups that combine membership from different protected groups, especially if such a subgroup is particularly underrepresented in opportunities historically. The intersectional group fairness test is run over subsets representing this intersection between two protected groups.
Configuration: This test runs over unique pairs of categorical protected features.
Example: Suppose your dataset contains two protected features: race and gender. Both features pass the demographic parity test for categories women, men, white and black. However, when certain subsets of these features are combined, such as black women or white men, the positive prediction rates perform significantly worse than the overall population. This would show disparate impact towards this subgroup.
Intersectional Group Fairness (Avg Rank)
This test checks whether the model performs equally well across subgroups created from the intersection of protected groups. The test first creates unique pairs of categorical protected features. We then test whether the average rank of model predictions within a specific subset is significantly lower than the model average rank over the entire population. This will expose hidden biases against groups at the intersection of these protected features. Also included in this test is the Impact Ratios tab, which includes a calculation of Disparate Impact Ratio for each subgroup. Disparate Impact Ratio is defined as the Positive Prediction Rate for the subgroup divided by the best Positive Prediction Rate across all subgroups.
Policies: NYC Local Law 144, NIST Map 1.5, NIST Map 1.6, NIST Measure 2.2, NIST Measure 2.11
Why it matters: Most existing work in the fairness literature deals with a binary view of fairness - either a particular group is performing worse or not. This binary categorization misses the important nuance of the fairness field - that biases can often be amplified in subgroups that combine membership from different protected groups, especially if such a subgroup is particularly underrepresented in opportunities historically. The intersectional group fairness test is run over subsets representing this intersection between two protected groups.
Configuration: This test runs over unique pairs of categorical protected features.
Example: Suppose your dataset contains two protected features: race and gender. Both features pass the demographic parity test for categories women, men, white and black. However, when certain subsets of these features are combined, such as black women or white men, the positive prediction rates perform significantly worse than the overall population. This would show disparate impact towards this subgroup.
Predictive Equality (FPR)
The false positive error rate test is also popularly referred to as predictive equality, or equal mis-opportunity in fairness literature. This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the False Positive Rate of model predictions within a specific subset is significantly upper than the model prediction False Positive Rate over the entire population.
Policies: NIST Map 1.5, NIST Map 1.6, NIST Measure 2.2, NIST Measure 2.9, NIST Measure 2.11
Why it matters: Having different False Positive Rate between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation. Unlike demographic parity, this test permits assuming different base label rates but flags differing mistake rates between different subgroups. As an intuitive example, consider the case when the label indicates an undesirable attribute: if predicting whether a person will default on their loan, make sure that for people who didn't default, the rate at which the model incorrectly predicts positive is similar for group A and B.
Configuration: By default, False Positive Rate is computed over all predictions/labels. Note that we round predictions to 0/1 to compute false positive rate.
Example: Suppose we had data with 2 features: [['cat', 0.2], ['dog', 0.3], ['cat', 0.5], ['dog', 0.7], ['cat', 0.7], ['dog', 0.2]], mode predictions [0.3, 0.51, 0.7, 0.49, 0.9, 0.58], and labels [1, 0, 1, 0, 0, 1]. Then, the False Positive Rate over the feature subset value 'cat' would be 1.0, compared to the overall metric of 0.67.
Discrimination By Proxy
This test checks whether any feature is a proxy for a protected feature. It runs over categorical features, using mutual information as a measure of similarity with a protected feature. Mutual information measures any dependencies between two variables.
Policies: NIST Map 1.5, NIST Map 1.6, NIST Map 2.3, NIST Measure 2.11
Why it matters: A common strategy to try to ensure a model is not biased is to remove protected features from the training data entirely so the model cannot learn over them. However, if other features are highly dependent on those features, that could lead to the model effectively still training over those features by proxy.
Configuration: By default, this test is run over all categorical protected columns.
Example: Suppose we had data with a protected feature ('gender'). If there was another feature, like 'title', which was highly associated with 'gender', this test would raise a warning if the mutual information between those two features was particularly high.
Subset Sensitivity (Pos Pred)
This test measures how sensitive the model is to substituting the lowest performing subset of a feature into a sample of data. The test splits the dataset into various subsets based on the feature values and finds the lowest performing subset, based on the lowest Positive Prediction Rate. The test then substitutes this subset into a sample from the original data and calculates the change in Positive Prediction Rate. This test fails if the Positive Prediction Rate changes significantly between the original rows and the rows substituted with the lowest performing subset.
Policies: NIST Map 1.5, NIST Map 1.6, NIST Map 2.3, NIST Measure 2.11
Why it matters: Assessing differences in model output is an important measure of fairness. If the model performs worse because of the value of a protected feature such as race or gender, then this could indicate bias. It can be useful in legal/compliance settings where we fundamentally want the prediction for any protected group to be the same as for other groups.
Configuration: By default, the subset sensitivity is computed for all protected features that are strings.
Example: Suppose the data had the following protected feature 'animal': ['cat', 'cat', 'cat', 'dog', 'dog', 'dog', 'horse', 'horse'], and model predictions for cat were the lowest. If substituting cat for dog and horse in the other inputs causes model predictions to decrease, then this would indicate a failure because the model disadvantages cats.
Subset Sensitivity (Avg Pred)
This test measures how sensitive the model is to substituting the lowest performing subset of a feature into a sample of data. The test splits the dataset into various subsets based on the feature values and finds the lowest performing subset, based on the lowest Average Prediction. The test then substitutes this subset into a sample from the original data and calculates the change in Average Prediction. This test fails if the Average Prediction changes significantly between the original rows and the rows substituted with the lowest performing subset.
Policies: NIST Map 1.5, NIST Map 1.6, NIST Map 2.3, NIST Measure 2.11
Why it matters: Assessing differences in model output is an important measure of fairness. If the model performs worse because of the value of a protected feature such as race or gender, then this could indicate bias. It can be useful in legal/compliance settings where we fundamentally want the prediction for any protected group to be the same as for other groups.
Configuration: By default, the subset sensitivity is computed for all protected features that are strings.
Example: Suppose the data had the following protected feature 'animal': ['cat', 'cat', 'cat', 'dog', 'dog', 'dog', 'horse', 'horse'], and model predictions for cat were the lowest. If substituting cat for dog and horse in the other inputs causes model predictions to decrease, then this would indicate a failure because the model disadvantages cats.
Subset Sensitivity (Avg Rank)
This test measures how sensitive the model is to substituting the lowest performing subset of a feature into a sample of data. The test splits the dataset into various subsets based on the feature values and finds the lowest performing subset, based on the lowest Average Rank. The test then substitutes this subset into a sample from the original data and calculates the change in Average Rank. This test fails if the Average Rank changes significantly between the original rows and the rows substituted with the lowest performing subset.
Policies: NIST Map 1.5, NIST Map 1.6, NIST Map 2.3, NIST Measure 2.11
Why it matters: Assessing differences in model output is an important measure of fairness. If the model performs worse because of the value of a protected feature such as race or gender, then this could indicate bias. It can be useful in legal/compliance settings where we fundamentally want the prediction for any protected group to be the same as for other groups.
Configuration: By default, the subset sensitivity is computed for all protected features that are strings.
Example: Suppose the data had the following protected feature 'animal': ['cat', 'cat', 'cat', 'dog', 'dog', 'dog', 'horse', 'horse'], and model predictions for cat were the lowest. If substituting cat for dog and horse in the other inputs causes model predictions to decrease, then this would indicate a failure because the model disadvantages cats.
Gendered Pronoun Distribution
This test checks that both masculine and feminine pronouns are approximately equally likely to be predicted by the fill-mask model for various templates.
Policies: NIST Map 1.5, NIST Map 1.6, NIST Measure 2.11
Why it matters: Fill-mask models can be tested for gender bias by analyzing predictions for a masked portion of a semantically-bleached template. If a model is significantly more likely to suggest a masculine or feminine pronoun within a sentence relative to its counterpart, it may be learning biased behaviors, which can have important ethical implications.
Configuration: This test runs only on fill-mask model tasks.
Example: Suppose we had the masked template [MASK] runs this company.. We can configure this test to check that both she or he have similar probabilities of being chosen by the model.
Fill Mask Invariance
This test uses templates to check that word associations of fill-mask models are similar for majority and protected minority groups.
Policies: NIST Map 1.5, NIST Map 1.6, NIST Measure 2.11
Why it matters: Fill-mask models are vulnerable to significant bias based on the target groups provided in a semantically-bleached template. If a model is significantly more likely to suggest certain attributes within a sentence for one protected group relative to a counterpart, it may be learning biased behaviors, which can have important ethical implications.
Configuration: This test runs only on fill-mask model tasks.
Example: Suppose we had this pair of masked templates: She is very [MASK] and He is very [MASK].We can configure this test to check that the model suggests similar attributes for both templates. A biased model may return very different responses, like beautiful for the first template and intelligent for the second template, which could be a sign the model is learning biased or stereotypical behaviors.
Replace Masculine with Feminine Pronouns
This test measures the robustness of your model to Replace Masculine with Feminine Pronouns transformations. It does this by taking a sample input, swapping all masculine pronouns from the input string to feminine ones, and measuring the behavior of the model on the transformed input.
Policies: NIST Map 1.5, NIST Map 1.6, NIST Measure 2.11
Why it matters: Production natural language input sequences can have errors from data preprocessing or human input (mistaken or adversarial). It is important that your language models are robust to the introduction of such errors.
Configuration: By default, this test runs over a sample of strings from the evaluation set, and it performs this attack on 5% of the words in each input.
Example: Given an input sequence "He was elected because his opponent dropped out", this test measures the performance of the model when given the transformed input of "She was elected because her opponent dropped out".
Replace Feminine with Masculine Pronouns
This test measures the robustness of your model to Replace Feminine with Masculine Pronouns transformations. It does this by taking a sample input, swapping all feminine pronouns from the input string to masculine ones, and measuring the behavior of the model on the transformed input.
Policies: NIST Map 1.5, NIST Map 1.6, NIST Measure 2.11
Why it matters: Production natural language input sequences can have errors from data preprocessing or human input (mistaken or adversarial). It is important that your language models are robust to the introduction of such errors.
Configuration: By default, this test runs over a sample of strings from the evaluation set, and it performs this attack on 5% of the words in each input.
Example: Given an input sequence "She was elected because her opponent dropped out", this test measures the performance of the model when given the transformed input of "He was elected because his opponent dropped out".
Replace Masculine with Feminine Names
This test measures the invariance of your model to swapping gendered names transformations. It does this by taking a sample input, swapping all instances of traditionally masculine names (in the provided list) with a traditionally feminine name, and measuring the behavior of the model on the transformed input.
Policies: NIST Map 1.5, NIST Map 1.6, NIST Measure 2.11
Why it matters: Production natural language input sequences should properly support people of all demographics. It is important that your language models are robust to spurious correlations and bias from the data.
Configuration: By default, this test runs over a sample of text instances from the evaluation set that containone or more words from the source list.
Example: Given an input sequence "Amy is a good student.", this test measures the behavior of the model when given the transformed input of "Adrian is a good student.".
Replace Feminine with Masculine Names
This test measures the invariance of your model to swapping gendered names transformations. It does this by taking a sample input, swapping all instances of traditionally feminine names (in the provided list) with a traditionally masculine name, and measuring the behavior of the model on the transformed input.
Policies: NIST Map 1.5, NIST Map 1.6, NIST Measure 2.11
Why it matters: Production natural language input sequences should properly support people of all demographics. It is important that your language models are robust to spurious correlations and bias from the data.
Configuration: By default, this test runs over a sample of text instances from the evaluation set that containone or more words from the source list.
Example: Given an input sequence "Adrian is a good student.", this test measures the behavior of the model when given the transformed input of "Amy is a good student.".
Replace Masculine with Plural Pronouns
This test measures the robustness of your model to Replace Masculine with Plural Pronouns transformations. It does this by taking a sample input, swapping all masculine pronouns from the input string to plural ones, and measuring the behavior of the model on the transformed input.
Policies: NIST Map 1.5, NIST Map 1.6, NIST Measure 2.11
Why it matters: Production natural language input sequences can have errors from data preprocessing or human input (mistaken or adversarial). It is important that your language models are robust to the introduction of such errors.
Configuration: By default, this test runs over a sample of strings from the evaluation set, and it performs this attack on 5% of the words in each input.
Example: Given an input sequence "He got elected because his opponent dropped out", this test measures the performance of the model when given the transformed input of "They got elected because their opponent dropped out".
Replace Feminine with Plural Pronouns
This test measures the robustness of your model to Replace Feminine with Plural Pronouns transformations. It does this by taking a sample input, swapping all feminine pronouns from the input string to plural ones, and measuring the behavior of the model on the transformed input.
Policies: NIST Map 1.5, NIST Map 1.6, NIST Measure 2.11
Why it matters: Production natural language input sequences can have errors from data preprocessing or human input (mistaken or adversarial). It is important that your language models are robust to the introduction of such errors.
Configuration: By default, this test runs over a sample of strings from the evaluation set, and it performs this attack on 5% of the words in each input.
Example: Given an input sequence "She got elected because her opponent dropped out", this test measures the performance of the model when given the transformed input of "They got elected because their opponent dropped out".
Swap High Income with Low Income Countries
This test measures the invariance of your model to country name swap transformations. It does this by taking a sample input, swapping all instances of traditionally high-income countries (in the provided list) with a traditionally low-income country, and measuring the behavior of the model on the transformed input.
Policies: NIST Map 1.5, NIST Map 1.6, NIST Measure 2.11
Why it matters: Production natural language input sequences should properly support people of all demographics. It is important that your language models are robust to spurious correlations and bias from the data.
Configuration: By default, this test runs over a sample of text instances from the evaluation set that containone or more words from the source list.
Example: Given an input sequence "I grew up in Yemen.", this test measures the behavior of the model when given the transformed input of "I grew up in Germany.".
Swap Low Income with High Income Countries
This test measures the invariance of your model to country name swap transformations. It does this by taking a sample input, swapping all instances of traditionally low-income countries (in the provided list) with a traditionally high-income country, and measuring the behavior of the model on the transformed input.
Policies: NIST Map 1.5, NIST Map 1.6, NIST Measure 2.11
Why it matters: Production natural language input sequences should properly support people of all demographics. It is important that your language models are robust to spurious correlations and bias from the data.
Configuration: By default, this test runs over a sample of text instances from the evaluation set that containone or more words from the source list.
Example: Given an input sequence "I grew up in Germany.", this test measures the behavior of the model when given the transformed input of "I grew up in Yemen.".
Swap Majority Ethnicity Names with Minority Names
This test measures the invariance of your model to swapping names of various ethnicities transformations. It does this by taking a sample input, swapping all instances of traditionally majority names (in the provided list) with a traditionally minority name, and measuring the behavior of the model on the transformed input.
Policies: NIST Map 1.5, NIST Map 1.6, NIST Measure 2.11
Why it matters: Production natural language input sequences should properly support people of all demographics. It is important that your language models are robust to spurious correlations and bias from the data.
Configuration: By default, this test runs over a sample of text instances from the evaluation set that containone or more words from the source list.
Example: Given an input sequence "Alberto is a good student.", this test measures the behavior of the model when given the transformed input of "Adrian is a good student.".
Swap Minority Ethnicity Names with Majority Names
This test measures the invariance of your model to swapping names of various ethnicities transformations. It does this by taking a sample input, swapping all instances of traditionally minority names (in the provided list) with a traditionally majority name, and measuring the behavior of the model on the transformed input.
Policies: NIST Map 1.5, NIST Map 1.6, NIST Measure 2.11
Why it matters: Production natural language input sequences should properly support people of all demographics. It is important that your language models are robust to spurious correlations and bias from the data.
Configuration: By default, this test runs over a sample of text instances from the evaluation set that containone or more words from the source list.
Example: Given an input sequence "Adrian is a good student.", this test measures the behavior of the model when given the transformed input of "Alberto is a good student.".
Transformations
Out of Range Substitution
This test measures the impact on the model when we substitute values outside the inferred range of allowed values into clean datapoints.
Policies: NIST Measure 2.5
Why it matters: In production, the model may encounter corrupted or manipulated out of range values. It is important that the model is robust to such extremities.
Configuration: By default, this test runs over all numeric features.
Example: In the reference set, the Age feature has a range of [0, 121]. This test raises a warning if substituting values outside of this range into Age (eg. 150, 200) causes model performance to decrease.
Numeric Outliers Substitution
This test measures the impact on the model when we substitute outliers into clean datapoints. Outliers are values which may not necessarily be outside of an allowed range for a feature, but are extreme values that are unusual and may be indicative of abnormality.
Policies: NIST Measure 2.5
Why it matters: Outliers can be a sign of corrupted or otherwise erroneous data, and can degrade model performance if used in the training data, or lead to unexpected behaviour if input at inference time.
Configuration: By default this test is run over each numeric feature that is neither unique nor ascending.
Example: Suppose there is a normally distributed feature age for which the reference set has a mean of 45 and a standard deviation of 10. The test would infer a lower outlier bound of 15 and an upper outlier bound of 75 by subtracting and adding 3 standard deviations from the mean, respectively. This test raises a warning if substituting outliers into age causes model performance to decrease.
Feature Type Change
This test measures the impact on the model when we substitute valid feature values with values of the incorrect type.
Policies: NIST Measure 2.5, NIST Measure 2.6
Why it matters: A feature may require a specific type. However, errors in the data pipeline may produce values that are outside the expected type. Failing to catch such errors may lead to errors or undefined behavior from the model.
Configuration: By default, this test runs over all features.
Example: Say that the feature Cost requires the float type. This test raises a warning if changing values in Cost to a different type causes model performance to decrease.
Empty String Substitution
This test measures the impact on the model when we substitute empty string values instead of null values into clean datapoints.
Policies: NIST Measure 2.5, NIST Measure 2.6
Why it matters: In production, the model may encounter corrupted or manipulated string values. Null values and empty strings are often expected to be treated the same, but the model might not treat them that way. It is important that the model is robust to such extremities.
Configuration: By default, this test runs over all string features with null values.
Example: In the reference set, the Name feature contains nulls. This test raises a warning if substituting empty strings instead of null values into the Name feature causes model performance to decrease.
Required Characters Deletion
This test measures the impact on the model when we delete required characters, inferred from the reference set, from the strings of clean datapoints.
Policies: NIST Measure 2.5
Why it matters: A feature may require specific characters. However, errors in the data pipeline may allow invalid data points that lack these required characters to pass. Failing to catch such errors may lead to noisier training data or noisier predictions during inference, which can degrade model metrics.
Configuration: By default, this test runs over all string features that are inferred to have required characters.
Example: Say that the feature email requires the character @. This test raises a warning if removing @ from values in email causes model performance to decrease
Unseen Categorical Substitution
This test measures the impact on the model when we substitute unseen categorical values into clean datapoints.
Policies: NIST Measure 2.5, NIST Measure 2.6
Why it matters: Unseen categorical values are a common failure point in machine learning systems; since these models are trained over a reference set, they may yield uninterpretable or undefined behavior when interacting with an unseen categorical value. In addition, such errors may expose gaps or errors in data collection.
Configuration: By default, this test runs over all categorical features.
Example: Say that the feature Animal contains the values ['Cat', 'Dog'] from the reference set. This test raises a warning if substituting unseen values into the feature Animal causes model performance to decrease.
Null Substitution
This test measures the impact on the model when we substitute nulls in features that should not have nulls into clean datapoints.
Policies: NIST Measure 2.5, NIST Measure 2.6
Why it matters: The model may make certain assumptions about a column depending on whether or not it had nulls in the training data. If these assumptions break during production, this may damage the model's performance. For example, if a column was never null during training then a model may not have learned to be robust against noise in that column.
Configuration: By default, this test runs over all columns that had zero nulls in the reference set.
Example: Suppose that the feature Age was never null in the reference set. This test raises a warning if substituting nulls into the Age feature causes model performance to decrease.
Capitalization Change
This test measures the impact on the model when we substitute different types of capitalization into clean datapoints.
Policies: NIST Measure 2.5
Why it matters: In production, models can come across the same value with different capitalizations, making it important to explicitly check that your model is invariant to such differences.
Configuration: By default, this test runs over all categorical features.
Example: Suppose we had a column that corresponded to country code. For a specific row, let's say the observed value in the reference set was USA. This test raises a warning if substituting different capitalizations of USA, eg.usa, causes model performance to decrease.
Identity
This test measures the robustness of your model to Identity transformations. It does this by taking a sample input, doing nothing to it, and measuring the behavior of the model on the same input on two different occasions. The purpose of this test is to ensure that the model's predictions are stable when passed the same input twice, since LLMs can be highly unstable, especially if they have high settings for parameters like temperature or top_p.
Policies: NIST Measure 2.5
Why it matters: Production natural language input sequences can have errors from data preprocessing or human input (mistaken or adversarial). It is important that your language models are robust to the introduction of such errors.
Configuration: By default, this test runs over a sample of strings from the evaluation set, and it performs this attack on 5% of the words in each input.
Example: Given an input sequence "The boy saw Paris Hilton in Paris", this test measures the performance of the model when given the transformed input of "The boy saw Paris Hilton in Paris".
Upper-Case Text
This test measures the robustness of your model to Upper-Case Text transformations. It does this by taking a sample input, upper-casing all text, and measuring the behavior of the model on the transformed input.
Policies: NIST Measure 2.5
Why it matters: Production natural language input sequences can have errors from data preprocessing or human input (mistaken or adversarial). It is important that your language models are robust to the introduction of such errors.
Configuration: By default, this test runs over a sample of strings from the evaluation set, and it performs this attack on 5% of the words in each input.
Example: Given an input sequence "The boy saw Paris Hilton in Paris", this test measures the performance of the model when given the transformed input of "THE BOY SAW PARIS HILTON IN PARIS".
Lower-Case Text
This test measures the robustness of your model to Lower-Case Text transformations. It does this by taking a sample input, lower-casing all text, and measuring the behavior of the model on the transformed input.
Policies: NIST Measure 2.5
Why it matters: Production natural language input sequences can have errors from data preprocessing or human input (mistaken or adversarial). It is important that your language models are robust to the introduction of such errors.
Configuration: By default, this test runs over a sample of strings from the evaluation set, and it performs this attack on 5% of the words in each input.
Example: Given an input sequence "The boy saw Paris Hilton in Paris", this test measures the performance of the model when given the transformed input of "the boy saw paris hilton in paris".
Remove Special Characters
This test measures the robustness of your model to Remove Special Characters transformations. It does this by taking a sample input, removing all periods and apostrophes from the input string, and measuring the behavior of the model on the transformed input.
Policies: NIST Measure 2.5
Why it matters: Production natural language input sequences can have errors from data preprocessing or human input (mistaken or adversarial). It is important that your language models are robust to the introduction of such errors.
Configuration: By default, this test runs over a sample of strings from the evaluation set, and it performs this attack on 5% of the words in each input.
Example: Given an input sequence "The quick brown fox jumped over the lazy dog...", this test measures the performance of the model when given the transformed input of "The quick brown fox jumped over the lazy dog".
Unicode to ASCII
This test measures the robustness of your model to Unicode to ASCII transformations. It does this by taking a sample input, converting all characters in the input string to their nearest ASCII representation, and measuring the behavior of the model on the transformed input.
Policies: NIST Measure 2.5
Why it matters: Production natural language input sequences can have errors from data preprocessing or human input (mistaken or adversarial). It is important that your language models are robust to the introduction of such errors.
Configuration: By default, this test runs over a sample of strings from the evaluation set, and it performs this attack on 5% of the words in each input.
Example: Given an input sequence "René François Lacôte did not like that movie", this test measures the performance of the model when given the transformed input of "Rene Francois Lacote did not like that movie".
Character Substitution
This test measures the robustness of your model to character substitution attacks. It does this by randomly substituting characters in the input string and measuring your model's performance on the attacked string.
Policies: NIST Measure 2.5
Why it matters: Production natural language input sequences can have errors from data preprocessing or human input (mistaken or adversarial). It is important that your NLP models are robust to the introduction of such errors.
Configuration: By default, this test runs over a sample of strings from the evaluation set, and it performs this attack on 5% of the words in each input.
Example: Given an input sequence "The quick brown fox jumped over the lazy dog", this test measures the performance of the model when given the attacked input of "Tie quick brorn fox tumped over the lyzy dog".
Character Deletion
This test measures the robustness of your model to character deletion attacks. It does this by randomly deleting characters in the input string and measuring your model's performance on the attacked string.
Policies: NIST Measure 2.5
Why it matters: Production natural language input sequences can have errors from data preprocessing or human input (mistaken or adversarial). It is important that your NLP models are robust to the introduction of such errors.
Configuration: By default, this test runs over a sample of strings from the evaluation set, and it performs this attack on 5% of the words in each input.
Example: Given an input sequence "The quick brown fox jumped over the lazy dog", this test measures the performance of the model when given the attacked input of "Th quick brwn fox jumpd over the lazy dog".
Character Insertion
This test measures the robustness of your model to character insertion attacks. It does this by randomly adding characters to the input string and measuring your model's performance on the attacked string.
Policies: NIST Measure 2.5
Why it matters: Production natural language input sequences can have errors from data preprocessing or human input (mistaken or adversarial). It is important that your NLP models are robust to the introduction of such errors.
Configuration: By default, this test runs over a sample of strings from the evaluation set, and it performs this attack on 5% of the words in each input.
Example: Given an input sequence "The quick brown fox jumped over the lazy dog", this test measures the performance of the model when given the attacked input of "Thew quick broqwn fox jumqped over the lazy dog".
Character Swap
This test measures the robustness of your model to character swap attacks. It does this by randomly swapping characters in the input string and measuring your model's performance on the attacked string.
Policies: NIST Measure 2.5
Why it matters: Production natural language input sequences can have errors from data preprocessing or human input (mistaken or adversarial). It is important that your NLP models are robust to the introduction of such errors.
Configuration: By default, this test runs over a sample of strings from the evaluation set, and it performs this attack on 5% of the words in each input.
Example: Given an input sequence "The quick brown fox jumped over the lazy dog", this test measures the performance of the model when given the attacked input of "Teh quick bornw fox ujmpde over the lazy dog".
Keyboard Augmentation
This test measures the robustness of your model to keyboard augmentation attacks. It does this by adding common typos based on keyboard distance to the input string and measuring your model's performance on the attacked string.
Policies: NIST Measure 2.5
Why it matters: Production natural language input sequences can have errors from data preprocessing or human input (mistaken or adversarial). It is important that your NLP models are robust to the introduction of such errors.
Configuration: By default, this test runs over a sample of strings from the evaluation set, and it performs this attack on 5% of the words in each input.
Example: Given an input sequence "The quick brown fox jumped over the lazy dog", this test measures the performance of the model when given the attacked input of "Thr quick browb fox jumled over the lazy dog".
Common Misspellings
This test measures the robustness of your model to common misspellings attacks. It does this by adding common misspellings to the input string and measuring your model's performance on the attacked string.
Policies: NIST Measure 2.5
Why it matters: Production natural language input sequences can have errors from data preprocessing or human input (mistaken or adversarial). It is important that your NLP models are robust to the introduction of such errors.
Configuration: By default, this test runs over a sample of strings from the evaluation set, and it performs this attack on 5% of the words in each input.
Example: Given an input sequence "The quick brown fox jumped over the lazy dog", this test measures the performance of the model when given the attacked input of "Thee quik brown focks jumped over the lasy dog".
OCR Error Simulation
This test measures the robustness of your model to ocr error simulation attacks. It does this by adding common OCR errors to the input string and measuring your model's performance on the attacked string.
Policies: NIST Measure 2.5
Why it matters: Production natural language input sequences can have errors from data preprocessing or human input (mistaken or adversarial). It is important that your NLP models are robust to the introduction of such errors.
Configuration: By default, this test runs over a sample of strings from the evaluation set, and it performs this attack on 5% of the words in each input.
Example: Given an input sequence "The quick brown fox jumped over the lazy dog", this test measures the performance of the model when given the attacked input of "Th3 quick br0wn fox jumped over the 1azy d0g".
Synonym Swap
This test measures the robustness of your model to synonym swap attacks. It does this by randomly swapping synonyms in the input string and measuring your model's performance on the attacked string.
Policies: NIST Measure 2.5
Why it matters: Production natural language input sequences can have errors from data preprocessing or human input (mistaken or adversarial). It is important that your NLP models are robust to the introduction of such errors.
Configuration: By default, this test runs over a sample of strings from the evaluation set, and it performs this attack on 5% of the words in each input.
Example: Given an input sequence "The quick brown fox jumped over the lazy dog", this test measures the performance of the model when given the attacked input of "The fast brown fox leaped over the lazy dog".
Contextual Word Swap
This test measures the robustness of your model to contextual word swap attacks. It does this by replacing words with those close in embedding space and measuring your model's performance on the attacked string.
Policies: NIST Measure 2.5
Why it matters: Production natural language input sequences can have errors from data preprocessing or human input (mistaken or adversarial). It is important that your NLP models are robust to the introduction of such errors.
Configuration: By default, this test runs over a sample of strings from the evaluation set, and it performs this attack on 5% of the words in each input.
Example: Given an input sequence "The quick brown fox jumped over the lazy dog", this test measures the performance of the model when given the attacked input of "the fast brown pigeon leaped over the white dog".
Contextual Word Insertion
This test measures the robustness of your model to contextual word insertion attacks. It does this by inserting words generated from a language model and measuring your model's performance on the attacked string.
Policies: NIST Measure 2.5
Why it matters: Production natural language input sequences can have errors from data preprocessing or human input (mistaken or adversarial). It is important that your NLP models are robust to the introduction of such errors.
Configuration: By default, this test runs over a sample of strings from the evaluation set, and it performs this attack on 5% of the words in each input.
Example: Given an input sequence "The quick brown fox jumped over the lazy dog", this test measures the performance of the model when given the attacked input of "the fast brown fox leaped away over the lazy dog".
Lower-Case Entity
This test measures the robustness of your model to Lower-Case Entity transformations. It does this by taking a sample input, lower-casing all entities, and measuring the behavior of the model on the transformed input.
Policies: NIST Measure 2.5
Why it matters: Production natural language input sequences can have errors from data preprocessing or human input (mistaken or adversarial). It is important that your language models are robust to the introduction of such errors.
Configuration: By default, this test runs over a sample of strings from the evaluation set, and it performs this attack on 30% of the words in each input.
Example: Given an input sequence "The boy saw Paris Hilton in Paris", this test measures the performance of the model when given the transformed input of "The boy saw paris hilton in paris".
Upper-Case Entity
This test measures the robustness of your model to Upper-Case Entity transformations. It does this by taking a sample input, upper-casing all entities, and measuring the behavior of the model on the transformed input.
Policies: NIST Measure 2.5
Why it matters: Production natural language input sequences can have errors from data preprocessing or human input (mistaken or adversarial). It is important that your language models are robust to the introduction of such errors.
Configuration: By default, this test runs over a sample of strings from the evaluation set, and it performs this attack on 30% of the words in each input.
Example: Given an input sequence "The boy saw Paris Hilton in Paris", this test measures the performance of the model when given the transformed input of "The boy saw PARIS HILTON in PARIS".
Ampersand
This test measures the robustness of your model to Ampersand transformations. It does this by taking a sample input, changing & to and, and measuring the behavior of the model on the transformed input.
Policies: NIST Measure 2.5
Why it matters: Production natural language input sequences can have errors from data preprocessing or human input (mistaken or adversarial). It is important that your language models are robust to the introduction of such errors.
Configuration: By default, this test runs over a sample of strings from the evaluation set, and it performs this attack on 30% of the words in each input.
Example: Given an input sequence "Peanut Butter & Jelly", this test measures the performance of the model when given the transformed input of "Peanut Butter and Jelly".
Abbreviation Expander
This test measures the robustness of your model to Abbreviation Expander transformations. It does this by taking a sample input, expanding abbreviations in entities, and measuring the behavior of the model on the transformed input.
Policies: NIST Measure 2.5
Why it matters: Production natural language input sequences can have errors from data preprocessing or human input (mistaken or adversarial). It is important that your language models are robust to the introduction of such errors.
Configuration: By default, this test runs over a sample of strings from the evaluation set, and it performs this attack on 30% of the words in each input.
Example: Given an input sequence "Monsters Inc.", this test measures the performance of the model when given the transformed input of "Monsters Incorporated".
Whitespace Around Special Character
This test measures the robustness of your model to Whitespace Around Special Character transformations. It does this by taking a sample input, adding whitespace around special characters, and measuring the behavior of the model on the transformed input.
Policies: NIST Measure 2.5
Why it matters: Production natural language input sequences can have errors from data preprocessing or human input (mistaken or adversarial). It is important that your language models are robust to the introduction of such errors.
Configuration: By default, this test runs over a sample of strings from the evaluation set, and it performs this attack on 30% of the words in each input.
Example: Given an input sequence "Hi customer. That'll be $50.", this test measures the performance of the model when given the transformed input of "Hi customer . That ' ll be $ 50 .".
Entity Unicode to ASCII
This test measures the robustness of your model to Entity Unicode to ASCII transformations. It does this by taking a sample input, converting all characters in the input string to their nearest ASCII representation, and measuring the behavior of the model on the transformed input.
Policies: NIST Measure 2.5
Why it matters: Production natural language input sequences can have errors from data preprocessing or human input (mistaken or adversarial). It is important that your language models are robust to the introduction of such errors.
Configuration: By default, this test runs over a sample of strings from the evaluation set, and it performs this attack on 30% of the words in each input.
Example: Given an input sequence "René François Lacôte did not like that movie", this test measures the performance of the model when given the transformed input of "Rene Francois Lacote did not like that movie".
Entity Remove Special Characters
This test measures the robustness of your model to Entity Remove Special Characters transformations. It does this by taking a sample input, removing all periods and apostrophes from the input string, and measuring the behavior of the model on the transformed input.
Policies: NIST Measure 2.5
Why it matters: Production natural language input sequences can have errors from data preprocessing or human input (mistaken or adversarial). It is important that your language models are robust to the introduction of such errors.
Configuration: By default, this test runs over a sample of strings from the evaluation set, and it performs this attack on 30% of the words in each input.
Example: Given an input sequence "The quick brown fox jumped over the lazy dog...", this test measures the performance of the model when given the transformed input of "The quick brown fox jumped over the lazy dog".
Swap Seen Entities
This test measures the robustness of your model to Swap Seen Entities transformations. It does this by taking a sample input, swapping all the entities in a text with random entities of the same type seen in the rest of the data, and measuring the behavior of the model on the transformed input.
Policies: NIST Measure 2.5
Why it matters: Production natural language input sequences can have errors from data preprocessing or human input (mistaken or adversarial). It is important that your language models are robust to the introduction of such errors.
Configuration: By default, this test runs over a sample of strings from the evaluation set, and it performs this attack on 30% of the words in each input.
Example: Given an input sequence "Gabriela Szabo ( Romania ) 15 minutes 04.95 seconds", this test measures the performance of the model when given the transformed input of "Asif Mujtaba ( Luxembourg ) 15 minutes 04.95 seconds".
Swap Unseen Entities
This test measures the robustness of your model to Swap Unseen Entities transformations. It does this by taking a sample input, swapping all the entities in a text with random entities of the same category, unseen in the data, and measuring the behavior of the model on the transformed input. This test supports swapping entities from commonly-appearing categories in NER tasks: Person, Geopolitical Entity, Location, Nationality, Product, Corporation, and Organization.
Policies: NIST Measure 2.5
Why it matters: Production natural language input sequences can have errors from data preprocessing or human input (mistaken or adversarial). It is important that your language models are robust to the introduction of such errors.
Configuration: By default, this test runs over a sample of strings from the evaluation set, and it performs this attack on 30% of the words in each input.
Example: Given an input sequence "DNIB also set a 110 million guilder step-up bond.", this test measures the performance of the model when given the transformed input of "New Oromio Insurance LLC also set a 110 million guilder step-up bond.".
Gaussian Blur
This test measures the robustness of your model to Gaussian Blur transformations. It does this by taking a sample input, blurring the image, and measuring the behavior of the model on the transformed input.
Policies: N/A
Why it matters: Production inputs can have unusual variations amongst many different dimensions, ranging from lighting changes to sensor errors to compression artifacts. It is important that your models are robust to the introduction of such variations.
Color Jitter
This test measures the robustness of your model to Color Jitter transformations. It does this by taking a sample input, jittering the image colors, and measuring the behavior of the model on the transformed input.
Policies: N/A
Why it matters: Production inputs can have unusual variations amongst many different dimensions, ranging from lighting changes to sensor errors to compression artifacts. It is important that your models are robust to the introduction of such variations.
Gaussian Noise
This test measures the robustness of your model to Gaussian Noise transformations. It does this by taking a sample input, adding gaussian noise to the image, and measuring the behavior of the model on the transformed input.
Policies: N/A
Why it matters: Production inputs can have unusual variations amongst many different dimensions, ranging from lighting changes to sensor errors to compression artifacts. It is important that your models are robust to the introduction of such variations.
Vertical Flip
This test measures the robustness of your model to Vertical Flip transformations. It does this by taking a sample input, flipping the image vertically, and measuring the behavior of the model on the transformed input.
Policies: N/A
Why it matters: Production inputs can have unusual variations amongst many different dimensions, ranging from lighting changes to sensor errors to compression artifacts. It is important that your models are robust to the introduction of such variations.
Horizontal Flip
This test measures the robustness of your model to Horizontal Flip transformations. It does this by taking a sample input, flipping the image horizontally, and measuring the behavior of the model on the transformed input.
Policies: N/A
Why it matters: Production inputs can have unusual variations amongst many different dimensions, ranging from lighting changes to sensor errors to compression artifacts. It is important that your models are robust to the introduction of such variations.
Randomize Pixels With Mask
This test measures the robustness of your model to Randomize Pixels With Mask transformations. It does this by taking a sample input, randomizing pixels with fixed probability, and measuring the behavior of the model on the transformed input.
Policies: N/A
Why it matters: Production inputs can have unusual variations amongst many different dimensions, ranging from lighting changes to sensor errors to compression artifacts. It is important that your models are robust to the introduction of such variations.
Contrast Increase
This test measures the robustness of your model to Contrast Increase transformations. It does this by taking a sample input, increase image contrast, and measuring the behavior of the model on the transformed input.
Policies: N/A
Why it matters: Production inputs can have unusual variations amongst many different dimensions, ranging from lighting changes to sensor errors to compression artifacts. It is important that your models are robust to the introduction of such variations.
Contrast Decrease
This test measures the robustness of your model to Contrast Decrease transformations. It does this by taking a sample input, decrease image contrast, and measuring the behavior of the model on the transformed input.
Policies: N/A
Why it matters: Production inputs can have unusual variations amongst many different dimensions, ranging from lighting changes to sensor errors to compression artifacts. It is important that your models are robust to the introduction of such variations.
Motion Blur
This test measures the robustness of your model to Motion Blur transformations. It does this by taking a sample input, motion blurring the image, and measuring the behavior of the model on the transformed input.
Policies: N/A
Why it matters: Production inputs can have unusual variations amongst many different dimensions, ranging from lighting changes to sensor errors to compression artifacts. It is important that your models are robust to the introduction of such variations.
Add Rain
This test measures the robustness of your model to Add Rain transformations. It does this by taking a sample input, adding rain texture to the image, and measuring the behavior of the model on the transformed input.
Policies: N/A
Why it matters: Production inputs can have unusual variations amongst many different dimensions, ranging from lighting changes to sensor errors to compression artifacts. It is important that your models are robust to the introduction of such variations.
Add Snow
This test measures the robustness of your model to Add Snow transformations. It does this by taking a sample input, adding snow texture to the image, and measuring the behavior of the model on the transformed input.
Policies: N/A
Why it matters: Production inputs can have unusual variations amongst many different dimensions, ranging from lighting changes to sensor errors to compression artifacts. It is important that your models are robust to the introduction of such variations.
Drift
Correlation Drift (Feature-to-Feature)
This test measures the severity of feature-feature correlation drift from the reference to the evaluation set for a given pair of features. The severity is a function of the correlation drift in the data. The key detail is the difference in correlation scores between the reference and evaluation sets, along with an associated p-value. Correlation is a measure of the linear relationship between two numeric columns (feature-feature) so this test checks for significant changes in this relationship between each feature-feature in the reference and evaluation sets. To compute the p-value, we use Fisher's z-transformation to convert the distribution of sample correlations to a normal distribution, and then we run a standard two-sample test on two normal distributions.
Policies: NIST Map 2.3, NIST Measure 2.4, NIST Measure 2.5
Why it matters: Correlation drift between training and inference can be caused by a variety of factors, including a change in the data generation process or a change in the underlying processing stage. A big shift in these dependencies could indicate shifting datasets and degradation in model performance, signaling the need for relabeling and retraining.
Configuration: By default, this test runs over all pairs of features in the dataset.
Example: Suppose that the correlation between country and state is 0.5 in the reference set but 0.7 in the evaluation set, and the p-value is 0.03. Then the large difference in scores indicates that the dependency between the two features has drifted. If our difference threshold was 0.2, and p-value threshold was 0.05, then the test would fail.
Correlation Drift (Feature-to-Label)
This test measures the severity of feature-label correlation drift from the reference to the evaluation set for a given pair of a feature and label. The severity is a function of the correlation drift in the data. The key detail is the difference in correlation scores between the reference and evaluation sets, along with an associated p-value. Correlation is a measure of the linear relationship between two numeric columns (feature-label) so this test checks for significant changes in this relationship between each feature-label in the reference and evaluation sets. To compute the p-value, we use Fisher's z-transformation to convert the distribution of sample correlations to a normal distribution, and then we run a standard two-sample test on two normal distributions.
Policies: NIST Map 2.3, NIST Measure 2.4, NIST Measure 2.5
Why it matters: Correlation drift between training and inference can be caused by a variety of factors, including a change in the data generation process or a change in the underlying processing stage. A big shift in these dependencies could indicate shifting datasets and degradation in model performance, signaling the need for relabeling and retraining.
Configuration: By default, this test runs over all pairs of features and labels in the dataset.
Example: Suppose that the correlation between LotArea and SalePrice is 0.4 in the reference set but 0.8 in the evaluation set, and the p-value is 0.15. Then the large difference in scores indicates that the impact of the feature on the label has drifted. If our difference threshold was 0.2, and p-value threshold was 0.05, then the test would fail.
Mutual Information Drift (Feature-to-Feature)
This test measures the severity of feature mutual information drift from the reference to the evaluation set for a given pair of features. The severity is a function of the mutual information drift in the data. The key detail is the difference in mutual information scores between the reference and evaluation sets. Mutual information is a measure of how dependent two features are, so this checks for significant changes in dependence between pairs of features in the reference and evaluation sets.
Policies: NIST Measure 2.4
Why it matters: Mutual information drift between training and inference can be caused by a variety of factors, including a change in the data generation process or a change in the underlying processing stage. A big shift in these dependencies could indicate shifting datasets and degradation in model performance, signaling the need for relabeling and retraining.
Configuration: By default, this test runs over all pairs of features in the dataset.
Example: Suppose that the mutual information between country and state is 0.5 in the reference set but 0.7 in the evaluation set. Then the large difference in scores indicates that the dependency between the two features has drifted. If our difference threshold was 0.2 then the test would fail.
Mutual Information Drift (Feature-to-Label)
This test measures the severity of feature mutual information drift from the reference to the evaluation set for a given pair of features. The severity is a function of the mutual information drift in the data. The key detail is the difference in mutual information scores between the reference and evaluation sets. Mutual information is a measure of how dependent two features are, so this checks for significant changes in dependence between pairs of features in the reference and evaluation sets.
Policies: NIST Map 2.3, NIST Measure 2.4, NIST Measure 2.5
Why it matters: Mutual information drift between training and inference can be caused by a variety of factors, including a change in the data generation process or a change in the underlying processing stage. A big shift in these dependencies could indicate shifting datasets and degradation in model performance, signaling the need for relabeling and retraining.
Configuration: By default, this test runs over all pairs of features in the dataset.
Example: Suppose that the mutual information between country and state is 0.5 in the reference set but 0.7 in the evaluation set. Then the large difference in scores indicates that the dependency between the two features has drifted. If our difference threshold was 0.2 then the test would fail.
Label Drift (Categorical)
This test checks that the difference in label distribution between the reference and evaluation sets is small, using PSI test. The key detail displayed is the PSI statistic which is a measure of how different the frequencies of the column in the reference and evaluation sets are.
Policies: NIST Measure 2.4
Why it matters: Label distribution shift between reference and test can indicate that the underlying data distribution has changed significantly enough to modify model decisions. This may mean that the model needs to be retrained to adjust to the new data environment. In addition, significant label distribution shift may indicate that upstream decision-making modules (e.g. thresholds) may need to be updated.
Configuration: This test is run by default whenever both the reference and evaluation sets have associated labels.
Example: Suppose that the observed frequencies of the label column is [100, 200] in the reference set but [25, 150] in the test set. Then the PSI would be 0.201. If our PSI threshold was 0.1 then the test would fail.
Predicted Label Drift
This test checks that the difference in predicted label distribution between the reference and evaluation sets is small, using PSI test. The key detail displayed is the PSI statistic which is a measure of how different the frequencies of the column in the reference and evaluation sets are.
Policies: NIST Measure 2.4
Why it matters: Predicted Label distribution shift between reference and test can indicate that the underlying data distribution has changed significantly enough to modify model decisions. This may mean that the model needs to be retrained to adjust to the new data environment. In addition, significant predicted label distribution shift may indicate that upstream decision-making modules (e.g. thresholds) may need to be updated.
Configuration: This test is run by default whenever the model or predictions is provided.
Example: Suppose that the observed frequencies of the predicted label column is [100, 200] in the reference set but [25, 150] in the test set. Then the PSI would be 0.201. If our PSI threshold was 0.1 then the test would fail.
Label Drift (Regression)
This test checks that the difference in label distribution between the reference and evaluation sets is small, using the PSI test. The key detail displayed is the KS statistic which is a measure of how different the labels in the reference and evaluation sets are. Concretely, the KS statistic is the maximum difference of the empirical CDF's of the two label columns.
Policies: NIST Measure 2.4
Why it matters: Label distribution shift between reference and test can indicate that the underlying data distribution has changed significantly enough to modify model decisions. This may mean that the model needs to be retrained to adjust to the new data environment. In addition, significant label distribution shift may indicate that upstream decision-making modules (e.g. thresholds) may need to be updated.
Configuration: This test is run by default whenever both the reference and evaluation sets have associated labels.
Example: Suppose that the distribution of labels changes between the reference and evaluation sets such that PSI these two samples is 0.2. If the PSI threshold is 0.1, then this test would raise a warning.
Feature Drift
This test measures the change in the distribution of a feature by comparing the distribution in an evaluation set to a reference set. The test severity is a function of both the degree to which the distribution has changed and the estimated impact the observed drift has had on model performance.
Policies: NIST Measure 2.4
Why it matters: Distribution shift between training and inference can cause degradation in model performance. If the shift is sufficiently large, retraining the model on newer data may be necessary.
Configuration: By default, this test runs over all feature columns with sufficiently many samples in both the reference and evaluation sets.
Example: Suppose that the distribution of a feature Age shifts between the reference and evaluation sets such that the PSI between these two samples is 0.2. If PSI is configured as the drift statistic for numeric features and the PSI warning threshold is set to 0.1, this test would raise a warning.
Prediction Drift
This test checks that the difference in the prediction distribution between the reference and evaluation sets is small, using Population Stability Index. The key detail displayed is the PSI which is a measure of how different the prediction distributions in the reference and evaluation sets are.
Policies: NIST Measure 2.4
Why it matters: Prediction distribution shift between reference and test can indicate that the underlying data distribution has changed significantly enough to modify model decisions. This may mean that the model needs to be retrained to adjust to the new data environment. In addition, significant prediction distribution drift may indicate that upstream decision-making modules (e.g. thresholds) may need to be updated.
Configuration: This test is run by default whenever both the reference and evaluation sets have associated predictions. Different thresholds are associated with different severities.
Example: Suppose that the PSI between the prediction distributions in the reference and evaluation sets is 0.201. Then if the PSI thresholds are (0.2, 0.6), the test would raise a warning.
Embedding Drift
This test measures the severity of passing to the model data points associated with embeddings that have drifted from the distribution observed in the reference set. The severity is a function of the impact on the model, as well as the presence of drift in the data. The model impact measures how much model performance changes due to drift in the given feature. The key detail is the Euclidean Distance statistic. The Euclidean Distance is defined as the square root of the sum of the squared differences between two vectors X and Y. The normalized version of this metric first divides each vector by its L2 norm. This test takes the normalized Euclidean distance between the centroids of the ref and eval data sets.
Policies: NIST Measure 2.4
Why it matters: Distribution shift between training and inference can cause degradation in model performance. If the shift is sufficiently large, retraining the model on newer data may be necessary.
Configuration: By default, this test runs over all specified embeddings with sufficiently many samples in each of the reference and evaluation sets.
Example: Suppose that the distribution of an embedding User changes between the reference and evaluation sets such that the Euclidean Distance between these two samples is 0.3. If the distance threshold is set to 0.1, this test would raise a warning.
Nulls Per Feature Drift
This test measures the severity of passing to the model data points that have features with a null proportion that has drifted from the distribution observed in the reference set. The severity is a function of the impact on the model, as well as the presence of drift in the data. The model impact measures how much model performance changes due to drift in the given feature. The key detail is the p-value from a two-sample proportion test that checks if there is a statistically significant difference in the frequencies of null values between the reference and evaluation sets.
Policies: NIST Measure 2.4
Why it matters: Distribution drift in null values between training and inference can be caused by a variety of factors, including a change in the data generation process or a change in the preprocessing pipeline. A big shift in null value proportion could indicate a degradation in model performance and signal the need for relabeling and retraining.
Configuration: By default, this test runs over all columns with sufficiently many samples.
Example: Suppose that the observed frequencies of the null values for a given feature is 100/2000 in the reference set but 100/1500 in the test. Then the p-value would be 0.0425. If our p-value threshold was 0.05 then the test would fail.
Nulls Per Row Drift
This test measures the severity of passing to the model data points that have proportions of null values that have drifted from the distribution observed in the reference set. The severity is a function of the impact on the model, as well as the presence of drift in the data. The model impact measures how much predictions change when the observed drift is applied to a given row. The key detail displayed is the PSI statistic that is a measure of how statistically significant the difference in the proportion of null values in a row between the reference and evaluation sets is.
Policies: NIST Measure 2.4
Why it matters: Distribution drift in null values between training and inference can be caused by a variety of factors, including a change in the data generation process or a change in the preprocessing pipeline. A big shift in null value proportion could indicate a degradation in model performance and signal the need for relabeling and retraining.
Configuration: By default, this test runs over all rows.
Example: Suppose that in the reference set 5% of rows had more than three features that were null. If we observe in the evaluation set that now 50% of rows had more than three features that were null, this test would fail, highlighting a large drift in the proportion of features within a row that were null.
Adversarial
Single-Feature Changes
This test measures the severity of passing to the model data points that have been manipulated across a single feature in an unbounded manner. The severity is a function of the impact of these manipulations on the model.
Policies: NIST Map 1.5, NIST Measure 2.5, NIST Measure 2.7
Why it matters: In production, your model will likely come across inputs that are out-of-distribution with respect to the training data, and it is often difficult to know ahead of time how your model will behave on such inputs. 'Attacking' a model in the manner of this test is a technique for finding the out-of-distribution regions of the input space where your model most severely misbehaves, before putting it into production. Rstricting ourselves to changing a single feature at a time is one proxy for what 'realistic' out-of-distribution data can look like.
Configuration: By default, for a given input we aim to change your model's prediction in the opposite direction of the true label. This test raises a warning if the average prediction change that can be achieved exceeds an acceptable threshold.
Example: Suppose your model has an Age feature with observed range 0 to 120. For every row in some sample, this test would search for the value of Age in 0 to 120 that caused the maximal change in prediction in the desired direction.
Bounded Single-Feature Changes
This test measures the severity of passing to the model data points that have been manipulated across a single feature in a bounded manner. The severity is a function of the impact of these manipulations on the model.We bound the manipulations to be less than some fraction of the range of the given feature.
Policies: NIST Map 1.5, NIST Measure 2.5, NIST Measure 2.7
Why it matters: In production, your model will likely come across inputs that are out-of-distribution with respect to the training data, and it is often difficult to know ahead of time how your model will behave on such inputs. 'Attacking' a model in the manner of this test is a technique for finding the out-of-distribution regions of the input space where your model most severely misbehaves, before putting it into production. Restricting ourselves to changing a single feature by a small amount is one proxy for what 'realistic' out-of-distribution data can look like.
Configuration: By default, for a given input we aim to change your model's prediction in the opposite direction of the true label. This test raises a warning if the average prediction change that can be achieved exceeds an acceptable threshold. This test runs only over numeric features.
Example: Suppose your model has an Age feature with observed range 0 to 120, and we restricted ourselves to changes that were no greater than 10% of the feature range. For every row in some sample, this test would search for the value of Age that was at most 12 away from the row's initial Age value and that caused the maximal change in prediction in the desired direction.
Multi-Feature Changes
This test measures the severity of passing to the model data points that have been manipulated across multiple features in an unbounded manner. The severity is a function of the impact of these manipulations on the model.
Policies: NIST Map 1.5, NIST Measure 2.5, NIST Measure 2.7
Why it matters: In production, your model will likely come across inputs that are out-of-distribution with respect to the training data, and it is often difficult to know ahead of time how your model will behave on such inputs. 'Attacking' a model in the manner of this test is a technique for finding the out-of-distribution regions of the input space where your model most severely misbehaves, before putting it into production. Restricting the number of features that can be changed is one proxy for what 'realistic' out-of-distribution data can look like.
Configuration: By default, for a given input we aim to change your model's prediction in the opposite direction of the true label. This test raises a warning if the average prediction change that can be achieved exceeds an acceptable threshold.
Example: Suppose we restricted ourselves to changing 5 features. This means for each input we would search for the 5 feature values change that, when performed together, caused the largest possible change in your model's prediction on that input.
Bounded Multi-Feature Changes
This test measures the severity of passing to the model data points that have been manipulated across multiple features in an bounded manner. The severity is a function of the impact of these manipulations on the model.We bound the manipulations to be less than some fraction of the range of the given feature.
Policies: NIST Map 1.5, NIST Measure 2.5, NIST Measure 2.7
Why it matters: In production, your model will likely come across inputs that are out-of-distribution with respect to the training data, and it is often difficult to know ahead of time how your model will behave on such inputs. 'Attacking' a model in the manner of this test is a technique for finding the out-of-distribution regions of the input space where your model most severely misbehaves, before putting it into production. Restricting the number of features that can be changed and the magnitude of the change that can be made to each feature is one proxy for what 'realistic' out-of-distribution data can look like.
Configuration: By default, for a given input we aim to change your model's prediction in the opposite direction of the true label. This test raises a warning if the average prediction change that can be achieved exceeds an acceptable threshold. This test runs only over numeric features.
Example: Suppose we restricted ourselves to changing 5 features, each by no more than 10% of the range of the given feature. This means for each input we would search for the 5 restricted feature values change that, when performed together, caused the largest possible change in your model's prediction on that input.
Tabular HopSkipJump Attack
This test measures the robustness of your model to HopSkipJump attacks. It does this by taking a sample of inputs, applying a HopSkipJump attack to each input, and measuring the performance of the model on the perturbed input. See the paper "HopSkipJumpAttack: A Query-Efficient Decision-Based Attack" by Chen, et al. (https://arxiv.org/abs/1904.02144) for more details.
Policies: NIST Map 1.5, NIST Measure 2.5, NIST Measure 2.7
Why it matters: Malicious actors can perturb input data to alter model behavior in unexpected ways. It is important that your models are robust to such attacks.
Configuration: By default, this test runs when the "Adversarial" test category is selected.
Invisible Character Attack
This test measures the robustness of your model to invisible character attacks. It does this by taking a sample input, inserting zero-width unicode characters, and measuring the performance of the model on the perturbed input. See the paper "Fall of Giants: How Popular Text-Based MLaaS Fall against a Simple Evasion Attack" by Pajola and Conti (https://arxiv.org/abs/2104.05996) for more details.
Policies: NIST Map 1.5, NIST Measure 2.5
Why it matters: Malicious actors can perturb natural language input sequences to alter model behavior in unexpected ways. It is important that your NLP models are robust to such attacks.
Configuration: By default, this test runs when the "Adversarial" test category is selected.
Example: Given the input sequence "RIME is helpful.", this test measures the performance of the model when imperceptibly perturbed (e.g., when changed to "RIME is helpful.")
Deletion Control Character Attack
This test measures the robustness of your model to deletion control character attacks. It does this by taking a sample input, inserting deletion control characters, and measuring the performance of the model on the perturbed input. See the paper "Bad Characters: Imperceptible NLP Attacks" by Boucher, Shumailov, et al. (https://arxiv.org/abs/2106.09898) for more details.
Policies: NIST Map 1.5, NIST Measure 2.5
Why it matters: Malicious actors can perturb natural language input sequences to alter model behavior in unexpected ways. It is important that your NLP models are robust to such attacks.
Configuration: By default, this test runs when the "Adversarial" test category is selected.
Example: Given the input sequence "RIME is helpful.", this test measures the performance of the model when imperceptibly perturbed (e.g., when changed to "RIME is helpful.")
Intentional Homoglyph Attack
This test measures the robustness of your model to intentional homoglyph attacks. It does this by taking a sample input, substituting homoglyphs designed to look like other characters, and measuring the performance of the model on the perturbed input. See the paper "Bad Characters: Imperceptible NLP Attacks" by Boucher, Shumailov, et al. (https://arxiv.org/abs/2106.09898) for more details.
Policies: NIST Map 1.5, NIST Measure 2.5
Why it matters: Malicious actors can perturb natural language input sequences to alter model behavior in unexpected ways. It is important that your NLP models are robust to such attacks.
Configuration: By default, this test runs when the "Adversarial" test category is selected.
Example: Given the input sequence "RIME is helpful.", this test measures the performance of the model when imperceptibly perturbed (e.g., when changed to "RIME is helpful.")
Confusable Homoglyph Attack
This test measures the robustness of your model to confusable homoglyph attacks. It does this by taking a sample input, substituting homoglyphs that are easily confused with other characters, and measuring the performance of the model on the perturbed input. See the paper "Bad Characters: Imperceptible NLP Attacks" by Boucher, Shumailov, et al. (https://arxiv.org/abs/2106.09898) for more details.
Policies: NIST Map 1.5, NIST Measure 2.5
Why it matters: Malicious actors can perturb natural language input sequences to alter model behavior in unexpected ways. It is important that your NLP models are robust to such attacks.
Configuration: By default, this test runs when the "Adversarial" test category is selected.
Example: Given the input sequence "RIME is helpful.", this test measures the performance of the model when imperceptibly perturbed (e.g., when changed to "RIME is helpful.")
HotFlip Attack
This test measures the robustness of your model to hotflip attacks. It does this by taking a sample input, applying gradient-based token substitutions, and measuring the performance of the model on the perturbed input. See the paper "HotFlip: White-Box Adversarial Examples for Text Classification" by Ebrahimi, Rao, et al. (https://arxiv.org/abs/1712.06751) for more details.
Policies: NIST Map 1.5, NIST Measure 2.5, NIST Measure 2.7
Why it matters: Malicious actors can perturb natural language input sequences to alter model behavior in unexpected ways. It is important that your NLP models are robust to such attacks.
Configuration: By default, this test runs when the "Adversarial" test category is selected.
Example: Given the input sequence "RIME is helpful.", this test measures the performance of the model when perturbed (e.g., when changed to "RIME is useful.").
Universal Prefix Attack
This test measures the robustness of your model to 'universal' adversarial prefix injections. It does this by sampling a batch of inputs, and searching over the model vocabulary to find a prefix that is nonsensical to a reader but that, when prepended to the batch of inputs, will cause the model to output a different prediction. See the paper "Universal Adversarial Triggers for Attacking and Analyzing NLP" by Wallace, Feng, Kandpal, et al. (https://arxiv.org/abs/1908.07125) for more details.
Why it matters: Malicious actors can perturb natural language input sequences to alter model behavior in unexpected ways. 'Universal triggers' pose a particularly large threat since they easily transfer between models and data points to permit an adversary to make large-scale, cost-efficient attacks. It is important that your NLP models are robust to such threat vectors.
Configuration: By default, this test runs when the 'Adversarial' category is specified.
Example: Given a target class of 0, this test selects a batch of inputs for which the model predicts a different class (e.g., 1). It then searches for an adversarial prefix that maximizes the probability assigned to the target class. The severity of this test is based on the difference in the average probability assigned to the target class before and after the prefix is prepended to the batch. For instance, given two inputs "I am happy!" and "I like ice cream!", the attack finds an example prefix, e.g., "the why y could", and measures the new probability assigned by the model to the target class for inputs "the why y could I am happy!" and "the why y could I like ice cream!".
Image HopSkipJump Attack
This test measures the robustness of your model to Image HopSkipJump attacks. It does this by taking a sample input, applying a HopSkipJump attack, and measuring the performance of the model on the perturbed input. See the paper "HopSkipJumpAttack: A Query-Efficient Decision-Based Attack" by Chen, et al. (https://arxiv.org/abs/1904.02144) for more details.
Policies: NIST Map 1.5, NIST Measure 2.5
Why it matters: Malicious actors can perturb input images to alter model behavior in unexpected ways. It is important that your Computer Vision models are robust to such attacks.
Configuration: By default, this test runs when the "Adversarial" test category is selected.
Pixel Attack
This test measures the robustness of your model to Pixel attacks. It does this by taking a sample input, applying a Pixel attack to perturb a bounded number of pixels, and measuring the performance of the model on the perturbed input. See the paper "One pixel attack for fooling deep neural networks" by Su, et al. (https://arxiv.org/abs/1710.08864) for more details.
Policies: N/A
Why it matters: Malicious actors can perturb input images to alter model behavior in unexpected ways. It is important that your Computer Vision models are robust to such attacks.
Configuration: By default, this test runs when the "Adversarial" test category is selected.
Square Attack
This test measures the robustness of your model to Square attacks. It does this by taking a sample input, applying a Square attack, and measuring the performance of the model on the perturbed input. See the paper "Square Attack: a query-efficient black-box adversarial attack via random search" by Andriushchenko, Croce, et al. (https://arxiv.org/abs/1912.00049) for more details.
Policies: NIST Map 1.5, NIST Measure 2.5
Why it matters: Malicious actors can perturb input images to alter model behavior in unexpected ways. It is important that your Computer Vision models are robust to such attacks.
Configuration: By default, this test runs when the "Adversarial" test category is selected.
Data Cleanliness
Required Features
This test checks that the features of a dataset are as expected.
Policies: NIST Map 2.3
Why it matters: Errors in data collection and processing can lead to invalid missing (or extra) features. In the case of missing features, this can cause failures in models. In the case of extra features, this can lead to unnecessary storage and computation.
Configuration: This test runs only when required features are specified.
Example: Suppose we had a few features (Age, Location, etc.) that we always expected to be present in the dataset. We can configure this test to check that those columns are there.
Duplicate Row
This test checks if there are any duplicate rows in your dataset. The key detail displays the number of duplicate rows in your dataset.
Policies: N/A
Why it matters: Duplicate rows are potentially a sign of a broken data pipeline or an otherwise corrupted input.
Configuration: By default this test is run over all features, meaning two rows are considered duplicates only if they match across all features.
Example: Suppose we had two rows that were the same across every feature except an ID feature. By default these two rows would not be flagged as duplicates. If we exclude the ID feature, then these two rows would be flagged as duplicates.
Mutual Information Decrease (Feature to Label)
This test flags a likely data leakage issue in the model. Data leakage occurs when a model is trained on features containing information about the label that is not normally present during production.This test flags an issue if both of the following occur:
- the normalized mutual information between the feature and the label is too high in the reference set
- the normalized mutual information for the reference set is much higher than for the evaluation set
Policies: N/A
Why it matters: Errors in data collection and processing can lead to some features containing information about the label in the reference set that do not appear in the evaluation set. This causes the model to under-perform during production.
Configuration: By default, this test always runs on all categorical features.
Example: Consider a lending model that is trying to predict a boolean variable loan given that reports whether or not a bank will issue this loan to a potential borrower, and suppose one of the features is total debt over 50K. An error during the data processing causes the model to be trained on a data set where total debt over 50K is calculated after the loan has already been given, resulting in the model predicting loan given to be true whenever total debt over 50K is large. However, when the model is deployed, the feature total debt must be calculated before the loan given prediction can be made.
The normalized mutual information between these columns might be 0.3 in the reference set but only 0.1 in the evaluation set. This test would then flag a likely feature leakage issue where total debt over 50K is leaking into the variable loan given during training.
High Mutual Information (Feature to Label)
This test flags a likely data leakage issue if the normalized mutual information between the feature and the label is too high in the reference set. Data leakage occurs when a model is trained on features containing information about the label that is not normally present during production. This criterion is an indicator that this feature has unreasonably high predictive power for the label during training. One requirement for this test to flag data leakage is that the reference set labels and features are collected properly. This test should be utilized when one doesn't trust their eval data is collected correctly, else the MI Decrease test should be used.
Policies: N/A
Why it matters: Errors in data collection and processing can lead to some features containing information about the label in the reference set. This causes the model to under-perform during production.
Configuration: By default, this test always runs on all categorical features.
Example: Consider a lending model that is trying to predict a boolean variable loan given that reports whether or not a bank will issue this loan to a potential borrower, and suppose one of the features is total debt over 50K. An error during the data processing causes the model to be trained on a data set where total debt over 50K is calculated after the loan has already been given, resulting in the model predicting loan given to be true whenever total debt over 50K is true. The normalized mutual information between these columns might be 0.8 in the reference set, due to the data leakage phenomenon. This test would then flag a likely feature leakage issue where total debt over 50K is leaking into the variable loan given during training.
High Feature Correlation
This test checks that the correlation between two features in the reference set is not too high. Correlation is a measure of the linear relationship between two numeric features.
Policies: NIST Map 2.3, NIST Measure 2.5
Why it matters: Correlation in training features can be caused by a variety of factors, including interdependencies between the collected features, data collection processes, or change in data labeling. Training on too similar features can lead to underperforming or non-robust models.
Configuration: By default, this test runs over all pairs of numeric features in the dataset.
Example: Suppose that the correlation between age and years of employment is 0.9 in the reference set. Because of the high correlation between this pair of features, you might not want to train a model across both of them, and this test would fail.
Label Imbalance
This test checks that no labels have exceedingly high frequency.
Policies: N/A
Why it matters: Label imbalance in the training data can introduce bias into the model and possibly result in poor predictive performance on examples from the minority classes.
Configuration: This test runs only on classification tasks.
Example: Suppose we had a binary classification task. We can configure this test to check that neither label 0 nor 1 has frequency above a certain threshold.
Subset Performance
Subset Average Rank
This test is commonly known as the demographic parity or statistical parity test in fairness literature. This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Average Rank of model predictions within a specific subset is significantly upper than the model prediction Average Rank over the entire population.
Policies: N/A
Why it matters: Demographic parity is one of the most well-known and strict measures of fairness. It is meant to be used in a setting where we assert that the base label rates between subgroups should be the same (even if empirically they are different). This contrasts with equality of opportunity or predictive parity tests, which permit classification rates to depend on a protected attribute. It can be useful in legal/compliance settings where we want a Selection Rate for any protected group to fundamentally be the same as other groups.
Configuration: By default, Average Rank is computed for all protected features.
Example: Suppose we had data with the following protected feature 'animal': ['cat', 'cat', 'cat', 'dog', 'dog', 'dog'], and model predictions [0.3, 0.4, 0.5, 0.7, 0.8, 0.9], and rank [6, 5, 4, 3, 2, 1]. Then regardless of the labels, the Average Rank over the feature values ('cat', 'dog') would be (5.0, 2.0), indicating a failure in Average Rank.
Subset Recall
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Recall of model predictions within a specific subset is significantly lower than the model prediction Recall over the entire population.
Policies: N/A
Why it matters: Having different Recall between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Recall is computed over all predictions/labels.
Example: Suppose in our subset the ground truth has the following: [Microsoft Corp.] CEO [Steve Ballmer] announced the release of [Windows 7] today Suppose your actual extraction has the following: [Microsoft Corp.] [CEO] [Steve] Ballmer announced the release of Windows 7 [today] This has 1 true positive ([Microsoft Corp.]), 2 false negatives ([Steve Ballmer], [Windows 7]), and 3 false positives ([Steve], [CEO], [today]). This leads to a Recall of 0.33 on this subset of data. We then compare that to the overall Recall on the full dataset.
Subset Normalized Discounted Cumulative Gain (NDCG)
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Normalized Discounted Cumulative Gain (NDCG) of model predictions within a specific subset is significantly lower than the model prediction Normalized Discounted Cumulative Gain (NDCG) over the entire population.
Policies: N/A
Why it matters: Having different Normalized Discounted Cumulative Gain (NDCG) between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Normalized Discounted Cumulative Gain (NDCG) is computed over all predictions/labels.
Example: Suppose we had the following query-document pairs: [[(qid: 1), 'A'], [(qid: 1), 'A'], [(qid: 2), 'B'], [(qid: 2), 'B']] , model predictions [2, 1, 1, 2], and true relevance ranks [1,2,1,2]. Then, the Normalized Discounted Cumulative Gain (NDCG) over the feature subset 'A' would be 0.86, compared to the overall metric of 0.93.
Subset Macro Recall
The recall test is more popularly referred to as equal opportunity or false negative error rate balance in fairness literature. When transitioning to the multiclass setting we can use macro recall which computes the recall of each individual class and then averages these numbers. This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Macro Recall of model predictions within a specific subset is significantly lower than the model prediction Macro Recall over the entire population.
Policies: NIST Map 1.5, NIST Map 1.6, NIST Measure 2.2, NIST Measure 2.9, NIST Measure 2.11
Why it matters: Having different Macro Recall between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation. Unlike demographic parity, this test permits assuming different base label rates but flags differing mistake rates between different subgroups. An intuitive example is when the label indicates a positive attribute: if predicting whether to interview a given candidate, make sure that out of qualified candidates, the rate at which the model predicts an interview is similar to group A and B.
Configuration: By default, Macro Recall is computed over all predictions/labels. Note that the predicted label is the label with the largest predicted class probability.
Example: Suppose we are differentiating between cats, bears, and dogs. Assume that across the data points where height=2 the predictions are [0.9, 0.1, 0], [0.1, 0.9, 0], [0.2, 0.1, 0.7] and the labels are [1, 0, 0], [1, 0, 0], [0, 0, 1] (where the first index corresponds to cat, the second corresponds to bear, and the third corresponds to dog). Then the Macro Recall across this subset is 0.5. If the overall Macro Recall across all subsets is 0.9 then this test raises a warning.
Subset F1
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the F1 of model predictions within a specific subset is significantly lower than the model prediction F1 over the entire population.
Policies: N/A
Why it matters: Having different F1 between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, F1 is computed over all predictions/labels.
Example: Suppose in our subset the ground truth has the following: [Microsoft Corp.] CEO [Steve Ballmer] announced the release of [Windows 7] today Suppose your actual extraction has the following: [Microsoft Corp.] [CEO] [Steve] Ballmer announced the release of Windows 7 [today] This has 1 true positive ([Microsoft Corp.]), 2 false negatives ([Steve Ballmer], [Windows 7]), and 3 false positives ([Steve], [CEO], [today]). This leads to a F1 of 0.29 on this subset of data. We then compare that to the overall F1 on the full dataset.
Subset Mean-Absolute Percentage Error (MAPE)
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Mean-Absolute Percentage Error (MAPE) of model predictions within a specific subset is significantly upper than the model prediction Mean-Absolute Percentage Error (MAPE) over the entire population.
Policies: N/A
Why it matters: Having different Mean-Absolute Percentage Error (MAPE) between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Mean-Absolute Percentage Error (MAPE) is computed over all predictions/labels.
Example: Suppose we had data with 2 features: [[0.4, 0.2], [0.5, 0.3], [0.7, 0.5], [0.6, 0.7], [0.8, 0.7]], model predictions [0.3, 0.4, 0.8, 0.8, 0.9], and labels [0.5, 1.0, 1.5, 1.5, 1.5]. Then, the Mean-Absolute Percentage Error (MAPE) over the feature subset (0.0, 0.5] for the first feature would be 0.6, compared to the overall metric of 0.48.
Subset Positive Prediction Rate
This test is commonly known as the demographic parity or statistical parity test in fairness literature. This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Positive Prediction Rate of model predictions within a specific subset is significantly both than the model prediction Positive Prediction Rate over the entire population.
Policies: N/A
Why it matters: Demographic parity is one of the most well-known and strict measures of fairness. It is meant to be used in a setting where we assert that the base label rates between subgroups should be the same (even if empirically they are different). This contrasts with equality of opportunity or predictive parity tests, which permit classification rates to depend on a protected attribute. It can be useful in legal/compliance settings where we want a Selection Rate for any protected group to fundamentally be the same as other groups.
Configuration: By default, Positive Prediction Rate is computed for all protected features.
Example: Suppose we had data with the following protected feature 'animal': ['cat', 'cat', 'cat', 'dog', 'dog', 'dog'], and model predictions [0.3, 0.3, 0.9, 0.9, 0.9, 0.3]. Then regardless of the labels, the Positive Prediction Rate over the feature values ('cat', 'dog') would be (0.33, 0.67), indicating a failure in demographic parity.
Subset Recall
The recall test is more popularly referred to as equal opportunity or false negative error rate balance in fairness literature. This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Recall of model predictions within a specific subset is significantly lower than the model prediction Recall over the entire population.
Policies: NIST Map 1.5, NIST Map 1.6, NIST Measure 2.2, NIST Measure 2.9, NIST Measure 2.11
Why it matters: Having different Recall between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation. Unlike demographic parity, this test permits assuming different base label rates but flags differing mistake rates between different subgroups. An intuitive example is when the label indicates a positive attribute: if predicting whether to interview a given candidate, make sure that out of qualified candidates, the rate at which the model predicts a rejection is similar to group A and B.
Configuration: By default, Recall is computed over all predictions/labels. Note that we round predictions to 0/1 to compute recall.
Example: Suppose we had data with 2 features: [['cat', 0.2], ['dog', 0.3], ['cat', 0.5], ['dog', 0.7], ['cat', 0.7], ['dog', 0.2]], mode predictions [0.3, 0.51, 0.7, 0.49, 0.9, 0.58], and labels [1, 0, 1, 0, 0, 1]. Then, the Recall over the feature subset value 'cat' would be 0.5, compared to the overall metric of 0.67.
Subset Average Confidence
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Average Confidence of model predictions within a specific subset is significantly lower than the model prediction Average Confidence over the entire population.
Policies: N/A
Why it matters: Having different Average Confidence between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Average Confidence is computed over all predictions/labels.
Example: Suppose we had data with 2 features: [['cat', 0.2], ['dog', 0.3], ['cat', 0.5], ['dog', 0.7], ['cat', 0.7], ['dog', 0.2]], mode predictions [0.3, 0.51, 0.7, 0.49, 0.9, 0.58], and labels [1, 0, 1, 0, 0, 1]. Then, the Average Confidence over the feature subset value 'cat' would be 0.77, compared to the overall metric of 0.65.
Subset Macro Precision
The precision test is also popularly referred to as positive predictive parity in fairness literature. When transitioning to the multiclass setting, we can compute macro precision which computes the precisions of each class individually and then averages them. This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Macro Precision of model predictions within a specific subset is significantly lower than the model prediction Macro Precision over the entire population.
Policies: N/A
Why it matters: Having different Macro Precision between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation. Unlike demographic parity, this test permits assuming different base label rates but flags differing mistake rates between different subgroups. Note that positive predictive parity does not necessarily indicate equal opportunity or predictive equality: as a hypothetical example, imagine that a loan qualification classifier flags 100 entries for group A and 100 entries for group B, each with a precision of 100%, but there are 100 actual qualified entries in group A and 9000 in group B. This would indicate disparities in opportunities given to each subgroup.
Configuration: By default, Macro Precision is computed over all predictions/labels. Note that the predicted label is the label with the largest predicted
Example: Suppose we are differentiating between cats, bears, and dogs. Assume that across the data points where height=2 the predictions are [0.9, 0.1, 0], [0.1, 0.9, 0], [0.2, 0.1, 0.7] and the labels are [1, 0, 0], [1, 0, 0], [0, 0, 1] (where the first index corresponds to cat, the second corresponds to bear, and the third corresponds to dog). Then the Macro Precision across this subset is 0.67. If the overall Macro Precision across all subsets is 0.9 then this test raises a warning.
Subset Root-Mean-Squared Error (RMSE)
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Root-Mean-Squared Error (RMSE) of model predictions within a specific subset is significantly upper than the model prediction Root-Mean-Squared Error (RMSE) over the entire population.
Policies: N/A
Why it matters: Having different Root-Mean-Squared Error (RMSE) between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Root-Mean-Squared Error (RMSE) is computed over all predictions/labels.
Example: Suppose we had data with 2 features: [[0.4, 0.2], [0.5, 0.3], [0.7, 0.5], [0.6, 0.7], [0.8, 0.7]], model predictions [0.3, 0.4, 0.8, 0.8, 0.9], and labels [0.5, 1.0, 1.5, 1.5, 1.5]. Then, the Root-Mean-Squared Error (RMSE) over the feature subset (0.0, 0.5] for the first feature would be 0.45, compared to the overall metric of 0.59.
Subset Precision
The precision test is also popularly referred to as positive predictive parity in fairness literature. This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Precision of model predictions within a specific subset is significantly lower than the model prediction Precision over the entire population.
Policies: N/A
Why it matters: Having different Precision between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation. Unlike demographic parity, this test permits assuming different base label rates but flags differing mistake rates between different subgroups. Note that positive predictive parity does not necessarily indicate equal opportunity or predictive equality: as a hypothetical example, imagine that a loan qualification classifier flags 100 entries for group A and 100 entries for group B, each with a precision of 100%, but there are 100 actual qualified entries in group A and 9000 in group B. This would indicate disparities in opportunities given to each subgroup.
Configuration: By default, Precision is computed over all predictions/labels. Note that we round predictions to 0/1 to compute precision.
Example: Suppose we had data with 2 features: [['cat', 0.2], ['dog', 0.3], ['cat', 0.5], ['dog', 0.7], ['cat', 0.7], ['dog', 0.2]], mode predictions [0.3, 0.51, 0.7, 0.49, 0.9, 0.58], and labels [1, 0, 1, 0, 0, 1]. Then, the Precision over the feature subset value 'cat' would be 0.5, compared to the overall metric of 0.5.
Subset Prediction Variance (Positive Labels)
The subset variance test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the variance of model predictions within a specific subset significantly higher than model prediction variance of the entire population. In this test, the population refers to all data positive.
Why it matters: High variance within a feature subset compared to the overall population could mean a few different things, and should be analyzed with other subset performance tests (accuracy, AUC) for a more clear view. In the variance metric over positive/negative labels, this could mean the model is much more uncertain about the given subset. When paired with a decrease in AUC, this implies the model underperforms on this subset.
Configuration: By default, the variance is computed over all
Example: Suppose we had data with 2 features: [['cat', 0.2], ['dog', 0.3], ['cat', 0.5], ['dog', 0.7], ['cat', 0.7], ['dog', 0.2]] and model predictions [0.3, 0.51, 0.7, 0.49, 0.9, 0.48]. Assume the labels are [1, 0, 1, 0, 0, 0].Then the prediction variance for feature column 1, subset 'cat' with positive labels would be 0.04.
Subset Multiclass AUC
In the multiclass setting, we compute one vs. one area under the curve (AUC), which computes the AUC between every pairwise combination of classes. This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Multiclass AUC of model predictions within a specific subset is significantly lower than the model prediction Multiclass AUC over the entire population.
Policies: N/A
Why it matters: Having different Multiclass AUC between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Multiclass AUC is computed over all predictions/labels.
Example: Suppose we are differentiating between cats, bears, and dogs. Assume that across the data points where height=2 the predictions are [0.9, 0.1, 0], [0.1, 0.9, 0], [0.2, 0.1, 0.7] and the labels are [1, 0, 0], [1, 0, 0], [0, 0, 1] (where the first index corresponds to cat, the second corresponds to bear, and the third corresponds to dog). Then the Multiclass AUC across this subset is 0.75. If the overall Multiclass AUC across all subsets is 0.9 then this test raises a warning.
Subset False Negative Rate
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the False Negative Rate of model predictions within a specific subset is significantly upper than the model prediction False Negative Rate over the entire population.
Policies: N/A
Why it matters: Having different False Negative Rate between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, False Negative Rate is computed over all predictions/labels.
Example: Suppose we had data with 2 features: [['cat', 0.2], ['dog', 0.3], ['cat', 0.5], ['dog', 0.7], ['cat', 0.7], ['dog', 0.2]], mode predictions [0.3, 0.51, 0.7, 0.49, 0.9, 0.58], and labels [1, 0, 1, 0, 0, 1]. Then, the False Negative Rate over the feature subset value 'cat' would be 0.5, compared to the overall metric of 0.33.
Subset Precision
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Precision of model predictions within a specific subset is significantly lower than the model prediction Precision over the entire population.
Policies: N/A
Why it matters: Having different Precision between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Precision is computed over all predictions/labels.
Example: Suppose in our subset the ground truth has two cats and one dog in the image. Suppose your actual detection has two true positives (the cats), one false positive (it predicts a bird) and one false negative (does not predict the dog). This leads to a Precision of 0.67 on this subset of data. We then compare that to the overall Precision on the full dataset.
Subset Mean Reciprocal Rank (MRR)
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Mean Reciprocal Rank (MRR) of model predictions within a specific subset is significantly lower than the model prediction Mean Reciprocal Rank (MRR) over the entire population.
Policies: N/A
Why it matters: Having different Mean Reciprocal Rank (MRR) between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Mean Reciprocal Rank (MRR) is computed over all predictions/labels.
Example: Suppose we had the following query-document pairs: [[(qid: 1), 'A'], [(qid: 1), 'A'], [(qid: 2), 'B'], [(qid: 2), 'B']] , model predictions [2, 1, 1, 2], and true relevance ranks [1,2,1,2]. Then, the Mean Reciprocal Rank (MRR) over the feature subset 'A' would be 0.5, compared to the overall metric of 0.75.
Subset AUC
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the AUC of model predictions within a specific subset is significantly lower than the model prediction AUC over the entire population.
Policies: N/A
Why it matters: Having different AUC between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, AUC is computed over all predictions/labels. Note that we compute AUC of the Receiver Operating Characteristic (ROC) curve.
Example: Suppose we had data with 2 features: [['cat', 0.2], ['dog', 0.3], ['cat', 0.5], ['dog', 0.7], ['cat', 0.7], ['dog', 0.2]], mode predictions [0.3, 0.51, 0.7, 0.49, 0.9, 0.58], and labels [1, 0, 1, 0, 0, 1]. Then, the AUC over the feature subset value 'cat' would be 0.0, compared to the overall metric of 0.44.
Subset Precision
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Precision of model predictions within a specific subset is significantly lower than the model prediction Precision over the entire population.
Policies: N/A
Why it matters: Having different Precision between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Precision is computed over all predictions/labels.
Example: Suppose in our subset the ground truth has the following: [Microsoft Corp.] CEO [Steve Ballmer] announced the release of [Windows 7] today Suppose your actual extraction has the following: [Microsoft Corp.] [CEO] [Steve] Ballmer announced the release of Windows 7 [today] This has 1 true positive ([Microsoft Corp.]), 2 false negatives ([Steve Ballmer], [Windows 7]), and 3 false positives ([Steve], [CEO], [today]). This leads to a Precision of 0.25 on this subset of data. We then compare that to the overall Precision on the full dataset.
Subset Rank Correlation
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Rank Correlation of model predictions within a specific subset is significantly lower than the model prediction Rank Correlation over the entire population.
Policies: N/A
Why it matters: Having different Rank Correlation between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Rank Correlation is computed over all predictions/labels.
Example: Suppose we had the following query-document pairs: [[(qid: 1), 'A'], [(qid: 1), 'A'], [(qid: 2), 'B'], [(qid: 2), 'B']] , model predictions [2, 1, 1, 2], and true relevance ranks [1,2,1,2]. Then, the Rank Correlation over the feature subset 'A' would be -1.0, compared to the overall metric of 0.0.
Subset F1
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the F1 of model predictions within a specific subset is significantly lower than the model prediction F1 over the entire population.
Policies: N/A
Why it matters: Having different F1 between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, F1 is computed over all predictions/labels. Note that we round predictions to 0/1 to compute F1 score.
Example: Suppose we had data with 2 features: [['cat', 0.2], ['dog', 0.3], ['cat', 0.5], ['dog', 0.7], ['cat', 0.7], ['dog', 0.2]], mode predictions [0.3, 0.51, 0.7, 0.49, 0.9, 0.58], and labels [1, 0, 1, 0, 0, 1]. Then, the F1 over the feature subset value 'cat' would be 0.5, compared to the overall metric of 0.57.
Subset Prediction Variance (Negative Labels)
The subset variance test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the variance of model predictions within a specific subset significantly higher than model prediction variance of the entire population. In this test, the population refers to all data negative.
Why it matters: High variance within a feature subset compared to the overall population could mean a few different things, and should be analyzed with other subset performance tests (accuracy, AUC) for a more clear view. In the variance metric over positive/negative labels, this could mean the model is much more uncertain about the given subset. When paired with a decrease in AUC, this implies the model underperforms on this subset.
Configuration: By default, the variance is computed over all
Example: Suppose we had data with 2 features: [['cat', 0.2], ['dog', 0.3], ['cat', 0.5], ['dog', 0.7], ['cat', 0.7], ['dog', 0.2]] and model predictions [0.3, 0.51, 0.7, 0.49, 0.9, 0.48]. Assume the labels are [1, 0, 1, 0, 0, 0].Then the prediction variance for feature column 1, subset 'cat' with negative labels would be 0.0.
Subset False Positive Rate
The false positive error rate test is also popularly referred to as predictive equality, or equal mis-opportunity in fairness literature. This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the False Positive Rate of model predictions within a specific subset is significantly upper than the model prediction False Positive Rate over the entire population.
Policies: NIST Map 1.5, NIST Map 1.6, NIST Measure 2.2, NIST Measure 2.9, NIST Measure 2.11
Why it matters: Having different False Positive Rate between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation. Unlike demographic parity, this test permits assuming different base label rates but flags differing mistake rates between different subgroups. As an intuitive example, consider the case when the label indicates an undesirable attribute: if predicting whether a person will default on their loan, make sure that for people who didn't default, the rate at which the model incorrectly predicts positive is similar for group A and B.
Configuration: By default, False Positive Rate is computed over all predictions/labels. Note that we round predictions to 0/1 to compute false positive rate.
Example: Suppose we had data with 2 features: [['cat', 0.2], ['dog', 0.3], ['cat', 0.5], ['dog', 0.7], ['cat', 0.7], ['dog', 0.2]], mode predictions [0.3, 0.51, 0.7, 0.49, 0.9, 0.58], and labels [1, 0, 1, 0, 0, 1]. Then, the False Positive Rate over the feature subset value 'cat' would be 1.0, compared to the overall metric of 0.67.
Subset Prediction Variance
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Prediction Variance of model predictions within a specific subset is significantly both than the model prediction Prediction Variance over the entire population.
Policies: N/A
Why it matters: Having different Prediction Variance between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Prediction Variance is computed over all predictions/labels.
Example: Suppose we had data with 2 features: [[0.4, 0.2], [0.5, 0.3], [0.7, 0.5], [0.6, 0.7], [0.8, 0.7]], model predictions [0.3, 0.4, 0.8, 0.8, 0.9], and labels [0.5, 1.0, 1.5, 1.5, 1.5]. Then, the Prediction Variance over the feature subset (0.0, 0.5] for the first feature would be 0.0, compared to the overall metric of 0.06.
Subset Accuracy
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Accuracy of model predictions within a specific subset is significantly lower than the model prediction Accuracy over the entire population.
Policies: N/A
Why it matters: Having different Accuracy between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation. Accuracy can be thought of as a 'weaker' metric of model bias compared to measuring false positive rate (predictive equality) or false negative rate (equal opportunity). This is because we can have similar accuracy between group A and group B; yet group A actually has higher false positive rate, while group B has higher false negative rate (e.g. we reject qualified applicants in group A but accept non-qualified applicants in group B). Nevertheless, accuracy is a standard metric used during evaluation and should be considered as part of performance bias testing.
Configuration: By default, Accuracy is computed over all predictions/labels. Note we round predictions to 0/1 to compute accuracy.
Example: Suppose we had data with 2 features: [['cat', 0.2], ['dog', 0.3], ['cat', 0.5], ['dog', 0.7], ['cat', 0.7], ['dog', 0.2]], mode predictions [0.3, 0.51, 0.7, 0.49, 0.9, 0.58], and labels [1, 0, 1, 0, 0, 1]. Then, the Accuracy over the feature subset value 'cat' would be 0.33, compared to the overall metric of 0.5.
Subset Mean-Absolute Error (MAE)
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Mean-Absolute Error (MAE) of model predictions within a specific subset is significantly upper than the model prediction Mean-Absolute Error (MAE) over the entire population.
Policies: N/A
Why it matters: Having different Mean-Absolute Error (MAE) between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Mean-Absolute Error (MAE) is computed over all predictions/labels.
Example: Suppose we had data with 2 features: [[0.4, 0.2], [0.5, 0.3], [0.7, 0.5], [0.6, 0.7], [0.8, 0.7]], model predictions [0.3, 0.4, 0.8, 0.8, 0.9], and labels [0.5, 1.0, 1.5, 1.5, 1.5]. Then, the Mean-Absolute Error (MAE) over the feature subset (0.0, 0.5] for the first feature would be 0.4, compared to the overall metric of 0.56.
Subset F1
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the F1 of model predictions within a specific subset is significantly lower than the model prediction F1 over the entire population.
Policies: N/A
Why it matters: Having different F1 between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, F1 is computed over all predictions/labels.
Example: Suppose in our subset the ground truth has two cats and one dog in the image. Suppose your actual detection has two true positives (the cats), one false positive (it predicts a bird) and one false negative (does not predict the dog). This leads to a F1 of 0.67 on this subset of data. We then compare that to the overall F1 on the full dataset.
Subset Mean-Squared-Log Error (MSLE)
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Mean-Squared-Log Error (MSLE) of model predictions within a specific subset is significantly upper than the model prediction Mean-Squared-Log Error (MSLE) over the entire population.
Policies: N/A
Why it matters: Having different Mean-Squared-Log Error (MSLE) between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Mean-Squared-Log Error (MSLE) is computed over all predictions/labels.
Example: Suppose we had data with 2 features: [[0.4, 0.2], [0.5, 0.3], [0.7, 0.5], [0.6, 0.7], [0.8, 0.7]], model predictions [0.3, 0.4, 0.8, 0.8, 0.9], and labels [0.5, 1.0, 1.5, 1.5, 1.5]. Then, the Mean-Squared-Log Error (MSLE) over the feature subset (0.0, 0.5] for the first feature would be 0.07, compared to the overall metric of 0.09.
Subset Macro F1
F1 is a holistic measure of both precision and recall. When transitioning to the multiclass setting we can use macro F1 which computes the F1 of each class and averages them. This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Macro F1 of model predictions within a specific subset is significantly lower than the model prediction Macro F1 over the entire population.
Policies: N/A
Why it matters: Having different Macro F1 between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Macro F1 is computed over all predictions/labels. Note that the predicted label is the label with the largest predicted probability.
Example: Suppose we are differentiating between cats, bears, and dogs. Assume that across the data points where height=2 the predictions are [0.9, 0.1, 0], [0.1, 0.9, 0], [0.2, 0.1, 0.7] and the labels are [1, 0, 0], [1, 0, 0], [0, 0, 1] (where the first index corresponds to cat, the second corresponds to bear, and the third corresponds to dog). Then the Macro F1 across this subset is 0.56. If the overall Macro F1 across all subsets is 0.9 then this test raises a warning.
Subset Mean-Squared Error (MSE)
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Mean-Squared Error (MSE) of model predictions within a specific subset is significantly upper than the model prediction Mean-Squared Error (MSE) over the entire population.
Policies: N/A
Why it matters: Having different Mean-Squared Error (MSE) between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Mean-Squared Error (MSE) is computed over all predictions/labels.
Example: Suppose we had data with 2 features: [[0.4, 0.2], [0.5, 0.3], [0.7, 0.5], [0.6, 0.7], [0.8, 0.7]], model predictions [0.3, 0.4, 0.8, 0.8, 0.9], and labels [0.5, 1.0, 1.5, 1.5, 1.5]. Then, the Mean-Squared Error (MSE) over the feature subset (0.0, 0.5] for the first feature would be 0.2, compared to the overall metric of 0.35.
Subset Recall
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Recall of model predictions within a specific subset is significantly lower than the model prediction Recall over the entire population.
Policies: N/A
Why it matters: Having different Recall between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Recall is computed over all predictions/labels.
Example: Suppose in our subset the ground truth has two cats and one dog in the image. Suppose your actual detection has two true positives (the cats), one false positive (it predicts a bird) and one false negative (does not predict the dog). This leads to a Recall of 0.67 on this subset of data. We then compare that to the overall Recall on the full dataset.
Subset Multiclass Accuracy
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Multiclass Accuracy of model predictions within a specific subset is significantly lower than the model prediction Multiclass Accuracy over the entire population.
Policies: N/A
Why it matters: Having different Multiclass Accuracy between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Multiclass Accuracy is computed over all predictions/labels.
Example: Suppose we are differentiating between cats, bears, and dogs. Assume that across the data points where height=2 the predictions are [0.9, 0.1, 0], [0.1, 0.9, 0], [0.2, 0.1, 0.7] and the labels are [1, 0, 0], [1, 0, 0], [0, 0, 1] (where the first index corresponds to cat, the second corresponds to bear, and the third corresponds to dog). Then the Multiclass Accuracy across this subset is 0.67. If the overall Multiclass Accuracy across all subsets is 0.9 then this test raises a warning.
Abnormal Inputs
Numeric Outliers
This test measures the number of failing rows in your data with outliers and their impact on the model. Outliers are values which may not necessarily be outside of an allowed range for a feature, but are extreme values that are unusual and may be indicative of abnormality. The model impact is the difference in model performance between passing and failing rows with outliers. If labels are not provided, prediction change is used instead of model performance change.
Policies: NIST Map 2.3
Why it matters: Outliers can be a sign of corrupted or otherwise erroneous data, and can degrade model performance if used in the training data, or lead to unexpected behaviour if input at inference time.
Configuration: By default this test is run over each numeric feature that is neither unique nor ascending.
Example: Suppose there is a normally distributed feature age for which the reference set has a mean of 45 and a standard deviation of 10. The test would infer a lower outlier bound of 15 and an upper outlier bound of 75 by subtracting and adding 3 standard deviations from the mean, respectively. This test raises a warning if we observe any values in the evaluation set outside these thresholds or if model performance decreases on observed datapoints with outliers.
Unseen Categorical
This test measures the number of failing rows in your data with unseen categorical values and their impact on the model. The model impact is the difference in model performance between passing and failing rows with unseen categorical values. If labels are not provided, prediction change is used instead of model performance change.
Policies: NIST Map 2.3
Why it matters: Unseen categorical values are a common failure point in machine learning systems; since these models are trained over a reference set, they may yield uninterpretable or undefined behavior when interacting with an unseen categorical value. In addition, such errors may expose gaps or errors in data collection.
Configuration: By default, this test runs over all categorical features.
Example: Say that the feature Animal contains the values ['Cat', 'Dog'] from the reference set. This test raises a warning if we observe any unseen values in the evaluation set such as 'Mouse' that causes a significant change in model performance. If labels/predictions are provided in the run, then a severity would be raised if the Average Prediction changed by 0.03. If labels/predictions were not provided but 'Mouse' appeared in 3% of the evaluation dataset, an severity would be raised due to the significant increase in presence of an unseen feature.
Rare Categories
This test measures the severity of passing to the model data points whose features contain rarely observed categories (relative to the reference set). The severity is a function of the impact of these values on the model, as well as the presence of these values in the data. The model impact is the difference in model performance between passing and failing rows with rarely observed categorical values. If labels are not provided, prediction change is used instead of model performance change. The number of failing rows refers to the number of times rarely observed categorical values are observed in the evaluation set.
Policies: NIST Map 2.3
Why it matters: Rare categories are a common failure point in machine learning systems because less data often means worse performance. In addition, this may expose gaps or errors in data collection.
Configuration: By default, this test runs over all categorical features. A category is considered rare if it occurs fewer than min_num_occurrences times, or if it occurs less than min_pct_occurrences of the time. If neither of these values are specified, the rate of appearance below which a category is considered rare is min_ratio_rel_uniform divided by the number of classes.
Example: Say that the feature AgeGroup takes on the value 0-18 twice while taking on the value 35-55 a total of 98 times. If the min_num_occurences is 5 and the min_pct_occurrences is 0.03 then the test will flag the value 0-18 as a rare category.
Out of Range
This test measures the number of failing rows in your data with values outside the inferred range of allowed values and their impact on the model. The model impact is the difference in model performance between passing and failing rows with values outside the inferred range of allowed values. If labels are not provided, prediction change is used instead of model performance change.
Policies: NIST Map 2.3
Why it matters: In production, the model may encounter corrupted or manipulated out of range values. It is important that the model is robust to such extremities.
Configuration: By default, this test runs over all numeric features.
Example: In the reference set, the Age feature has a range of [0, 121]. This test raises a warning if we observe values outside of this range in the evaluation set (eg. 150, 200) or if model performance decreases on observed datapoints outside of this range.
Required Characters
This test measures the number of failing rows in your data with strings without any required characters and their impact on the model. The model impact is the difference in model performance between passing and failing rows with strings without any required characters. If labels are not provided, prediction change is used instead of model performance change.
Policies: NIST Map 2.3
Why it matters: A feature may require specific characters. However, errors in the data pipeline may allow invalid data points that lack these required characters to pass. Failing to catch such errors may lead to noisier training data or noisier predictions during inference, which can degrade model metrics.
Configuration: By default, this test runs over all string features that are inferred to have required characters.
Example: Say that the feature email requires the character @. This test raises a warning if we observe any values in the evaluation set where the character is missing.
Inconsistencies
This test measures the severity of passing to the model data points whose values are inconsistent (as inferred from the reference set). The severity is a function of the impact of these values on the model, as well as the presence of these values in the data. The model impact is the difference in model performance between passing and failing rows with data containing inconsistent feature values. If labels are not provided, prediction change is used instead of model performance change. The number of failing rows refers to the number of times data containing inconsistent feature values are observed in the evaluation set.
Policies: NIST Map 2.3
Why it matters: Inconsistent values might be the result of malicious actors manipulating the data or errors in the data pipeline. Thus, it is important to be aware of inconsistent values to identify sources of manipulations or errors.
Configuration: By default, this test runs on pairs of categorical features whose correlations exceed some minimum threshold. The default threshold for the frequency ratio below which values are considered to be inconsistent is 0.02.
Example: Suppose we have a feature country that takes on value "US" with frequency 0.5, and a feature time_zone that takes on value "Central European Time" with frequency 0.2. Then if these values appear together with frequency less than 0.5 * 0.2 * 0.02 = 0.002 , in the reference set, rows in which these values do appear together are inconsistencies.
Capitalization
This test measures the number of failing rows in your data with different types of capitalization and their impact on the model. The model impact is the difference in model performance between passing and failing rows with different types of capitalization. If labels are not provided, prediction change is used instead of model performance change.
Policies: NIST Map 2.3
Why it matters: In production, models can come across the same value with different capitalizations, making it important to explicitly check that your model is invariant to such differences.
Configuration: By default, this test runs over all categorical features.
Example: Suppose we had a column that corresponded to country code. For a specific row, let's say the observed value in the reference set was USA. This test raises a warning if we observe a similar value in the evaluation set with case changes, e.g. uSa or if model performance decreases on observed datapoints with case changes.
Empty String
This test measures the number of failing rows in your data with empty string values instead of null values and their impact on the model. The model impact is the difference in model performance between passing and failing rows with empty string values instead of null values. If labels are not provided, prediction change is used instead of model performance change.
Policies: NIST Map 2.3
Why it matters: In production, the model may encounter corrupted or manipulated string values. Null values and empty strings are often expected to be treated the same, but the model might not treat them that way. It is important that the model is robust to such extremities.
Configuration: By default, this test runs over all string features with null values.
Example: In the reference set, the Name feature contains nulls. This test raises a warning if we observe any empty string in the Name feature or if these values decrease model performance.
Embedding Anomalies
This test measures the number of failing rows in your data with anomalous embeddings and their impact on the model. The model impact is the difference in model performance between passing and failing rows with anomalous embeddings. If labels are not provided, prediction change is used instead of model performance change.
Policies: NIST Map 2.3
Why it matters: In production, the presence of anomalous embeddings can indicate breaks in upstream data pipelines, poor model generalization, or other issues.
Configuration: By default, this test runs over all configured embeddings.
Example: Say that the 'user_id' embedding is two-dimensional and has a mean at the origin and a covariance matrix of [[1, 0], [0, 1]] in the reference set. This test will flag any embeddings in the test set that are distant from the reference distribution using the Mahalanobis distance.
Null Check
This test measures the number of failing rows in your data with nulls in features that should not have nulls and their impact on the model. The model impact is the difference in model performance between passing and failing rows with nulls in features that should not have nulls. If labels are not provided, prediction change is used instead of model performance change.
Policies: NIST Map 2.3
Why it matters: The model may make certain assumptions about a column depending on whether or not it had nulls in the training data. If these assumptions break during production, this may damage the model's performance. For example, if a column was never null during training then a model may not have learned to be robust against noise in that column.
Configuration: By default, this test runs over all columns that had zero nulls in the reference set.
Example: Suppose that the feature Age was never null in the reference set. This test raises a warning if Age was null 10% of the time in the evaluation set or if model performance decreases on observed datapoints with nulls
Feature Type Check
This test checks for feature values of the incorrect type. The test severity is a function of both the presence of values of the incorrect type and the observed effect of these values on model performance.
Policies: NIST Map 2.3
Why it matters: A feature may require a specific type. However, errors in the data pipeline may produce values that are outside the expected type. Failing to catch such errors may lead to errors or undefined behavior from the model.
Configuration: By default, this test runs over all features.
Example: Say that the feature Cost requires the float type. This test raises a warning if we observe any values where Cost is represented as a different type instead.
Subset Performance Degradation
Subset Drift Average Rank
This test is commonly known as the demographic parity or statistical parity test in fairness literature. This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Average Rank of model predictions within a specific subset is significantly upper than the model prediction Average Rank over the entire population.
Policies: N/A
Why it matters: Demographic parity is one of the most well-known and strict measures of fairness. It is meant to be used in a setting where we assert that the base label rates between subgroups should be the same (even if empirically they are different). This contrasts with equality of opportunity or predictive parity tests, which permit classification rates to depend on a protected attribute. It can be useful in legal/compliance settings where we want a Selection Rate for any protected group to fundamentally be the same as other groups.
Configuration: By default, Average Rank is computed for all protected features.
Example: Suppose we had data with the following protected feature 'animal': ['cat', 'cat', 'cat', 'dog', 'dog', 'dog'], and model predictions [0.3, 0.4, 0.5, 0.7, 0.8, 0.9], and rank [6, 5, 4, 3, 2, 1]. Then regardless of the labels, the Average Rank over the feature values ('cat', 'dog') would be (5.0, 2.0), indicating a failure in Average Rank.
Subset Drift Recall
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Recall of model predictions within a specific subset is significantly lower than the model prediction Recall over the entire population.
Policies: N/A
Why it matters: Having different Recall between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Recall is computed over all predictions/labels.
Example: Suppose in our subset the ground truth has the following: [Microsoft Corp.] CEO [Steve Ballmer] announced the release of [Windows 7] today Suppose your actual extraction has the following: [Microsoft Corp.] [CEO] [Steve] Ballmer announced the release of Windows 7 [today] This has 1 true positive ([Microsoft Corp.]), 2 false negatives ([Steve Ballmer], [Windows 7]), and 3 false positives ([Steve], [CEO], [today]). This leads to a Recall of 0.33 on this subset of data. We then compare that to the overall Recall on the full dataset.
Subset Drift Average Number of Predicted Entities
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Average Number of Predicted Entities of model predictions within a specific subset is significantly both than the model prediction Average Number of Predicted Entities over the entire population.
Policies: N/A
Why it matters: Having different Average Number of Predicted Entities between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Average Number of Predicted Entities is computed over all predictions/labels.
Example: Suppose in our subset the ground truth has the following: [Microsoft Corp.] CEO [Steve Ballmer] announced the release of [Windows 7] today Suppose your actual extraction has the following: [Microsoft Corp.] [CEO] [Steve] Ballmer announced the release of Windows 7 [today] This has 1 true positive ([Microsoft Corp.]), 2 false negatives ([Steve Ballmer], [Windows 7]), and 3 false positives ([Steve], [CEO], [today]). This leads to a Average Number of Predicted Entities of 4.0 on this subset of data. We then compare that to the overall Average Number of Predicted Entities on the full dataset.
Subset Drift NDCG
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Normalized Discounted Cumulative Gain (NDCG) of model predictions within a specific subset is significantly lower than the model prediction Normalized Discounted Cumulative Gain (NDCG) over the entire population.
Policies: N/A
Why it matters: Having different Normalized Discounted Cumulative Gain (NDCG) between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Normalized Discounted Cumulative Gain (NDCG) is computed over all predictions/labels.
Example: Suppose we had the following query-document pairs: [[(qid: 1), 'A'], [(qid: 1), 'A'], [(qid: 2), 'B'], [(qid: 2), 'B']] , model predictions [2, 1, 1, 2], and true relevance ranks [1,2,1,2]. Then, the Normalized Discounted Cumulative Gain (NDCG) over the feature subset 'A' would be 0.86, compared to the overall metric of 0.93.
Subset Drift Macro Recall
The recall test is more popularly referred to as equal opportunity or false negative error rate balance in fairness literature. When transitioning to the multiclass setting we can use macro recall which computes the recall of each individual class and then averages these numbers. This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Macro Recall of model predictions within a specific subset is significantly lower than the model prediction Macro Recall over the entire population.
Policies: NIST Map 1.5, NIST Map 1.6, NIST Measure 2.2, NIST Measure 2.9, NIST Measure 2.11
Why it matters: Having different Macro Recall between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation. Unlike demographic parity, this test permits assuming different base label rates but flags differing mistake rates between different subgroups. An intuitive example is when the label indicates a positive attribute: if predicting whether to interview a given candidate, make sure that out of qualified candidates, the rate at which the model predicts an interview is similar to group A and B.
Configuration: By default, Macro Recall is computed over all predictions/labels. Note that the predicted label is the label with the largest predicted class probability.
Example: Suppose we are differentiating between cats, bears, and dogs. Assume that across the data points where height=2 the predictions are [0.9, 0.1, 0], [0.1, 0.9, 0], [0.2, 0.1, 0.7] and the labels are [1, 0, 0], [1, 0, 0], [0, 0, 1] (where the first index corresponds to cat, the second corresponds to bear, and the third corresponds to dog). Then the Macro Recall across this subset is 0.5. If the overall Macro Recall across all subsets is 0.9 then this test raises a warning.
Subset Drift F1
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the F1 of model predictions within a specific subset is significantly lower than the model prediction F1 over the entire population.
Policies: N/A
Why it matters: Having different F1 between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, F1 is computed over all predictions/labels.
Example: Suppose in our subset the ground truth has the following: [Microsoft Corp.] CEO [Steve Ballmer] announced the release of [Windows 7] today Suppose your actual extraction has the following: [Microsoft Corp.] [CEO] [Steve] Ballmer announced the release of Windows 7 [today] This has 1 true positive ([Microsoft Corp.]), 2 false negatives ([Steve Ballmer], [Windows 7]), and 3 false positives ([Steve], [CEO], [today]). This leads to a F1 of 0.29 on this subset of data. We then compare that to the overall F1 on the full dataset.
Subset Drift Mean-Absolute Percentage Error (MAPE)
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Mean-Absolute Percentage Error (MAPE) of model predictions within a specific subset is significantly upper than the model prediction Mean-Absolute Percentage Error (MAPE) over the entire population.
Policies: N/A
Why it matters: Having different Mean-Absolute Percentage Error (MAPE) between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Mean-Absolute Percentage Error (MAPE) is computed over all predictions/labels.
Example: Suppose we had data with 2 features: [[0.4, 0.2], [0.5, 0.3], [0.7, 0.5], [0.6, 0.7], [0.8, 0.7]], model predictions [0.3, 0.4, 0.8, 0.8, 0.9], and labels [0.5, 1.0, 1.5, 1.5, 1.5]. Then, the Mean-Absolute Percentage Error (MAPE) over the feature subset (0.0, 0.5] for the first feature would be 0.6, compared to the overall metric of 0.48.
Subset Drift Recall
The recall test is more popularly referred to as equal opportunity or false negative error rate balance in fairness literature. This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Recall of model predictions within a specific subset is significantly lower than the model prediction Recall over the entire population.
Policies: NIST Map 1.5, NIST Map 1.6, NIST Measure 2.2, NIST Measure 2.9, NIST Measure 2.11
Why it matters: Having different Recall between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation. Unlike demographic parity, this test permits assuming different base label rates but flags differing mistake rates between different subgroups. An intuitive example is when the label indicates a positive attribute: if predicting whether to interview a given candidate, make sure that out of qualified candidates, the rate at which the model predicts a rejection is similar to group A and B.
Configuration: By default, Recall is computed over all predictions/labels. Note that we round predictions to 0/1 to compute recall.
Example: Suppose we had data with 2 features: [['cat', 0.2], ['dog', 0.3], ['cat', 0.5], ['dog', 0.7], ['cat', 0.7], ['dog', 0.2]], mode predictions [0.3, 0.51, 0.7, 0.49, 0.9, 0.58], and labels [1, 0, 1, 0, 0, 1]. Then, the Recall over the feature subset value 'cat' would be 0.5, compared to the overall metric of 0.67.
Subset Drift Macro Precision
The precision test is also popularly referred to as positive predictive parity in fairness literature. When transitioning to the multiclass setting, we can compute macro precision which computes the precisions of each class individually and then averages them. This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Macro Precision of model predictions within a specific subset is significantly lower than the model prediction Macro Precision over the entire population.
Policies: N/A
Why it matters: Having different Macro Precision between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation. Unlike demographic parity, this test permits assuming different base label rates but flags differing mistake rates between different subgroups. Note that positive predictive parity does not necessarily indicate equal opportunity or predictive equality: as a hypothetical example, imagine that a loan qualification classifier flags 100 entries for group A and 100 entries for group B, each with a precision of 100%, but there are 100 actual qualified entries in group A and 9000 in group B. This would indicate disparities in opportunities given to each subgroup.
Configuration: By default, Macro Precision is computed over all predictions/labels. Note that the predicted label is the label with the largest predicted
Example: Suppose we are differentiating between cats, bears, and dogs. Assume that across the data points where height=2 the predictions are [0.9, 0.1, 0], [0.1, 0.9, 0], [0.2, 0.1, 0.7] and the labels are [1, 0, 0], [1, 0, 0], [0, 0, 1] (where the first index corresponds to cat, the second corresponds to bear, and the third corresponds to dog). Then the Macro Precision across this subset is 0.67. If the overall Macro Precision across all subsets is 0.9 then this test raises a warning.
Subset Drift Root-Mean-Squared Error (RMSE)
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Root-Mean-Squared Error (RMSE) of model predictions within a specific subset is significantly upper than the model prediction Root-Mean-Squared Error (RMSE) over the entire population.
Policies: N/A
Why it matters: Having different Root-Mean-Squared Error (RMSE) between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Root-Mean-Squared Error (RMSE) is computed over all predictions/labels.
Example: Suppose we had data with 2 features: [[0.4, 0.2], [0.5, 0.3], [0.7, 0.5], [0.6, 0.7], [0.8, 0.7]], model predictions [0.3, 0.4, 0.8, 0.8, 0.9], and labels [0.5, 1.0, 1.5, 1.5, 1.5]. Then, the Root-Mean-Squared Error (RMSE) over the feature subset (0.0, 0.5] for the first feature would be 0.45, compared to the overall metric of 0.59.
Subset Drift Precision
The precision test is also popularly referred to as positive predictive parity in fairness literature. This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Precision of model predictions within a specific subset is significantly lower than the model prediction Precision over the entire population.
Policies: N/A
Why it matters: Having different Precision between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation. Unlike demographic parity, this test permits assuming different base label rates but flags differing mistake rates between different subgroups. Note that positive predictive parity does not necessarily indicate equal opportunity or predictive equality: as a hypothetical example, imagine that a loan qualification classifier flags 100 entries for group A and 100 entries for group B, each with a precision of 100%, but there are 100 actual qualified entries in group A and 9000 in group B. This would indicate disparities in opportunities given to each subgroup.
Configuration: By default, Precision is computed over all predictions/labels. Note that we round predictions to 0/1 to compute precision.
Example: Suppose we had data with 2 features: [['cat', 0.2], ['dog', 0.3], ['cat', 0.5], ['dog', 0.7], ['cat', 0.7], ['dog', 0.2]], mode predictions [0.3, 0.51, 0.7, 0.49, 0.9, 0.58], and labels [1, 0, 1, 0, 0, 1]. Then, the Precision over the feature subset value 'cat' would be 0.5, compared to the overall metric of 0.5.
Subset Drift Prediction Variance (Positive Labels)
The subset variance test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the variance of model predictions within a specific subset significantly higher than model prediction variance of the entire population. In this test, the population refers to all data positive.
Why it matters: High variance within a feature subset compared to the overall population could mean a few different things, and should be analyzed with other subset performance tests (accuracy, AUC) for a more clear view. In the variance metric over positive/negative labels, this could mean the model is much more uncertain about the given subset. When paired with a decrease in AUC, this implies the model underperforms on this subset.
Configuration: By default, the variance is computed over all
Example: Suppose we had data with 2 features: [['cat', 0.2], ['dog', 0.3], ['cat', 0.5], ['dog', 0.7], ['cat', 0.7], ['dog', 0.2]] and model predictions [0.3, 0.51, 0.7, 0.49, 0.9, 0.48]. Assume the labels are [1, 0, 1, 0, 0, 0].Then the prediction variance for feature column 1, subset 'cat' with positive labels would be 0.04.
Subset Drift Multiclass AUC
In the multiclass setting, we compute one vs. one area under the curve (AUC), which computes the AUC between every pairwise combination of classes. This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Multiclass AUC of model predictions within a specific subset is significantly lower than the model prediction Multiclass AUC over the entire population.
Policies: N/A
Why it matters: Having different Multiclass AUC between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Multiclass AUC is computed over all predictions/labels.
Example: Suppose we are differentiating between cats, bears, and dogs. Assume that across the data points where height=2 the predictions are [0.9, 0.1, 0], [0.1, 0.9, 0], [0.2, 0.1, 0.7] and the labels are [1, 0, 0], [1, 0, 0], [0, 0, 1] (where the first index corresponds to cat, the second corresponds to bear, and the third corresponds to dog). Then the Multiclass AUC across this subset is 0.75. If the overall Multiclass AUC across all subsets is 0.9 then this test raises a warning.
Subset Drift False Negative Rate
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the False Negative Rate of model predictions within a specific subset is significantly upper than the model prediction False Negative Rate over the entire population.
Policies: N/A
Why it matters: Having different False Negative Rate between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, False Negative Rate is computed over all predictions/labels.
Example: Suppose we had data with 2 features: [['cat', 0.2], ['dog', 0.3], ['cat', 0.5], ['dog', 0.7], ['cat', 0.7], ['dog', 0.2]], mode predictions [0.3, 0.51, 0.7, 0.49, 0.9, 0.58], and labels [1, 0, 1, 0, 0, 1]. Then, the False Negative Rate over the feature subset value 'cat' would be 0.5, compared to the overall metric of 0.33.
Subset Drift Precision
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Precision of model predictions within a specific subset is significantly lower than the model prediction Precision over the entire population.
Policies: N/A
Why it matters: Having different Precision between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Precision is computed over all predictions/labels.
Example: Suppose in our subset the ground truth has two cats and one dog in the image. Suppose your actual detection has two true positives (the cats), one false positive (it predicts a bird) and one false negative (does not predict the dog). This leads to a Precision of 0.67 on this subset of data. We then compare that to the overall Precision on the full dataset.
Subset Drift Average Prediction
This test is commonly known as the demographic parity or statistical parity test in fairness literature. This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Average Prediction of model predictions within a specific subset is significantly both than the model prediction Average Prediction over the entire population.
Policies: N/A
Why it matters: Demographic parity is one of the most well-known and strict measures of fairness. It is meant to be used in a setting where we assert that the base label rates between subgroups should be the same (even if empirically they are different). This contrasts with equality of opportunity or predictive parity tests, which permit classification rates to depend on a protected attribute. It can be useful in legal/compliance settings where we want a Selection Rate for any protected group to fundamentally be the same as other groups.
Configuration: By default, Average Prediction is computed for all protected features.
Example: Suppose we had data with the following protected feature 'animal': ['cat', 'cat', 'cat', 'dog', 'dog', 'dog'], and model predictions [10.4, 10.0, 10.2, 8.7, 9.0, 9.0]. Then regardless of the labels, the Average Prediction over the feature values ('cat', 'dog') would be (10.2, 8.9), indicating a failure in average prediction.
Subset Drift Mean Reciprocal Rank (MRR)
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Mean Reciprocal Rank (MRR) of model predictions within a specific subset is significantly lower than the model prediction Mean Reciprocal Rank (MRR) over the entire population.
Policies: N/A
Why it matters: Having different Mean Reciprocal Rank (MRR) between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Mean Reciprocal Rank (MRR) is computed over all predictions/labels.
Example: Suppose we had the following query-document pairs: [[(qid: 1), 'A'], [(qid: 1), 'A'], [(qid: 2), 'B'], [(qid: 2), 'B']] , model predictions [2, 1, 1, 2], and true relevance ranks [1,2,1,2]. Then, the Mean Reciprocal Rank (MRR) over the feature subset 'A' would be 0.5, compared to the overall metric of 0.75.
Subset Drift AUC
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the AUC of model predictions within a specific subset is significantly lower than the model prediction AUC over the entire population.
Policies: N/A
Why it matters: Having different AUC between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, AUC is computed over all predictions/labels. Note that we compute AUC of the Receiver Operating Characteristic (ROC) curve.
Example: Suppose we had data with 2 features: [['cat', 0.2], ['dog', 0.3], ['cat', 0.5], ['dog', 0.7], ['cat', 0.7], ['dog', 0.2]], mode predictions [0.3, 0.51, 0.7, 0.49, 0.9, 0.58], and labels [1, 0, 1, 0, 0, 1]. Then, the AUC over the feature subset value 'cat' would be 0.0, compared to the overall metric of 0.44.
Subset Drift Precision
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Precision of model predictions within a specific subset is significantly lower than the model prediction Precision over the entire population.
Policies: N/A
Why it matters: Having different Precision between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Precision is computed over all predictions/labels.
Example: Suppose in our subset the ground truth has the following: [Microsoft Corp.] CEO [Steve Ballmer] announced the release of [Windows 7] today Suppose your actual extraction has the following: [Microsoft Corp.] [CEO] [Steve] Ballmer announced the release of Windows 7 [today] This has 1 true positive ([Microsoft Corp.]), 2 false negatives ([Steve Ballmer], [Windows 7]), and 3 false positives ([Steve], [CEO], [today]). This leads to a Precision of 0.25 on this subset of data. We then compare that to the overall Precision on the full dataset.
Subset Drift Rank Correlation
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Rank Correlation of model predictions within a specific subset is significantly lower than the model prediction Rank Correlation over the entire population.
Policies: N/A
Why it matters: Having different Rank Correlation between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Rank Correlation is computed over all predictions/labels.
Example: Suppose we had the following query-document pairs: [[(qid: 1), 'A'], [(qid: 1), 'A'], [(qid: 2), 'B'], [(qid: 2), 'B']] , model predictions [2, 1, 1, 2], and true relevance ranks [1,2,1,2]. Then, the Rank Correlation over the feature subset 'A' would be -1.0, compared to the overall metric of 0.0.
Subset Drift F1
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the F1 of model predictions within a specific subset is significantly lower than the model prediction F1 over the entire population.
Policies: N/A
Why it matters: Having different F1 between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, F1 is computed over all predictions/labels. Note that we round predictions to 0/1 to compute F1 score.
Example: Suppose we had data with 2 features: [['cat', 0.2], ['dog', 0.3], ['cat', 0.5], ['dog', 0.7], ['cat', 0.7], ['dog', 0.2]], mode predictions [0.3, 0.51, 0.7, 0.49, 0.9, 0.58], and labels [1, 0, 1, 0, 0, 1]. Then, the F1 over the feature subset value 'cat' would be 0.5, compared to the overall metric of 0.57.
Subset Drift Prediction Variance (Negative Labels)
The subset variance test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the variance of model predictions within a specific subset significantly higher than model prediction variance of the entire population. In this test, the population refers to all data negative.
Why it matters: High variance within a feature subset compared to the overall population could mean a few different things, and should be analyzed with other subset performance tests (accuracy, AUC) for a more clear view. In the variance metric over positive/negative labels, this could mean the model is much more uncertain about the given subset. When paired with a decrease in AUC, this implies the model underperforms on this subset.
Configuration: By default, the variance is computed over all
Example: Suppose we had data with 2 features: [['cat', 0.2], ['dog', 0.3], ['cat', 0.5], ['dog', 0.7], ['cat', 0.7], ['dog', 0.2]] and model predictions [0.3, 0.51, 0.7, 0.49, 0.9, 0.48]. Assume the labels are [1, 0, 1, 0, 0, 0].Then the prediction variance for feature column 1, subset 'cat' with negative labels would be 0.0.
Subset Drift False Positive Rate
The false positive error rate test is also popularly referred to as predictive equality, or equal mis-opportunity in fairness literature. This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the False Positive Rate of model predictions within a specific subset is significantly upper than the model prediction False Positive Rate over the entire population.
Policies: NIST Map 1.5, NIST Map 1.6, NIST Measure 2.2, NIST Measure 2.9, NIST Measure 2.11
Why it matters: Having different False Positive Rate between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation. Unlike demographic parity, this test permits assuming different base label rates but flags differing mistake rates between different subgroups. As an intuitive example, consider the case when the label indicates an undesirable attribute: if predicting whether a person will default on their loan, make sure that for people who didn't default, the rate at which the model incorrectly predicts positive is similar for group A and B.
Configuration: By default, False Positive Rate is computed over all predictions/labels. Note that we round predictions to 0/1 to compute false positive rate.
Example: Suppose we had data with 2 features: [['cat', 0.2], ['dog', 0.3], ['cat', 0.5], ['dog', 0.7], ['cat', 0.7], ['dog', 0.2]], mode predictions [0.3, 0.51, 0.7, 0.49, 0.9, 0.58], and labels [1, 0, 1, 0, 0, 1]. Then, the False Positive Rate over the feature subset value 'cat' would be 1.0, compared to the overall metric of 0.67.
Subset Drift Prediction Variance
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Prediction Variance of model predictions within a specific subset is significantly both than the model prediction Prediction Variance over the entire population.
Policies: N/A
Why it matters: Having different Prediction Variance between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Prediction Variance is computed over all predictions/labels.
Example: Suppose we had data with 2 features: [[0.4, 0.2], [0.5, 0.3], [0.7, 0.5], [0.6, 0.7], [0.8, 0.7]], model predictions [0.3, 0.4, 0.8, 0.8, 0.9], and labels [0.5, 1.0, 1.5, 1.5, 1.5]. Then, the Prediction Variance over the feature subset (0.0, 0.5] for the first feature would be 0.0, compared to the overall metric of 0.06.
Subset Drift Accuracy
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Accuracy of model predictions within a specific subset is significantly lower than the model prediction Accuracy over the entire population.
Policies: N/A
Why it matters: Having different Accuracy between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation. Accuracy can be thought of as a 'weaker' metric of model bias compared to measuring false positive rate (predictive equality) or false negative rate (equal opportunity). This is because we can have similar accuracy between group A and group B; yet group A actually has higher false positive rate, while group B has higher false negative rate (e.g. we reject qualified applicants in group A but accept non-qualified applicants in group B). Nevertheless, accuracy is a standard metric used during evaluation and should be considered as part of performance bias testing.
Configuration: By default, Accuracy is computed over all predictions/labels. Note we round predictions to 0/1 to compute accuracy.
Example: Suppose we had data with 2 features: [['cat', 0.2], ['dog', 0.3], ['cat', 0.5], ['dog', 0.7], ['cat', 0.7], ['dog', 0.2]], mode predictions [0.3, 0.51, 0.7, 0.49, 0.9, 0.58], and labels [1, 0, 1, 0, 0, 1]. Then, the Accuracy over the feature subset value 'cat' would be 0.33, compared to the overall metric of 0.5.
Subset Drift Mean-Absolute Error (MAE)
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Mean-Absolute Error (MAE) of model predictions within a specific subset is significantly upper than the model prediction Mean-Absolute Error (MAE) over the entire population.
Policies: N/A
Why it matters: Having different Mean-Absolute Error (MAE) between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Mean-Absolute Error (MAE) is computed over all predictions/labels.
Example: Suppose we had data with 2 features: [[0.4, 0.2], [0.5, 0.3], [0.7, 0.5], [0.6, 0.7], [0.8, 0.7]], model predictions [0.3, 0.4, 0.8, 0.8, 0.9], and labels [0.5, 1.0, 1.5, 1.5, 1.5]. Then, the Mean-Absolute Error (MAE) over the feature subset (0.0, 0.5] for the first feature would be 0.4, compared to the overall metric of 0.56.
Subset Drift F1
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the F1 of model predictions within a specific subset is significantly lower than the model prediction F1 over the entire population.
Policies: N/A
Why it matters: Having different F1 between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, F1 is computed over all predictions/labels.
Example: Suppose in our subset the ground truth has two cats and one dog in the image. Suppose your actual detection has two true positives (the cats), one false positive (it predicts a bird) and one false negative (does not predict the dog). This leads to a F1 of 0.67 on this subset of data. We then compare that to the overall F1 on the full dataset.
Subset Drift Mean-Squared-Log Error (MSLE)
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Mean-Squared-Log Error (MSLE) of model predictions within a specific subset is significantly upper than the model prediction Mean-Squared-Log Error (MSLE) over the entire population.
Policies: N/A
Why it matters: Having different Mean-Squared-Log Error (MSLE) between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Mean-Squared-Log Error (MSLE) is computed over all predictions/labels.
Example: Suppose we had data with 2 features: [[0.4, 0.2], [0.5, 0.3], [0.7, 0.5], [0.6, 0.7], [0.8, 0.7]], model predictions [0.3, 0.4, 0.8, 0.8, 0.9], and labels [0.5, 1.0, 1.5, 1.5, 1.5]. Then, the Mean-Squared-Log Error (MSLE) over the feature subset (0.0, 0.5] for the first feature would be 0.07, compared to the overall metric of 0.09.
Subset Drift Macro F1
F1 is a holistic measure of both precision and recall. When transitioning to the multiclass setting we can use macro F1 which computes the F1 of each class and averages them. This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Macro F1 of model predictions within a specific subset is significantly lower than the model prediction Macro F1 over the entire population.
Policies: N/A
Why it matters: Having different Macro F1 between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Macro F1 is computed over all predictions/labels. Note that the predicted label is the label with the largest predicted probability.
Example: Suppose we are differentiating between cats, bears, and dogs. Assume that across the data points where height=2 the predictions are [0.9, 0.1, 0], [0.1, 0.9, 0], [0.2, 0.1, 0.7] and the labels are [1, 0, 0], [1, 0, 0], [0, 0, 1] (where the first index corresponds to cat, the second corresponds to bear, and the third corresponds to dog). Then the Macro F1 across this subset is 0.56. If the overall Macro F1 across all subsets is 0.9 then this test raises a warning.
Subset Drift Mean-Squared Error (MSE)
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Mean-Squared Error (MSE) of model predictions within a specific subset is significantly upper than the model prediction Mean-Squared Error (MSE) over the entire population.
Policies: N/A
Why it matters: Having different Mean-Squared Error (MSE) between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Mean-Squared Error (MSE) is computed over all predictions/labels.
Example: Suppose we had data with 2 features: [[0.4, 0.2], [0.5, 0.3], [0.7, 0.5], [0.6, 0.7], [0.8, 0.7]], model predictions [0.3, 0.4, 0.8, 0.8, 0.9], and labels [0.5, 1.0, 1.5, 1.5, 1.5]. Then, the Mean-Squared Error (MSE) over the feature subset (0.0, 0.5] for the first feature would be 0.2, compared to the overall metric of 0.35.
Subset Drift Recall
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Recall of model predictions within a specific subset is significantly lower than the model prediction Recall over the entire population.
Policies: N/A
Why it matters: Having different Recall between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Recall is computed over all predictions/labels.
Example: Suppose in our subset the ground truth has two cats and one dog in the image. Suppose your actual detection has two true positives (the cats), one false positive (it predicts a bird) and one false negative (does not predict the dog). This leads to a Recall of 0.67 on this subset of data. We then compare that to the overall Recall on the full dataset.
Subset Drift Multiclass Accuracy
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Multiclass Accuracy of model predictions within a specific subset is significantly lower than the model prediction Multiclass Accuracy over the entire population.
Policies: N/A
Why it matters: Having different Multiclass Accuracy between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Multiclass Accuracy is computed over all predictions/labels.
Example: Suppose we are differentiating between cats, bears, and dogs. Assume that across the data points where height=2 the predictions are [0.9, 0.1, 0], [0.1, 0.9, 0], [0.2, 0.1, 0.7] and the labels are [1, 0, 0], [1, 0, 0], [0, 0, 1] (where the first index corresponds to cat, the second corresponds to bear, and the third corresponds to dog). Then the Multiclass Accuracy across this subset is 0.67. If the overall Multiclass Accuracy across all subsets is 0.9 then this test raises a warning.
Subset Drift Average Number of Predicted Boxes
This test checks whether the model performs equally well across a given subset of rows as it does across the whole dataset. The key detail displays the performance difference between the lowest performing subset and the overall population. The test first splits the dataset into various subsets depending on the quantiles of a given feature column. If the feature is categorical, the data is split based on the feature values. We then test whether the Average Number of Predicted Boxes of model predictions within a specific subset is significantly both than the model prediction Average Number of Predicted Boxes over the entire population.
Policies: N/A
Why it matters: Having different Average Number of Predicted Boxes between different subgroups is an important indicator of performance bias; in general, bias is an important phenomenon in machine learning and not only contains implications for and ethics, but also indicates failures in adequate feature representation and fairness spurious correlation.
Configuration: By default, Average Number of Predicted Boxes is computed over all predictions/labels.
Example: Suppose in our subset the ground truth has two cats and one dog in the image. Suppose your actual detection has two true positives (the cats), one false positive (it predicts a bird) and one false negative (does not predict the dog). This leads to a Average Number of Predicted Boxes of 3.0 on this subset of data. We then compare that to the overall Average Number of Predicted Boxes on the full dataset.
Data Poisoning Detection
Label Flipping Detection (Exact Match)
This test detects corrupted data points in the evaluation dataset. It does this by checking for data points in the evaluation set that are also present in the reference set, but with a different label. This test assumes that the reference set is clean, trusted data and the evaluation set is potentially corrupted.
Policies: NIST Map 1.5, NIST Measure 2.5
Why it matters: Malicious actors can tamper with data pipelines by sending mislabeled data points to undermine the trustworthiness of your model and cause it to produce incorrect or harmful output. Detecting poisoning attacks before they affect your model is critical to ensuring model security.
Configuration: By default, this test runs when the "Data Poisoning Detection" test category is selected.
Example: Suppose there was an identical data point in both datasets, with label 0 in the reference set and label 1 in the evaluation set. This test would flag the sample in the evaluation set as being corrupted.
Label Flipping Detection (Near Match)
This test detects corrupted data points in the evaluation dataset. It does this by checking for data points in the evaluation set that appear to be mislabeled based on their relative distances to each class in the reference set. This test assumes that the reference set is clean, trusted data and the evaluation set is potentially corrupted.
Policies: NIST Map 1.5, NIST Measure 2.5
Why it matters: Malicious actors can tamper with data pipelines by sending mislabeled data points to undermine the trustworthiness of your model and cause it to produce incorrect or harmful output. Detecting poisoning attacks before they affect your model is critical to ensuring model security.
Configuration: By default, this test runs when the "Data Poisoning Detection" test category is selected.
Example: Suppose that in the reference set, the minimum distance of any point with label 0 to a point from any other class is 0.5. Further suppose that in the evaluation set, a point with label 1 has distance 0.1 to a point from class 0 in the reference set. This test would flag the sample in the evaluation set as being corrupted.
Evasion Attack Detection
Stateful Black Box Evasion Detection
This test examines query patterns in the evaluation set to identify behavior indicative of an attempt to generate an adversarial example. It does this by flagging points for which the average distance to its k-nearest neighbors among a fixed number of preceding queries is below a threshold configured from the reference set. Often when only black box access to the model is available, the process of generating an adversarial example will involve querying the model on several similar data points in a short time period.
Why it matters: Malicious actors can perturb inputs to alter model behavior in unexpected ways. It is important to be able to identify data coming from an adversarial attack.
Configuration: This test requires timestamps to be specified in the evaluation set.
Example: Suppose that for a point in the evaluation set, the average distance to its k-nearest neighbors in time window immediately preceding it is 5.0, and the threshold determined from the reference set is 10.0. This test would flag that point as being part of an adversarial attack.