ConvertibleBond

ConvertibleBond объект прибора

Описание

Создайте и оцените ConvertibleBond объект инструмента, использующий этот рабочий процесс:

  1. Использовать fininstrument для создания ConvertibleBond объект прибора.

  2. Использовать finmodel для задания BlackScholes модель для ConvertibleBond прибора.

  3. Использовать finpricer для задания FiniteDifference метод ценообразования для ConvertibleBond прибора.

Дополнительные сведения об этом рабочем процессе см. в разделе Запуске с рабочими процессами с использованием объектной среды для ценообразования финансовых инструментов.

Для получения дополнительной информации о доступных моделях и методах ценообразования для ConvertibleBond инструмент, см. «Выбор инструментов», «Модели» и «Цены».

Создание

Описание

пример

ConvertibleBondObj = fininstrument(InstrumentType,'CouponRate',couponrate_value,'Maturity',maturity_date,'ConversionRatio',conversion_ratio_value) создает ConvertibleBond объект путем определения InstrumentType и устанавливает свойства для необходимых аргументов пары "имя-значение" CouponRate, Maturity, и ConversionRatio.

пример

ConvertibleBondObj = fininstrument(___,Name,Value) устанавливает необязательные свойства, используя аргументы пары "имя-значение" в дополнение к требуемым аргументам в предыдущем синтаксисе. Для примера, ConvertibleBondObj = fininstrument("ConvertibleBond",'CouponRate',CouponRate, 'Maturity',Maturity,'ConversionRatio',ConvRatio,'Period',Period,'Spread',Spread,'CallSchedule',CallSchedule,'CallExerciseStyle',"american") создает ConvertibleBond инструмент с американским упражнением и расписанием вызовов. Можно задать несколько аргументы пары "имя-значение".

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

расширить все

Тип инструмента, заданный как строка со значением "ConvertibleBond" или вектор символов со значением 'ConvertibleBond'.

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

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

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

Пример: ConvertibleBondObj = fininstrument("ConvertibleBond",'CouponRate',CouponRate, 'Maturity',Maturity,'ConversionRatio',ConvRatio,'Period',Period,'Spread',Spread,'CallSchedule',CallSchedule,'CallExerciseStyle',"american")
Требуемая ConvertibleBond Аргументы в виде пар имя-значение

расширить все

Ставка купона для ConvertibleBond объект, заданный как разделенная разделенными запятой парами, состоящая из 'CouponRate' в виде скалярного десятичного числа для годовой скорости или расписания, где первый столбец является датами, а второй столбец связан со скоростями. Дата указывает на последний день действия ставки купона.

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

Дата погашения ConvertibleBond объект, заданный как разделенная разделенными запятой парами, состоящая из 'Maturity' и скалярное значение datetime, серийный номер даты, вектор символов даты или строка даты.

Если вы используете вектор символов даты или строку даты, формат должен быть распознаваемым datetime потому что Maturity свойство сохранено как datetime.

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

Количество акций, конвертируемых из одной облигации, заданное как разделенная разделенными запятой парами, состоящая из 'ConversionRatio' и скаляр число или расписание, где первый столбец является датами, а второй - связанными коэффициентами. Дата в первом столбце указывает на последний день действия коэффициента преобразования.

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

Необязательные ConvertibleBond Аргументы в виде пар имя-значение

расширить все

Количество базисных точек над ссылочной ставкой, заданное как разделенная разделенными запятой парами, состоящая из 'Spread' и скалярным числом.

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

Расписание вызовов, заданное как разделенная разделенными запятой парами, состоящая из 'CallSchedule' и расписание дат вызовов и забастовок.

Если вы используете вектор символов даты или строку даты для дат в этом расписании, формат должен быть распознаваемым datetime потому что CallSchedule свойство сохранено как datetime.

Примечание

Для ConvertibleBond инструмент, можно использовать CallSchedule с CallExerciseStyle и a PutSchedule с PutExerciseStyle одновременно.

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

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

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

Поместите расписание, заданное как разделенная разделенными запятой парами, состоящая из 'PutSchedule' и расписание дат вызовов и забастовок.

Если вы используете вектор символов даты или строку даты для дат в этом расписании, формат должен быть распознаваемым datetime потому что PutSchedule свойство сохранено как datetime.

Примечание

Для него ConvertibleBond инструмент, можно использовать CallSchedule с CallExerciseStyle и a PutSchedule с PutExerciseStyle одновременно.

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

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

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

Частота платежей в год, заданная как разделенная разделенными запятой парами, состоящая из 'Period' и скалярное целое число. Возможные значения для Period являются 1, 2, 3, 4, 6, и 12.

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

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

