Package org.drip.product.option

Class OptionComponent

java.lang.Object

org.drip.product.definition.Component

org.drip.product.definition.CalibratableComponent

org.drip.product.option.OptionComponent

All Implemented Interfaces:

ComponentMarketParamRef

Direct Known Subclasses:

CDSEuropeanOption, FixFloatEuropeanOption, FRAStandardCapFloor, FRAStandardCapFloorlet

public abstract class OptionComponent
extends CalibratableComponent

OptionComponent extends ComponentMarketParamRef and provides the following methods:

• Get the component's initial notional, notional, and coupon.
• Get the Effective date, Maturity date, First Coupon Date.
• Set the market curves - discount, TSY, forward, and Credit curves.
• Retrieve the component's settlement parameters.
• Value the component using standard/custom market parameters.
• Retrieve the component's named measures and named measure values.
• Retrieve the Underlying Fixed Income Product, Day Count, Strike, Calendar, and Manifest Measure.

• Module = Product Core Module
• Library = Fixed Income Analytics
• Project = Product Components/Baskets for Credit, FRA, FX, Govvie, Rates, and Option AssetClasses
• Package = Options on Fixed Income Components

Author:

Lakshmi Krishnamurthy

Method Summary

Modifier and Type	Method	Description
CaseInsensitiveTreeMap<java.lang.Double>	calibMeasures(ValuationParams valParams, CreditPricerParams pricerParams, CurveSurfaceQuoteContainer csqs, ValuationCustomizationParams vcp)	Generate a Map of the Calibration Measures
ProductQuoteSet	calibQuoteSet(LatentStateSpecification[] aLSS)	Generate the Product Specific Calibration Quote Set
CashSettleParams	cashSettleParams()	Get the Product's cash settlement parameters
CaseInsensitiveTreeMap<java.lang.String>	couponCurrency()	Get the Map of Coupon Currencies
CompositePeriodCouponMetrics	couponMetrics(int iAccrualEndDate, ValuationParams valParams, CurveSurfaceQuoteContainer csqs)	Get the Product's coupon Metrics at the specified accrual date
java.util.List<CompositePeriod>	couponPeriods()	Get the Product's Cash Flow Periods
EntityCDSLabel	creditLabel()	Get the Credit Curve Latent State Identifier Label
JulianDate	effectiveDate()	Get the Effective Date
JulianDate	exerciseDate()	Retrieve the Option Exercise Date
JulianDate	firstCouponDate()	Get the First Coupon Date
CaseInsensitiveTreeMap<ForwardLabel>	forwardLabel()	Get the Map of Forward Latent State Labels
PredictorResponseWeightConstraint	forwardPRWC(ValuationParams valParams, CreditPricerParams pricerParams, CurveSurfaceQuoteContainer csqs, ValuationCustomizationParams vcp, ProductQuoteSet pqs)	Generate the Calibratable Linearized Predictor/Response Constraint Weights for the Non-merged Forward Factor Latent State from the Component's Cash Flows.
int	freq()	Retrieve the Coupon Frequency
PredictorResponseWeightConstraint	fundingForwardPRWC(ValuationParams valParams, CreditPricerParams pricerParams, CurveSurfaceQuoteContainer csqs, ValuationCustomizationParams vcp, ProductQuoteSet pqs)	Generate the Calibratable Linearized Predictor/Response Constraint Weights for the merged Funding and Forward Latent States from the Component's Cash Flows.
FundingLabel	fundingLabel()	Get the Funding Curve Latent State Label
PredictorResponseWeightConstraint	fundingPRWC(ValuationParams valParams, CreditPricerParams pricerParams, CurveSurfaceQuoteContainer csqs, ValuationCustomizationParams vcp, ProductQuoteSet pqs)	Generate the Calibratable Linearized Predictor/Response Constraint Weights for the Non-merged Funding Curve Discount Factor Latent State from the Component's Cash Flows.
CaseInsensitiveTreeMap<FXLabel>	fxLabel()	Get the Map of FX Latent State Identifier Labels
PredictorResponseWeightConstraint	fxPRWC(ValuationParams valParams, CreditPricerParams pricerParams, CurveSurfaceQuoteContainer csqs, ValuationCustomizationParams vcp, ProductQuoteSet pqs)	Generate the Calibratable Linearized Predictor/Response Constraint Weights for the Non-merged FX Curve FX Forward Latent State from the Component's Cash Flows.
GovvieLabel	govvieLabel()	Get the Govvie Curve Latent State Label
PredictorResponseWeightConstraint	govviePRWC(ValuationParams valParams, CreditPricerParams pricerParams, CurveSurfaceQuoteContainer csqs, ValuationCustomizationParams vcp, ProductQuoteSet pqs)	Generate the Calibratable Linearized Predictor/Response Constraint Weights for the Non-merged Govvie Curve FX Forward Latent State from the Component's Cash Flows.
double	initialNotional()	Get the Initial Notional for the Product
WengertJacobian	jackDDirtyPVDManifestMeasure(ValuationParams valParams, CreditPricerParams pricerParams, CurveSurfaceQuoteContainer csqs, ValuationCustomizationParams vcp)	Compute the Jacobian of the Dirty PV to the Calibrated Input Manifest Measures
LastTradingDateSetting	lastTradingDateSetting()	Retrieve the Option Last Trading Date Setting
java.lang.String	manifestMeasure()	Retrieve the Manifest Measure on which the Option's Strike is quoted
WengertJacobian	manifestMeasureDFMicroJack(java.lang.String strMainfestMeasure, ValuationParams valParams, CreditPricerParams pricerParams, CurveSurfaceQuoteContainer csqs, ValuationCustomizationParams vcp)	Compute the micro-Jacobian of the given measure to the DF
JulianDate	maturityDate()	Get the Maturity Date
java.lang.String	name()	Get the component name
double	notional()	Retrieve the Notional
double	notional(int dblDate1)	Get the Notional for the Product at the given date
double	notional(int dblDate1, int dblDate2)	Get the time-weighted Notional for the Product between 2 dates
CaseInsensitiveTreeMap<OTCFixFloatLabel>	otcFixFloatLabel()	Get the Map of OTC Fix Float Latent State Labels
java.lang.String	payCurrency()	Get the Pay Currency
java.lang.String	primaryCode()	Return the primary code
java.lang.String	principalCurrency()	Get the Principal Currency
void	setPrimaryCode(java.lang.String strCode)	Set the component's primary code
double	strike()	Retrieve the Strike
Component	underlying()	Retrieve the Underlying Component
CaseInsensitiveTreeMap<VolatilityLabel>	volatilityLabel()	Get the Map of Volatility Latent State Identifier Labels

