exponenta event banner

bndtotalreturn

Общий возврат облигации с фиксированным купоном

Описание

пример

[BondEquiv,EffectiveRate] = bndtotalreturn(Price,CouponRate,Settle,Maturity,ReinvestRate)вычисляет общий доход по облигациям с фиксированным купоном до погашения или до определенного инвестиционного горизонта.

[BondEquiv,EffectiveRate] = bndtotalreturn(___,Name,Value) добавляет необязательные аргументы пары имя-значение.

Примеры

свернуть все

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

Определение облигации с фиксированным купоном.

Price = 101;
CouponRate = 0.05;
Settle = '15-Nov-2011';
Maturity = '15-Nov-2031';
ReinvestRate = 0.04;

Рассчитайте общий возврат к сроку погашения.

[BondEquiv, EffectiveRate] = bndtotalreturn(Price, CouponRate, ...
Settle, Maturity, ReinvestRate)
BondEquiv = 0.0460
EffectiveRate = 0.0466

Укажите горизонт инвестиций.

HorizonDate = '15-Nov-2021';
[BondEquiv, EffectiveRate] = bndtotalreturn(Price, CouponRate, ...
Settle, Maturity, ReinvestRate, 'HorizonDate', HorizonDate)
BondEquiv = 0.0521
EffectiveRate = 0.0528

Выполните анализ сценария по ставке реинвестирования.

ReinvestRate = [0.03; 0.035; 0.04; 0.045; 0.05];
[BondEquiv, EffectiveRate] = bndtotalreturn(Price, CouponRate, ...
Settle, Maturity, ReinvestRate, 'HorizonDate', HorizonDate)
BondEquiv = 5×1

    0.0557
    0.0538
    0.0521
    0.0505
    0.0490

EffectiveRate = 5×1

    0.0565
    0.0546
    0.0528
    0.0511
    0.0496

Использовать bndtotalreturn с datetime входные данные для расчета общей прибыли по облигации с фиксированным купоном с указанием даты инвестиционного горизонта.

Price = 101;
CouponRate = 0.05;
Settle = datetime('15-Nov-2011','Locale','en_US');
Maturity = datetime('15-Nov-2031','Locale','en_US');
HorizonDate = datetime('15-Nov-2021','Locale','en_US');
ReinvestRate = 0.04;
[BondEquiv, EffectiveRate] = bndtotalreturn(Price, CouponRate, ...
Settle, Maturity, ReinvestRate, 'HorizonDate', HorizonDate)
BondEquiv = 0.0521
EffectiveRate = 0.0528

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

свернуть все

Чистая цена на дату расчета, указанная как скаляр или NINSTоколо-1 вектор.

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

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

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

Дата расчета облигации с фиксированным купоном, указанная как скаляр или NINSTоколо-1 вектор серийных номеров дат, векторы символов даты или массивы datetime. Если поставляется в виде NINSTоколо-1 вектор дат, даты расчета могут быть различными, если они находятся до Maturity дата и HorizonDate.

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

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

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

Ставка реинвестирования (ставка, полученная путем реинвестирования купонов), указанная как скалярная или NINSTоколо-2 вектор десятичных значений.

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

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

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

Пример: [BondEquiv,EffectiveRate] = bndtotalreturn(Price,CouponRate,Settle,Maturity,ReinvestRate,'HorizonDate','15-Nov-2021')

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

Если HorizonDate не указан, общая доходность рассчитывается как Maturity.

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

Цена на дату инвестиционного горизонта, указанная как пара, разделенная запятыми, состоящая из 'HorizonPrice' и скаляр или NINSTоколо-1 вектор.

Если HorizonPrice не указан, цена по HorizonDate рассчитывается на основе ReinvestRate. Если HorizonDate равно Maturity дата, HorizonPrice игнорируется, и общий возврат к сроку рассчитывается на основе Face значение.

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

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

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

Базисное число дней, указанное как пара, разделенная запятыми, состоящая из 'Basis' и скаляр или NINSTоколо-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около-1 вектор. Это правило применяется только в том случае, если Maturity - дата окончания месяца, имеющая 30 или менее дней.

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

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

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

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

Если не указать IssueDateдаты оплаты денежного потока определяются из других входных данных.

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

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

Если не указать FirstCouponDateдаты оплаты денежного потока определяются из других входных данных.

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

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

Если не указать LastCouponDateдаты оплаты денежного потока определяются из других входных данных.

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

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

Если не указать StartDate, дата начала действия - Settle дата.

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

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

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

Частота объединения для расчета выхода, указанная как пара, разделенная запятыми, состоящая из 'CompoundingFrequency' и скаляр или NINSTоколо-1 вектор.

  • 1 - Годовое суммирование

  • 2 - Полугодичное компаундирование

  • 3 - Три раза в год

  • 4 - Квартальное суммирование

  • 6 - Компаундирование раз в два месяца

  • 12 - Ежемесячное суммирование

Примечание

По умолчанию базы SIA (0-7) и BUS/252 использовать полугодовое соглашение о компаундировании и базы ICMA (8-12) использовать ежегодное соглашение о компаундировании.

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

Базис, используемый для вычисления коэффициентов дисконтирования для вычисления доходности, указанной как пара, разделенная запятыми, состоящая из 'DiscountBasis' и скаляр или NINSTоколо-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

Дополнительные сведения см. в разделе Базис.

Примечание

Поведение по умолчанию для баз SIA (0-7) для использования actual/actual количество дней для вычисления коэффициентов дисконтирования и количество дней ICMA (812) и BUS/252 для использования указанного DiscountBasis.

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

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

свернуть все

Общий доход в эквиваленте облигаций, возвращенный в виде NUMBONDSоколо-1 вектор.

Общая доходность на основе действующей ставки, возвращенная как NUMBONDSоколо-1 вектор.

Ссылки

[1] Фабоцци, Фрэнк Дж., Манн, Стивен В. Введение в аналитику с фиксированным доходом: анализ относительной стоимости, показатели риска и оценка. Джон Уайли и сыновья, Нью-Йорк, 2010.

Представлен в R2012b