BondReplicationRun.java

  1. package org.drip.service.scenario;

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

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

  76. /**
  77.  * <i>BondReplicationRun</i> holds the Results of a Full Bond Replication Run.
  78.  *
  79.  * <br><br>
  80.  *  <ul>
  81.  *      <li><b>Module </b> = <a href = "https://github.com/lakshmiDRIP/DROP/tree/master/ComputationalCore.md">Computational Core Module</a></li>
  82.  *      <li><b>Library</b> = <a href = "https://github.com/lakshmiDRIP/DROP/tree/master/ComputationSupportLibrary.md">Computation Support</a></li>
  83.  *      <li><b>Project</b> = <a href = "https://github.com/lakshmiDRIP/DROP/tree/master/src/main/java/org/drip/service/README.md">Environment, Product/Definition Containers, and Scenario/State Manipulation APIs</a></li>
  84.  *      <li><b>Package</b> = <a href = "https://github.com/lakshmiDRIP/DROP/tree/master/src/main/java/org/drip/service/scenario/README.md">Custom Scenario Service Metric Generator</a></li>
  85.  *  </ul>
  86.  * <br><br>
  87.  *
  88.  * @author Lakshmi Krishnamurthy
  89.  */

  90. public class BondReplicationRun {
  91.     private java.util.Map<java.lang.String, org.drip.service.scenario.NamedField> _mapNF = new
  92.         org.drip.analytics.support.CaseInsensitiveHashMap<org.drip.service.scenario.NamedField>();

  93.     private java.util.Map<java.lang.String, org.drip.service.scenario.NamedFieldMap> _mapNFM = new
  94.         org.drip.analytics.support.CaseInsensitiveHashMap<org.drip.service.scenario.NamedFieldMap>();

  95.     /**
  96.      * Empty ReplicationRun Constructor
  97.      */

  98.     public BondReplicationRun()
  99.     {
  100.     }

  101.     /**
  102.      * Add a Named Field
  103.      *
  104.      * @param nf The Named Field
  105.      *
  106.      * @return TRUE - The Named Field Successfully added
  107.      */

  108.     public boolean addNamedField (
  109.         final org.drip.service.scenario.NamedField nf)
  110.     {
  111.         if (null == nf) return false;

  112.         _mapNF.put (nf.name(), nf);

  113.         return true;
  114.     }

  115.     /**
  116.      * Add a Named Field Map
  117.      *
  118.      * @param nfm The Named Field Map
  119.      *
  120.      * @return TRUE - The Named Field Map Successfully added
  121.      */

  122.     public boolean addNamedFieldMap (
  123.         final org.drip.service.scenario.NamedFieldMap nfm)
  124.     {
  125.         if (null == nfm) return false;

  126.         _mapNFM.put (nfm.name(), nfm);

  127.         return true;
  128.     }

  129.     /**
  130.      * Retrieve the Named Field Metrics
  131.      *
  132.      * @return The Named Field Metrics
  133.      */

  134.     public java.util.Map<java.lang.String, org.drip.service.scenario.NamedField> namedField()
  135.     {
  136.         return _mapNF;
  137.     }

  138.     /**
  139.      * Retrieve the Named Field Map Metrics
  140.      *
  141.      * @return The Named Field Map Metrics
  142.      */

  143.     public java.util.Map<java.lang.String, org.drip.service.scenario.NamedFieldMap> namedFieldMap()
  144.     {
  145.         return _mapNFM;
  146.     }

  147.     /**
  148.      * Generate The Headers
  149.      *
  150.      * @return The Headers
  151.      */

  152.     public java.lang.String header()
  153.     {
  154.         java.lang.String strHeader = "";

  155.         for (java.util.Map.Entry<java.lang.String, org.drip.service.scenario.NamedField> meNF :
  156.             _mapNF.entrySet())
  157.             strHeader = strHeader + meNF.getKey() + ",";

  158.         for (java.util.Map.Entry<java.lang.String, org.drip.service.scenario.NamedFieldMap> meNFM :
  159.             _mapNFM.entrySet()) {
  160.             java.lang.String strNFMKey = meNFM.getKey() + ",";

  161.             org.drip.service.scenario.NamedFieldMap nfm = meNFM.getValue();

  162.             for (java.util.Map.Entry<java.lang.String, java.lang.Double> meNFMEntry : nfm.value().entrySet())
  163.                 strHeader = strHeader + strNFMKey + "::" + meNFMEntry.getKey() + ",";
  164.         }

  165.         return strHeader;
  166.     }

  167.     /**
  168.      * Generate The Values
  169.      *
  170.      * @return The Values
  171.      */

  172.     public java.lang.String value()
  173.     {
  174.         java.lang.String strValue = "";

  175.         for (java.util.Map.Entry<java.lang.String, org.drip.service.scenario.NamedField> meNF :
  176.             _mapNF.entrySet())
  177.             strValue = strValue + meNF.getValue().value() + ",";

  178.         for (java.util.Map.Entry<java.lang.String, org.drip.service.scenario.NamedFieldMap> meNFM :
  179.             _mapNFM.entrySet()) {
  180.             org.drip.service.scenario.NamedFieldMap nfm = meNFM.getValue();

  181.             for (java.util.Map.Entry<java.lang.String, java.lang.Double> meNFMEntry : nfm.value().entrySet())
  182.                 strValue = strValue + meNFMEntry.getValue() + ",";
  183.         }

  184.         return strValue;
  185.     }

  186.     /**
  187.      * Display the Measures
  188.      *
  189.      * @return The Measures
  190.      */

  191.     public java.lang.String display()
  192.     {
  193.         java.lang.String strValue = "";

  194.         for (java.util.Map.Entry<java.lang.String, org.drip.service.scenario.NamedField> meNF :
  195.             _mapNF.entrySet())
  196.             strValue = strValue + meNF.getKey() + " => " + meNF.getValue().value() + "\n";

  197.         for (java.util.Map.Entry<java.lang.String, org.drip.service.scenario.NamedFieldMap> meNFM :
  198.             _mapNFM.entrySet()) {
  199.             org.drip.service.scenario.NamedFieldMap nfm = meNFM.getValue();

  200.             java.lang.String strNFMKey = meNFM.getKey();

  201.             for (java.util.Map.Entry<java.lang.String, java.lang.Double> meNFMEntry : nfm.value().entrySet())
  202.                 strValue = strValue + strNFMKey + "::" + meNFMEntry.getKey() + " => " + meNFMEntry.getValue()
  203.                     + "\n";
  204.         }

  205.         return strValue;
  206.     }
  207. }