| Name | tpk JSON |
| Version |
0.0.1.dev0
JSON |
| download |
| home_page | |
| Summary | TempportalPredictionsKit: toolset for timeseries data predictions |
| upload_time | 2023-12-13 15:33:26 |
| maintainer | |
| docs_url | None |
| author | |
| requires_python | >=3.8 |
| license | |
| keywords |
machine learning
timeseries
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# tpk (Temporal Predictions Kit)
A collection of tools, models and functionalities for hanling timeseries datasets
<!-- <img class="hide-on-website" height="100px" src="https://ts.gluon.ai/dev/_static/gluonts.svg"> -->
<!-- # GluonTS - Probabilistic Time Series Modeling in Python -->
<p align="center">
<a href="https://github.com/airtai/tpk/actions/workflows/test.yaml" target="_blank">
<img src="https://github.com/airtai/tpk/actions/workflows/test.yaml/badge.svg?branch=main" alt="Test Passing"/>
</a>
<a href="https://coverage-badge.samuelcolvin.workers.dev/redirect/airtai/tpk" target="_blank">
<img src="https://coverage-badge.samuelcolvin.workers.dev/airtai/tpk.svg" alt="Coverage">
</a>
<a href="https://www.pepy.tech/projects/tpk" target="_blank">
<img src="https://static.pepy.tech/personalized-badge/tpk?period=month&units=international_system&left_color=grey&right_color=green&left_text=downloads/month" alt="Downloads"/>
</a>
<a href="https://pypi.org/project/tpk" target="_blank">
<img src="https://img.shields.io/pypi/v/tpk?label=PyPI" alt="Package version">
</a>
<a href="https://pypi.org/project/tpk" target="_blank">
<img src="https://img.shields.io/pypi/pyversions/tpk.svg" alt="Supported Python versions">
</a>
<br/>
<a href="https://github.com/airtai/tpk/actions/workflows/codeql.yml" target="_blank">
<img src="https://github.com/airtai/tpk/actions/workflows/codeql.yml/badge.svg" alt="CodeQL">
</a>
<a href="https://github.com/airtai/tpk/actions/workflows/dependency-review.yaml" target="_blank">
<img src="https://github.com/airtai/tpk/actions/workflows/dependency-review.yaml/badge.svg" alt="Dependency Review">
</a>
<a href="https://github.com/airtai/tpk/blob/main/LICENSE" target="_blank">
<img src="https://img.shields.io/github/license/airtai/tpk.png" alt="License">
</a>
<a href="https://github.com/airtai/tpk/blob/main/CODE_OF_CONDUCT.md" target="_blank">
<img src="https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg" alt="Code of Conduct">
</a>
<a href="https://discord.gg/qFm6aSqq59" target="_blank">
<img alt="Discord" src="https://img.shields.io/discord/1085457301214855171?logo=discord">
</a>
</p>
<!-- GluonTS is a Python package for probabilistic time series modeling, focusing on deep learning based models,
based on [PyTorch](https://pytorch.org) and [MXNet](https://mxnet.apache.org). -->
## Installation
**tpk** requires Python 3.7 or newer, and the easiest way to install it is via
`pip`:
```bash
pip install tpk"
```
<!-- See the [documentation](https://ts.gluon.ai/stable/getting_started/install.html)
for more info on how GluonTS can be installed. -->
## Simple Example
To illustrate how to use tpk, we train a model and make predictions
using the airpassengers dataset. The dataset consists of a single time
series of monthly passenger numbers between 1949 and 1960. We train the model
on the first nine years and make predictions for the remaining three years.
```py
import pandas as pd
import matplotlib.pyplot as plt
from gluonts.dataset.pandas import PandasDataset
from gluonts.dataset.split import split
from gluonts.torch import DeepAREstimator
from tpk.torch import TPKEstimator
# Load data from a CSV file into a PandasDataset
df = pd.read_csv(
"https://raw.githubusercontent.com/AileenNielsen/"
"TimeSeriesAnalysisWithPython/master/data/AirPassengers.csv",
index_col=0,
parse_dates=True,
)
dataset = PandasDataset(df, target="#Passengers")
# Split the data for training and testing
training_data, test_gen = split(dataset, offset=-36)
test_data = test_gen.generate_instances(prediction_length=12, windows=3)
# Train the model and make predictions
model = TPKEstimator(
prediction_length=12, freq="M", trainer_kwargs={"max_epochs": 5}
).train(training_data)
forecasts = list(model.predict(test_data.input))
# Plot predictions
plt.plot(df["1954":], color="black")
for forecast in forecasts:
forecast.plot()
plt.legend(["True values"], loc="upper left", fontsize="xx-large")
plt.show()
```
##### todo: replace me
![[train-test]](https://ts.gluon.ai/static/README/forecasts.png)
Note, the forecasts are displayed in terms of a probability distribution and
the shaded areas represent the 50% and 90% prediction intervals.
## Contributing
If you wish to contribute to the project, please refer to our
[contribution guidelines](https://github.com/airt/tpk/tree/dev/CONTRIBUTING.md).
## Citing
If you use tpk in a scientific publication, we encourage you to add the following references to the related papers,
in addition to any model-specific references that are relevant for your work:
<!-- ```bibtex
@article{gluonts_jmlr,
author = {Alexander Alexandrov and Konstantinos Benidis and Michael Bohlke-Schneider
and Valentin Flunkert and Jan Gasthaus and Tim Januschowski and Danielle C. Maddix
and Syama Rangapuram and David Salinas and Jasper Schulz and Lorenzo Stella and
Ali Caner Türkmen and Yuyang Wang},
title = {{GluonTS: Probabilistic and Neural Time Series Modeling in Python}},
journal = {Journal of Machine Learning Research},
year = {2020},
volume = {21},
number = {116},
pages = {1-6},
url = {http://jmlr.org/papers/v21/19-820.html}
}
```
```bibtex
@article{gluonts_arxiv,
author = {Alexandrov, A. and Benidis, K. and Bohlke-Schneider, M. and
Flunkert, V. and Gasthaus, J. and Januschowski, T. and Maddix, D. C.
and Rangapuram, S. and Salinas, D. and Schulz, J. and Stella, L. and
Türkmen, A. C. and Wang, Y.},
title = {{GluonTS: Probabilistic Time Series Modeling in Python}},
journal = {arXiv preprint arXiv:1906.05264},
year = {2019}
}
``` -->
## Links
### Documentation
* [Documentation](https://tpk.airt.ai/)
<!-- ### References
* [JMLR MLOSS Paper](http://www.jmlr.org/papers/v21/19-820.html)
* [ArXiv Paper](https://arxiv.org/abs/1906.05264)
* [Collected Papers from the group behind GluonTS](https://github.com/awslabs/gluonts/tree/dev/REFERENCES.md): a bibliography. -->
<!-- ### Tutorials and Workshops
* [Tutorial at IJCAI 2021 (with videos)](https://lovvge.github.io/Forecasting-Tutorial-IJCAI-2021/) with [YouTube link](https://youtu.be/AB3I9pdT46c).
* [Tutorial at WWW 2020 (with videos)](https://lovvge.github.io/Forecasting-Tutorial-WWW-2020/)
* [Tutorial at SIGMOD 2019](https://lovvge.github.io/Forecasting-Tutorials/SIGMOD-2019/)
* [Tutorial at KDD 2019](https://lovvge.github.io/Forecasting-Tutorial-KDD-2019/)
* [Tutorial at VLDB 2018](https://lovvge.github.io/Forecasting-Tutorial-VLDB-2018/)
* [Neural Time Series with GluonTS](https://youtu.be/beEJMIt9xJ8)
* [International Symposium of Forecasting: Deep Learning for Forecasting workshop](https://lostella.github.io/ISF-2020-Deep-Learning-Workshop/) -->
## Stay in touch
Please show your support and stay in touch by:
- giving our [GitHub repository](https://github.com/airtai/tpk/){.external-link target="_blank"} a star, and
- joining our [Discord server](https://discord.gg/qFm6aSqq59){.external-link target="_blank"}
Your support helps us to stay in touch with you and encourages us to
continue developing and improving the framework. Thank you for your
support!
---
## Contributors
Thanks to all of these amazing people who made the project better!
<a href="https://github.com/airtai/tpk/graphs/contributors">
<img src="https://contrib.rocks/image?repo=airtai/tpk"/>
</a>
Raw data
{
"_id": null,
"home_page": "",
"name": "tpk",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "machine learning,timeseries",
"author": "",
"author_email": "airt <info@airt.ai>",
"download_url": "https://files.pythonhosted.org/packages/53/13/0fcc4375f72eb4292439fdf3a919deedb5f3797079e9ec8c7a9747991b4b/tpk-0.0.1.dev0.tar.gz",
"platform": null,
"description": "# tpk (Temporal Predictions Kit)\n\nA collection of tools, models and functionalities for hanling timeseries datasets\n\n\n\n<!-- <img class=\"hide-on-website\" height=\"100px\" src=\"https://ts.gluon.ai/dev/_static/gluonts.svg\"> -->\n\n<!-- # GluonTS - Probabilistic Time Series Modeling in Python -->\n\n<p align=\"center\">\n <a href=\"https://github.com/airtai/tpk/actions/workflows/test.yaml\" target=\"_blank\">\n <img src=\"https://github.com/airtai/tpk/actions/workflows/test.yaml/badge.svg?branch=main\" alt=\"Test Passing\"/>\n </a>\n\n <a href=\"https://coverage-badge.samuelcolvin.workers.dev/redirect/airtai/tpk\" target=\"_blank\">\n <img src=\"https://coverage-badge.samuelcolvin.workers.dev/airtai/tpk.svg\" alt=\"Coverage\">\n </a>\n\n <a href=\"https://www.pepy.tech/projects/tpk\" target=\"_blank\">\n <img src=\"https://static.pepy.tech/personalized-badge/tpk?period=month&units=international_system&left_color=grey&right_color=green&left_text=downloads/month\" alt=\"Downloads\"/>\n </a>\n\n <a href=\"https://pypi.org/project/tpk\" target=\"_blank\">\n <img src=\"https://img.shields.io/pypi/v/tpk?label=PyPI\" alt=\"Package version\">\n </a>\n\n <a href=\"https://pypi.org/project/tpk\" target=\"_blank\">\n <img src=\"https://img.shields.io/pypi/pyversions/tpk.svg\" alt=\"Supported Python versions\">\n </a>\n\n <br/>\n\n <a href=\"https://github.com/airtai/tpk/actions/workflows/codeql.yml\" target=\"_blank\">\n <img src=\"https://github.com/airtai/tpk/actions/workflows/codeql.yml/badge.svg\" alt=\"CodeQL\">\n </a>\n\n <a href=\"https://github.com/airtai/tpk/actions/workflows/dependency-review.yaml\" target=\"_blank\">\n <img src=\"https://github.com/airtai/tpk/actions/workflows/dependency-review.yaml/badge.svg\" alt=\"Dependency Review\">\n </a>\n\n <a href=\"https://github.com/airtai/tpk/blob/main/LICENSE\" target=\"_blank\">\n <img src=\"https://img.shields.io/github/license/airtai/tpk.png\" alt=\"License\">\n </a>\n\n <a href=\"https://github.com/airtai/tpk/blob/main/CODE_OF_CONDUCT.md\" target=\"_blank\">\n <img src=\"https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg\" alt=\"Code of Conduct\">\n </a>\n\n <a href=\"https://discord.gg/qFm6aSqq59\" target=\"_blank\">\n <img alt=\"Discord\" src=\"https://img.shields.io/discord/1085457301214855171?logo=discord\">\n </a>\n</p>\n\n\n<!-- GluonTS is a Python package for probabilistic time series modeling, focusing on deep learning based models,\nbased on [PyTorch](https://pytorch.org) and [MXNet](https://mxnet.apache.org). -->\n\n\n## Installation\n\n**tpk** requires Python 3.7 or newer, and the easiest way to install it is via\n`pip`:\n\n```bash\npip install tpk\"\n```\n\n<!-- See the [documentation](https://ts.gluon.ai/stable/getting_started/install.html)\nfor more info on how GluonTS can be installed. -->\n\n## Simple Example\n\nTo illustrate how to use tpk, we train a model and make predictions\nusing the airpassengers dataset. The dataset consists of a single time\nseries of monthly passenger numbers between 1949 and 1960. We train the model\non the first nine years and make predictions for the remaining three years.\n\n```py\nimport pandas as pd\nimport matplotlib.pyplot as plt\n\nfrom gluonts.dataset.pandas import PandasDataset\nfrom gluonts.dataset.split import split\nfrom gluonts.torch import DeepAREstimator\nfrom tpk.torch import TPKEstimator\n\n# Load data from a CSV file into a PandasDataset\ndf = pd.read_csv(\n \"https://raw.githubusercontent.com/AileenNielsen/\"\n \"TimeSeriesAnalysisWithPython/master/data/AirPassengers.csv\",\n index_col=0,\n parse_dates=True,\n)\ndataset = PandasDataset(df, target=\"#Passengers\")\n\n# Split the data for training and testing\ntraining_data, test_gen = split(dataset, offset=-36)\ntest_data = test_gen.generate_instances(prediction_length=12, windows=3)\n\n# Train the model and make predictions\nmodel = TPKEstimator(\n prediction_length=12, freq=\"M\", trainer_kwargs={\"max_epochs\": 5}\n).train(training_data)\n\nforecasts = list(model.predict(test_data.input))\n\n# Plot predictions\nplt.plot(df[\"1954\":], color=\"black\")\nfor forecast in forecasts:\n forecast.plot()\nplt.legend([\"True values\"], loc=\"upper left\", fontsize=\"xx-large\")\nplt.show()\n```\n\n##### todo: replace me\n![[train-test]](https://ts.gluon.ai/static/README/forecasts.png)\n\nNote, the forecasts are displayed in terms of a probability distribution and\nthe shaded areas represent the 50% and 90% prediction intervals.\n\n\n## Contributing\n\nIf you wish to contribute to the project, please refer to our\n[contribution guidelines](https://github.com/airt/tpk/tree/dev/CONTRIBUTING.md).\n\n## Citing\n\nIf you use tpk in a scientific publication, we encourage you to add the following references to the related papers,\nin addition to any model-specific references that are relevant for your work:\n\n<!-- ```bibtex\n@article{gluonts_jmlr,\n author = {Alexander Alexandrov and Konstantinos Benidis and Michael Bohlke-Schneider\n and Valentin Flunkert and Jan Gasthaus and Tim Januschowski and Danielle C. Maddix\n and Syama Rangapuram and David Salinas and Jasper Schulz and Lorenzo Stella and\n Ali Caner T\u00fcrkmen and Yuyang Wang},\n title = {{GluonTS: Probabilistic and Neural Time Series Modeling in Python}},\n journal = {Journal of Machine Learning Research},\n year = {2020},\n volume = {21},\n number = {116},\n pages = {1-6},\n url = {http://jmlr.org/papers/v21/19-820.html}\n}\n```\n\n```bibtex\n@article{gluonts_arxiv,\n author = {Alexandrov, A. and Benidis, K. and Bohlke-Schneider, M. and\n Flunkert, V. and Gasthaus, J. and Januschowski, T. and Maddix, D. C.\n and Rangapuram, S. and Salinas, D. and Schulz, J. and Stella, L. and\n T\u00fcrkmen, A. C. and Wang, Y.},\n title = {{GluonTS: Probabilistic Time Series Modeling in Python}},\n journal = {arXiv preprint arXiv:1906.05264},\n year = {2019}\n}\n``` -->\n\n## Links\n\n### Documentation\n\n* [Documentation](https://tpk.airt.ai/)\n\n<!-- ### References\n\n* [JMLR MLOSS Paper](http://www.jmlr.org/papers/v21/19-820.html)\n* [ArXiv Paper](https://arxiv.org/abs/1906.05264)\n* [Collected Papers from the group behind GluonTS](https://github.com/awslabs/gluonts/tree/dev/REFERENCES.md): a bibliography. -->\n\n<!-- ### Tutorials and Workshops\n\n* [Tutorial at IJCAI 2021 (with videos)](https://lovvge.github.io/Forecasting-Tutorial-IJCAI-2021/) with [YouTube link](https://youtu.be/AB3I9pdT46c).\n* [Tutorial at WWW 2020 (with videos)](https://lovvge.github.io/Forecasting-Tutorial-WWW-2020/)\n* [Tutorial at SIGMOD 2019](https://lovvge.github.io/Forecasting-Tutorials/SIGMOD-2019/)\n* [Tutorial at KDD 2019](https://lovvge.github.io/Forecasting-Tutorial-KDD-2019/)\n* [Tutorial at VLDB 2018](https://lovvge.github.io/Forecasting-Tutorial-VLDB-2018/)\n* [Neural Time Series with GluonTS](https://youtu.be/beEJMIt9xJ8)\n* [International Symposium of Forecasting: Deep Learning for Forecasting workshop](https://lostella.github.io/ISF-2020-Deep-Learning-Workshop/) -->\n\n## Stay in touch\n\nPlease show your support and stay in touch by:\n\n- giving our [GitHub repository](https://github.com/airtai/tpk/){.external-link target=\"_blank\"} a star, and\n\n- joining our [Discord server](https://discord.gg/qFm6aSqq59){.external-link target=\"_blank\"}\n\nYour support helps us to stay in touch with you and encourages us to\ncontinue developing and improving the framework. Thank you for your\nsupport!\n\n---\n\n## Contributors\n\nThanks to all of these amazing people who made the project better!\n\n<a href=\"https://github.com/airtai/tpk/graphs/contributors\">\n <img src=\"https://contrib.rocks/image?repo=airtai/tpk\"/>\n</a>\n",
"bugtrack_url": null,
"license": "",
"summary": "TempportalPredictionsKit: toolset for timeseries data predictions",
"version": "0.0.1.dev0",
"project_urls": {
"Documentation": "https://tpk.airt.ai/latest/getting-started/",
"Homepage": "https://tpk.airt.ai/",
"Source": "https://github.com/airtai/tpk",
"Tracker": "https://github.com/airtai/tpk/issues"
},
"split_keywords": [
"machine learning",
"timeseries"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f1dcce61a77b4349109e1c5235204462bc1efab20f38d169e412f198c24e6725",
"md5": "ac5b7584032fa650c230b197480df491",
"sha256": "41d7965c5be40b3b6a7c09459f4fc73aa40c2352bb28d291a64e2deabf88e72f"
},
"downloads": -1,
"filename": "tpk-0.0.1.dev0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ac5b7584032fa650c230b197480df491",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 30717,
"upload_time": "2023-12-13T15:33:24",
"upload_time_iso_8601": "2023-12-13T15:33:24.467284Z",
"url": "https://files.pythonhosted.org/packages/f1/dc/ce61a77b4349109e1c5235204462bc1efab20f38d169e412f198c24e6725/tpk-0.0.1.dev0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "53130fcc4375f72eb4292439fdf3a919deedb5f3797079e9ec8c7a9747991b4b",
"md5": "190528a260952fbb66f1f7c4224fedd5",
"sha256": "e764a5621aec0119ce87b4c451cc05472da07ad3802873c35e677459047cba29"
},
"downloads": -1,
"filename": "tpk-0.0.1.dev0.tar.gz",
"has_sig": false,
"md5_digest": "190528a260952fbb66f1f7c4224fedd5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 32624,
"upload_time": "2023-12-13T15:33:26",
"upload_time_iso_8601": "2023-12-13T15:33:26.417936Z",
"url": "https://files.pythonhosted.org/packages/53/13/0fcc4375f72eb4292439fdf3a919deedb5f3797079e9ec8c7a9747991b4b/tpk-0.0.1.dev0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-13 15:33:26",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "airtai",
"github_project": "tpk",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "tpk"
}
