pvCouponDeficiency {bondAnalyst} R Documentation

## Calculates the Present Value of the Deficiency as result of lower Coupon Payments as compared that of the Market.

### Description

Calculates the Present Value of the Deficiency as result of lower Coupon Payments as compared that of the Market.

### Usage

pvCouponDeficiency(couponDeficiency, times, r)


### Arguments

 couponDeficiency A vector. times A vector. r A number.

### Details

Price of a fixed-rate bond, relative to par value, depends on the relationship of the coupon rate to the market discount rate. When the coupon rate is less than the market discount rate, the bond is priced at a discount below par value. Coupon rate indicates the amount the issuer promises to pay the bondholders each year in interest. The market discount rate reflects the amount investors need to receive in interest each year in order to pay full par value for the bond (Adams & Smith, 2019). If a bond pays coupons at 4 percent, whereas the the market discount rate is 6 percent then this bond has coupon deficiency of 2 percent. So a deficiency of 2 percent also means a deficient coupon payment of 2 dollars (entered -2) for a par value of 100 dollars. In light of this, the method pvCouponDeficiency() is developed to compute the present value of the Coupon Deficiency. So, pvCouponDeficiency() gives the discounted value of Deficient Coupon Payments for values passed to its three arguments. Here, couponDeficiency is the vector that has dollar values of Deficient Coupon Payments for periods till maturity, times is a vector of number of years ranging from 1 to any specified number of years till maturity, and r is Market Discount Rate or Required Rate of return. The output is rounded off to three decimal places.

### Value

Input values to three arguments couponDeficiency , times and r.

### 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

pvCouponDeficiency(couponDeficiency=c(-2,-2,-2,-2,-2), times=c(1,2,3,4,5), r= 0.06)
pvCouponDeficiency(couponDeficiency=c(-2,-2,-2,-2,-2), times=c(1:5), r= 0.06)
pvCouponDeficiency(couponDeficiency=c(rep(-2,5)), times=c(1:5), r= 0.06)
pvCouponDeficiency(c(rep(-2,5)), c(1:5), 0.06)


[Package bondAnalyst version 1.0.1 Index]