Methods inherited from class org.drip.product.definition.CalibratableComponent

calibPRWC, secondaryCode, volatilityPRWC

Methods inherited from class org.drip.product.definition.Component

customScenarioMeasures, maturityPayDate, measureNames, measures, measureValue, pv, tenor, value

Methods inherited from class java.lang.Object

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

Method Details

underlying

public Component underlying()

Retrieve the Underlying Component

Returns:

The Underlying Component

manifestMeasure

public java.lang.String manifestMeasure()

Retrieve the Manifest Measure on which the Option's Strike is quoted

Returns:

The Manifest Measure on which the Option's Strike is quoted

strike

public double strike()

Retrieve the Strike

Returns:

The Strike

notional

public double notional()

Retrieve the Notional

Returns:

The Notional

exerciseDate

public JulianDate exerciseDate()

Retrieve the Option Exercise Date

Returns:

The Option Exercise Date

lastTradingDateSetting

public LastTradingDateSetting lastTradingDateSetting()

Retrieve the Option Last Trading Date Setting

Returns:

The Option Last Trading Date Setting

setPrimaryCode

public void setPrimaryCode(java.lang.String strCode)

Description copied from class: CalibratableComponent

Set the component's primary code

Specified by:

setPrimaryCode in class CalibratableComponent

