org.drip.state.curve

Class DiscountFactorDiscountCurve

java.lang.Object

org.drip.state.discount.MergedDiscountForwardCurve

org.drip.state.curve.DiscountFactorDiscountCurve

All Implemented Interfaces:

Curve, DiscountCurve, DiscountFactorEstimator, LatentState

public class DiscountFactorDiscountCurve
extends MergedDiscountForwardCurve

DiscountFactorDiscountCurve manages the Discounting Latent State, using the Discount Factor as the State Response Representation. It exports the following functionality: - Compute the discount factor, forward rate, or the zero rate from the Discount Factor Latent State - Create a ForwardRateEstimator instance for the given Index - Retrieve Array of the Calibration Components - Retrieve the Curve Construction Input Set - Compute the Jacobian of the Discount Factor Latent State to the input Quote - Synthesize scenario Latent State by parallel shifting/custom tweaking the quantification metric - Synthesize scenario Latent State by parallel/custom shifting/custom tweaking the manifest measure - Serialize into and de-serialize out of byte array

Author:

Lakshmi Krishnamurthy

Constructor Summary

Constructors

Constructor and Description
DiscountFactorDiscountCurve(java.lang.String strCurrency, Span span) DiscountFactorDiscountCurve constructor

Method Summary

Modifier and Type	Method and Description
CalibratableComponent[]	calibComp() Retrieve the Calibration Components
MergedDiscountForwardCurve	customTweakManifestMeasure(java.lang.String strManifestMeasure, ManifestMeasureTweak rvtp) Create a LatentState Instance from the Manifest Measure Tweak Parameters
Curve	customTweakQuantificationMetric(ManifestMeasureTweak rvtp) Create a LatentState Instance from the Quantification Metric Tweak Parameters
double	df(int iDate) Calculate the Discount Factor to the given Date
double	forward(int iDate1, int iDate2) Compute the Forward Rate between two Dates
ForwardRateEstimator	forwardRateEstimator(int iDate, ForwardLabel fri) Retrieve the Forward Curve that might be implied by the Latent State of this Discount Curve Instance corresponding to the specified Floating Rate Index
WengertJacobian	jackDDFDManifestMeasure(int iDate, java.lang.String strManifestMeasure) Retrieve the Manifest Measure Jacobian of the Discount Factor to the given date
java.lang.String	latentStateQuantificationMetric() Retrieve the Latent State Quantification Metric
CaseInsensitiveTreeMap<java.lang.Double>	manifestMeasure(java.lang.String strInstrumentCode) Retrieve the Manifest Measure Map of the given Instrument used to construct the Curve
DiscountFactorDiscountCurve	parallelShiftManifestMeasure(java.lang.String strManifestMeasure, double dblShift) Create a LatentState Instance from the Manifest Measure Parallel Shift
DiscountFactorDiscountCurve	parallelShiftQuantificationMetric(double dblShift) Create a LatentState Instance from the Quantification Metric Parallel Shift
DiscountFactorDiscountCurve	shiftManifestMeasure(int iSpanIndex, java.lang.String strManifestMeasure, double dblShift) Create a LatentState Instance from the Shift of the Specified Manifest Measure
double	zero(int iDate) Calculate the implied rate to the given date

Methods inherited from class org.drip.state.discount.MergedDiscountForwardCurve

canonicalTruthness, compJackDPVDManifestMeasure, compJackDPVDManifestMeasure, currency, df, df, effectiveDF, effectiveDF, effectiveDF, epoch, estimateManifestMeasure, forward, jackDDFDManifestMeasure, jackDDFDManifestMeasure, jackDForwardDManifestMeasure, jackDForwardDManifestMeasure, jackDForwardDManifestMeasure, label, libor, libor, libor, libor, nativeForwardCurve, parSwapDV01, setCCIS, setTurns, turnAdjust, zero, zeroRateJack, zeroRateJack

Methods inherited from class java.lang.Object

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

Constructor Detail

DiscountFactorDiscountCurve

public DiscountFactorDiscountCurve(java.lang.String strCurrency,
                                   Span span)
                            throws java.lang.Exception

DiscountFactorDiscountCurve constructor

Parameters:

strCurrency - Currency

span - The Span Instance

Throws:

java.lang.Exception - Thrown if the Inputs are Invalid

Method Detail

df

public double df(int iDate)
          throws java.lang.Exception

Description copied from interface: DiscountFactorEstimator

Calculate the Discount Factor to the given Date

Parameters:

iDate - Date

Returns:

Discount Factor

Throws:

java.lang.Exception - Thrown if the Discount Factor cannot be calculated

forward

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

