SPB Git

Repository Public MIT

financial-conventions.md 4.0 KB 88 lines markdown

1<!--2ORIX Calc3File: docs/mathematics/financial-conventions.md4Author: Simon-Pierre Boucher5Contact: contact@spboucher.ai6-->7# Conventions89Calculators disagree on conventions more often than on arithmetic. This page states the ones ORIX Calc uses.10Engine-level detail and reference cases are in `Packages/ORIXFinancial/API.md` and `VALIDATION.md`.1112## Percent key (Standard and Scientific)1314| Input | Contextual (default) | Strict |15|---|---|---|16| `200 + 10%` | 220 (200 + 10 % of 200) | 200.1 |17| `200 − 10%` | 180 | 199.9 |18| `200 × 10%` | 20 | 20 |19| `200 ÷ 10%` | 2000 | 2000 |20| `50%` | 0.5 | 0.5 |21| `100 + 5% + 5%` | 110.25 (each percentage applies to the running total) | 100.1 |22| `(100 + 50) − 20%` | 120 | 149.8 |2324The contextual rule applies only when `%` directly follows the right operand of `+` or `−`. It is implemented in the25evaluator (not in the keypad), so typed, pasted and stored expressions behave identically. Explain always states which26convention was used.2728## Operator conventions2930| Rule | Example |31|---|---|32| Unary minus binds looser than a power | `−2² = −4`, `(−2)² = 4` |33| Powers associate to the right | `2^3^2 = 2^9 = 512` |34| Implicit multiplication has the precedence of `×` | `1/2x = (1/2)·x`, `6 ÷ 2(1+2) = 9` |35| `mod` has the sign of the divisor | `−7 mod 3 = 2` |36| `0^0 = 1` | with an assumption note in Explain |37| Odd roots of negative numbers are real in real mode | `(−8)^(1/3) = −2`; in complex mode the principal value `1 + 1.732…i` |38| Rounding | `round` rounds half away from zero; display rounding is half away from zero and never alters the stored value |3940## Time value of money4142- Cash-flow sign convention: money received is positive, money paid is negative.43- `I/Y` is the nominal annual rate in percent. `P/Y` payments per year, `C/Y` compounding periods per year.44  Periodic rate: `i = (1 + (I/Y) / (100 · C/Y))^(C/Y ÷ P/Y) − 1`.45- `END` (ordinary annuity) is the default; `BGN` is always indicated when active.46- A rate solve that has several solutions returns all of them; one that has none says so.4748## Mortgages4950| Convention | Quoted rate means | Periodic rate for monthly payments |51|---|---|---|52| Canada, fixed rate | Nominal annual, compounded **semi-annually**, not in advance | `(1 + r/2)^(2/12) − 1` |53| Canada, variable rate | Nominal annual, compounded monthly | `r / 12` |54| United States | Nominal annual, compounded monthly | `r / 12` |55| Custom | Any `C/Y` | `(1 + r/C)^(C/12) − 1` |5657Reference: 300,000 at 5 % over 25 years, monthly payments — 1,744.81 (Canada, fixed) versus 1,753.77 (United States).58The default follows the device region and can be changed per loan and in Settings.5960Accelerated biweekly = monthly payment ÷ 2, paid 26 times a year. Accelerated weekly = monthly payment ÷ 4, paid 52 times.6162## Bonds6364Street convention, regular coupons generated backwards from maturity. Day counts: 30/360 US, 30E/360, Actual/360,65Actual/365 Fixed, Actual/Actual (ICMA). Quoted (clean) price excludes accrued interest; dirty price includes it.66"Effective" duration and convexity are computed by bump-and-reprice and labelled as such.6768## IRR6970All real roots above −100 % are searched. The result is one of *unique*, *multiple* (every rate listed) or *none*.71MIRR needs a finance rate and a reinvestment rate, both explicit inputs.7273## Options7475Black–Scholes–Merton is offered for European exercise only, with a continuous dividend yield, constant volatility and76rate. American options are priced by a Cox–Ross–Rubinstein tree; the early-exercise premium is reported.77Vega is given per 1.00 and per 1 % of volatility; theta per year and per day.7879## Statistics8081Sample statistics divide by n − 1 unless labelled "population". The default quantile method is linear interpolation82(R-7, the default of NumPy and Excel `PERCENTILE.INC`); R-6 and Tukey hinges are available. Details: `Packages/ORIXStatistics/API.md`.8384## Currency8586Rates are either typed by the user ("Manual") or ECB euro reference rates downloaded on request, always shown with source,87date and age. A cached rate is never described as live.88
Files main
Menu

Theme