<div align="center">
<br><br>
<img alt="Torch Spatiotemporal" src="https://raw.githubusercontent.com/TorchSpatiotemporal/tsl/main/docs/source/_static/img/tsl_logo_text.svg" width="85%"/>
<h3>Neural spatiotemporal forecasting with PyTorch</h3>
<hr>
<p>
<a href='https://pypi.org/project/torch-spatiotemporal/'>
<img alt="PyPI" src="https://img.shields.io/pypi/v/torch-spatiotemporal">
</a>
<img alt="PyPI - Python Version" src="https://img.shields.io/badge/python-%3E%3D3.8-blue">
<!-- img alt="PyPI - Python Version" src="https://img.shields.io/pypi/pyversions/torch-spatiotemporal" -->
<img alt="Total downloads" src="https://static.pepy.tech/badge/torch-spatiotemporal">
<a href='https://torch-spatiotemporal.readthedocs.io/en/latest/?badge=latest'>
<img src='https://readthedocs.org/projects/torch-spatiotemporal/badge/?version=latest' alt='Documentation Status' />
</a>
</p>
<p>
🚀 <a href="https://torch-spatiotemporal.readthedocs.io/en/latest/usage/quickstart.html">Getting Started</a> - 📚 <a href="https://torch-spatiotemporal.readthedocs.io/en/latest/">Documentation</a> - 💻 <a href="https://torch-spatiotemporal.readthedocs.io/en/latest/notebooks/a_gentle_introduction_to_tsl.html">Introductory notebook</a>
</p>
</div>
<p><img src="https://raw.githubusercontent.com/TorchSpatiotemporal/tsl/main/docs/source/_static/img/tsl_logo.svg" width="25px" align="center"/> <b>tsl</b> <em>(Torch Spatiotemporal)</em> is a library built to accelerate research on neural spatiotemporal data processing
methods, with a focus on Graph Neural Networks.</p>
<p><img src="https://raw.githubusercontent.com/TorchSpatiotemporal/tsl/main/docs/source/_static/img/tsl_logo.svg" width="25px" align="center"/> tsl is built on several libraries of the <b>Python</b> scientific computing ecosystem, with the final objective of providing a straightforward process that goes from data preprocessing to model prototyping.
In particular, <img src="https://raw.githubusercontent.com/TorchSpatiotemporal/tsl/main/docs/source/_static/img/tsl_logo.svg" width="25px" align="center"/> tsl offers a wide range of utilities to develop neural networks in <img src="https://raw.githubusercontent.com/TorchSpatiotemporal/tsl/main/docs/source/_static/img/logos/pytorch.svg" width="20px" align="center"/> <a href="https://pytorch.org"><b>PyTorch</b></a> for processing spatiotemporal data signals.</p>
## Getting Started
Before you start using <img src="https://raw.githubusercontent.com/TorchSpatiotemporal/tsl/main/docs/source/_static/img/tsl_logo.svg" width="25px" align="center"/> tsl, please review the <a href="https://torch-spatiotemporal.readthedocs.io/en/latest/">documentation</a> to get an understanding of the library and its capabilities.
You can also explore the examples provided in the `examples` directory to see how train deep learning models working with spatiotemporal data.
## Installation
Before installing <img src="https://raw.githubusercontent.com/TorchSpatiotemporal/tsl/main/docs/source/_static/img/tsl_logo.svg" width="25px" align="center"/> tsl, make sure you have installed <img src="https://raw.githubusercontent.com/TorchSpatiotemporal/tsl/main/docs/source/_static/img/logos/pytorch.svg" width="20px" align="center"/> <a href="https://pytorch.org">PyTorch</a> (>=1.9.0) and <img src="https://raw.githubusercontent.com/TorchSpatiotemporal/tsl/main/docs/source/_static/img/logos/pyg.svg" width="20px" align="center"/> <a href="https://pyg.org">PyG</a> (>=2.0.3) in your virtual environment (see [PyG installation guidelines](https://pytorch-geometric.readthedocs.io/en/latest/install/installation.html)). <img src="https://raw.githubusercontent.com/TorchSpatiotemporal/tsl/main/docs/source/_static/img/tsl_logo.svg" width="25px" align="center"/> tsl is available for Python>=3.8. We recommend installation from github to be up-to-date with the latest version:
```bash
pip install git+https://github.com/TorchSpatiotemporal/tsl.git
```
Alternatively, you can install the library from the pypi repository:
```bash
pip install torch-spatiotemporal
```
To avoid dependencies issues, we recommend using [Anaconda](https://www.anaconda.com/) and the provided environment configuration by running the command:
```bash
conda env create -f conda_env.yml
```
## Tutorial
The best way to start using <img src="https://raw.githubusercontent.com/TorchSpatiotemporal/tsl/main/docs/source/_static/img/tsl_logo.svg" width="25px" align="center"/> tsl is by following the tutorial notebook in `examples/notebooks/a_gentle_introduction_to_tsl.ipynb`.
## Documentation
The documentation is hosted on [readthedocs](https://torch-spatiotemporal.readthedocs.io/en/latest/). For local access, you can build it from the `docs` directory.
## Citing
If you use Torch Spatiotemporal for your research, please consider citing the library
```latex
@software{Cini_Torch_Spatiotemporal_2022,
author = {Cini, Andrea and Marisca, Ivan},
license = {MIT},
month = {3},
title = {{Torch Spatiotemporal}},
url = {https://github.com/TorchSpatiotemporal/tsl},
year = {2022}
}
```
By [Andrea Cini](https://andreacini.github.io/) and [Ivan Marisca](https://marshka.github.io/).
Thanks to all contributors! Check the [Contributing guidelines](https://github.com/TorchSpatiotemporal/tsl/blob/dev/.github/CONTRIBUTING.md) and help us build a better <img src="https://raw.githubusercontent.com/TorchSpatiotemporal/tsl/main/docs/source/_static/img/tsl_logo.svg" width="25px" align="center"/> tsl.
<a href="https://github.com/TorchSpatiotemporal/tsl/graphs/contributors">
<img src="https://contrib.rocks/image?repo=TorchSpatiotemporal/tsl" />
</a>
Raw data
{
"_id": null,
"home_page": "https://github.com/TorchSpatiotemporal/tsl",
"name": "torch-spatiotemporal",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "pytorch,pytorch-geometric,geometric-deep-learning,graph-neural-networks,temporal-graph-networks,spatiotemporal-graph-neural-networks,spatiotemporal-processing,neural-spatiotemporal-forecasting,time-series-analysis,forecasting",
"author": "Andrea Cini, Ivan Marisca",
"author_email": "andrea.cini@usi.ch, ivan.marisca@usi.ch",
"download_url": "https://files.pythonhosted.org/packages/35/6c/58757c324edd0976391463abd3630c8364b8f2e1a5061f594f189564a7ab/torch_spatiotemporal-0.9.4.tar.gz",
"platform": null,
"description": "<div align=\"center\">\n <br><br>\n <img alt=\"Torch Spatiotemporal\" src=\"https://raw.githubusercontent.com/TorchSpatiotemporal/tsl/main/docs/source/_static/img/tsl_logo_text.svg\" width=\"85%\"/>\n <h3>Neural spatiotemporal forecasting with PyTorch</h3>\n <hr>\n <p>\n <a href='https://pypi.org/project/torch-spatiotemporal/'>\n <img alt=\"PyPI\" src=\"https://img.shields.io/pypi/v/torch-spatiotemporal\">\n </a>\n <img alt=\"PyPI - Python Version\" src=\"https://img.shields.io/badge/python-%3E%3D3.8-blue\">\n <!-- img alt=\"PyPI - Python Version\" src=\"https://img.shields.io/pypi/pyversions/torch-spatiotemporal\" -->\n <img alt=\"Total downloads\" src=\"https://static.pepy.tech/badge/torch-spatiotemporal\">\n <a href='https://torch-spatiotemporal.readthedocs.io/en/latest/?badge=latest'>\n <img src='https://readthedocs.org/projects/torch-spatiotemporal/badge/?version=latest' alt='Documentation Status' />\n </a>\n </p>\n <p>\n \ud83d\ude80 <a href=\"https://torch-spatiotemporal.readthedocs.io/en/latest/usage/quickstart.html\">Getting Started</a> - \ud83d\udcda <a href=\"https://torch-spatiotemporal.readthedocs.io/en/latest/\">Documentation</a> - \ud83d\udcbb <a href=\"https://torch-spatiotemporal.readthedocs.io/en/latest/notebooks/a_gentle_introduction_to_tsl.html\">Introductory notebook</a>\n </p>\n</div>\n\n<p><img src=\"https://raw.githubusercontent.com/TorchSpatiotemporal/tsl/main/docs/source/_static/img/tsl_logo.svg\" width=\"25px\" align=\"center\"/> <b>tsl</b> <em>(Torch Spatiotemporal)</em> is a library built to accelerate research on neural spatiotemporal data processing\nmethods, with a focus on Graph Neural Networks.</p>\n\n<p><img src=\"https://raw.githubusercontent.com/TorchSpatiotemporal/tsl/main/docs/source/_static/img/tsl_logo.svg\" width=\"25px\" align=\"center\"/> tsl is built on several libraries of the <b>Python</b> scientific computing ecosystem, with the final objective of providing a straightforward process that goes from data preprocessing to model prototyping.\nIn particular, <img src=\"https://raw.githubusercontent.com/TorchSpatiotemporal/tsl/main/docs/source/_static/img/tsl_logo.svg\" width=\"25px\" align=\"center\"/> tsl offers a wide range of utilities to develop neural networks in <img src=\"https://raw.githubusercontent.com/TorchSpatiotemporal/tsl/main/docs/source/_static/img/logos/pytorch.svg\" width=\"20px\" align=\"center\"/> <a href=\"https://pytorch.org\"><b>PyTorch</b></a> for processing spatiotemporal data signals.</p>\n\n## Getting Started\n\nBefore you start using <img src=\"https://raw.githubusercontent.com/TorchSpatiotemporal/tsl/main/docs/source/_static/img/tsl_logo.svg\" width=\"25px\" align=\"center\"/> tsl, please review the <a href=\"https://torch-spatiotemporal.readthedocs.io/en/latest/\">documentation</a> to get an understanding of the library and its capabilities.\n\nYou can also explore the examples provided in the `examples` directory to see how train deep learning models working with spatiotemporal data.\n\n## Installation\n\nBefore installing <img src=\"https://raw.githubusercontent.com/TorchSpatiotemporal/tsl/main/docs/source/_static/img/tsl_logo.svg\" width=\"25px\" align=\"center\"/> tsl, make sure you have installed <img src=\"https://raw.githubusercontent.com/TorchSpatiotemporal/tsl/main/docs/source/_static/img/logos/pytorch.svg\" width=\"20px\" align=\"center\"/> <a href=\"https://pytorch.org\">PyTorch</a> (>=1.9.0) and <img src=\"https://raw.githubusercontent.com/TorchSpatiotemporal/tsl/main/docs/source/_static/img/logos/pyg.svg\" width=\"20px\" align=\"center\"/> <a href=\"https://pyg.org\">PyG</a> (>=2.0.3) in your virtual environment (see [PyG installation guidelines](https://pytorch-geometric.readthedocs.io/en/latest/install/installation.html)). <img src=\"https://raw.githubusercontent.com/TorchSpatiotemporal/tsl/main/docs/source/_static/img/tsl_logo.svg\" width=\"25px\" align=\"center\"/> tsl is available for Python>=3.8. We recommend installation from github to be up-to-date with the latest version:\n\n```bash\npip install git+https://github.com/TorchSpatiotemporal/tsl.git\n```\n\nAlternatively, you can install the library from the pypi repository:\n\n```bash\npip install torch-spatiotemporal\n```\n\nTo avoid dependencies issues, we recommend using [Anaconda](https://www.anaconda.com/) and the provided environment configuration by running the command:\n\n```bash\nconda env create -f conda_env.yml\n```\n\n## Tutorial\n\nThe best way to start using <img src=\"https://raw.githubusercontent.com/TorchSpatiotemporal/tsl/main/docs/source/_static/img/tsl_logo.svg\" width=\"25px\" align=\"center\"/> tsl is by following the tutorial notebook in `examples/notebooks/a_gentle_introduction_to_tsl.ipynb`.\n\n## Documentation\n\nThe documentation is hosted on [readthedocs](https://torch-spatiotemporal.readthedocs.io/en/latest/). For local access, you can build it from the `docs` directory.\n\n## Citing\n\nIf you use Torch Spatiotemporal for your research, please consider citing the library\n\n```latex\n@software{Cini_Torch_Spatiotemporal_2022,\n author = {Cini, Andrea and Marisca, Ivan},\n license = {MIT},\n month = {3},\n title = {{Torch Spatiotemporal}},\n url = {https://github.com/TorchSpatiotemporal/tsl},\n year = {2022}\n}\n```\n\nBy [Andrea Cini](https://andreacini.github.io/) and [Ivan Marisca](https://marshka.github.io/).\n\nThanks to all contributors! Check the [Contributing guidelines](https://github.com/TorchSpatiotemporal/tsl/blob/dev/.github/CONTRIBUTING.md) and help us build a better <img src=\"https://raw.githubusercontent.com/TorchSpatiotemporal/tsl/main/docs/source/_static/img/tsl_logo.svg\" width=\"25px\" align=\"center\"/> tsl.\n\n<a href=\"https://github.com/TorchSpatiotemporal/tsl/graphs/contributors\">\n <img src=\"https://contrib.rocks/image?repo=TorchSpatiotemporal/tsl\" />\n</a>\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A PyTorch library for spatiotemporal data processing",
"version": "0.9.4",
"project_urls": {
"Download": "https://github.com/TorchSpatiotemporal/tsl/archive/v0.9.4.tar.gz",
"Homepage": "https://github.com/TorchSpatiotemporal/tsl"
},
"split_keywords": [
"pytorch",
"pytorch-geometric",
"geometric-deep-learning",
"graph-neural-networks",
"temporal-graph-networks",
"spatiotemporal-graph-neural-networks",
"spatiotemporal-processing",
"neural-spatiotemporal-forecasting",
"time-series-analysis",
"forecasting"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "dbde16a81fbdbb7f150e46e9e1d45afc78415ede816c13076630e3d99aba2be8",
"md5": "6b6db8b1b3976336bfbccb62fdfc85d8",
"sha256": "83a43968efe5fbd851d3ff133e4fd6c9f979a1e2a9f68984794f095bbe2dbfc4"
},
"downloads": -1,
"filename": "torch_spatiotemporal-0.9.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6b6db8b1b3976336bfbccb62fdfc85d8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 242952,
"upload_time": "2023-08-18T12:14:10",
"upload_time_iso_8601": "2023-08-18T12:14:10.152454Z",
"url": "https://files.pythonhosted.org/packages/db/de/16a81fbdbb7f150e46e9e1d45afc78415ede816c13076630e3d99aba2be8/torch_spatiotemporal-0.9.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "356c58757c324edd0976391463abd3630c8364b8f2e1a5061f594f189564a7ab",
"md5": "a5c09ce603c731ba037d8b2e2ba2646a",
"sha256": "bdf31e38d37dc6fc993543c642260871c98a06fa4912eeca4e7e47a6e9cc40d0"
},
"downloads": -1,
"filename": "torch_spatiotemporal-0.9.4.tar.gz",
"has_sig": false,
"md5_digest": "a5c09ce603c731ba037d8b2e2ba2646a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 173511,
"upload_time": "2023-08-18T12:14:11",
"upload_time_iso_8601": "2023-08-18T12:14:11.923269Z",
"url": "https://files.pythonhosted.org/packages/35/6c/58757c324edd0976391463abd3630c8364b8f2e1a5061f594f189564a7ab/torch_spatiotemporal-0.9.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-18 12:14:11",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "TorchSpatiotemporal",
"github_project": "tsl",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "torch-spatiotemporal"
}