DatedOISRateHelper Class Reference

Rate helper for bootstrapping using Overnight Indexed Swaps. More...

#include <qle/termstructures/oisratehelper.hpp>

Inheritance diagram for DatedOISRateHelper:

Collaboration diagram for DatedOISRateHelper:

Public Member Functions
	DatedOISRateHelper (const Date &startDate, const Date &endDate, const Handle< Quote > &fixedRate, const QuantLib::ext::shared_ptr< OvernightIndex > &overnightIndex, const DayCounter &fixedDayCounter, const Calendar &fixedCalendar, Natural paymentLag=0, Frequency paymentFrequency=Annual, BusinessDayConvention fixedConvention=Following, BusinessDayConvention paymentAdjustment=Following, DateGeneration::Rule rule=DateGeneration::Backward, const Handle< YieldTermStructure > &discountingCurve=Handle< YieldTermStructure >(), bool telescopicValueDates=false, Pillar::Choice pillar=Pillar::LastRelevantDate, Date customPillarDate=Date())
RateHelper interface
Real	impliedQuote () const override
void	setTermStructure (YieldTermStructure *) override

Visitability
QuantLib::ext::shared_ptr< OvernightIndex >	overnightIndex_
DayCounter	fixedDayCounter_
Calendar	fixedCalendar_
Natural	paymentLag_
Frequency	paymentFrequency_
BusinessDayConvention	fixedConvention_
BusinessDayConvention	paymentAdjustment_
DateGeneration::Rule	rule_
QuantLib::ext::shared_ptr< OvernightIndexedSwap >	swap_
RelinkableHandle< YieldTermStructure >	termStructureHandle_
Handle< YieldTermStructure >	discountHandle_
RelinkableHandle< YieldTermStructure >	discountRelinkableHandle_
bool	telescopicValueDates_
Pillar::Choice	pillarChoice_
void	accept (AcyclicVisitor &) override

Detailed Description

Rate helper for bootstrapping using Overnight Indexed Swaps.

Definition at line 86 of file oisratehelper.hpp.

Constructor & Destructor Documentation

DatedOISRateHelper()

DatedOISRateHelper	(	const Date &	startDate,
		const Date &	endDate,
		const Handle< Quote > &	fixedRate,
		const QuantLib::ext::shared_ptr< OvernightIndex > &	overnightIndex,
		const DayCounter &	fixedDayCounter,
		const Calendar &	fixedCalendar,
		Natural	paymentLag = 0,
		Frequency	paymentFrequency = Annual,
		BusinessDayConvention	fixedConvention = Following,
		BusinessDayConvention	paymentAdjustment = Following,
		DateGeneration::Rule	rule = DateGeneration::Backward,
		const Handle< YieldTermStructure > &	discountingCurve = Handle<YieldTermStructure>(),
		bool	telescopicValueDates = false,
		Pillar::Choice	pillar = Pillar::LastRelevantDate,
		Date	customPillarDate = Date()
	)

Definition at line 141 of file oisratehelper.cpp.

    : RateHelper(fixedRate), overnightIndex_(overnightIndex), fixedDayCounter_(fixedDayCounter),
      fixedCalendar_(fixedCalendar), paymentLag_(paymentLag), paymentFrequency_(paymentFrequency),
      fixedConvention_(fixedConvention), paymentAdjustment_(paymentAdjustment), rule_(rule),
      discountHandle_(discountingCurve), telescopicValueDates_(telescopicValueDates), pillarChoice_(pillar) {
 
    pillarDate_ = customPillarDate;
 
    bool onIndexHasCurve = !overnightIndex_->forwardingTermStructure().empty();
    bool haveDiscountCurve = !discountHandle_.empty();
    QL_REQUIRE(!(onIndexHasCurve && haveDiscountCurve), "Have both curves nothing to solve for.");
 
    if (!onIndexHasCurve) {
        QuantLib::ext::shared_ptr<IborIndex> clonedIborIndex(overnightIndex_->clone(termStructureHandle_));
        overnightIndex_ = QuantLib::ext::dynamic_pointer_cast<OvernightIndex>(clonedIborIndex);
        overnightIndex_->unregisterWith(termStructureHandle_);
    }
 
    registerWith(overnightIndex_);
    registerWith(discountHandle_);
 
    swap_ = MakeOIS(Period(), overnightIndex_, 0.0)
                .withEffectiveDate(startDate)
                .withTerminationDate(endDate)
                .withFixedLegDayCount(fixedDayCounter_)
                .withPaymentFrequency(paymentFrequency_)
                .withRule(rule_)
                // TODO: patch QL
                //.withFixedAccrualConvention(fixedConvention_)
                // .withFixedCalendar(fixedCalendar_)
                .withPaymentCalendar(overnightIndex_->fixingCalendar())
                .withPaymentAdjustment(paymentAdjustment_)
                .withPaymentLag(paymentLag_)
                .withDiscountingTermStructure(termStructureHandle_)
                .withTelescopicValueDates(telescopicValueDates_);
 
    earliestDate_ = swap_->startDate();
    maturityDate_ = swap_->maturityDate();
 
    Date lastPaymentDate = std::max(swap_->overnightLeg().back()->date(), swap_->fixedLeg().back()->date());
    latestRelevantDate_ = std::max(maturityDate_, lastPaymentDate);
 
    switch (pillarChoice_) {
    case Pillar::MaturityDate:
        pillarDate_ = maturityDate_;
        break;
    case Pillar::LastRelevantDate:
        pillarDate_ = latestRelevantDate_;
        break;
    case Pillar::CustomDate:
        // pillarDate_ already assigned at construction time
        QL_REQUIRE(pillarDate_ >= earliestDate_, "pillar date (" << pillarDate_
                                                                 << ") must be later "
                                                                    "than or equal to the instrument's earliest date ("
                                                                 << earliestDate_ << ")");
        QL_REQUIRE(pillarDate_ <= latestRelevantDate_, "pillar date ("
                                                           << pillarDate_
                                                           << ") must be before "
                                                              "or equal to the instrument's latest relevant date ("
                                                           << latestRelevantDate_ << ")");
        break;
    default:
        QL_FAIL("unknown Pillar::Choice(" << Integer(pillarChoice_) << ")");
    }
 
    // for backwards compatibility
    latestDate_ = pillarDate_;
}

