<p align="center" style="font-size:40px; margin:0px 10px 0px 10px">
<em>pyextremes</em>
</p>
<p align="center">
<em>Extreme Value Analysis (EVA) in Python</em>
</p>
<p align="center">
<a href="https://github.com/georgebv/pyextremes/actions/workflows/test.yml" target="_blank">
<img src="https://github.com/georgebv/pyextremes/actions/workflows/test.yml/badge.svg?event=pull_request" alt="Test">
</a>
<a href="https://codecov.io/gh/georgebv/pyextremes" target="_blank">
<img src="https://codecov.io/gh/georgebv/pyextremes/branch/master/graph/badge.svg" alt="Coverage">
</a>
<a href="https://pypi.org/project/pyextremes" target="_blank">
<img src="https://badge.fury.io/py/pyextremes.svg" alt="PyPI Package">
</a>
<a href="https://anaconda.org/conda-forge/pyextremes" target="_blank">
<img src="https://img.shields.io/conda/vn/conda-forge/pyextremes.svg" alt="Anaconda Package">
</a>
</p>
# About
**Documentation:** https://georgebv.github.io/pyextremes/
**License:** [MIT](https://opensource.org/licenses/MIT)
**Support:** [ask a question](https://github.com/georgebv/pyextremes/discussions)
or [create an issue](https://github.com/georgebv/pyextremes/issues/new/choose),
any input is appreciated and would help develop the project
**pyextremes** is a Python library aimed at performing univariate
[Extreme Value Analysis (EVA)](https://en.wikipedia.org/wiki/Extreme_value_theory).
It provides tools necessary to perform a wide range of tasks required to
perform EVA, such as:
- extraction of extreme events from time series using methods such as
Block Maxima (BM) or Peaks Over Threshold (POT)
- fitting continuous distributions, such as GEVD, GPD, or user-specified
continous distributions to the extracted extreme events
- visualization of model inputs, results, and goodness-of-fit statistics
- estimation of extreme events of given probability or return period
(e.g. 100-year event) and of corresponding confidence intervals
- tools assisting with model selection and tuning, such as selection of
block size in BM and threshold in POT
Check out [this repository](https://github.com/georgebv/pyextremes-notebooks)
with Jupyter notebooks used to produce figures for this readme
and for the official documentation.
# Installation
Get latest version from PyPI:
```shell
pip install pyextremes
```
Install with optional dependencies:
```shell
pip install pyextremes[full]
```
Get latest experimental build from GitHub:
```shell
pip install "git+https://github.com/georgebv/pyextremes.git#egg=pyextremes"
```
Get pyextremes for the Anaconda Python distribution:
```shell
conda install -c conda-forge pyextremes
```
# Illustrations
<p align="center" style="font-size:20px; margin:10px 10px 0px 10px">
<em>Model diagnostic</em>
</p>
<p align="center" style="font-size:20px; margin:10px 10px 40px 10px">
<img src="https://raw.githubusercontent.com/georgebv/pyextremes-notebooks/master/notebooks/documentation/readme%20figures/diagnostic.png" alt="Diagnostic plot" width="600px">
</p>
<p align="center" style="font-size:20px; margin:10px 10px 0px 10px">
<em>Extreme value extraction</em>
</p>
<p align="center" style="font-size:20px; margin:10px 10px 40px 10px">
<img src="https://raw.githubusercontent.com/georgebv/pyextremes-notebooks/master/notebooks/documentation/readme%20figures/extremes.png" alt="Diagnostic plot" width="600px">
</p>
<p align="center" style="font-size:20px; margin:10px 10px 0px 10px">
<em>Trace plot</em>
</p>
<p align="center" style="font-size:20px; margin:10px 10px 40px 10px">
<img src="https://raw.githubusercontent.com/georgebv/pyextremes-notebooks/master/notebooks/documentation/readme%20figures/trace.png" alt="Diagnostic plot" width="600px">
</p>
<p align="center" style="font-size:20px; margin:10px 10px 0px 10px">
<em>Corner plot</em>
</p>
<p align="center" style="font-size:20px; margin:10px 10px 40px 10px">
<img src="https://raw.githubusercontent.com/georgebv/pyextremes-notebooks/master/notebooks/documentation/readme%20figures/corner.png" alt="Diagnostic plot" width="600px">
</p>
# Acknowledgements
I wanted to give kudos to [Jean Toilliez](https://github.com/jtoilliez) who has inspired me to develop this open-source project and who taught me a lot about the extreme value theory. Also big thanks to Max Larson who has introduced me to software development and statistics.
Raw data
{
"_id": null,
"home_page": "https://georgebv.github.io/pyextremes",
"name": "pyextremes",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9,<4.0",
"maintainer_email": "",
"keywords": "statistics,extreme,extreme value analysis,eva,coastal,ocean,marine,environmental,engineering",
"author": "George Bocharov",
"author_email": "bocharovgeorgii@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/0f/19/db65453131780983300e9bb6389de2544c2efca87e6c67c0807685d7bd1f/pyextremes-2.3.2.tar.gz",
"platform": null,
"description": "<p align=\"center\" style=\"font-size:40px; margin:0px 10px 0px 10px\">\n <em>pyextremes</em>\n</p>\n<p align=\"center\">\n <em>Extreme Value Analysis (EVA) in Python</em>\n</p>\n<p align=\"center\">\n<a href=\"https://github.com/georgebv/pyextremes/actions/workflows/test.yml\" target=\"_blank\">\n <img src=\"https://github.com/georgebv/pyextremes/actions/workflows/test.yml/badge.svg?event=pull_request\" alt=\"Test\">\n</a>\n<a href=\"https://codecov.io/gh/georgebv/pyextremes\" target=\"_blank\">\n <img src=\"https://codecov.io/gh/georgebv/pyextremes/branch/master/graph/badge.svg\" alt=\"Coverage\">\n</a>\n<a href=\"https://pypi.org/project/pyextremes\" target=\"_blank\">\n <img src=\"https://badge.fury.io/py/pyextremes.svg\" alt=\"PyPI Package\">\n</a>\n<a href=\"https://anaconda.org/conda-forge/pyextremes\" target=\"_blank\">\n <img src=\"https://img.shields.io/conda/vn/conda-forge/pyextremes.svg\" alt=\"Anaconda Package\">\n</a>\n</p>\n\n# About\n\n**Documentation:** https://georgebv.github.io/pyextremes/\n\n**License:** [MIT](https://opensource.org/licenses/MIT)\n\n**Support:** [ask a question](https://github.com/georgebv/pyextremes/discussions)\nor [create an issue](https://github.com/georgebv/pyextremes/issues/new/choose),\nany input is appreciated and would help develop the project\n\n**pyextremes** is a Python library aimed at performing univariate\n[Extreme Value Analysis (EVA)](https://en.wikipedia.org/wiki/Extreme_value_theory).\nIt provides tools necessary to perform a wide range of tasks required to\nperform EVA, such as:\n\n- extraction of extreme events from time series using methods such as\nBlock Maxima (BM) or Peaks Over Threshold (POT)\n- fitting continuous distributions, such as GEVD, GPD, or user-specified\ncontinous distributions to the extracted extreme events\n- visualization of model inputs, results, and goodness-of-fit statistics\n- estimation of extreme events of given probability or return period\n(e.g. 100-year event) and of corresponding confidence intervals\n- tools assisting with model selection and tuning, such as selection of\nblock size in BM and threshold in POT\n\nCheck out [this repository](https://github.com/georgebv/pyextremes-notebooks)\nwith Jupyter notebooks used to produce figures for this readme\nand for the official documentation.\n\n# Installation\n\nGet latest version from PyPI:\n\n```shell\npip install pyextremes\n```\n\nInstall with optional dependencies:\n\n```shell\npip install pyextremes[full]\n```\n\nGet latest experimental build from GitHub:\n\n```shell\npip install \"git+https://github.com/georgebv/pyextremes.git#egg=pyextremes\"\n```\n\nGet pyextremes for the Anaconda Python distribution:\n\n```shell\nconda install -c conda-forge pyextremes\n```\n\n# Illustrations\n\n<p align=\"center\" style=\"font-size:20px; margin:10px 10px 0px 10px\">\n <em>Model diagnostic</em>\n</p>\n<p align=\"center\" style=\"font-size:20px; margin:10px 10px 40px 10px\">\n <img src=\"https://raw.githubusercontent.com/georgebv/pyextremes-notebooks/master/notebooks/documentation/readme%20figures/diagnostic.png\" alt=\"Diagnostic plot\" width=\"600px\">\n</p>\n\n<p align=\"center\" style=\"font-size:20px; margin:10px 10px 0px 10px\">\n <em>Extreme value extraction</em>\n</p>\n<p align=\"center\" style=\"font-size:20px; margin:10px 10px 40px 10px\">\n <img src=\"https://raw.githubusercontent.com/georgebv/pyextremes-notebooks/master/notebooks/documentation/readme%20figures/extremes.png\" alt=\"Diagnostic plot\" width=\"600px\">\n</p>\n\n<p align=\"center\" style=\"font-size:20px; margin:10px 10px 0px 10px\">\n <em>Trace plot</em>\n</p>\n<p align=\"center\" style=\"font-size:20px; margin:10px 10px 40px 10px\">\n <img src=\"https://raw.githubusercontent.com/georgebv/pyextremes-notebooks/master/notebooks/documentation/readme%20figures/trace.png\" alt=\"Diagnostic plot\" width=\"600px\">\n</p>\n\n<p align=\"center\" style=\"font-size:20px; margin:10px 10px 0px 10px\">\n <em>Corner plot</em>\n</p>\n<p align=\"center\" style=\"font-size:20px; margin:10px 10px 40px 10px\">\n <img src=\"https://raw.githubusercontent.com/georgebv/pyextremes-notebooks/master/notebooks/documentation/readme%20figures/corner.png\" alt=\"Diagnostic plot\" width=\"600px\">\n</p>\n\n# Acknowledgements\nI wanted to give kudos to [Jean Toilliez](https://github.com/jtoilliez) who has inspired me to develop this open-source project and who taught me a lot about the extreme value theory. Also big thanks to Max Larson who has introduced me to software development and statistics.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Extreme Value Analysis (EVA) in Python",
"version": "2.3.2",
"project_urls": {
"Homepage": "https://georgebv.github.io/pyextremes",
"Repository": "https://github.com/georgebv/pyextremes"
},
"split_keywords": [
"statistics",
"extreme",
"extreme value analysis",
"eva",
"coastal",
"ocean",
"marine",
"environmental",
"engineering"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f787d74a1f331c368f3d4f371c20f935188139577485f0848a74afcd0b067719",
"md5": "e5566c31859131d136450ae99a4ac955",
"sha256": "2b5015ac1e9fd44d93f27f1f2d52838be5097955687396c688db895a0e67584c"
},
"downloads": -1,
"filename": "pyextremes-2.3.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e5566c31859131d136450ae99a4ac955",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9,<4.0",
"size": 57643,
"upload_time": "2023-10-14T22:59:45",
"upload_time_iso_8601": "2023-10-14T22:59:45.668952Z",
"url": "https://files.pythonhosted.org/packages/f7/87/d74a1f331c368f3d4f371c20f935188139577485f0848a74afcd0b067719/pyextremes-2.3.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0f19db65453131780983300e9bb6389de2544c2efca87e6c67c0807685d7bd1f",
"md5": "c2eb6b8ce8e2bf43b482a64fa0fa031a",
"sha256": "144bc9d25bf10d67c95b90d9236f3ea71bf9e4e242855e97cd8015319b7918e9"
},
"downloads": -1,
"filename": "pyextremes-2.3.2.tar.gz",
"has_sig": false,
"md5_digest": "c2eb6b8ce8e2bf43b482a64fa0fa031a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9,<4.0",
"size": 41647,
"upload_time": "2023-10-14T22:59:47",
"upload_time_iso_8601": "2023-10-14T22:59:47.313491Z",
"url": "https://files.pythonhosted.org/packages/0f/19/db65453131780983300e9bb6389de2544c2efca87e6c67c0807685d7bd1f/pyextremes-2.3.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-10-14 22:59:47",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "georgebv",
"github_project": "pyextremes",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pyextremes"
}
JSON
