ForwardSpreadedTermStructure Class Reference

Term structure with added spread on the instantaneous forward rate. More...

#include <ql/termstructures/yield/forwardspreadedtermstructure.hpp>

Inheritance diagram for ForwardSpreadedTermStructure:

Public Member Functions
	ForwardSpreadedTermStructure (Handle< YieldTermStructure >, Handle< Quote > spread)
TermStructure interface
DayCounter	dayCounter () const override
	the day counter used for date/time conversion
Date	maxDate () const override
	the latest date for which the curve can return values
Time	maxTime () const override
	the latest time for which the curve can return values
const Date &	referenceDate () const override
	the date at which discount = 1.0 and/or variance = 0.0
Calendar	calendar () const override
	the calendar used for reference and/or option date calculation
Natural	settlementDays () const override
	the settlementDays used for reference date calculation
Observer interface
void	update () override
Public Member Functions inherited from ForwardRateStructure
	ForwardRateStructure (const DayCounter &dayCounter=DayCounter())
	ForwardRateStructure (const Date &referenceDate, const Calendar &cal=Calendar(), const DayCounter &dayCounter=DayCounter(), const std::vector< Handle< Quote > > &jumps={}, const std::vector< Date > &jumpDates={})
	ForwardRateStructure (Natural settlementDays, const Calendar &cal, const DayCounter &dayCounter=DayCounter(), const std::vector< Handle< Quote > > &jumps={}, const std::vector< Date > &jumpDates={})
Public Member Functions inherited from YieldTermStructure
	YieldTermStructure (const DayCounter &dc=DayCounter())
	YieldTermStructure (const Date &referenceDate, const Calendar &cal=Calendar(), const DayCounter &dc=DayCounter(), std::vector< Handle< Quote > > jumps={}, const std::vector< Date > &jumpDates={})
	YieldTermStructure (Natural settlementDays, const Calendar &cal, const DayCounter &dc=DayCounter(), std::vector< Handle< Quote > > jumps={}, const std::vector< Date > &jumpDates={})
DiscountFactor	discount (const Date &d, bool extrapolate=false) const
DiscountFactor	discount (Time t, bool extrapolate=false) const
InterestRate	zeroRate (const Date &d, const DayCounter &resultDayCounter, Compounding comp, Frequency freq=Annual, bool extrapolate=false) const
InterestRate	zeroRate (Time t, Compounding comp, Frequency freq=Annual, bool extrapolate=false) const
InterestRate	forwardRate (const Date &d1, const Date &d2, const DayCounter &resultDayCounter, Compounding comp, Frequency freq=Annual, bool extrapolate=false) const
InterestRate	forwardRate (const Date &d, const Period &p, const DayCounter &resultDayCounter, Compounding comp, Frequency freq=Annual, bool extrapolate=false) const
InterestRate	forwardRate (Time t1, Time t2, Compounding comp, Frequency freq=Annual, bool extrapolate=false) const
const std::vector< Date > &	jumpDates () const
const std::vector< Time > &	jumpTimes () const
void	update () override
Public Member Functions inherited from TermStructure
	TermStructure (DayCounter dc=DayCounter())
	default constructor
	TermStructure (const Date &referenceDate, Calendar calendar=Calendar(), DayCounter dc=DayCounter())
	initialize with a fixed reference date
	TermStructure (Natural settlementDays, Calendar, DayCounter dc=DayCounter())
	calculate the reference date based on the global evaluation date
Time	timeFromReference (const Date &date) const
	date/time conversion
Public Member Functions inherited from Observer
	Observer (const Observer &)
Observer &	operator= (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 ()
Public Member Functions inherited from Observable
	Observable (const Observable &)
Observable &	operator= (const Observable &)
	Observable (Observable &&)=delete
Observable &	operator= (Observable &&)=delete
void	notifyObservers ()
Public Member Functions inherited from Extrapolator
void	enableExtrapolation (bool b=true)
	enable extrapolation in subsequent calls
void	disableExtrapolation (bool b=true)
	disable extrapolation in subsequent calls
bool	allowsExtrapolation () const
	tells whether extrapolation is enabled

ForwardRateStructure implementation
Rate	forwardImpl (Time t) const override
	instantaneous forward-rate calculation
Rate	zeroYieldImpl (Time t) const override

Additional Inherited Members
Public Types inherited from Observer
typedef set_type::iterator	iterator
Protected Member Functions inherited from ForwardRateStructure
DiscountFactor	discountImpl (Time) const override
void	checkRange (const Date &d, bool extrapolate) const
	date-range check
void	checkRange (Time t, bool extrapolate) const
	time-range check
bool	moving_ = false
bool	updated_ = true
Calendar	calendar_

Detailed Description

Term structure with added spread on the instantaneous forward rate.

Note

This term structure will remain linked to the original structure, i.e., any changes in the latter will be reflected in this structure as well.

Tests

• the correctness of the returned values is tested by checking them against numerical calculations.
• observability against changes in the underlying term structure and in the added spread is checked.

Member Function Documentation

dayCounter()

DayCounter dayCounter ( ) const

overridevirtual

the day counter used for date/time conversion

Reimplemented from TermStructure.

maxDate()

Date maxDate ( ) const

overridevirtual

the latest date for which the curve can return values

Implements TermStructure.

maxTime()

Time maxTime ( ) const

overridevirtual

the latest time for which the curve can return values

Reimplemented from TermStructure.

referenceDate()

const Date & referenceDate ( ) const

overridevirtual

the date at which discount = 1.0 and/or variance = 0.0

Reimplemented from TermStructure.

calendar()

Calendar calendar ( ) const

overridevirtual

the calendar used for reference and/or option date calculation

Reimplemented from TermStructure.

settlementDays()

Natural settlementDays ( ) const

overridevirtual

the settlementDays used for reference date calculation

Reimplemented from TermStructure.

update()

void update ( )

overridevirtual

This method must be implemented in derived classes. An instance of Observer does not call this method directly: instead, it will be called by the observables the instance registered with when they need to notify any changes.

Implements Observer.

forwardImpl()

Rate forwardImpl ( Time ) const

overrideprotectedvirtual

instantaneous forward-rate calculation

Implements ForwardRateStructure.

zeroYieldImpl()

Rate zeroYieldImpl ( Time ) const

overrideprotectedvirtual

Returns the zero yield rate for the given date calculating it from the instantaneous forward rate \( f(t) \) as

\[z(t) = \int_0^t f(\tau) d\tau \]

Warning

This default implementation uses an highly inefficient and possibly wildly inaccurate numerical integration. Derived classes should override it if a more efficient implementation is available.

Reimplemented from ForwardRateStructure.