oasbyhw

Решите, что опция настроила распространение с помощью модели Hull-White

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

Синтаксис

[OAS,OAD,OAC] = oasbyhw(HWTree,Price,CouponRate,Settle,Maturity,OptSpec,Strike,ExerciseDates)
[OAS,OAD,OAC] = oasbyhw(___,Name,Value)

Описание

пример

[OAS,OAD,OAC] = oasbyhw(HWTree,Price,CouponRate,Settle,Maturity,OptSpec,Strike,ExerciseDates) вычисляет опция настроила распространение с помощью модели Hull-White.

oasbyhw вычисляет цены связей ванили со встроенными опциями, продвинулся облигации на предъявителя со встроенными опциями, амортизировав связи со встроенными опциями, и связи амортизационного фонда с вызовом встроили опцию. Для получения дополнительной информации смотрите Больше О.

пример

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

Примеры

свернуть все

Скрипт Open Live Script

В этом примере показано, как вычислить OAS и OAD использование модели Hull-White (HW) с помощью следующих данных.

ValuationDate = 'October-25-2010';
Rates = [0.0355; 0.0382; 0.0427; 0.0489];
StartDates = ValuationDate;
EndDates = datemnth(ValuationDate, 12:12:48)';
Compounding = 1;

% define RateSpec
RateSpec = intenvset('ValuationDate', ValuationDate,...
'StartDates', StartDates, 'EndDates', EndDates, ...
'Rates', Rates,'Compounding', Compounding); 

% specify VolsSpec and TimeSpec
Sigma = 0.05;
Alpha = 0.01;
VS = hwvolspec(ValuationDate, EndDates, Sigma*ones(size(EndDates)),...
EndDates, Alpha*ones(size(EndDates)));
TS = hwtimespec(ValuationDate, EndDates, Compounding);

% build the HW tree
HWTree = hwtree(VS, RateSpec, TS);

% instrument information
CouponRate = 0.045;
Settle = ValuationDate;
Maturity = '25-October-2014';
OptSpec = 'call';
Strike = 100;
ExerciseDates = {'25-October-2010','25-October-2013'};
Period = 1;
AmericanOpt = 0;
Price = 97;

% compute the OAS
[OAS, OAD] = oasbyhw(HWTree, Price, CouponRate, Settle, Maturity,...
OptSpec, Strike, ExerciseDates, 'Period', Period, 'AmericanOpt', AmericanOpt)
OAS = -12.8538

OAD = 3.2910
Скрипт Open Live Script

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

Используйте следующие данные о связи: 

Settle = datenum('20-Aug-2014');

% Bond Properties
Maturity = datenum('01-Apr-2034');
CouponRate = .0625;
CallDates = datemnth('01-Oct-2014',6*(0:19));
CallStrikes = [102.85 102.7 102.55 102.4 102.25 102.1 101.95 101.8 ...
    101.65 101.5 101.35 101.2 101.05 100.9 100.75 100.6 100.45 100.3 ...
    100.15 100];

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

