From d3419f1599f73b6e4e6cc5845db5e1791859caf8 Mon Sep 17 00:00:00 2001 From: Adrian Gao Date: Tue, 4 Jul 2023 11:45:36 +1000 Subject: [PATCH] Fix broken img link and update readme --- README.md | 55 ++++++++++++++++--- docs/measures/modified_default_probability.md | 10 ++-- 2 files changed, 53 insertions(+), 12 deletions(-) diff --git a/README.md b/README.md index f4048014..58de73b7 100644 --- a/README.md +++ b/README.md @@ -22,13 +22,14 @@ If there's any issue (likely), please contact me at [mingze.gao@sydney.edu.au](m More to be added. For a complete list of supported built-in measures, please check [frds.io/measures/](https://frds.io/measures/). -* [Absorption Ratio](https://frds.io/measures/absorption_ratio/) -* [Contingent Claim Analysis](https://frds.io/measures/contingent_claim_analysis/) -* [Distress Insurance Premium](https://frds.io/measures/distress_insurance_premium/) -* [Long-Run MES](https://frds.io/measures/long_run_mes/) -* [Marginal Expected Shortfall (MES)](https://frds.io/measures/marginal_expected_shortfall/) -* [SRISK](https://frds.io/measures/srisk/) -* [Systemic Expected Shortfall (SES)](https://frds.io/measures/systemic_expected_shortfall/) +* [Absorption Ratio](https://frds.io/measures/absorption_ratio/) in Kritzman, Li, Page, and Rigobon (2010). +* [Contingent Claim Analysis](https://frds.io/measures/contingent_claim_analysis/) in Gray and Jobst (2010). +* [Distress Insurance Premium](https://frds.io/measures/distress_insurance_premium/) in Huang, Zhou, and Zhu (2009). +* [Long-Run MES](https://frds.io/measures/long_run_mes/) in Brownlees and Engle (2017). +* [Marginal Expected Shortfall (MES)](https://frds.io/measures/marginal_expected_shortfall/) in Acharya, Pedersen, Philippon, and Richardson (2010). +* [Modified Default Probability](https://frds.io/measures/modified_default_probability/) in Nagel and Purnanandam (2020) +* [SRISK](https://frds.io/measures/srisk/) in Brownlees and Engle (2017). +* [Systemic Expected Shortfall (SES)](https://frds.io/measures/systemic_expected_shortfall/) in Acharya, Pedersen, Philippon, and Richardson (2010). * [Z-score](https://frds.io/measures/z_score) @@ -36,6 +37,8 @@ More to be added. For a complete list of supported built-in measures, please che The primary purpose of `frds` is to offer ready-to-use functions. +### Absorption Ratio + For example, Kritzman, Li, Page, and Rigobon (2010) propose an [Absorption Ratio](https://frds.io/measures/absorption_ratio/) that measures the fraction of the total variance of a set of asset returns explained or absorbed by a fixed number of eigenvectors. It captures the extent to which markets are unified or tightly coupled. ``` python @@ -52,6 +55,8 @@ For example, Kritzman, Li, Page, and Rigobon (2010) propose an [Absorption Ratio 0.7746543307660252 ``` +### Distress Insurance Premium + Another example, [Distress Insurance Premium (DIP)](https://frds.io/measures/distress_insurance_premium/) proposed by Huang, Zhou, and Zhu (2009) as a systemic risk measure of a hypothetical insurance premium against a systemic financial distress, defined as total losses that exceed a given threshold, say 15%, of total bank liabilities. ``` python @@ -71,3 +76,39 @@ Another example, [Distress Insurance Premium (DIP)](https://frds.io/measures/dis >>> distress_insurance_premium.estimate(default_probabilities, correlations) 0.28661995758 ``` + +### Modified Default Probability (bank) + +More examples. [Nagel and Purnanandam (2020)](https://doi.org/10.1093/rfs/hhz125) introduce the Modified Default Probability for banks. Banks' assets are contingent claims on borrowers' collateral assets, hence banks' equity and debt are contingent claims on these contingent claims. While borrowers' assets value may follow a lognormal distribution, banks' assets do not. + +Below is a one-liner replication of the simulations. + +```python +>>> from frds.measures.modified_merton import mod_merton_simulation +>>> mod_merton_simulation.simulate() +---------------------------------------------------------------------------- + Borrower asset value + ---------------------------------------- + No shock +ve shock -ve shock +---------------------------------------------------------------------------- +A. True properties +Agg. Borrower Asset Value 1.06 1.33 0.85 +Bank Asset Value 0.74 0.79 0.67 +Bank Market Equity/Market Assets 0.12 0.16 0.07 +Bank 5Y RN Default Prob. 0.23 0.11 0.49 +Bank Credit Spread (%) 0.50 0.19 1.37 +---------------------------------------------------------------------------- +B. Misspecified estimates based on standard Merton model +Merton 5Y RN Default Prob. 0.13 0.01 0.58 +Merton Credit Spread (%) 0.12 0.00 1.54 +---------------------------------------------------------------------------- +``` + +These results are largely the same as Table 1 in Nagel and Purnanandam (2020). Additionally, several plots will be saved in the working directory, e.g., Figure 2: + +![figure2](https://github.com/mgao6767/frds/blob/main/docs/images/NagelPurnanandam2020/figure2_PayoffsAtDMat.png?raw=true) + +And another sample output, Figure 4: + +![figure4](https://github.com/mgao6767/frds/blob/main/docs/images/NagelPurnanandam2020/figure4_mdef.png?raw=true) + diff --git a/docs/measures/modified_default_probability.md b/docs/measures/modified_default_probability.md index 07d647fa..40e55a45 100644 --- a/docs/measures/modified_default_probability.md +++ b/docs/measures/modified_default_probability.md @@ -23,21 +23,21 @@ The following figures are produced in by running `frds.measures.modified_merton. ### Figure 2 -![figure2](https://github.com/mgao6767/frds/blob/main/docs/images/NagelPurnanandam2020/figure2_PayoffsAtDMat.png) +![figure2](https://github.com/mgao6767/frds/blob/main/docs/images/NagelPurnanandam2020/figure2_PayoffsAtDMat.png?raw=true) ### Figure 3 -![figure3](https://github.com/mgao6767/frds/blob/main/docs/images/NagelPurnanandam2020/figure3_mVe.png) +![figure3](https://github.com/mgao6767/frds/blob/main/docs/images/NagelPurnanandam2020/figure3_mVe.png?raw=true) ### Figure 4 -![figure4](https://github.com/mgao6767/frds/blob/main/docs/images/NagelPurnanandam2020/figure4_mdef.png) +![figure4](https://github.com/mgao6767/frds/blob/main/docs/images/NagelPurnanandam2020/figure4_mdef.png?raw=true) ### Figure 5 -![figure5_panel_a](https://github.com/mgao6767/frds/blob/main/docs/images/NagelPurnanandam2020/figure5_panel_a_mdefsingles.png) +![figure5_panel_a](https://github.com/mgao6767/frds/blob/main/docs/images/NagelPurnanandam2020/figure5_panel_a_mdefsingles.png?raw=true) -![figure5_panel_b](https://github.com/mgao6767/frds/blob/main/docs/images/NagelPurnanandam2020/figure5_panel_b_mertalt.png) +![figure5_panel_b](https://github.com/mgao6767/frds/blob/main/docs/images/NagelPurnanandam2020/figure5_panel_b_mertalt.png?raw=true) ## TODO