The Numenta Anomaly Benchmark Competition
For Real-Time Anomaly Detection
Part of the IEEE WCCI (World Congress on Computational Intelligence)
Do you have an algorithm that detects anomalies in streaming data? Or a dataset of real-world, time-series data with labeled anomalies? If so, you’re encouraged to enter the Numenta Anomaly Benchmark (NAB) Competition.
- What is NAB?
- Why is it important?
- What is the NAB competition?
- How do I enter?
- What are some example entries?
- What are the rules?
- What are the prizes?
- What is the deadline?
What is NAB?The Numenta Anomaly Detection Benchmark (NAB) attempts to provide a controlled and repeatable environment of open-source tools to test and measure anomaly detection algorithms on streaming data. NAB is available at https://github.com/numenta/NAB. You can learn more about NAB in this paper: http://arxiv.org/abs/1510.03336 or this video presentation, given by VP Research Subutai Ahmad at MLConf Nov 2015: Evaluating Real-Time Anomaly Detection: The Numenta Benchmark.
Why is it important?Much of the world’s data is streaming, time-series data, where anomalies give significant information in often-critical situations; examples abound in domains such as finance, IT, security, medical, and energy. Yet detecting anomalies in streaming data is a difficult task, requiring detectors to process data in real-time, not batches, and learn while simultaneously making predictions.
What is the NAB competition?Numenta is conducting this competition in association with the IEEE WCCI (World Congress on Computational Intelligence). The WCCI NAB competition has two categories:
- Algorithms: what is the best algorithm for detecting anomalies in streaming data?
- Datasets: what is the best data contribution to the benchmark corpus?
How do I enter?You may submit to either the algorithms or datasets components, or both. Please send all submissions to firstname.lastname@example.org.
Algorithms CategoryTo enter the Algorithms category, you must submit your anomaly detection algorithm and the results of running it on NAB. Deliverables include:
- Detailed description of algorithm(s), including NAB results
- Code to run your algorithm and recreate the results (link to Github repository is fine)
- List of contributors and contact information
Dataset CategoryTo enter the Dataset category, you must submit real-world, time-series data with labeled anomalies. Deliverables include:
- Data file(s) in CSV format
- one header row
- fields for "timestamp" (time at the end of the metric collection window) and "value" (the metric as either float or integer)
- timestamp format is
- Anomaly labels — timestamps at which the anomalies start
- Description of the data and anomalies
- meeting the requirements described above
- interesting types of anomalies
- relevance to real applications
- accuracy/quality of anomaly labels
- good challenges for detection algorithms
- quantity of data — the more files in your submission the better
- feasibility for algorithms to detect anomalies
- We can not expect noisy data without temporal patterns to be valuable in evaluating algorithms, and thus this type of data will not be useful in NAB.
What are some example entries?We’ve provided two example entries to give you an idea of what a submission in each category would look like.
DATASET CATEGORYAttached with this entry are two data files of satellite data. These are station-keeping metrics for a Planet Labs “Dove”, an Earth-imagery cubesat [1,2] currently in orbit! The file
dove_array_temp.csvcontains 10,000 records of the satellite’s external temperature, where the metric is degrees Celsius. The file
dove_p.csvis 6,610 records of the p-axis vector (in radians); this is one axis of a 4x1 quaternion that is used to orient the spacecraft . Both files have a column for timestamps in
yyyy-mm-dd hh:mm:ssformat, and one column for the metric values. The accompanying JSON file
dove_labels.jsoncontains anomaly labels for both of these files in the NAB format, where timestamps denote the start of each anomaly. The temperature data shows three anomalies: the first and third anomalies are fluctuations in the normal periodicity that correspond to attitude correction maneuvers as the satellite rotates in its nadir-pointing orbit , and the spike anomaly is where the temperature sensor has been exposed to direct sunlight. The quaternion data shows four anomalies, each representing rotational drag of the spacecraft due to the solar arrays; these are deployed like wings from the spacecraft and feel a pushing force from solar rays. Also included are plots showing the data and anomaly points.
-  https://www.planet.com/
-  https://en.wikipedia.org/wiki/CubeSat
-  https://en.wikipedia.org/wiki/Quaternions_and_spatial_rotation
-  https://en.wikipedia.org/wiki/Nadir
ALGORITHMS CATEGORYThe table below shows the results of running my algorithm, “BAD”, on NAB.
|Standard profile||Reward low-FP profile||Reward low-FN profile|
The algorithm bags together two outlier detectors, “outliers”  and “extremevalues” , which are both open-source R packages. To bag them they are run independently, each producing a probability that a given data point is anomalous, and the mean of these probabilities is the final anomaly likelihood. Running the NAB threshold optimization step, my algorithm has a detection threshold of 0.89 for all three scoring profiles. More info, along with the open-sourced code and NAB results files, can be found in the GitHub repository: gitub.com/baggedanomalydetectors. The repo includes directions on how to run the R code, which will generate CSV files with anomaly detections that you can then run through the NAB scoring system.For questions and comments please contact Dr. Boltzmann at email@example.com.
-  https://cran.r-project.org/web/packages/outliers/index.html
-  https://cran.r-project.org/web/packages/extremevalues/index.html
What are the rules?
- Entrants may make more than one submission in each category, but the algorithms/datasets must be unique (i.e. not just a tweak in the parameters).
- Results from submitted algorithms must be reproducible; either the algorithm code is open source or accompanied with a sufficient documentation detailing the algorithm.
- Submitted algorithms must meet the following criteria:
- Any sort of look ahead is not allowed. Detections by the algorithm must be made on the fly, one record at a time.
- There must be no batch, or per data file, manual parameter tuning. The algorithm must be fully automated with a single set of parameters across all data files. Any further parameter tuning required by the algorithm must be done on the fly. For example, it is not possible to look through a dataset, set a threshold, and then run through the data again. (One exception to this rule is that we allow the algorithm to know the range of data values for each data file. In the NAB detector code, the min/max value of each data file is passed in automatically when each algorithm is initialized.)
- The algorithm treats each file independently. The algorithm is initialized from scratch for each stream using a single constant set of parameters.
- It is not required to use NAB code to run your algorithm, but the reported scores must have been generated using the NAB scoring code. There are several ways to do this as detailed in the NAB wiki .
- Submitted data must meet the following criteria:
- Data files must be consistent with the existing NAB format and work with the existing codebase
- Univariate time-series data, from a real-world source.
- Each stream must be greater than 1000 records, where each record represents an equal amount of time (e.g. 5-minute intervals), and records are in chronological order.
- Any submission, regardless of eventual competition outcome, may be included in NAB. As such the data must be freely sharable; anyone will be able to view and download it from the NAB repository. Appropriate acknowledgment will be given.
- The data must be accompanied by a set of anomaly labels, along with a description of the data source.
- Official contest entrants must be participants of WCCI, however non-attendees are still eligible to win prizes outside of the conference. Numenta will judge submissions in two separate groups:
- WCCI attendees will be eligible for cash prizes and winners will be announced by conference staff during the event.
- Non-WCCI attendees will be eligible for cash prizes and will be announced separately by Numenta after WCCI.