{"id":21989733,"url":"https://github.com/iandanforth/nab-detectors","last_synced_at":"2026-05-13T20:34:03.431Z","repository":{"id":142059405,"uuid":"184490695","full_name":"iandanforth/NAB-detectors","owner":"iandanforth","description":"Detectors for the Numenta Anomaly Benchmark","archived":false,"fork":false,"pushed_at":"2019-05-15T17:34:34.000Z","size":87,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-04-03T04:16:47.133Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/iandanforth.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-05-01T22:38:44.000Z","updated_at":"2019-05-15T17:34:36.000Z","dependencies_parsed_at":null,"dependency_job_id":"611129c5-ecd4-44a1-a908-f30205244706","html_url":"https://github.com/iandanforth/NAB-detectors","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/iandanforth/NAB-detectors","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iandanforth%2FNAB-detectors","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iandanforth%2FNAB-detectors/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iandanforth%2FNAB-detectors/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iandanforth%2FNAB-detectors/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iandanforth","download_url":"https://codeload.github.com/iandanforth/NAB-detectors/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iandanforth%2FNAB-detectors/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32999461,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-13T13:14:54.681Z","status":"ssl_error","status_checked_at":"2026-05-13T13:14:51.610Z","response_time":115,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-29T19:32:47.021Z","updated_at":"2026-05-13T20:34:03.415Z","avatar_url":"https://github.com/iandanforth.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NAB-detectors\n\nThis is a companion repository for the [Numenta Anomaly Benchmark\n(NAB)](https://github.com/numenta/NAB). If you are unfamiliar with NAB please\nrefer to the main repository first.\n\nIn 2019 the main body of the benchmark's code was ported to Python 3. The\nNumenta detector code was outside the scope of that project and was moved here.\n\nThis repository can be used to replicate results listed on the scoreboard of\nthe main repository for the following detectors:\n\n    numenta\n    numentaTM\n    htmjava  # See README.md in nab/detectors/htmjava for more additional setup\n\n## Installation\n\n### Initial requirements\n\nYou need to manually install the following:\n\n- [Python 2.7](https://www.python.org/download/)\n- [pip](https://pip.pypa.io/en/latest/installing.html)\n- [NumPy](http://www.numpy.org/)\n- [NuPIC](http://www.github.com/numenta/nupic)\n\n### Clone this repository\n\n`git clone git@github.com:numenta/NAB-detectors.git`\n\n### Install the Python requirements\n\n    cd NAB-detectors\n    (sudo) pip install -r requirements.txt\n\nThis will install the required modules.\n\n## Usage\n\n**Note**: The following assumes you have a working Python 2.7 environment.\n\n### NAB Benchmark Data \n\nThe canonical benchmark data is stored in the main NAB repository. You will need to\nclone the main NAB repository into a sibling directory.\n\n    cd ..\n    git clone git@github.com:numenta/NAB.git\n\n### Running a Detector\n\nOne or more detectors can be run against the benchmark data by specifying\nwhich detector or detectors to run and the path to the main NAB data\ndirectory.\n\nFor example, to run the `numenta` detector move into the `NAB-detectors`\nrepository and run:\n\n    cd NAB-detectors\n    python run.py -d numenta --detect --rootDir path/to/NAB/\n\nNote: By default `run.py` tries to use all the cores on your machine. The above\ncommand should take about 20-30 minutes on a current powerful laptop with 4-8\ncores.\n\nFor debugging you can run subsets of the data files by modifying and\nspecifying specific label files (see section below). Please type:\n\n    python run.py --help\n\nto see all the options.\n\nNote that to replicate results exactly as in the NAB paper you may need to checkout\nthe specific version of NuPIC (and associated nupic.core) that is noted in the\n[Scoreboard](https://github.com/numenta/NAB#additional-scores):\n\n    cd /path/to/nupic/\n    git checkout -b nab {TAG NAME}\n    cd /path/to/nupic.core/\n    git checkout -b nab {TAG NAME}\n\n##### Run a subset of NAB data files\n\nFor debugging it is sometimes useful to be able to run your algorithm on a\nsubset of the NAB data files or on your own set of data files. You can do that\nby creating a custom `combined_windows.json` file that only contains labels for\nthe files you want to run. This new file should be in exactly the same format as\n`combined_windows.json` except it would only contain windows for the files you\nare interested in.\n\n**Example**: an example file containing two files is in\n`labels/combined_windows_tiny.json`. (Part of the main NAB repository) The following \ncommand shows you how to run NAB on a subset of labels:\n\n    cd /path/to/NAB-detectors\n    python run.py -d numenta --detect --rootDir path/to/NAB --windowsFile labels/combined_windows_tiny.json\n\nThis will run the `detect` phase of NAB on the data files specified in the above\nJSON file. Note that scoring and normalization are not supported with this\noption. Note also that you may see warning messages regarding the lack of labels\nfor other files. You can ignore these warnings.\n\n### Detector Output\n\nAfter running a detector against the data the `path/to/NAB/results` directory\nwill be updated with the results for the detector run.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiandanforth%2Fnab-detectors","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiandanforth%2Fnab-detectors","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiandanforth%2Fnab-detectors/lists"}