optbndbybk

Ценовая облигация, опция из дерева процентных ставок Black-Karasinski

Свернуть все на странице

Синтаксис

[Price,PriceTree] = optbndbybk(BKTree,OptSpec,Strike,ExerciseDates,AmericanOpt,CouponRate,Settle,Maturity)
[Price,PriceTree] = optbndbybk(___,Period,Basis,EndMonthRule,IssueDate,FirstCouponDate,LastCouponDate,StartDate,Face,Options)

Описание

пример

[Price,PriceTree] = optbndbybk(BKTree,OptSpec,Strike,ExerciseDates,AmericanOpt,CouponRate,Settle,Maturity) вычисляет цену для опции облигации из дерева процентных ставок Black-Karasinski.

пример

[Price,PriceTree] = optbndbybk(___,Period,Basis,EndMonthRule,IssueDate,FirstCouponDate,LastCouponDate,StartDate,Face,Options) добавляет необязательные аргументы.

Примеры

свернуть все

Использование дерева процентных ставок BK в deriv.mat файл, цена европейского вызова и put опция на 4% облигации с забастовкой 96. Дата выполнения опции - 01 января 2006 года. Дата погашения облигации - 01 января 2005 года, а дата погашения - 01 января 2009 года.

Загрузите файл deriv.mat, который обеспечивает BKTree. The BKTree структура содержит информацию о времени и форвардной ставке, необходимую для оценки облигации.

load deriv.mat;

Использовать optbondbybk вычислить цену 'call' опция.

[Price,PriceTree] = optbndbybk(BKTree,'Call',96,'01-Jan-2006',... 
0,0.04,'01-Jan-2005','01-Jan-2009')
Warning: OptBonds are valued at Tree ValuationDate rather than Settle. 
> In optbndbytrintree (line 40)
  In optbndbybk (line 92) 
Warning: Not all cash flows are aligned with the tree. Result will be approximated. 
> In optbndbytrintree (line 151)
  In optbndbybk (line 92) 

Price =

    0.1512


PriceTree = 

  struct with fields:

     FinObj: 'BKPriceTree'
      PTree: {[0.1512]  [0.0281 0.1481 0.3119]  [0 0 0.1329 0.3886 0.3086]  [0 0 0 0 0]  [0 0 0 0 0]}
       tObs: [0 1 2 3 4]
    Connect: {[2]  [2 3 4]  [2 2 3 4 4]}
      Probs: {[3×1 double]  [3×3 double]  [3×5 double]}
     ExTree: {[0]  [0 0 0]  [0 0 1 1 1]  [0 0 0 0 0]  [0 0 0 0 0]}

Теперь используйте optbndbybdt для вычисления цены 'put' опция на ту же связь.

[Price,PriceTree] = optbndbybk(BKTree,'Put',96,'01-Jan-2006',... 
0,0.04,'01-Jan-2005','01-Jan-2009')
Warning: OptBonds are valued at Tree ValuationDate rather than Settle. 
> In optbndbytrintree (line 40)
  In optbndbybk (line 92) 
Warning: Not all cash flows are aligned with the tree. Result will be approximated. 
> In optbndbytrintree (line 151)
  In optbndbybk (line 92) 

Price =

    0.0272


PriceTree = 

  struct with fields:

     FinObj: 'BKPriceTree'
      PTree: {[0.0272]  [0.0860 0.0204 0]  [0.0474 0.1266 0 0 0]  [0 0 0 0 0]  [0 0 0 0 0]}
       tObs: [0 1 2 3 4]
    Connect: {[2]  [2 3 4]  [2 2 3 4 4]}
      Probs: {[3×1 double]  [3×3 double]  [3×5 double]}
     ExTree: {[0]  [0 0 0]  [1 1 0 0 0]  [0 0 0 0 0]  [0 0 0 0 0]}

The PriceTree.ExTree выход для 'call' и 'put' опция содержит массивы индикаторов упражнений. Каждый элемент массива ячеек является массивом, содержащим 1где используется опция и 0там, где нет.

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

свернуть все

Древовидная структура процентной ставки, заданная при помощи bktree.

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

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

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

