{"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/timex-learning-time-series-explanations-with","title":"TimeX++: Learning Time-Series Explanations with Information Bottleneck","arxiv_id":"2405.09308","date":"2024-05-15","proceeding":null,"authors":["Zichuan Liu","Tianchun Wang","Jimeng Shi","Xu Zheng","Zhuomin Chen","Lei Song","Wenqian Dong","Jayantha Obeysekera","Farhad Shirani","Dongsheng Luo"],"abstract":"Explaining deep learning models operating on time series data is crucial in various applications of interest which require interpretable and transparent insights from time series signals. In this work, we investigate this problem from an information theoretic perspective and show that most existing measures of explainability may suffer from trivial solutions and distributional shift issues. To address these issues, we introduce a simple yet practical objective function for time series explainable learning. The design of the objective function builds upon the principle of information bottleneck (IB), and modifies the IB objective function to avoid trivial solutions and distributional shift issues. We further present TimeX++, a novel explanation framework that leverages a parametric network to produce explanation-embedded instances that are both in-distributed and label-preserving. We evaluate TimeX++ on both synthetic and real-world datasets comparing its performance against leading baselines, and validate its practical efficacy through case studies in a real-world environmental application. Quantitative and qualitative evaluations show that TimeX++ outperforms baselines across all datasets, demonstrating a substantial improvement in explanation quality for time series data. The source code is available at \\url{https://github.com/zichuan-liu/TimeXplusplus}.","url_abs":"https://arxiv.org/abs/2405.09308v1","url_pdf":"https://arxiv.org/pdf/2405.09308v1.pdf","source":{"archive":"pwc-archive (Hugging Face), CC BY-SA 4.0","snapshot":"2025-07-28","licence_url":"https://creativecommons.org/licenses/by-sa/4.0/legalcode","row_kind":"abstracts"},"code_links":[{"paper_slug":"timex-learning-time-series-explanations-with","repo_url":"https://github.com/zichuan-liu/timexplusplus","is_official":1,"mentioned_in_paper":1,"mentioned_in_github":1,"framework":"pytorch","reach":{"status":"ok"}},{"paper_slug":"timex-learning-time-series-explanations-with","repo_url":"https://github.com/zichuan-liu/ib4llms","is_official":0,"mentioned_in_paper":0,"mentioned_in_github":1,"framework":"pytorch","reach":null}],"tasks":[{"task_slug":"time-series-1","task_name":"Time Series"}],"methods":[],"datasets_introduced":[],"methods_introduced":[],"results":[],"syntology":{"atlas_url":"https://app.syntology.ai/?focus=2405.09308","mcp":{"get_harvested_code_for_paper":{"arxiv_id":"2405.09308"}},"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":[{"provenance":"deterministic:regex_extraction","url":"https://github.com/zichuan-liu/TimeXplusplus","reach":{"status":"ok"}},{"provenance":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/zichuan-liu/ib4llms","reach":null},{"provenance":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/zichuan-liu/timexplusplus","reach":{"status":"ok"}}],"summary":{"ran":4,"ran_draft_wrong":3},"by_repo_kind":{"official":{"samples":7,"ran":7,"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":7,"samples":[{"code_sha256_prefix":"5a30ab7cdc1e83d5","entry":"concat_all_dicts","repo":"zichuan-liu/TimeXplusplus","repo_kind":"official","path":"experiments/evaluation/get_model_outputs.py","file_url":"https://github.com/zichuan-liu/TimeXplusplus/blob/HEAD/experiments/evaluation/get_model_outputs.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"5a30ab7cdc1e83d5"}},{"code_sha256_prefix":"8aa3139ada5e300b","entry":"naming_convention","repo":"zichuan-liu/timexplusplus","repo_kind":"official","path":"experiments/freqshape/bc_model_ptype.py","file_url":"https://github.com/zichuan-liu/timexplusplus/blob/HEAD/experiments/freqshape/bc_model_ptype.py","link_basis":"first_harvest_node","language":"python","status":"ran_draft_wrong","verification_level":1,"contract_check":"OUTPUT_MISDECLARED","metamorphic_tier":"deterministic","behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"8aa3139ada5e300b"}},{"code_sha256_prefix":"c060ddc9f31e7962","entry":"naming_convention","repo":"zichuan-liu/TimeXplusplus","repo_kind":"official","path":"experiments/Boiler/bc_model_ptype.py","file_url":"https://github.com/zichuan-liu/TimeXplusplus/blob/HEAD/experiments/Boiler/bc_model_ptype.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"c060ddc9f31e7962"}},{"code_sha256_prefix":"6b050e3c4f0c0904","entry":"naming_convention","repo":"zichuan-liu/TimeXplusplus","repo_kind":"official","path":"experiments/PAM/bc_model_ptype.py","file_url":"https://github.com/zichuan-liu/TimeXplusplus/blob/HEAD/experiments/PAM/bc_model_ptype.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"6b050e3c4f0c0904"}},{"code_sha256_prefix":"3c1f6345d3e11c6e","entry":"naming_convention","repo":"zichuan-liu/TimeXplusplus","repo_kind":"official","path":"experiments/epilepsy/bc_model_ptype.py","file_url":"https://github.com/zichuan-liu/TimeXplusplus/blob/HEAD/experiments/epilepsy/bc_model_ptype.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"3c1f6345d3e11c6e"}},{"code_sha256_prefix":"2890aeb57456dc85","entry":"normalize_exp","repo":"zichuan-liu/timexplusplus","repo_kind":"official","path":"experiments/freqshape/bc_model_ptype.py","file_url":"https://github.com/zichuan-liu/timexplusplus/blob/HEAD/experiments/freqshape/bc_model_ptype.py","link_basis":"first_harvest_node","language":"python","status":"ran_draft_wrong","verification_level":1,"contract_check":"MISDECLARED","metamorphic_tier":"invariant","behaviour_fingerprint":true,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"2890aeb57456dc85"}},{"code_sha256_prefix":"ec74cdbcfad6f7e2","entry":"print_results","repo":"zichuan-liu/timexplusplus","repo_kind":"official","path":"experiments/freqshape/bc_model_ptype.py","file_url":"https://github.com/zichuan-liu/timexplusplus/blob/HEAD/experiments/freqshape/bc_model_ptype.py","link_basis":"first_harvest_node","language":"python","status":"ran_draft_wrong","verification_level":1,"contract_check":"MISDECLARED","metamorphic_tier":"deterministic","behaviour_fingerprint":true,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"ec74cdbcfad6f7e2"}}]},"arxiv_metadata":null,"syntology_extracted_results":null}