# *SporTran* (FKA thermocepstrum)
A code to estimate transport coefficients from the cepstral analysis of a multi-variate current stationary time series.
[](https://badge.fury.io/py/sportran)
[](https://sportran.readthedocs.io/en/latest/?badge=latest)
### Documentation
https://sportran.readthedocs.io
### References
- [Ercole L., Bertossa R., Bisacchi S., and Baroni S., "_SporTran: a code to estimate transport coefficients from the cepstral analysis of (multivariate) current time series_", *Comput. Phys. Commun.*, 108470](https://doi.org/10.1016/j.cpc.2022.108470), [*arXiv*:2202.11571 (2022)](https://arxiv.org/abs/2202.11571)
- (cepstral analysis) [Ercole, Marcolongo, Baroni, *Sci. Rep.* **7**, 15835 (2017)](https://doi.org/10.1038/s41598-017-15843-2)
- (multicomponent systems) [Bertossa, Grasselli, Ercole, Baroni, *Phys. Rev. Lett.* **122**, 255901 (2019)](https://doi.org/10.1103/PhysRevLett.122.255901) ([arXiv](https://arxiv.org/abs/1808.03341))
- (review) [Baroni, Bertossa, Ercole, Grasselli, Marcolongo, *Handbook of Materials Modeling* (2018)](https://doi.org/10.1007/978-3-319-50257-1_12-1) ([arXiv](https://arxiv.org/abs/1802.08006))
Developed by Loris Ercole, Riccardo Bertossa, Sebastiano Bisacchi under the supervision of prof. Stefano Baroni
**Acknowledgment** The development of this software is part of the scientific program of the EU MaX Centre of Excellence for Supercomputing Applications (Grant No. 676598, 824143) and has been partly funded through it.
---
### Usage
There is a [**GUI**](README_GUI.md) that you can try after installing the package. Click [here](README_GUI.md) for instructions.
The code can be used as a **library**, for example in a Jupyter notebook.
In the [`examples`](examples/) folder you can find some examples.
Alternatively, you can run the code `analysis.py` from the **command line** without any installation procedure.
It can execute most of the cepstral analysis routines, returning the results in a series of data files and PDF plots.
See the [`examples/example_commandline_NaCl`](examples/example_commandline_NaCl/) folder and the help (`python analysis.py --help`) for more information.
### Requirements
- numpy
- scipy
- matplotlib
- tkinter
- markdown2
- pillow
### Installation
You can simply pip-install SporTran downloading it from PyPI with `pip install sportran`.
Alternatively:
1. Clone this repository: `git clone https://github.com/sissaschool/sportran.git`
2. Install the package with pip (dependencies will be automatically downloaded). For example:
```
cd sportran
pip install .
```
You are all set! You can check that the installation is working by trying to run the command `sportran-analysis`.
The Graphical User Interface can be started with the command `sportran-gui`.
### Issues
You are strongly encouraged to report any issue on the [official](https://github.com/sissaschool/sportran/issues) GitHub issues page.
Raw data
{
"_id": null,
"home_page": "https://github.com/sissaschool/sportran",
"name": "sportran",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7, <4",
"maintainer_email": "",
"keywords": "cepstral data analysis thermal conductivity transport coefficients physics green-kubo",
"author": "Loris Ercole, Riccardo Bertossa, Sebastiano Bisacchi",
"author_email": "loris.ercole@epfl.ch",
"download_url": "https://files.pythonhosted.org/packages/79/c6/4fc6017bf627576b06dae9db5d39a9f29cd8125e687ccf33eb018584d6f9/sportran-1.0.0rc4.tar.gz",
"platform": null,
"description": "# *SporTran* (FKA thermocepstrum)\n\nA code to estimate transport coefficients from the cepstral analysis of a multi-variate current stationary time series.\n\n[](https://badge.fury.io/py/sportran)\n[](https://sportran.readthedocs.io/en/latest/?badge=latest)\n\n### Documentation\nhttps://sportran.readthedocs.io\n\n### References\n - [Ercole L., Bertossa R., Bisacchi S., and Baroni S., \"_SporTran: a code to estimate transport coefficients from the cepstral analysis of (multivariate) current time series_\", *Comput. Phys. Commun.*, 108470](https://doi.org/10.1016/j.cpc.2022.108470), [*arXiv*:2202.11571 (2022)](https://arxiv.org/abs/2202.11571)\n - (cepstral analysis) [Ercole, Marcolongo, Baroni, *Sci. Rep.* **7**, 15835 (2017)](https://doi.org/10.1038/s41598-017-15843-2)\n - (multicomponent systems) [Bertossa, Grasselli, Ercole, Baroni, *Phys. Rev. Lett.* **122**, 255901 (2019)](https://doi.org/10.1103/PhysRevLett.122.255901) ([arXiv](https://arxiv.org/abs/1808.03341))\n - (review) [Baroni, Bertossa, Ercole, Grasselli, Marcolongo, *Handbook of Materials Modeling* (2018)](https://doi.org/10.1007/978-3-319-50257-1_12-1) ([arXiv](https://arxiv.org/abs/1802.08006))\n\nDeveloped by Loris Ercole, Riccardo Bertossa, Sebastiano Bisacchi under the supervision of prof. Stefano Baroni\n\n**Acknowledgment** The development of this software is part of the scientific program of the EU MaX Centre of Excellence for Supercomputing Applications (Grant No. 676598, 824143) and has been partly funded through it.\n\n---\n\n### Usage\nThere is a [**GUI**](README_GUI.md) that you can try after installing the package. Click [here](README_GUI.md) for instructions.\n\nThe code can be used as a **library**, for example in a Jupyter notebook.\nIn the [`examples`](examples/) folder you can find some examples.\n\nAlternatively, you can run the code `analysis.py` from the **command line** without any installation procedure.\nIt can execute most of the cepstral analysis routines, returning the results in a series of data files and PDF plots.\nSee the [`examples/example_commandline_NaCl`](examples/example_commandline_NaCl/) folder and the help (`python analysis.py --help`) for more information.\n\n### Requirements\n - numpy\n - scipy\n - matplotlib\n - tkinter\n - markdown2\n - pillow\n\n\n### Installation\n You can simply pip-install SporTran downloading it from PyPI with `pip install sportran`.\n\n Alternatively:\n\n 1. Clone this repository: `git clone https://github.com/sissaschool/sportran.git`\n 2. Install the package with pip (dependencies will be automatically downloaded). For example:\n```\ncd sportran\npip install .\n```\n You are all set! You can check that the installation is working by trying to run the command `sportran-analysis`.\n\n The Graphical User Interface can be started with the command `sportran-gui`.\n\n### Issues\n You are strongly encouraged to report any issue on the [official](https://github.com/sissaschool/sportran/issues) GitHub issues page.\n\n\n",
"bugtrack_url": null,
"license": "GPL 3",
"summary": "Cepstral Data Analysis of current time series for Green-Kubo transport coefficients",
"version": "1.0.0rc4",
"split_keywords": [
"cepstral",
"data",
"analysis",
"thermal",
"conductivity",
"transport",
"coefficients",
"physics",
"green-kubo"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "96a49763f8027fb5c0caaf1dc58992340371b5492d9d97605446d7da13aab3b4",
"md5": "52e2ea6134d3a7571739fcd006469045",
"sha256": "29b6d39d94f9ebca3c367c6f2845a13e1f29e1c0715cd4174e5d361c2dbc2ab6"
},
"downloads": -1,
"filename": "sportran-1.0.0rc4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "52e2ea6134d3a7571739fcd006469045",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7, <4",
"size": 134550,
"upload_time": "2023-04-14T08:15:28",
"upload_time_iso_8601": "2023-04-14T08:15:28.400060Z",
"url": "https://files.pythonhosted.org/packages/96/a4/9763f8027fb5c0caaf1dc58992340371b5492d9d97605446d7da13aab3b4/sportran-1.0.0rc4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "79c64fc6017bf627576b06dae9db5d39a9f29cd8125e687ccf33eb018584d6f9",
"md5": "58dd5ef26c373b12d2ad98045241c458",
"sha256": "9fd104e4d87bcaedd2e90b534db1fc05778b704940a7700a341ea212aae49abf"
},
"downloads": -1,
"filename": "sportran-1.0.0rc4.tar.gz",
"has_sig": false,
"md5_digest": "58dd5ef26c373b12d2ad98045241c458",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7, <4",
"size": 15956499,
"upload_time": "2023-04-14T08:15:31",
"upload_time_iso_8601": "2023-04-14T08:15:31.175204Z",
"url": "https://files.pythonhosted.org/packages/79/c6/4fc6017bf627576b06dae9db5d39a9f29cd8125e687ccf33eb018584d6f9/sportran-1.0.0rc4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-04-14 08:15:31",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "sissaschool",
"github_project": "sportran",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "sportran"
}
JSON