Parameters:

strCode - Primary Code

primaryCode

public java.lang.String primaryCode()

Description copied from class: CalibratableComponent

Return the primary code

Specified by:

primaryCode in class CalibratableComponent

Returns:

Primary Code

name

public java.lang.String name()

Description copied from interface: ComponentMarketParamRef

Get the component name

Returns:

The component name

couponCurrency

public CaseInsensitiveTreeMap<java.lang.String> couponCurrency()

Description copied from interface: ComponentMarketParamRef

Get the Map of Coupon Currencies

Returns:

The Map of Coupon Currencies

payCurrency

public java.lang.String payCurrency()

Description copied from interface: ComponentMarketParamRef

Get the Pay Currency

Returns:

The Pay Currency

principalCurrency

public java.lang.String principalCurrency()

Description copied from interface: ComponentMarketParamRef

Get the Principal Currency

Returns:

The Principal Currency

effectiveDate

public JulianDate effectiveDate()

Description copied from class: Component

Get the Effective Date

Specified by:

effectiveDate in class Component

Returns:

Effective Date

maturityDate

public JulianDate maturityDate()

Description copied from class: Component

Get the Maturity Date

Specified by:

maturityDate in class Component

Returns:

Maturity Date

firstCouponDate

public JulianDate firstCouponDate()

Description copied from class: Component

Get the First Coupon Date

Specified by:

firstCouponDate in class Component

Returns:

First Coupon Date

initialNotional

public double initialNotional()

Description copied from class: Component

Get the Initial Notional for the Product

Specified by:

initialNotional in class Component

Returns:

Initial Notional

notional

public double notional(int dblDate1)

Description copied from class: Component

Get the Notional for the Product at the given date

Specified by:

notional in class Component

Parameters:

dblDate1 - Date

Returns:

Product Notional

notional

public double notional(int dblDate1,
int dblDate2)

Description copied from class: Component

Get the time-weighted Notional for the Product between 2 dates

Specified by:

notional in class Component

Parameters:

dblDate1 - Date #1

dblDate2 - Date #2

Returns:

The Product Notional

freq

public int freq()

Description copied from class: Component

Retrieve the Coupon Frequency

Specified by:

freq in class Component

Returns:

The Coupon Frequency

creditLabel

public EntityCDSLabel creditLabel()

Description copied from interface: ComponentMarketParamRef

Get the Credit Curve Latent State Identifier Label

Returns:

The Credit Curve Latent State Identifier Label

forwardLabel

public CaseInsensitiveTreeMap<ForwardLabel> forwardLabel()

Description copied from interface: ComponentMarketParamRef

Get the Map of Forward Latent State Labels

Returns:

The Map of the Forward Latent State Labels

otcFixFloatLabel

public CaseInsensitiveTreeMap<OTCFixFloatLabel> otcFixFloatLabel()

Description copied from interface: ComponentMarketParamRef

Get the Map of OTC Fix Float Latent State Labels

Returns:

The Map of the OTC Fix Float Latent State Labels

fundingLabel

public FundingLabel fundingLabel()

Description copied from interface: ComponentMarketParamRef

Get the Funding Curve Latent State Label

Returns:

Funding Curve Latent State Label

govvieLabel

public GovvieLabel govvieLabel()

Description copied from interface: ComponentMarketParamRef

Get the Govvie Curve Latent State Label

Returns:

Govvie Curve Latent State Label

fxLabel

public CaseInsensitiveTreeMap<FXLabel> fxLabel()

Description copied from interface: ComponentMarketParamRef

Get the Map of FX Latent State Identifier Labels

Returns:

The Map of FX Latent State Identifier Labels

volatilityLabel

public CaseInsensitiveTreeMap<VolatilityLabel> volatilityLabel()

Description copied from interface: ComponentMarketParamRef

Get the Map of Volatility Latent State Identifier Labels

Returns:

The Map of Volatility Latent State Identifier Labels

