Skip to main content

ICE: Intervention-Consistent Explanation Evaluation

Paper PyPI License: MIT

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

ice_faithfulness-1.0.0.tar.gz (37.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ice_faithfulness-1.0.0-py3-none-any.whl (40.0 kB view details)

Uploaded Python 3

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

Hashes for ice_faithfulness-1.0.0.tar.gz
Algorithm Hash digest
SHA256 c17066327b567ed19183c5c1ce7ccd79eda66735ea38c4bc1b3a57ff5fad6479
MD5 dd23319e92eaf0f2900c6ab4c8d096dc
BLAKE2b-256 e6e7fb5b529e7cc2b28983637cc562ac5cdee085e50d11a9ee663c0198afa307

See more details on using hashes here.

File details

Details for the file ice_faithfulness-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for ice_faithfulness-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ebebe44dc77ddf96cf6344062cab1921388de6f287d5296b641a07519f91432b
MD5 762671128cbe261de02a70f475e3f4b2
BLAKE2b-256 4584b2c4842cae1f4da5df8ce7d6b71468af6661edcdf102011b27e8246b268e

See more details on using hashes here.

Release history Release notifications | RSS feed

1.0.1

2 files

This release

1.0.0 This release

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page