/usr/include/ql/instruments/cpicapfloor.hpp is in libquantlib0-dev 1.7.1-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 | /* -*- mode: c++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*
Copyright (C) 2010, 2011 Chris Kenyon
This file is part of QuantLib, a free-software/open-source library
for financial quantitative analysts and developers - http://quantlib.org/
QuantLib is free software: you can redistribute it and/or modify it
under the terms of the QuantLib license. You should have received a
copy of the license along with this program; if not, please email
<quantlib-dev@lists.sf.net>. The license is also available online at
<http://quantlib.org/license.shtml>.
This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the license for more details.
*/
/*! \file cpicapfloor.hpp
\brief zero-inflation-indexed-ratio-with-base option
*/
#ifndef quantlib_cpicapfloor_hpp
#define quantlib_cpicapfloor_hpp
#include <ql/instrument.hpp>
#include <ql/option.hpp>
#include <ql/time/calendar.hpp>
#include <ql/time/daycounter.hpp>
#include <ql/indexes/inflationindex.hpp>
#include <ql/cashflows/cpicoupon.hpp>
namespace QuantLib {
//! CPI cap or floor
/*! Quoted as a fixed strike rate \f$ K \f$. Payoff:
\f[
P_n(0,T) \max(y (N [(1+K)^{T}-1] -
N \left[ \frac{I(T)}{I(0)} -1 \right]), 0)
\f]
where \f$ T \f$ is the maturity time, \f$ P_n(0,t) \f$ is the
nominal discount factor at time \f$ t \f$, \f$ N \f$ is the
notional, and \f$ I(t) \f$ is the inflation index value at
time \f$ t \f$.
Inflation is generally available on every day, including
holidays and weekends. Hence there is a variable to state
whether the observe/fix dates for inflation are adjusted or
not. The default is not to adjust.
N.B. a cpi cap or floor is an option, not a cap or floor on a coupon.
Thus this is very similar to a ZCIIS and has a single flow, this is
as usual for cpi because it is cumulative up to option maturity from base
date.
We do not inherit from Option, although this would be reasonable,
because we do not have that degree of generality.
*/
class CPICapFloor : public Instrument {
public:
class arguments;
class results;
class engine;
CPICapFloor(Option::Type type,
Real nominal,
const Date& startDate, // start date of contract (only)
Real baseCPI,
const Date& maturity, // this is pre-adjustment!
const Calendar& fixCalendar,
BusinessDayConvention fixConvention,
const Calendar& payCalendar,
BusinessDayConvention payConvention,
Rate strike,
const Handle<ZeroInflationIndex> &infIndex,
const Period& observationLag,
CPI::InterpolationType observationInterpolation = CPI::AsIndex);
//! \name Inspectors
//@{
Option::Type type() const { return type_; }
Real nominal() const { return nominal_; }
//! \f$ K \f$ in the above formula.
Rate strike() const { return strike_; }
Date fixingDate() const;
Date payDate() const;
Handle<ZeroInflationIndex> inflationIndex() const { return infIndex_; }
Period observationLag() const { return observationLag_; }
//@}
//! \name Instrument interface
//@{
bool isExpired() const;
void setupArguments(PricingEngine::arguments*) const;
void fetchResults(const PricingEngine::results* r) const;
//@}
protected:
Option::Type type_;
Real nominal_;
Date startDate_, fixDate_, payDate_;
Real baseCPI_;
Date maturity_;
Calendar fixCalendar_;
BusinessDayConvention fixConvention_;
Calendar payCalendar_;
BusinessDayConvention payConvention_;
Rate strike_;
Handle<ZeroInflationIndex> infIndex_;
Period observationLag_;
CPI::InterpolationType observationInterpolation_;
};
class CPICapFloor::arguments : public virtual PricingEngine::arguments{
public:
Option::Type type;
Real nominal;
Date startDate, fixDate, payDate;
Real baseCPI;
Date maturity;
Calendar fixCalendar, payCalendar;
BusinessDayConvention fixConvention, payConvention;
Rate strike;
Handle<ZeroInflationIndex> infIndex;
Period observationLag;
CPI::InterpolationType observationInterpolation;
void validate() const;
};
class CPICapFloor::results : public Instrument::results {
public:
void reset();
};
class CPICapFloor::engine : public GenericEngine<CPICapFloor::arguments,
CPICapFloor::results> {
};
};
#endif
|