org.drip.state.credit

Class CreditCurve

java.lang.Object

org.drip.state.credit.CreditCurve

All Implemented Interfaces:

Curve, LatentState

Direct Known Subclasses:

ExplicitBootCreditCurve

public abstract class CreditCurve
extends java.lang.Object
implements Curve

CreditCurve is the stub for the survival curve functionality. It extends the Curve object by exposing the following functions: - Set of curve and market identifiers - Recovery to a specific date/tenor, and effective recovery between a date interval - Hazard Rate to a specific date/tenor, and effective hazard rate between a date interval - Survival to a specific date/tenor, and effective survival between a date interval - Set/unset date of specific default - Generate scenario curves from the base credit curve (flat/parallel/custom) - Set/unset the Curve Construction Inputs, Latent State, and the Manifest Metrics - Serialization/De-serialization to and from Byte Arrays

Author:

Lakshmi Krishnamurthy

Method Summary

Modifier and Type	Method and Description
CalibratableComponent[]	calibComp() Retrieve the Calibration Components
java.lang.String	currency() Get the Currency
double	effectiveRecovery(int iDate1, int iDate2) Calculate the time-weighted recovery between a pair of dates
double	effectiveRecovery(JulianDate dt1, JulianDate dt2) Calculate the time-weighted recovery between a pair of dates
double	effectiveRecovery(java.lang.String strTenor1, java.lang.String strTenor2) Calculate the time-weighted recovery between a pair of tenors
double	effectiveSurvival(int iDate1, int iDate2) Calculate the time-weighted survival between a pair of 2 dates
double	effectiveSurvival(JulianDate dt1, JulianDate dt2) Calculate the time-weighted survival between a pair of 2 dates
double	effectiveSurvival(java.lang.String strTenor1, java.lang.String strTenor2) Calculate the time-weighted survival between a pair of 2 tenors
JulianDate	epoch() Get the Epoch Date
abstract CreditCurve	flatCurve(double dblFlatNodeValue, boolean bSingleNode, double dblRecovery) Create a flat hazard curve from the inputs
double	hazard(JulianDate dt) Calculate the hazard rate to the given date
double	hazard(JulianDate dt1, JulianDate dt2) Calculate the hazard rate between a pair of forward dates
double	hazard(java.lang.String strTenor) Calculate the hazard rate to the given tenor
LatentStateLabel	label() Get the Curve Latent State Identifier Label
CaseInsensitiveTreeMap<java.lang.Double>	manifestMeasure(java.lang.String strInstr) Retrieve the Manifest Measure Map of the given Instrument used to construct the Curve
abstract double	recovery(int iDate) Calculate the recovery rate to the given date
double	recovery(JulianDate dt) Calculate the recovery rate to the given date
double	recovery(java.lang.String strTenor) Calculate the recovery rate to the given tenor
boolean	setCCIS(CurveConstructionInputSet ccis) Set the Curve Construction Input Set Parameters
void	setInstrCalibInputs(ValuationParams valParam, boolean bFlat, MergedDiscountForwardCurve dc, GovvieCurve gc, CreditPricerParams pricerParam, CalibratableComponent[] aCalibInst, double[] adblCalibQuote, java.lang.String[] astrCalibMeasure, LatentStateFixingsContainer lsfc, ValuationCustomizationParams quotingParams) Set the calibration inputs for the CreditCurve
boolean	setSpecificDefault(int iSpecificDefaultDate) Set the Specific Default Date
abstract double	survival(int iDate) Calculate the survival to the given date
double	survival(JulianDate dt) Calculate the survival to the given date
double	survival(java.lang.String strTenor) Calculate the survival to the given tenor
boolean	unsetSpecificDefault() Remove the Specific Default Date

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.drip.state.representation.LatentState

customTweakManifestMeasure, customTweakQuantificationMetric, parallelShiftManifestMeasure, parallelShiftQuantificationMetric, shiftManifestMeasure

Method Detail

label

