QuantLib
A free/open-source library for quantitative finance
Reference manual - version 1.20
Classes | Public Member Functions | List of all members
SyntheticCDO Class Reference

Synthetic Collateralized Debt Obligation. More...

#include <ql/experimental/credit/syntheticcdo.hpp>

+ Inheritance diagram for SyntheticCDO:

Classes

class  engine
 CDO base engine. More...
 

Public Member Functions

 SyntheticCDO (const ext::shared_ptr< Basket > &basket, Protection::Side side, const Schedule &schedule, Rate upfrontRate, Rate runningRate, const DayCounter &dayCounter, BusinessDayConvention paymentConvention, boost::optional< Real > notional=boost::none)
 
const ext::shared_ptr< Basket > & basket () const
 
bool isExpired () const
 returns whether the instrument might have value greater than zero.
 
Rate fairPremium () const
 
Rate fairUpfrontPremium () const
 
Rate premiumValue () const
 
Rate protectionValue () const
 
Real premiumLegNPV () const
 
Real protectionLegNPV () const
 
Real remainingNotional () const
 
Real leverageFactor () const
 
const Datematurity () const
 Last protection date.
 
Real implicitCorrelation (const std::vector< Real > &recoveries, const Handle< YieldTermStructure > &discountCurve, Real targetNPV=0., Real accuracy=1.0e-3) const
 
Disposable< std::vector< Real > > expectedTrancheLoss () const
 
Size error () const
 
void setupArguments (PricingEngine::arguments *) const
 
void fetchResults (const PricingEngine::results *) const
 
- Public Member Functions inherited from Instrument
Real NPV () const
 returns the net present value of the instrument.
 
Real errorEstimate () const
 returns the error estimate on the NPV when available.
 
const DatevaluationDate () const
 returns the date the net present value refers to.
 
template<typename T >
result (const std::string &tag) const
 returns any additional result returned by the pricing engine.
 
const std::map< std::string, boost::any > & additionalResults () const
 returns all additional result returned by the pricing engine.
 
void setPricingEngine (const ext::shared_ptr< PricingEngine > &)
 set the pricing engine to be used. More...
 
- Public Member Functions inherited from LazyObject
void update ()
 
void recalculate ()
 
void freeze ()
 
void unfreeze ()
 
void alwaysForwardNotifications ()
 
- Public Member Functions inherited from Observable
 Observable (const Observable &)
 
Observableoperator= (const Observable &)
 
void notifyObservers ()
 
- Public Member Functions inherited from Observer
 Observer (const Observer &)
 
Observeroperator= (const Observer &)
 
std::pair< iterator, bool > registerWith (const ext::shared_ptr< Observable > &)
 
void registerWithObservables (const ext::shared_ptr< Observer > &)
 
Size unregisterWith (const ext::shared_ptr< Observable > &)
 
void unregisterWithAll ()
 
virtual void deepUpdate ()
 

Additional Inherited Members

- Public Types inherited from Observer
typedef boost::unordered_set< ext::shared_ptr< Observable > > set_type
 
typedef set_type::iterator iterator
 
- Protected Member Functions inherited from Instrument
void calculate () const
 
virtual void performCalculations () const
 
- Protected Member Functions inherited from LazyObject
- Protected Attributes inherited from Instrument
Real NPV_
 
Real errorEstimate_
 
Date valuationDate_
 
std::map< std::string, boost::any > additionalResults_
 
ext::shared_ptr< PricingEngineengine_
 
- Protected Attributes inherited from LazyObject
bool calculated_
 
bool frozen_
 
bool alwaysForward_
 

Detailed Description

Synthetic Collateralized Debt Obligation.

The instrument prices a mezzanine CDO tranche with loss given default between attachment point \( D_1\) and detachment point \( D_2 > D_1 \).

For purchased protection, the instrument value is given by the difference of the protection value \( V_1 \) and premium value \( V_2 \),

\[ V = V_1 - V_2. \]

The protection leg is priced as follows:

The premium is paid on the protected notional amount, initially \( D_2 - D_1. \) This notional amount is reduced by the expected protection payments \( E_i \) at times \( t_i, \) so that the premium value is calculated as

\[ V_2 =m \, \cdot \sum_{i=1}^N \,(D_2 - D_1 - E_i) \cdot \Delta_{i-1,i}\,d_i \]

where \( m \) is the premium rate, \( \Delta_{i-1, i}\) is the day count fraction between date/time \( t_{i-1}\) and \( t_i.\)

The construction of the portfolio loss distribution \( E_i \) is based on the probability bucketing algorithm described in

John Hull and Alan White, "Valuation of a CDO and nth to default CDS without Monte Carlo simulation", Journal of Derivatives 12, 2, 2004

The pricing algorithm allows for varying notional amounts and default termstructures of the underlyings.

Constructor & Destructor Documentation

◆ SyntheticCDO()

SyntheticCDO ( const ext::shared_ptr< Basket > &  basket,
Protection::Side  side,
const Schedule schedule,
Rate  upfrontRate,
Rate  runningRate,
const DayCounter dayCounter,
BusinessDayConvention  paymentConvention,
boost::optional< Real notional = boost::none 
)

If the notional exceeds the basket inception tranche notional, the cdo is leveraged by that factor.

Member Function Documentation

◆ remainingNotional()

Real remainingNotional ( ) const

Total outstanding tranche notional, not wiped out

◆ leverageFactor()

Real leverageFactor ( ) const

The number of times the contract contains the portfolio tranched notional.

◆ implicitCorrelation()

Real implicitCorrelation ( const std::vector< Real > &  recoveries,
const Handle< YieldTermStructure > &  discountCurve,
Real  targetNPV = 0.,
Real  accuracy = 1.0e-3 
) const

The Gaussian Copula LHP implied correlation that makes the contract zero value. This is for a flat correlation along time and portfolio loss level.

◆ expectedTrancheLoss()

Disposable<std::vector<Real> > expectedTrancheLoss ( ) const

Expected tranche loss for all payment dates

◆ setupArguments()

void setupArguments ( PricingEngine::arguments *  ) const
virtual

When a derived argument structure is defined for an instrument, this method should be overridden to fill it. This is mandatory in case a pricing engine is used.

Reimplemented from Instrument.

◆ fetchResults()

void fetchResults ( const PricingEngine::results *  r) const
virtual

When a derived result structure is defined for an instrument, this method should be overridden to read from it. This is mandatory in case a pricing engine is used.

Reimplemented from Instrument.