sktime


Namesktime JSON
Version 0.28.0 PyPI version JSON
download
home_pageNone
SummaryA unified framework for machine learning with time series
upload_time2024-03-28 01:36:39
maintainerFranz Király, Jonathan Bechtel, Kiril Ralinovski, Marc Rovira, Sagar Mishra, Ugochukwu Onyeka
docs_urlNone
authorNone
requires_python<3.13,>=3.8
licenseBSD 3-Clause License Copyright (c) 2019 - present, The sktime developers. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
keywords data-mining data-science forecasting machine-learning scikit-learn time-series time-series-analysis time-series-classification time-series-regression
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage
            <a href="https://www.sktime.net"><img src="https://github.com/sktime/sktime/blob/main/docs/source/images/sktime-logo.svg" width="175" align="right" /></a>

# Welcome to sktime

> A unified interface for machine learning with time series

:rocket: **Version 0.28.0 out now!** [Check out the release notes here](https://www.sktime.net/en/latest/changelog.html).

sktime is a library for time series analysis in Python. It provides a unified interface for multiple time series learning tasks. Currently, this includes time series classification, regression, clustering, annotation, and forecasting. It comes with [time series algorithms](https://www.sktime.net/en/stable/estimator_overview.html) and [scikit-learn] compatible tools to build, tune and validate time series models.

[scikit-learn]: https://scikit-learn.org/stable/

| Overview | |
|---|---|
| **Open&#160;Source** | [![BSD 3-clause](https://img.shields.io/badge/License-BSD%203--Clause-blue.svg)](https://github.com/sktime/sktime/blob/main/LICENSE) |
| **Tutorials** | [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/sktime/sktime/main?filepath=examples) [![!youtube](https://img.shields.io/static/v1?logo=youtube&label=YouTube&message=tutorials&color=red)](https://www.youtube.com/playlist?list=PLKs3UgGjlWHqNzu0LEOeLKvnjvvest2d0) |
| **Community** | [![!discord](https://img.shields.io/static/v1?logo=discord&label=discord&message=chat&color=lightgreen)](https://discord.com/invite/54ACzaFsn7) [![!slack](https://img.shields.io/static/v1?logo=linkedin&label=LinkedIn&message=news&color=lightblue)](https://www.linkedin.com/company/scikit-time/)  |
| **CI/CD** | [![github-actions](https://img.shields.io/github/actions/workflow/status/sktime/sktime/wheels.yml?logo=github)](https://github.com/sktime/sktime/actions/workflows/wheels.yml) [![!codecov](https://img.shields.io/codecov/c/github/sktime/sktime?label=codecov&logo=codecov)](https://codecov.io/gh/sktime/sktime) [![readthedocs](https://img.shields.io/readthedocs/sktime?logo=readthedocs)](https://www.sktime.net/en/latest/?badge=latest) [![platform](https://img.shields.io/conda/pn/conda-forge/sktime)](https://github.com/sktime/sktime) |
| **Code** |  [![!pypi](https://img.shields.io/pypi/v/sktime?color=orange)](https://pypi.org/project/sktime/) [![!conda](https://img.shields.io/conda/vn/conda-forge/sktime)](https://anaconda.org/conda-forge/sktime) [![!python-versions](https://img.shields.io/pypi/pyversions/sktime)](https://www.python.org/) [![!black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)  |
| **Downloads**| [![Downloads](https://static.pepy.tech/personalized-badge/sktime?period=week&units=international_system&left_color=grey&right_color=blue&left_text=weekly%20(pypi))](https://pepy.tech/project/sktime) [![Downloads](https://static.pepy.tech/personalized-badge/sktime?period=month&units=international_system&left_color=grey&right_color=blue&left_text=monthly%20(pypi))](https://pepy.tech/project/sktime) [![Downloads](https://static.pepy.tech/personalized-badge/sktime?period=total&units=international_system&left_color=grey&right_color=blue&left_text=cumulative%20(pypi))](https://pepy.tech/project/sktime) |
| **Citation** | [![!zenodo](https://zenodo.org/badge/DOI/10.5281/zenodo.3749000.svg)](https://doi.org/10.5281/zenodo.3749000) |

## :books: Documentation

| Documentation              |                                                                |
| -------------------------- | -------------------------------------------------------------- |
| :star: **[Tutorials]**        | New to sktime? Here's everything you need to know!              |
| :clipboard: **[Binder Notebooks]** | Example notebooks to play with in your browser.              |
| :woman_technologist: **[User Guides]**      | How to use sktime and its features.                             |
| :scissors: **[Extension Templates]** | How to build your own estimator using sktime's API.            |
| :control_knobs: **[API Reference]**      | The detailed reference for sktime's API.                        |
| :tv: **[Video Tutorial]**            | Our video tutorial from 2021 PyData Global.      |
| :hammer_and_wrench: **[Changelog]**          | Changes and version history.                                   |
| :deciduous_tree: **[Roadmap]**          | sktime's software and community development plan.                                   |
| :pencil: **[Related Software]**          | A list of related software. |

[tutorials]: https://www.sktime.net/en/latest/tutorials.html
[binder notebooks]: https://mybinder.org/v2/gh/sktime/sktime/main?filepath=examples
[user guides]: https://www.sktime.net/en/latest/user_guide.html
[video tutorial]: https://github.com/sktime/sktime-tutorial-pydata-global-2021
[api reference]: https://www.sktime.net/en/latest/api_reference.html
[changelog]: https://www.sktime.net/en/latest/changelog.html
[roadmap]: https://www.sktime.net/en/latest/roadmap.html
[related software]: https://www.sktime.net/en/latest/related_software.html

## :speech_balloon: Where to ask questions

Questions and feedback are extremely welcome! We strongly believe in the value of sharing help publicly, as it allows a wider audience to benefit from it.

| Type                            | Platforms                               |
| ------------------------------- | --------------------------------------- |
| :bug: **Bug Reports**              | [GitHub Issue Tracker]                  |
| :sparkles: **Feature Requests & Ideas** | [GitHub Issue Tracker]                       |
| :woman_technologist: **Usage Questions**          | [GitHub Discussions] · [Stack Overflow] |
| :speech_balloon: **General Discussion**        | [GitHub Discussions] |
| :factory: **Contribution & Development** | `dev-chat` channel · [Discord] |
| :globe_with_meridians: **Community collaboration session** | [Discord] - Fridays 3 pm UTC, dev/meet-ups channel |

[github issue tracker]: https://github.com/sktime/sktime/issues
[github discussions]: https://github.com/sktime/sktime/discussions
[stack overflow]: https://stackoverflow.com/questions/tagged/sktime
[discord]: https://discord.com/invite/54ACzaFsn7

## :dizzy: Features
Our objective is to enhance the interoperability and usability of the time series analysis ecosystem in its entirety. sktime provides a __unified interface for distinct but related time series learning tasks__. It features [__dedicated time series algorithms__](https://www.sktime.net/en/stable/estimator_overview.html) and __tools for composite model building__  such as pipelining, ensembling, tuning, and reduction, empowering users to apply an algorithm designed for one task to another.

sktime also provides **interfaces to related libraries**, for example [scikit-learn], [statsmodels], [tsfresh], [PyOD], and [fbprophet], among others.

[statsmodels]: https://www.statsmodels.org/stable/index.html
[tsfresh]: https://tsfresh.readthedocs.io/en/latest/
[pyod]: https://pyod.readthedocs.io/en/latest/
[fbprophet]: https://facebook.github.io/prophet/

| Module | Status | Links |
|---|---|---|
| **[Forecasting]** | stable | [Tutorial](https://www.sktime.net/en/latest/examples/01_forecasting.html) · [API Reference](https://www.sktime.net/en/latest/api_reference/forecasting.html) · [Extension Template](https://github.com/sktime/sktime/blob/main/extension_templates/forecasting.py)  |
| **[Time Series Classification]** | stable | [Tutorial](https://github.com/sktime/sktime/blob/main/examples/02_classification.ipynb) · [API Reference](https://www.sktime.net/en/latest/api_reference/classification.html) · [Extension Template](https://github.com/sktime/sktime/blob/main/extension_templates/classification.py) |
| **[Time Series Regression]** | stable | [API Reference](https://www.sktime.net/en/latest/api_reference/regression.html) |
| **[Transformations]** | stable | [Tutorial](https://github.com/sktime/sktime/blob/main/examples/03_transformers.ipynb) · [API Reference](https://www.sktime.net/en/latest/api_reference/transformations.html) · [Extension Template](https://github.com/sktime/sktime/blob/main/extension_templates/transformer.py)  |
| **[Parameter fitting]** | maturing | [API Reference](https://www.sktime.net/en/latest/api_reference/param_est.html) · [Extension Template](https://github.com/sktime/sktime/blob/main/extension_templates/transformer.py)  |
| **[Time Series Clustering]** | maturing | [API Reference](https://www.sktime.net/en/latest/api_reference/clustering.html) ·  [Extension Template](https://github.com/sktime/sktime/blob/main/extension_templates/clustering.py) |
| **[Time Series Distances/Kernels]** | maturing | [Tutorial](https://github.com/sktime/sktime/blob/main/examples/03_transformers.ipynb) · [API Reference](https://www.sktime.net/en/latest/api_reference/dists_kernels.html) · [Extension Template](https://github.com/sktime/sktime/blob/main/extension_templates/dist_kern_panel.py) |
| **[Time Series Alignment]** | experimental | [API Reference](https://www.sktime.net/en/latest/api_reference/alignment.html) · [Extension Template](https://github.com/sktime/sktime/blob/main/extension_templates/alignment.py) |
| **[Annotation]** | experimental | [Extension Template](https://github.com/sktime/sktime/blob/main/extension_templates/annotation.py) |
| **[Time Series Splitters]** | maturing | [Extension Template](https://github.com/sktime/sktime/blob/main/extension_templates/split.py) | |
| **[Distributions and simulation]** | experimental |  |

[forecasting]: https://github.com/sktime/sktime/tree/main/sktime/forecasting
[time series classification]: https://github.com/sktime/sktime/tree/main/sktime/classification
[time series regression]: https://github.com/sktime/sktime/tree/main/sktime/regression
[time series clustering]: https://github.com/sktime/sktime/tree/main/sktime/clustering
[annotation]: https://github.com/sktime/sktime/tree/main/sktime/annotation
[time series distances/kernels]: https://github.com/sktime/sktime/tree/main/sktime/dists_kernels
[time series alignment]: https://github.com/sktime/sktime/tree/main/sktime/alignment
[transformations]: https://github.com/sktime/sktime/tree/main/sktime/transformations
[distributions and simulation]: https://github.com/sktime/sktime/tree/main/sktime/proba
[time series splitters]: https://github.com/sktime/sktime/tree/main/sktime/split
[parameter fitting]: https://github.com/sktime/sktime/tree/main/sktime/param_est


## :hourglass_flowing_sand: Install sktime
For troubleshooting and detailed installation instructions, see the [documentation](https://www.sktime.net/en/latest/installation.html).

- **Operating system**: macOS X · Linux · Windows 8.1 or higher
- **Python version**: Python 3.8, 3.9, 3.10, 3.11, and 3.12 (only 64-bit)
- **Package managers**: [pip] · [conda] (via `conda-forge`)

[pip]: https://pip.pypa.io/en/stable/
[conda]: https://docs.conda.io/en/latest/

### pip
Using pip, sktime releases are available as source packages and binary wheels.
Available wheels are listed [here](https://pypi.org/simple/sktime/).

```bash
pip install sktime
```

or, with maximum dependencies,

```bash
pip install sktime[all_extras]
```

For curated sets of soft dependencies for specific learning tasks:

```bash
pip install sktime[forecasting]  # for selected forecasting dependencies
pip install sktime[forecasting,transformations]  # forecasters and transformers
```

or similar. Valid sets are:

* `forecasting`
* `transformations`
* `classification`
* `regression`
* `clustering`
* `param_est`
* `networks`
* `annotation`
* `alignment`

Cave: in general, not all soft dependencies for a learning task are installed,
only a curated selection.

### conda
You can also install sktime from `conda` via the `conda-forge` channel.
The feedstock including the build recipe and configuration is maintained
in [this conda-forge repository](https://github.com/conda-forge/sktime-feedstock).

```bash
conda install -c conda-forge sktime
```

or, with maximum dependencies,

```bash
conda install -c conda-forge sktime-all-extras
```

(as `conda` does not support dependency sets,
flexible choice of soft dependencies is unavailable via `conda`)

## :zap: Quickstart

### Forecasting

``` python
from sktime.datasets import load_airline
from sktime.forecasting.base import ForecastingHorizon
from sktime.forecasting.theta import ThetaForecaster
from sktime.split import temporal_train_test_split
from sktime.performance_metrics.forecasting import mean_absolute_percentage_error

y = load_airline()
y_train, y_test = temporal_train_test_split(y)
fh = ForecastingHorizon(y_test.index, is_relative=False)
forecaster = ThetaForecaster(sp=12)  # monthly seasonal periodicity
forecaster.fit(y_train)
y_pred = forecaster.predict(fh)
mean_absolute_percentage_error(y_test, y_pred)
>>> 0.08661467738190656
```

### Time Series Classification

```python
from sktime.classification.interval_based import TimeSeriesForestClassifier
from sktime.datasets import load_arrow_head
from sklearn.model_selection import train_test_split
from sklearn.metrics import accuracy_score

X, y = load_arrow_head()
X_train, X_test, y_train, y_test = train_test_split(X, y)
classifier = TimeSeriesForestClassifier()
classifier.fit(X_train, y_train)
y_pred = classifier.predict(X_test)
accuracy_score(y_test, y_pred)
>>> 0.8679245283018868
```

## :wave: How to get involved

There are many ways to join the sktime community. We follow the [all-contributors](https://github.com/all-contributors/all-contributors) specification: all kinds of contributions are welcome - not just code.

| Documentation              |                                                                |
| -------------------------- | --------------------------------------------------------------        |
| :gift_heart: **[Contribute]**        | How to contribute to sktime.          |
| :school_satchel:  **[Mentoring]** | New to open source? Apply to our mentoring program! |
| :date: **[Meetings]** | Join our discussions, tutorials, workshops, and sprints! |
| :woman_mechanic:  **[Developer Guides]**      | How to further develop sktime's code base.                             |
| :construction: **[Enhancement Proposals]** | Design a new feature for sktime. |
| :medal_sports: **[Contributors]** | A list of all contributors. |
| :raising_hand: **[Roles]** | An overview of our core community roles. |
| :money_with_wings: **[Donate]** | Fund sktime maintenance and development. |
| :classical_building: **[Governance]** | How and by whom decisions are made in sktime's community.   |

[contribute]: https://www.sktime.net/en/latest/get_involved/contributing.html
[donate]: https://opencollective.com/sktime
[extension templates]: https://github.com/sktime/sktime/tree/main/extension_templates
[developer guides]: https://www.sktime.net/en/latest/developer_guide.html
[contributors]: https://github.com/sktime/sktime/blob/main/CONTRIBUTORS.md
[governance]: https://www.sktime.net/en/latest/get_involved/governance.html
[mentoring]: https://github.com/sktime/mentoring
[meetings]: https://calendar.google.com/calendar/u/0/embed?src=sktime.toolbox@gmail.com&ctz=UTC
[enhancement proposals]: https://github.com/sktime/enhancement-proposals
[roles]: https://www.sktime.net/en/latest/about/team.html

## :trophy: Hall of fame

Thanks to all our community for all your wonderful contributions, PRs, issues, ideas.

<a href="https://github.com/sktime/sktime/graphs/contributors">
<img src="https://opencollective.com/sktime/contributors.svg?width=600&button=false" />
</a>
<br>

## :bulb: Project vision

* **By the community, for the community** -- developed by a friendly and collaborative community.
* The **right tool for the right task** -- helping users to diagnose their learning problem and suitable scientific model types.
* **Embedded in state-of-art ecosystems** and **provider of interoperable interfaces** -- interoperable with [scikit-learn], [statsmodels], [tsfresh], and other community favorites.
* **Rich model composition and reduction functionality** -- build tuning and feature extraction pipelines, solve forecasting tasks with [scikit-learn] regressors.
* **Clean, descriptive specification syntax** -- based on modern object-oriented design principles for data science.
* **Fair model assessment and benchmarking** -- build your models, inspect your models, check your models, and avoid pitfalls.
* **Easily extensible** -- easy extension templates to add your own algorithms compatible with sktime's API.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "sktime",
    "maintainer": "Franz Kir\u00e1ly, Jonathan Bechtel, Kiril Ralinovski, Marc Rovira, Sagar Mishra, Ugochukwu Onyeka",
    "docs_url": null,
    "requires_python": "<3.13,>=3.8",
    "maintainer_email": "sktime developers <sktime.toolbox@gmail.com>",
    "keywords": "data-mining, data-science, forecasting, machine-learning, scikit-learn, time-series, time-series-analysis, time-series-classification, time-series-regression",
    "author": null,
    "author_email": "sktime developers <sktime.toolbox@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/48/72/a79b57e3ac562245d644deb6529eaecf84ff47f5ca582fa0c584f827e4b3/sktime-0.28.0.tar.gz",
    "platform": null,
    "description": "<a href=\"https://www.sktime.net\"><img src=\"https://github.com/sktime/sktime/blob/main/docs/source/images/sktime-logo.svg\" width=\"175\" align=\"right\" /></a>\n\n# Welcome to sktime\n\n> A unified interface for machine learning with time series\n\n:rocket: **Version 0.28.0 out now!** [Check out the release notes here](https://www.sktime.net/en/latest/changelog.html).\n\nsktime is a library for time series analysis in Python. It provides a unified interface for multiple time series learning tasks. Currently, this includes time series classification, regression, clustering, annotation, and forecasting. It comes with [time series algorithms](https://www.sktime.net/en/stable/estimator_overview.html) and [scikit-learn] compatible tools to build, tune and validate time series models.\n\n[scikit-learn]: https://scikit-learn.org/stable/\n\n| Overview | |\n|---|---|\n| **Open&#160;Source** | [![BSD 3-clause](https://img.shields.io/badge/License-BSD%203--Clause-blue.svg)](https://github.com/sktime/sktime/blob/main/LICENSE) |\n| **Tutorials** | [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/sktime/sktime/main?filepath=examples) [![!youtube](https://img.shields.io/static/v1?logo=youtube&label=YouTube&message=tutorials&color=red)](https://www.youtube.com/playlist?list=PLKs3UgGjlWHqNzu0LEOeLKvnjvvest2d0) |\n| **Community** | [![!discord](https://img.shields.io/static/v1?logo=discord&label=discord&message=chat&color=lightgreen)](https://discord.com/invite/54ACzaFsn7) [![!slack](https://img.shields.io/static/v1?logo=linkedin&label=LinkedIn&message=news&color=lightblue)](https://www.linkedin.com/company/scikit-time/)  |\n| **CI/CD** | [![github-actions](https://img.shields.io/github/actions/workflow/status/sktime/sktime/wheels.yml?logo=github)](https://github.com/sktime/sktime/actions/workflows/wheels.yml) [![!codecov](https://img.shields.io/codecov/c/github/sktime/sktime?label=codecov&logo=codecov)](https://codecov.io/gh/sktime/sktime) [![readthedocs](https://img.shields.io/readthedocs/sktime?logo=readthedocs)](https://www.sktime.net/en/latest/?badge=latest) [![platform](https://img.shields.io/conda/pn/conda-forge/sktime)](https://github.com/sktime/sktime) |\n| **Code** |  [![!pypi](https://img.shields.io/pypi/v/sktime?color=orange)](https://pypi.org/project/sktime/) [![!conda](https://img.shields.io/conda/vn/conda-forge/sktime)](https://anaconda.org/conda-forge/sktime) [![!python-versions](https://img.shields.io/pypi/pyversions/sktime)](https://www.python.org/) [![!black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)  |\n| **Downloads**| [![Downloads](https://static.pepy.tech/personalized-badge/sktime?period=week&units=international_system&left_color=grey&right_color=blue&left_text=weekly%20(pypi))](https://pepy.tech/project/sktime) [![Downloads](https://static.pepy.tech/personalized-badge/sktime?period=month&units=international_system&left_color=grey&right_color=blue&left_text=monthly%20(pypi))](https://pepy.tech/project/sktime) [![Downloads](https://static.pepy.tech/personalized-badge/sktime?period=total&units=international_system&left_color=grey&right_color=blue&left_text=cumulative%20(pypi))](https://pepy.tech/project/sktime) |\n| **Citation** | [![!zenodo](https://zenodo.org/badge/DOI/10.5281/zenodo.3749000.svg)](https://doi.org/10.5281/zenodo.3749000) |\n\n## :books: Documentation\n\n| Documentation              |                                                                |\n| -------------------------- | -------------------------------------------------------------- |\n| :star: **[Tutorials]**        | New to sktime? Here's everything you need to know!              |\n| :clipboard: **[Binder Notebooks]** | Example notebooks to play with in your browser.              |\n| :woman_technologist: **[User Guides]**      | How to use sktime and its features.                             |\n| :scissors: **[Extension Templates]** | How to build your own estimator using sktime's API.            |\n| :control_knobs: **[API Reference]**      | The detailed reference for sktime's API.                        |\n| :tv: **[Video Tutorial]**            | Our video tutorial from 2021 PyData Global.      |\n| :hammer_and_wrench: **[Changelog]**          | Changes and version history.                                   |\n| :deciduous_tree: **[Roadmap]**          | sktime's software and community development plan.                                   |\n| :pencil: **[Related Software]**          | A list of related software. |\n\n[tutorials]: https://www.sktime.net/en/latest/tutorials.html\n[binder notebooks]: https://mybinder.org/v2/gh/sktime/sktime/main?filepath=examples\n[user guides]: https://www.sktime.net/en/latest/user_guide.html\n[video tutorial]: https://github.com/sktime/sktime-tutorial-pydata-global-2021\n[api reference]: https://www.sktime.net/en/latest/api_reference.html\n[changelog]: https://www.sktime.net/en/latest/changelog.html\n[roadmap]: https://www.sktime.net/en/latest/roadmap.html\n[related software]: https://www.sktime.net/en/latest/related_software.html\n\n## :speech_balloon: Where to ask questions\n\nQuestions and feedback are extremely welcome! We strongly believe in the value of sharing help publicly, as it allows a wider audience to benefit from it.\n\n| Type                            | Platforms                               |\n| ------------------------------- | --------------------------------------- |\n| :bug: **Bug Reports**              | [GitHub Issue Tracker]                  |\n| :sparkles: **Feature Requests & Ideas** | [GitHub Issue Tracker]                       |\n| :woman_technologist: **Usage Questions**          | [GitHub Discussions] \u00b7 [Stack Overflow] |\n| :speech_balloon: **General Discussion**        | [GitHub Discussions] |\n| :factory: **Contribution & Development** | `dev-chat` channel \u00b7 [Discord] |\n| :globe_with_meridians: **Community collaboration session** | [Discord] - Fridays 3 pm UTC, dev/meet-ups channel |\n\n[github issue tracker]: https://github.com/sktime/sktime/issues\n[github discussions]: https://github.com/sktime/sktime/discussions\n[stack overflow]: https://stackoverflow.com/questions/tagged/sktime\n[discord]: https://discord.com/invite/54ACzaFsn7\n\n## :dizzy: Features\nOur objective is to enhance the interoperability and usability of the time series analysis ecosystem in its entirety. sktime provides a __unified interface for distinct but related time series learning tasks__. It features [__dedicated time series algorithms__](https://www.sktime.net/en/stable/estimator_overview.html) and __tools for composite model building__  such as pipelining, ensembling, tuning, and reduction, empowering users to apply an algorithm designed for one task to another.\n\nsktime also provides **interfaces to related libraries**, for example [scikit-learn], [statsmodels], [tsfresh], [PyOD], and [fbprophet], among others.\n\n[statsmodels]: https://www.statsmodels.org/stable/index.html\n[tsfresh]: https://tsfresh.readthedocs.io/en/latest/\n[pyod]: https://pyod.readthedocs.io/en/latest/\n[fbprophet]: https://facebook.github.io/prophet/\n\n| Module | Status | Links |\n|---|---|---|\n| **[Forecasting]** | stable | [Tutorial](https://www.sktime.net/en/latest/examples/01_forecasting.html) \u00b7 [API Reference](https://www.sktime.net/en/latest/api_reference/forecasting.html) \u00b7 [Extension Template](https://github.com/sktime/sktime/blob/main/extension_templates/forecasting.py)  |\n| **[Time Series Classification]** | stable | [Tutorial](https://github.com/sktime/sktime/blob/main/examples/02_classification.ipynb) \u00b7 [API Reference](https://www.sktime.net/en/latest/api_reference/classification.html) \u00b7 [Extension Template](https://github.com/sktime/sktime/blob/main/extension_templates/classification.py) |\n| **[Time Series Regression]** | stable | [API Reference](https://www.sktime.net/en/latest/api_reference/regression.html) |\n| **[Transformations]** | stable | [Tutorial](https://github.com/sktime/sktime/blob/main/examples/03_transformers.ipynb) \u00b7 [API Reference](https://www.sktime.net/en/latest/api_reference/transformations.html) \u00b7 [Extension Template](https://github.com/sktime/sktime/blob/main/extension_templates/transformer.py)  |\n| **[Parameter fitting]** | maturing | [API Reference](https://www.sktime.net/en/latest/api_reference/param_est.html) \u00b7 [Extension Template](https://github.com/sktime/sktime/blob/main/extension_templates/transformer.py)  |\n| **[Time Series Clustering]** | maturing | [API Reference](https://www.sktime.net/en/latest/api_reference/clustering.html) \u00b7  [Extension Template](https://github.com/sktime/sktime/blob/main/extension_templates/clustering.py) |\n| **[Time Series Distances/Kernels]** | maturing | [Tutorial](https://github.com/sktime/sktime/blob/main/examples/03_transformers.ipynb) \u00b7 [API Reference](https://www.sktime.net/en/latest/api_reference/dists_kernels.html) \u00b7 [Extension Template](https://github.com/sktime/sktime/blob/main/extension_templates/dist_kern_panel.py) |\n| **[Time Series Alignment]** | experimental | [API Reference](https://www.sktime.net/en/latest/api_reference/alignment.html) \u00b7 [Extension Template](https://github.com/sktime/sktime/blob/main/extension_templates/alignment.py) |\n| **[Annotation]** | experimental | [Extension Template](https://github.com/sktime/sktime/blob/main/extension_templates/annotation.py) |\n| **[Time Series Splitters]** | maturing | [Extension Template](https://github.com/sktime/sktime/blob/main/extension_templates/split.py) | |\n| **[Distributions and simulation]** | experimental |  |\n\n[forecasting]: https://github.com/sktime/sktime/tree/main/sktime/forecasting\n[time series classification]: https://github.com/sktime/sktime/tree/main/sktime/classification\n[time series regression]: https://github.com/sktime/sktime/tree/main/sktime/regression\n[time series clustering]: https://github.com/sktime/sktime/tree/main/sktime/clustering\n[annotation]: https://github.com/sktime/sktime/tree/main/sktime/annotation\n[time series distances/kernels]: https://github.com/sktime/sktime/tree/main/sktime/dists_kernels\n[time series alignment]: https://github.com/sktime/sktime/tree/main/sktime/alignment\n[transformations]: https://github.com/sktime/sktime/tree/main/sktime/transformations\n[distributions and simulation]: https://github.com/sktime/sktime/tree/main/sktime/proba\n[time series splitters]: https://github.com/sktime/sktime/tree/main/sktime/split\n[parameter fitting]: https://github.com/sktime/sktime/tree/main/sktime/param_est\n\n\n## :hourglass_flowing_sand: Install sktime\nFor troubleshooting and detailed installation instructions, see the [documentation](https://www.sktime.net/en/latest/installation.html).\n\n- **Operating system**: macOS X \u00b7 Linux \u00b7 Windows 8.1 or higher\n- **Python version**: Python 3.8, 3.9, 3.10, 3.11, and 3.12 (only 64-bit)\n- **Package managers**: [pip] \u00b7 [conda] (via `conda-forge`)\n\n[pip]: https://pip.pypa.io/en/stable/\n[conda]: https://docs.conda.io/en/latest/\n\n### pip\nUsing pip, sktime releases are available as source packages and binary wheels.\nAvailable wheels are listed [here](https://pypi.org/simple/sktime/).\n\n```bash\npip install sktime\n```\n\nor, with maximum dependencies,\n\n```bash\npip install sktime[all_extras]\n```\n\nFor curated sets of soft dependencies for specific learning tasks:\n\n```bash\npip install sktime[forecasting]  # for selected forecasting dependencies\npip install sktime[forecasting,transformations]  # forecasters and transformers\n```\n\nor similar. Valid sets are:\n\n* `forecasting`\n* `transformations`\n* `classification`\n* `regression`\n* `clustering`\n* `param_est`\n* `networks`\n* `annotation`\n* `alignment`\n\nCave: in general, not all soft dependencies for a learning task are installed,\nonly a curated selection.\n\n### conda\nYou can also install sktime from `conda` via the `conda-forge` channel.\nThe feedstock including the build recipe and configuration is maintained\nin [this conda-forge repository](https://github.com/conda-forge/sktime-feedstock).\n\n```bash\nconda install -c conda-forge sktime\n```\n\nor, with maximum dependencies,\n\n```bash\nconda install -c conda-forge sktime-all-extras\n```\n\n(as `conda` does not support dependency sets,\nflexible choice of soft dependencies is unavailable via `conda`)\n\n## :zap: Quickstart\n\n### Forecasting\n\n``` python\nfrom sktime.datasets import load_airline\nfrom sktime.forecasting.base import ForecastingHorizon\nfrom sktime.forecasting.theta import ThetaForecaster\nfrom sktime.split import temporal_train_test_split\nfrom sktime.performance_metrics.forecasting import mean_absolute_percentage_error\n\ny = load_airline()\ny_train, y_test = temporal_train_test_split(y)\nfh = ForecastingHorizon(y_test.index, is_relative=False)\nforecaster = ThetaForecaster(sp=12)  # monthly seasonal periodicity\nforecaster.fit(y_train)\ny_pred = forecaster.predict(fh)\nmean_absolute_percentage_error(y_test, y_pred)\n>>> 0.08661467738190656\n```\n\n### Time Series Classification\n\n```python\nfrom sktime.classification.interval_based import TimeSeriesForestClassifier\nfrom sktime.datasets import load_arrow_head\nfrom sklearn.model_selection import train_test_split\nfrom sklearn.metrics import accuracy_score\n\nX, y = load_arrow_head()\nX_train, X_test, y_train, y_test = train_test_split(X, y)\nclassifier = TimeSeriesForestClassifier()\nclassifier.fit(X_train, y_train)\ny_pred = classifier.predict(X_test)\naccuracy_score(y_test, y_pred)\n>>> 0.8679245283018868\n```\n\n## :wave: How to get involved\n\nThere are many ways to join the sktime community. We follow the [all-contributors](https://github.com/all-contributors/all-contributors) specification: all kinds of contributions are welcome - not just code.\n\n| Documentation              |                                                                |\n| -------------------------- | --------------------------------------------------------------        |\n| :gift_heart: **[Contribute]**        | How to contribute to sktime.          |\n| :school_satchel:  **[Mentoring]** | New to open source? Apply to our mentoring program! |\n| :date: **[Meetings]** | Join our discussions, tutorials, workshops, and sprints! |\n| :woman_mechanic:  **[Developer Guides]**      | How to further develop sktime's code base.                             |\n| :construction: **[Enhancement Proposals]** | Design a new feature for sktime. |\n| :medal_sports: **[Contributors]** | A list of all contributors. |\n| :raising_hand: **[Roles]** | An overview of our core community roles. |\n| :money_with_wings: **[Donate]** | Fund sktime maintenance and development. |\n| :classical_building: **[Governance]** | How and by whom decisions are made in sktime's community.   |\n\n[contribute]: https://www.sktime.net/en/latest/get_involved/contributing.html\n[donate]: https://opencollective.com/sktime\n[extension templates]: https://github.com/sktime/sktime/tree/main/extension_templates\n[developer guides]: https://www.sktime.net/en/latest/developer_guide.html\n[contributors]: https://github.com/sktime/sktime/blob/main/CONTRIBUTORS.md\n[governance]: https://www.sktime.net/en/latest/get_involved/governance.html\n[mentoring]: https://github.com/sktime/mentoring\n[meetings]: https://calendar.google.com/calendar/u/0/embed?src=sktime.toolbox@gmail.com&ctz=UTC\n[enhancement proposals]: https://github.com/sktime/enhancement-proposals\n[roles]: https://www.sktime.net/en/latest/about/team.html\n\n## :trophy: Hall of fame\n\nThanks to all our community for all your wonderful contributions, PRs, issues, ideas.\n\n<a href=\"https://github.com/sktime/sktime/graphs/contributors\">\n<img src=\"https://opencollective.com/sktime/contributors.svg?width=600&button=false\" />\n</a>\n<br>\n\n## :bulb: Project vision\n\n* **By the community, for the community** -- developed by a friendly and collaborative community.\n* The **right tool for the right task** -- helping users to diagnose their learning problem and suitable scientific model types.\n* **Embedded in state-of-art ecosystems** and **provider of interoperable interfaces** -- interoperable with [scikit-learn], [statsmodels], [tsfresh], and other community favorites.\n* **Rich model composition and reduction functionality** -- build tuning and feature extraction pipelines, solve forecasting tasks with [scikit-learn] regressors.\n* **Clean, descriptive specification syntax** -- based on modern object-oriented design principles for data science.\n* **Fair model assessment and benchmarking** -- build your models, inspect your models, check your models, and avoid pitfalls.\n* **Easily extensible** -- easy extension templates to add your own algorithms compatible with sktime's API.\n",
    "bugtrack_url": null,
    "license": "BSD 3-Clause License  Copyright (c) 2019 - present, The sktime developers.  All rights reserved.  Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:  * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.  * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.  * Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. ",
    "summary": "A unified framework for machine learning with time series",
    "version": "0.28.0",
    "project_urls": {
        "API Reference": "https://www.sktime.net/en/stable/api_reference.html",
        "Documentation": "https://www.sktime.net",
        "Download": "https://pypi.org/project/sktime/#files",
        "Homepage": "https://www.sktime.net",
        "Release Notes": "https://www.sktime.net/en/stable/changelog.html",
        "Repository": "https://github.com/sktime/sktime"
    },
    "split_keywords": [
        "data-mining",
        " data-science",
        " forecasting",
        " machine-learning",
        " scikit-learn",
        " time-series",
        " time-series-analysis",
        " time-series-classification",
        " time-series-regression"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "646a0ce9eff555b71db275b54c356b4952021fa13c91e355b74997693c9b2b76",
                "md5": "07e7c2331755d26784b78142b3f2f185",
                "sha256": "35e53e3abda364cf46e0dd1d7bd4438b49b5d99b0c432978500ac394afe302fc"
            },
            "downloads": -1,
            "filename": "sktime-0.28.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "07e7c2331755d26784b78142b3f2f185",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<3.13,>=3.8",
            "size": 21924123,
            "upload_time": "2024-03-28T01:36:35",
            "upload_time_iso_8601": "2024-03-28T01:36:35.710029Z",
            "url": "https://files.pythonhosted.org/packages/64/6a/0ce9eff555b71db275b54c356b4952021fa13c91e355b74997693c9b2b76/sktime-0.28.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "4872a79b57e3ac562245d644deb6529eaecf84ff47f5ca582fa0c584f827e4b3",
                "md5": "be5518df0236084dbd28d106cbdc4260",
                "sha256": "ee24781352617479b1498ec3255205e6a1c76ebee91f13ee2dbcb28cfadcdd4d"
            },
            "downloads": -1,
            "filename": "sktime-0.28.0.tar.gz",
            "has_sig": false,
            "md5_digest": "be5518df0236084dbd28d106cbdc4260",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<3.13,>=3.8",
            "size": 21142220,
            "upload_time": "2024-03-28T01:36:39",
            "upload_time_iso_8601": "2024-03-28T01:36:39.944311Z",
            "url": "https://files.pythonhosted.org/packages/48/72/a79b57e3ac562245d644deb6529eaecf84ff47f5ca582fa0c584f827e4b3/sktime-0.28.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-03-28 01:36:39",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "sktime",
    "github_project": "sktime",
    "travis_ci": false,
    "coveralls": true,
    "github_actions": true,
    "lcname": "sktime"
}
        
Elapsed time: 0.23980s