https://github.com/arundo/adtk

A Python toolkit for rule-based/unsupervised anomaly detection in time series

https://github.com/arundo/adtk

Science Score: 13.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (18.6%) to scientific vocabulary

Keywords

anomaly-detection time-series
Last synced: 11 months ago · JSON representation

Repository

A Python toolkit for rule-based/unsupervised anomaly detection in time series

Basic Info
  • Host: GitHub
  • Owner: arundo
  • License: mpl-2.0
  • Language: Python
  • Default Branch: develop
  • Homepage: https://adtk.readthedocs.io
  • Size: 23.5 MB
Statistics
  • Stars: 1,174
  • Watchers: 24
  • Forks: 160
  • Open Issues: 51
  • Releases: 12
Topics
anomaly-detection time-series
Created almost 7 years ago · Last pushed almost 2 years ago
Metadata Files
Readme License

README.md

Anomaly Detection Toolkit (ADTK)

Build Status Documentation Status Coverage Status PyPI Downloads Code style: black Binder

Anomaly Detection Toolkit (ADTK) is a Python package for unsupervised / rule-based time series anomaly detection.

As the nature of anomaly varies over different cases, a model may not work universally for all anomaly detection problems. Choosing and combining detection algorithms (detectors), feature engineering methods (transformers), and ensemble methods (aggregators) properly is the key to build an effective anomaly detection model.

This package offers a set of common detectors, transformers and aggregators with unified APIs, as well as pipe classes that connect them together into models. It also provides some functions to process and visualize time series and anomaly events.

See https://adtk.readthedocs.io for complete documentation.

Installation

Prerequisites: Python 3.5 or later.

It is recommended to install the most recent stable release of ADTK from PyPI.

shell pip install adtk

Alternatively, you could install from source code. This will give you the latest, but unstable, version of ADTK.

shell git clone https://github.com/arundo/adtk.git cd adtk/ git checkout develop pip install ./

Examples

Please see Quick Start for a simple example.

For more detailed examples of each module of ADTK, please refer to Examples section in the documentation or an interactive demo notebook.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update unit tests as appropriate.

Please see Contributing for more details.

License

ADTK is licensed under the Mozilla Public License 2.0 (MPL 2.0). See the LICENSE file for details.

Owner

  • Name: Arundo Analytics
  • Login: arundo
  • Kind: organization

GitHub Events

Total
  • Issues event: 1
  • Watch event: 86
  • Issue comment event: 7
  • Fork event: 10
Last Year
  • Issues event: 1
  • Watch event: 86
  • Issue comment event: 7
  • Fork event: 10

Committers

Last synced: about 1 year ago

All Time
  • Total Commits: 64
  • Total Committers: 11
  • Avg Commits per committer: 5.818
  • Development Distribution Score (DDS): 0.25
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
tailaiw 2****w 48
tailaiw t****n@a****m 5
tailaiw-ghost 6****t 2
Roy Keyes r****g@g****m 2
tellezsanti t****i@g****m 1
burakyilmaz321 b****1@g****m 1
Yang Yu 4****6 1
Sam Zeitlin s****n@g****m 1
Nathaniel Saul n****t@r****m 1
Ajda a****r 1
Jason Hu j****u@a****m 1
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 12 months ago

All Time
  • Total issues: 68
  • Total pull requests: 45
  • Average time to close issues: about 1 month
  • Average time to close pull requests: 1 day
  • Total issue authors: 57
  • Total pull request authors: 9
  • Average comments per issue: 2.01
  • Average comments per pull request: 0.22
  • Merged pull requests: 34
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 2
  • Pull requests: 1
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 2
  • Pull request authors: 1
  • Average comments per issue: 0.0
  • Average comments per pull request: 4.0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • tailaiw (7)
  • engineeryashsaxena (2)
  • ivanokeeffe (2)
  • joriws (2)
  • TonyEinstein (2)
  • ajdapretnar (2)
  • senemaktas (1)
  • kusumy (1)
  • f5-ansible (1)
  • szeitlin (1)
  • Anaisdg (1)
  • nbrosse (1)
  • numericOverflow (1)
  • estcarisimo (1)
  • tellezsanti (1)
Pull Request Authors
  • tailaiw (32)
  • tailaiw-ghost (4)
  • earthgecko (3)
  • tellezsanti (2)
  • mazzma12 (1)
  • csrgxtu (1)
  • rbs392 (1)
  • nabeelraza-7 (1)
  • ajdapretnar (1)
Top Labels
Issue Labels
question (16) enhancement (5) bug (5) documentation (1) help wanted (1)
Pull Request Labels
WIP (1) documentation (1)

Packages

  • Total packages: 4
  • Total downloads:
    • pypi 276,339 last-month
  • Total dependent packages: 2
    (may contain duplicates)
  • Total dependent repositories: 40
    (may contain duplicates)
  • Total versions: 25
  • Total maintainers: 2
pypi.org: adtk

A package for unsupervised time series anomaly detection

  • Versions: 12
  • Dependent Packages: 2
  • Dependent Repositories: 38
  • Downloads: 276,339 Last month
  • Docker Downloads: 0
Rankings
Downloads: 0.6%
Stargazers count: 2.0%
Docker downloads count: 2.2%
Dependent repos count: 2.4%
Average: 2.7%
Forks count: 4.2%
Dependent packages count: 4.7%
Maintainers (2)
Last synced: 11 months ago
proxy.golang.org: github.com/arundo/adtk
  • Versions: 9
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 5.4%
Average: 5.5%
Dependent repos count: 5.7%
Last synced: 11 months ago
conda-forge.org: adtk

This package offers a set of common detectors, transformers and aggregators with unified APIs, as well as pipe classes that connect them together into models. It also provides some functions to process and visualize time series and anomaly events.

  • Versions: 3
  • Dependent Packages: 0
  • Dependent Repositories: 1
Rankings
Stargazers count: 13.3%
Forks count: 16.1%
Dependent repos count: 24.3%
Average: 26.3%
Dependent packages count: 51.6%
Last synced: 11 months ago
anaconda.org: adtk

This package offers a set of common detectors, transformers and aggregators with unified APIs, as well as pipe classes that connect them together into models. It also provides some functions to process and visualize time series and anomaly events.

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 1
Rankings
Stargazers count: 24.5%
Forks count: 28.7%
Average: 39.0%
Dependent packages count: 51.2%
Dependent repos count: 51.4%
Last synced: 11 months ago

Dependencies

docs/requirements-docs.txt pypi
  • jupyter >=1
  • nbsphinx >=0.4
  • python-dateutil >=2.5
  • sphinx >=2.0
  • sphinx_rtd_theme <0.5
.github/workflows/pythonpublish.yml actions
  • actions/checkout v1 composite
  • actions/setup-python v1 composite
pyproject.toml pypi
setup.py pypi