TreasuryFuturesClosesReconstitutor.java

  1. package org.drip.feed.transformer;

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

  77. /**
  78.  * <i>TreasuryFuturesClosesReconstitutor</i> transforms the Treasury Futures Closes- Feed Inputs into Formats
  79.  * suitable for Valuation Metrics and Sensitivities Generation.
  80.  *
  81.  *  <br><br>
  82.  *  <ul>
  83.  *      <li><b>Module </b> = <a href = "https://github.com/lakshmiDRIP/DROP/tree/master/ComputationalCore.md">Computational Core Module</a></li>
  84.  *      <li><b>Library</b> = <a href = "https://github.com/lakshmiDRIP/DROP/tree/master/ComputationSupportLibrary.md">Computation Support</a></li>
  85.  *      <li><b>Project</b> = <a href = "https://github.com/lakshmiDRIP/DROP/tree/master/src/main/java/org/drip/feed/README.md">Load, Transform, and compute Target Metrics across Feeds</a></li>
  86.  *      <li><b>Package</b> = <a href = "https://github.com/lakshmiDRIP/DROP/tree/master/src/main/java/org/drip/feed/transformer/README.md">Market Data Reconstitutive Feed Transformer</a></li>
  87.  *  </ul>
  88.  *
  89.  * @author Lakshmi Krishnamurthy
  90.  */

  91. public class TreasuryFuturesClosesReconstitutor {

  92.     /**
  93.      * Regularize the Treasury Feed Closes
  94.      *
  95.      * @param strClosesLocation The Closes Location
  96.      * @param iSpotDateIndex Spot Date Column Index
  97.      * @param iConversionFactorIndex Conversion Factor Column Index
  98.      * @param iCleanPriceIndex Clean Price Column Index
  99.      * @param iCTDCouponIndex CTD Coupon Column Index
  100.      * @param iEffectiveDateIndex Effective Date Column Index
  101.      * @param iMaturityDateIndex Maturity Date Column Index
  102.      * @param iExpiryProxyIndex Expiry Proxy Column Index
  103.      *
  104.      * @return TRUE - The Regularization Successful
  105.      */

  106.     public static final boolean RegularizeCloses (
  107.         final java.lang.String strClosesLocation,
  108.         final int iSpotDateIndex,
  109.         final int iConversionFactorIndex,
  110.         final int iCleanPriceIndex,
  111.         final int iCTDCouponIndex,
  112.         final int iEffectiveDateIndex,
  113.         final int iMaturityDateIndex,
  114.         final int iExpiryProxyIndex)
  115.     {
  116.         org.drip.feed.loader.CSVGrid csvGrid = org.drip.feed.loader.CSVParser.StringGrid (strClosesLocation,
  117.             true);

  118.         if (null == csvGrid) return false;

  119.         org.drip.analytics.date.JulianDate[] adtSpot = csvGrid.dateArrayAtColumn (iSpotDateIndex);

  120.         if (null == adtSpot) return false;

  121.         int iNumClose = adtSpot.length;
  122.         org.drip.analytics.date.JulianDate[] adtExpiry = new org.drip.analytics.date.JulianDate[iNumClose];

  123.         if (0 == iNumClose) return false;

  124.         double[] adblConversionFactor = csvGrid.doubleArrayAtColumn (iConversionFactorIndex);

  125.         if (null == adblConversionFactor || iNumClose != adblConversionFactor.length) return false;

  126.         double[] adblCleanPrice = csvGrid.doubleArrayAtColumn (iCleanPriceIndex, 0.01);

  127.         if (null == adblCleanPrice || iNumClose != adblCleanPrice.length) return false;

  128.         double[] adblCoupon = csvGrid.doubleArrayAtColumn (iCTDCouponIndex, 0.01);

  129.         if (null == adblCoupon || iNumClose != adblCoupon.length) return false;

  130.         org.drip.analytics.date.JulianDate[] adtEffective = csvGrid.dateArrayAtColumn (iEffectiveDateIndex);

  131.         if (null == adtEffective || iNumClose != adtEffective.length) return false;

  132.         org.drip.analytics.date.JulianDate[] adtMaturity = csvGrid.dateArrayAtColumn (iMaturityDateIndex);

  133.         if (null == adtMaturity || iNumClose != adtMaturity.length) return false;

  134.         org.drip.analytics.date.JulianDate[] adtExpiryProxy = csvGrid.dateArrayAtColumn (iExpiryProxyIndex);

  135.         if (null == adtExpiryProxy || iNumClose != adtExpiryProxy.length) return false;

  136.         try {
  137.             for (int i = 0; i < iNumClose; ++i) {
  138.                 if (null == adtExpiryProxy[i]) return false;

  139.                 int iExpiryProxyDate = adtExpiryProxy[i].julian();

  140.                 int iMonth = org.drip.analytics.date.DateUtil.Month (iExpiryProxyDate);

  141.                 int iYear = 2000 + org.drip.analytics.date.DateUtil.Date (iExpiryProxyDate);

  142.                 if (null == (adtExpiry[i] = org.drip.analytics.date.DateUtil.CreateFromYMD (iYear, iMonth,
  143.                     org.drip.analytics.date.DateUtil.DaysInMonth (iMonth, iYear))))
  144.                     return false;
  145.             }
  146.         } catch (java.lang.Exception e) {
  147.             e.printStackTrace();

  148.             return false;
  149.         }

  150.         System.out.println
  151.             ("CloseDate,ConversionFactor,CTDPrice,CTDCoupon,CTDEffective,CTDMaturity,FuturesExpiry");

  152.         for (int i = 0; i < iNumClose; ++i)
  153.             System.out.println (adtSpot[i] + "," + adblConversionFactor[i] + "," + adblCleanPrice[i] + "," +
  154.                 adblCoupon[i] + "," + adtEffective[i] + "," + adtMaturity[i] + "," + adtExpiry[i]);

  155.         return true;
  156.     }

  157.     /**
  158.      * Regularize the UST Futures Closes Feed
  159.      *
  160.      * @param strClosesLocation The UST Futures Closes Feed Location
  161.      *
  162.      * @return TRUE - Regularization Successful
  163.      */

  164.     public static final boolean USTRegularizeCloses (
  165.         final java.lang.String strClosesLocation)
  166.     {
  167.         return RegularizeCloses (strClosesLocation, 0, 1, 4, 9, 10, 8, 13);
  168.     }
  169. }