optemfloatbyhw

Цена встроенной опции на ноту плавающей ставки для дерева процентной ставки Халл-Уайт

Описание

пример

[Price,PriceTree] = optemfloatbyhw(HWTree,Spread,Settle,Maturity,OptSpec,Strike,ExerciseDates) цены встраивали опции на купюры с плавающей ставкой из дерева процентных ставок Hull-White. optemfloatbybk вычисляет цены ванильных купюр с плавающей скоростью с встраиваемыми опциями.

пример

[Price,PriceTree] = optemfloatbyhw(___,Name,Value) добавляет необязательные аргументы пары "имя-значение".

Примеры

свернуть все

Определите структуру процентной ставки.

Rates = [0.03;0.034;0.038;0.04];
ValuationDate = 'Jan-1-2012';
StartDates = ValuationDate;
EndDates = {'Jan-1-2013'; 'Jan-1-2014'; 'Jan-1-2015'; 'Jan-1-2016'};
Compounding = 1;

Создайте RateSpec.

RateSpec = intenvset('ValuationDate', ValuationDate, 'StartDates',...
StartDates, 'EndDates', EndDates,'Rates', Rates, 'Compounding', Compounding)
RateSpec = struct with fields:
           FinObj: 'RateSpec'
      Compounding: 1
             Disc: [4x1 double]
            Rates: [4x1 double]
         EndTimes: [4x1 double]
       StartTimes: [4x1 double]
         EndDates: [4x1 double]
       StartDates: 734869
    ValuationDate: 734869
            Basis: 0
     EndMonthRule: 1

Создайте дерево аппаратных средств с помощью следующего:

VolDates = ['1-Jan-2013'; '1-Jan-2014'; '1-Jan-2015';'1-Jan-2016'];
VolCurve = 0.01;
AlphaDates = '01-01-2016';
AlphaCurve = 0.1;

HWVolSpec = hwvolspec(RateSpec.ValuationDate, VolDates, VolCurve,... 
            AlphaDates, AlphaCurve);
HWTimeSpec = hwtimespec(RateSpec.ValuationDate, VolDates, Compounding);
HWT = hwtree(HWVolSpec, RateSpec, HWTimeSpec)
HWT = struct with fields:
      FinObj: 'HWFwdTree'
     VolSpec: [1x1 struct]
    TimeSpec: [1x1 struct]
    RateSpec: [1x1 struct]
        tObs: [0 1 2 3]
        dObs: [734869 735235 735600 735965]
      CFlowT: {[4x1 double]  [3x1 double]  [2x1 double]  [4]}
       Probs: {[3x1 double]  [3x3 double]  [3x5 double]}
     Connect: {[2]  [2 3 4]  [2 3 4 5 6]}
     FwdTree: {[1.0300]  [1.0562 1.0381 1.0202]  [1x5 double]  [1x7 double]}

Определите инструменты плавающего устройства с помощью опции встроенного вызова.

Spread = 10;
Settle = 'Jan-1-2012';
Maturity =  {'Jan-1-2015';'Jan-1-2016'};
Period = 1;
OptSpec = {'call'};
Strike = 101;
ExerciseDates = 'Jan-1-2015';

Вычислите цену плавающих устройств с помощью встроенного вызова.

Price= optemfloatbyhw(HWT, Spread, Settle, Maturity, OptSpec, Strike,...
ExerciseDates)
Price = 2×1

  100.2800
  100.3655

Входные параметры

свернуть все

Дерево процентных ставок, заданное как структура при помощи hwtree.

Типы данных: struct

Количество базисных точек над опорной скоростью, заданное как вектор неотрицательных целых чисел для количества инструментов (NINST) -by- 1).

Типы данных: single | double

Даты расчета примечания с плавающей скоростью, заданные как серийные номера дат или векторы символов даты с использованием NINST-by- 1 вектор дат.

Примечание

The Settle дата для каждого примечания с плавающей скоростью с встроенной опцией устанавливается в ValuationDate дерева HW. Аргумент ноты с плавающей скоростью Settle игнорируется.

Типы данных: double | cell | char

Дата погашения нот с плавающей скоростью, заданная как серийные номера дат или векторы символов даты с использованием NINST-by- 1 вектор дат.

Типы данных: double | cell | char

Определение опции как 'call' или 'put' задается как NINST-by- 1 массив ячеек из векторов символов для 'call' или 'put'.

Типы данных: cell | char

Опция strike price задает неотрицательные целые числа, используя как NINST-by- NSTRIKES вектор значений цены доставки.

Типы данных: single | double

Дата упражнения для опции (европейская, бермудская или американская), заданная как серийные номера дат или векторы символов даты с использованием NINST-by- NSTRIKES или NINST-by- 2 вектор для дат упражнений опции.

  • Если европейская или бермудская опция, ExerciseDates является 1-by- 1 (Европейский) или 1-by- NSTRIKES (Бермудские острова) вектор дат упражнений. Для европейской опции существует только один ExerciseDate на дату истечения срока действия опции.

  • Если американская опция, то ExerciseDates является 1-by- 2 вектор контуров дат упражнения. Опции выполняются на любую дату между или включая пару дат в этой строке. Если существует только один не - NaN дата, или если ExerciseDates является 1-by- 1, опциональные упражнения между Settle дата и сингл перечисленные ExerciseDate.

