cfbyzero (Financial Derivatives Toolbox)

Price cash flows by a set of zero curves

Syntax

Price = cfbyzero(RateSpec, CFlowAmounts, CFlowDates, Settle, Basis)

Arguments

RateSpec
A structure encapsulating the properties of an interest rate structure. See intenvset for information on creating RateSpec.

CFlowAmounts
Number of instruments (NINST) by maximum number of cash flows (MOSTCFS) matrix with entries listing cash flow amounts corresponding to each date in CFlowDates. Each row is a list of cash flow values for one instrument. If an instrument has fewer than MOSTCFS cash flows, the end of the row is padded with NaNs.

CFlowDates
NINST-by-MOSTCFS matrix of cash flow dates. Each entry contains the serial date of the corresponding cash flow in CFlowAmounts.

Settle
Settlement date on which the cash flows are priced.

Basis
(Optional) Day-count basis of the bond. A vector of integers.
0 = actual/actual (default), 1 = 30/360, 2 = actual/360,
3 = actual/365.

`RateSpec`	A structure encapsulating the properties of an interest rate structure. See `intenvset` for information on creating `RateSpec`.
`CFlowAmounts`	Number of instruments `(NINST)` by maximum number of cash flows (`MOSTCFS`) matrix with entries listing cash flow amounts corresponding to each date in `CFlowDates`. Each row is a list of cash flow values for one instrument. If an instrument has fewer than `MOSTCFS` cash flows, the end of the row is padded with `NaN`s.
`CFlowDates`	`NINST`-by-`MOSTCFS` matrix of cash flow dates. Each entry contains the serial date of the corresponding cash flow in `CFlowAmounts`.
`Settle`	Settlement date on which the cash flows are priced.
`Basis`	(Optional) Day-count basis of the bond. A vector of integers. `0` = actual/actual (default), `1` = 30/360, `2` = actual/360, `3` = actual/365.

Description

Price = cfbyzero(RateSpec, CFlowAmounts, CFlowDates, Settle, Basis) computes Price, an NINST-by-NUMCURVES matrix of cash flows prices. Each column arises from one of the zero curves.

Examples

Price a portfolio containing two cash flow instruments paying interest annually over the four year period from January 1, 2000 to January 1, 2004.

Load the file deriv.mat, which provides ZeroRateSpec. ZeroRateSpec contains the interest rate information needed to price the instruments.

load deriv 
CFlowAmounts =[5 NaN 5.5 105;5 0 6 105];
CFlowDates = [730852, NaN, 731582,731947; 
              730852, 731217, 731582, 731947];
Settle = 730486;
Price = cfbyzero(ZeroRateSpec, CFlowAmounts, CFlowDates, Settle)

Price =

   96.7804
   97.2187

cfbyhjm classfin