Условная сумма основной суммы или график основного значения, заданный как разделенная разделенными запятой парами, состоящая из 'Principal' и скаляр число или расписание.

Principal принимает timetable, где первый столбец является датами, а второй - связанным условным основным значением. Дата указывает на последний день действия основного значения.

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

Флаг, указывающий, корректируется ли денежный поток для соглашения о отсчете дней, заданный как разделенная разделенными запятой парами, состоящая из 'DaycountAdjustedCashFlow' и скаляр логический со значением true или false.

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

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

  • "actual" - Дни небизнеса эффективно игнорируются. Денежные потоки, которые приходятся на нерабочие дни, считаются распределенными на фактическую дату.

  • "follow" - Денежные потоки, которые приходятся на день небизнеса, принимаются распределенными на следующий рабочий день.

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

  • "previous" - Денежные потоки, которые приходятся на день небизнеса, принимаются распределенными в предыдущий рабочий день.

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

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

Праздничные дни, используемые в вычислении рабочих дней, заданные как разделенная разделенными запятой парами, состоящая из 'Holidays' и дат с использованием datetimes, серийных номеров дат, массива ячеек векторов символов дат или строковых массивов дат. Ниже приведен пример.

H = holidays(datetime('today'),datetime(2025,12,15));
ConvertibleBondObj = fininstrument("ConvertibleBond",'CouponRate',0.34,'Maturity',datetime(2025,12,15),...
'ConversionRatio',ConvRatio,'CallSchedule',schedule,'CallExerciseStyle',"american",'Holidays',H)

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

Флаг правила конца месяца для генерации дат при Maturity - дата конца месяца для месяца с 30 или менее дней, заданная как разделенная разделенными запятой парами, состоящая из 'EndMonthRule' и скаляр логическое значение true или false.

  • Если вы задаете EndMonthRule на falseпрограммное обеспечение игнорирует правило, означающее, что дата платежа всегда является одним и тем же числовым днем месяца.

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

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

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

Если вы используете вектор символов даты или строку даты, формат должен быть распознаваемым datetime потому что IssueDate свойство сохранено как datetime.

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

Нерегулярная дата первого купона, заданная как разделенная разделенными запятой парами, состоящая из 'FirstCouponDate' и скалярное значение datetime, серийный номер даты, вектор символов даты или строка даты.

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

Если вы используете вектор символов даты или строку даты, формат должен быть распознаваемым datetime потому что FirstCouponDate свойство сохранено как datetime.

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

Нерегулярная дата последнего купона, заданная как разделенная разделенными запятой парами, состоящая из 'LastCouponDate' и скалярное значение datetime, серийный номер даты, вектор символов даты или строка даты.

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

Если вы используете вектор символов даты или строку даты, формат должен быть распознаваемым datetime потому что LastCouponDate свойство сохранено как datetime.

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

Дата начала пересчета платежей, заданная как разделенная разделенными запятой парами, состоящая из 'StartDate' и скалярное значение datetime, серийный номер даты, вектор символов даты или строка даты.

Если вы используете вектор символов даты или строку даты, формат должен быть распознаваемым datetime потому что StartDate свойство сохранено как datetime.

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

Определяемое пользователем имя инструмента, заданное как разделенная разделенными запятой парами, состоящая из 'Name' и скалярную строку или вектор символов.

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

Свойства

расширить все

Годовая ставка купона, возвращенная в виде скалярного десятичного знака или расписания.

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

Дата погашения, возвращенная как datetime.

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

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

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

Количество базисных точек над частотой ссылки, возвращаемое в виде числа.

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

Расписание вызовов, возвращаемое как расписание.

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

Поставьте расписание, вернитесь как расписание.

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

Купоны в год, возвращаются в виде скалярного целого числа.

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

Базис отсчета дней, возвращенный как скалярное целое число.

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

Условная сумма основной суммы или график основного значения, возвращаемый в виде скалярного числа или расписания.

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

Флаг, указывающий, скорректирован ли денежный поток по соглашению о подсчете дней, возвращен как скалярный логический со значением true или false.

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

Соглашения о рабочих днях, возвращенные как строка

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

Праздничные дни, используемые в вычислении рабочих дней, возвращенные как datetimes.

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

Флаг правила конца месяца для генерации дат при Maturity - дата конца месяца для месяца с 30 или менее дней, возвращаемая как скаляр логическая.

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

Дата выпуска облигаций, возвращенная как datetime.

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

Нерегулярная дата первого купона, возвращенная как datetime.

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

Нерегулярная дата последнего купона, возвращенная как datetime.

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

Форвардная дата начала платежей, возвращенная как datetime.

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

Это свойство доступно только для чтения.

Стиль упражнения опции вызова, возвращенный как строка со значением "European", "American", или "Bermuda".

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

