# TSFEDL: A Python Library for Time Series Spatio-Temporal Feature Extraction and Prediction using Deep Learning.
## Description
Time series feature extraction is a classical problem in time series analysis. Classical addition and multiplication models have been used for this purpose until the appearance of Artificial Neural Networks and Deep Learning. This problem has gained attention since multiple real-life problems imply the usage of time series.
In this repository, we introduce a new Python module which compiles 20 backbones for time series feature extraction using Deep Learning. This module has been created to cover the necessity of a versatile and expandable piece of software for practitioners to use in their problems.
## How to run
### Conda environment for GPU clusters
To easily use the library inside a conda environment the following commands are recommended to install the module. First of all install pip inside anaconda, which will install python inside the environment as well to encapsulate the whole installation.
```bash
conda install -c anaconda pip
```
After this, if a GPU is going to be used, we should install cuDNN 8.2.1 for the current tensorflow-gpu version (2.6.0). The NVIDIA CUDA toolkit will be also installed as a cuDNN dependency.
```bash
conda install -c anaconda cudnn==8.2.1
```
Finally, we can install the TSFEDL library using pip3 (which will be inside the conda environment, you can check this by running "which pip3"). This will install as dependencies pytorch-lightning, pytorch, tensorflow-gpu and all the needed packages. Use the --use-feature=2020-resolver flag if the installation runs into an error.
```bash
pip3 install --use-feature=2020-resolver tsfedl
```
Otherwise use
```bash
pip3 install tsfedl
```
After this everything is set up.
### PyPi
The module is uploaded to PyPi for an easy installation:
```bash
pip install tsfedl
```
or
```bash
pip3 install tsfedl
```
### Documentation
The documentation of the model can be found in https://s-tsfe-dl.readthedocs.io/en/latest/
### Using the repository
First, install dependencies
```bash
# clone project
git clone https://github.com/ari-dasci/S-TSFE-DL.git
# install project
cd S-TSFE-DL
pip install -e .
```
### Examples
To run an example, navigate to any file and run it.
```bash
cd project/examples
# run example
python arrythmia_experiment.py
```
## Imports
This project is set up as a package which means you can now easily import any file into any other file like so:
```python
import tensorflow as tf
import TSFEDL.models_keras as TSFEDL
# get the OhShuLih model
model = TSFEDL.OhShuLih(input_tensor=input, include_top=True)
# compile and fit as usual
model.compile(optimizer='Adam')
model.fit(X, y, epochs=20)
```
## Citation
Please cite this work as:
Time Series Feature Extraction using Deep Learning library (https://github.com/ari-dasci/S-TSFE-DL/)
```
@article{AGUILERAMARTOS2023223,
title = {{TSFEDL}: A python library for time series spatio-temporal feature extraction and prediction using deep learning},
journal = {Neurocomputing},
volume = {517},
pages = {223-228},
year = {2023},
doi = {https://doi.org/10.1016/j.neucom.2022.10.062},
author = {Ignacio Aguilera-Martos and Ángel M. García-Vico and Julián Luengo and Sergio Damas and Francisco J. Melero and José Javier Valle-Alonso and Francisco Herrera}
}
```
ArXiV reference with extended material: https://arxiv.org/abs/2206.03179
Raw data
{
"_id": null,
"home_page": "https://github.com/ari-dasci/S-TSFE-DL",
"name": "TSFEDL",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "Time series,Feature extraction,Deep learning,recurrent,cnn",
"author": "Ignacio Aguilera Martos, \u00c1ngel Miguel Garc\u00eda Vico, Julian Luengo, Francisco Herrera",
"author_email": "nacheteam@ugr.es",
"download_url": "https://files.pythonhosted.org/packages/ac/3a/b25797d322ce6494d18c3b095086487c71a6c71190dc307b52b9cb72f9f6/TSFEDL-1.0.7.6.tar.gz",
"platform": null,
"description": "# TSFEDL: A Python Library for Time Series Spatio-Temporal Feature Extraction and Prediction using Deep Learning.\n\n## Description\n\nTime series feature extraction is a classical problem in time series analysis. Classical addition and multiplication models have been used for this purpose until the appearance of Artificial Neural Networks and Deep Learning. This problem has gained attention since multiple real-life problems imply the usage of time series.\n\nIn this repository, we introduce a new Python module which compiles 20 backbones for time series feature extraction using Deep Learning. This module has been created to cover the necessity of a versatile and expandable piece of software for practitioners to use in their problems.\n\n## How to run\n\n### Conda environment for GPU clusters\n\nTo easily use the library inside a conda environment the following commands are recommended to install the module. First of all install pip inside anaconda, which will install python inside the environment as well to encapsulate the whole installation.\n\n```bash\nconda install -c anaconda pip\n```\n\nAfter this, if a GPU is going to be used, we should install cuDNN 8.2.1 for the current tensorflow-gpu version (2.6.0). The NVIDIA CUDA toolkit will be also installed as a cuDNN dependency.\n\n```bash\nconda install -c anaconda cudnn==8.2.1\n```\n\nFinally, we can install the TSFEDL library using pip3 (which will be inside the conda environment, you can check this by running \"which pip3\"). This will install as dependencies pytorch-lightning, pytorch, tensorflow-gpu and all the needed packages. Use the --use-feature=2020-resolver flag if the installation runs into an error.\n\n```bash\npip3 install --use-feature=2020-resolver tsfedl\n```\n\nOtherwise use\n\n```bash\npip3 install tsfedl\n```\n\nAfter this everything is set up.\n\n### PyPi\n\nThe module is uploaded to PyPi for an easy installation:\n```bash\npip install tsfedl\n```\nor\n```bash\npip3 install tsfedl\n```\n\n### Documentation\n\nThe documentation of the model can be found in https://s-tsfe-dl.readthedocs.io/en/latest/\n\n### Using the repository\n\nFirst, install dependencies\n\n```bash\n# clone project\ngit clone https://github.com/ari-dasci/S-TSFE-DL.git\n\n# install project\ncd S-TSFE-DL\npip install -e .\n``` \n\n### Examples\n\nTo run an example, navigate to any file and run it.\n\n```bash\ncd project/examples\n\n# run example\npython arrythmia_experiment.py\n```\n\n## Imports\nThis project is set up as a package which means you can now easily import any file into any other file like so:\n\n```python\nimport tensorflow as tf\nimport TSFEDL.models_keras as TSFEDL\n\n# get the OhShuLih model\nmodel = TSFEDL.OhShuLih(input_tensor=input, include_top=True)\n\n# compile and fit as usual\nmodel.compile(optimizer='Adam')\nmodel.fit(X, y, epochs=20)\n```\n\n## Citation\n\nPlease cite this work as:\n\nTime Series Feature Extraction using Deep Learning library (https://github.com/ari-dasci/S-TSFE-DL/)\n\n```\n@article{AGUILERAMARTOS2023223,\ntitle = {{TSFEDL}: A python library for time series spatio-temporal feature extraction and prediction using deep learning},\njournal = {Neurocomputing},\nvolume = {517},\npages = {223-228},\nyear = {2023},\ndoi = {https://doi.org/10.1016/j.neucom.2022.10.062},\nauthor = {Ignacio Aguilera-Martos and \u00c1ngel M. Garc\u00eda-Vico and Juli\u00e1n Luengo and Sergio Damas and Francisco J. Melero and Jos\u00e9 Javier Valle-Alonso and Francisco Herrera}\n}\n```\n\nArXiV reference with extended material: https://arxiv.org/abs/2206.03179\n",
"bugtrack_url": null,
"license": "",
"summary": "Time Series Spatio-Temporal Feature Extraction using Deep Learning",
"version": "1.0.7.6",
"project_urls": {
"Homepage": "https://github.com/ari-dasci/S-TSFE-DL"
},
"split_keywords": [
"time series",
"feature extraction",
"deep learning",
"recurrent",
"cnn"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "dceb161a471ff33988c360d482de552c70f5a9bf44a0cd8f401957957db7549e",
"md5": "e42025fd45a5f89549c00dcae03f9617",
"sha256": "e10e4f935e31c95eaca1fd6e8874aca677ac48d83634df9bf3636a8307782ec4"
},
"downloads": -1,
"filename": "TSFEDL-1.0.7.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e42025fd45a5f89549c00dcae03f9617",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 44311,
"upload_time": "2024-03-05T11:32:51",
"upload_time_iso_8601": "2024-03-05T11:32:51.411861Z",
"url": "https://files.pythonhosted.org/packages/dc/eb/161a471ff33988c360d482de552c70f5a9bf44a0cd8f401957957db7549e/TSFEDL-1.0.7.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ac3ab25797d322ce6494d18c3b095086487c71a6c71190dc307b52b9cb72f9f6",
"md5": "eed7311296a3a1bcc816fe98b0a23d55",
"sha256": "3ce63fc62210761817672516383e5e7c349fae5ee9ad2a61dfca7342e42ff190"
},
"downloads": -1,
"filename": "TSFEDL-1.0.7.6.tar.gz",
"has_sig": false,
"md5_digest": "eed7311296a3a1bcc816fe98b0a23d55",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 48900,
"upload_time": "2024-03-05T11:32:53",
"upload_time_iso_8601": "2024-03-05T11:32:53.431093Z",
"url": "https://files.pythonhosted.org/packages/ac/3a/b25797d322ce6494d18c3b095086487c71a6c71190dc307b52b9cb72f9f6/TSFEDL-1.0.7.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-05 11:32:53",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ari-dasci",
"github_project": "S-TSFE-DL",
"travis_ci": true,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "tsfedl"
}
JSON
