zero2pyld (Financial Toolbox)

Par yield curve given a zero curve.

Syntax

[pr, cd] = zero2pyld(zr, cd, sd, ocomp, obasis, icomp, ibasis)
[pr, cd] = zero2pyld(zr, cd, sd, ocomp, obasis, icomp)
[pr, cd] = zero2pyld(zr, cd, sd, ocomp, obasis)
[pr, cd] = zero2pyld(zr, cd, sd, ocomp)
[pr, cd] = zero2pyld(zr, cd, sd)

Arguments

zr: Zero rates. An N-by-1 vector of annualized zero rates, as decimal fractions. In aggregate, the rates in zr constitute an implied zero curve for the investment horizon represented by cd.

cd: Curve dates. An N-by-1 vector of maturity dates (as serial date numbers) that correspond to the zero rates in zr. Use datenum to convert date strings to serial date numbers.

sd: Settlement date. A serial date number that is the common settlement date for the zero rates in zr.

ocomp: Output compounding. A scalar that sets the compounding (coupon) frequency per year for annualizing the output par yield rates in pr. Allowed values are:

1: = annual compounding or one payment per year
2 = semi-annual compounding (default)
3 = compounding three times per year
4 = quarterly compounding
6 = bimonthly compounding
12 = monthly compounding

obasis: Output day-count basis for annualizing the par yield rates in pr.
0 = actual/actual (default), 1 = 30/360, 2 = actual/360, 3 = actual/365.

icomp: Input compounding. A scalar that indicates the compounding frequency per year used for annualizing the input zero rates in zr. Allowed values are the same as for ocomp. Default = ocomp.

ibasis: Input day-count basis used for annualizing the input zero rates in zr.
Allowed values are the same as for obasis. Default = obasis.

Description

[pr, cd] = zero2pyld(zr, cd, sd, ocomp, obasis, icomp, ibasis)

returns a par yield curve given a zero curve and its maturity dates.

pr: Par yield rates. An N-by-1 vector of annualized par yields, as decimal fractions. (Par yields = coupon rates.) In aggregate, the yield rates in pr constitute a par yield curve for the investment horizon represented by cd.

cd: Curve dates. An N-by-1 vector of maturity dates (as serial date numbers) that correspond to the par yield rates in pr. This vector is the same as the input vector cd. Use datestr to convert serial date numbers to date strings.

Example

Given a zero curve zr over a set of maturity dates cd, and a settlement date sd:

zr = [0.0457
      0.0487
      0.0506
      0.0507
      0.0505
      0.0504
      0.0506
      0.0516
      0.0539
      0.0530];
cd = [datenum('06-Nov-1997')
      datenum('11-Dec-1997')
      datenum('15-Jan-1998')
      datenum('05-Feb-1998')
      datenum('04-Mar-1998')
      datenum('02-Apr-1998')
      datenum('30-Apr-1998')
      datenum('25-Jun-1998')
      datenum('04-Sep-1998')
      datenum('12-Nov-1998')];
sd = datenum('03-Nov-1997');

Set annual compounding for the par yield curve, on an actual/actual basis. The zero curve was compounded monthly, on an actual/365 basis.

ocomp = 1;
obasis = 0;
icomp = 12;
ibasis = 3;

Execute the function

[pr, cd] = zero2pyld(zr, cd, sd, ocomp, obasis, icomp, ibasis)

which returns the par yield curve pr at the maturity dates cd:

(For readability, zr and pr are shown only to the basis point. However, MATLAB computed them at full precision. If you enter zr as shown, pr may differ due to rounding.)