Это свойство доступно только для чтения.

Поместите опцию стиль упражнения, возвращенный как строка со значением "European", "American", или "Bermuda".

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

Определяемое пользователем имя инструмента, возвращаемое как строка.

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

Функции объекта

setCallExercisePolicyУстановите политику выполнения вызовов для OptionEmbeddedFixedBond, OptionEmbeddedFloatBond, или ConvertibleBond инструмент
setPutExercisePolicyУстановите политику упражнений put для OptionEmbeddedFixedBond, OptionEmbeddedFloatBond, или ConvertibleBond инструмент

Примеры

свернуть все

Этот пример показывает рабочий процесс, чтобы оценить ConvertibleBond инструмент, когда вы используете BlackScholes модель и FiniteDifference метод ценообразования.

Создание ConvertibleBond Объект прибора

Использование fininstrument для создания ConvertibleBond объект прибора.

CouponRate = 0;
Maturity = datetime(2014,10,1);
ConvRatio = 2;
Period = 1;
Spread = 0.05;

CallExDates = datetime(2014,10,1);
CallStrike = 115;
CallSchedule = timetable(CallExDates, CallStrike);

ConvBond = fininstrument("ConvertibleBond",'CouponRate',CouponRate,'Maturity',Maturity,'ConversionRatio',ConvRatio,'Period',Period,'Spread',Spread,'CallSchedule',CallSchedule,'CallExercisestyle',"american",'Name',"Convertible_Bond")
ConvBond = 
  ConvertibleBond with properties:

                  CouponRate: 0
             ConversionRatio: 2
                      Spread: 0.0500
                      Period: 1
                       Basis: 0
                EndMonthRule: 1
                   Principal: 100
    DaycountAdjustedCashFlow: 0
       BusinessDayConvention: "actual"
                    Holidays: NaT
                    Maturity: 01-Oct-2014
                   IssueDate: NaT
             FirstCouponDate: NaT
              LastCouponDate: NaT
                   StartDate: NaT
                CallSchedule: [1x1 timetable]
                 PutSchedule: [0x0 timetable]
           CallExerciseStyle: "american"
            PutExerciseStyle: [0x0 string]
                        Name: "Convertible_Bond"

Создание BlackScholes Объект модели

Использование finmodel для создания BlackScholes объект модели.

AssetPrice = 50;
Volatility = 0.3;

BSModel = finmodel("BlackScholes",'Volatility',Volatility)
BSModel = 
  BlackScholes with properties:

     Volatility: 0.3000
    Correlation: 1

Создание ratecurve Объект

Создайте ratecurve объект, использующий ratecurve.

StartDate = datetime(2014,1,1);
EndDate = datetime(2015,1,1);
Rate = 0.1;

ZeroCurve = ratecurve('zero',StartDate,EndDate,Rate,'Compounding',-1,'Basis',1)
ZeroCurve = 
  ratecurve with properties:

                 Type: "zero"
          Compounding: -1
                Basis: 1
                Dates: 01-Jan-2015
                Rates: 0.1000
               Settle: 01-Jan-2014
         InterpMethod: "linear"
    ShortExtrapMethod: "next"
     LongExtrapMethod: "previous"

Создание FiniteDifference Объект прейскуранта

Использование finpricer для создания FiniteDifference и используйте объект pricer ratecurve объект для 'DiscountCurve' аргумент пары "имя-значение".

outPricer = finpricer("FiniteDifference",'Model',BSModel,'SpotPrice',AssetPrice,'DiscountCurve',ZeroCurve)
outPricer = 
  FiniteDifference with properties:

     DiscountCurve: [1x1 ratecurve]
             Model: [1x1 finmodel.BlackScholes]
         SpotPrice: 50
    GridProperties: [1x1 struct]
      DividendType: "continuous"
     DividendValue: 0

Ценовые ConvertibleBond Инструмент

Использование price вычислить цену и чувствительность для ConvertibleBond прибора.

[Price, outPR] = price(outPricer,ConvBond,"all")
Price = 104.3812
outPR = 
  priceresult with properties:

       Results: [1x7 table]
    PricerData: [1x1 struct]

outPR.Results
ans=1×7 table
    Price     Delta      Gamma     Lambda      Theta       Rho       Vega 
    ______    ______    _______    _______    _______    _______    ______

    104.38    1.3012    0.04195    0.62329    0.72984    -21.883    17.947

Подробнее о

расширить все

Совет

После создания ConvertibleBond объект, можно изменить CallSchedule и CallExerciseStyle использование setCallExercisePolicy. Можно изменить PutSchedule и PutExerciseStyle значения с использованием setPutExercisePolicy.

Введенный в R2021a