Member Function Documentation

impliedQuote()

Real impliedQuote ( ) const

override

Definition at line 232 of file oisratehelper.cpp.

                                            {
    QL_REQUIRE(termStructure_ != 0, "term structure not set");
    // we didn't register as observers - force calculation
    swap_->deepUpdate();
    return swap_->fairRate();
}

setTermStructure()

void setTermStructure ( YieldTermStructure *  t )

override

Definition at line 216 of file oisratehelper.cpp.

                                                               {
    // do not set the relinkable handle as an observer -
    // force recalculation when needed
    bool observer = false;
 
    QuantLib::ext::shared_ptr<YieldTermStructure> temp(t, null_deleter());
    termStructureHandle_.linkTo(temp, observer);
 
    if (discountHandle_.empty())
        discountRelinkableHandle_.linkTo(temp, observer);
    else
        discountRelinkableHandle_.linkTo(*discountHandle_, observer);
 
    RateHelper::setTermStructure(t);
}

accept()

void accept ( AcyclicVisitor &  v )

override

Definition at line 239 of file oisratehelper.cpp.

                                                 {
    Visitor<DatedOISRateHelper>* v1 = dynamic_cast<Visitor<DatedOISRateHelper>*>(&v);
    if (v1 != 0)
        v1->visit(*this);
    else
        RateHelper::accept(v);
}

Member Data Documentation

overnightIndex_

QuantLib::ext::shared_ptr<OvernightIndex> overnightIndex_

protected

Definition at line 108 of file oisratehelper.hpp.

fixedDayCounter_

DayCounter fixedDayCounter_

protected

Definition at line 109 of file oisratehelper.hpp.

fixedCalendar_

Calendar fixedCalendar_

protected

Definition at line 110 of file oisratehelper.hpp.

paymentLag_

Natural paymentLag_

protected

Definition at line 111 of file oisratehelper.hpp.

paymentFrequency_

Frequency paymentFrequency_

protected

Definition at line 112 of file oisratehelper.hpp.

fixedConvention_

BusinessDayConvention fixedConvention_

protected

Definition at line 113 of file oisratehelper.hpp.

paymentAdjustment_

BusinessDayConvention paymentAdjustment_

protected

Definition at line 114 of file oisratehelper.hpp.

rule_

DateGeneration::Rule rule_

protected

Definition at line 115 of file oisratehelper.hpp.

swap_

QuantLib::ext::shared_ptr<OvernightIndexedSwap> swap_

protected

Definition at line 117 of file oisratehelper.hpp.

termStructureHandle_

RelinkableHandle<YieldTermStructure> termStructureHandle_

protected

Definition at line 118 of file oisratehelper.hpp.

discountHandle_

Handle<YieldTermStructure> discountHandle_

protected

Definition at line 119 of file oisratehelper.hpp.

discountRelinkableHandle_

RelinkableHandle<YieldTermStructure> discountRelinkableHandle_

protected

Definition at line 120 of file oisratehelper.hpp.

telescopicValueDates_

bool telescopicValueDates_

protected

Definition at line 121 of file oisratehelper.hpp.

pillarChoice_

Pillar::Choice pillarChoice_

protected

Definition at line 122 of file oisratehelper.hpp.