YieldFromCleanPrice - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Mozilla Firefox.

Online Help

All Products    Maple    MapleSim


Finance

  

YieldFromCleanPrice

  

calculate the yield of a bond given its clean price

 

Calling Sequence

Parameters

Options

Description

Examples

Compatibility

Calling Sequence

YieldFromCleanPrice(bond, price, compounding, opts)

Parameters

bond

-

fixed- or floating-rate bond data structure; bond

price

-

non-negative constant; bond's clean price

compounding

-

Simple, Continuous, Compounded, or SimpleThenCompounded; the underlying compounding type

opts

-

equations of the form option = value where option is one of accuracy, iterations, or evaluationdate; specify options for the YieldFromCleanPrice command

Options

• 

accuracy = positive -- This option specifies the desired accuracy of the result. The default value is 1e-9.

• 

evaluationdate = a string containing a date specification in a format recognized by ParseDate or a Date data structure -- This option specifies the evaluation date. By default this is set to the global evaluation date (see EvaluationDate).

• 

iterations = posint -- This option specifies the maximum number of iterations. The default value is 100000.

Description

• 

The YieldFromCleanPrice command calculates a bond's yield based on the specified clean price.

• 

The parameter bond can be either a fixed-rate bond or a floating-rate bond.

• 

The parameter price is the desired clean price.

• 

The (optional) parameter compounding specifies what type of compounding will be used to calculate the yield. By default, Continuous compounding is assumed.

Examples

> 

with⁡Finance:

> 

SetEvaluationDate⁡November 25, 2006:

> 

EvaluationDate⁡

November 25, 2006

(1)
> 

Settings⁡daycounter=Historical,settlementdays=0,businessdayconvention=Unadjusted

daycounter=Historical,settlementdays=0,businessdayconvention=Unadjusted

(2)

Consider a zero-coupon bond with a face value of 100 maturing in five years.

> 

bond1≔ZeroCouponBond⁡100,5,Years:

> 

price1≔CleanPrice⁡bond1,0.05,Compounded

price1≔78.35261665

(3)
> 

100⁢DiscountFactor⁡0.05,5,compounding=Annual

78.35261665

(4)
> 

100⁢11.055

78.35261665

(5)
> 

yield1≔YieldFromCleanPrice⁡bond1,price1

yield1≔0.04879016417

(6)
> 

EquivalentRate⁡yield1,Continuous,Annual

0.05000000000

(7)
> 

yield1≔YieldFromCleanPrice⁡bond1,price1,Compounded

yield1≔0.05000000006

(8)

Consider a 3-year bond with a face value of 100 that pays a fixed coupon of 3% issued on March 15, 2005.

> 

principal2≔100:

> 

coupon2≔0.03:

> 

rate2≔0.05:

We will use the Thirty360European day counter.

> 

Settings⁡daycounter=Thirty360European:

> 

Settings⁡daycounter

Thirty360European

(9)
> 

bond2≔FixedCouponBond⁡principal2,3,Years,coupon2,issuedate=March 17, 2005:

Calculate the bond's clean price given its yield and vice-versa.

> 

yield2≔YieldFromCleanPrice⁡bond2,100,Compounded

yield2≔0.02992505925

(10)
> 

price2≔CleanPrice⁡bond2,yield2,Compounded

price2≔100.0000000

(11)
> 

yield3≔YieldFromCleanPrice⁡bond2,price2

yield3≔0.02948604163

(12)
> 

CleanPrice⁡bond2,yield3

99.99999999

(13)

Compatibility

• 

The Finance[YieldFromCleanPrice] command was introduced in Maple 15.

• 

For more information on Maple 15 changes, see Updates in Maple 15.

See Also

Finance[AccruedAmount]

Finance[CleanPrice]

Finance[DayCounter]

Finance[DirtyPrice]

Finance[FixedCouponBond]

Finance[FloatingRateBond]

Finance[FormatDate]

Finance[ParseDate]

Finance[YearFraction]

Finance[YieldFromDirtyPrice]

Finance[ZeroCouponBond]