CurveDates = datemnth(Settle,12*[1 2 3 5 7 10 20 30]');
ZeroRates = [.11 0.30 0.64 1.44 2.07 2.61 3.29 3.55]'/100;

Задайте RateSpec и создайте дерево HW. 

RateSpec = intenvset('StartDate',Settle,'EndDates',CurveDates,'Rates',ZeroRates);

% HW Model Properties
alpha = .1;
sigma = .01;

TimeSpec = hwtimespec(Settle,cfdates(Settle,Maturity,12),2);
VolSpec = hwvolspec(Settle,Maturity,sigma,Maturity,alpha);

HWTree = hwtree(VolSpec,RateSpec,TimeSpec,'method','HW2000')
HWTree = struct with fields:
      FinObj: 'HWFwdTree'
     VolSpec: [1x1 struct]
    TimeSpec: [1x1 struct]
    RateSpec: [1x1 struct]
        tObs: [1x236 double]
        dObs: [1x236 double]
      CFlowT: {1x236 cell}
       Probs: {1x235 cell}
     Connect: {1x235 cell}
     FwdTree: {1x236 cell}

Вычислите OAS для связи. 

Price = 103.25;
OAS = oasbyhw(HWTree, Price, CouponRate, Settle, Maturity, 'call', CallStrikes, CallDates)
OAS = 234.8209

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

Скрипт Open Live Script

В этом примере показано, как вычислить OAS для амортизирующей вызываемой связи с помощью модели решетки HW.

Создайте RateSpec.

Rates = [0.035; 0.042147; 0.047345; 0.052707];
ValuationDate = 'Jan-1-2012';
StartDates = ValuationDate;
EndDates = {'Jan-1-2013'; 'Jan-1-2014'; 'Jan-1-2015'; 'Jan-1-2016'};
Compounding = 1;
RS = intenvset('ValuationDate', ValuationDate, 'StartDates', StartDates,...
'EndDates', EndDates,'Rates', Rates, 'Compounding', Compounding);

Создайте дерево HW.

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(RS.ValuationDate, VolDates, VolCurve,... 
AlphaDates, AlphaCurve);
HWTimeSpec = hwtimespec(RS.ValuationDate, EndDates, Compounding);
HWT = hwtree(HWVolSpec, RS, HWTimeSpec);

Задайте вызываемую связь.

CouponRate = 0.05;
Settle = 'Jan-1-2012';
Maturity =  'Jan-1-2016';
Period = 1;
    
    Face = { 
                 {'Jan-1-2014'  100; 
                  'Jan-1-2015'   70;
                  'Jan-1-2016'   50};
                 };
 
OptSpec = 'call'; 
Strike = [97 95 93];
ExerciseDates ={'Jan-1-2014' 'Jan-1-2015' 'Jan-1-2016'};

Вычислите OAS для вызываемой связи амортизации с помощью дерева HW.

Price = 55;
BondType = 'amortizing';
OAS = oasbyhw(HWT,Price, CouponRate, Settle, Maturity,...
OptSpec, Strike, ExerciseDates, 'Period', Period, 'Face', Face,'BondType', BondType)
OAS = 2.4023e+03

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

свернуть все

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

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

Рыночные цены связей со встроенными опциями в виде NINST- 1 вектор.

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

Уровень облигационного купона в виде NINST- 1 десятичный годовой показатель.

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

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

Примечание

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

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

Дата погашения в виде NINST- 1 вектор из последовательных чисел даты или векторов символов даты.

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

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

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

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

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

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

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

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

Даты осуществления опции в виде NINST- 1, NINST- 2, или NINST- NSTRIKES использование последовательных чисел даты или векторов символов даты, в зависимости от типа опции:

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

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

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

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

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

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

Пример: OAS = oasbybk(BDTTree,Price,CouponRate,Settle,Maturity,OptSpec,Strike,ExerciseDates,'Period',4)

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

  • 0 — Европеец/Бермуды

  • 1 — Американец

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

Купоны в год в виде разделенной запятой пары, состоящей из 'Period' и NINST- 1 вектор.

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

Основание дневного количества в виде разделенной запятой пары, состоящей из 'Basis' и NINST- 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Тип базовой связи в виде разделенной запятой пары, состоящей из 'BondType' и NINST- 1 массив ячеек из символьных векторов или массив строк, задающий, является ли базовой связь ванили, связь амортизации или вызываемая связь амортизационного фонда. Поддерживаемые типы:

  • 'vanilla'стандартная вызываемая или связь с правом досрочного погашения со скалярным Face значение и один купон или продвинулись купоны.

  • 'callablesinking' связь с расписанием Face значения и условие досрочного выкупа амортизационного фонда с синглом или ступенчатыми купонами.

  • 'amortizing' амортизирующая вызываемая или связь с правом досрочного погашения с расписанием Face значения с одним или ступенчатыми купонами.

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

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

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

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

свернуть все

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

Опция настроила длительность, возвращенную как NINST- 1 вектор.

Опция настроила выпуклость, возвращенную как NINST- 1 вектор.

Больше о

свернуть все

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

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

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

Ступенчатая облигация на предъявителя с вызываемыми и функциями с правом досрочного погашения

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

С этими инструментами увеличение купонов (подходит) или уменьшается (уходят) в конкретные моменты времени во время жизни связи. Ступенчатые облигации на предъявителя могут иметь функции опций (вызовите, и помещает).

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

Связь амортизационного фонда является облигацией на предъявителя с условием амортизационного фонда.

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

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

Амортизация вызываемой или связи с правом досрочного погашения

Амортизирующие вызываемые или связи с правом досрочного погашения работают под запланированным Face.

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

Ссылки

[1] Fabozzi, F. Руководство ценных бумаг фиксированного дохода. 7-й выпуск. McGraw-Hill, 2005.

[2] Windas, T. Введение в настроенный опцией анализ распространения. 3-й выпуск. Нажатие Bloomberg, 2007.

Смотрите также

| | | | | |

Темы

Введенный в R2011a

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

Поддержка

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