English

xaitimesynth: A Python Package for Evaluating Attribution Methods for Time Series with Synthetic Ground Truth

Machine Learning 2026-03-10 v1 Artificial Intelligence

Abstract

Evaluating time series attribution methods is difficult because real-world datasets rarely provide ground truth for which time points drive a prediction. A common workaround is to generate synthetic data where class-discriminating features are placed at known locations, but each study currently reimplements this from scratch. We introduce xaitimesynth, a Python package that provides reusable infrastructure for this evaluation approach. The package generates synthetic time series following an additive model where each sample is a sum of background signal and a localized, class-discriminating feature, with the feature window automatically tracked as a ground truth mask. A fluent data generation API and YAML configuration format allow flexible and reproducible dataset definitions for both univariate and multivariate time series. The package also provides standard localization metrics, including AUC-PR, AUC-ROC, Relevance Mass Accuracy, and Relevance Rank Accuracy. xaitimesynth is open source and available at https://github.com/gregorbaer/xaitimesynth.

Keywords

Cite

@article{arxiv.2603.06781,
  title  = {xaitimesynth: A Python Package for Evaluating Attribution Methods for Time Series with Synthetic Ground Truth},
  author = {Gregor Baer},
  journal= {arXiv preprint arXiv:2603.06781},
  year   = {2026}
}

Comments

9 pages, 1 figure, 2 tables, 1 listing

R2 v1 2026-07-01T11:07:50.530Z