Опции цены значения, заданные как NINST-by- 1 или NINST-by- NSTRIKES в зависимости от типа опции:

  • Европейская опция - NINST-by- 1 вектор значений цены доставки.

  • Бермудская опция - NINST по количеству ударов (NSTRIKES) матрица значений цены доставки. Каждая строка является расписанием для одной опции. Если опция имеет меньше NSTRIKES возможности упражнений, конец строки заполнен NaNс.

  • Американская опция - NINST-by- 1 вектор значений цены доставки для каждой опции.

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

Опции даты упражнений, заданные как NINST-by- 1, NINST-by- 2, или NINST-by- NSTRIKES использование серийных номеров дат или векторов символов дат в зависимости от типа опции:

  • Для европейской опции используйте NINST-by- 1 вектор дат. Для европейской опции существует только один ExerciseDates на дату истечения срока действия опции.

  • Для опции Бермудских островов используйте NINST-by- NSTRIKES вектор дат.

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

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

(Необязательно) Тип опции, заданный как NINST-by- 1 положительные целочисленные флаги со значениями:

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

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

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

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

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

Дата расчета для опции облигации, заданная как NINST-by- 1 вектор серийных номеров дат или векторов символов дат.

Примечание

The Settle дата для каждой облигации устанавливается в ValuationDate дерева BK. Аргумент в пользу Settle игнорируется.

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

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

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

(Необязательно) Купоны в год в виде NINST-by- 1 вектор.

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

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

  • 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

(Необязательно) Флаг правила конца месяца задается как неотрицательное целое число с использованием NINST-by- 1 вектор. Это правило применяется только тогда, когда Maturity - дата окончания месяца для месяца, имеющего 30 или менее дней.

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

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

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

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

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

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

Когда FirstCouponDate и LastCouponDate оба заданы, FirstCouponDate имеет приоритет при определении структуры купонного платежа. Если вы не задаете FirstCouponDateДаты платежа денежного потока определяются из других входов.

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

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

При отсутствии заданного FirstCouponDate, a заданное LastCouponDate определяет купонную структуру облигации. Купонная структура облигации усечена в LastCouponDate, независимо от того, где он падает, и сопровождается только датой движения денежных средств по облигации со сроком погашения. Если вы не задаете LastCouponDateДаты платежа денежного потока определяются из других входов.

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

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

Если вы не задаете StartDate, дата начала вступления в силу является Settle дата.

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

(Необязательно) Грань или номинал, заданные как NINST-by- 1 вектор.

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

(Необязательно) Опции ценообразования производных, заданные как структура, созданная с derivset.

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

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

свернуть все

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

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

  • PriceTree.PTree содержит чистые цены.

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

  • PriceTree.Connect содержит векторы связности. Каждый элемент массива ячеек описывает, как узлы на этом уровне соединяются с следующим. Для заданного уровня дерева существуют NumNodes элементы в векторе, и они содержат индекс узла на следующем уровне, с которым соединяется средняя ветвь. Вычитание 1 из этого значения указывает, где соединяется восходящая ветвь, и добавление 1 указывает, где соединяется нисходящая ветвь.

  • PriceTree.Probs содержит массивы вероятностей. Каждый элемент массива ячеек содержит вероятности перехода вверх, посередине и вниз для каждого узла уровня.

  • PriceTree.ExTree содержит массивы индикаторов упражнений. Каждый элемент массива ячеек является массивом, содержащим 1где используется опция и 0там, где нет.

Подробнее о

свернуть все

Опция облигации

bond option предоставляет держателю право продать облигацию обратно эмитенту (put) или погасить облигацию у его текущего владельца (call) по определенной цене и в определенную дату.

Financial Instruments Toolbox™ поддерживает три типа опционов put и call по облигациям:

  • Американский вариант: Опция, которую вы используете в любое время до истечения срока ее действия.

  • Европейский вариант: Опция, которую вы выполняете только на дату ее истечения.

  • Бермудская опция: Опция напоминает гибрид американских и европейских опций. Ее можно выполнять только в заранее определенные даты, обычно ежемесячно.

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

См. также

| |

Темы

Представлено до R2006a

Документация по продукту Financial Instruments Toolbox

Поддержка

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