The `antiCPy` package provides tools to monitor destabilization because of varying control parameters or the influence of noise. Based on early warning measures it provides an extrapolation tool to estimate the time horizon in which a critical transition will probably occur.<br /><br />[![DOI](https://zenodo.org/badge/440811484.svg)](https://zenodo.org/badge/latestdoi/440811484) [![Documentation Status](https://readthedocs.org/projects/anticpy/badge/?version=latest)](https://anticpy.readthedocs.io/en/latest/?badge=latest) [![PyPI version](https://badge.fury.io/py/antiCPy.svg)](https://badge.fury.io/py/antiCPy) [![GitHub release](https://img.shields.io/github/release/MartinHessler/antiCPy?color)](https://github.com/MartinHessler/antiCPy) [![license](https://img.shields.io/github/license/MartinHessler/antiCPy?color=blue)](https://img.shields.io/github/MartinHessler/antiCPy/blob/main/LICENSE)
antiCPy
=======
The package abbreviation **antiCPy** stands for ''**anti**cipate **C**ritical **P**oints (and if you like **C**hange **P**oints)
with **Py**thon''. The vision of the **antiCPy** package is designing a package collection of state-of-the-art
early warning measures, leading indicators and time series analysis tools that focus on system stability and
resilience in general as well as algorithms that might be helpful to estimate time horizons of future transitions or resilience changes.
It provides an easy applicable and efficient toolbox
1. to estimate the drift slope $\hat{\zeta}$ of a polynomial Langevin equation as an early warning signal via Markov Chain Monte Carlo
(MCMC) sampling or maximum posterior (MAP) estimation,
2. to estimate a non-Markovian two-time scale polynomial system via MCMC or MAP with the option of a priori activated time scale separation,
3. to estimate the dominant eigenvalue by empiric dynamic modelling approaches like delay embedding and shadow manifolds combined with
iterated map's linear stability formalism,
4. to extrapolate an early warning signal trend to find the probable transition horizon based on the current data information.
Computationally expensive algorithms are implemented both, serially and strongly parallelized to minimize computation times. In case of
the change point trend extrapolation it involves furthermore algorithms that allow for computing of complicated fits with high numbers
of change points without memory errors.
The package aims to provide easily applicable methods and guarantee high flexibility and access to the derived interim results
for research purposes.
![An illustration of the drift slope procedure.](https://github.com/MartinHessler/antiCPy/blob/main/images/compound_BLE_illustration.jpg?raw=true)
Citing antiCPy
==============
If you use **antiCPy's** `drift_slope` measure, please cite
Martin Heßler et al. Bayesian on-line anticipation of critical transitions. New J. Phys. (2022). https://doi.org/10.1088/1367-2630/ac46d4.
If you use **antiCPy's** `dominant_eigenvalue` instead, please cite
Martin Heßler et al. Anticipation of Oligocene's climate heartbeat by simplified eigenvalue estimation.
arXiv (2023). https://doi.org/10.48550/arXiv.2309.14179
Documentation
=============
You can find the [documentation on read the docs](https://anticpy.readthedocs.io/en/latest/).
Install
=======
The package can be installed via
```
pip install antiCPy
```
Related publications
====================
Up to now the package is accompanied by
- the publication [Efficient Multi-Change Point Analysis to Decode Economic Crisis Information from the S&P500 Mean Market Correlation](https://www.mdpi.com/1099-4300/25/9/1265),
- the publication [Memory Effects, Multiple Time Scales and Local Stability in Langevin Models of the S&P500 Market Correlation](https://www.mdpi.com/1099-4300/25/9/1257),
- the publication [Identifying dominant industrial sectors in market states of the S&P 500 financial data](https://iopscience.iop.org/article/10.1088/1742-5468/accce0),
- the publication [Quantifying resilience and the risk of regime shifts under strong correlated noise](https://academic.oup.com/pnasnexus/article/2/2/pgac296/6960580),
- the publication [Bayesian on-line anticipation of critical transitions](https://iopscience.iop.org/article/10.1088/1367-2630/ac46d4),
- the preprint [Anticipation of Oligocene's climate heartbeat by simplified eigenvalue estimation](https://arxiv.org/abs/2309.14179),
- the preprint [Quantifying Tipping Risks in Power Grids and beyond](https://arxiv.org/abs/2212.06780).
Raw data
{
"_id": null,
"home_page": "https://github.com/MartinHessler/antiCPy",
"name": "antiCPy",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "time series analysis, critical transitions, leading indicators",
"author": "Martin He\u00dfler",
"author_email": "m_hess23@wwu.de",
"download_url": "https://files.pythonhosted.org/packages/a1/39/c8365cad713d37acae9e83cfac25e6d414ebc288aa3a9367abb80a0f3468/anticpy-0.0.9.post3.tar.gz",
"platform": "any",
"description": "The `antiCPy` package provides tools to monitor destabilization because of varying control parameters or the influence of noise. Based on early warning measures it provides an extrapolation tool to estimate the time horizon in which a critical transition will probably occur.<br /><br />[![DOI](https://zenodo.org/badge/440811484.svg)](https://zenodo.org/badge/latestdoi/440811484) [![Documentation Status](https://readthedocs.org/projects/anticpy/badge/?version=latest)](https://anticpy.readthedocs.io/en/latest/?badge=latest) [![PyPI version](https://badge.fury.io/py/antiCPy.svg)](https://badge.fury.io/py/antiCPy) [![GitHub release](https://img.shields.io/github/release/MartinHessler/antiCPy?color)](https://github.com/MartinHessler/antiCPy) [![license](https://img.shields.io/github/license/MartinHessler/antiCPy?color=blue)](https://img.shields.io/github/MartinHessler/antiCPy/blob/main/LICENSE)\n\nantiCPy\n=======\n\nThe package abbreviation **antiCPy** stands for ''**anti**cipate **C**ritical **P**oints (and if you like **C**hange **P**oints) \nwith **Py**thon''. The vision of the **antiCPy** package is designing a package collection of state-of-the-art\nearly warning measures, leading indicators and time series analysis tools that focus on system stability and\nresilience in general as well as algorithms that might be helpful to estimate time horizons of future transitions or resilience changes.\nIt provides an easy applicable and efficient toolbox\n\n1. to estimate the drift slope $\\hat{\\zeta}$ of a polynomial Langevin equation as an early warning signal via Markov Chain Monte Carlo\n (MCMC) sampling or maximum posterior (MAP) estimation,\n2. to estimate a non-Markovian two-time scale polynomial system via MCMC or MAP with the option of a priori activated time scale separation,\n3. to estimate the dominant eigenvalue by empiric dynamic modelling approaches like delay embedding and shadow manifolds combined with\n iterated map's linear stability formalism,\n4. to extrapolate an early warning signal trend to find the probable transition horizon based on the current data information.\n\nComputationally expensive algorithms are implemented both, serially and strongly parallelized to minimize computation times. In case of\nthe change point trend extrapolation it involves furthermore algorithms that allow for computing of complicated fits with high numbers\nof change points without memory errors.\nThe package aims to provide easily applicable methods and guarantee high flexibility and access to the derived interim results\nfor research purposes.\n\n![An illustration of the drift slope procedure.](https://github.com/MartinHessler/antiCPy/blob/main/images/compound_BLE_illustration.jpg?raw=true)\n\nCiting antiCPy\n==============\n\nIf you use **antiCPy's** `drift_slope` measure, please cite\n\nMartin He\u00dfler et al. Bayesian on-line anticipation of critical transitions. New J. Phys. (2022). https://doi.org/10.1088/1367-2630/ac46d4.\n\nIf you use **antiCPy's** `dominant_eigenvalue` instead, please cite\n\nMartin He\u00dfler et al. Anticipation of Oligocene's climate heartbeat by simplified eigenvalue estimation.\narXiv (2023). https://doi.org/10.48550/arXiv.2309.14179\n\nDocumentation\n=============\n\nYou can find the [documentation on read the docs](https://anticpy.readthedocs.io/en/latest/).\n\nInstall\n=======\n\nThe package can be installed via\n\n```\npip install antiCPy\n```\n\nRelated publications\n====================\nUp to now the package is accompanied by\n- the publication [Efficient Multi-Change Point Analysis to Decode Economic Crisis Information from the S&P500 Mean Market Correlation](https://www.mdpi.com/1099-4300/25/9/1265),\n- the publication [Memory Effects, Multiple Time Scales and Local Stability in Langevin Models of the S&P500 Market Correlation](https://www.mdpi.com/1099-4300/25/9/1257),\n- the publication [Identifying dominant industrial sectors in market states of the S&P 500 financial data](https://iopscience.iop.org/article/10.1088/1742-5468/accce0),\n- the publication [Quantifying resilience and the risk of regime shifts under strong correlated noise](https://academic.oup.com/pnasnexus/article/2/2/pgac296/6960580),\n- the publication [Bayesian on-line anticipation of critical transitions](https://iopscience.iop.org/article/10.1088/1367-2630/ac46d4),\n\n- the preprint [Anticipation of Oligocene's climate heartbeat by simplified eigenvalue estimation](https://arxiv.org/abs/2309.14179),\n- the preprint [Quantifying Tipping Risks in Power Grids and beyond](https://arxiv.org/abs/2212.06780).\n",
"bugtrack_url": null,
"license": "GPL",
"summary": "A package that provides tools to estimate resilience and noise level of a system as well as extrapolate possible transition times.",
"version": "0.0.9.post3",
"project_urls": {
"Homepage": "https://github.com/MartinHessler/antiCPy"
},
"split_keywords": [
"time series analysis",
" critical transitions",
" leading indicators"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a139c8365cad713d37acae9e83cfac25e6d414ebc288aa3a9367abb80a0f3468",
"md5": "3349424b9c88ed8951c28fd68c12c5a3",
"sha256": "11412fab49b42de207e84653444028145af77d01cf8736cef9db7a714251a41b"
},
"downloads": -1,
"filename": "anticpy-0.0.9.post3.tar.gz",
"has_sig": false,
"md5_digest": "3349424b9c88ed8951c28fd68c12c5a3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 78486,
"upload_time": "2024-08-23T13:13:16",
"upload_time_iso_8601": "2024-08-23T13:13:16.381974Z",
"url": "https://files.pythonhosted.org/packages/a1/39/c8365cad713d37acae9e83cfac25e6d414ebc288aa3a9367abb80a0f3468/anticpy-0.0.9.post3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-23 13:13:16",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "MartinHessler",
"github_project": "antiCPy",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "anticpy"
}