[Calculation Name] — Calculation Specification¶
Use this template to document any non-trivial calculation or formula precisely — especially where correctness matters for compliance, finance-adjacent, or safety-relevant logic. Ambiguity here is a defect.
Purpose¶
[What this calculation computes and why it's needed.]
Inputs¶
| Name | Type | Units | Valid range | Source |
|---|---|---|---|---|
[input_1] |
[type] | [units] | [range] | [where it comes from] |
Formula / algorithm¶
[The precise formula or step-by-step algorithm. Use explicit notation, not prose alone, wherever precision matters.]
[formula or pseudocode]
Output¶
| Name | Type | Units | Notes |
|---|---|---|---|
[output_1] |
[type] | [units] |
Edge cases and error handling¶
- [Edge case 1 — e.g. division by zero, out-of-range input — and required behavior]
Worked example(s)¶
| Inputs | Expected output | Notes |
|---|---|---|
| [example inputs] | [example output] |
Sources / basis for this calculation¶
[Cite the source of the formula — regulation, published standard, prior art, or derivation — per the company's research and evidence principles. Do not present an unverified formula as authoritative.]
Validation status¶
[Has this calculation been independently checked or tested against known values? Record status and date.]