public LatentStateLabel label()

Description copied from interface: Curve

Get the Curve Latent State Identifier Label

Specified by:

label in interface Curve

Returns:

The Curve Latent State Identifier Label

currency

public java.lang.String currency()

Description copied from interface: Curve

Get the Currency

Specified by:

currency in interface Curve

Returns:

Currency

epoch

public JulianDate epoch()

Description copied from interface: Curve

Get the Epoch Date

Specified by:

epoch in interface Curve

Returns:

The Epoch Date

setSpecificDefault

public boolean setSpecificDefault(int iSpecificDefaultDate)

Set the Specific Default Date

Parameters:

iSpecificDefaultDate - Date of Specific Default

Returns:

TRUE if successful

unsetSpecificDefault

public boolean unsetSpecificDefault()

Remove the Specific Default Date

Returns:

TRUE if successful

survival

public abstract double survival(int iDate)
                         throws java.lang.Exception

Calculate the survival to the given date

Parameters:

iDate - Date

Returns:

Survival Probability

Throws:

java.lang.Exception - Thrown if the survival probability cannot be calculated

survival

public double survival(JulianDate dt)
                throws java.lang.Exception

Calculate the survival to the given date

Parameters:

dt - Date

Returns:

Survival Probability

Throws:

java.lang.Exception - Thrown if the survival probability cannot be calculated

survival

public double survival(java.lang.String strTenor)
                throws java.lang.Exception

Calculate the survival to the given tenor

Parameters:

strTenor - Tenor

Returns:

Survival Probability

Throws:

java.lang.Exception - Thrown if the survival probability cannot be calculated

effectiveSurvival

public double effectiveSurvival(int iDate1,
                                int iDate2)
                         throws java.lang.Exception

Calculate the time-weighted survival between a pair of 2 dates

Parameters:

iDate1 - First Date

iDate2 - Second Date

Returns:

Survival Probability

Throws:

java.lang.Exception - Thrown if the survival probability cannot be calculated

effectiveSurvival

public double effectiveSurvival(JulianDate dt1,
                                JulianDate dt2)
                         throws java.lang.Exception

Calculate the time-weighted survival between a pair of 2 dates

Parameters:

dt1 - First Date

dt2 - Second Date

Returns:

Survival Probability

Throws:

java.lang.Exception - Thrown if the survival probability cannot be calculated

effectiveSurvival

public double effectiveSurvival(java.lang.String strTenor1,
                                java.lang.String strTenor2)
                         throws java.lang.Exception

Calculate the time-weighted survival between a pair of 2 tenors

Parameters:

strTenor1 - First tenor

strTenor2 - Second tenor

Returns:

Survival Probability

Throws:

java.lang.Exception - Thrown if the survival probability cannot be calculated

recovery

public abstract double recovery(int iDate)
                         throws java.lang.Exception

Calculate the recovery rate to the given date

Parameters:

iDate - Date

Returns:

Recovery Rate

Throws:

java.lang.Exception - Thrown if the Recovery rate cannot be calculated

recovery

public double recovery(JulianDate dt)
                throws java.lang.Exception

Calculate the recovery rate to the given date

Parameters:

dt - Date

Returns:

Recovery Rate

Throws:

java.lang.Exception - Thrown if the Recovery rate cannot be calculated

recovery

public double recovery(java.lang.String strTenor)
                throws java.lang.Exception

Calculate the recovery rate to the given tenor

Parameters:

strTenor - Tenor

Returns:

Recovery Rate

Throws:

java.lang.Exception - Thrown if the Recovery rate cannot be calculated

effectiveRecovery

public double effectiveRecovery(int iDate1,
                                int iDate2)
                         throws java.lang.Exception

Calculate the time-weighted recovery between a pair of dates

Parameters:

iDate1 - First Date

iDate2 - Second Date

Returns:

Time-weighted recovery

Throws:

java.lang.Exception - Thrown if the recovery cannot be calculated

effectiveRecovery

