matrixMethod {bondAnalyst}R Documentation

Calculate Present Value or the Price of illiquid Bond using Matrix Method.

Description

Calculate Present Value or the Price of illiquid Bond using Matrix Method.

Usage

matrixMethod(couponPmt, times, maturityVal, n, r1, r2)

Arguments

couponPmt

A vector.

times

A vector.

maturityVal

A number.

n

A number.

r1

A number.

r2

A number

Details

Some fixed-rate bonds are not actively traded. Therefore, there is no market price available to calculate the rate of return required by investors. The same problem occurs for bonds that are not yet issued. In these situations, it is common to estimate the market discount rate and price based on the quoted or flat prices of more frequently traded comparable bonds. These comparable bonds have similar times-to-maturity, coupon rates, and credit quality. This estimation process is called matrix pricing. Matrix pricing also is used in underwriting new bonds to get an estimate of the required yield spread over the benchmark rate. The benchmark rate typically is the yield-to-maturity on a government bond having the same, or close to the same, time-to-maturity (Adams & Smith, 2019). Based on the information provided, matrixMethod() is developed to compute the Price of Bond using Matrix Method. So, matrixMethod() gives the Price of Bond using returns of two frequently traded comparable bonds for values passed to its six arguments. Here, couponPmt represents the dollar values of all the coupon payments, times is a vector of number of years ranging from 1 to any specified number of years till maturity, maturityVal is Maturity Value, n is number of years till maturity, r1 return on first comparable bond, and r2 is return on second comparable bond. The function computes simple average of the returns of two comparable bonds with r=(r1+r2)/2, that is being used for Bond pricing. The output is rounded off to three decimal places.

Value

Input values to six arguments couponPmt ,times, maturityVal,n, r1 and r2.

Author(s)

MaheshP Kumar, maheshparamjitkumar@gmail.com

References

Adams,J.F. & Smith,D.J.(2019). Introduction to fixed-income valuation. In CFA Program Curriculum 2020 Level I Volumes 1-6. (Vol. 5, pp. 107-151). Wiley Professional Development (P&T). ISBN 9781119593577, https://bookshelf.vitalsource.com/books/9781119593577

Examples

matrixMethod(couponPmt=c(4.5,4.5,4.5,4.5),times=c(1:4),maturityVal=100,n=4,r1=0.02856,r2=0.03449)

[Package bondAnalyst version 1.0.1 Index]