SPB Git

Repository Public MIT

financial-conventions.md 4.0 KB

# Conventions

Calculators disagree on conventions more often than on arithmetic. This page states the ones ORIX Calc uses. Engine-level detail and reference cases are in Packages/ORIXFinancial/API.md and VALIDATION.md.

# Percent key (Standard and Scientific)

Input Contextual (default) Strict
200 + 10% 220 (200 + 10 % of 200) 200.1
200 − 10% 180 199.9
200 × 10% 20 20
200 ÷ 10% 2000 2000
50% 0.5 0.5
100 + 5% + 5% 110.25 (each percentage applies to the running total) 100.1
(100 + 50) − 20% 120 149.8

The contextual rule applies only when % directly follows the right operand of + or −. It is implemented in the evaluator (not in the keypad), so typed, pasted and stored expressions behave identically. Explain always states which convention was used.

# Operator conventions

Rule Example
Unary minus binds looser than a power −2² = −4, (−2)² = 4
Powers associate to the right 2^3^2 = 2^9 = 512
Implicit multiplication has the precedence of × 1/2x = (1/2)·x, 6 ÷ 2(1+2) = 9
mod has the sign of the divisor −7 mod 3 = 2
0^0 = 1 with an assumption note in Explain
Odd roots of negative numbers are real in real mode (−8)^(1/3) = −2; in complex mode the principal value 1 + 1.732…i
Rounding round rounds half away from zero; display rounding is half away from zero and never alters the stored value

# Time value of money

  • Cash-flow sign convention: money received is positive, money paid is negative.
  • I/Y is the nominal annual rate in percent. P/Y payments per year, C/Y compounding periods per year. Periodic rate: i = (1 + (I/Y) / (100 · C/Y))^(C/Y ÷ P/Y) − 1.
  • END (ordinary annuity) is the default; BGN is always indicated when active.
  • A rate solve that has several solutions returns all of them; one that has none says so.

# Mortgages

Convention Quoted rate means Periodic rate for monthly payments
Canada, fixed rate Nominal annual, compounded semi-annually, not in advance (1 + r/2)^(2/12) − 1
Canada, variable rate Nominal annual, compounded monthly r / 12
United States Nominal annual, compounded monthly r / 12
Custom Any C/Y (1 + r/C)^(C/12) − 1

Reference: 300,000 at 5 % over 25 years, monthly payments — 1,744.81 (Canada, fixed) versus 1,753.77 (United States). The default follows the device region and can be changed per loan and in Settings.

Accelerated biweekly = monthly payment ÷ 2, paid 26 times a year. Accelerated weekly = monthly payment ÷ 4, paid 52 times.

# Bonds

Street convention, regular coupons generated backwards from maturity. Day counts: 30/360 US, 30E/360, Actual/360, Actual/365 Fixed, Actual/Actual (ICMA). Quoted (clean) price excludes accrued interest; dirty price includes it. "Effective" duration and convexity are computed by bump-and-reprice and labelled as such.

# IRR

All real roots above −100 % are searched. The result is one of unique, multiple (every rate listed) or none. MIRR needs a finance rate and a reinvestment rate, both explicit inputs.

# Options

Black–Scholes–Merton is offered for European exercise only, with a continuous dividend yield, constant volatility and rate. American options are priced by a Cox–Ross–Rubinstein tree; the early-exercise premium is reported. Vega is given per 1.00 and per 1 % of volatility; theta per year and per day.

# Statistics

Sample statistics divide by n − 1 unless labelled "population". The default quantile method is linear interpolation (R-7, the default of NumPy and Excel PERCENTILE.INC); R-6 and Tukey hinges are available. Details: Packages/ORIXStatistics/API.md.

# Currency

Rates are either typed by the user ("Manual") or ECB euro reference rates downloaded on request, always shown with source, date and age. A cached rate is never described as live.

Files main
Menu

Theme