public double effectiveRecovery(JulianDate dt1,
                                JulianDate dt2)
                         throws java.lang.Exception

Calculate the time-weighted recovery between a pair of dates

Parameters:

dt1 - First Date

dt2 - Second Date

Returns:

Time-weighted recovery

Throws:

java.lang.Exception - Thrown if the recovery cannot be calculated

effectiveRecovery

public double effectiveRecovery(java.lang.String strTenor1,
                                java.lang.String strTenor2)
                         throws java.lang.Exception

Calculate the time-weighted recovery between a pair of tenors

Parameters:

strTenor1 - First Tenor

strTenor2 - Second Tenor

Returns:

Time-weighted recovery

Throws:

java.lang.Exception - Thrown if the recovery cannot be calculated

hazard

public double hazard(JulianDate dt1,
                     JulianDate dt2)
              throws java.lang.Exception

Calculate the hazard rate between a pair of forward dates

Parameters:

dt1 - First Date

dt2 - Second Date

Returns:

Hazard Rate

Throws:

java.lang.Exception - Thrown if the hazard rate cannot be calculated

hazard

public double hazard(JulianDate dt)
              throws java.lang.Exception

Calculate the hazard rate to the given date

Parameters:

dt - Date

Returns:

Hazard Rate

Throws:

java.lang.Exception - Thrown if the hazard rate cannot be calculated

hazard

public double hazard(java.lang.String strTenor)
              throws java.lang.Exception

Calculate the hazard rate to the given tenor

Parameters:

strTenor - Tenor

Returns:

Hazard Rate

Throws:

java.lang.Exception - Thrown if the hazard rate cannot be calculated

flatCurve

public abstract CreditCurve flatCurve(double dblFlatNodeValue,
                                      boolean bSingleNode,
                                      double dblRecovery)

Create a flat hazard curve from the inputs

Parameters:

dblFlatNodeValue - Flat hazard node value

bSingleNode - Uses a single node for Calibration (True)

dblRecovery - (Optional) Recovery to be used in creation of the flat curve

Returns:

New CreditCurve instance

setInstrCalibInputs

public void setInstrCalibInputs(ValuationParams valParam,
                                boolean bFlat,
                                MergedDiscountForwardCurve dc,
                                GovvieCurve gc,
                                CreditPricerParams pricerParam,
                                CalibratableComponent[] aCalibInst,
                                double[] adblCalibQuote,
                                java.lang.String[] astrCalibMeasure,
                                LatentStateFixingsContainer lsfc,
                                ValuationCustomizationParams quotingParams)

Set the calibration inputs for the CreditCurve

Parameters:

valParam - ValuationParams

bFlat - Flat calibration desired (True)

dc - Base Discount Curve

gc - Govvie Curve

pricerParam - PricerParams

aCalibInst - Array of calibration instruments

adblCalibQuote - Array of calibration quotes

astrCalibMeasure - Array of calibration measures

lsfc - Latent State Fixings Container

quotingParams - Quoting Parameters

setCCIS

public boolean setCCIS(CurveConstructionInputSet ccis)

Description copied from interface: Curve

Set the Curve Construction Input Set Parameters

Specified by:

setCCIS in interface Curve

Parameters:

ccis - The Curve Construction Input Set Parameters

Returns:

TRUE - Inputs successfully Set

calibComp

public CalibratableComponent[] calibComp()

Description copied from interface: Curve

Retrieve the Calibration Components

Specified by:

calibComp in interface Curve

Returns:

Array of Calibration Components

manifestMeasure

public CaseInsensitiveTreeMap<java.lang.Double> manifestMeasure(java.lang.String strInstr)

Description copied from interface: Curve

Retrieve the Manifest Measure Map of the given Instrument used to construct the Curve

Specified by:

manifestMeasure in interface Curve

Parameters:

strInstr - The Calibration Instrument's Code whose Manifest Measure Map is sought

Returns:

The Manifest Measure Map of the given Instrument used to construct the Curve