readme.md

April 11, 2026 Β· View on GitHub

CoAD

πŸŒ‰ Bridging Classification and Reconstruction: Cooperative Time Series Anomaly Detection

Table of Contents

πŸ„β€ Overall Framework

main_structure

πŸ“„ Main Results

Evaluation results on reliable datasets (KDD21 [1] and TSB-AD [2]) using rigorous evaluation protocols [2].

main_results

πŸ“Š Case Studies

Visualizes the detection results of COAD on several challenging cases.

main_results

βš™οΈ Setup

Installation
conda create -n CoAD python=3.11
conda activate CoAD
pip install -r requirements.txt

πŸ—„οΈ Prepare datasets

  • A visual illustration of the flaws present in the datasets (SMD, PSM, SWaT, SMAP, MSL, and NAB) can be found at the following anonymous link: flawed datasets. The PDF is sourced from a presentation given at ITISE 2023.

  • Download the dataset from the anonymous link dataset and extract it to the dataset folder.

  • The 64 subsets of TSB-AD used in the paper can be found in the runners/run_all_CoAD.sh file, including MGAB, SED, SVDB, IOPS and TODS benchmark datasets.

β”œβ”€dataset
β”œβ”€β”€β”€TSB-AD
β”‚   β”œβ”€β”€β”€raw
β”‚   β”‚   β”œβ”€β”€β”€001_NAB_id_1_Facility_tr_1007_1st_2014.csv
β”‚   β”‚   β”œβ”€β”€β”€...
β”œβ”€β”€β”€UCR(KDD21)
β”‚   β”œβ”€β”€β”€processed
β”‚   β”‚   β”œβ”€β”€β”€train
β”‚   β”‚   β”œβ”€β”€β”€test
β”‚   β”‚   β”œβ”€β”€β”€label
β”‚   β”œβ”€β”€β”€all_period.csv

πŸ” Reproduce the main results

sh runners/run_all_CoAD.sh

πŸ” Reproduce the baseline results

# reproduce the deep learning based methods
sh runners/run_deep_baseline.sh
# reproduce the data mining based methods
sh runners/run_dm_baseline.sh

πŸ” Reproduce the ablation study results

The details of the ablation versions are shown in the runners/run_ablation_CoAD.sh file.

sh runners/run_ablation_CoAD.sh

πŸ” Reproduce the parameter study results

sh runners/parameter.sh

πŸ“š References

  1. β€œMultidataset time series anomaly detection competition,” 2021, https://compete.hexagon-ml.com/practice/competition/39/.

  2. β€œThe elephant in the room: Towards a reliable time-series anomaly detection benchmark,” in The 38th Conference on Neural Information Processing Systems Datasets and Benchmarks Track, 2024