Description copied from class: MergedDiscountForwardCurve

Compute the Forward Rate between two Dates

Specified by:

forward in class MergedDiscountForwardCurve

Parameters:

iDate1 - First Date

iDate2 - Second Date

Returns:

The Forward Rate

Throws:

java.lang.Exception - Thrown if the Forward Rate cannot be calculated

zero

public double zero(int iDate)
            throws java.lang.Exception

Description copied from class: MergedDiscountForwardCurve

Calculate the implied rate to the given date

Specified by:

zero in class MergedDiscountForwardCurve

Parameters:

iDate - Date

Returns:

Implied rate

Throws:

java.lang.Exception - Thrown if the discount factor cannot be calculated

forwardRateEstimator

public ForwardRateEstimator forwardRateEstimator(int iDate,
                                                 ForwardLabel fri)

Description copied from class: MergedDiscountForwardCurve

Retrieve the Forward Curve that might be implied by the Latent State of this Discount Curve Instance corresponding to the specified Floating Rate Index

Specified by:

forwardRateEstimator in class MergedDiscountForwardCurve

Parameters:

iDate - The Date

fri - The Floating Rate Index

Returns:

The Forward Curve Implied by the Discount Curve Latent State

latentStateQuantificationMetric

public java.lang.String latentStateQuantificationMetric()

Description copied from class: MergedDiscountForwardCurve

Retrieve the Latent State Quantification Metric

Specified by:

latentStateQuantificationMetric in class MergedDiscountForwardCurve

Returns:

The Latent State Quantification Metric

parallelShiftManifestMeasure

public DiscountFactorDiscountCurve parallelShiftManifestMeasure(java.lang.String strManifestMeasure,
                                                                double dblShift)

Description copied from interface: LatentState

Create a LatentState Instance from the Manifest Measure Parallel Shift

Parameters:

strManifestMeasure - The Specified Manifest Measure

dblShift - Parallel shift of the Manifest Measure

Returns:

New LatentState Instance corresponding to the Parallel Shifted Manifest Measure

shiftManifestMeasure

public DiscountFactorDiscountCurve shiftManifestMeasure(int iSpanIndex,
                                                        java.lang.String strManifestMeasure,
                                                        double dblShift)

Description copied from interface: LatentState

Create a LatentState Instance from the Shift of the Specified Manifest Measure

Parameters:

iSpanIndex - Index into the Span that identifies the Instrument

strManifestMeasure - The Specified Manifest Measure

dblShift - Shift of the Manifest Measure

Returns:

New LatentState Instance corresponding to the Shift of the Specified Manifest Measure

customTweakManifestMeasure

public MergedDiscountForwardCurve customTweakManifestMeasure(java.lang.String strManifestMeasure,
                                                             ManifestMeasureTweak rvtp)

Description copied from interface: LatentState

Create a LatentState Instance from the Manifest Measure Tweak Parameters

Parameters:

strManifestMeasure - The Specified Manifest Measure

rvtp - Manifest Measure Tweak Parameters

Returns:

New LatentState Instance corresponding to the Tweaked Manifest Measure

parallelShiftQuantificationMetric

public DiscountFactorDiscountCurve parallelShiftQuantificationMetric(double dblShift)

Description copied from interface: LatentState

Create a LatentState Instance from the Quantification Metric Parallel Shift

Parameters:

dblShift - Parallel shift of the Quantification Metric

Returns:

New LatentState Instance corresponding to the Parallel Shifted Quantification Metric

customTweakQuantificationMetric

public Curve customTweakQuantificationMetric(ManifestMeasureTweak rvtp)

Description copied from interface: LatentState

Create a LatentState Instance from the Quantification Metric Tweak Parameters

Parameters:

rvtp - Quantification Metric Tweak Parameters

Returns:

New LatentState Instance corresponding to the Tweaked Quantification Metric

jackDDFDManifestMeasure

public WengertJacobian jackDDFDManifestMeasure(int iDate,
                                               java.lang.String strManifestMeasure)

Description copied from class: MergedDiscountForwardCurve

Retrieve the Manifest Measure Jacobian of the Discount Factor to the given date

Specified by:

jackDDFDManifestMeasure in class MergedDiscountForwardCurve

Parameters:

iDate - Date

strManifestMeasure - Manifest Measure

Returns:

The Manifest Measure Jacobian of the Discount Factor to the given date

calibComp

public CalibratableComponent[] calibComp()

Description copied from interface: Curve

Retrieve the Calibration Components

Returns:

Array of Calibration Components

manifestMeasure

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

Description copied from interface: Curve

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

Parameters:

strInstrumentCode - 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