Типы данных: double | char | cell

Аргументы в виде пар имя-значение

Задайте необязательные разделенные разделенными запятой парами Name,Value аргументы. Name - имя аргумента и Value - соответствующее значение. Name должны находиться внутри кавычек. Можно задать несколько аргументов в виде пар имен и значений в любом порядке Name1,Value1,...,NameN,ValueN.

Пример: [Price,PriceTree] = optemfloatbyhw(HWTree,Spread,Settle,Maturity,OptSpec,Strike,ExerciseDates,'AmericanOpt',1,'FloatReset',6,'Basis',8)

Тип опции, заданный как разделенная разделенными запятой парами, состоящая из 'AmericanOpt' и NINST-by- 1 положительные целочисленные скалярные флаги со значениями:

  • 0 - Европейский/Бермудские острова

  • 1 - Американский

Типы данных: double

Частота платежей в год, заданная как разделенная разделенными запятой парами, состоящая из 'FloatReset' и положительные целые числа для значений [1,2,3,4,6,12] в NINST-by- 1 вектор.

Примечание

Платежи по купюрам с плавающей ставкой (FRN) определяются эффективной процентной ставкой между датами сброса. Если период сброса для FRN охватывает более одного уровня дерева, вычисление платежа становится невозможным из-за рекомбинантного характера дерева. Иными словами, древовидный путь, соединяющий две последовательные даты сброса, не может быть однозначно определен, поскольку существует несколько возможных путей для соединения двух дат платежа.

Типы данных: double

Дневной базис инструмента, заданный как разделенная запятыми пара, состоящая из 'Basis' и положительное целое число с использованием NINST-by- 1 вектор. The Basis значение представляет базис, используемый при аннуализации входа дерева прямой скорости.

  • 0 = факт/факт

  • 1 = 30/360 (SIA)

  • 2 = факт/360

  • 3 = факт/365

  • 4 = 30/360 (PSA)

  • 5 = 30/360 (ISDA)

  • 6 = 30/360 (европейский)

  • 7 = факт/365 (японский)

  • 8 = факт/факт (ICMA)

  • 9 = факт/360 (ICMA)

  • 10 = факт/365 (ICMA)

  • 11 = 30/360E (ICMA)

  • 12 = факт/365 (ISDA)

  • 13 = BUS/252

Для получения дополнительной информации см. раздел Базиса.

Типы данных: double

Флаг правила в конце месяца, заданный как разделенная разделенными запятой парами, состоящая из 'EndMonthRule' и неотрицательное целое число [0, 1] использование NINST-by- 1 вектор. Это правило применяется только тогда, когда Maturity - дата окончания месяца для месяца, имеющего 30 или менее дней.

  • 0 = Игнорируйте правило, означающее, что дата выплаты купона по облигации всегда совпадает с числовым днем месяца.

  • 1 = Установите правило, означающее, что дата выплаты купона по облигации всегда является последним фактическим днем месяца.

Типы данных: double

Основные значения, заданные как разделенная разделенными запятой парами, состоящая из 'Principal' и неотрицательные значения с использованием NINST-by- 1 вектор или NINST-by- 1 массив ячеек условных основных сумм. При использовании NINST-by- 1 массив ячеек, каждый элемент является NumDates-by- 2 массив ячеек, где первый столбец является датами, а второй - связанным основным объемом. Дата указывает на последний день действия основного значения.

Типы данных: double | cell

Структура, содержащая опции ценообразования производных, заданные как разделенная разделенными запятой парами, состоящая из 'Options' и структуру, полученную при использовании derivset.

Типы данных: struct

Выходные аргументы

свернуть все

Ожидаемые цены опции ноты с плавающей ставкой во время 0 возвращаются в виде скаляра или NINST-by- 1 вектор.

Структура деревьев, содержащих векторы цен на приборы и накопленных процентов, и вектор времени наблюдения для каждого узла, возвращаемый как:

  • PriceTree.PTree содержит цены встраиваемых опций.

  • PriceTree.tObs содержит время наблюдения.

Подробнее о

свернуть все

Примечание с плавающей скоростью с встроенными опциями

A floating-rate note with an embedded option позволяет заметкам с плавающей скоростью иметь функции раннего погашения.

FRN с встраиваемой опцией предоставляет инвесторам или эмитентам опцию выбытия непогашенного принципала до погашения. Опция embedded call дает право отменить примечание до даты погашения (callable floater), а опция embedded put дает право продать примечание обратно по определенной цене (pattable floater).

Для получения дополнительной информации смотрите Примечание с плавающей скоростью с встроенными опциями.

Введенный в R2013a
Для просмотра документации необходимо авторизоваться на сайте