Finance - Maple Programming Help

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Mathematics : Finance : Financial Instruments : Finance/YieldFromCleanPrice

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

price1:=78.35261665

(3)

100DiscountFactor0.05,5,compounding=Annual

78.35261665

(4)

10011.055

78.35261665

(5)

yield1YieldFromCleanPricebond1,price1

yield1:=0.04879016417

(6)

EquivalentRateyield1,Continuous,Annual

0.05000000000

(7)

yield1YieldFromCleanPricebond1,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.

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

yield2:=0.02992505925

(10)

price2CleanPricebond2,yield2,Compounded

price2:=100.0000000

(11)

yield3YieldFromCleanPricebond2,price2

yield3:=0.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]

 


Download Help Document

Was this information helpful?



Please add your Comment (Optional)
E-mail Address (Optional)
What is ? This question helps us to combat spam