[![pytest](https://github.com/fortitudo-tech/entropy-pooling/actions/workflows/tests.yml/badge.svg)](https://github.com/fortitudo-tech/entropy-pooling/actions/workflows/tests.yml)
[![codecov](https://codecov.io/gh/fortitudo-tech/entropy-pooling/graph/badge.svg?token=XGIQ78ZLDN)](https://codecov.io/gh/fortitudo-tech/entropy-pooling)
[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/fortitudo-tech/entropy-pooling/HEAD?labpath=examples)
Entropy Pooling in Python
=========================
Due to popular demand from developers, this package contains the Entropy Pooling
implementation from the [fortitudo.tech Python package](https://github.com/fortitudo-tech/fortitudo.tech)
with a more permissive BSD 3-Clause license.
This package contains only one function called ep and has minimal dependencies
with just scipy. See [the examples](https://github.com/fortitudo-tech/entropy-pooling/tree/main/examples)
for how you can import and use the ep function.
You can explore the examples without local installations using
[Binder](https://mybinder.org/v2/gh/fortitudo-tech/entropy-pooling/HEAD?labpath=examples).
Installation instructions
-------------------------
Installation can be done via pip:
pip install entropy-pooling
Theory
------
Entropy Pooling is a powerful method for implementing subjective views and
performing stress-tests for fully general Monte Carlo distributions. It was first
introduced by [Meucci (2008)](https://ssrn.com/abstract=1213325) and refined
with sequential algorithms by [Vorobets (2021)](https://ssrn.com/abstract=3936392).
[You can loosely think about Entropy Pooling as a generalization of the Black-Litterman model](https://antonvorobets.substack.com/p/entropy-pooling-vs-black-litterman-abb608b810cd) without all the oversimplifying assumptions. Entropy Pooling operates directly on
[the next generation market representation](https://youtu.be/4ESigySdGf8?si=yWYuP9te1K1RBU7j&t=46)
defined by the simulation matrix $R\in \mathbb{R}^{S\times I}$ and associated joint
scenario probability vector $p\in \mathbb{R}^{S}$.
For a quick introduction to Entropy Pooling intuition, watch [this YouTube video](https://youtu.be/qk_5l4ICXfY).
For a collection of Entropy Pooling resources, see this [Substack post](https://antonvorobets.substack.com/p/entropy-pooling-collection).
The original Entropy Pooling approach solves the minimum relative entropy problem
$$q=\underset{x}{\text{argmin}}\lbrace x^{T}\left(\ln x-\ln p\right)\rbrace$$
subject to linear constraints on the posterior probabilities
$$Gx\leq h \quad \text{and} \quad Ax=b.$$
The constraints matrices $A$ and $G$ contain functions of the Monte Carlo
simulation $R$ that allow you to implement subjective views and stress-tests by
changing the joint scenario probabilities from a prior probability vector $p$
to a posterior probability vector $q$.
A useful statistic when working with Entropy Pooling is the effective number of
scenarios introduced by [Meucci (2012)](https://ssrn.com/abstract=1971808).
For a causal Bayesian network overlay on top of Entropy Pooling, see
[Vorobets (2023)](https://ssrn.com/abstract=4444291).
Video walkthroughs
------------------
Video walkthroughs of the two notebook examples are available [here](https://youtu.be/hDt103zEML8)
and [here](https://youtu.be/DK1Pv5tuLgo). The videos give additional insights into
Entropy Pooling theory and its sequential refinements. It is highly recommended
to watch these videos to quickly increase your understanding.
Portfolio Construction and Risk Management Book
-----------------------------------------------
Entropy Pooling is a core part of the next generation investment framework that
also utilizes fully general Monte Carlo distributions and CVaR analysis, see
[this YouTube video](https://youtu.be/4ESigySdGf8?si) for an introduction. To
get a pedagogical and deep presentation of all the possibilities Entropy Pooling
offers, see the [Portfolio Construction and Risk Management Book](https://igg.me/at/pcrm-book).
Raw data
{
"_id": null,
"home_page": "https://fortitudo.tech",
"name": "entropy-pooling",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.13,>=3.9",
"maintainer_email": null,
"keywords": "Entropy Pooling, Quantitative Finance, Monte Carlo, Stress-Testing, CVaR",
"author": "Fortitudo Technologies",
"author_email": "software@fortitudo.tech",
"download_url": "https://files.pythonhosted.org/packages/95/7f/622abb0b223879a7f960008bb2e70b00c0d3cd94e2289b69cbfd6b2ecf87/entropy_pooling-1.0.8.tar.gz",
"platform": null,
"description": "[![pytest](https://github.com/fortitudo-tech/entropy-pooling/actions/workflows/tests.yml/badge.svg)](https://github.com/fortitudo-tech/entropy-pooling/actions/workflows/tests.yml)\n[![codecov](https://codecov.io/gh/fortitudo-tech/entropy-pooling/graph/badge.svg?token=XGIQ78ZLDN)](https://codecov.io/gh/fortitudo-tech/entropy-pooling)\n[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/fortitudo-tech/entropy-pooling/HEAD?labpath=examples)\n\nEntropy Pooling in Python\n=========================\n\nDue to popular demand from developers, this package contains the Entropy Pooling\nimplementation from the [fortitudo.tech Python package](https://github.com/fortitudo-tech/fortitudo.tech)\nwith a more permissive BSD 3-Clause license.\n\nThis package contains only one function called ep and has minimal dependencies\nwith just scipy. See [the examples](https://github.com/fortitudo-tech/entropy-pooling/tree/main/examples)\nfor how you can import and use the ep function.\n\nYou can explore the examples without local installations using\n[Binder](https://mybinder.org/v2/gh/fortitudo-tech/entropy-pooling/HEAD?labpath=examples).\n\nInstallation instructions\n-------------------------\n\nInstallation can be done via pip:\n\n pip install entropy-pooling\n\nTheory\n------\nEntropy Pooling is a powerful method for implementing subjective views and\nperforming stress-tests for fully general Monte Carlo distributions. It was first\nintroduced by [Meucci (2008)](https://ssrn.com/abstract=1213325) and refined\nwith sequential algorithms by [Vorobets (2021)](https://ssrn.com/abstract=3936392).\n\n[You can loosely think about Entropy Pooling as a generalization of the Black-Litterman model](https://antonvorobets.substack.com/p/entropy-pooling-vs-black-litterman-abb608b810cd) without all the oversimplifying assumptions. Entropy Pooling operates directly on \n[the next generation market representation](https://youtu.be/4ESigySdGf8?si=yWYuP9te1K1RBU7j&t=46)\ndefined by the simulation matrix $R\\in \\mathbb{R}^{S\\times I}$ and associated joint\nscenario probability vector $p\\in \\mathbb{R}^{S}$.\n\nFor a quick introduction to Entropy Pooling intuition, watch [this YouTube video](https://youtu.be/qk_5l4ICXfY).\nFor a collection of Entropy Pooling resources, see this [Substack post](https://antonvorobets.substack.com/p/entropy-pooling-collection).\n\nThe original Entropy Pooling approach solves the minimum relative entropy problem\n\n$$q=\\underset{x}{\\text{argmin}}\\lbrace x^{T}\\left(\\ln x-\\ln p\\right)\\rbrace$$\n\nsubject to linear constraints on the posterior probabilities\n\n$$Gx\\leq h \\quad \\text{and} \\quad Ax=b.$$\n\nThe constraints matrices $A$ and $G$ contain functions of the Monte Carlo\nsimulation $R$ that allow you to implement subjective views and stress-tests by\nchanging the joint scenario probabilities from a prior probability vector $p$\nto a posterior probability vector $q$.\n\nA useful statistic when working with Entropy Pooling is the effective number of\nscenarios introduced by [Meucci (2012)](https://ssrn.com/abstract=1971808).\n\nFor a causal Bayesian network overlay on top of Entropy Pooling, see\n[Vorobets (2023)](https://ssrn.com/abstract=4444291).\n\nVideo walkthroughs\n------------------\n\nVideo walkthroughs of the two notebook examples are available [here](https://youtu.be/hDt103zEML8)\nand [here](https://youtu.be/DK1Pv5tuLgo). The videos give additional insights into\nEntropy Pooling theory and its sequential refinements. It is highly recommended\nto watch these videos to quickly increase your understanding.\n\nPortfolio Construction and Risk Management Book\n-----------------------------------------------\n\nEntropy Pooling is a core part of the next generation investment framework that\nalso utilizes fully general Monte Carlo distributions and CVaR analysis, see\n[this YouTube video](https://youtu.be/4ESigySdGf8?si) for an introduction. To\nget a pedagogical and deep presentation of all the possibilities Entropy Pooling\noffers, see the [Portfolio Construction and Risk Management Book](https://igg.me/at/pcrm-book).\n",
"bugtrack_url": null,
"license": "BSD-3-Clause",
"summary": "Entropy Pooling in Python with a BSD 3-Clause license.",
"version": "1.0.8",
"project_urls": {
"Documentation": "https://os.fortitudo.tech",
"Homepage": "https://fortitudo.tech",
"Issues": "https://github.com/fortitudo-tech/entropy-pooling/issues",
"Repository": "https://github.com/fortitudo-tech/entropy-pooling"
},
"split_keywords": [
"entropy pooling",
" quantitative finance",
" monte carlo",
" stress-testing",
" cvar"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b8e95031963e2dde81d9ef1961fb92a7723a90dda9d8a26656cf0b0cac29c9c7",
"md5": "68738f195457b56f533fdf6230e7e5c8",
"sha256": "4d9afd4fc7ed90c37070ae789e9cbfd1cd13c5f850964bd342201573445f44fc"
},
"downloads": -1,
"filename": "entropy_pooling-1.0.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "68738f195457b56f533fdf6230e7e5c8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.9",
"size": 5370,
"upload_time": "2024-10-14T08:09:30",
"upload_time_iso_8601": "2024-10-14T08:09:30.966014Z",
"url": "https://files.pythonhosted.org/packages/b8/e9/5031963e2dde81d9ef1961fb92a7723a90dda9d8a26656cf0b0cac29c9c7/entropy_pooling-1.0.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "957f622abb0b223879a7f960008bb2e70b00c0d3cd94e2289b69cbfd6b2ecf87",
"md5": "a875983948f18a12559bd1c6a2fe743f",
"sha256": "041b52a13c001fa7a5d3fde84cd9b3abdc31d231313a574463322a020103a1b2"
},
"downloads": -1,
"filename": "entropy_pooling-1.0.8.tar.gz",
"has_sig": false,
"md5_digest": "a875983948f18a12559bd1c6a2fe743f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.9",
"size": 5211,
"upload_time": "2024-10-14T08:09:32",
"upload_time_iso_8601": "2024-10-14T08:09:32.096898Z",
"url": "https://files.pythonhosted.org/packages/95/7f/622abb0b223879a7f960008bb2e70b00c0d3cd94e2289b69cbfd6b2ecf87/entropy_pooling-1.0.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-14 08:09:32",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "fortitudo-tech",
"github_project": "entropy-pooling",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "entropy-pooling"
}