Papers › CausalCompass: Evaluating the Robustness of Time-Series Causal Discovery in...

CausalCompass: Evaluating the Robustness of Time-Series Causal Discovery in Misspecified Scenarios

8 Feb 2026arXiv:2602.07915added by Syntology

Huiyang Yi, Xiaojian Shen, Yonggang Wu, Duxin Chen, He Wang, Wenwu Yu

Title, abstract, authors and date from arXiv's metadata (CC0); this paper is not in the Papers with Code archive (frozen 2025-07-28).

Causal discovery from time series is a fundamental task in machine learning. However, its widespread adoption is hindered by a reliance on untestable causal assumptions and by the lack of robustness-oriented evaluation in existing benchmarks. To address these challenges, we propose CausalCompass, a flexible and extensible benchmark framework designed to assess the robustness of time-series causal discovery (TSCD) methods under violations of modeling assumptions. To demonstrate the practical utility of CausalCompass, we conduct extensive benchmarking of representative TSCD algorithms across eight assumption-violation scenarios. Our experimental results indicate that no single method consistently attains optimal performance across all settings. Nevertheless, the methods exhibiting superior overall performance across diverse scenarios are almost invariably deep learning-based approaches. We further provide hyperparameter sensitivity analyses to deepen the understanding of these findings. We additionally conduct ablation experiments to explain the strong performance of deep learning-based methods under assumption violations. We also find, somewhat surprisingly, that NTS-NOTEARS relies heavily on standardized preprocessing in practice, performing poorly in the vanilla setting but exhibiting strong performance after standardization. Finally, our work aims to provide a comprehensive and systematic evaluation of TSCD methods under assumption violations, thereby facilitating their broader adoption in real-world applications. The user-friendly implementation, documentation and datasets are available at https://anonymous.4open.science/r/CausalCompass-anonymous-5B4F/.

PaperPDFCode Syntology ran

In Syntology For agents, Syntology's MCP tool lists every function and class Syntology harvested from this paper and whether it ran (how to connect): get_harvested_code_for_paper(arxiv_id="2602.07915")

Code

Syntology Ran 11 of 27 code samples harvested from 5 repositories linked to this paper; 16 have no recorded run. Of those that ran: 1 ran · honoured contract; 3 ran · our draft was wrong; 7 ran with no contract checked.

By repository: found in paper text by Syntology: 26 samples from 5 repositories, 10 ran; 1 identical to code first harvested elsewhere. The run record, sample by sample. “Ran” means executed on a synthesized input, not that the code is correct or reproduces the paper.

iancovert/Neural-GC found in paper text by Syntology report
mckinsey/causalnex found in paper text by Syntology report
jarrycyx/UNN found in paper text by Syntology report
ckassaad/causal_discovery_for_time_series found in paper text by Syntology report
cloud36/graphical_granger_methods found in paper text by Syntology report
xiangyu-sun-789/NTS-NOTEARS found in paper text by Syntology report

Reachability, where shown, is from one Syntology probe window (2026-09-16 to 2026-09-18); repositories not probed show nothing. GitHub stars are not tracked.

Code Syntology ran Syntology

27 samples harvested; 11 ran; 1 honoured the contract we drafted; 16 have no recorded run. Read from Syntology's graph 2026-09-24; that is when this build read the record, not when the samples ran.

1ran · honoured contract
3ran · our draft was wrong
7ran
16unverified

Licence: 19 of the 27 samples are pointer only, meaning Syntology does not serve that copy's text. This page shows no code text for any sample; each one links to its file in the repository.

Harvested from 5 repositories linked to this paper, official or community; each sample names its own and says which. Some samples are identical code Syntology first harvested from another repository; for those, this paper's copy is not located and its licence is not recorded. “Ran” means the sample executed on a synthesized input. It does not mean the output is correct, and nothing here reproduces the paper's results. “Honoured” and “violated” refer to a contract Syntology drafted from the code itself; “our draft was wrong” and “fixture could not drive it” are failures of Syntology's instrument, not of the code.

Each sample ends with its code_sha256, Syntology's identity for that exact code. An agent fetches the stored sample with Syntology's MCP tool get_code(code_sha256="…") (how to connect); click an identity to copy that call.

Repository labels, per sample. official repository: The archive marks this repository official for the paper. named in the paper: The archive records that the paper mentions this repository; it is not marked official. community (archive-listed): In the archive's code links for this paper, not marked official and not recorded as mentioned in the paper. found in paper text by Syntology: Syntology found this repository in the paper's own text; whether it is the authors' implementation is not asserted. community: Not in the archive's code links for this paper; a community repository Syntology harvested. Samples from a repository marked official are listed first. Licence labels name the repository's licence as recorded at harvest. “Pointer only” means Syntology does not serve that copy's text, for one of four reasons: no licence file was found; the licence was not identified; the licence is recorded as permissive but that copy's record is not marked cleared; or the licence is outside the permissive list Syntology serves text under (MIT, Apache-2.0, BSD and similar). Some licences outside that list permit redistribution, such as WTFPL, and GPL-3.0 under its conditions; they are simply not on the list. Hover a licence label for the reason. File links open the file on GitHub at the default branch, which may have changed since the harvest.

