bondbybk

Ценовая связь от Черного-Karasinski дерева процентной ставки

Синтаксис

[Price,PriceTree] = bondbybk(BKTree,CouponRate,Settle,Maturity)
[Price,PriceTree] = bondbybk(___,Name,Value)

Описание

пример

[Price,PriceTree] = bondbybk(BKTree,CouponRate,Settle,Maturity) ценовая связь от Черного-Karasinski дерева процентной ставки. bondbybk вычисляет цены связей ванили, продвинулся связи амортизации и облигации на предъявителя.

пример

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

Примеры

свернуть все

Оцените 4%-ю связь с помощью Черного-Karasinski дерева процентной ставки.

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

load deriv.mat;

Задайте связь с помощью обязательных аргументов. Другие аргументы используют значения по умолчанию.

CouponRate = 0.04;
Settle = '01-Jan-2004';
Maturity = '31-Dec-2008';

Используйте bondbybk, чтобы вычислить цену связи.

Price = bondbybk(BKTree, CouponRate, Settle, Maturity)
Warning: Not all cash flows are aligned with the tree. Result will be approximated.
Price = 98.0300

Цена одна ступенчатые облигации на предъявителя с помощью данных о рынке.

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

Rates = [0.035; 0.042147; 0.047345; 0.052707];
ValuationDate = 'Jan-1-2010';
StartDates = ValuationDate;
EndDates = {'Jan-1-2011'; 'Jan-1-2012';...
'Jan-1-2013'; 'Jan-1-2014'};
Compounding = 1;

Создайте RateSpec.

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

Создайте ступенчатый инструмент связи.

Settle = '01-Jan-2010';
Maturity = {'01-Jan-2011';'01-Jan-2012';'01-Jan-2013';'01-Jan-2014'};
CouponRate = {{'01-Jan-2012' .0425;'01-Jan-2014' .0750}};
Period = 1;

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

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

BKVolSpec = bkvolspec(RS.ValuationDate, VolDates, VolCurve,... 
AlphaDates, AlphaCurve);
BKTimeSpec = bktimespec(RS.ValuationDate, VolDates, Compounding);
BKT = bktree(BKVolSpec, RS, BKTimeSpec);

Вычислите цену ступенчатых облигаций на предъявителя.

PBK= bondbybk(BKT, CouponRate, Settle,Maturity , Period)
PBK = 4×1

  100.7246
  100.0945
  101.5900
  102.0820

Оцените связь с расписанием амортизации с помощью входного параметра Face, чтобы задать расписание.

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

Rates = 0.065;
ValuationDate = '1-Jan-2011';
StartDates = ValuationDate;
EndDates=  '1-Jan-2017';
Compounding = 1;

Создайте RateSpec.

RateSpec = intenvset('ValuationDate', ValuationDate,'StartDates', StartDates,...
'EndDates', EndDates,'Rates', Rates, 'Compounding', Compounding)
RateSpec = struct with fields:
           FinObj: 'RateSpec'
      Compounding: 1
             Disc: 0.6853
            Rates: 0.0650
         EndTimes: 6
       StartTimes: 0
         EndDates: 736696
       StartDates: 734504
    ValuationDate: 734504
            Basis: 0
     EndMonthRule: 1

Создайте инструмент связи. Связь имеет купонную ставку 7%, период одного года, и назревает 1 января 2017.

CouponRate = 0.07;
Settle ='1-Jan-2011';
Maturity = '1-Jan-2017';
Period = 1;
Face = {{'1-Jan-2015' 100;'1-Jan-2016' 90;'1-Jan-2017' 80}};

Создайте дерево BK со следующими данными о рынке:

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

BKVolSpec = bkvolspec(RateSpec.ValuationDate, VolDates, VolCurve,... 
AlphaDates, AlphaCurve);
BKTimeSpec = bktimespec(RateSpec.ValuationDate, VolDates, Compounding);
BKT = bktree(BKVolSpec, RateSpec, BKTimeSpec);

Вычислите цену связи амортизации.

Price = bondbybk(BKT, CouponRate, Settle, Maturity, 'Period', Period,...
'Face', Face)
Price = 102.3155

Сравните результаты с ценой связи ванили.

PriceVanilla = bondbybk(BKT, CouponRate, Settle, Maturity, Period)
PriceVanilla = 102.4205

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

свернуть все

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

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

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

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

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

