BulletCorporate6.java
package org.drip.sample.bondfixed;
import java.util.Map;
import org.drip.analytics.date.*;
import org.drip.analytics.output.BondRVMeasures;
import org.drip.analytics.support.Helper;
import org.drip.numerical.common.FormatUtil;
import org.drip.param.creator.MarketParamsBuilder;
import org.drip.param.market.CurveSurfaceQuoteContainer;
import org.drip.param.quote.*;
import org.drip.param.valuation.*;
import org.drip.product.creator.BondBuilder;
import org.drip.product.credit.BondComponent;
import org.drip.product.definition.*;
import org.drip.service.env.EnvManager;
import org.drip.service.template.*;
import org.drip.state.discount.MergedDiscountForwardCurve;
import org.drip.state.govvie.GovvieCurve;
/*
* -*- mode: java; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*-
*/
/*!
* Copyright (C) 2020 Lakshmi Krishnamurthy
* Copyright (C) 2019 Lakshmi Krishnamurthy
* Copyright (C) 2018 Lakshmi Krishnamurthy
* Copyright (C) 2017 Lakshmi Krishnamurthy
*
* This file is part of DROP, an open-source library targeting analytics/risk, transaction cost analytics,
* asset liability management analytics, capital, exposure, and margin analytics, valuation adjustment
* analytics, and portfolio construction analytics within and across fixed income, credit, commodity,
* equity, FX, and structured products. It also includes auxiliary libraries for algorithm support,
* numerical analysis, numerical optimization, spline builder, model validation, statistical learning,
* and computational support.
*
* https://lakshmidrip.github.io/DROP/
*
* DROP is composed of three modules:
*
* - DROP Product Core - https://lakshmidrip.github.io/DROP-Product-Core/
* - DROP Portfolio Core - https://lakshmidrip.github.io/DROP-Portfolio-Core/
* - DROP Computational Core - https://lakshmidrip.github.io/DROP-Computational-Core/
*
* DROP Product Core implements libraries for the following:
* - Fixed Income Analytics
* - Loan Analytics
* - Transaction Cost Analytics
*
* DROP Portfolio Core implements libraries for the following:
* - Asset Allocation Analytics
* - Asset Liability Management Analytics
* - Capital Estimation Analytics
* - Exposure Analytics
* - Margin Analytics
* - XVA Analytics
*
* DROP Computational Core implements libraries for the following:
* - Algorithm Support
* - Computation Support
* - Function Analysis
* - Model Validation
* - Numerical Analysis
* - Numerical Optimizer
* - Spline Builder
* - Statistical Learning
*
* Documentation for DROP is Spread Over:
*
* - Main => https://lakshmidrip.github.io/DROP/
* - Wiki => https://github.com/lakshmiDRIP/DROP/wiki
* - GitHub => https://github.com/lakshmiDRIP/DROP
* - Repo Layout Taxonomy => https://github.com/lakshmiDRIP/DROP/blob/master/Taxonomy.md
* - Javadoc => https://lakshmidrip.github.io/DROP/Javadoc/index.html
* - Technical Specifications => https://github.com/lakshmiDRIP/DROP/tree/master/Docs/Internal
* - Release Versions => https://lakshmidrip.github.io/DROP/version.html
* - Community Credits => https://lakshmidrip.github.io/DROP/credits.html
* - Issues Catalog => https://github.com/lakshmiDRIP/DROP/issues
* - JUnit => https://lakshmidrip.github.io/DROP/junit/index.html
* - Jacoco => https://lakshmidrip.github.io/DROP/jacoco/index.html
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
*
* You may obtain a copy of the License at
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
*
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* <i>BulletCorporate6</i> demonstrates Non-EOS Fixed Coupon Corporate Bond Pricing and Relative Value
* Measure Generation Functionality.
*
* <br><br>
* <ul>
* <li><b>Module </b> = <a href = "https://github.com/lakshmiDRIP/DROP/tree/master/ProductCore.md">Product Core Module</a></li>
* <li><b>Library</b> = <a href = "https://github.com/lakshmiDRIP/DROP/tree/master/FixedIncomeAnalyticsLibrary.md">Fixed Income Analytics</a></li>
* <li><b>Project</b> = <a href = "https://github.com/lakshmiDRIP/DROP/tree/master/src/main/java/org/drip/sample/README.md">DROP API Construction and Usage</a></li>
* <li><b>Package</b> = <a href = "https://github.com/lakshmiDRIP/DROP/tree/master/src/main/java/org/drip/sample/bondfixed/README.md">Fixed Coupon Agency/Corporate Bonds</a></li>
* </ul>
* <br><br>
*
* @author Lakshmi Krishnamurthy
*/
public class BulletCorporate6 {
private static final MergedDiscountForwardCurve FundingCurve (
final JulianDate dtSpot,
final String strCurrency)
throws Exception
{
String[] astrDepositMaturityTenor = new String[] {
"2D"
};
double[] adblDepositQuote = new double[] {
0.0103456 // 2D
};
double[] adblFuturesQuote = new double[] {
0.01070,
0.01235,
0.01360
};
String[] astrFixFloatMaturityTenor = new String[] {
"01Y",
"02Y",
"03Y",
"04Y",
"05Y",
"06Y",
"07Y",
"08Y",
"09Y",
"10Y",
"11Y",
"12Y",
"15Y",
"20Y",
"25Y",
"30Y",
"40Y",
"50Y"
};
double[] adblFixFloatQuote = new double[] {
0.012484, // 1Y
0.014987, // 2Y
0.017036, // 3Y
0.018624, // 4Y
0.019868, // 5Y
0.020921, // 6Y
0.021788, // 7Y
0.022530, // 8Y
0.023145, // 9Y
0.023685, // 10Y
0.024153, // 11Y
0.024562, // 12Y
0.025389, // 15Y
0.026118, // 20Y
0.026368, // 25Y
0.026432, // 30Y
0.026339, // 40Y
0.026122 // 50Y
};
MergedDiscountForwardCurve dcFunding = LatentMarketStateBuilder.SmoothFundingCurve (
dtSpot,
strCurrency,
astrDepositMaturityTenor,
adblDepositQuote,
"ForwardRate",
adblFuturesQuote,
"ForwardRate",
astrFixFloatMaturityTenor,
adblFixFloatQuote,
"SwapRate"
);
Component[] aDepositComp = OTCInstrumentBuilder.FundingDeposit (
dtSpot,
strCurrency,
astrDepositMaturityTenor
);
Component[] aFuturesComp = ExchangeInstrumentBuilder.ForwardRateFuturesPack (
dtSpot,
adblFuturesQuote.length,
strCurrency
);
Component[] aFixFloatComp = OTCInstrumentBuilder.FixFloatStandard (
dtSpot,
strCurrency,
"ALL",
astrFixFloatMaturityTenor,
"MAIN",
0.
);
ValuationParams valParams = new ValuationParams (
dtSpot,
dtSpot,
strCurrency
);
CurveSurfaceQuoteContainer csqc = MarketParamsBuilder.Create (
dcFunding,
null,
null,
null,
null,
null,
null
);
System.out.println();
System.out.println ("\t|-------------------------------------||");
System.out.println ("\t| DEPOSIT INPUT vs. CALC ||");
System.out.println ("\t|-------------------------------------||");
for (int i = 0; i < aDepositComp.length; ++i)
System.out.println ("\t| [" + aDepositComp[i].maturityDate() + "] =" +
FormatUtil.FormatDouble (aDepositComp[i].measureValue (
valParams,
null,
csqc,
null,
"ForwardRate"
), 1, 6, 1.) + " |" +
FormatUtil.FormatDouble (adblDepositQuote[i], 1, 6, 1.) + " ||"
);
System.out.println ("\t|-------------------------------------||");
System.out.println();
System.out.println ("\t|-------------------------------------||");
System.out.println ("\t| FUTURES INPUT vs. CALC ||");
System.out.println ("\t|-------------------------------------||");
for (int i = 0; i < aFuturesComp.length; ++i)
System.out.println ("\t| [" + aFuturesComp[i].maturityDate() + "] =" +
FormatUtil.FormatDouble (aFuturesComp[i].measureValue (
valParams,
null,
csqc,
null,
"ForwardRate"
), 1, 6, 1.) + " |" +
FormatUtil.FormatDouble (adblFuturesQuote[i], 1, 6, 1.) + " ||"
);
System.out.println ("\t|-------------------------------------||");
System.out.println();
System.out.println ("\t|------------------------------------------------|| ");
System.out.println ("\t| FIX-FLOAT INPUTS vs CALIB ||");
System.out.println ("\t|------------------------------------------------|| ");
for (int i = 0; i < aFixFloatComp.length; ++i)
System.out.println ("\t| [" + aFixFloatComp[i].maturityDate() + "] =" +
FormatUtil.FormatDouble (aFixFloatComp[i].measureValue (
valParams,
null,
csqc,
null,
"CalibSwapRate"
), 1, 6, 1.) + " |" +
FormatUtil.FormatDouble (adblFixFloatQuote[i], 1, 6, 1.) + " |" +
FormatUtil.FormatDouble (aFixFloatComp[i].measureValue (
valParams,
null,
csqc,
null,
"FairPremium"
), 1, 6, 1.) + " ||"
);
System.out.println ("\t|------------------------------------------------||");
System.out.println();
return dcFunding;
}
private static final Map<String, GovvieCurve> GovvieCurve (
final JulianDate dtSpot,
final String strCode,
final double[] adblCoupon,
final double[] adblYield)
throws Exception
{
JulianDate[] adtEffective = new JulianDate[] {
dtSpot,
dtSpot,
dtSpot,
dtSpot,
dtSpot,
dtSpot,
dtSpot,
dtSpot
};
JulianDate[] adtMaturity = new JulianDate[] {
dtSpot.addTenor ("1Y"),
dtSpot.addTenor ("2Y"),
dtSpot.addTenor ("3Y"),
dtSpot.addTenor ("5Y"),
dtSpot.addTenor ("7Y"),
dtSpot.addTenor ("10Y"),
dtSpot.addTenor ("20Y"),
dtSpot.addTenor ("30Y")
};
Map<String, GovvieCurve> mapGovvieCurve = LatentMarketStateBuilder.BumpedGovvieCurve (
strCode,
dtSpot,
adtEffective,
adtMaturity,
adblCoupon,
adblYield,
"Yield",
LatentMarketStateBuilder.SHAPE_PRESERVING,
0.0001,
false
);
BondComponent[] aComp = TreasuryBuilder.FromCode (
strCode,
adtEffective,
adtMaturity,
adblCoupon
);
ValuationParams valParams = ValuationParams.Spot (dtSpot.julian());
CurveSurfaceQuoteContainer csqc = new CurveSurfaceQuoteContainer();
csqc.setGovvieState (mapGovvieCurve.get ("BASE"));
System.out.println();
System.out.println ("\t|-------------------------------------------||");
System.out.println ("\t| TREASURY INPUT vs CALIB YIELD ||");
System.out.println ("\t|-------------------------------------------||");
for (int i = 0; i < aComp.length; ++i)
System.out.println ("\t| " + aComp[i].name() + " | " +
FormatUtil.FormatDouble (adblYield[i], 1, 3, 100.) + "% | " +
FormatUtil.FormatDouble (aComp[i].yieldFromPrice (
valParams,
null,
null,
aComp[i].maturityDate().julian(),
1.,
aComp[i].priceFromYield (
valParams,
null,
null,
mapGovvieCurve.get ("BASE").yield (aComp[i].maturityDate().julian())
)
), 1, 3, 100.) + "% ||"
);
System.out.println ("\t|-------------------------------------------||");
return mapGovvieCurve;
}
private static final void AccumulateBondMarketQuote (
final CurveSurfaceQuoteContainer csqc,
final String[] astrOnTheRunCode,
final double[] adblYield)
throws Exception
{
for (int i = 0; i < astrOnTheRunCode.length; ++i) {
ProductMultiMeasure pmmq = new ProductMultiMeasure();
pmmq.addQuote (
"Yield",
new MultiSided (
"mid",
adblYield[i]
),
true
);
csqc.setProductQuote (
astrOnTheRunCode[i],
pmmq
);
}
}
private static final Bond Corporate (
final String strName,
final JulianDate dtEffective,
final JulianDate dtMaturity,
final double dblCoupon,
final int iFreq,
final String strDayCount)
throws Exception
{
return BondBuilder.CreateSimpleFixed (
strName + FormatUtil.FormatDouble (dblCoupon, 1, 4, 100.) + " " + dtMaturity,
"USD",
"",
dblCoupon,
iFreq,
strDayCount,
dtEffective,
dtMaturity,
null,
null
);
}
private static final double[] RVMeasures (
final Bond[] aBond,
final JulianDate dtValue,
final CurveSurfaceQuoteContainer csqc,
final double[] adblCleanPrice)
throws Exception
{
JulianDate dtSettle = dtValue.addBusDays (
3,
aBond[0].currency()
);
ValuationParams valParams = new ValuationParams (
dtValue,
dtSettle,
aBond[0].currency()
);
System.out.println();
System.out.println ("\t|--------------------------------||");
System.out.println ("\t| Trade Date : " + dtValue + " ||");
System.out.println ("\t| Cash Settle Date : " + dtSettle + " ||");
System.out.println ("\t|--------------------------------||");
System.out.println();
String strCurveMetrics = "";
String strSecularMetrics = "";
double[] adblOAS = new double[aBond.length];
for (int i = 0; i < aBond.length; ++i) {
System.out.println ("Doing " + aBond[i].name());
WorkoutInfo wi = aBond[i].exerciseYieldFromPrice (
valParams,
csqc,
null,
adblCleanPrice[i]
);
BondRVMeasures rvm = aBond[i].standardMeasures (
valParams,
null,
csqc,
null,
wi,
adblCleanPrice[i]
);
strSecularMetrics += "\t| " +
aBond[i].name() + " | " +
aBond[i].effectiveDate() + " | " +
aBond[i].maturityDate() + " | " +
aBond[i].firstCouponDate() + " |" +
FormatUtil.FormatDouble (adblCleanPrice[i], 3, 3, 100.) + " |" +
FormatUtil.FormatDouble (wi.yield(), 1, 2, 100.) + "% | " +
FormatUtil.FormatDouble (rvm.macaulayDuration(), 2, 2, 1.) + " | " +
FormatUtil.FormatDouble (rvm.modifiedDuration(), 2, 2, 10000.) + " | " +
FormatUtil.FormatDouble (rvm.yield01(), 2, 2, 10000.) + " |" +
FormatUtil.FormatDouble (rvm.yield01(), 4, 0, 1000000.) + " |" +
FormatUtil.FormatDouble (rvm.convexity(), 1, 2, 1000000.) + " | " +
FormatUtil.FormatDouble (rvm.bondBasis(), 3, 0, 10000.) + " ||" + "\n";
adblOAS[i] = rvm.oas();
double dblCleanPriceOASUp = aBond[i].priceFromOAS (
valParams,
csqc,
null,
adblOAS[i] + 0.0001
);
double dblCleanPriceOASDown = aBond[i].priceFromOAS (
valParams,
csqc,
null,
adblOAS[i] - 0.0001
);
strCurveMetrics += "\t| " +
aBond[i].name() + " |" +
FormatUtil.FormatDouble (adblCleanPrice[i], 3, 3, 100.) + " |" +
FormatUtil.FormatDouble (wi.yield(), 1, 2, 100.) + "% | " +
FormatUtil.FormatDouble (rvm.zSpread(), 3, 0, 10000.) + " |" +
FormatUtil.FormatDouble (adblOAS[i], 3, 0, 10000.) + " | " +
FormatUtil.FormatDouble (0.5 * (dblCleanPriceOASDown - dblCleanPriceOASUp) / adblCleanPrice[i], 2, 2, 10000.) + " | " +
FormatUtil.FormatDouble ((dblCleanPriceOASDown + dblCleanPriceOASUp - 2. * adblCleanPrice[i]) / adblCleanPrice[i], 2, 2, 1000000.) + " |" +
FormatUtil.FormatDouble (rvm.asw(), 3, 0, 10000.) + " | " +
FormatUtil.FormatDouble (rvm.gSpread(), 3, 0, 10000.) + " | " +
FormatUtil.FormatDouble (rvm.iSpread(), 3, 0, 10000.) + " | " +
FormatUtil.FormatDouble (rvm.tsySpread(), 3, 0, 10000.) + " | " +
Helper.BaseTsyBmk (
dtValue.julian(),
aBond[i].maturityDate().julian()
) + " ||" + "\n";
}
System.out.println ("\t|----------------------------------------------------------------------------------------------------------------------------------------------------||");
System.out.println ("\t| BOND | EFFECTIVE | MATURITY | FIRST COUPON | PRICE | YIELD | MAC DUR | MOD DUR | YIELD 01 | DV01 | CONV | BOND BASIS ||");
System.out.println ("\t|----------------------------------------------------------------------------------------------------------------------------------------------------||");
System.out.print (strSecularMetrics);
System.out.println ("\t|----------------------------------------------------------------------------------------------------------------------------------------------------||\n");
System.out.println ("\t|----------------------------------------------------------------------------------------------------------------------------------------||");
System.out.println ("\t| BOND | PRICE | YIELD | Z SPREAD | OAS | OAS DUR | OAS CONV | ASW | G SPREAD | I SPREAD | TSY SPREAD | TSY BMK ||");
System.out.println ("\t|----------------------------------------------------------------------------------------------------------------------------------------||");
System.out.print (strCurveMetrics);
System.out.println ("\t|----------------------------------------------------------------------------------------------------------------------------------------||");
return adblOAS;
}
public static final void main (
final String[] astrArgs)
throws Exception
{
EnvManager.InitEnv (
"",
true
);
JulianDate dtSpot = DateUtil.CreateFromYMD (
2017,
DateUtil.FEBRUARY,
2
);
String strCurrency = "USD";
String strTreasuryCode = "UST";
MergedDiscountForwardCurve dcFunding = FundingCurve (
dtSpot,
strCurrency
);
double[] adblTreasuryCoupon = new double[] {
0.0100,
0.0100,
0.0125,
0.0150,
0.0200,
0.0225,
0.0250,
0.0300
};
double[] adblTreasuryYield = new double[] {
0.0083, // 1Y
0.0122, // 2Y
0.0149, // 3Y
0.0193, // 5Y
0.0227, // 7Y
0.0248, // 10Y
0.0280, // 20Y
0.0308 // 30Y
};
Map<String, GovvieCurve> mapGovvieCurve = GovvieCurve (
dtSpot,
strTreasuryCode,
adblTreasuryCoupon,
adblTreasuryYield
);
CurveSurfaceQuoteContainer csqc = MarketParamsBuilder.Create (
dcFunding,
null,
null,
null,
null,
null,
null
);
csqc.setGovvieState (mapGovvieCurve.get ("BASE"));
AccumulateBondMarketQuote (
csqc,
new String[] {
"01YON",
"02YON",
"03YON",
"05YON",
"07YON",
"10YON",
"20YON",
"30YON"
},
adblTreasuryYield
);
Bond[] aCorporateBond = new Bond[] {
Corporate ("CORPORA", DateUtil.CreateFromYMD (2014, 6, 5), DateUtil.CreateFromYMD (2017, 6, 2), 0.01250, 2, "30/360"),
Corporate ("CORPORA", DateUtil.CreateFromYMD (2016, 3, 9), DateUtil.CreateFromYMD (2018, 3, 9), 0.02500, 2, "30/360"),
Corporate ("CORPORA", DateUtil.CreateFromYMD (2013, 8, 8), DateUtil.CreateFromYMD (2018, 12, 15), 0.02900, 2, "30/360"),
Corporate ("CORPORA", DateUtil.CreateFromYMD (2009, 1, 16), DateUtil.CreateFromYMD (2019, 1, 15), 0.08625, 2, "30/360"),
Corporate ("CORPORA", DateUtil.CreateFromYMD (2010, 12, 15), DateUtil.CreateFromYMD (2020, 12, 15), 0.06000, 2, "ISMA-30/360"),
Corporate ("CORPORA", DateUtil.CreateFromYMD (2011, 2, 16), DateUtil.CreateFromYMD (2021, 2, 16), 0.05462, 2, "30/360"),
Corporate ("CORPORA", DateUtil.CreateFromYMD (2016, 10, 27), DateUtil.CreateFromYMD (2021, 9, 20), 0.03360, 2, "30/360"),
Corporate ("CORPORA", DateUtil.CreateFromYMD (2012, 7, 13), DateUtil.CreateFromYMD (2022, 7, 11), 0.04875, 2, "30/360"),
Corporate ("CORPORA", DateUtil.CreateFromYMD (2004, 5, 4), DateUtil.CreateFromYMD (2024, 3, 30), 0.06119, 2, "30/360 NON-EOM"),
Corporate ("CORPORA", DateUtil.CreateFromYMD (2015, 7, 29), DateUtil.CreateFromYMD (2025, 7, 29), 0.04000, 2, "30/360"),
Corporate ("CORPORA", DateUtil.CreateFromYMD (2016, 3, 4), DateUtil.CreateFromYMD (2026, 3, 4), 0.04150, 2, "30/360"),
Corporate ("CORPORA", DateUtil.CreateFromYMD (2011, 6, 30), DateUtil.CreateFromYMD (2034, 7, 15), 0.05820, 2, "30/360"),
Corporate ("CORPORA", DateUtil.CreateFromYMD (2004, 10, 15), DateUtil.CreateFromYMD (2049, 10, 1), 0.05586, 2, "30/360"),
Corporate ("CORPORA", DateUtil.CreateFromYMD (2006, 5, 1), DateUtil.CreateFromYMD (2051, 5, 15), 0.06124, 2, "30/360"),
Corporate ("CORPORA", DateUtil.CreateFromYMD (2015, 9, 30), DateUtil.CreateFromYMD (2051, 10, 15), 0.05334, 2, "30/360"),
};
double[] adblCleanPrice = new double[] {
0.9989031, // (2017, 6, 2)
1.0092960, // (2018, 3, 9)
1.0115980, // (2018, 12, 15)
1.1223650, // (2019, 1, 15)
1.0954840, // (2020, 12, 15)
1.0905480, // (2021, 2, 16)
1.0005000, // (2021, 9, 20)
1.0762390, // (2022, 7, 11)
1.1097420, // (2024, 3, 30)
1.0285550, // (2026, 7, 29)
1.0456260, // (2026, 3, 4)
1.0824400, // (2034, 7, 15)
1.0980730, // (2049, 10, 1)
1.0919230, // (2051, 5, 15)
1.0331340, // (2051, 10, 15)
};
double[] adblOAS = RVMeasures (
aCorporateBond,
dtSpot,
csqc,
adblCleanPrice
);
ValuationParams valParams = new ValuationParams (
dtSpot,
dtSpot.addBusDays (
3,
dcFunding.currency()
),
dcFunding.currency()
);
System.out.println();
System.out.println ("\t|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------||");
System.out.print ("\t| BOND ");
for (Map.Entry<String, GovvieCurve> meGovvieCurve : mapGovvieCurve.entrySet()) {
if ("BASE".equalsIgnoreCase (meGovvieCurve.getKey()) || "BUMP".equalsIgnoreCase (meGovvieCurve.getKey()))
continue;
System.out.print (" | " + meGovvieCurve.getKey());
}
System.out.println (" ||");
System.out.println ("\t|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------||");
for (int i = 0; i < adblOAS.length; ++i) {
System.out.print ("\t| " + aCorporateBond[i].name());
for (Map.Entry<String, GovvieCurve> meGovvieCurve : mapGovvieCurve.entrySet()) {
if ("BASE".equalsIgnoreCase (meGovvieCurve.getKey()) || "BUMP".equalsIgnoreCase (meGovvieCurve.getKey()))
continue;
csqc.setGovvieState (meGovvieCurve.getValue());
System.out.print (" | " +
FormatUtil.FormatDouble (
(adblCleanPrice[i] - aCorporateBond[i].priceFromOAS (
valParams,
csqc,
null,
adblOAS[i]
)) / adblCleanPrice[i],
2, 2, 10000.) + " "
);
}
System.out.println (" ||");
}
System.out.println ("\t|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------||");
EnvManager.TerminateEnv();
}
}