BurgardKjaerEdgeRun.java

  1. package org.drip.xva.pde;

  3. /*
  4.  * -*- mode: java; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*-
  5.  */

  7. /*!
  8.  * Copyright (C) 2020 Lakshmi Krishnamurthy
  9.  * Copyright (C) 2019 Lakshmi Krishnamurthy
  10.  * Copyright (C) 2018 Lakshmi Krishnamurthy
  11.  * Copyright (C) 2017 Lakshmi Krishnamurthy
  12.  * 
  13.  *  This file is part of DROP, an open-source library targeting analytics/risk, transaction cost analytics,
  14.  *      asset liability management analytics, capital, exposure, and margin analytics, valuation adjustment
  15.  *      analytics, and portfolio construction analytics within and across fixed income, credit, commodity,
  16.  *      equity, FX, and structured products. It also includes auxiliary libraries for algorithm support,
  17.  *      numerical analysis, numerical optimization, spline builder, model validation, statistical learning,
  18.  *      and computational support.
  19.  *  
  20.  *      https://lakshmidrip.github.io/DROP/
  21.  *  
  22.  *  DROP is composed of three modules:
  23.  *  
  24.  *  - DROP Product Core - https://lakshmidrip.github.io/DROP-Product-Core/
  25.  *  - DROP Portfolio Core - https://lakshmidrip.github.io/DROP-Portfolio-Core/
  26.  *  - DROP Computational Core - https://lakshmidrip.github.io/DROP-Computational-Core/
  27.  * 
  28.  *  DROP Product Core implements libraries for the following:
  29.  *  - Fixed Income Analytics
  30.  *  - Loan Analytics
  31.  *  - Transaction Cost Analytics
  32.  * 
  33.  *  DROP Portfolio Core implements libraries for the following:
  34.  *  - Asset Allocation Analytics
  35.  *  - Asset Liability Management Analytics
  36.  *  - Capital Estimation Analytics
  37.  *  - Exposure Analytics
  38.  *  - Margin Analytics
  39.  *  - XVA Analytics
  40.  * 
  41.  *  DROP Computational Core implements libraries for the following:
  42.  *  - Algorithm Support
  43.  *  - Computation Support
  44.  *  - Function Analysis
  45.  *  - Model Validation
  46.  *  - Numerical Analysis
  47.  *  - Numerical Optimizer
  48.  *  - Spline Builder
  49.  *  - Statistical Learning
  50.  * 
  51.  *  Documentation for DROP is Spread Over:
  52.  * 
  53.  *  - Main                     => https://lakshmidrip.github.io/DROP/
  54.  *  - Wiki                     => https://github.com/lakshmiDRIP/DROP/wiki
  55.  *  - GitHub                   => https://github.com/lakshmiDRIP/DROP
  56.  *  - Repo Layout Taxonomy     => https://github.com/lakshmiDRIP/DROP/blob/master/Taxonomy.md
  57.  *  - Javadoc                  => https://lakshmidrip.github.io/DROP/Javadoc/index.html
  58.  *  - Technical Specifications => https://github.com/lakshmiDRIP/DROP/tree/master/Docs/Internal
  59.  *  - Release Versions         => https://lakshmidrip.github.io/DROP/version.html
  60.  *  - Community Credits        => https://lakshmidrip.github.io/DROP/credits.html
  61.  *  - Issues Catalog           => https://github.com/lakshmiDRIP/DROP/issues
  62.  *  - JUnit                    => https://lakshmidrip.github.io/DROP/junit/index.html
  63.  *  - Jacoco                   => https://lakshmidrip.github.io/DROP/jacoco/index.html
  64.  * 
  65.  *  Licensed under the Apache License, Version 2.0 (the "License");
  66.  *      you may not use this file except in compliance with the License.
  67.  *   
  68.  *  You may obtain a copy of the License at
  69.  *      http://www.apache.org/licenses/LICENSE-2.0
  70.  *  
  71.  *  Unless required by applicable law or agreed to in writing, software
  72.  *      distributed under the License is distributed on an "AS IS" BASIS,
  73.  *      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  74.  *  
  75.  *  See the License for the specific language governing permissions and
  76.  *      limitations under the License.
  77.  */

  79. /**
  80.  * <i>BurgardKjaerEdgeRun</i> collects the Results of the Burgard Kjaer PDE based on the Risk-Neutral Ito
  81.  * Evolution of the Derivative, as laid out in Burgard and Kjaer (2014). The References are:
  82.  *
  83.  *  <br><br>
  84.  *  <ul>
  85.  *      <li>
  86.  *          Burgard, C., and M. Kjaer (2014): PDE Representations of Derivatives with Bilateral Counter-party
  87.  *              Risk and Funding Costs <i>Journal of Credit Risk</i> <b>7 (3)</b> 1-19
  88.  *      </li>
  89.  *      <li>
  90.  *          Cesari, G., J. Aquilina, N. Charpillon, X. Filipovic, G. Lee, and L. Manda (2009): <i>Modeling,
  91.  *              Pricing, and Hedging Counter-party Credit Exposure - A Technical Guide</i> <b>Springer
  92.  *              Finance</b> New York
  93.  *      </li>
  94.  *      <li>
  95.  *          Gregory, J. (2009): Being Two-faced over Counter-party Credit Risk <i>Risk</i> <b>20 (2)</b>
  96.  *              86-90
  97.  *      </li>
  98.  *      <li>
  99.  *          Li, B., and Y. Tang (2007): <i>Quantitative Analysis, Derivatives Modeling, and Trading
  100.  *              Strategies in the Presence of Counter-party Credit Risk for the Fixed Income Market</i>
  101.  *              <b>World Scientific Publishing</b> Singapore
  102.  *      </li>
  103.  *      <li>
  104.  *          Piterbarg, V. (2010): Funding Beyond Discounting: Collateral Agreements and Derivatives Pricing
  105.  *              <i>Risk</i> <b>21 (2)</b> 97-102
  106.  *      </li>
  107.  *  </ul>
  108.  *
  109.  *  <br><br>
  110.  *  <ul>
  111.  *      <li><b>Module </b> = <a href = "https://github.com/lakshmiDRIP/DROP/tree/master/PortfolioCore.md">Portfolio Core Module</a></li>
  112.  *      <li><b>Library</b> = <a href = "https://github.com/lakshmiDRIP/DROP/tree/master/XVAAnalyticsLibrary.md">XVA Analytics Library</a></li>
  113.  *      <li><b>Project</b> = <a href = "https://github.com/lakshmiDRIP/DROP/tree/master/src/main/java/org/drip/xva/README.md">Valuation Adjustments that account for Collateral, CC Credit/Debt and Funding Overhead</a></li>
  114.  *      <li><b>Package</b> = <a href = "https://github.com/lakshmiDRIP/DROP/tree/master/src/main/java/org/drip/xva/pde/README.md">Burgard Kjaer PDE Evolution Scheme</a></li>
  115.  *  </ul>
  116.  * <br><br>
  117.  * 
  118.  * @author Lakshmi Krishnamurthy
  119.  */

  121. public class BurgardKjaerEdgeRun extends org.drip.xva.pde.BurgardKjaerEdge
  122. {
  123.     private double _derivativeXVAFundingGrowth = java.lang.Double.NaN;
  124.     private double _derivativeXVAHedgeErrorGrowth = java.lang.Double.NaN;
  125.     private double _derivativeXVAClientDefaultGrowth = java.lang.Double.NaN;
  126.     private double _derivativeXVADealerDefaultGrowth = java.lang.Double.NaN;

  128.     /**
  129.      * BurgardKjaerEdgeRun Constructor
  130.      * 
  131.      * @param dblPositionValueBump The Bump in the Position Value
  132.      * @param derivativeXVAStochasticGrowthDown The Stochastic Down Component of the Derivative XVA Value
  133.      *      Growth
  134.      * @param derivativeXVAStochasticGrowth The Stochastic Component of the Derivative XVA Value Growth
  135.      * @param derivativeXVAStochasticGrowthUp The Stochastic Up Component of the Derivative XVA Value
  136.      *      Growth
  137.      * @param derivativeXVACollateralGrowth The Collateral Component of the Derivative XVA Value Growth
  138.      * @param derivativeXVAFundingGrowth The Funding Component of the Derivative XVA Value Growth
  139.      * @param derivativeXVADealerDefaultGrowth The Dealer Default Component of the Derivative XVA Value
  140.      *      Growth
  141.      * @param derivativeXVAClientDefaultGrowth The Client Default Component of the Derivative XVA Value
  142.      *      Growth
  143.      * @param derivativeXVAHedgeErrorGrowth The Hedge Error Component of the Derivaitve XVA Growth
  144.      * 
  145.      * @throws java.lang.Exception Thrown if the Inputs are Invalid
  146.      */

  148.     public BurgardKjaerEdgeRun (
  149.         final double dblPositionValueBump,
  150.         final double derivativeXVAStochasticGrowthDown,
  151.         final double derivativeXVAStochasticGrowth,
  152.         final double derivativeXVAStochasticGrowthUp,
  153.         final double derivativeXVACollateralGrowth,
  154.         final double derivativeXVAFundingGrowth,
  155.         final double derivativeXVADealerDefaultGrowth,
  156.         final double derivativeXVAClientDefaultGrowth,
  157.         final double derivativeXVAHedgeErrorGrowth)
  158.         throws java.lang.Exception
  159.     {
  160.         super (
  161.             dblPositionValueBump,
  162.             derivativeXVAStochasticGrowthDown,
  163.             derivativeXVAStochasticGrowth,
  164.             derivativeXVAStochasticGrowthUp,
  165.             derivativeXVACollateralGrowth
  166.         );

  168.         if (!org.drip.numerical.common.NumberUtil.IsValid (_derivativeXVAFundingGrowth =
  169.                 derivativeXVAFundingGrowth) ||
  170.             !org.drip.numerical.common.NumberUtil.IsValid (_derivativeXVADealerDefaultGrowth =
  171.                 derivativeXVADealerDefaultGrowth) ||
  172.             !org.drip.numerical.common.NumberUtil.IsValid (_derivativeXVAClientDefaultGrowth =
  173.                 derivativeXVAClientDefaultGrowth) ||
  174.             !org.drip.numerical.common.NumberUtil.IsValid (_derivativeXVAHedgeErrorGrowth =
  175.                 derivativeXVAHedgeErrorGrowth))
  176.         {
  177.             throw new java.lang.Exception ("BurgardKjaerEdgeRun Constructor => Invalid Inputs");
  178.         }
  179.     }

  181.     /**
  182.      * Retrieve the Hedge Error Component of the Derivative XVA Value Growth
  183.      * 
  184.      * @return The Hedge Error Component of the Derivative XVA Value Growth
  185.      */

  187.     public double derivativeXVAHedgeErrorGrowth()
  188.     {
  189.         return _derivativeXVAHedgeErrorGrowth;
  190.     }

  192.     /**
  193.      * Retrieve the Funding Component of the Derivative XVA Value Growth
  194.      * 
  195.      * @return The Funding Component of the Derivative XVA Value Growth
  196.      */

  198.     public double derivativeXVAFundingGrowth()
  199.     {
  200.         return _derivativeXVAFundingGrowth;
  201.     }

  203.     /**
  204.      * Retrieve the Dealer Default Component of the Derivative XVA Value Growth
  205.      * 
  206.      * @return The Dealer Default Component of the Derivative XVA Value Growth
  207.      */

  209.     public double derivativeXVADealerDefaultGrowth()
  210.     {
  211.         return _derivativeXVADealerDefaultGrowth;
  212.     }

  214.     /**
  215.      * Retrieve the Client Default Component of the Derivative XVA Value Growth
  216.      * 
  217.      * @return The Client Default Component of the Derivative XVA Value Growth
  218.      */

  220.     public double derivativeXVAClientDefaultGrowth()
  221.     {
  222.         return _derivativeXVAClientDefaultGrowth;
  223.     }

  225.     @Override public double thetaPositionValueDown()
  226.     {
  227.         return super.derivativeXVAStochasticGrowthDown() + super.derivativeXVACollateralGrowth() +
  228.             _derivativeXVAFundingGrowth + _derivativeXVADealerDefaultGrowth +
  229.                 _derivativeXVAClientDefaultGrowth + _derivativeXVAHedgeErrorGrowth;
  230.     }

  232.     @Override public double theta()
  233.     {
  234.         return super.derivativeXVAStochasticGrowth() + super.derivativeXVACollateralGrowth() +
  235.             _derivativeXVAFundingGrowth + _derivativeXVADealerDefaultGrowth +
  236.                 _derivativeXVAClientDefaultGrowth + _derivativeXVAHedgeErrorGrowth;
  237.     }

  239.     @Override public double thetaPositionValueUp()
  240.     {
  241.         return super.derivativeXVAStochasticGrowthUp() + super.derivativeXVACollateralGrowth() +
  242.             _derivativeXVAFundingGrowth + _derivativeXVADealerDefaultGrowth +
  243.                 _derivativeXVAClientDefaultGrowth + _derivativeXVAHedgeErrorGrowth;
  244.     }
  245. }
Created with JaCoCo 0.7.9.201702052155