couponMetrics

public CompositePeriodCouponMetrics couponMetrics(int iAccrualEndDate,
ValuationParams valParams,
CurveSurfaceQuoteContainer csqs)

Description copied from class: Component

Get the Product's coupon Metrics at the specified accrual date

Specified by:

couponMetrics in class Component

Parameters:

iAccrualEndDate - Accrual End Date

valParams - The Valuation Parameters

csqs - Component Market Parameters

Returns:

The Product's coupon Nominal/Adjusted Coupon Measures

couponPeriods

public java.util.List<CompositePeriod> couponPeriods()

Description copied from class: Component

Get the Product's Cash Flow Periods

Specified by:

couponPeriods in class Component

Returns:

List of the Product's Cash Flow Periods

cashSettleParams

public CashSettleParams cashSettleParams()

Description copied from class: Component

Get the Product's cash settlement parameters

Specified by:

cashSettleParams in class Component

Returns:

Cash settlement Parameters

calibQuoteSet

public ProductQuoteSet calibQuoteSet(LatentStateSpecification[] aLSS)

Description copied from class: CalibratableComponent

Generate the Product Specific Calibration Quote Set

Specified by:

calibQuoteSet in class CalibratableComponent

Parameters:

aLSS - Array of Latent State Specification

Returns:

The Product Specific Calibration Quote Set

calibMeasures

public CaseInsensitiveTreeMap<java.lang.Double> calibMeasures(ValuationParams valParams,
CreditPricerParams pricerParams,
CurveSurfaceQuoteContainer csqs,
ValuationCustomizationParams vcp)

Description copied from class: CalibratableComponent

Generate a Map of the Calibration Measures

Specified by:

calibMeasures in class CalibratableComponent

Parameters:

valParams - Valuation Parameters

pricerParams - Pricer Parameters

csqs - Market Parameters

vcp - Valuation Customization Parameters

Returns:

Map of the Calibration Measures

forwardPRWC

public PredictorResponseWeightConstraint forwardPRWC(ValuationParams valParams,
CreditPricerParams pricerParams,
CurveSurfaceQuoteContainer csqs,
ValuationCustomizationParams vcp,
ProductQuoteSet pqs)

Description copied from class: CalibratableComponent

Generate the Calibratable Linearized Predictor/Response Constraint Weights for the Non-merged Forward Factor Latent State from the Component's Cash Flows. The Constraints here typically correspond to Date/Cash Flow pairs and the corresponding leading PV.

Specified by:

forwardPRWC in class CalibratableComponent

Parameters:

valParams - Valuation Parameters

pricerParams - Pricer Parameters

csqs - Component Market Parameters

vcp - Valuation Customization Parameters

pqs - Product Quote Set

Returns:

The Calibratable Linearized Predictor/Response Constraints (Date/Cash Flow pairs and the corresponding PV)

fundingPRWC

public PredictorResponseWeightConstraint fundingPRWC(ValuationParams valParams,
CreditPricerParams pricerParams,
CurveSurfaceQuoteContainer csqs,
ValuationCustomizationParams vcp,
ProductQuoteSet pqs)

Description copied from class: CalibratableComponent

Generate the Calibratable Linearized Predictor/Response Constraint Weights for the Non-merged Funding Curve Discount Factor Latent State from the Component's Cash Flows. The Constraints here typically correspond to Date/Cash Flow pairs and the corresponding leading PV.

Specified by:

fundingPRWC in class CalibratableComponent

Parameters:

valParams - Valuation Parameters

pricerParams - Pricer Parameters

csqs - Component Market Parameters

vcp - Valuation Customization Parameters

pqs - Product Quote Set

Returns:

The Calibratable Linearized Predictor/Response Constraints (Date/Cash Flow pairs and the corresponding PV)

fundingForwardPRWC

public PredictorResponseWeightConstraint fundingForwardPRWC(ValuationParams valParams,
CreditPricerParams pricerParams,
CurveSurfaceQuoteContainer csqs,
ValuationCustomizationParams vcp,
ProductQuoteSet pqs)

