YieldFromCleanPrice - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.
Our website is currently undergoing maintenance, which may result in occasional errors while browsing. We apologize for any inconvenience this may cause and are working swiftly to restore full functionality. Thank you for your patience.

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

withFinance:

SetEvaluationDateNovember 25, 2006:

EvaluationDate

November 25, 2006

(1)

Settingsdaycounter=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.

bond1ZeroCouponBond100,5,Years:

price1CleanPricebond1,0.05,Compounded

price178.35261665

(3)

100DiscountFactor0.05,5,compounding=Annual

78.35261665

(4)

10011.055

78.35261665

(5)

yield1YieldFromCleanPricebond1,price1

yield10.04879016417

(6)

EquivalentRateyield1,Continuous,Annual

0.05000000000

(7)

yield1YieldFromCleanPricebond1,price1,Compounded

yield10.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.

principal2100:

coupon20.03:

rate20.05:

We will use the Thirty360European day counter.

Settingsdaycounter=Thirty360European:

Settingsdaycounter

Thirty360European

(9)

bond2FixedCouponBondprincipal2,3,Years,coupon2,issuedate=March 17, 2005:

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

yield2YieldFromCleanPricebond2,100,Compounded

yield20.02992505925

(10)

price2CleanPricebond2,yield2,Compounded

price2100.0000000

(11)

yield3YieldFromCleanPricebond2,price2

yield30.02948604163

(12)

CleanPricebond2,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]