|
Calling Sequence
|
|
InternalRateOfReturn(cashflows, price, opts)
InternalRateOfReturn(bond, price, opts)
|
|
Parameters
|
|
cashflows
|
-
|
data structure created using the SimpleCashFlow constructor or a list of such data structures; cash flows
|
price
|
-
|
real constant; market price of the set of cash flows
|
bond
|
-
|
fixed or floating rate bond data structure; bond
|
opts
|
-
|
equations of the form option = value where option is one of evaluationdate, compounding, daycounter, maxiterations, tolerance, or guess; specify options for the InternalRateOfReturn command
|
|
|
|
|
Options
|
|
•
|
compounding = Simple, Continuous, Annual, Semiannual, EveryFourthMonth, Quarterly, Bimonthly, Monthly, SimpleThenAnnual, SimpleThenSemiannual, SimpleThenEveryFourthMonth, SimpleThenQuarterly, SimpleThenBimonthly, or SimpleThenMonthly -- This option specifies the compounding type for the given interest rate.
|
•
|
daycounter = a name representing a supported day counter (e.g. ISDA, Simple) or a day counter data structure created using the DayCounter constructor -- This option provides a day counter that will be used to convert the period between two dates to a fraction of the year.
|
•
|
tolerance = positive constant -- This option specifies the required absolute precision of the returned result. The default value is 1e-9.
|
•
|
maxiterations = positive integer -- This option specifies the maximum number of iterations that can be performed to obtain the result. When the maximum number of iterations has been reached, but InternalRateOfReturn cannot guarantee the requested accuracy of the result, an error will be thrown. The default value is 100000 iterations.
|
•
|
guess = positive constant -- This option can be used to specify the initial guess.
|
|
|
Description
|
|
•
|
The InternalRateOfReturn command calculates the internal rate of return of a set of cash flows or a bond. This is the rate at which the present value of the set of cash flows or the bond is equal to the given price. For bonds the internal rate of return is the same as the yield (see YieldFromCleanPrice and YieldFromDirtyPrice).
|
|
|
Examples
|
|
>
|
|
>
|
|
| (1) |
>
|
|
| (2) |
>
|
|
>
|
|
The following will throw an error because the specified number of iterations is insufficient to achieve the required precision.
>
|
|
>
|
|
Here is another example.
>
|
|
| (8) |
| (9) |
| (10) |
>
|
|
| (11) |
Compute the value of this cash flow on January 1, 2005.
>
|
|
>
|
|
Here is an example using bonds.
>
|
|
| (14) |
>
|
|
>
|
|
>
|
|
|
|
Compatibility
|
|
•
|
The Finance[InternalRateOfReturn] command was introduced in Maple 15.
|
|
|
|