instoptembnd

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

Описание

пример

InstSet = instoptembnd(CouponRate,Settle,Maturity,OptSpec,Strike,ExerciseDates) создает новый набор приборов, содержащий Bond с встроенными опционными инструментами.

пример

InstSet = instoptembnd(InstSet,CouponRate,Settle,Maturity,OptSpec,Strike,ExerciseDates) добавляет Bond со встроенными опционными инструментами к существующему набору приборов.

пример

InstSet = instoptembnd(___,Name,Value) использует дополнительные пары "имя-значение" в дополнение к необходимым аргументам в предыдущем синтаксисе.

пример

[FieldList,ClassList,TypeString] = instoptembnd Списки метаданные поля для инструмента Bond опции.

Примеры

свернуть все

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

Settle = 'jan-1-2007';
Maturity   = 'jan-1-2010'; 
CouponRate = 0.07;
OptSpec = 'call'; 
Strike= 100;  
ExerciseDates= {'jan-1-2008' '01-Jan-2010'}; 
AmericanOpt=1;
Period = 1;

InstSet = instoptembnd(CouponRate, ...
Settle, Maturity, OptSpec, Strike,  ExerciseDates,'AmericanOpt', AmericanOpt, ...
'Period', Period);

% display the instrument
 instdisp(InstSet)
Index Type      CouponRate Settle         Maturity       OptSpec Strike ExerciseDates                Period Basis EndMonthRule IssueDate FirstCouponDate LastCouponDate StartDate Face AmericanOpt
1     OptEmBond 0.07       01-Jan-2007    01-Jan-2010    call    100    01-Jan-2008   01-Jan-2010    1      0     1            NaN       NaN             NaN            NaN       100  1          
 

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

свернуть все

Переменная инструмента, заданная только при добавлении встроенных опций инструментов Бонда к существующему набору приборов. Для получения дополнительной информации о InstSet переменная, см. instget.

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

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

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

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

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

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

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

Определение опции, заданное как скаляр или 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 вектор контуров дат упражнения. Опция может быть использована в любую дату между или включая пару дат в этой строке.

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

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

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

Пример: InstSet = instoptembnd(InstSet,CouponRate,Settle,Maturity,OptSpec,Strike,ExerciseDates,'Period',1,'AmericanOp',1)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Дата начала платежей (дата, с которой рассматривается денежный поток облигаций), заданная как разделенная разделенными запятой парами, состоящая из 'StartDate' и скаляр или NINST-by- 1 вектор с использованием серийных номеров дат или векторов символов дат. The StartDate является датой фактического начала облигации (т.е. датой, с которой может учитываться денежный поток облигации). Чтобы сделать опционный инструмент встроенной облигации форвардным, укажите эту дату как будущую дату.

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

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

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

Примечание

Инструменты без Face расписание рассматривается как ванильные облигации или ступенчатые купонные облигации с встраиваемыми опциями.

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

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

свернуть все

Переменная, содержащая набор инструментов, возвращаемая как структура. Инструменты разбиваются по типам, и каждый тип может иметь различные поля данных. Каждое поле сохраненных данных имеет вектор-строку или строку для каждого инструмента. Для получения дополнительной информации о InstSet переменная, см. instget.

Имя каждого поля данных для встроенного опционного инструмента Bond, возвращаемое как NFIELDS-by- 1 массив ячеек из векторов символов.

Класс данных для каждого поля, возвращенный как NFIELDS-by- 1 массив ячеек из векторов символов. Класс определяет, как анализируются аргументы. Допустимые векторы символов 'dble', 'date', и 'char'.

Тип прибора, возвращаемый как вектор символов. Для встроенной опции инструмента Bond, TypeString = 'OptEmBond'.

Подробнее о

свернуть все

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

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

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

Ступенчатая купонная облигация с функциями Callable и Puttable

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

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

Облигация тонущего фонда с опцией Call Embedded

Облигация тонущего фонда - купонная облигация с обеспечением тонущего фонда.

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

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

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

Амортизация callable или puttable облигаций работает в соответствии с запланированным Face.

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

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