ICE: Intervention-Consistent Explanation Evaluation
Official implementation of "ICE: Intervention-Consistent Explanation Evaluation with Statistical Grounding for LLMs" (EMNLP 2026 Findings).
Key Finding
Faithfulness is operator-dependent: switching the intervention operator flips the faithfulness verdict in 36% of configurations, with gaps up to 44 percentage points. One-third of configurations are anti-faithful (worse than random), invisible without randomized baselines.
What ICE Does
ICE evaluates whether model explanations (attention, gradient) identify tokens that are genuinely more important than random tokens, under multiple intervention operators.
Input: "a gorgeous, witty, seductive movie" (positive sentiment)
Rationale: {gorgeous, seductive}
Deletion Retrieval Infill
NSR: 0.79 0.39
Win Rate: 92% 68%
Verdict: Faithful Weakly Faithful <-- operator changes conclusion
Installation
pip install ice-faithfulness
Quick Start
from ice import ICEEvaluator, ICEConfig
config = ICEConfig(
k=0.2, # top 20% tokens as rationale
n_permutations=50, # random baselines
operators=["delete", "retrieval"],
)
evaluator = ICEEvaluator(model, tokenizer, config)
result = evaluator.evaluate(dataset, extractor="attention")
print(f"Win Rate: {result.win_rate:.1%}")
print(f"Effect Size: {result.effect_size:.2f}")
print(f"Operators agree: {result.operators_agree}")
Core Modules
| Module | Purpose |
|---|---|
ice.evaluation |
Main evaluator (ICEEvaluator, ICEConfig) |
ice.extractors |
Attention, gradient, IG, LIME extractors |
ice.operators |
Deletion, mask, retrieval infill operators |
ice.metrics |
NSR scoring, AUC-over-k |
ice.stats |
Randomization tests, bootstrap CI, BH correction |
ice.retrieval_operator |
Leave-one-out retrieval infill |
Evaluation Scripts
# English benchmarks (7 models x 4 tasks)
python run_ice_eval.py --model llama-3.2-3b --dataset sst2
# Multilingual (6 languages)
python run_multilingual.py --model qwen-2.5-7b --lang french
# Operator comparison
python run_retrieval.py --model mistral-7b --dataset esnli
Key Metrics
| Metric | Range | Meaning |
|---|---|---|
| Win Rate | 0-100% | % of random baselines beaten by the rationale |
| Effect Size | Cohen's d | Magnitude (>0.8 = large, <0 = anti-faithful) |
| Operator Agreement | bool | Both operators give same verdict |
Results Summary
Evaluated on 7 LLMs (1.5B-8B), 4 English tasks, 6 non-English languages, 2 attribution methods:
- Operator gaps reach 44 pp (e.g., Llama-3.2 e-SNLI: 86% deletion vs 43% retrieval)
- Anti-faithfulness in 1/3 of configurations (gradient selects function words)
- No correlation between faithfulness and human plausibility (|r| < 0.04)
- Cross-lingual faithfulness spans 16%-83%, not predicted by tokenization alone
Citation
@inproceedings{basu2026ice,
title={ICE: Intervention-Consistent Explanation Evaluation with Statistical Grounding for LLMs},
author={Basu, Abhinaba and Chakraborty, Pavan},
booktitle={Findings of the Association for Computational Linguistics: EMNLP 2026},
year={2026}
}
License
MIT
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ice_faithfulness-1.0.0.tar.gz.
File metadata
- Download URL: ice_faithfulness-1.0.0.tar.gz
- Upload date:
- Size: 37.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c17066327b567ed19183c5c1ce7ccd79eda66735ea38c4bc1b3a57ff5fad6479
|
|
| MD5 |
dd23319e92eaf0f2900c6ab4c8d096dc
|
|
| BLAKE2b-256 |
e6e7fb5b529e7cc2b28983637cc562ac5cdee085e50d11a9ee663c0198afa307
|
File details
Details for the file ice_faithfulness-1.0.0-py3-none-any.whl.
File metadata
- Download URL: ice_faithfulness-1.0.0-py3-none-any.whl
- Upload date:
- Size: 40.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ebebe44dc77ddf96cf6344062cab1921388de6f287d5296b641a07519f91432b
|
|
| MD5 |
762671128cbe261de02a70f475e3f4b2
|
|
| BLAKE2b-256 |
4584b2c4842cae1f4da5df8ce7d6b71468af6661edcdf102011b27e8246b268e
|