bndtotalreturn

Совокупный доход фиксированной облигации на предъявителя

Синтаксис

[BondEquiv,EffectiveRate] = bndtotalreturn(Price,CouponRate,Settle,Maturity,ReinvestRate)
[BondEquiv,EffectiveRate] = bndtotalreturn(___,Name,Value)

Описание

пример

[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-by-1 вектор.

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

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

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

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

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

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

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

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

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

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

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

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

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

Если HorizonDate не задан, совокупный доход вычисляется к Maturity.

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

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

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

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

Количество купонных платежей в год, заданный как пара, разделенная запятой, состоящая из 'Period' и скаляра или NINST-by-1 вектор с помощью значений: 0, 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Соединение частоты для вычисления урожая, заданного как пара, разделенная запятой, состоящая из 'CompoundingFrequency' и скаляра или NINST-by-1 вектор.

  • 1 — Ежегодное соединение

  • 2 — Полугодовое соединение

  • 3 — Соединение три раза в год

  • 4 — Ежеквартально соединение

  • 6 — Два раза в месяц соединение

  • 12 — Ежемесячно соединение

Примечание

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

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

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

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

Примечание

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

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

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

свернуть все

Совокупный доход в связи эквивалентное основание, возвращенное как NUMBONDS-by-1 вектор.

Совокупный доход в эффективном основании уровня, возвращенном как NUMBONDS-by-1 вектор.

Ссылки

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

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

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