## Documentation |

This example shows how to use objects to model the term structure of interest rates (also referred to as the yield curve). This can be contrasted with modeling the term structure with vectors of dates and data and interpolating between the points (which can currently be done with the function PRBYZERO).

The term structure can refer to at least three different curves: the discount curve, zero curve, or forward curve.

The new object IRFunctionCurve allows the user to model an interest rate curve as a function.

This example will explore using IRFunctionCurve to model the default-free term structure of interest rates in the United Kingdom. Three different forms for the term structure will be implemented, which will be discussed in more detail later:

Nelson-Siegel

Svensson

Smoothing Cubic Spline with a so-called Variable Roughness Penalty (VRP)

On this page… |
---|

Fit Nelson-Siegel Model to Market Data |

The first question in modeling the yield curve is what data should be used. To model a default-free yield curve, default-free, option-free market instruments must be used. The most significant component of the data set will be UK Government Bonds (known as Gilts). Historical data was retrieved from the following site:

Repo data will be used to construct the short end of the curve. Repo data was retrieved from the following site:

Note also that the data must be specified as a matrix where the columns are Settle, Maturity, CleanPrice and CouponRate -- and that instruments must be bonds or synthetically converted to bonds.

Market data for a close date of April 30, 2008, has been downloaded and saved to the following data file, which can be loaded into MATLAB® with the following command

% Load the data load ukdata20080430 % Convert repo rates to be equivalent zero coupon bonds RepoCouponRate = repmat(0,size(RepoRates)); RepoPrice = bndprice(RepoRates, RepoCouponRate, RepoSettle, RepoMaturity); % Aggregate the data Settle = [RepoSettle;BondSettle]; Maturity = [RepoMaturity;BondMaturity]; CleanPrice = [RepoPrice;BondCleanPrice]; CouponRate = [RepoCouponRate;BondCouponRate]; Instruments = [Settle Maturity CleanPrice CouponRate]; InstrumentPeriod = [repmat(0,6,1);repmat(2,31,1)]; CurveSettle = datenum('30-Apr-2008');

**Fit Nelson-Siegel Model to Market Data**

The Nelson-Siegel model proposes that the instantaneous forward curve can be modeled with the following:

This can be integrated to derive an equation for the zero curve (see [6] for more information on the equations and the derivation):

See [1] for more information.

The IRFunctionCurve object provides the capability to fit a Nelson Siegel curve to observed market data with the FITNELSONSIEGEL method. The fitting is done by calling the Optimization Toolbox™ function LSQNONLIN.

This method has required inputs: Curve Type, Curve Settle, and a matrix of instrument data.

Optional input arguments, specified in parameter value pairs, are:

IRFitOptions structure: Provides capability to choose which quantity to be minimized (price, yield, or duration weighted price) and other optimization parameters (e.g.: upper and lower bounds for parameters)

Curve Compounding and Basis (Day Count Convention)

Additional instrument parameters, Period, Basis, FirstCouponDate, etc.

NSModel = IRFunctionCurve.fitNelsonSiegel('Zero',CurveSettle,... Instruments,'InstrumentPeriod',InstrumentPeriod);

A very similar model to the Nelson-Siegel is the Svensson model, which adds two additional parameters to account for greater flexibility in the term structure. This model proposes that the forward rate can be modeled with the following form:

As above, this can be integrated to derive an equation for the zero curve:

See [2] for more information.

Fitting the parameters to this model proceeds in a similar fashion to the Nelson-Siegel model.

SvenssonModel = IRFunctionCurve.fitSvensson('Zero',CurveSettle,... Instruments,'InstrumentPeriod',InstrumentPeriod);

The term structure can also be modeled with a spline -- specifically, one way to model the term structure is by representing the forward curve with a cubic spline. To ensure that the spline is sufficiently smooth, a penalty is imposed relating to the curvature (second derivative) of the spline:

where the first term is the difference between the observed price P and the predicted price, P_hat, (weighted by the bond's duration, D) summed over all bonds in our data set and the second term is the penalty term (where lambda is a penalty function and f is the spline)

See [3], [4], [5] below.

There have been different proposals for the specification of the penalty function lambda. One approach, advocated by [4], and currently used by the UK Debt Management Office, is a penalty function of the following form:

The parameters L, S, and mu are typically estimated from historical data.

The IRFunctionCurve object can be used to fit a smoothing spline representation of the forward curve with a penalty function.

Required inputs, like for methods above, are a Curve Type, Curve Settle, Instrument matrix, and new for this method, a function handle containing the penalty function

Optional parameters are similar to FITNELSONSIEGEL and FITSVENSSON

% Parameters chosen to be roughly similar to [4] below. L = 9.2; S = -1; mu = 1; lambdafun = @(t) exp(L - (L-S)*exp(-t/mu)); % Construct penalty function t = 0:.1:25; % Construct data to plot penalty function y = lambdafun(t); figure semilogy(t,y); title('Penalty Function for VRP Approach') ylabel('Penalty') xlabel('Time') VRPModel = IRFunctionCurve.fitSmoothingSpline('Forward',CurveSettle,... Instruments,lambdafun,'Compounding',-1,... 'InstrumentPeriod',InstrumentPeriod);

**Use Fitted Curves and Plot Results**

Once a curve has been constructed, methods can be called to extract the Forward and Zero Rates and the Discount Factors. This curve can also be converted into a RateSpec structure, to be used with functions in the Financial Instruments Toolbox™

PlottingDates = CurveSettle+20:30:CurveSettle+365*25; TimeToMaturity = yearfrac(CurveSettle,PlottingDates); NSForwardRates = NSModel.getForwardRates(PlottingDates); SvenssonForwardRates = SvenssonModel.getForwardRates(PlottingDates); VRPForwardRates = VRPModel.getForwardRates(PlottingDates); figure hold on plot(TimeToMaturity,NSForwardRates,'r') plot(TimeToMaturity,SvenssonForwardRates,'g') plot(TimeToMaturity,VRPForwardRates,'b') title('UK instantaneous nominal forward curve') xlabel('Years ahead') legend({'Nelson Siegel','Svensson','VRP'})

This link provides a live look at the derived yield curve published by the UK

http://www.bankofengland.co.uk

This example is based on the following papers and journal articles:

[1] Nelson, C.R., Siegel, A.F., (1987), "Parsimonious modelling of yield curves", Journal of Business, 60, pp 473-89

[2] Svensson, L.E.O. (1994), "Estimating and interpreting forward interest rates: Sweden 1992-4", International Monetary Fund, IMF Working Paper, 1994/114

[3] Fisher, M., Nychka, D., Zervos, D. (1995), "Fitting the term structure of interest rates with smoothing splines", Board of Governors of the Federal Reserve System, Federal Reserve Board Working Paper 95-1

[4] Anderson, N., Sleath, J. (1999), "New estimates of the UK real and nominal yield curves", Bank of England Quarterly Bulletin, November, pp 384-92

[5] Waggoner, D. (1997), "Spline Methods for Extracting Interest Rate Curves from Coupon Bond Prices", Federal Reserve Board Working Paper 97-10

[6] "Zero-coupon yield curves: technical documentation", BIS Papers No. 25 October 2005

[7] Bolder, D.J., Gusba,S (2002), "Exponentials, Polynomials, and Fourier Series: More Yield Curve Modelling at the Bank of Canada," Working Papers 02-29, Bank of Canada

[8] Bolder, D.J., Streliski, D (1999), "Yield Curve Modelling at the Bank of Canada," Technical Reports 84, Bank of Canada

Was this topic helpful?