LocallyConnected xiangyu-sun-789/NTS-NOTEARS/notears/nts_notears.py found in paper text by Syntology ran Apache-2.0 (permissive) · 70a9e4933e75d139 · report
MLP iancovert/Neural-GC/models/cmlp.py found in paper text by Syntology ran · metamorphic tier: deterministic MIT (permissive) · b66e5800a09b6fee · report
NormalizingFlows jarrycyx/UNN/CausalTime/models.py found in paper text by Syntology ran MIT (permissive) · d2a4faacd04000f3 · report
StructureModel mckinsey/causalnex/causalnex/structure/dynotears.py found in paper text by Syntology ran · metamorphic tier: deterministic licence not identified · pointer only · cf6a80d8442eefe1 · report
TraceExpm xiangyu-sun-789/NTS-NOTEARS/notears/nts_notears.py found in paper text by Syntology ran Apache-2.0 (permissive) · 8e6d66fa6322428e · report
_format_name_from_pandas mckinsey/causalnex/causalnex/structure/dynotears.py found in paper text by Syntology ran · our draft was wrong licence not identified · pointer only · 86138b90cd251240 · report
_learn_dynamic_structure mckinsey/causalnex/causalnex/structure/dynotears.py found in paper text by Syntology ran licence not identified · pointer only · 86645caeb5a5b501 · report
_reshape_wa mckinsey/causalnex/causalnex/structure/dynotears.py found in paper text by Syntology ran · our draft was wrong licence not identified · pointer only · 3084266f9053abf6 · report
activation_helper iancovert/Neural-GC/models/cmlp.py found in paper text by Syntology ran · our draft was wrong MIT (permissive) · 8f5922d83d039372 · report
cMLP iancovert/Neural-GC/models/cmlp.py found in paper text by Syntology ran · metamorphic tier: deterministic MIT (permissive) · 748b07a3576144e0 · report
DynamicDataTransformer mckinsey/causalnex/causalnex/structure/dynotears.py found in paper text by Syntology unverified licence not identified · pointer only · 62219bb481848681 · report
NF_ResidualTransformerModel jarrycyx/UNN/CausalTime/models.py found in paper text by Syntology unverified MIT (permissive) · 37c3692248c9618b · report
NTS_NOTEARS xiangyu-sun-789/NTS-NOTEARS/notears/nts_notears.py found in paper text by Syntology unverified Apache-2.0 (permissive) · 2cbcabcdda9cb54c · report
_matrices_to_structure_model mckinsey/causalnex/causalnex/structure/dynotears.py found in paper text by Syntology unverified licence not identified · pointer only · de15d5a3875be53a · report
_validate_origin mckinsey/causalnex/causalnex/structure/dynotears.py found in paper text by Syntology unverified licence not identified · pointer only · 2a6932bf8cdd2b4d · report
add_noise ckassaad/causal_discovery_for_time_series/baselines/scripts_python/kitmi.py found in paper text by Syntology unverified no licence file found · pointer only · d8a48b76818dc316 · report
from_numpy_dynamic mckinsey/causalnex/causalnex/structure/dynotears.py found in paper text by Syntology unverified licence not identified · pointer only · cfeec6fd5584fc91 · report
from_pandas_dynamic mckinsey/causalnex/causalnex/structure/dynotears.py found in paper text by Syntology unverified licence not identified · pointer only · 94ae5ecf684cc462 · report
generate_structure ckassaad/causal_discovery_for_time_series/baselines/scripts_python/granger_mv2.py found in paper text by Syntology unverified no licence file found · pointer only · a36fff89ac3a5137 · report
granger_mv2 ckassaad/causal_discovery_for_time_series/baselines/scripts_python/granger_mv2.py found in paper text by Syntology unverified no licence file found · pointer only · de2bc5c4d517d9be · report
granger_pw ckassaad/causal_discovery_for_time_series/baselines/scripts_python/granger_pw.py found in paper text by Syntology unverified no licence file found · pointer only · 056cd5492fba5b71 · report
predict ckassaad/causal_discovery_for_time_series/baselines/scripts_python/kitmi.py found in paper text by Syntology unverified no licence file found · pointer only · a50bd03edb6f3900 · report
run_R ckassaad/causal_discovery_for_time_series/baselines/scripts_R/scripts_R.py found in paper text by Syntology unverified no licence file found · pointer only · 4fc714d69d52982a · report
run_matlab ckassaad/causal_discovery_for_time_series/baselines/scripts_matlab/scripts_matlab.py found in paper text by Syntology unverified no licence file found · pointer only · 7e18e34ec866a59a · report
train ckassaad/causal_discovery_for_time_series/baselines/scripts_python/kitmi.py found in paper text by Syntology unverified no licence file found · pointer only · 525a91883f4d1214 · report
ts_fci_dataframe_to_dict ckassaad/causal_discovery_for_time_series/baselines/scripts_R/scripts_R.py found in paper text by Syntology unverified no licence file found · pointer only · febad5f5c2b1ce68 · report
convert_provided_bound identical code first harvested elsewhere ran · honoured contract fingerprinted licence of this copy not recorded · b32a1228967d36d5 · report

Results from the paper

The Papers with Code archive ends with its 2025-07-28 snapshot. This paper's arXiv identifier, 2602.07915, was issued in February 2026, after that date, so the archive has no leaderboard rows for it.

Report a problem or propose a change · a person checks every report against the paper or source before anything changes; decisions are listed on /corrections