Description copied from class: CalibratableComponent

Generate the Calibratable Linearized Predictor/Response Constraint Weights for the merged Funding and Forward Latent States from the Component's Cash Flows. The Constraints here typically correspond to Date/Cash Flow pairs and the corresponding leading PV.

Specified by:

fundingForwardPRWC in class CalibratableComponent

Parameters:

valParams - Valuation Parameters

pricerParams - Pricer Parameters

csqs - Component Market Parameters

vcp - Valuation Customization Parameters

pqs - Product Quote Set

Returns:

The Calibratable Linearized Predictor/Response Constraints (Date/Cash Flow pairs and the corresponding PV)

fxPRWC

public PredictorResponseWeightConstraint fxPRWC(ValuationParams valParams,
CreditPricerParams pricerParams,
CurveSurfaceQuoteContainer csqs,
ValuationCustomizationParams vcp,
ProductQuoteSet pqs)

Description copied from class: CalibratableComponent

Generate the Calibratable Linearized Predictor/Response Constraint Weights for the Non-merged FX Curve FX Forward Latent State from the Component's Cash Flows. The Constraints here typically correspond to Date/Cash Flow pairs and the corresponding leading PV.

Specified by:

fxPRWC in class CalibratableComponent

Parameters:

valParams - Valuation Parameters

pricerParams - Pricer Parameters

csqs - Component Market Parameters

vcp - Valuation Customization Parameters

pqs - Product Quote Set

Returns:

The Calibratable Linearized Predictor/Response Constraints (Date/Cash Flow pairs and the corresponding FX Forward)

govviePRWC

public PredictorResponseWeightConstraint govviePRWC(ValuationParams valParams,
CreditPricerParams pricerParams,
CurveSurfaceQuoteContainer csqs,
ValuationCustomizationParams vcp,
ProductQuoteSet pqs)

Description copied from class: CalibratableComponent

Generate the Calibratable Linearized Predictor/Response Constraint Weights for the Non-merged Govvie Curve FX Forward Latent State from the Component's Cash Flows. The Constraints here typically correspond to Date/Cash Flow pairs and the corresponding leading PV.

Specified by:

govviePRWC in class CalibratableComponent

Parameters:

valParams - Valuation Parameters

pricerParams - Pricer Parameters

csqs - Component Market Parameters

vcp - Valuation Customization Parameters

pqs - Product Quote Set

Returns:

The Calibratable Linearized Predictor/Response Constraints (Date/Cash Flow pairs and the corresponding Govvie Forward)

jackDDirtyPVDManifestMeasure

public WengertJacobian jackDDirtyPVDManifestMeasure(ValuationParams valParams,
CreditPricerParams pricerParams,
CurveSurfaceQuoteContainer csqs,
ValuationCustomizationParams vcp)

Description copied from class: CalibratableComponent

Compute the Jacobian of the Dirty PV to the Calibrated Input Manifest Measures

Specified by:

jackDDirtyPVDManifestMeasure in class CalibratableComponent

Parameters:

valParams - Valuation Parameters

pricerParams - Pricer Parameters

csqs - Component Market Parameters

vcp - Valuation Customization Parameters

Returns:

The micro-Jacobian

manifestMeasureDFMicroJack

public WengertJacobian manifestMeasureDFMicroJack(java.lang.String strMainfestMeasure,
ValuationParams valParams,
CreditPricerParams pricerParams,
CurveSurfaceQuoteContainer csqs,
ValuationCustomizationParams vcp)

Description copied from class: CalibratableComponent

Compute the micro-Jacobian of the given measure to the DF

Specified by:

manifestMeasureDFMicroJack in class CalibratableComponent

Parameters:

strMainfestMeasure - Manifest Measure Name

valParams - Valuation Parameters

pricerParams - Pricer Parameters

csqs - Component Market Parameters

vcp - Valuation Customization Parameters

Returns:

The micro-Jacobian