{"about":{"site":"https://codewithpapers.app","non_affiliation":"Code with Papers and Syntology are not affiliated with, endorsed by, or sponsored by Papers with Code, Meta, or the pwc-archive mirror.","licence":"CC BY-SA 4.0","licence_url":"https://creativecommons.org/licenses/by-sa/4.0/legalcode","attribution":"https://codewithpapers.app/attribution","modified":"archive material modified by Syntology; see the attribution page"},"url":"/paper/arxiv-2608-00198","title":"AutoCause: A Python framework that automates expert decisions in environmental time-series causal discovery","arxiv_id":"2608.00198","date":"2026-07-31","proceeding":null,"authors":["Marco Ruiz","Miguel Arana-Catania","David R. Ardila","Rodrigo Ventura"],"abstract":"Environmental time-series causal discovery requires expert decisions about method choice, conditional-independence tests, lag horizons, sample-size adequacy, multiple-testing control, and evidence interpretation. Applied inconsistently across datasets, these choices yield graphs that cannot be compared, reproduced, or audited. We present AutoCause, an open-source Python workflow that records each decision, derives defaults from an extended causal-audit module, and admits domain-informed overrides. The workflow wraps four established causal-discovery methods from three families, adds non-causal reference models, and grades links by method-count support. On 145 datasets from DGP-Atlas, TimeGraph, and a topology-derived CausalRivers reference, the methods recover complementary parts of the reference graphs. Majority-supported links are more precise than single-method links on the synthetic benchmarks but not against river topology. AutoCause converts inconsistent expert practice into an auditable, repeatable analysis; causal interpretation remains with the analyst. Available at https://github.com/marcoruizrueda/autocause.","url_abs":"https://arxiv.org/abs/2608.00198","url_pdf":"https://arxiv.org/pdf/2608.00198","source":{"archive":null,"snapshot":"2025-07-28","note":"not in the Papers with Code archive (frozen at the snapshot)","row_kind":"graph","title_abstract_authors_date":"arXiv metadata, CC0 1.0 (https://info.arxiv.org/help/license)"},"code_links":[],"tasks":[],"methods":[],"datasets_introduced":[],"methods_introduced":[],"results":[],"syntology":{"syntology_url":null,"atlas_url":"https://app.syntology.ai/?focus=2608.00198","mcp":{"get_harvested_code_for_paper":{"arxiv_id":"2608.00198"}},"developers":"https://syntology.ai/developers","read_at":"2026-09-24T18:15:14+00:00","read_at_is":"when the build read Syntology's graph, not when any sample ran","claim":"Per-sample execution status on synthesized fixtures; not a correctness claim about the paper. Samples come from repositories linked to the paper, official or community; repo_kind says which.","repos":[{"mentioned_in_github":null,"is_official":null,"provenance":"deterministic:regex_extraction","mentioned_in_paper":null,"url":"https://github.com/marcoruizrueda/autocause","reach":null}],"summary":{"ran":14,"unverified":8},"by_repo_kind":{"found_in_text":{"samples":22,"ran":14,"repositories":1}},"repo_kind_vocabulary":{"official":"The archive marks this repository official for the paper","named_in_paper":"The archive records that the paper mentions this repository; it is not marked official","listed":"In the archive's code links for this paper, not marked official and not recorded as mentioned in the paper","found_in_text":"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"},"n_pointer_only_for_licence":22,"samples":[{"code_sha256_prefix":"d896e199cf6742f2","entry":"bootstrap_ci","repo":"marcoruizrueda/autocause","repo_kind":"found_in_text","path":"experiments/make_figures.py","file_url":"https://github.com/marcoruizrueda/autocause/blob/HEAD/experiments/make_figures.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"AGPL-3.0","inline_ok":false,"mcp_get_code":{"code_sha256":"d896e199cf6742f2"}},{"code_sha256_prefix":"71620cb36e40f3f6","entry":"compute_tier_precision","repo":"marcoruizrueda/autocause","repo_kind":"found_in_text","path":"experiments/recompute_tier_metrics.py","file_url":"https://github.com/marcoruizrueda/autocause/blob/HEAD/experiments/recompute_tier_metrics.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"AGPL-3.0","inline_ok":false,"mcp_get_code":{"code_sha256":"71620cb36e40f3f6"}},{"code_sha256_prefix":"bae801ff01bc29bd","entry":"extract_tier_edges","repo":"marcoruizrueda/autocause","repo_kind":"found_in_text","path":"experiments/reproduce_fig8_tiers.py","file_url":"https://github.com/marcoruizrueda/autocause/blob/HEAD/experiments/reproduce_fig8_tiers.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"AGPL-3.0","inline_ok":false,"mcp_get_code":{"code_sha256":"bae801ff01bc29bd"}},{"code_sha256_prefix":"0b2f5bc148c4f3e4","entry":"load_consensus_edges","repo":"marcoruizrueda/autocause","repo_kind":"found_in_text","path":"experiments/recompute_tier_metrics.py","file_url":"https://github.com/marcoruizrueda/autocause/blob/HEAD/experiments/recompute_tier_metrics.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"AGPL-3.0","inline_ok":false,"mcp_get_code":{"code_sha256":"0b2f5bc148c4f3e4"}},{"code_sha256_prefix":"24aad64628702bba","entry":"load_dgp_dataset","repo":"marcoruizrueda/autocause","repo_kind":"found_in_text","path":"experiments/run_dgp_atlas.py","file_url":"https://github.com/marcoruizrueda/autocause/blob/HEAD/experiments/run_dgp_atlas.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"AGPL-3.0","inline_ok":false,"mcp_get_code":{"code_sha256":"24aad64628702bba"}},{"code_sha256_prefix":"0f771887bcf9037f","entry":"load_subgraph_tiers","repo":"marcoruizrueda/autocause","repo_kind":"found_in_text","path":"experiments/verify_causalrivers_tiers.py","file_url":"https://github.com/marcoruizrueda/autocause/blob/HEAD/experiments/verify_causalrivers_tiers.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"AGPL-3.0","inline_ok":false,"mcp_get_code":{"code_sha256":"0f771887bcf9037f"}},{"code_sha256_prefix":"56e83549aaed012d","entry":"load_timegraph_dataset","repo":"marcoruizrueda/autocause","repo_kind":"found_in_text","path":"experiments/run_timegraph.py","file_url":"https://github.com/marcoruizrueda/autocause/blob/HEAD/experiments/run_timegraph.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"AGPL-3.0","inline_ok":false,"mcp_get_code":{"code_sha256":"56e83549aaed012d"}},{"code_sha256_prefix":"7d0696eee5a53bdd","entry":"load_true_edges","repo":"marcoruizrueda/autocause","repo_kind":"found_in_text","path":"experiments/recompute_tier_metrics.py","file_url":"https://github.com/marcoruizrueda/autocause/blob/HEAD/experiments/recompute_tier_metrics.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"AGPL-3.0","inline_ok":false,"mcp_get_code":{"code_sha256":"7d0696eee5a53bdd"}},{"code_sha256_prefix":"229a4bb21506f7f1","entry":"map_audit_to_config","repo":"marcoruizrueda/autocause","repo_kind":"found_in_text","path":"framework/core/causal_audit_adapter.py","file_url":"https://github.com/marcoruizrueda/autocause/blob/HEAD/framework/core/causal_audit_adapter.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"AGPL-3.0","inline_ok":false,"mcp_get_code":{"code_sha256":"229a4bb21506f7f1"}},{"code_sha256_prefix":"62ef4caa6a3a95b7","entry":"method_divergence_alert","repo":"marcoruizrueda/autocause","repo_kind":"found_in_text","path":"framework/core/diagnostics.py","file_url":"https://github.com/marcoruizrueda/autocause/blob/HEAD/framework/core/diagnostics.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"AGPL-3.0","inline_ok":false,"mcp_get_code":{"code_sha256":"62ef4caa6a3a95b7"}},{"code_sha256_prefix":"813815e9792ac88b","entry":"resample_to_6h","repo":"marcoruizrueda/autocause","repo_kind":"found_in_text","path":"experiments/run_causalrivers.py","file_url":"https://github.com/marcoruizrueda/autocause/blob/HEAD/experiments/run_causalrivers.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"AGPL-3.0","inline_ok":false,"mcp_get_code":{"code_sha256":"813815e9792ac88b"}},{"code_sha256_prefix":"7cd186e4f3b79701","entry":"restrict_to_year","repo":"marcoruizrueda/autocause","repo_kind":"found_in_text","path":"experiments/run_causalrivers.py","file_url":"https://github.com/marcoruizrueda/autocause/blob/HEAD/experiments/run_causalrivers.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"AGPL-3.0","inline_ok":false,"mcp_get_code":{"code_sha256":"7cd186e4f3b79701"}},{"code_sha256_prefix":"eed6bc2a96241719","entry":"sample_subgraphs","repo":"marcoruizrueda/autocause","repo_kind":"found_in_text","path":"experiments/run_causalrivers.py","file_url":"https://github.com/marcoruizrueda/autocause/blob/HEAD/experiments/run_causalrivers.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"AGPL-3.0","inline_ok":false,"mcp_get_code":{"code_sha256":"eed6bc2a96241719"}},{"code_sha256_prefix":"e23259dfe68d649e","entry":"verify_tier_inversion","repo":"marcoruizrueda/autocause","repo_kind":"found_in_text","path":"experiments/verify_causalrivers_tiers.py","file_url":"https://github.com/marcoruizrueda/autocause/blob/HEAD/experiments/verify_causalrivers_tiers.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"AGPL-3.0","inline_ok":false,"mcp_get_code":{"code_sha256":"e23259dfe68d649e"}},{"code_sha256_prefix":"0304bf7a55cfb863","entry":"batch_quantify","repo":"marcoruizrueda/autocause","repo_kind":"found_in_text","path":"framework/core/causal_strength.py","file_url":"https://github.com/marcoruizrueda/autocause/blob/HEAD/framework/core/causal_strength.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"AGPL-3.0","inline_ok":false,"mcp_get_code":{"code_sha256":"0304bf7a55cfb863"}},{"code_sha256_prefix":"1322f75950070594","entry":"decide_and_run","repo":"marcoruizrueda/autocause","repo_kind":"found_in_text","path":"framework/core/decision.py","file_url":"https://github.com/marcoruizrueda/autocause/blob/HEAD/framework/core/decision.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"AGPL-3.0","inline_ok":false,"mcp_get_code":{"code_sha256":"1322f75950070594"}},{"code_sha256_prefix":"fcb38b5fa8af8636","entry":"decide_for_pair","repo":"marcoruizrueda/autocause","repo_kind":"found_in_text","path":"framework/core/decision.py","file_url":"https://github.com/marcoruizrueda/autocause/blob/HEAD/framework/core/decision.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"AGPL-3.0","inline_ok":false,"mcp_get_code":{"code_sha256":"fcb38b5fa8af8636"}},{"code_sha256_prefix":"b321a31e955a3677","entry":"load_dataset","repo":"marcoruizrueda/autocause","repo_kind":"found_in_text","path":"experiments/reproduce_fig8_tiers.py","file_url":"https://github.com/marcoruizrueda/autocause/blob/HEAD/experiments/reproduce_fig8_tiers.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"AGPL-3.0","inline_ok":false,"mcp_get_code":{"code_sha256":"b321a31e955a3677"}},{"code_sha256_prefix":"5e9ba834237b0f4f","entry":"permutation_negative_control","repo":"marcoruizrueda/autocause","repo_kind":"found_in_text","path":"framework/core/diagnostics.py","file_url":"https://github.com/marcoruizrueda/autocause/blob/HEAD/framework/core/diagnostics.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"AGPL-3.0","inline_ok":false,"mcp_get_code":{"code_sha256":"5e9ba834237b0f4f"}},{"code_sha256_prefix":"edc3e440528f7d2b","entry":"reverse_direction_check","repo":"marcoruizrueda/autocause","repo_kind":"found_in_text","path":"framework/core/diagnostics.py","file_url":"https://github.com/marcoruizrueda/autocause/blob/HEAD/framework/core/diagnostics.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"AGPL-3.0","inline_ok":false,"mcp_get_code":{"code_sha256":"edc3e440528f7d2b"}},{"code_sha256_prefix":"738dc557ee4fe0b5","entry":"run_ci_sensitivity","repo":"marcoruizrueda/autocause","repo_kind":"found_in_text","path":"framework/core/ci_sensitivity.py","file_url":"https://github.com/marcoruizrueda/autocause/blob/HEAD/framework/core/ci_sensitivity.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"AGPL-3.0","inline_ok":false,"mcp_get_code":{"code_sha256":"738dc557ee4fe0b5"}},{"code_sha256_prefix":"827f34cd93c0da54","entry":"run_plan_for_pair","repo":"marcoruizrueda/autocause","repo_kind":"found_in_text","path":"framework/core/decision.py","file_url":"https://github.com/marcoruizrueda/autocause/blob/HEAD/framework/core/decision.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"AGPL-3.0","inline_ok":false,"mcp_get_code":{"code_sha256":"827f34cd93c0da54"}}]},"arxiv_metadata":{"licence":"arXiv metadata, CC0 1.0 (https://info.arxiv.org/help/license)","fields":["title","abstract","authors","date"],"primary_category":"cs.LG","source":"arxiv_2026.jsonl"},"syntology_extracted_results":{"kind":"leaderboard_placements","source":"Syntology's leaderboard-shaped extractor over the paper's own arXiv-HTML tables: a model pointed at a cell, the number was read from that cell and checked against the board's metric, dataset, split and scale, and an independent check accepted the entry; not reviewed by the paper's authors or the archive's editors","extractor_model":"global.anthropic.claude-sonnet-4-5-20250929-v1:0","verifier_model":null,"prompt_sha":"fa63d4bb9d755694","coverage":{"sentence":"Syntology has checked 6,795 of the 9,581 papers on this site that are newer than the archive; results from the others appear after they are checked.","papers_newer_than_archive":9581,"papers_checked":6795},"entries":[],"not_placed":{"boards":0,"rejected_by_independent_check":0,"refused_by_a_rule":0,"check_did_not_answer":0,"proposed_without_a_cell":0,"declined_by_site":0}}}