Дата Settle каждой связи назначена к ValuationDate дерева BK. Аргумент Settle связи проигнорирован.

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

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

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

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

Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (Name) — это имя аргумента, а значение (Value) — соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: [Price,PriceTree] = bondbybk(BKTree,CouponRate,Settle,Maturity,'Period',4,'Face',10000)

Купоны в год, заданный как пара, разделенная запятой, состоящая из 'Period' и NINST-by-1 вектор. Значениями для Period является 1, 2, 3, 4, 6 и 12.

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

Основание дневного количества инструмента, заданного как пара, разделенная запятой, состоящая из 'Basis' и NINST-by-1 вектор.

  •  0 = фактический/фактический

  •  1 = 30/360 (СИА)

  •  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 = ШИНА/252

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

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

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

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

  • 1 = Установленное правило о, означая, что платежный день всегда является прошлым фактическим днем месяца.

Типы данных: логический

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

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

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

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

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

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

В отсутствие заданного FirstCouponDate заданный LastCouponDate определяет структуру купона связи. Структура купона связи является усеченной в LastCouponDate, независимо от того, где это падает и сопровождается только датой потока наличности зрелости связи. Если вы не задаете LastCouponDate, платежные дни потока наличности определяются от других входных параметров.

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

Передайте срок начала работы платежей (дата, с которой поток наличности связи рассматривается), заданный как пара, разделенная запятой, состоящая из 'StartDate' и NINST-by-1 вектор с помощью последовательных чисел даты или векторов символов даты.

Если вы не задаете StartDate, эффективная дата начала является датой Settle.

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

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

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

Производные оценивая опции, заданные как пара, разделенная запятой, состоящая из 'Options' и структуры, которая создается с derivset.

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

Отметьте, чтобы настроить потоки наличности на основе фактического дневного количества периода, заданного как пара, разделенная запятой, состоящая из 'AdjustCashFlowsBasis' и NINST-by-1 вектор logicals со значениями (FALSE) 0 или (TRUE) 1.

Типы данных: логический

Соглашения рабочего дня, заданные как пара, разделенная запятой, состоящая из 'BusinessDayConvention' и вектора символов или N-by-1 (или NINST-by-2, если BusinessDayConvention отличается для каждого участка), массив ячеек из символьных векторов соглашений рабочего дня. Выбор для соглашения рабочего дня определяет, как обработаны нерабочие дни. Нерабочие дни заданы как выходные плюс любая другая дата, что компании не открыты (например, установленные законом праздники). Значения:

  • actual — Нерабочие дни эффективно проигнорированы. Потоки наличности, которые падают в нерабочие дни, приняты, чтобы быть распределенными в фактическую дату.

  • follow — Потоки наличности, которые падают в нерабочий день, приняты, чтобы быть распределенными в следующий рабочий день.

  • modifiedfollow — Потоки наличности, которые падают в нерабочий день, приняты, чтобы быть распределенными в следующий рабочий день. Однако, если следующий рабочий день находится в различном месяце, предыдущий рабочий день принят вместо этого.

  • previous — Потоки наличности, которые падают в нерабочий день, приняты, чтобы быть распределенными в предыдущий рабочий день.

  • modifiedprevious — Потоки наличности, которые падают в нерабочий день, приняты, чтобы быть распределенными в предыдущий рабочий день. Однако, если предыдущий рабочий день находится в различном месяце, следующий рабочий день принят вместо этого.

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

Праздники используются в вычислении рабочих дней, заданных как пара, разделенная запятой, состоящая из 'Holidays' и чисел даты MATLAB с помощью NHolidays-by-1 вектор.

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

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

свернуть все

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

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

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

  • PriceTree.AITree содержит начисленные проценты.

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

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

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

Больше о

свернуть все

Связь ванили

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

Выпускающий связи делает периодические выплаты процентов, пока связь не назревает. В зрелости выпускающий выплачивает держателю связи основную сумму, бывшую должную (номинальную стоимость) и последнюю выплату процентов.

Ступенчатая облигация на предъявителя

Связь повышения и понижения является долговой безопасностью с предопределенной структурой купона в зависимости от времени.

С этими инструментами увеличение купонов (подходит) или уменьшается (уходят) в конкретные моменты времени во время жизни связи.

Связь с расписанием амортизации

Амортизируемая связь обработана как актив с суммой скидки, амортизируемой к процентным расходам по жизни связи.

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

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